1 Kernel driver amc6821 1 Kernel driver amc6821
2 ===================== 2 =====================
3 3
4 Supported chips: 4 Supported chips:
5 5
6 Texas Instruments AMC6821 6 Texas Instruments AMC6821
7 7
8 Prefix: 'amc6821' 8 Prefix: 'amc6821'
9 9
10 Addresses scanned: 0x18, 0x19, 0x1a, 0 10 Addresses scanned: 0x18, 0x19, 0x1a, 0x2c, 0x2d, 0x2e, 0x4c, 0x4d, 0x4e
11 11
12 Datasheet: http://focus.ti.com/docs/pr 12 Datasheet: http://focus.ti.com/docs/prod/folders/print/amc6821.html
13 13
14 Authors: 14 Authors:
15 Tomaz Mertelj <tomaz.mertelj@guest.arne 15 Tomaz Mertelj <tomaz.mertelj@guest.arnes.si>
16 16
17 17
18 Description 18 Description
19 ----------- 19 -----------
20 20
21 This driver implements support for the Texas I 21 This driver implements support for the Texas Instruments amc6821 chip.
22 The chip has one on-chip and one remote temper 22 The chip has one on-chip and one remote temperature sensor and one pwm fan
23 regulator. 23 regulator.
24 The pwm can be controlled either from software 24 The pwm can be controlled either from software or automatically.
25 25
26 The driver provides the following sensor acces 26 The driver provides the following sensor accesses in sysfs:
27 27
28 ======================= == ============== 28 ======================= == ===============================================
29 temp1_input ro on-chip temper 29 temp1_input ro on-chip temperature
30 temp1_min rw " 30 temp1_min rw "
31 temp1_max rw " 31 temp1_max rw "
32 temp1_crit rw " 32 temp1_crit rw "
33 temp1_min_alarm ro " 33 temp1_min_alarm ro "
34 temp1_max_alarm ro " 34 temp1_max_alarm ro "
35 temp1_crit_alarm ro " 35 temp1_crit_alarm ro "
36 36
37 temp2_input ro remote tempera 37 temp2_input ro remote temperature
38 temp2_min rw " 38 temp2_min rw "
39 temp2_max rw " 39 temp2_max rw "
40 temp2_crit rw " 40 temp2_crit rw "
41 temp2_min_alarm ro " 41 temp2_min_alarm ro "
42 temp2_max_alarm ro " 42 temp2_max_alarm ro "
43 temp2_crit_alarm ro " 43 temp2_crit_alarm ro "
44 temp2_fault ro " 44 temp2_fault ro "
45 45
46 fan1_input ro tachometer spe 46 fan1_input ro tachometer speed
47 fan1_min rw " 47 fan1_min rw "
48 fan1_max rw " 48 fan1_max rw "
49 fan1_fault ro " 49 fan1_fault ro "
50 fan1_pulses rw Pulses per rev !! 50 fan1_div rw Fan divisor can be either 2 or 4.
51 fan1_target rw Target fan spe <<
52 mode 4. <<
53 51
54 pwm1 rw pwm1 52 pwm1 rw pwm1
55 pwm1_enable rw regulator mode 53 pwm1_enable rw regulator mode, 1=open loop, 2=fan controlled
56 by remote temp 54 by remote temperature, 3=fan controlled by
57 combination of 55 combination of the on-chip temperature and
58 remote-sensor 56 remote-sensor temperature,
59 4=fan controll <<
60 fan1_target at <<
61 pwm1_mode rw Fan duty contr <<
62 pwm1_auto_channels_temp ro 1 if pwm_enabl 57 pwm1_auto_channels_temp ro 1 if pwm_enable==2, 3 if pwm_enable==3
63 pwm1_auto_point1_pwm ro Hardwired to 0 58 pwm1_auto_point1_pwm ro Hardwired to 0, shared for both
64 temperature ch 59 temperature channels.
65 pwm1_auto_point2_pwm rw This value is 60 pwm1_auto_point2_pwm rw This value is shared for both temperature
66 channels. 61 channels.
67 pwm1_auto_point3_pwm rw Hardwired to 2 62 pwm1_auto_point3_pwm rw Hardwired to 255, shared for both
68 temperature ch 63 temperature channels.
69 64
70 temp1_auto_point1_temp ro Hardwired to t 65 temp1_auto_point1_temp ro Hardwired to temp2_auto_point1_temp
71 which is rw. B 66 which is rw. Below this temperature fan stops.
72 temp1_auto_point2_temp rw The low-temper 67 temp1_auto_point2_temp rw The low-temperature limit of the proportional
73 range. Below t 68 range. Below this temperature
74 pwm1 = pwm1_au 69 pwm1 = pwm1_auto_point2_pwm. It can go from
75 0 degree C to 70 0 degree C to 124 degree C in steps of
76 4 degree C. Re 71 4 degree C. Read it out after writing to get
77 the actual val 72 the actual value.
78 temp1_auto_point3_temp rw Above this tem 73 temp1_auto_point3_temp rw Above this temperature fan runs at maximum
79 speed. It can 74 speed. It can go from temp1_auto_point2_temp.
80 It can only ha 75 It can only have certain discrete values
81 which depend o 76 which depend on temp1_auto_point2_temp and
82 pwm1_auto_poin 77 pwm1_auto_point2_pwm. Read it out after
83 writing to get 78 writing to get the actual value.
84 79
85 temp2_auto_point1_temp rw Must be betwee 80 temp2_auto_point1_temp rw Must be between 0 degree C and 63 degree C and
86 it defines the 81 it defines the passive cooling temperature.
87 Below this tem 82 Below this temperature the fan stops in
88 the closed loo 83 the closed loop mode.
89 temp2_auto_point2_temp rw The low-temper 84 temp2_auto_point2_temp rw The low-temperature limit of the proportional
90 range. Below t 85 range. Below this temperature
91 pwm1 = pwm1_au 86 pwm1 = pwm1_auto_point2_pwm. It can go from
92 0 degree C to 87 0 degree C to 124 degree C in steps
93 of 4 degree C. 88 of 4 degree C.
94 89
95 temp2_auto_point3_temp rw Above this tem 90 temp2_auto_point3_temp rw Above this temperature fan runs at maximum
96 speed. It can 91 speed. It can only have certain discrete
97 values which d 92 values which depend on temp2_auto_point2_temp
98 and pwm1_auto_ 93 and pwm1_auto_point2_pwm. Read it out after
99 writing to get 94 writing to get actual value.
100 ======================= == ============== 95 ======================= == ===============================================
101 96
102 97
103 Module parameters 98 Module parameters
104 ----------------- 99 -----------------
105 100
106 If your board has a BIOS that initializes the 101 If your board has a BIOS that initializes the amc6821 correctly, you should
107 load the module with: init=0. 102 load the module with: init=0.
108 103
109 If your board BIOS doesn't initialize the chip 104 If your board BIOS doesn't initialize the chip, or you want
110 different settings, you can set the following 105 different settings, you can set the following parameters:
111 106
112 - init=1, 107 - init=1,
113 - pwminv: 0 default pwm output, 1 inverts pwm 108 - pwminv: 0 default pwm output, 1 inverts pwm output.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.