summaryrefslogtreecommitdiff
path: root/Documentation/hwmon/adm1275
blob: 15b4a20d5062f4e3872135557f6740da6c9408cf (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
Kernel driver adm1275
=====================

Supported chips:
  * Analog Devices ADM1075
    Prefix: 'adm1075'
    Addresses scanned: -
    Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1075.pdf
  * Analog Devices ADM1275
    Prefix: 'adm1275'
    Addresses scanned: -
    Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1275.pdf
  * Analog Devices ADM1276
    Prefix: 'adm1276'
    Addresses scanned: -
    Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1276.pdf

Author: Guenter Roeck <linux@roeck-us.net>


Description
-----------

This driver supports hardware montoring for Analog Devices ADM1075, ADM1275,
and ADM1276 Hot-Swap Controller and Digital Power Monitor.

ADM1075, ADM1275, and ADM1276 are hot-swap controllers that allow a circuit
board to be removed from or inserted into a live backplane. They also feature
current and voltage readback via an integrated 12-bit analog-to-digital
converter (ADC), accessed using a PMBus interface.

The driver is a client driver to the core PMBus driver. Please see
Documentation/hwmon/pmbus for details on PMBus client drivers.


Usage Notes
-----------

This driver does not auto-detect devices. You will have to instantiate the
devices explicitly. Please see Documentation/i2c/instantiating-devices for
details.

The ADM1075, unlike many other PMBus devices, does not support internal voltage
or current scaling. Reported voltages, currents, and power are raw measurements,
and will typically have to be scaled.


Platform data support
---------------------

The driver supports standard PMBus driver platform data. Please see
Documentation/hwmon/pmbus for details.


Sysfs entries
-------------

The following attributes are supported. Limits are read-write, history reset
attributes are write-only, all other attributes are read-only.

in1_label		"vin1" or "vout1" depending on chip variant and
			configuration. On ADM1075, vout1 reports the voltage on
			the VAUX pin.
in1_input		Measured voltage.
in1_min			Minimum Voltage.
in1_max			Maximum voltage.
in1_min_alarm		Voltage low alarm.
in1_max_alarm		Voltage high alarm.
in1_highest		Historical maximum voltage.
in1_reset_history	Write any value to reset history.

curr1_label		"iout1"
curr1_input		Measured current.
curr1_max		Maximum current.
curr1_max_alarm		Current high alarm.
curr1_lcrit		Critical minimum current. Depending on the chip
			configuration, either curr1_lcrit or curr1_crit is
			supported, but not both.
curr1_lcrit_alarm	Critical current low alarm.
curr1_crit		Critical maximum current. Depending on the chip
			configuration, either curr1_lcrit or curr1_crit is
			supported, but not both.
curr1_crit_alarm	Critical current high alarm.
curr1_highest		Historical maximum current.
curr1_reset_history	Write any value to reset history.

power1_label		"pin1"
power1_input		Input power.
power1_reset_history	Write any value to reset history.

			Power attributes are supported on ADM1075 and ADM1276
			only.