iio/resolver/adi%2Cad2s1210.yaml

1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
3 ---
4 $id: http://devicetree.org/schemas/iio/resolver/adi,ad2s1210.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 title: Analog Devices AD2S1210 Resolver-to-Digital Converter
10   - Michael Hennerich <michael.hennerich@analog.com>
13   The AD2S1210 is a complete 10-bit to 16-bit resolution tracking
14   resolver-to-digital converter, integrating an on-board programmable
18   The AD2S1210 allows the user to read the angular position or the
29      0   0  Normal mode - position output
30      0   1  Normal mode - velocity output
34   In normal mode, the resolution of the digital output is selected using
44   Note on SPI connections: The CS line on the AD2S1210 should hard-wired to
45   logic low and the WR/FSYNC line on the AD2S1210 should be connected to the
49   https://www.analog.com/media/en/technical-documentation/data-sheets/ad2s1210.pdf
58   spi-max-frequency:
61   spi-cpha: true
63   avdd-supply:
65       A 4.75 to 5.25 V regulator that powers the Analog Supply Voltage (AVDD)
68   dvdd-supply:
70       A 4.75 to 5.25 V regulator that powers the Digital Supply Voltage (DVDD)
73   vdrive-supply:
75       A 2.3 to 5.25 V regulator that powers the Logic Power Supply Input
82   reset-gpios:
84       GPIO connected to the /RESET pin. As the line needs to be low for the
85       reset to be active, it should be configured as GPIO_ACTIVE_LOW.
88   sample-gpios:
90       GPIO connected to the /SAMPLE pin. As the line needs to be low to trigger
94   mode-gpios:
96       GPIO lines connected to the A0 and A1 pins. These pins select the data
101   resolution-gpios:
103       GPIO lines connected to the RES0 and RES1 pins. These pins select the
104       resolution of the digital output. If omitted, it is assumed that the
105       RES0 and RES1 pins are hard-wired to match the assigned-resolution-bits
110   fault-gpios:
112       GPIO lines connected to the LOT and DOS pins. These pins combined indicate
113       the type of fault present, if any. As these pins a pulled low to indicate
118   adi,fixed-mode:
120       This is used to indicate the selected mode if A0 and A1 are hard-wired
121       instead of connected to GPIOS (i.e. mode-gpios is omitted).
125   assigned-resolution-bits:
127       Resolution of the digital output required by the application. This
129       be measured. If resolution-gpios is omitted, it is assumed that RES0 and
130       RES1 are hard-wired to match this value.
134   - compatible
135   - reg
136   - spi-cpha
137   - avdd-supply
138   - dvdd-supply
139   - vdrive-supply
140   - clocks
141   - sample-gpios
142   - assigned-resolution-bits
145   - required:
146       - mode-gpios
147   - required:
148       - adi,fixed-mode
151   - $ref: /schemas/spi/spi-peripheral-props.yaml#
156   - |
157     #include <dt-bindings/gpio/gpio.h>
160         #address-cells = <1>;
161         #size-cells = <0>;
163         resolver@0 {
166             spi-max-frequency = <20000000>;
167             spi-cpha;
168             avdd-supply = <&avdd_regulator>;
169             dvdd-supply = <&dvdd_regulator>;
170             vdrive-supply = <&vdrive_regulator>;
172             sample-gpios = <&gpio0 90 GPIO_ACTIVE_LOW>;
173             mode-gpios = <&gpio0 86 0>, <&gpio0 87 0>;
174             resolution-gpios = <&gpio0 88 0>, <&gpio0 89 0>;
175             assigned-resolution-bits = <16>;