xref: /linux/Documentation/hwmon/max16065.rst (revision 976e3645923bdd2fe7893aae33fd7a21098bfb28)
1Kernel driver max16065
2======================
3
4
5Supported chips:
6
7  * Maxim MAX16065, MAX16066
8
9    Prefixes: 'max16065', 'max16066'
10
11    Addresses scanned: -
12
13    Datasheet:
14
15	http://datasheets.maxim-ic.com/en/ds/MAX16065-MAX16066.pdf
16
17 *  Maxim MAX16067
18
19    Prefix: 'max16067'
20
21    Addresses scanned: -
22
23    Datasheet:
24
25	http://datasheets.maxim-ic.com/en/ds/MAX16067.pdf
26
27 *  Maxim MAX16068
28
29    Prefix: 'max16068'
30
31    Addresses scanned: -
32
33    Datasheet:
34
35	http://datasheets.maxim-ic.com/en/ds/MAX16068.pdf
36
37 *  Maxim MAX16070/MAX16071
38
39    Prefixes: 'max16070', 'max16071'
40
41    Addresses scanned: -
42
43    Datasheet:
44
45	http://datasheets.maxim-ic.com/en/ds/MAX16070-MAX16071.pdf
46
47Author: Guenter Roeck <linux@roeck-us.net>
48
49
50Description
51-----------
52
53[From datasheets] The MAX16065/MAX16066 flash-configurable system managers
54monitor and sequence multiple system voltages. The MAX16065/MAX16066 can also
55accurately monitor (+/-2.5%) one current channel using a dedicated high-side
56current-sense amplifier. The MAX16065 manages up to twelve system voltages
57simultaneously, and the MAX16066 manages up to eight supply voltages.
58
59The MAX16067 flash-configurable system manager monitors and sequences multiple
60system voltages. The MAX16067 manages up to six system voltages simultaneously.
61
62The MAX16068 flash-configurable system manager monitors and manages up to six
63system voltages simultaneously.
64
65The MAX16070/MAX16071 flash-configurable system monitors supervise multiple
66system voltages. The MAX16070/MAX16071 can also accurately monitor (+/-2.5%)
67one current channel using a dedicated high-side current-sense amplifier. The
68MAX16070 monitors up to twelve system voltages simultaneously, and the MAX16071
69monitors up to eight supply voltages.
70
71Each monitored channel has its own low and high critical limits. MAX16065,
72MAX16066, MAX16070, and MAX16071 support an additional limit which is
73configurable as either low or high secondary limit. MAX16065, MAX16066,
74MAX16070, and MAX16071 also support supply current monitoring.
75
76
77Usage Notes
78-----------
79
80This driver does not probe for devices, since there is no register which
81can be safely used to identify the chip. You will have to instantiate
82the devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
83details.
84
85WARNING: Do not access chip registers using the i2cdump command, and do not use
86any of the i2ctools commands on a command register (0xa5 to 0xac). The chips
87supported by this driver interpret any access to a command register (including
88read commands) as request to execute the command in question. This may result in
89power loss, board resets, and/or Flash corruption. Worst case, your board may
90turn into a brick.
91
92
93Sysfs entries
94-------------
95
96======================= ========================================================
97in[0-11]_input		Input voltage measurements.
98
99in12_input		Voltage on CSP (Current Sense Positive) pin.
100			Only if the chip supports current sensing and if
101			current sensing is enabled.
102
103in[0-11]_min		Low warning limit.
104			Supported on MAX16065, MAX16066, MAX16070, and MAX16071
105			only.
106
107in[0-11]_max		High warning limit.
108			Supported on MAX16065, MAX16066, MAX16070, and MAX16071
109			only.
110
111			Either low or high warning limits are supported
112			(depending on chip configuration), but not both.
113
114in[0-11]_lcrit		Low critical limit.
115
116in[0-11]_crit		High critical limit.
117
118in[0-11]_alarm		Input voltage alarm.
119
120curr1_input		Current sense input; only if the chip supports current
121			sensing and if current sensing is enabled.
122			Displayed current assumes 0.001 Ohm current sense
123			resistor.
124
125curr1_alarm		Overcurrent alarm; only if the chip supports current
126			sensing and if current sensing is enabled.
127======================= ========================================================
128