1 .. SPDX-License-Identifier: GPL-2.0-only 1 .. SPDX-License-Identifier: GPL-2.0-only
2 2
3 ============= 3 =============
4 AD4000 driver 4 AD4000 driver
5 ============= 5 =============
6 6
7 Device driver for Analog Devices Inc. AD4000 s 7 Device driver for Analog Devices Inc. AD4000 series of ADCs.
8 8
9 Supported devices 9 Supported devices
10 ================= 10 =================
11 11
12 * `AD4000 <https://www.analog.com/AD4000>`_ 12 * `AD4000 <https://www.analog.com/AD4000>`_
13 * `AD4001 <https://www.analog.com/AD4001>`_ 13 * `AD4001 <https://www.analog.com/AD4001>`_
14 * `AD4002 <https://www.analog.com/AD4002>`_ 14 * `AD4002 <https://www.analog.com/AD4002>`_
15 * `AD4003 <https://www.analog.com/AD4003>`_ 15 * `AD4003 <https://www.analog.com/AD4003>`_
16 * `AD4004 <https://www.analog.com/AD4004>`_ 16 * `AD4004 <https://www.analog.com/AD4004>`_
17 * `AD4005 <https://www.analog.com/AD4005>`_ 17 * `AD4005 <https://www.analog.com/AD4005>`_
18 * `AD4006 <https://www.analog.com/AD4006>`_ 18 * `AD4006 <https://www.analog.com/AD4006>`_
19 * `AD4007 <https://www.analog.com/AD4007>`_ 19 * `AD4007 <https://www.analog.com/AD4007>`_
20 * `AD4008 <https://www.analog.com/AD4008>`_ 20 * `AD4008 <https://www.analog.com/AD4008>`_
21 * `AD4010 <https://www.analog.com/AD4010>`_ 21 * `AD4010 <https://www.analog.com/AD4010>`_
22 * `AD4011 <https://www.analog.com/AD4011>`_ 22 * `AD4011 <https://www.analog.com/AD4011>`_
23 * `AD4020 <https://www.analog.com/AD4020>`_ 23 * `AD4020 <https://www.analog.com/AD4020>`_
24 * `AD4021 <https://www.analog.com/AD4021>`_ 24 * `AD4021 <https://www.analog.com/AD4021>`_
25 * `AD4022 <https://www.analog.com/AD4022>`_ 25 * `AD4022 <https://www.analog.com/AD4022>`_
26 * `ADAQ4001 <https://www.analog.com/ADAQ4001>` 26 * `ADAQ4001 <https://www.analog.com/ADAQ4001>`_
27 * `ADAQ4003 <https://www.analog.com/ADAQ4003>` 27 * `ADAQ4003 <https://www.analog.com/ADAQ4003>`_
28 28
29 Wiring connections 29 Wiring connections
30 ------------------ 30 ------------------
31 31
32 Devices of the AD4000 series can be connected 32 Devices of the AD4000 series can be connected to the SPI host controller in a
33 few different modes. 33 few different modes.
34 34
35 CS mode, 3-wire turbo mode 35 CS mode, 3-wire turbo mode
36 ^^^^^^^^^^^^^^^^^^^^^^^^^^ 36 ^^^^^^^^^^^^^^^^^^^^^^^^^^
37 37
38 Datasheet "3-wire" mode is what most resembles 38 Datasheet "3-wire" mode is what most resembles standard SPI connection which,
39 for these devices, comprises of connecting the 39 for these devices, comprises of connecting the controller CS line to device CNV
40 pin and other SPI lines as usual. This configu 40 pin and other SPI lines as usual. This configuration is (misleadingly) called
41 "CS Mode, 3-Wire Turbo Mode" connection in dat 41 "CS Mode, 3-Wire Turbo Mode" connection in datasheets.
42 NOTE: The datasheet definition of 3-wire mode 42 NOTE: The datasheet definition of 3-wire mode for the AD4000 series is NOT the
43 same of standard spi-3wire mode. 43 same of standard spi-3wire mode.
44 This is the only connection mode that allows c 44 This is the only connection mode that allows configuration register access but
45 it requires the SPI controller to support the 45 it requires the SPI controller to support the ``SPI_MOSI_IDLE_HIGH`` feature.
46 46
47 Omit the ``adi,sdi-pin`` property in device tr 47 Omit the ``adi,sdi-pin`` property in device tree to select this mode.
48 48
49 :: 49 ::
50 50
51 +---- 51 +-------------+
52 + ----------------------------------| SDO 52 + ----------------------------------| SDO |
53 | | 53 | | |
54 | +-------------------| CS 54 | +-------------------| CS |
55 | v | 55 | v | |
56 | +--------------------+ | 56 | +--------------------+ | HOST |
57 | | CNV | | 57 | | CNV | | |
58 +--->| SDI AD4000 SDO |-------->| SDI 58 +--->| SDI AD4000 SDO |-------->| SDI |
59 | SCK | | 59 | SCK | | |
60 +--------------------+ | 60 +--------------------+ | |
61 ^ | 61 ^ | |
62 +--------------------| SCL 62 +--------------------| SCLK |
63 +---- 63 +-------------+
64 64
65 CS mode, 3-wire, without busy indicator 65 CS mode, 3-wire, without busy indicator
66 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 66 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
67 67
68 Another wiring configuration supported as "3-w 68 Another wiring configuration supported as "3-wire" mode has the SDI pin
69 hard-wired to digital input/output interface s 69 hard-wired to digital input/output interface supply (VIO). In this setup, the
70 controller is not required to support ``SPI_MO 70 controller is not required to support ``SPI_MOSI_IDLE_HIGH`` but register access
71 is not possible. This connection mode saves on 71 is not possible. This connection mode saves one wire and works with any SPI
72 controller. 72 controller.
73 73
74 Set the ``adi,sdi-pin`` device tree property t 74 Set the ``adi,sdi-pin`` device tree property to ``"high"`` to select this mode.
75 75
76 :: 76 ::
77 77
78 +---- 78 +-------------+
79 +--------------------| CS 79 +--------------------| CS |
80 v | 80 v | |
81 VIO +--------------------+ | 81 VIO +--------------------+ | HOST |
82 | | CNV | | 82 | | CNV | | |
83 +--->| SDI AD4000 SDO |-------->| SDI 83 +--->| SDI AD4000 SDO |-------->| SDI |
84 | SCK | | 84 | SCK | | |
85 +--------------------+ | 85 +--------------------+ | |
86 ^ | 86 ^ | |
87 +--------------------| SCL 87 +--------------------| SCLK |
88 +---- 88 +-------------+
89 89
90 Alternatively, a GPIO may be connected to the 90 Alternatively, a GPIO may be connected to the device CNV pin. This is similar to
91 the previous wiring configuration but saves th 91 the previous wiring configuration but saves the use of a CS line.
92 92
93 :: 93 ::
94 94
95 +---- 95 +-------------+
96 +--------------------| GPI 96 +--------------------| GPIO |
97 v | 97 v | |
98 VIO +--------------------+ | 98 VIO +--------------------+ | HOST |
99 | | CNV | | 99 | | CNV | | |
100 +--->| SDI AD4000 SDO |-------->| SDI 100 +--->| SDI AD4000 SDO |-------->| SDI |
101 | SCK | | 101 | SCK | | |
102 +--------------------+ | 102 +--------------------+ | |
103 ^ | 103 ^ | |
104 +--------------------| SCL 104 +--------------------| SCLK |
105 +---- 105 +-------------+
106 106
107 CS mode, 4-wire without busy indicator 107 CS mode, 4-wire without busy indicator
108 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 108 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
109 109
110 In datasheet "4-wire" mode, the controller CS 110 In datasheet "4-wire" mode, the controller CS line is connected to the ADC SDI
111 pin and a GPIO is connected to the ADC CNV pin 111 pin and a GPIO is connected to the ADC CNV pin. This connection mode may better
112 suit scenarios where multiple ADCs can share o 112 suit scenarios where multiple ADCs can share one CNV trigger.
113 113
114 Set ``adi,sdi-pin`` to ``"cs"`` to select this 114 Set ``adi,sdi-pin`` to ``"cs"`` to select this mode.
115 115
116 116
117 :: 117 ::
118 118
119 +---- 119 +-------------+
120 + ----------------------------------| CS 120 + ----------------------------------| CS |
121 | | 121 | | |
122 | +-------------------| GPI 122 | +-------------------| GPIO |
123 | v | 123 | v | |
124 | +--------------------+ | 124 | +--------------------+ | HOST |
125 | | CNV | | 125 | | CNV | | |
126 +--->| SDI AD4000 SDO |-------->| SDI 126 +--->| SDI AD4000 SDO |-------->| SDI |
127 | SCK | | 127 | SCK | | |
128 +--------------------+ | 128 +--------------------+ | |
129 ^ | 129 ^ | |
130 +--------------------| SCL 130 +--------------------| SCLK |
131 +---- 131 +-------------+
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.