• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1Kernel driver adm1275
2=====================
3
4Supported chips:
5  * Analog Devices ADM1075
6    Prefix: 'adm1075'
7    Addresses scanned: -
8    Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1075.pdf
9  * Analog Devices ADM1275
10    Prefix: 'adm1275'
11    Addresses scanned: -
12    Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1275.pdf
13  * Analog Devices ADM1276
14    Prefix: 'adm1276'
15    Addresses scanned: -
16    Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1276.pdf
17  * Analog Devices ADM1278
18    Prefix: 'adm1278'
19    Addresses scanned: -
20    Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1278.pdf
21  * Analog Devices ADM1293/ADM1294
22    Prefix: 'adm1293', 'adm1294'
23    Addresses scanned: -
24    Datasheet: http://www.analog.com/media/en/technical-documentation/data-sheets/ADM1293_1294.pdf
25
26Author: Guenter Roeck <linux@roeck-us.net>
27
28
29Description
30-----------
31
32This driver supports hardware monitoring for Analog Devices ADM1075, ADM1275,
33ADM1276, ADM1278, ADM1293, and ADM1294 Hot-Swap Controller and Digital
34Power Monitors.
35
36ADM1075, ADM1275, ADM1276, ADM1278, ADM1293, and ADM1294 are hot-swap
37controllers that allow a circuit board to be removed from or inserted into
38a live backplane. They also feature current and voltage readback via an
39integrated 12 bit analog-to-digital converter (ADC), accessed using a
40PMBus interface.
41
42The driver is a client driver to the core PMBus driver. Please see
43Documentation/hwmon/pmbus for details on PMBus client drivers.
44
45
46Usage Notes
47-----------
48
49This driver does not auto-detect devices. You will have to instantiate the
50devices explicitly. Please see Documentation/i2c/instantiating-devices for
51details.
52
53The ADM1075, unlike many other PMBus devices, does not support internal voltage
54or current scaling. Reported voltages, currents, and power are raw measurements,
55and will typically have to be scaled.
56
57
58Platform data support
59---------------------
60
61The driver supports standard PMBus driver platform data. Please see
62Documentation/hwmon/pmbus for details.
63
64
65Sysfs entries
66-------------
67
68The following attributes are supported. Limits are read-write, history reset
69attributes are write-only, all other attributes are read-only.
70
71inX_label		"vin1" or "vout1" depending on chip variant and
72			configuration. On ADM1075, ADM1293, and ADM1294,
73			vout1 reports the voltage on the VAUX pin.
74inX_input		Measured voltage.
75inX_min			Minimum Voltage.
76inX_max			Maximum voltage.
77inX_min_alarm		Voltage low alarm.
78inX_max_alarm		Voltage high alarm.
79inX_highest		Historical maximum voltage.
80inX_reset_history	Write any value to reset history.
81
82curr1_label		"iout1"
83curr1_input		Measured current.
84curr1_max		Maximum current.
85curr1_max_alarm		Current high alarm.
86curr1_lcrit		Critical minimum current. Depending on the chip
87			configuration, either curr1_lcrit or curr1_crit is
88			supported, but not both.
89curr1_lcrit_alarm	Critical current low alarm.
90curr1_crit		Critical maximum current. Depending on the chip
91			configuration, either curr1_lcrit or curr1_crit is
92			supported, but not both.
93curr1_crit_alarm	Critical current high alarm.
94curr1_highest		Historical maximum current.
95curr1_reset_history	Write any value to reset history.
96
97power1_label		"pin1"
98power1_input		Input power.
99power1_input_lowest	Lowest observed input power. ADM1293 and ADM1294 only.
100power1_input_highest	Highest observed input power.
101power1_reset_history	Write any value to reset history.
102
103			Power attributes are supported on ADM1075, ADM1276,
104			ADM1293, and ADM1294.
105
106temp1_input		Chip temperature.
107			Temperature attributes are only available on ADM1278.
108temp1_max		Maximum chip temperature.
109temp1_max_alarm		Temperature alarm.
110temp1_crit		Critical chip temperature.
111temp1_crit_alarm	Critical temperature high alarm.
112temp1_highest		Highest observed temperature.
113temp1_reset_history	Write any value to reset history.
114
115			Temperature attributes are supported on ADM1278.
116