Documentation/devicetree/bindings/gnss/gnss-common.yaml

   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
   7 title: Common Properties for Global Navigation Satellite Systems (GNSS)
   8   receiver devices
   9
  10 maintainers:
  11   - Johan Hovold <johan@kernel.org>
  12
  13 description: |
  14   This document defines device tree properties common to Global Navigation
  15   Satellite System receivers.
  16
  17 properties:
  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
  38 additionalProperties: true
  39
  40 examples:
  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     };