1 Kernel driver thmc50 1 Kernel driver thmc50
2 ===================== 2 =====================
3 3
4 Supported chips: 4 Supported chips:
5 5
6 * Analog Devices ADM1022 6 * Analog Devices ADM1022
7 7
8 Prefix: 'adm1022' 8 Prefix: 'adm1022'
9 9
10 Addresses scanned: I2C 0x2c - 0x2e 10 Addresses scanned: I2C 0x2c - 0x2e
11 11
12 Datasheet: http://www.analog.com/en/prod/0 12 Datasheet: http://www.analog.com/en/prod/0,2877,ADM1022,00.html
13 13
14 * Texas Instruments THMC50 14 * Texas Instruments THMC50
15 15
16 Prefix: 'thmc50' 16 Prefix: 'thmc50'
17 17
18 Addresses scanned: I2C 0x2c - 0x2e 18 Addresses scanned: I2C 0x2c - 0x2e
19 19
20 Datasheet: https://www.ti.com/ 20 Datasheet: https://www.ti.com/
21 21
22 22
23 Author: Krzysztof Helt <krzysztof.h1@wp.pl> 23 Author: Krzysztof Helt <krzysztof.h1@wp.pl>
24 24
25 This driver was derived from the 2.4 kernel th 25 This driver was derived from the 2.4 kernel thmc50.c source file.
26 26
27 Credits: 27 Credits:
28 28
29 thmc50.c (2.4 kernel): 29 thmc50.c (2.4 kernel):
30 30
31 - Frodo Looijaard <frodol@dds.nl> 31 - Frodo Looijaard <frodol@dds.nl>
32 - Philip Edelbrock <phil@netroedge.com> 32 - Philip Edelbrock <phil@netroedge.com>
33 33
34 Module Parameters 34 Module Parameters
35 ----------------- 35 -----------------
36 36
37 * adm1022_temp3: short array 37 * adm1022_temp3: short array
38 List of adapter,address pairs to force chi 38 List of adapter,address pairs to force chips into ADM1022 mode with
39 second remote temperature. This does not w 39 second remote temperature. This does not work for original THMC50 chips.
40 40
41 Description 41 Description
42 ----------- 42 -----------
43 43
44 The THMC50 implements: an internal temperature 44 The THMC50 implements: an internal temperature sensor, support for an
45 external diode-type temperature sensor (compat 45 external diode-type temperature sensor (compatible w/ the diode sensor inside
46 many processors), and a controllable fan/analo 46 many processors), and a controllable fan/analog_out DAC. For the temperature
47 sensors, limits can be set through the appropr 47 sensors, limits can be set through the appropriate Overtemperature Shutdown
48 register and Hysteresis register. Each value c 48 register and Hysteresis register. Each value can be set and read to half-degree
49 accuracy. An alarm is issued (usually to a co 49 accuracy. An alarm is issued (usually to a connected LM78) when the
50 temperature gets higher then the Overtemperatu 50 temperature gets higher then the Overtemperature Shutdown value; it stays on
51 until the temperature falls below the Hysteres 51 until the temperature falls below the Hysteresis value. All temperatures are in
52 degrees Celsius, and are guaranteed within a r 52 degrees Celsius, and are guaranteed within a range of -55 to +125 degrees.
53 53
54 The THMC50 only updates its values each 1.5 se 54 The THMC50 only updates its values each 1.5 seconds; reading it more often
55 will do no harm, but will return 'old' values. 55 will do no harm, but will return 'old' values.
56 56
57 The THMC50 is usually used in combination with 57 The THMC50 is usually used in combination with LM78-like chips, to measure
58 the temperature of the processor(s). 58 the temperature of the processor(s).
59 59
60 The ADM1022 works the same as THMC50 but it is 60 The ADM1022 works the same as THMC50 but it is faster (5 Hz instead of
61 1 Hz for THMC50). It can be also put in a new 61 1 Hz for THMC50). It can be also put in a new mode to handle additional
62 remote temperature sensor. The driver use the 62 remote temperature sensor. The driver use the mode set by BIOS by default.
63 63
64 In case the BIOS is broken and the mode is set 64 In case the BIOS is broken and the mode is set incorrectly, you can force
65 the mode with additional remote temperature wi 65 the mode with additional remote temperature with adm1022_temp3 parameter.
66 A typical symptom of wrong setting is a fan fo 66 A typical symptom of wrong setting is a fan forced to full speed.
67 67
68 Driver Features 68 Driver Features
69 --------------- 69 ---------------
70 70
71 The driver provides up to three temperatures: 71 The driver provides up to three temperatures:
72 72
73 temp1 73 temp1
74 - internal 74 - internal
75 temp2 75 temp2
76 - remote 76 - remote
77 temp3 77 temp3
78 - 2nd remote only for ADM1022 78 - 2nd remote only for ADM1022
79 79
80 pwm1 80 pwm1
81 - fan speed (0 = stop, 255 = full) 81 - fan speed (0 = stop, 255 = full)
82 pwm1_mode 82 pwm1_mode
83 - always 0 (DC mode) 83 - always 0 (DC mode)
84 84
85 The value of 0 for pwm1 also forces FAN_OFF si 85 The value of 0 for pwm1 also forces FAN_OFF signal from the chip,
86 so it stops fans even if the value 0 into the 86 so it stops fans even if the value 0 into the ANALOG_OUT register does not.
87 87
88 The driver was tested on Compaq AP550 with two 88 The driver was tested on Compaq AP550 with two ADM1022 chips (one works
89 in the temp3 mode), five temperature readings 89 in the temp3 mode), five temperature readings and two fans.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.