Blame view

Documentation/hwmon/lm87 3.06 KB
7f15b6646   Rudolf Marek   [PATCH] I2C: docu...
1
2
3
4
5
6
  Kernel driver lm87
  ==================
  
  Supported chips:
    * National Semiconductor LM87
      Prefix: 'lm87'
c7fa37379   Jean Delvare   hwmon: (lm87) Add...
7
      Addresses scanned: I2C 0x2c - 0x2e
7f15b6646   Rudolf Marek   [PATCH] I2C: docu...
8
      Datasheet: http://www.national.com/pf/LM/LM87.html
c7fa37379   Jean Delvare   hwmon: (lm87) Add...
9
10
11
12
    * Analog Devices ADM1024
      Prefix: 'adm1024'
      Addresses scanned: I2C 0x2c - 0x2e
      Datasheet: http://www.analog.com/en/prod/0,2877,ADM1024,00.html
7f15b6646   Rudolf Marek   [PATCH] I2C: docu...
13
14
15
16
17
18
19
20
21
22
23
24
  
  Authors:
          Frodo Looijaard <frodol@dds.nl>,
          Philip Edelbrock <phil@netroedge.com>,
          Mark Studebaker <mdsxyz123@yahoo.com>,
          Stephen Rousset <stephen.rousset@rocketlogix.com>,
          Dan Eaton <dan.eaton@rocketlogix.com>,
          Jean Delvare <khali@linux-fr.org>,
          Original 2.6 port Jeff Oliver
  
  Description
  -----------
c7fa37379   Jean Delvare   hwmon: (lm87) Add...
25
26
  This driver implements support for the National Semiconductor LM87
  and the Analog Devices ADM1024.
7f15b6646   Rudolf Marek   [PATCH] I2C: docu...
27
28
29
  
  The LM87 implements up to three temperature sensors, up to two fan
  rotation speed sensors, up to seven voltage sensors, alarms, and some
c7fa37379   Jean Delvare   hwmon: (lm87) Add...
30
  miscellaneous stuff. The ADM1024 is fully compatible.
7f15b6646   Rudolf Marek   [PATCH] I2C: docu...
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
  
  Temperatures are measured in degrees Celsius. Each input has a high
  and low alarm settings. A high limit produces an alarm when the value
  goes above it, and an alarm is also produced when the value goes below
  the low limit.
  
  Fan rotation speeds are reported in RPM (rotations per minute). An alarm is
  triggered if the rotation speed has dropped below a programmable limit. Fan
  readings can be divided by a programmable divider (1, 2, 4 or 8) to give
  the readings more range or accuracy. Not all RPM values can accurately be
  represented, so some rounding is done. With a divider of 2, the lowest
  representable value is around 2600 RPM.
  
  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.
  
  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! Note that in the current implementation, all
  hardware registers are read whenever any data is read (unless it is less
  than 1.0 seconds since the last update). This means that you can easily
  miss once-only alarms.
  
  The lm87 driver only updates its values each 1.0 seconds; reading it more
  often will do no harm, but will return 'old' values.
  
  
  Hardware Configurations
  -----------------------
  
  The LM87 has four pins which can serve one of two possible functions,
  depending on the hardware configuration.
  
  Some functions share pins, so not all functions are available at the same
47064d645   Ben Hutchings   hwmon: (lm87) Add...
67
68
69
70
  time. Which are depends on the hardware setup. This driver normally
  assumes that firmware configured the chip correctly. Where this is not
  the case, platform code must set the I2C client's platform_data to point
  to a u8 value to be written to the channel register.
7f15b6646   Rudolf Marek   [PATCH] I2C: docu...
71
72
73
74
75
76
  
  For reference, here is the list of exclusive functions:
   - in0+in5 (default) or temp3
   - fan1 (default) or in6
   - fan2 (default) or in7
   - VID lines (default) or IRQ lines (not handled by this driver)