xref: /linux/Documentation/devicetree/bindings/gnss/sirfstar.yaml (revision 3a39d672e7f48b8d6b91a09afa4b55352773b4b5) 
1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/gnss/sirfstar.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: SiRFstar GNSS Receiver
8
9maintainers:
10  - Johan Hovold <johan@kernel.org>
11
12description:
13  The SiRFstar GNSS receivers have incarnated over the years in different
14  chips, starting from the SiRFstarIII which was a chip that was introduced in
15  2004 and used in a lot of dedicated GPS devices. In 2009 SiRF was acquired
16  by CSR (Cambridge Silicon Radio) and in 2012 the CSR GPS business was
17  acquired by Samsung, while some products remained with CSR. In 2014 CSR
18  was acquired by Qualcomm who still sell some of the SiRF products.
19
20  SiRF chips can be used over UART, I2C or SPI buses.
21
22allOf:
23  - $ref: gnss-common.yaml#
24  - $ref: /schemas/serial/serial-peripheral-props.yaml#
25
26properties:
27  compatible:
28    enum:
29      - csr,gsd4t
30      - csr,csrg05ta03-icje-r
31      - fastrax,uc430
32      - linx,r4
33      - wi2wi,w2sg0004
34      - wi2wi,w2sg0008i
35      - wi2wi,w2sg0084i
36
37  reg:
38    description:
39      The I2C Address, SPI chip select address. Not required on UART buses.
40
41  vcc-supply:
42    description:
43      Main voltage regulator, pin names such as 3V3_IN, VCC, VDD.
44
45  reset-gpios:
46    maxItems: 1
47    description: An optional active low reset line, should be flagged with
48      GPIO_ACTIVE_LOW.
49
50  sirf,onoff-gpios:
51    maxItems: 1
52    description: GPIO used to power on and off device, pin name ON_OFF.
53
54  sirf,wakeup-gpios:
55    maxItems: 1
56    description: GPIO used to determine device power state, pin names such
57      as RFPWRUP, WAKEUP.
58
59required:
60  - compatible
61  - vcc-supply
62
63unevaluatedProperties: false
64
65examples:
66  - |
67    #include <dt-bindings/gpio/gpio.h>
68    serial {
69        gnss {
70            compatible = "wi2wi,w2sg0084i";
71            vcc-supply = <&gnss_vcc_reg>;
72            reset-gpios = <&gpio0 15 GPIO_ACTIVE_LOW>;
73            sirf,onoff-gpios = <&gpio0 16 GPIO_ACTIVE_HIGH>;
74            sirf,wakeup-gpios = <&gpio0 17 GPIO_ACTIVE_HIGH>;
75            current-speed = <38400>;
76        };
77    };
78