Blame view

Documentation/hwmon/adc128d818 1.97 KB
b4c9c1a79   Guenter Roeck   hwmon: Driver for...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
  Kernel driver adc128d818
  ========================
  
  Supported chips:
    * Texas Instruments ADC818D818
      Prefix: 'adc818d818'
      Addresses scanned: I2C 0x1d, 0x1e, 0x1f, 0x2d, 0x2e, 0x2f
      Datasheet: Publicly available at the TI website
                 http://www.ti.com/
  
  Author: Guenter Roeck
  
  Description
  -----------
  
  This driver implements support for the Texas Instruments ADC128D818.
  It is described as 'ADC System Monitor with Temperature Sensor'.
  
  The ADC128D818 implements one temperature sensor and seven voltage sensors.
  
  Temperatures are measured in degrees Celsius. There is one set of limits.
  When the HOT Temperature Limit is crossed, this will cause an alarm that will
  be reasserted until the temperature drops below the HOT Hysteresis.
  Measurements are guaranteed between -55 and +125 degrees. The temperature
  measurement has a resolution of 0.5 degrees; the limits have a resolution
  of 1 degree.
  
  Voltage sensors (also known as IN sensors) report their values in volts.
  An alarm is triggered if the voltage has crossed a programmable minimum
  or maximum limit. Note that minimum in this case always means 'closest to
  zero'; this is important for negative voltage measurements. All voltage
  inputs can measure voltages between 0 and 2.55 volts, with a resolution
  of 0.625 mV.
  
  If an alarm triggers, it will remain triggered until the hardware register
  is read at least once. This means that the cause for the alarm may
  already have disappeared by the time the alarm is read. The driver
  caches the alarm status for each sensor until it is at least reported
  once, to ensure that alarms are reported to user space.
  
  The ADC128D818 only updates its values approximately once per second;
  reading it more often will do no harm, but will return 'old' values.
  
  In addition to the scanned address list, the chip can also be configured for
  addresses 0x35 to 0x37. Those addresses are not scanned. You have to instantiate
  the driver explicitly if the chip is configured for any of those addresses in
  your system.