Blame view

Documentation/hwmon/ads7828.rst 2.1 KB
5812f9283   Steve Hardy   hwmon: Add suppor...
1
2
3
4
  Kernel driver ads7828
  =====================
  
  Supported chips:
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
5

5812f9283   Steve Hardy   hwmon: Add suppor...
6
    * Texas Instruments/Burr-Brown ADS7828
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
7

5812f9283   Steve Hardy   hwmon: Add suppor...
8
      Prefix: 'ads7828'
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
9

46d784629   Vivien Didelot   hwmon: (ads7828) ...
10
      Datasheet: Publicly available at the Texas Instruments website:
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
11
12
  
  	       http://focus.ti.com/lit/ds/symlink/ads7828.pdf
5812f9283   Steve Hardy   hwmon: Add suppor...
13

0962e0f1a   Guillaume Roguez   hwmon: (ads7828) ...
14
    * Texas Instruments ADS7830
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
15

0962e0f1a   Guillaume Roguez   hwmon: (ads7828) ...
16
      Prefix: 'ads7830'
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
17

0962e0f1a   Guillaume Roguez   hwmon: (ads7828) ...
18
      Datasheet: Publicly available at the Texas Instruments website:
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
19
20
  
  	       http://focus.ti.com/lit/ds/symlink/ads7830.pdf
0962e0f1a   Guillaume Roguez   hwmon: (ads7828) ...
21

5812f9283   Steve Hardy   hwmon: Add suppor...
22
  Authors:
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
23
24
25
  	- Steve Hardy <shardy@redhat.com>
  	- Vivien Didelot <vivien.didelot@savoirfairelinux.com>
  	- Guillaume Roguez <guillaume.roguez@savoirfairelinux.com>
5812f9283   Steve Hardy   hwmon: Add suppor...
26

46d784629   Vivien Didelot   hwmon: (ads7828) ...
27
28
  Platform data
  -------------
5812f9283   Steve Hardy   hwmon: Add suppor...
29

46d784629   Vivien Didelot   hwmon: (ads7828) ...
30
31
32
33
  The ads7828 driver accepts an optional ads7828_platform_data structure (defined
  in include/linux/platform_data/ads7828.h). The structure fields are:
  
  * diff_input: (bool) Differential operation
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
34
      set to true for differential mode, false for default single ended mode.
46d784629   Vivien Didelot   hwmon: (ads7828) ...
35
36
  
  * ext_vref: (bool) External reference
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
37
38
      set to true if it operates with an external reference, false for default
      internal reference.
46d784629   Vivien Didelot   hwmon: (ads7828) ...
39
40
  
  * vref_mv: (unsigned int) Voltage reference
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
41
42
43
      if using an external reference, set this to the reference voltage in mV,
      otherwise it will default to the internal value (2500mV). This value will be
      bounded with limits accepted by the chip, described in the datasheet.
46d784629   Vivien Didelot   hwmon: (ads7828) ...
44
45
46
  
   If no structure is provided, the configuration defaults to single ended
   operation and internal voltage reference (2.5V).
5812f9283   Steve Hardy   hwmon: Add suppor...
47
48
49
  
  Description
  -----------
0962e0f1a   Guillaume Roguez   hwmon: (ads7828) ...
50
  This driver implements support for the Texas Instruments ADS7828 and ADS7830.
5812f9283   Steve Hardy   hwmon: Add suppor...
51

0962e0f1a   Guillaume Roguez   hwmon: (ads7828) ...
52
53
  The ADS7828 device is a 12-bit 8-channel A/D converter, while the ADS7830 does
  8-bit sampling.
5812f9283   Steve Hardy   hwmon: Add suppor...
54
55
56
57
58
59
60
  
  It can operate in single ended mode (8 +ve inputs) or in differential mode,
  where 4 differential pairs can be measured.
  
  The chip also has the facility to use an external voltage reference.  This
  may be required if your hardware supplies the ADS7828 from a 5V supply, see
  the datasheet for more details.
46d784629   Vivien Didelot   hwmon: (ads7828) ...
61
62
63
64
  
  There is no reliable way to identify this chip, so the driver will not scan
  some addresses to try to auto-detect it. That means that you will have to
  statically declare the device in the platform support code.