1 Kernel driver zl6100 1 Kernel driver zl6100
2 ==================== 2 ====================
3 3
4 Supported chips: 4 Supported chips:
5 5
6 * Renesas / Intersil / Zilker Labs ZL2004 6 * Renesas / Intersil / Zilker Labs ZL2004
7 7
8 Prefix: 'zl2004' 8 Prefix: 'zl2004'
9 9
10 Addresses scanned: - 10 Addresses scanned: -
11 11
12 Datasheet: https://www.renesas.com/us/en/d 12 Datasheet: https://www.renesas.com/us/en/document/dst/zl2004-datasheet.pdf
13 13
14 * Renesas / Intersil / Zilker Labs ZL2005 14 * Renesas / Intersil / Zilker Labs ZL2005
15 15
16 Prefix: 'zl2005' 16 Prefix: 'zl2005'
17 17
18 Addresses scanned: - 18 Addresses scanned: -
19 19
20 Datasheet: https://www.renesas.com/us/en/d 20 Datasheet: https://www.renesas.com/us/en/document/dst/zl2005-datasheet.pdf
21 21
22 * Renesas / Intersil / Zilker Labs ZL2006 22 * Renesas / Intersil / Zilker Labs ZL2006
23 23
24 Prefix: 'zl2006' 24 Prefix: 'zl2006'
25 25
26 Addresses scanned: - 26 Addresses scanned: -
27 27
28 Datasheet: https://www.renesas.com/us/en/d 28 Datasheet: https://www.renesas.com/us/en/document/dst/zl2006-datasheet.pdf
29 29
30 * Renesas / Intersil / Zilker Labs ZL2008 30 * Renesas / Intersil / Zilker Labs ZL2008
31 31
32 Prefix: 'zl2008' 32 Prefix: 'zl2008'
33 33
34 Addresses scanned: - 34 Addresses scanned: -
35 35
36 Datasheet: https://www.renesas.com/us/en/d 36 Datasheet: https://www.renesas.com/us/en/document/dst/zl2008-datasheet.pdf
37 37
38 * Renesas / Intersil / Zilker Labs ZL2105 38 * Renesas / Intersil / Zilker Labs ZL2105
39 39
40 Prefix: 'zl2105' 40 Prefix: 'zl2105'
41 41
42 Addresses scanned: - 42 Addresses scanned: -
43 43
44 Datasheet: https://www.renesas.com/us/en/d 44 Datasheet: https://www.renesas.com/us/en/document/dst/zl2105-datasheet.pdf
45 45
46 * Renesas / Intersil / Zilker Labs ZL2106 46 * Renesas / Intersil / Zilker Labs ZL2106
47 47
48 Prefix: 'zl2106' 48 Prefix: 'zl2106'
49 49
50 Addresses scanned: - 50 Addresses scanned: -
51 51
52 Datasheet: https://www.renesas.com/us/en/d 52 Datasheet: https://www.renesas.com/us/en/document/dst/zl2106-datasheet.pdf
53 53
54 * Renesas / Intersil / Zilker Labs ZL6100 54 * Renesas / Intersil / Zilker Labs ZL6100
55 55
56 Prefix: 'zl6100' 56 Prefix: 'zl6100'
57 57
58 Addresses scanned: - 58 Addresses scanned: -
59 59
60 Datasheet: https://www.renesas.com/us/en/d 60 Datasheet: https://www.renesas.com/us/en/document/dst/zl6100-datasheet.pdf
61 61
62 * Renesas / Intersil / Zilker Labs ZL6105 62 * Renesas / Intersil / Zilker Labs ZL6105
63 63
64 Prefix: 'zl6105' 64 Prefix: 'zl6105'
65 65
66 Addresses scanned: - 66 Addresses scanned: -
67 67
68 Datasheet: https://www.renesas.com/us/en/d 68 Datasheet: https://www.renesas.com/us/en/document/dst/zl6105-datasheet.pdf
69 69
70 * Renesas / Intersil / Zilker Labs ZL8802 70 * Renesas / Intersil / Zilker Labs ZL8802
71 71
72 Prefix: 'zl8802' 72 Prefix: 'zl8802'
73 73
74 Addresses scanned: - 74 Addresses scanned: -
75 75
76 Datasheet: https://www.renesas.com/us/en/d 76 Datasheet: https://www.renesas.com/us/en/document/dst/zl8802-datasheet
77 77
78 * Renesas / Intersil / Zilker Labs ZL9101M 78 * Renesas / Intersil / Zilker Labs ZL9101M
79 79
80 Prefix: 'zl9101' 80 Prefix: 'zl9101'
81 81
82 Addresses scanned: - 82 Addresses scanned: -
83 83
84 Datasheet: https://www.renesas.com/us/en/d 84 Datasheet: https://www.renesas.com/us/en/document/dst/zl9101m-datasheet
85 85
86 * Renesas / Intersil / Zilker Labs ZL9117M 86 * Renesas / Intersil / Zilker Labs ZL9117M
87 87
88 Prefix: 'zl9117' 88 Prefix: 'zl9117'
89 89
90 Addresses scanned: - 90 Addresses scanned: -
91 91
92 Datasheet: https://www.renesas.com/us/en/d 92 Datasheet: https://www.renesas.com/us/en/document/dst/zl9117m-datasheet
93 93
94 * Renesas / Intersil / Zilker Labs ZLS1003, 94 * Renesas / Intersil / Zilker Labs ZLS1003, ZLS4009
95 95
96 Prefix: 'zls1003', zls4009 96 Prefix: 'zls1003', zls4009
97 97
98 Addresses scanned: - 98 Addresses scanned: -
99 99
100 Datasheet: Not published 100 Datasheet: Not published
101 101
102 * Flex BMR450, BMR451 102 * Flex BMR450, BMR451
103 103
104 Prefix: 'bmr450', 'bmr451' 104 Prefix: 'bmr450', 'bmr451'
105 105
106 Addresses scanned: - 106 Addresses scanned: -
107 107
108 Datasheet: 108 Datasheet:
109 109
110 https://flexpowermodules.com/resources/fpm-tec 110 https://flexpowermodules.com/resources/fpm-techspec-bmr450-digital-pol-regulators-20a
111 111
112 * Flex BMR462, BMR463, BMR464 112 * Flex BMR462, BMR463, BMR464
113 113
114 Prefixes: 'bmr462', 'bmr463', 'bmr464' 114 Prefixes: 'bmr462', 'bmr463', 'bmr464'
115 115
116 Addresses scanned: - 116 Addresses scanned: -
117 117
118 Datasheet: https://flexpowermodules.com/re 118 Datasheet: https://flexpowermodules.com/resources/fpm-techspec-bmr462
119 119
120 * Flex BMR465, BMR467 120 * Flex BMR465, BMR467
121 121
122 Prefixes: 'bmr465', 'bmr467' 122 Prefixes: 'bmr465', 'bmr467'
123 123
124 Addresses scanned: - 124 Addresses scanned: -
125 125
126 Datasheet: https://flexpowermodules.com/re 126 Datasheet: https://flexpowermodules.com/resources/fpm-techspec-bmr465-digital-pol
127 127
128 * Flex BMR466 128 * Flex BMR466
129 129
130 Prefixes: 'bmr466' 130 Prefixes: 'bmr466'
131 131
132 Addresses scanned: - 132 Addresses scanned: -
133 133
134 Datasheet: https://flexpowermodules.com/re 134 Datasheet: https://flexpowermodules.com/resources/fpm-techspec-bmr466-8x12
135 135
136 * Flex BMR469 136 * Flex BMR469
137 137
138 Prefixes: 'bmr469' 138 Prefixes: 'bmr469'
139 139
140 Addresses scanned: - 140 Addresses scanned: -
141 141
142 Datasheet: https://flexpowermodules.com/re 142 Datasheet: https://flexpowermodules.com/resources/fpm-techspec-bmr4696001
143 143
144 Author: Guenter Roeck <linux@roeck-us.net> 144 Author: Guenter Roeck <linux@roeck-us.net>
145 145
146 146
147 Description 147 Description
148 ----------- 148 -----------
149 149
150 This driver supports hardware monitoring for R 150 This driver supports hardware monitoring for Renesas / Intersil / Zilker Labs
151 ZL6100 and compatible digital DC-DC controller 151 ZL6100 and compatible digital DC-DC controllers.
152 152
153 The driver is a client driver to the core PMBu 153 The driver is a client driver to the core PMBus driver. Please see
154 Documentation/hwmon/pmbus.rst and Documentatio 154 Documentation/hwmon/pmbus.rst and Documentation.hwmon/pmbus-core for details
155 on PMBus client drivers. 155 on PMBus client drivers.
156 156
157 157
158 Usage Notes 158 Usage Notes
159 ----------- 159 -----------
160 160
161 This driver does not auto-detect devices. You 161 This driver does not auto-detect devices. You will have to instantiate the
162 devices explicitly. Please see Documentation/i 162 devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
163 details. 163 details.
164 164
165 .. warning:: 165 .. warning::
166 166
167 Do not access chip registers using the i2cdu 167 Do not access chip registers using the i2cdump command, and do not use
168 any of the i2ctools commands on a command re 168 any of the i2ctools commands on a command register used to save and restore
169 configuration data (0x11, 0x12, 0x15, 0x16, 169 configuration data (0x11, 0x12, 0x15, 0x16, and 0xf4). The chips supported by
170 this driver interpret any access to those co 170 this driver interpret any access to those command registers (including read
171 commands) as request to execute the command 171 commands) as request to execute the command in question. Unless write accesses
172 to those registers are protected, this may r 172 to those registers are protected, this may result in power loss, board resets,
173 and/or Flash corruption. Worst case, your bo 173 and/or Flash corruption. Worst case, your board may turn into a brick.
174 174
175 175
176 Platform data support 176 Platform data support
177 --------------------- 177 ---------------------
178 178
179 The driver supports standard PMBus driver plat 179 The driver supports standard PMBus driver platform data.
180 180
181 181
182 Module parameters 182 Module parameters
183 ----------------- 183 -----------------
184 184
185 delay 185 delay
186 ----- 186 -----
187 187
188 Renesas/Intersil/Zilker Labs DC-DC controllers 188 Renesas/Intersil/Zilker Labs DC-DC controllers require a minimum interval
189 between I2C bus accesses. According to Intersi 189 between I2C bus accesses. According to Intersil, the minimum interval is 2 ms,
190 though 1 ms appears to be sufficient and has n 190 though 1 ms appears to be sufficient and has not caused any problems in testing.
191 The problem is known to affect all currently s 191 The problem is known to affect all currently supported chips. For manual override,
192 the driver provides a writeable module paramet 192 the driver provides a writeable module parameter, 'delay', which can be used
193 to set the interval to a value between 0 and 6 193 to set the interval to a value between 0 and 65,535 microseconds.
194 194
195 195
196 Sysfs entries 196 Sysfs entries
197 ------------- 197 -------------
198 198
199 The following attributes are supported. Limits 199 The following attributes are supported. Limits are read-write; all other
200 attributes are read-only. 200 attributes are read-only.
201 201
202 ======================= ====================== 202 ======================= ========================================================
203 in1_label "vin" 203 in1_label "vin"
204 in1_input Measured input voltage 204 in1_input Measured input voltage.
205 in1_min Minimum input voltage. 205 in1_min Minimum input voltage.
206 in1_max Maximum input voltage. 206 in1_max Maximum input voltage.
207 in1_lcrit Critical minimum input 207 in1_lcrit Critical minimum input voltage.
208 in1_crit Critical maximum input 208 in1_crit Critical maximum input voltage.
209 in1_min_alarm Input voltage low alar 209 in1_min_alarm Input voltage low alarm.
210 in1_max_alarm Input voltage high ala 210 in1_max_alarm Input voltage high alarm.
211 in1_lcrit_alarm Input voltage critical 211 in1_lcrit_alarm Input voltage critical low alarm.
212 in1_crit_alarm Input voltage critical 212 in1_crit_alarm Input voltage critical high alarm.
213 213
214 in2_label "vmon" 214 in2_label "vmon"
215 in2_input Measured voltage on VM 215 in2_input Measured voltage on VMON (ZL2004) or VDRV (ZL9101M,
216 ZL9117M) pin. Reported 216 ZL9117M) pin. Reported voltage is 16x the voltage on the
217 pin (adjusted internal 217 pin (adjusted internally by the chip).
218 in2_lcrit Critical minimum VMON/ 218 in2_lcrit Critical minimum VMON/VDRV Voltage.
219 in2_crit Critical maximum VMON/ 219 in2_crit Critical maximum VMON/VDRV voltage.
220 in2_lcrit_alarm VMON/VDRV voltage crit 220 in2_lcrit_alarm VMON/VDRV voltage critical low alarm.
221 in2_crit_alarm VMON/VDRV voltage crit 221 in2_crit_alarm VMON/VDRV voltage critical high alarm.
222 222
223 vmon attributes are su 223 vmon attributes are supported on ZL2004, ZL8802,
224 ZL9101M, ZL9117M and Z 224 ZL9101M, ZL9117M and ZLS4009 only.
225 225
226 inX_label "vout[12]" 226 inX_label "vout[12]"
227 inX_input Measured output voltag 227 inX_input Measured output voltage.
228 inX_lcrit Critical minimum outpu 228 inX_lcrit Critical minimum output Voltage.
229 inX_crit Critical maximum outpu 229 inX_crit Critical maximum output voltage.
230 inX_lcrit_alarm Critical output voltag 230 inX_lcrit_alarm Critical output voltage critical low alarm.
231 inX_crit_alarm Critical output voltag 231 inX_crit_alarm Critical output voltage critical high alarm.
232 232
233 X is 3 for ZL2004, ZL9 233 X is 3 for ZL2004, ZL9101M, and ZL9117M,
234 3, 4 for ZL8802 and 2 234 3, 4 for ZL8802 and 2 otherwise.
235 235
236 curr1_label "iin" 236 curr1_label "iin"
237 curr1_input Measured input current 237 curr1_input Measured input current.
238 238
239 iin attributes are sup 239 iin attributes are supported on ZL8802 only
240 240
241 currY_label "iout[12]" 241 currY_label "iout[12]"
242 currY_input Measured output curren 242 currY_input Measured output current.
243 currY_lcrit Critical minimum outpu 243 currY_lcrit Critical minimum output current.
244 currY_crit Critical maximum outpu 244 currY_crit Critical maximum output current.
245 currY_lcrit_alarm Output current critica 245 currY_lcrit_alarm Output current critical low alarm.
246 currY_crit_alarm Output current critica 246 currY_crit_alarm Output current critical high alarm.
247 247
248 Y is 2, 3 for ZL8802, 248 Y is 2, 3 for ZL8802, 1 otherwise
249 249
250 temp[12]_input Measured temperature. 250 temp[12]_input Measured temperature.
251 temp[12]_min Minimum temperature. 251 temp[12]_min Minimum temperature.
252 temp[12]_max Maximum temperature. 252 temp[12]_max Maximum temperature.
253 temp[12]_lcrit Critical low temperatu 253 temp[12]_lcrit Critical low temperature.
254 temp[12]_crit Critical high temperat 254 temp[12]_crit Critical high temperature.
255 temp[12]_min_alarm Chip temperature low a 255 temp[12]_min_alarm Chip temperature low alarm.
256 temp[12]_max_alarm Chip temperature high 256 temp[12]_max_alarm Chip temperature high alarm.
257 temp[12]_lcrit_alarm Chip temperature criti 257 temp[12]_lcrit_alarm Chip temperature critical low alarm.
258 temp[12]_crit_alarm Chip temperature criti 258 temp[12]_crit_alarm Chip temperature critical high alarm.
259 ======================= ====================== 259 ======================= ========================================================
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.