^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) Kernel driver ads7828
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) =====================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) Supported chips:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) * Texas Instruments/Burr-Brown ADS7828
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) Prefix: 'ads7828'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) Datasheet: Publicly available at the Texas Instruments website:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) http://focus.ti.com/lit/ds/symlink/ads7828.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) * Texas Instruments ADS7830
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) Prefix: 'ads7830'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) Datasheet: Publicly available at the Texas Instruments website:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) http://focus.ti.com/lit/ds/symlink/ads7830.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) Authors:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) - Steve Hardy <shardy@redhat.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) - Vivien Didelot <vivien.didelot@savoirfairelinux.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) - Guillaume Roguez <guillaume.roguez@savoirfairelinux.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) Platform data
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) -------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) The ads7828 driver accepts an optional ads7828_platform_data structure (defined
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) in include/linux/platform_data/ads7828.h). The structure fields are:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) * diff_input: (bool) Differential operation
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) set to true for differential mode, false for default single ended mode.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) * ext_vref: (bool) External reference
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) set to true if it operates with an external reference, false for default
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) internal reference.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) * vref_mv: (unsigned int) Voltage reference
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) if using an external reference, set this to the reference voltage in mV,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) otherwise it will default to the internal value (2500mV). This value will be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) bounded with limits accepted by the chip, described in the datasheet.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) If no structure is provided, the configuration defaults to single ended
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) operation and internal voltage reference (2.5V).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) This driver implements support for the Texas Instruments ADS7828 and ADS7830.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) The ADS7828 device is a 12-bit 8-channel A/D converter, while the ADS7830 does
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) 8-bit sampling.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) It can operate in single ended mode (8 +ve inputs) or in differential mode,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) where 4 differential pairs can be measured.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) The chip also has the facility to use an external voltage reference. This
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) may be required if your hardware supplies the ADS7828 from a 5V supply, see
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) the datasheet for more details.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) There is no reliable way to identify this chip, so the driver will not scan
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) some addresses to try to auto-detect it. That means that you will have to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) statically declare the device in the platform support code.