xref: /linux/Documentation/devicetree/bindings/gnss/gnss-common.yaml (revision 3ea5eb68b9d624935108b5e696859304edfac202) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/gnss/gnss-common.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Common Properties for Global Navigation Satellite Systems (GNSS)
8  receiver devices
9
10maintainers:
11  - Johan Hovold <johan@kernel.org>
12
13description: |
14  This document defines device tree properties common to Global Navigation
15  Satellite System receivers.
16
17properties:
18  $nodename:
19    pattern: "^gnss(@.*)?$"
20
21  lna-supply:
22    description: A separate regulator supplying power for the Low Noise
23      Amplifier (LNA). This is an amplifier connected between the GNSS
24      device and the receiver antenna.
25
26  enable-gpios:
27    description: A GPIO line that will enable the GNSS receiver when
28      asserted. If this line is active low, the GPIO phandle should
29      consequently be tagged with the GPIO_ACTIVE_LOW flag so the operating
30      system can rely on asserting the line to enable the GNSS device.
31    maxItems: 1
32
33  timepulse-gpios:
34    description: When a timepulse is provided to the GNSS device using a
35      GPIO line, this is used.
36    maxItems: 1
37
38additionalProperties: true
39
40examples:
41  - |
42    #include <dt-bindings/gpio/gpio.h>
43    serial {
44      gnss {
45        compatible = "u-blox,neo-8";
46        vcc-supply = <&gnss_reg>;
47        timepulse-gpios = <&gpio0 16 GPIO_ACTIVE_HIGH>;
48        current-speed = <4800>;
49      };
50    };
51