blob: 2cfa256671235745f3433bec2e0c0a18e93041bf [file] [log] [blame]
Guenter Roeck83f76492011-03-17 13:16:01 -07001Kernel driver adm1275
2=====================
3
4Supported chips:
Guenter Roeck92711262012-02-24 03:40:53 -08005 * Analog Devices ADM1075
6 Prefix: 'adm1075'
7 Addresses scanned: -
8 Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1075.pdf
Guenter Roeck83f76492011-03-17 13:16:01 -07009 * Analog Devices ADM1275
10 Prefix: 'adm1275'
11 Addresses scanned: -
12 Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1275.pdf
Guenter Roeck5cf231a2011-07-14 11:55:35 -070013 * Analog Devices ADM1276
14 Prefix: 'adm1276'
15 Addresses scanned: -
16 Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1276.pdf
Guenter Roeck83f76492011-03-17 13:16:01 -070017
18Author: Guenter Roeck <guenter.roeck@ericsson.com>
19
20
21Description
22-----------
23
Guenter Roeck92711262012-02-24 03:40:53 -080024This driver supports hardware montoring for Analog Devices ADM1075, ADM1275,
25and ADM1276 Hot-Swap Controller and Digital Power Monitor.
Guenter Roeck83f76492011-03-17 13:16:01 -070026
Guenter Roeck92711262012-02-24 03:40:53 -080027ADM1075, ADM1275, and ADM1276 are hot-swap controllers that allow a circuit
28board to be removed from or inserted into a live backplane. They also feature
29current and voltage readback via an integrated 12-bit analog-to-digital
30converter (ADC), accessed using a PMBus interface.
Guenter Roeck83f76492011-03-17 13:16:01 -070031
32The driver is a client driver to the core PMBus driver. Please see
33Documentation/hwmon/pmbus for details on PMBus client drivers.
34
35
36Usage Notes
37-----------
38
39This driver does not auto-detect devices. You will have to instantiate the
40devices explicitly. Please see Documentation/i2c/instantiating-devices for
41details.
42
Guenter Roeck92711262012-02-24 03:40:53 -080043The ADM1075, unlike many other PMBus devices, does not support internal voltage
44or current scaling. Reported voltages, currents, and power are raw measurements,
45and will typically have to be scaled.
46
Guenter Roeck83f76492011-03-17 13:16:01 -070047
48Platform data support
49---------------------
50
51The driver supports standard PMBus driver platform data. Please see
52Documentation/hwmon/pmbus for details.
53
54
55Sysfs entries
56-------------
57
Guenter Roeckc576e302011-07-09 11:17:33 -070058The following attributes are supported. Limits are read-write, history reset
59attributes are write-only, all other attributes are read-only.
Guenter Roeck83f76492011-03-17 13:16:01 -070060
61in1_label "vin1" or "vout1" depending on chip variant and
Guenter Roeck92711262012-02-24 03:40:53 -080062 configuration. On ADM1075, vout1 reports the voltage on
63 the VAUX pin.
Guenter Roeck5cf231a2011-07-14 11:55:35 -070064in1_input Measured voltage.
Masanari Iida40e47122012-03-04 23:16:11 +090065in1_min Minimum Voltage.
Guenter Roeck5cf231a2011-07-14 11:55:35 -070066in1_max Maximum voltage.
67in1_min_alarm Voltage low alarm.
68in1_max_alarm Voltage high alarm.
Guenter Roeckc576e302011-07-09 11:17:33 -070069in1_highest Historical maximum voltage.
70in1_reset_history Write any value to reset history.
Guenter Roeck83f76492011-03-17 13:16:01 -070071
72curr1_label "iout1"
Guenter Roeck5cf231a2011-07-14 11:55:35 -070073curr1_input Measured current.
74curr1_max Maximum current.
75curr1_max_alarm Current high alarm.
Guenter Roeckc5e67632011-08-02 11:08:57 -070076curr1_lcrit Critical minimum current. Depending on the chip
77 configuration, either curr1_lcrit or curr1_crit is
78 supported, but not both.
79curr1_lcrit_alarm Critical current low alarm.
80curr1_crit Critical maximum current. Depending on the chip
81 configuration, either curr1_lcrit or curr1_crit is
82 supported, but not both.
83curr1_crit_alarm Critical current high alarm.
Guenter Roeckc576e302011-07-09 11:17:33 -070084curr1_highest Historical maximum current.
85curr1_reset_history Write any value to reset history.
Guenter Roeck92711262012-02-24 03:40:53 -080086
87power1_label "pin1"
88power1_input Input power.
89power1_reset_history Write any value to reset history.
90
91 Power attributes are supported on ADM1075 and ADM1276
92 only.