Commit | Line | Data |
---|---|---|
59ac8367 HR |
1 | Kernel driver smsc47m192 |
2 | ======================== | |
3 | ||
4 | Supported chips: | |
5 | * SMSC LPC47M192 and LPC47M997 | |
6 | Prefix: 'smsc47m192' | |
7 | Addresses scanned: I2C 0x2c - 0x2d | |
8 | Datasheet: The datasheet for LPC47M192 is publicly available from | |
9 | http://www.smsc.com/ | |
10 | The LPC47M997 is compatible for hardware monitoring. | |
11 | ||
12 | Author: Hartmut Rick <linux@rick.claranet.de> | |
13 | Special thanks to Jean Delvare for careful checking | |
14 | of the code and many helpful comments and suggestions. | |
15 | ||
16 | ||
17 | Description | |
18 | ----------- | |
19 | ||
20 | This driver implements support for the hardware sensor capabilities | |
21 | of the SMSC LPC47M192 and LPC47M997 Super-I/O chips. | |
22 | ||
23 | These chips support 3 temperature channels and 8 voltage inputs | |
24 | as well as CPU voltage VID input. | |
25 | ||
26 | They do also have fan monitoring and control capabilities, but the | |
27 | these features are accessed via ISA bus and are not supported by this | |
28 | driver. Use the 'smsc47m1' driver for fan monitoring and control. | |
29 | ||
30 | Voltages and temperatures are measured by an 8-bit ADC, the resolution | |
31 | of the temperatures is 1 bit per degree C. | |
32 | Voltages are scaled such that the nominal voltage corresponds to | |
33 | 192 counts, i.e. 3/4 of the full range. Thus the available range for | |
34 | each voltage channel is 0V ... 255/192*(nominal voltage), the resolution | |
35 | is 1 bit per (nominal voltage)/192. | |
36 | Both voltage and temperature values are scaled by 1000, the sys files | |
37 | show voltages in mV and temperatures in units of 0.001 degC. | |
38 | ||
39 | The +12V analog voltage input channel (in4_input) is multiplexed with | |
40 | bit 4 of the encoded CPU voltage. This means that you either get | |
41 | a +12V voltage measurement or a 5 bit CPU VID, but not both. | |
42 | The default setting is to use the pin as 12V input, and use only 4 bit VID. | |
43 | This driver assumes that the information in the configuration register | |
44 | is correct, i.e. that the BIOS has updated the configuration if | |
45 | the motherboard has this input wired to VID4. | |
46 | ||
47 | The temperature and voltage readings are updated once every 1.5 seconds. | |
48 | Reading them more often repeats the same values. | |
49 | ||
50 | ||
51 | sysfs interface | |
52 | --------------- | |
53 | ||
54 | in0_input - +2.5V voltage input | |
55 | in1_input - CPU voltage input (nominal 2.25V) | |
56 | in2_input - +3.3V voltage input | |
57 | in3_input - +5V voltage input | |
58 | in4_input - +12V voltage input (may be missing if used as VID4) | |
59 | in5_input - Vcc voltage input (nominal 3.3V) | |
60 | This is the supply voltage of the sensor chip itself. | |
61 | in6_input - +1.5V voltage input | |
62 | in7_input - +1.8V voltage input | |
63 | ||
64 | in[0-7]_min, | |
65 | in[0-7]_max - lower and upper alarm thresholds for in[0-7]_input reading | |
66 | ||
67 | All voltages are read and written in mV. | |
68 | ||
69 | in[0-7]_alarm - alarm flags for voltage inputs | |
70 | These files read '1' in case of alarm, '0' otherwise. | |
71 | ||
72 | temp1_input - chip temperature measured by on-chip diode | |
73 | temp[2-3]_input - temperature measured by external diodes (one of these would | |
74 | typically be wired to the diode inside the CPU) | |
75 | ||
76 | temp[1-3]_min, | |
77 | temp[1-3]_max - lower and upper alarm thresholds for temperatures | |
78 | ||
79 | temp[1-3]_offset - temperature offset registers | |
80 | The chip adds the offsets stored in these registers to | |
81 | the corresponding temperature readings. | |
82 | Note that temp1 and temp2 offsets share the same register, | |
83 | they cannot both be different from zero at the same time. | |
84 | Writing a non-zero number to one of them will reset the other | |
85 | offset to zero. | |
86 | ||
87 | All temperatures and offsets are read and written in | |
88 | units of 0.001 degC. | |
89 | ||
90 | temp[1-3]_alarm - alarm flags for temperature inputs, '1' in case of alarm, | |
91 | '0' otherwise. | |
92 | temp[2-3]_input_fault - diode fault flags for temperature inputs 2 and 3. | |
93 | A fault is detected if the two pins for the corresponding | |
94 | sensor are open or shorted, or any of the two is shorted | |
95 | to ground or Vcc. '1' indicates a diode fault. | |
96 | ||
97 | cpu0_vid - CPU voltage as received from the CPU | |
98 | ||
99 | vrm - CPU VID standard used for decoding CPU voltage | |
100 | ||
101 | The *_min, *_max, *_offset and vrm files can be read and | |
102 | written, all others are read-only. |