xref: /linux/Documentation/hwmon/adt7410.rst (revision 8e07e0e3964ca4e23ce7b68e2096fe660a888942)
1Kernel driver adt7410
2=====================
3
4Supported chips:
5
6  * Analog Devices ADT7410
7
8    Prefix: 'adt7410'
9
10    Addresses scanned: None
11
12    Datasheet: Publicly available at the Analog Devices website
13
14	       https://www.analog.com/static/imported-files/data_sheets/ADT7410.pdf
15  * Analog Devices ADT7420
16
17    Prefix: 'adt7420'
18
19    Addresses scanned: None
20
21    Datasheet: Publicly available at the Analog Devices website
22
23	       https://www.analog.com/static/imported-files/data_sheets/ADT7420.pdf
24
25  * Analog Devices ADT7310
26
27    Prefix: 'adt7310'
28
29    Addresses scanned: None
30
31    Datasheet: Publicly available at the Analog Devices website
32
33	       https://www.analog.com/static/imported-files/data_sheets/ADT7310.pdf
34
35  * Analog Devices ADT7320
36
37    Prefix: 'adt7320'
38
39    Addresses scanned: None
40
41    Datasheet: Publicly available at the Analog Devices website
42
43	       https://www.analog.com/static/imported-files/data_sheets/ADT7320.pdf
44
45Author: Hartmut Knaack <knaack.h@gmx.de>
46
47Description
48-----------
49
50The ADT7310/ADT7410 is a temperature sensor with rated temperature range of
51-55°C to +150°C. It has a high accuracy of +/-0.5°C and can be operated at a
52resolution of 13 bits (0.0625°C) or 16 bits (0.0078°C). The sensor provides an
53INT pin to indicate that a minimum or maximum temperature set point has been
54exceeded, as well as a critical temperature (CT) pin to indicate that the
55critical temperature set point has been exceeded. Both pins can be set up with a
56common hysteresis of 0°C - 15°C and a fault queue, ranging from 1 to 4 events.
57Both pins can individually set to be active-low or active-high, while the whole
58device can either run in comparator mode or interrupt mode. The ADT7410 supports
59continuous temperature sampling, as well as sampling one temperature value per
60second or even just get one sample on demand for power saving. Besides, it can
61completely power down its ADC, if power management is required.
62
63The ADT7320/ADT7420 is register compatible, the only differences being the
64package, a slightly narrower operating temperature range (-40°C to +150°C), and
65a better accuracy (0.25°C instead of 0.50°C.)
66
67The difference between the ADT7310/ADT7320 and ADT7410/ADT7420 is the control
68interface, the ADT7310 and ADT7320 use SPI while the ADT7410 and ADT7420 use
69I2C.
70
71Configuration Notes
72-------------------
73
74Since the device uses one hysteresis value, which is an offset to minimum,
75maximum and critical temperature, it can only be set for temp#_max_hyst.
76However, temp#_min_hyst and temp#_crit_hyst show their corresponding
77hysteresis.
78The device is set to 16 bit resolution and comparator mode.
79
80sysfs-Interface
81---------------
82
83======================== ====================================================
84temp#_input		 temperature input
85temp#_min		 temperature minimum setpoint
86temp#_max		 temperature maximum setpoint
87temp#_crit		 critical temperature setpoint
88temp#_min_hyst		 hysteresis for temperature minimum (read-only)
89temp#_max_hyst		 hysteresis for temperature maximum (read/write)
90temp#_crit_hyst		 hysteresis for critical temperature (read-only)
91temp#_min_alarm		 temperature minimum alarm flag
92temp#_max_alarm		 temperature maximum alarm flag
93temp#_crit_alarm	 critical temperature alarm flag
94======================== ====================================================
95