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