xref: /linux/drivers/power/supply/power_supply_hwmon.c (revision a3a02a52bcfcbcc4a637d4b68bf1bc391c9fad02)
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  *  power_supply_hwmon.c - power supply hwmon support.
4  */
5 
6 #include <linux/err.h>
7 #include <linux/hwmon.h>
8 #include <linux/power_supply.h>
9 #include <linux/slab.h>
10 
11 struct power_supply_hwmon {
12 	struct power_supply *psy;
13 	unsigned long *props;
14 };
15 
16 static const char *const ps_temp_label[] = {
17 	"temp",
18 	"ambient temp",
19 };
20 
21 static int power_supply_hwmon_in_to_property(u32 attr)
22 {
23 	switch (attr) {
24 	case hwmon_in_average:
25 		return POWER_SUPPLY_PROP_VOLTAGE_AVG;
26 	case hwmon_in_min:
27 		return POWER_SUPPLY_PROP_VOLTAGE_MIN;
28 	case hwmon_in_max:
29 		return POWER_SUPPLY_PROP_VOLTAGE_MAX;
30 	case hwmon_in_input:
31 		return POWER_SUPPLY_PROP_VOLTAGE_NOW;
32 	default:
33 		return -EINVAL;
34 	}
35 }
36 
37 static int power_supply_hwmon_curr_to_property(u32 attr)
38 {
39 	switch (attr) {
40 	case hwmon_curr_average:
41 		return POWER_SUPPLY_PROP_CURRENT_AVG;
42 	case hwmon_curr_max:
43 		return POWER_SUPPLY_PROP_CURRENT_MAX;
44 	case hwmon_curr_input:
45 		return POWER_SUPPLY_PROP_CURRENT_NOW;
46 	default:
47 		return -EINVAL;
48 	}
49 }
50 
51 static int power_supply_hwmon_power_to_property(u32 attr)
52 {
53 	switch (attr) {
54 	case hwmon_power_input:
55 		return POWER_SUPPLY_PROP_POWER_NOW;
56 	case hwmon_power_average:
57 		return POWER_SUPPLY_PROP_POWER_AVG;
58 	default:
59 		return -EINVAL;
60 	}
61 }
62 
63 static int power_supply_hwmon_temp_to_property(u32 attr, int channel)
64 {
65 	if (channel) {
66 		switch (attr) {
67 		case hwmon_temp_input:
68 			return POWER_SUPPLY_PROP_TEMP_AMBIENT;
69 		case hwmon_temp_min_alarm:
70 			return POWER_SUPPLY_PROP_TEMP_AMBIENT_ALERT_MIN;
71 		case hwmon_temp_max_alarm:
72 			return POWER_SUPPLY_PROP_TEMP_AMBIENT_ALERT_MAX;
73 		default:
74 			break;
75 		}
76 	} else {
77 		switch (attr) {
78 		case hwmon_temp_input:
79 			return POWER_SUPPLY_PROP_TEMP;
80 		case hwmon_temp_max:
81 			return POWER_SUPPLY_PROP_TEMP_MAX;
82 		case hwmon_temp_min:
83 			return POWER_SUPPLY_PROP_TEMP_MIN;
84 		case hwmon_temp_min_alarm:
85 			return POWER_SUPPLY_PROP_TEMP_ALERT_MIN;
86 		case hwmon_temp_max_alarm:
87 			return POWER_SUPPLY_PROP_TEMP_ALERT_MAX;
88 		default:
89 			break;
90 		}
91 	}
92 
93 	return -EINVAL;
94 }
95 
96 static int
97 power_supply_hwmon_to_property(enum hwmon_sensor_types type,
98 			       u32 attr, int channel)
99 {
100 	switch (type) {
101 	case hwmon_in:
102 		return power_supply_hwmon_in_to_property(attr);
103 	case hwmon_curr:
104 		return power_supply_hwmon_curr_to_property(attr);
105 	case hwmon_power:
106 		return power_supply_hwmon_power_to_property(attr);
107 	case hwmon_temp:
108 		return power_supply_hwmon_temp_to_property(attr, channel);
109 	default:
110 		return -EINVAL;
111 	}
112 }
113 
114 static bool power_supply_hwmon_is_a_label(enum hwmon_sensor_types type,
115 					   u32 attr)
116 {
117 	return type == hwmon_temp && attr == hwmon_temp_label;
118 }
119 
120 struct hwmon_type_attr_list {
121 	const u32 *attrs;
122 	size_t n_attrs;
123 };
124 
125 static const u32 ps_temp_attrs[] = {
126 	hwmon_temp_input,
127 	hwmon_temp_min, hwmon_temp_max,
128 	hwmon_temp_min_alarm, hwmon_temp_max_alarm,
129 };
130 
131 static const struct hwmon_type_attr_list ps_type_attrs[hwmon_max] = {
132 	[hwmon_temp] = { ps_temp_attrs, ARRAY_SIZE(ps_temp_attrs) },
133 };
134 
135 static bool power_supply_hwmon_has_input(
136 	const struct power_supply_hwmon *psyhw,
137 	enum hwmon_sensor_types type, int channel)
138 {
139 	const struct hwmon_type_attr_list *attr_list = &ps_type_attrs[type];
140 	size_t i;
141 
142 	for (i = 0; i < attr_list->n_attrs; ++i) {
143 		int prop = power_supply_hwmon_to_property(type,
144 			attr_list->attrs[i], channel);
145 
146 		if (prop >= 0 && test_bit(prop, psyhw->props))
147 			return true;
148 	}
149 
150 	return false;
151 }
152 
153 static bool power_supply_hwmon_is_writable(enum hwmon_sensor_types type,
154 					   u32 attr)
155 {
156 	switch (type) {
157 	case hwmon_in:
158 		return attr == hwmon_in_min ||
159 		       attr == hwmon_in_max;
160 	case hwmon_curr:
161 		return attr == hwmon_curr_max;
162 	case hwmon_temp:
163 		return attr == hwmon_temp_max ||
164 		       attr == hwmon_temp_min ||
165 		       attr == hwmon_temp_min_alarm ||
166 		       attr == hwmon_temp_max_alarm;
167 	default:
168 		return false;
169 	}
170 }
171 
172 static umode_t power_supply_hwmon_is_visible(const void *data,
173 					     enum hwmon_sensor_types type,
174 					     u32 attr, int channel)
175 {
176 	const struct power_supply_hwmon *psyhw = data;
177 	int prop;
178 
179 	if (power_supply_hwmon_is_a_label(type, attr)) {
180 		if (power_supply_hwmon_has_input(psyhw, type, channel))
181 			return 0444;
182 		else
183 			return 0;
184 	}
185 
186 	prop = power_supply_hwmon_to_property(type, attr, channel);
187 	if (prop < 0 || !test_bit(prop, psyhw->props))
188 		return 0;
189 
190 	if (power_supply_property_is_writeable(psyhw->psy, prop) > 0 &&
191 	    power_supply_hwmon_is_writable(type, attr))
192 		return 0644;
193 
194 	return 0444;
195 }
196 
197 static int power_supply_hwmon_read_string(struct device *dev,
198 					  enum hwmon_sensor_types type,
199 					  u32 attr, int channel,
200 					  const char **str)
201 {
202 	switch (type) {
203 	case hwmon_temp:
204 		*str = ps_temp_label[channel];
205 		break;
206 	default:
207 		/* unreachable, but see:
208 		 * gcc bug #51513 [1] and clang bug #978 [2]
209 		 *
210 		 * [1] https://gcc.gnu.org/bugzilla/show_bug.cgi?id=51513
211 		 * [2] https://github.com/ClangBuiltLinux/linux/issues/978
212 		 */
213 		break;
214 	}
215 
216 	return 0;
217 }
218 
219 static int
220 power_supply_hwmon_read(struct device *dev, enum hwmon_sensor_types type,
221 			u32 attr, int channel, long *val)
222 {
223 	struct power_supply_hwmon *psyhw = dev_get_drvdata(dev);
224 	struct power_supply *psy = psyhw->psy;
225 	union power_supply_propval pspval;
226 	int ret, prop;
227 
228 	prop = power_supply_hwmon_to_property(type, attr, channel);
229 	if (prop < 0)
230 		return prop;
231 
232 	ret  = power_supply_get_property(psy, prop, &pspval);
233 	if (ret)
234 		return ret;
235 
236 	switch (type) {
237 	/*
238 	 * Both voltage and current is reported in units of
239 	 * microvolts/microamps, so we need to adjust it to
240 	 * milliamps(volts)
241 	 */
242 	case hwmon_curr:
243 	case hwmon_in:
244 		pspval.intval = DIV_ROUND_CLOSEST(pspval.intval, 1000);
245 		break;
246 	case hwmon_power:
247 		/*
248 		 * Power properties are already in microwatts.
249 		 */
250 		break;
251 	/*
252 	 * Temp needs to be converted from 1/10 C to milli-C
253 	 */
254 	case hwmon_temp:
255 		if (check_mul_overflow(pspval.intval, 100,
256 				       &pspval.intval))
257 			return -EOVERFLOW;
258 		break;
259 	default:
260 		return -EINVAL;
261 	}
262 
263 	*val = pspval.intval;
264 
265 	return 0;
266 }
267 
268 static int
269 power_supply_hwmon_write(struct device *dev, enum hwmon_sensor_types type,
270 			 u32 attr, int channel, long val)
271 {
272 	struct power_supply_hwmon *psyhw = dev_get_drvdata(dev);
273 	struct power_supply *psy = psyhw->psy;
274 	union power_supply_propval pspval;
275 	int prop;
276 
277 	prop = power_supply_hwmon_to_property(type, attr, channel);
278 	if (prop < 0)
279 		return prop;
280 
281 	pspval.intval = val;
282 
283 	switch (type) {
284 	/*
285 	 * Both voltage and current is reported in units of
286 	 * microvolts/microamps, so we need to adjust it to
287 	 * milliamps(volts)
288 	 */
289 	case hwmon_curr:
290 	case hwmon_in:
291 		if (check_mul_overflow(pspval.intval, 1000,
292 				       &pspval.intval))
293 			return -EOVERFLOW;
294 		break;
295 	/*
296 	 * Temp needs to be converted from 1/10 C to milli-C
297 	 */
298 	case hwmon_temp:
299 		pspval.intval = DIV_ROUND_CLOSEST(pspval.intval, 100);
300 		break;
301 	default:
302 		return -EINVAL;
303 	}
304 
305 	return power_supply_set_property(psy, prop, &pspval);
306 }
307 
308 static const struct hwmon_ops power_supply_hwmon_ops = {
309 	.is_visible	= power_supply_hwmon_is_visible,
310 	.read		= power_supply_hwmon_read,
311 	.write		= power_supply_hwmon_write,
312 	.read_string	= power_supply_hwmon_read_string,
313 };
314 
315 static const struct hwmon_channel_info * const power_supply_hwmon_info[] = {
316 	HWMON_CHANNEL_INFO(temp,
317 			   HWMON_T_LABEL     |
318 			   HWMON_T_INPUT     |
319 			   HWMON_T_MAX       |
320 			   HWMON_T_MIN       |
321 			   HWMON_T_MIN_ALARM,
322 
323 			   HWMON_T_LABEL     |
324 			   HWMON_T_INPUT     |
325 			   HWMON_T_MIN_ALARM |
326 			   HWMON_T_MAX_ALARM),
327 
328 	HWMON_CHANNEL_INFO(curr,
329 			   HWMON_C_AVERAGE |
330 			   HWMON_C_MAX     |
331 			   HWMON_C_INPUT),
332 
333 	HWMON_CHANNEL_INFO(power,
334 			   HWMON_P_INPUT |
335 			   HWMON_P_AVERAGE),
336 
337 	HWMON_CHANNEL_INFO(in,
338 			   HWMON_I_AVERAGE |
339 			   HWMON_I_MIN     |
340 			   HWMON_I_MAX     |
341 			   HWMON_I_INPUT),
342 	NULL
343 };
344 
345 static const struct hwmon_chip_info power_supply_hwmon_chip_info = {
346 	.ops = &power_supply_hwmon_ops,
347 	.info = power_supply_hwmon_info,
348 };
349 
350 int power_supply_add_hwmon_sysfs(struct power_supply *psy)
351 {
352 	const struct power_supply_desc *desc = psy->desc;
353 	struct power_supply_hwmon *psyhw;
354 	struct device *dev = &psy->dev;
355 	struct device *hwmon;
356 	int ret, i;
357 	const char *name;
358 
359 	if (!devres_open_group(dev, power_supply_add_hwmon_sysfs,
360 			       GFP_KERNEL))
361 		return -ENOMEM;
362 
363 	psyhw = devm_kzalloc(dev, sizeof(*psyhw), GFP_KERNEL);
364 	if (!psyhw) {
365 		ret = -ENOMEM;
366 		goto error;
367 	}
368 
369 	psyhw->psy = psy;
370 	psyhw->props = devm_bitmap_zalloc(dev,
371 					  POWER_SUPPLY_PROP_TIME_TO_FULL_AVG + 1,
372 					  GFP_KERNEL);
373 	if (!psyhw->props) {
374 		ret = -ENOMEM;
375 		goto error;
376 	}
377 
378 	for (i = 0; i < desc->num_properties; i++) {
379 		const enum power_supply_property prop = desc->properties[i];
380 
381 		switch (prop) {
382 		case POWER_SUPPLY_PROP_CURRENT_AVG:
383 		case POWER_SUPPLY_PROP_CURRENT_MAX:
384 		case POWER_SUPPLY_PROP_CURRENT_NOW:
385 		case POWER_SUPPLY_PROP_POWER_AVG:
386 		case POWER_SUPPLY_PROP_POWER_NOW:
387 		case POWER_SUPPLY_PROP_TEMP:
388 		case POWER_SUPPLY_PROP_TEMP_MAX:
389 		case POWER_SUPPLY_PROP_TEMP_MIN:
390 		case POWER_SUPPLY_PROP_TEMP_ALERT_MIN:
391 		case POWER_SUPPLY_PROP_TEMP_ALERT_MAX:
392 		case POWER_SUPPLY_PROP_TEMP_AMBIENT:
393 		case POWER_SUPPLY_PROP_TEMP_AMBIENT_ALERT_MIN:
394 		case POWER_SUPPLY_PROP_TEMP_AMBIENT_ALERT_MAX:
395 		case POWER_SUPPLY_PROP_VOLTAGE_AVG:
396 		case POWER_SUPPLY_PROP_VOLTAGE_MIN:
397 		case POWER_SUPPLY_PROP_VOLTAGE_MAX:
398 		case POWER_SUPPLY_PROP_VOLTAGE_NOW:
399 			set_bit(prop, psyhw->props);
400 			break;
401 		default:
402 			break;
403 		}
404 	}
405 
406 	name = psy->desc->name;
407 	if (strchr(name, '-')) {
408 		char *new_name;
409 
410 		new_name = devm_kstrdup(dev, name, GFP_KERNEL);
411 		if (!new_name) {
412 			ret = -ENOMEM;
413 			goto error;
414 		}
415 		strreplace(new_name, '-', '_');
416 		name = new_name;
417 	}
418 	hwmon = devm_hwmon_device_register_with_info(dev, name,
419 						psyhw,
420 						&power_supply_hwmon_chip_info,
421 						NULL);
422 	ret = PTR_ERR_OR_ZERO(hwmon);
423 	if (ret)
424 		goto error;
425 
426 	devres_close_group(dev, power_supply_add_hwmon_sysfs);
427 	return 0;
428 error:
429 	devres_release_group(dev, NULL);
430 	return ret;
431 }
432 
433 void power_supply_remove_hwmon_sysfs(struct power_supply *psy)
434 {
435 	devres_release_group(&psy->dev, power_supply_add_hwmon_sysfs);
436 }
437