root/lm-sensors/trunk/doc/chips/thmc50 @ 746

Revision 746, 3.4 KB (checked in by mds, 14 years ago)

(mds) fix spelling of 'hysteresis'

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
Line 
1Kernel driver `thmc50.o'
2=====================
3
4Status: Complete and some-what tested
5
6Supported chips:
7  * Analog Devices ADM1022
8    Prefix: `adm1022'
9    Addresses scanned: I2C 0x2D - 0x2F (inclusive)
10    Datasheet: Publicly available at the Analog Devices website
11  * Texas Instruments THMC50
12    Prefix: `thmc50'
13    Addresses scanned: I2C 0x2D - 0x2F (inclusive)
14    Datasheet: Publicly available at the Texas Instruments' website
15
16Authors: Frodo Looijaard <frodol@dds.nl> and
17         Philip Edelbrock <phil@netroedge.com>
18
19
20Module Parameters
21-----------------
22
23* force: short array (min = 1, max = 48)
24  List of adapter,address pairs to boldly assume to be present
25* force_thmc50: short array (min = 1, max = 48)
26  List of adapter,address pairs which are unquestionably assumed to contain
27  a `thmc50' chip
28* ignore: short array (min = 1, max = 48)
29  List of adapter,address pairs not to scan
30* ignore_range: short array (min = 1, max = 48)
31  List of adapter,start-addr,end-addr triples not to scan
32* probe: short array (min = 1, max = 48)
33  List of adapter,address pairs to scan additionally
34* probe_range: short array (min = 1, max = 48)
35  List of adapter,start-addr,end-addr triples to scan additionally
36
37
38Description
39-----------
40
41The THMC50 implements: an internal temperature sensors, support for an
42external diode-type temperature sensor (compatible w/ the diode sensor inside
43many processors), and a controllable fan/analog_out DAC. For the temperature
44sensors, limits can be set through the appropriate Overtemperature Shutdown
45register and Hysteresis register. Each value can be set and read to half-degree
46accuracy.  An alarm is issued (usually to a connected LM78) when the
47temperature gets higher then the Overtemperature Shutdown value; it stays on
48until the temperature falls below the Hysteresis value. All temperatures are in
49degrees Celcius, and are guaranteed within a range of -55 to +125 degrees.
50
51The THMC50 only updates its values each 1.5 seconds; reading it more often
52will do no harm, but will return 'old' values.
53
54The THMC50 is usually used in combination with LM78-like chips, to measure
55the temperature of the processor(s).
56
57
58Driver Features
59---------------
60
61These are the files which are provided by the driver (ro=read-only,
62rw=read and writeable):
63
64temp --         Three fields: [temp-os,rw] [temp-hyst,rw] [temp,ro]
65remote_temp --  Three fields: [temp-os,rw] [temp-hyst,rw] [temp,ro]
66
67temp-os, temp-hyst, and temp are whole degree integers representing degrees
68celcius.
69
70analog_out --   One field: [output-value,rw]
71
72output-value is a number from 0 to 255 representing the voltage output
73provided by the DAC from 0 to 2.5, respectively.  Note: the max *current*
74supplied is actually quite low.  Some type of current amplification is needed
75in order to control a fan or other current demanding device (see the
76datasheet for more info).
77
78die_code --     One field: [die-code,ro]
79
80die-code is an integer representation of the die_code byte register.
81According to the docs, the high nibble is the die version, and the lower
82nibble is the stepping.  (Don't ask me why or what this means! ;')
83
84inter --        One field: [interrupts,rw]
85
86interrupts is an integer representation of the interrupts byte.  See the data
87sheet for what bits mean what.
88
89inter_mask --   One field: [inter-mask,rw]
90
91inter-mask is an integer repressentation of the interrupt mask which is a
92determination of which conditions can cause the /INT pin on the chip to
93become asserted.
94
95
96
Note: See TracBrowser for help on using the browser.