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