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