1 .. SPDX-License-Identifier: GPL-2.0-only
2
3 =============
4 AD7380 driver
5 =============
6
7 ADC driver for Analog Devices Inc. AD7380 and
8 is ``ad7380``.
9
10
11 Supported devices
12 =================
13
14 The following chips are supported by this driv
15
16 * `AD7380 <https://www.analog.com/en/products/
17 * `AD7381 <https://www.analog.com/en/products/
18 * `AD7383 <https://www.analog.com/en/products/
19 * `AD7384 <https://www.analog.com/en/products/
20 * `AD7386 <https://www.analog.com/en/products/
21 * `AD7387 <https://www.analog.com/en/products/
22 * `AD7388 <https://www.analog.com/en/products/
23 * `AD7380-4 <https://www.analog.com/en/product
24 * `AD7381-4 <https://www.analog.com/en/product
25 * `AD7383-4 <https://www.analog.com/en/product
26 * `AD7384-4 <https://www.analog.com/en/product
27 * `AD7386-4 <https://www.analog.com/en/product
28 * `AD7387-4 <https://www.analog.com/en/product
29 * `AD7388-4 <https://www.analog.com/en/product
30
31
32 Supported features
33 ==================
34
35 SPI wiring modes
36 ----------------
37
38 ad738x ADCs can output data on several SDO lin
39 supports only 1 SDO line.
40
41 Reference voltage
42 -----------------
43
44 ad7380-4
45 ~~~~~~~~
46
47 ad7380-4 supports only an external reference v
48 declared in the device tree as ``refin-supply`
49
50 All other devices from ad738x family
51 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
52
53 All other devices from ad738x support 2 possib
54
55 - Internal reference (2.5V)
56 - External reference (2.5V to 3.3V)
57
58 The source is determined by the device tree. I
59 then it is used as external reference, else th
60
61 Oversampling and resolution boost
62 ---------------------------------
63
64 This family supports 2 types of oversampling:
65 average. Only normal average is supported by t
66 be achieved by processing a captured data buff
67 available: 1 (oversampling disabled)/2/4/8/16/
68
69 When the on-chip oversampling function is enab
70 exceed the default resolution. To accommodate
71 it is possible to enable an additional two bit
72 resolution boost feature can only be enabled w
73 oversampling is not as useful without the reso
74 automatically enables the resolution boost if
75 enabled.
76
77 Since the resolution boost feature causes 16-b
78 which means the storagebits has to change from
79 ext_scan_type feature to allow changing the sc
80 libiio does not support it. So when enabling o
81 must restart iiod using the following command:
82
83 .. code-block:: bash
84
85 root:~# systemctl restart iiod
86
87 Channel selection and sequencer (single-end ch
88 ----------------------------------------------
89
90 Single-ended chips of this family (ad7386/7/8(
91 front of each ADC. They also include additiona
92 allow for either manual selection or automatic
93 the multiplexer inputs.
94
95 From an IIO point of view, all inputs are expo
96 export 4 channels and ad7386-4/7-4/8-4 export
97
98 Inputs ``AinX0`` of multiplexers correspond to
99 0-1 or 0-3) and inputs ``AinX1`` correspond to
100 Example for AD7386/7/8 (2 channels parts):
101
102 .. code-block::
103
104 IIO | AD7386/7/8
105 | +------------------
106 | | _____
107 | | | | |
108 voltage0 | AinA0 --|--->| | |
109 | | | mux |----->|
110 voltage2 | AinA1 --|--->| | |
111 | | |_____| |
112 | | _____
113 | | | | |
114 voltage1 | AinB0 --|--->| | |
115 | | | mux |----->|
116 voltage3 | AinB1 --|--->| | |
117 | | |_____| |
118 | |
119 | +------------------
120
121
122 When enabling sequencer mode, the effective sa
123
124 Unimplemented features
125 ----------------------
126
127 - 2/4 SDO lines
128 - Rolling average oversampling
129 - Power down mode
130 - CRC indication
131 - Alert
132
133
134 Device buffers
135 ==============
136
137 This driver supports IIO triggered buffers.
138
139 See :doc:`iio_devbuf` for more information.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.