Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/mason/linux...
[firefly-linux-kernel-4.4.55.git] / Documentation / hwmon / adt7410
1 Kernel driver adt7410
2 =====================
3
4 Supported chips:
5   * Analog Devices ADT7410
6     Prefix: 'adt7410'
7     Addresses scanned: None
8     Datasheet: Publicly available at the Analog Devices website
9                http://www.analog.com/static/imported-files/data_sheets/ADT7410.pdf
10   * Analog Devices ADT7420
11     Prefix: 'adt7420'
12     Addresses scanned: None
13     Datasheet: Publicly available at the Analog Devices website
14                http://www.analog.com/static/imported-files/data_sheets/ADT7420.pdf
15
16 Author: Hartmut Knaack <knaack.h@gmx.de>
17
18 Description
19 -----------
20
21 The ADT7410 is a temperature sensor with rated temperature range of -55°C to
22 +150°C. It has a high accuracy of +/-0.5°C and can be operated at a resolution
23 of 13 bits (0.0625°C) or 16 bits (0.0078°C). The sensor provides an INT pin to
24 indicate that a minimum or maximum temperature set point has been exceeded, as
25 well as a critical temperature (CT) pin to indicate that the critical
26 temperature set point has been exceeded. Both pins can be set up with a common
27 hysteresis of 0°C - 15°C and a fault queue, ranging from 1 to 4 events. Both
28 pins can individually set to be active-low or active-high, while the whole
29 device can either run in comparator mode or interrupt mode. The ADT7410
30 supports continous temperature sampling, as well as sampling one temperature
31 value per second or even justget one sample on demand for power saving.
32 Besides, it can completely power down its ADC, if power management is
33 required.
34
35 The ADT7420 is register compatible, the only differences being the package,
36 a slightly narrower operating temperature range (-40°C to +150°C), and a
37 better accuracy (0.25°C instead of 0.50°C.)
38
39 Configuration Notes
40 -------------------
41
42 Since the device uses one hysteresis value, which is an offset to minimum,
43 maximum and critical temperature, it can only be set for temp#_max_hyst.
44 However, temp#_min_hyst and temp#_crit_hyst show their corresponding
45 hysteresis.
46 The device is set to 16 bit resolution and comparator mode.
47
48 sysfs-Interface
49 ---------------
50
51 temp#_input             - temperature input
52 temp#_min               - temperature minimum setpoint
53 temp#_max               - temperature maximum setpoint
54 temp#_crit              - critical temperature setpoint
55 temp#_min_hyst          - hysteresis for temperature minimum (read-only)
56 temp#_max_hyst          - hysteresis for temperature maximum (read/write)
57 temp#_crit_hyst         - hysteresis for critical temperature (read-only)
58 temp#_min_alarm         - temperature minimum alarm flag
59 temp#_max_alarm         - temperature maximum alarm flag
60 temp#_crit_alarm        - critical temperature alarm flag