xref: /openbmc/linux/Documentation/devicetree/bindings/gnss/brcm,bcm4751.yaml (revision 4f2c0a4acffbec01079c28f839422e64ddeff004)
1a6bf474cSLinus Walleij# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2a6bf474cSLinus Walleij%YAML 1.2
3a6bf474cSLinus Walleij---
4a6bf474cSLinus Walleij$id: http://devicetree.org/schemas/gnss/brcm,bcm4751.yaml#
5a6bf474cSLinus Walleij$schema: http://devicetree.org/meta-schemas/core.yaml#
6a6bf474cSLinus Walleij
7*dd3cb467SAndrew Lunntitle: Broadcom BCM4751 family GNSS Receiver
8a6bf474cSLinus Walleij
9a6bf474cSLinus Walleijmaintainers:
10a6bf474cSLinus Walleij  - Johan Hovold <johan@kernel.org>
11a6bf474cSLinus Walleij  - Linus Walleij <linus.walleij@linaro.org>
12a6bf474cSLinus Walleij
13a6bf474cSLinus Walleijdescription:
14a6bf474cSLinus Walleij  Broadcom GPS chips can be used over the UART or I2C bus. The UART
15a6bf474cSLinus Walleij  bus requires CTS/RTS support. The number of the capsule is more
16a6bf474cSLinus Walleij  elaborate than the compatibles BCM4751 may be printed
17a6bf474cSLinus Walleij  BCM4751IFBG for example.
18a6bf474cSLinus Walleij
19a6bf474cSLinus WalleijallOf:
20a6bf474cSLinus Walleij  - $ref: gnss-common.yaml#
21a6bf474cSLinus Walleij
22a6bf474cSLinus Walleijproperties:
23a6bf474cSLinus Walleij  compatible:
24a6bf474cSLinus Walleij    enum:
25a6bf474cSLinus Walleij      - brcm,bcm4751
26a6bf474cSLinus Walleij      - brcm,bcm4752
27a6bf474cSLinus Walleij      - brcm,bcm4753
28a6bf474cSLinus Walleij
29a6bf474cSLinus Walleij  reg:
30a6bf474cSLinus Walleij    description:
31a6bf474cSLinus Walleij      The I2C Address, not required on UART buses.
32a6bf474cSLinus Walleij
33a6bf474cSLinus Walleij  vdd-auxin-supply:
34a6bf474cSLinus Walleij    description:
35a6bf474cSLinus Walleij      Main voltage supply, pin name VDD_AUXIN, typically connected
36a6bf474cSLinus Walleij      directly to a battery such as LiIon 3.8V battery or a 2.6V supply.
37a6bf474cSLinus Walleij
38a6bf474cSLinus Walleij  vddio-supply:
39a6bf474cSLinus Walleij    description:
40a6bf474cSLinus Walleij      IO voltage supply, pin name VDDIO, typically 1.8V
41a6bf474cSLinus Walleij
42a6bf474cSLinus Walleij  reset-gpios:
43a6bf474cSLinus Walleij    maxItems: 1
44a6bf474cSLinus Walleij    description: An optional active low reset line, should be flagged with
45a6bf474cSLinus Walleij      GPIO_ACTIVE_LOW.
46a6bf474cSLinus Walleij
47a6bf474cSLinus Walleij  enable-gpios:
48a6bf474cSLinus Walleij    description: Enable GPIO line, connected to pins named REGPU or NSTANDBY.
49a6bf474cSLinus Walleij      If the line is active low such as NSTANDBY, it should be tagged
50a6bf474cSLinus Walleij      GPIO_ACTIVE_LOW.
51a6bf474cSLinus Walleij
52a6bf474cSLinus Walleijrequired:
53a6bf474cSLinus Walleij  - compatible
54a6bf474cSLinus Walleij  - enable-gpios
55a6bf474cSLinus Walleij
56a6bf474cSLinus WalleijunevaluatedProperties: false
57a6bf474cSLinus Walleij
58a6bf474cSLinus Walleijexamples:
59a6bf474cSLinus Walleij  - |
60a6bf474cSLinus Walleij    #include <dt-bindings/gpio/gpio.h>
61a6bf474cSLinus Walleij    serial {
62a6bf474cSLinus Walleij        gnss {
63a6bf474cSLinus Walleij            compatible = "brcm,bcm4751";
64a6bf474cSLinus Walleij            vdd-auxin-supply = <&vbat>;
65a6bf474cSLinus Walleij            reset-gpios = <&gpio0 15 GPIO_ACTIVE_LOW>;
66a6bf474cSLinus Walleij            enable-gpios = <&gpio0 16 GPIO_ACTIVE_HIGH>;
67a6bf474cSLinus Walleij            current-speed = <38400>;
68a6bf474cSLinus Walleij        };
69a6bf474cSLinus Walleij    };
70