1.. SPDX-License-Identifier: GPL-2.0
2
3Kernel driver max16601
4======================
5
6Supported chips:
7
8  * Maxim MAX16508
9
10    Prefix: 'max16508'
11
12    Addresses scanned: -
13
14    Datasheet: Not published
15
16  * Maxim MAX16600
17
18    Prefix: 'max16600'
19
20    Addresses scanned: -
21
22    Datasheet: Not published
23
24  * Maxim MAX16601
25
26    Prefix: 'max16601'
27
28    Addresses scanned: -
29
30    Datasheet: Not published
31
32  * Maxim MAX16602
33
34    Prefix: 'max16602'
35
36    Addresses scanned: -
37
38    Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX16602.pdf
39
40Author: Guenter Roeck <linux@roeck-us.net>
41
42
43Description
44-----------
45
46This driver supports the MAX16508 VR13 Dual-Output Voltage Regulator
47as well as the MAX16600, MAX16601, and MAX16602 VR13.HC Dual-Output
48Voltage Regulator chipsets.
49
50The driver is a client driver to the core PMBus driver.
51Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
52
53
54Usage Notes
55-----------
56
57This driver does not auto-detect devices. You will have to instantiate the
58devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
59details.
60
61
62Platform data support
63---------------------
64
65The driver supports standard PMBus driver platform data.
66
67
68Sysfs entries
69-------------
70
71The following attributes are supported.
72
73=============================== ===============================================
74in1_label			"vin1"
75in1_input			VCORE input voltage.
76in1_alarm			Input voltage alarm.
77
78in2_label			"vout1"
79in2_input			VCORE output voltage.
80in2_alarm			Output voltage alarm.
81
82curr1_label			"iin1"
83curr1_input			VCORE input current, derived from duty cycle
84				and output current.
85curr1_max			Maximum input current.
86curr1_max_alarm			Current high alarm.
87
88curr[P+2]_label			"iin1.P"
89curr[P+2]_input			VCORE phase P input current.
90
91curr[N+2]_label			"iin2"
92curr[N+2]_input			VCORE input current, derived from sensor
93				element.
94				'N' is the number of enabled/populated phases.
95
96curr[N+3]_label			"iin3"
97curr[N+3]_input			VSA input current.
98
99curr[N+4]_label			"iout1"
100curr[N+4]_input			VCORE output current.
101curr[N+4]_crit			Critical output current.
102curr[N+4]_crit_alarm		Output current critical alarm.
103curr[N+4]_max			Maximum output current.
104curr[N+4]_max_alarm		Output current high alarm.
105
106curr[N+P+5]_label		"iout1.P"
107curr[N+P+5]_input		VCORE phase P output current.
108
109curr[2*N+5]_label		"iout3"
110curr[2*N+5]_input		VSA output current.
111curr[2*N+5]_highest		Historical maximum VSA output current.
112curr[2*N+5]_reset_history	Write any value to reset curr21_highest.
113curr[2*N+5]_crit		Critical output current.
114curr[2*N+5]_crit_alarm		Output current critical alarm.
115curr[2*N+5]_max			Maximum output current.
116curr[2*N+5]_max_alarm		Output current high alarm.
117
118power1_label			"pin1"
119power1_input			Input power, derived from duty cycle and output
120				current.
121power1_alarm			Input power alarm.
122
123power2_label			"pin2"
124power2_input			Input power, derived from input current sensor.
125
126power3_label			"pout"
127power3_input			Output power.
128
129temp1_input			VCORE temperature.
130temp1_crit			Critical high temperature.
131temp1_crit_alarm		Chip temperature critical high alarm.
132temp1_max			Maximum temperature.
133temp1_max_alarm			Chip temperature high alarm.
134
135temp2_input			TSENSE_0 temperature
136temp3_input			TSENSE_1 temperature
137temp4_input			TSENSE_2 temperature
138temp5_input			TSENSE_3 temperature
139
140temp6_input			VSA temperature.
141temp6_crit			Critical high temperature.
142temp6_crit_alarm		Chip temperature critical high alarm.
143temp6_max			Maximum temperature.
144temp6_max_alarm			Chip temperature high alarm.
145=============================== ===============================================
146