aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/hwmon
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/hwmon')
-rw-r--r--Documentation/hwmon/adt741051
-rw-r--r--Documentation/hwmon/coretemp1
-rw-r--r--Documentation/hwmon/da90522
-rw-r--r--Documentation/hwmon/exynos4_tmu81
-rw-r--r--Documentation/hwmon/ina2xx18
-rw-r--r--Documentation/hwmon/lm7012
-rw-r--r--Documentation/hwmon/max16192
-rw-r--r--Documentation/hwmon/max19760
-rw-r--r--Documentation/hwmon/mcp302123
-rw-r--r--Documentation/hwmon/submitting-patches3
-rw-r--r--Documentation/hwmon/twl4030-madc-hwmon2
11 files changed, 158 insertions, 97 deletions
diff --git a/Documentation/hwmon/adt7410 b/Documentation/hwmon/adt7410
new file mode 100644
index 000000000000..96004000dc2a
--- /dev/null
+++ b/Documentation/hwmon/adt7410
@@ -0,0 +1,51 @@
1Kernel driver adt7410
2=====================
3
4Supported chips:
5 * Analog Devices ADT7410
6 Prefix: 'adt7410'
7 Addresses scanned: I2C 0x48 - 0x4B
8 Datasheet: Publicly available at the Analog Devices website
9 http://www.analog.com/static/imported-files/data_sheets/ADT7410.pdf
10
11Author: Hartmut Knaack <knaack.h@gmx.de>
12
13Description
14-----------
15
16The ADT7410 is a temperature sensor with rated temperature range of -55°C to
17+150°C. It has a high accuracy of +/-0.5°C and can be operated at a resolution
18of 13 bits (0.0625°C) or 16 bits (0.0078°C). The sensor provides an INT pin to
19indicate that a minimum or maximum temperature set point has been exceeded, as
20well as a critical temperature (CT) pin to indicate that the critical
21temperature set point has been exceeded. Both pins can be set up with a common
22hysteresis of 0°C - 15°C and a fault queue, ranging from 1 to 4 events. Both
23pins can individually set to be active-low or active-high, while the whole
24device can either run in comparator mode or interrupt mode. The ADT7410
25supports continous temperature sampling, as well as sampling one temperature
26value per second or even justget one sample on demand for power saving.
27Besides, it can completely power down its ADC, if power management is
28required.
29
30Configuration Notes
31-------------------
32
33Since the device uses one hysteresis value, which is an offset to minimum,
34maximum and critical temperature, it can only be set for temp#_max_hyst.
35However, temp#_min_hyst and temp#_crit_hyst show their corresponding
36hysteresis.
37The device is set to 16 bit resolution and comparator mode.
38
39sysfs-Interface
40---------------
41
42temp#_input - temperature input
43temp#_min - temperature minimum setpoint
44temp#_max - temperature maximum setpoint
45temp#_crit - critical temperature setpoint
46temp#_min_hyst - hysteresis for temperature minimum (read-only)
47temp#_max_hyst - hysteresis for temperature maximum (read/write)
48temp#_crit_hyst - hysteresis for critical temperature (read-only)
49temp#_min_alarm - temperature minimum alarm flag
50temp#_max_alarm - temperature maximum alarm flag
51temp#_crit_alarm - critical temperature alarm flag
diff --git a/Documentation/hwmon/coretemp b/Documentation/hwmon/coretemp
index c86b50c03ea8..f17256f069ba 100644
--- a/Documentation/hwmon/coretemp
+++ b/Documentation/hwmon/coretemp
@@ -105,6 +105,7 @@ Process Processor TjMax(C)
105 330/230 125 105 330/230 125
106 E680/660/640/620 90 106 E680/660/640/620 90
107 E680T/660T/640T/620T 110 107 E680T/660T/640T/620T 110
108 CE4170/4150/4110 110
108 109
10945nm Core2 Processors 11045nm Core2 Processors
110 Solo ULV SU3500/3300 100 111 Solo ULV SU3500/3300 100
diff --git a/Documentation/hwmon/da9052 b/Documentation/hwmon/da9052
index ef898553638e..5bc51346b689 100644
--- a/Documentation/hwmon/da9052
+++ b/Documentation/hwmon/da9052
@@ -56,6 +56,6 @@ The junction temperature is calculated:
56The junction temperature attribute is supported by the driver. 56The junction temperature attribute is supported by the driver.
57 57
58The battery temperature is calculated: 58The battery temperature is calculated:
59 Degree Celcius = 1 / (t1 + 1/298)- 273 59 Degree Celsius = 1 / (t1 + 1/298)- 273
60where t1 = (1/B)* ln(( ADCval * 2.5)/(R25*ITBAT*255)) 60where t1 = (1/B)* ln(( ADCval * 2.5)/(R25*ITBAT*255))
61Default values of R25, B, ITBAT are 10e3, 3380 and 50e-6 respectively. 61Default values of R25, B, ITBAT are 10e3, 3380 and 50e-6 respectively.
diff --git a/Documentation/hwmon/exynos4_tmu b/Documentation/hwmon/exynos4_tmu
deleted file mode 100644
index c3c6b41db607..000000000000
--- a/Documentation/hwmon/exynos4_tmu
+++ /dev/null
@@ -1,81 +0,0 @@
1Kernel driver exynos4_tmu
2=================
3
4Supported chips:
5* ARM SAMSUNG EXYNOS4 series of SoC
6 Prefix: 'exynos4-tmu'
7 Datasheet: Not publicly available
8
9Authors: Donggeun Kim <dg77.kim@samsung.com>
10
11Description
12-----------
13
14This driver allows to read temperature inside SAMSUNG EXYNOS4 series of SoC.
15
16The chip only exposes the measured 8-bit temperature code value
17through a register.
18Temperature can be taken from the temperature code.
19There are three equations converting from temperature to temperature code.
20
21The three equations are:
22 1. Two point trimming
23 Tc = (T - 25) * (TI2 - TI1) / (85 - 25) + TI1
24
25 2. One point trimming
26 Tc = T + TI1 - 25
27
28 3. No trimming
29 Tc = T + 50
30
31 Tc: Temperature code, T: Temperature,
32 TI1: Trimming info for 25 degree Celsius (stored at TRIMINFO register)
33 Temperature code measured at 25 degree Celsius which is unchanged
34 TI2: Trimming info for 85 degree Celsius (stored at TRIMINFO register)
35 Temperature code measured at 85 degree Celsius which is unchanged
36
37TMU(Thermal Management Unit) in EXYNOS4 generates interrupt
38when temperature exceeds pre-defined levels.
39The maximum number of configurable threshold is four.
40The threshold levels are defined as follows:
41 Level_0: current temperature > trigger_level_0 + threshold
42 Level_1: current temperature > trigger_level_1 + threshold
43 Level_2: current temperature > trigger_level_2 + threshold
44 Level_3: current temperature > trigger_level_3 + threshold
45
46 The threshold and each trigger_level are set
47 through the corresponding registers.
48
49When an interrupt occurs, this driver notify user space of
50one of four threshold levels for the interrupt
51through kobject_uevent_env and sysfs_notify functions.
52Although an interrupt condition for level_0 can be set,
53it is not notified to user space through sysfs_notify function.
54
55Sysfs Interface
56---------------
57name name of the temperature sensor
58 RO
59
60temp1_input temperature
61 RO
62
63temp1_max temperature for level_1 interrupt
64 RO
65
66temp1_crit temperature for level_2 interrupt
67 RO
68
69temp1_emergency temperature for level_3 interrupt
70 RO
71
72temp1_max_alarm alarm for level_1 interrupt
73 RO
74
75temp1_crit_alarm
76 alarm for level_2 interrupt
77 RO
78
79temp1_emergency_alarm
80 alarm for level_3 interrupt
81 RO
diff --git a/Documentation/hwmon/ina2xx b/Documentation/hwmon/ina2xx
index f50a6cc27616..03444f9d833f 100644
--- a/Documentation/hwmon/ina2xx
+++ b/Documentation/hwmon/ina2xx
@@ -8,12 +8,24 @@ Supported chips:
8 Datasheet: Publicly available at the Texas Instruments website 8 Datasheet: Publicly available at the Texas Instruments website
9 http://www.ti.com/ 9 http://www.ti.com/
10 10
11 * Texas Instruments INA220
12 Prefix: 'ina220'
13 Addresses: I2C 0x40 - 0x4f
14 Datasheet: Publicly available at the Texas Instruments website
15 http://www.ti.com/
16
11 * Texas Instruments INA226 17 * Texas Instruments INA226
12 Prefix: 'ina226' 18 Prefix: 'ina226'
13 Addresses: I2C 0x40 - 0x4f 19 Addresses: I2C 0x40 - 0x4f
14 Datasheet: Publicly available at the Texas Instruments website 20 Datasheet: Publicly available at the Texas Instruments website
15 http://www.ti.com/ 21 http://www.ti.com/
16 22
23 * Texas Instruments INA230
24 Prefix: 'ina230'
25 Addresses: I2C 0x40 - 0x4f
26 Datasheet: Publicly available at the Texas Instruments website
27 http://www.ti.com/
28
17Author: Lothar Felten <l-felten@ti.com> 29Author: Lothar Felten <l-felten@ti.com>
18 30
19Description 31Description
@@ -23,7 +35,13 @@ The INA219 is a high-side current shunt and power monitor with an I2C
23interface. The INA219 monitors both shunt drop and supply voltage, with 35interface. The INA219 monitors both shunt drop and supply voltage, with
24programmable conversion times and filtering. 36programmable conversion times and filtering.
25 37
38The INA220 is a high or low side current shunt and power monitor with an I2C
39interface. The INA220 monitors both shunt drop and supply voltage.
40
26The INA226 is a current shunt and power monitor with an I2C interface. 41The INA226 is a current shunt and power monitor with an I2C interface.
27The INA226 monitors both a shunt voltage drop and bus supply voltage. 42The INA226 monitors both a shunt voltage drop and bus supply voltage.
28 43
44The INA230 is a high or low side current shunt and power monitor with an I2C
45interface. The INA230 monitors both a shunt voltage drop and bus supply voltage.
46
29The shunt value in micro-ohms can be set via platform data. 47The shunt value in micro-ohms can be set via platform data.
diff --git a/Documentation/hwmon/lm70 b/Documentation/hwmon/lm70
index 0d240291e3cc..86d182942c51 100644
--- a/Documentation/hwmon/lm70
+++ b/Documentation/hwmon/lm70
@@ -6,6 +6,10 @@ Supported chips:
6 Datasheet: http://www.national.com/pf/LM/LM70.html 6 Datasheet: http://www.national.com/pf/LM/LM70.html
7 * Texas Instruments TMP121/TMP123 7 * Texas Instruments TMP121/TMP123
8 Information: http://focus.ti.com/docs/prod/folders/print/tmp121.html 8 Information: http://focus.ti.com/docs/prod/folders/print/tmp121.html
9 * National Semiconductor LM71
10 Datasheet: http://www.ti.com/product/LM71
11 * National Semiconductor LM74
12 Datasheet: http://www.ti.com/product/LM74
9 13
10Author: 14Author:
11 Kaiwan N Billimoria <kaiwan@designergraphix.com> 15 Kaiwan N Billimoria <kaiwan@designergraphix.com>
@@ -31,9 +35,11 @@ As a real (in-tree) example of this "SPI protocol driver" interfacing
31with a "SPI master controller driver", see drivers/spi/spi_lm70llp.c 35with a "SPI master controller driver", see drivers/spi/spi_lm70llp.c
32and its associated documentation. 36and its associated documentation.
33 37
34The TMP121/TMP123 are very similar; main differences are 4 wire SPI inter- 38The LM74 and TMP121/TMP123 are very similar; main difference is 13-bit
35face (read only) and 13-bit temperature data (0.0625 degrees celsius reso- 39temperature data (0.0625 degrees celsius resolution).
36lution). 40
41The LM71 is also very similar; main difference is 14-bit temperature
42data (0.03125 degrees celsius resolution).
37 43
38Thanks to 44Thanks to
39--------- 45---------
diff --git a/Documentation/hwmon/max1619 b/Documentation/hwmon/max1619
index d6f8d9cd7d7f..e6d87398cc8f 100644
--- a/Documentation/hwmon/max1619
+++ b/Documentation/hwmon/max1619
@@ -9,7 +9,7 @@ Supported chips:
9 http://pdfserv.maxim-ic.com/en/ds/MAX1619.pdf 9 http://pdfserv.maxim-ic.com/en/ds/MAX1619.pdf
10 10
11Authors: 11Authors:
12 Alexey Fisher <fishor@mail.ru>, 12 Oleksij Rempel <bug-track@fisher-privat.net>,
13 Jean Delvare <khali@linux-fr.org> 13 Jean Delvare <khali@linux-fr.org>
14 14
15Description 15Description
diff --git a/Documentation/hwmon/max197 b/Documentation/hwmon/max197
new file mode 100644
index 000000000000..8d89b9009df8
--- /dev/null
+++ b/Documentation/hwmon/max197
@@ -0,0 +1,60 @@
1Maxim MAX197 driver
2===================
3
4Author:
5 * Vivien Didelot <vivien.didelot@savoirfairelinux.com>
6
7Supported chips:
8 * Maxim MAX197
9 Prefix: 'max197'
10 Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX197.pdf
11
12 * Maxim MAX199
13 Prefix: 'max199'
14 Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX199.pdf
15
16Description
17-----------
18
19The A/D converters MAX197, and MAX199 are both 8-Channel, Multi-Range, 5V,
2012-Bit DAS with 8+4 Bus Interface and Fault Protection.
21
22The available ranges for the MAX197 are {0,-5V} to 5V, and {0,-10V} to 10V,
23while they are {0,-2V} to 2V, and {0,-4V} to 4V on the MAX199.
24
25Platform data
26-------------
27
28The MAX197 platform data (defined in linux/platform_data/max197.h) should be
29filled with a pointer to a conversion function, defined like:
30
31 int convert(u8 ctrl);
32
33ctrl is the control byte to write to start a new conversion.
34On success, the function must return the 12-bit raw value read from the chip,
35or a negative error code otherwise.
36
37Control byte format:
38
39Bit Name Description
407,6 PD1,PD0 Clock and Power-Down modes
415 ACQMOD Internal or External Controlled Acquisition
424 RNG Full-scale voltage magnitude at the input
433 BIP Unipolar or Bipolar conversion mode
442,1,0 A2,A1,A0 Channel
45
46Sysfs interface
47---------------
48
49* in[0-7]_input: The conversion value for the corresponding channel.
50 RO
51
52* in[0-7]_min: The lower limit (in mV) for the corresponding channel.
53 For the MAX197, it will be adjusted to -10000, -5000, or 0.
54 For the MAX199, it will be adjusted to -4000, -2000, or 0.
55 RW
56
57* in[0-7]_max: The higher limit (in mV) for the corresponding channel.
58 For the MAX197, it will be adjusted to 0, 5000, or 10000.
59 For the MAX199, it will be adjusted to 0, 2000, or 4000.
60 RW
diff --git a/Documentation/hwmon/mcp3021 b/Documentation/hwmon/mcp3021
index 325fd87e81b2..74a6b72adf5f 100644
--- a/Documentation/hwmon/mcp3021
+++ b/Documentation/hwmon/mcp3021
@@ -5,18 +5,25 @@ Supported chips:
5 * Microchip Technology MCP3021 5 * Microchip Technology MCP3021
6 Prefix: 'mcp3021' 6 Prefix: 'mcp3021'
7 Datasheet: http://ww1.microchip.com/downloads/en/DeviceDoc/21805a.pdf 7 Datasheet: http://ww1.microchip.com/downloads/en/DeviceDoc/21805a.pdf
8 * Microchip Technology MCP3221
9 Prefix: 'mcp3221'
10 Datasheet: http://ww1.microchip.com/downloads/en/DeviceDoc/21732c.pdf
8 11
9Author: Mingkai Hu 12Authors:
13 Mingkai Hu
14 Sven Schuchmann <schuchmann@schleissheimer.de>
10 15
11Description 16Description
12----------- 17-----------
13 18
14This driver implements support for the Microchip Technology MCP3021 chip. 19This driver implements support for the Microchip Technology MCP3021 and
20MCP3221 chip.
15 21
16The Microchip Technology Inc. MCP3021 is a successive approximation A/D 22The Microchip Technology Inc. MCP3021 is a successive approximation A/D
17converter (ADC) with 10-bit resolution. 23converter (ADC) with 10-bit resolution. The MCP3221 has 12-bit resolution.
18This device provides one single-ended input with very low power consumption. 24
19Communication to the MCP3021 is performed using a 2-wire I2C compatible 25These devices provide one single-ended input with very low power consumption.
20interface. Standard (100 kHz) and Fast (400 kHz) I2C modes are available. 26Communication to the MCP3021/MCP3221 is performed using a 2-wire I2C
21The default I2C device address is 0x4d (contact the Microchip factory for 27compatible interface. Standard (100 kHz) and Fast (400 kHz) I2C modes are
22additional address options). 28available. The default I2C device address is 0x4d (contact the Microchip
29factory for additional address options).
diff --git a/Documentation/hwmon/submitting-patches b/Documentation/hwmon/submitting-patches
index 790f774a3032..843751c41fea 100644
--- a/Documentation/hwmon/submitting-patches
+++ b/Documentation/hwmon/submitting-patches
@@ -60,8 +60,7 @@ increase the chances of your change being accepted.
60 60
61* Add the driver to Kconfig and Makefile in alphabetical order. 61* Add the driver to Kconfig and Makefile in alphabetical order.
62 62
63* Make sure that all dependencies are listed in Kconfig. For new drivers, it 63* Make sure that all dependencies are listed in Kconfig.
64 is most likely prudent to add a dependency on EXPERIMENTAL.
65 64
66* Avoid forward declarations if you can. Rearrange the code if necessary. 65* Avoid forward declarations if you can. Rearrange the code if necessary.
67 66
diff --git a/Documentation/hwmon/twl4030-madc-hwmon b/Documentation/hwmon/twl4030-madc-hwmon
index ef7984317cec..c3a3a5be10ad 100644
--- a/Documentation/hwmon/twl4030-madc-hwmon
+++ b/Documentation/hwmon/twl4030-madc-hwmon
@@ -41,5 +41,5 @@ Channel Signal
41 41
42The Sysfs nodes will represent the voltage in the units of mV, 42The Sysfs nodes will represent the voltage in the units of mV,
43the temperature channel shows the converted temperature in 43the temperature channel shows the converted temperature in
44degree celcius. The Battery charging current channel represents 44degree Celsius. The Battery charging current channel represents
45battery charging current in mA. 45battery charging current in mA.