xref: /linux/drivers/power/supply/power_supply_sysfs.c (revision 37bef2170d4c88fc3d708eecf3ef0f4032bc1372)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  *  Sysfs interface for the universal power supply monitor class
4  *
5  *  Copyright © 2007  David Woodhouse <dwmw2@infradead.org>
6  *  Copyright © 2007  Anton Vorontsov <cbou@mail.ru>
7  *  Copyright © 2004  Szabolcs Gyurko
8  *  Copyright © 2003  Ian Molton <spyro@f2s.com>
9  *
10  *  Modified: 2004, Oct     Szabolcs Gyurko
11  */
12 
13 #include <linux/ctype.h>
14 #include <linux/device.h>
15 #include <linux/power_supply.h>
16 #include <linux/slab.h>
17 #include <linux/stat.h>
18 #include <linux/string_helpers.h>
19 
20 #include "power_supply.h"
21 
22 #define MAX_PROP_NAME_LEN 30
23 
24 struct power_supply_attr {
25 	const char *prop_name;
26 	char attr_name[MAX_PROP_NAME_LEN + 1];
27 	struct device_attribute dev_attr;
28 	const char * const *text_values;
29 	int text_values_len;
30 };
31 
32 #define _POWER_SUPPLY_ATTR(_name, _text, _len)	\
33 [POWER_SUPPLY_PROP_ ## _name] =			\
34 {						\
35 	.prop_name = #_name,			\
36 	.attr_name = #_name,			\
37 	.text_values = _text,			\
38 	.text_values_len = _len,		\
39 }
40 
41 #define POWER_SUPPLY_ATTR(_name) _POWER_SUPPLY_ATTR(_name, NULL, 0)
42 #define _POWER_SUPPLY_ENUM_ATTR(_name, _text)	\
43 	_POWER_SUPPLY_ATTR(_name, _text, ARRAY_SIZE(_text))
44 #define POWER_SUPPLY_ENUM_ATTR(_name)	\
45 	_POWER_SUPPLY_ENUM_ATTR(_name, POWER_SUPPLY_ ## _name ## _TEXT)
46 
47 static const char * const POWER_SUPPLY_TYPE_TEXT[] = {
48 	[POWER_SUPPLY_TYPE_UNKNOWN]		= "Unknown",
49 	[POWER_SUPPLY_TYPE_BATTERY]		= "Battery",
50 	[POWER_SUPPLY_TYPE_UPS]			= "UPS",
51 	[POWER_SUPPLY_TYPE_MAINS]		= "Mains",
52 	[POWER_SUPPLY_TYPE_USB]			= "USB",
53 	[POWER_SUPPLY_TYPE_USB_DCP]		= "USB_DCP",
54 	[POWER_SUPPLY_TYPE_USB_CDP]		= "USB_CDP",
55 	[POWER_SUPPLY_TYPE_USB_ACA]		= "USB_ACA",
56 	[POWER_SUPPLY_TYPE_USB_TYPE_C]		= "USB_C",
57 	[POWER_SUPPLY_TYPE_USB_PD]		= "USB_PD",
58 	[POWER_SUPPLY_TYPE_USB_PD_DRP]		= "USB_PD_DRP",
59 	[POWER_SUPPLY_TYPE_APPLE_BRICK_ID]	= "BrickID",
60 	[POWER_SUPPLY_TYPE_WIRELESS]		= "Wireless",
61 };
62 
63 static const char * const POWER_SUPPLY_USB_TYPE_TEXT[] = {
64 	[POWER_SUPPLY_USB_TYPE_UNKNOWN]		= "Unknown",
65 	[POWER_SUPPLY_USB_TYPE_SDP]		= "SDP",
66 	[POWER_SUPPLY_USB_TYPE_DCP]		= "DCP",
67 	[POWER_SUPPLY_USB_TYPE_CDP]		= "CDP",
68 	[POWER_SUPPLY_USB_TYPE_ACA]		= "ACA",
69 	[POWER_SUPPLY_USB_TYPE_C]		= "C",
70 	[POWER_SUPPLY_USB_TYPE_PD]		= "PD",
71 	[POWER_SUPPLY_USB_TYPE_PD_DRP]		= "PD_DRP",
72 	[POWER_SUPPLY_USB_TYPE_PD_PPS]		= "PD_PPS",
73 	[POWER_SUPPLY_USB_TYPE_PD_SPR_AVS]	= "PD_SPR_AVS",
74 	[POWER_SUPPLY_USB_TYPE_PD_PPS_SPR_AVS]	= "PD_PPS_SPR_AVS",
75 	[POWER_SUPPLY_USB_TYPE_APPLE_BRICK_ID]	= "BrickID",
76 };
77 
78 static const char * const POWER_SUPPLY_STATUS_TEXT[] = {
79 	[POWER_SUPPLY_STATUS_UNKNOWN]		= "Unknown",
80 	[POWER_SUPPLY_STATUS_CHARGING]		= "Charging",
81 	[POWER_SUPPLY_STATUS_DISCHARGING]	= "Discharging",
82 	[POWER_SUPPLY_STATUS_NOT_CHARGING]	= "Not charging",
83 	[POWER_SUPPLY_STATUS_FULL]		= "Full",
84 };
85 
86 static const char * const POWER_SUPPLY_CHARGE_TYPE_TEXT[] = {
87 	[POWER_SUPPLY_CHARGE_TYPE_UNKNOWN]	= "Unknown",
88 	[POWER_SUPPLY_CHARGE_TYPE_NONE]		= "N/A",
89 	[POWER_SUPPLY_CHARGE_TYPE_TRICKLE]	= "Trickle",
90 	[POWER_SUPPLY_CHARGE_TYPE_FAST]		= "Fast",
91 	[POWER_SUPPLY_CHARGE_TYPE_STANDARD]	= "Standard",
92 	[POWER_SUPPLY_CHARGE_TYPE_ADAPTIVE]	= "Adaptive",
93 	[POWER_SUPPLY_CHARGE_TYPE_CUSTOM]	= "Custom",
94 	[POWER_SUPPLY_CHARGE_TYPE_LONGLIFE]	= "Long Life",
95 	[POWER_SUPPLY_CHARGE_TYPE_BYPASS]	= "Bypass",
96 };
97 
98 static const char * const POWER_SUPPLY_HEALTH_TEXT[] = {
99 	[POWER_SUPPLY_HEALTH_UNKNOWN]		    = "Unknown",
100 	[POWER_SUPPLY_HEALTH_GOOD]		    = "Good",
101 	[POWER_SUPPLY_HEALTH_OVERHEAT]		    = "Overheat",
102 	[POWER_SUPPLY_HEALTH_DEAD]		    = "Dead",
103 	[POWER_SUPPLY_HEALTH_OVERVOLTAGE]	    = "Over voltage",
104 	[POWER_SUPPLY_HEALTH_UNDERVOLTAGE]	    = "Under voltage",
105 	[POWER_SUPPLY_HEALTH_UNSPEC_FAILURE]	    = "Unspecified failure",
106 	[POWER_SUPPLY_HEALTH_COLD]		    = "Cold",
107 	[POWER_SUPPLY_HEALTH_WATCHDOG_TIMER_EXPIRE] = "Watchdog timer expire",
108 	[POWER_SUPPLY_HEALTH_SAFETY_TIMER_EXPIRE]   = "Safety timer expire",
109 	[POWER_SUPPLY_HEALTH_OVERCURRENT]	    = "Over current",
110 	[POWER_SUPPLY_HEALTH_CALIBRATION_REQUIRED]  = "Calibration required",
111 	[POWER_SUPPLY_HEALTH_WARM]		    = "Warm",
112 	[POWER_SUPPLY_HEALTH_COOL]		    = "Cool",
113 	[POWER_SUPPLY_HEALTH_HOT]		    = "Hot",
114 	[POWER_SUPPLY_HEALTH_NO_BATTERY]	    = "No battery",
115 	[POWER_SUPPLY_HEALTH_BLOWN_FUSE]	    = "Blown fuse",
116 	[POWER_SUPPLY_HEALTH_CELL_IMBALANCE]	    = "Cell imbalance",
117 };
118 
119 static const char * const POWER_SUPPLY_TECHNOLOGY_TEXT[] = {
120 	[POWER_SUPPLY_TECHNOLOGY_UNKNOWN]	= "Unknown",
121 	[POWER_SUPPLY_TECHNOLOGY_NiMH]		= "NiMH",
122 	[POWER_SUPPLY_TECHNOLOGY_LION]		= "Li-ion",
123 	[POWER_SUPPLY_TECHNOLOGY_LIPO]		= "Li-poly",
124 	[POWER_SUPPLY_TECHNOLOGY_LiFe]		= "LiFe",
125 	[POWER_SUPPLY_TECHNOLOGY_NiCd]		= "NiCd",
126 	[POWER_SUPPLY_TECHNOLOGY_LiMn]		= "LiMn",
127 	[POWER_SUPPLY_TECHNOLOGY_PbAc]		= "PbAc",
128 	[POWER_SUPPLY_TECHNOLOGY_NiZn]		= "NiZn",
129 	[POWER_SUPPLY_TECHNOLOGY_RAM]		= "RAM",
130 	[POWER_SUPPLY_TECHNOLOGY_ZnAr]		= "ZnAr",
131 };
132 
133 static const char * const POWER_SUPPLY_CAPACITY_LEVEL_TEXT[] = {
134 	[POWER_SUPPLY_CAPACITY_LEVEL_UNKNOWN]	= "Unknown",
135 	[POWER_SUPPLY_CAPACITY_LEVEL_CRITICAL]	= "Critical",
136 	[POWER_SUPPLY_CAPACITY_LEVEL_LOW]	= "Low",
137 	[POWER_SUPPLY_CAPACITY_LEVEL_NORMAL]	= "Normal",
138 	[POWER_SUPPLY_CAPACITY_LEVEL_HIGH]	= "High",
139 	[POWER_SUPPLY_CAPACITY_LEVEL_FULL]	= "Full",
140 };
141 
142 static const char * const POWER_SUPPLY_SCOPE_TEXT[] = {
143 	[POWER_SUPPLY_SCOPE_UNKNOWN]	= "Unknown",
144 	[POWER_SUPPLY_SCOPE_SYSTEM]	= "System",
145 	[POWER_SUPPLY_SCOPE_DEVICE]	= "Device",
146 };
147 
148 static const char * const POWER_SUPPLY_CHARGE_BEHAVIOUR_TEXT[] = {
149 	[POWER_SUPPLY_CHARGE_BEHAVIOUR_AUTO]			= "auto",
150 	[POWER_SUPPLY_CHARGE_BEHAVIOUR_INHIBIT_CHARGE]		= "inhibit-charge",
151 	[POWER_SUPPLY_CHARGE_BEHAVIOUR_INHIBIT_CHARGE_AWAKE]	= "inhibit-charge-awake",
152 	[POWER_SUPPLY_CHARGE_BEHAVIOUR_FORCE_DISCHARGE]		= "force-discharge",
153 };
154 
155 static struct power_supply_attr power_supply_attrs[] __ro_after_init = {
156 	/* Properties of type `int' */
157 	POWER_SUPPLY_ENUM_ATTR(STATUS),
158 	POWER_SUPPLY_ENUM_ATTR(CHARGE_TYPE),
159 	POWER_SUPPLY_ENUM_ATTR(HEALTH),
160 	POWER_SUPPLY_ATTR(PRESENT),
161 	POWER_SUPPLY_ATTR(ONLINE),
162 	POWER_SUPPLY_ATTR(AUTHENTIC),
163 	POWER_SUPPLY_ENUM_ATTR(TECHNOLOGY),
164 	POWER_SUPPLY_ATTR(CYCLE_COUNT),
165 	POWER_SUPPLY_ATTR(VOLTAGE_MAX),
166 	POWER_SUPPLY_ATTR(VOLTAGE_MIN),
167 	POWER_SUPPLY_ATTR(VOLTAGE_MAX_DESIGN),
168 	POWER_SUPPLY_ATTR(VOLTAGE_MIN_DESIGN),
169 	POWER_SUPPLY_ATTR(VOLTAGE_NOW),
170 	POWER_SUPPLY_ATTR(VOLTAGE_AVG),
171 	POWER_SUPPLY_ATTR(VOLTAGE_OCV),
172 	POWER_SUPPLY_ATTR(VOLTAGE_BOOT),
173 	POWER_SUPPLY_ATTR(CURRENT_MAX),
174 	POWER_SUPPLY_ATTR(CURRENT_NOW),
175 	POWER_SUPPLY_ATTR(CURRENT_AVG),
176 	POWER_SUPPLY_ATTR(CURRENT_BOOT),
177 	POWER_SUPPLY_ATTR(POWER_NOW),
178 	POWER_SUPPLY_ATTR(POWER_AVG),
179 	POWER_SUPPLY_ATTR(CHARGE_FULL_DESIGN),
180 	POWER_SUPPLY_ATTR(CHARGE_EMPTY_DESIGN),
181 	POWER_SUPPLY_ATTR(CHARGE_FULL),
182 	POWER_SUPPLY_ATTR(CHARGE_EMPTY),
183 	POWER_SUPPLY_ATTR(CHARGE_NOW),
184 	POWER_SUPPLY_ATTR(CHARGE_AVG),
185 	POWER_SUPPLY_ATTR(CHARGE_COUNTER),
186 	POWER_SUPPLY_ATTR(CONSTANT_CHARGE_CURRENT),
187 	POWER_SUPPLY_ATTR(CONSTANT_CHARGE_CURRENT_MAX),
188 	POWER_SUPPLY_ATTR(CONSTANT_CHARGE_VOLTAGE),
189 	POWER_SUPPLY_ATTR(CONSTANT_CHARGE_VOLTAGE_MAX),
190 	POWER_SUPPLY_ATTR(CHARGE_CONTROL_LIMIT),
191 	POWER_SUPPLY_ATTR(CHARGE_CONTROL_LIMIT_MAX),
192 	POWER_SUPPLY_ATTR(CHARGE_CONTROL_START_THRESHOLD),
193 	POWER_SUPPLY_ATTR(CHARGE_CONTROL_END_THRESHOLD),
194 	POWER_SUPPLY_ENUM_ATTR(CHARGE_BEHAVIOUR),
195 	/* Same enum value texts as "charge_type" without the 's' at the end */
196 	_POWER_SUPPLY_ENUM_ATTR(CHARGE_TYPES, POWER_SUPPLY_CHARGE_TYPE_TEXT),
197 	POWER_SUPPLY_ATTR(INPUT_CURRENT_LIMIT),
198 	POWER_SUPPLY_ATTR(INPUT_VOLTAGE_LIMIT),
199 	POWER_SUPPLY_ATTR(INPUT_POWER_LIMIT),
200 	POWER_SUPPLY_ATTR(ENERGY_FULL_DESIGN),
201 	POWER_SUPPLY_ATTR(ENERGY_EMPTY_DESIGN),
202 	POWER_SUPPLY_ATTR(ENERGY_FULL),
203 	POWER_SUPPLY_ATTR(ENERGY_EMPTY),
204 	POWER_SUPPLY_ATTR(ENERGY_NOW),
205 	POWER_SUPPLY_ATTR(ENERGY_AVG),
206 	POWER_SUPPLY_ATTR(CAPACITY),
207 	POWER_SUPPLY_ATTR(CAPACITY_ALERT_MIN),
208 	POWER_SUPPLY_ATTR(CAPACITY_ALERT_MAX),
209 	POWER_SUPPLY_ATTR(CAPACITY_ERROR_MARGIN),
210 	POWER_SUPPLY_ENUM_ATTR(CAPACITY_LEVEL),
211 	POWER_SUPPLY_ATTR(TEMP),
212 	POWER_SUPPLY_ATTR(TEMP_MAX),
213 	POWER_SUPPLY_ATTR(TEMP_MIN),
214 	POWER_SUPPLY_ATTR(TEMP_ALERT_MIN),
215 	POWER_SUPPLY_ATTR(TEMP_ALERT_MAX),
216 	POWER_SUPPLY_ATTR(TEMP_AMBIENT),
217 	POWER_SUPPLY_ATTR(TEMP_AMBIENT_ALERT_MIN),
218 	POWER_SUPPLY_ATTR(TEMP_AMBIENT_ALERT_MAX),
219 	POWER_SUPPLY_ATTR(TIME_TO_EMPTY_NOW),
220 	POWER_SUPPLY_ATTR(TIME_TO_EMPTY_AVG),
221 	POWER_SUPPLY_ATTR(TIME_TO_FULL_NOW),
222 	POWER_SUPPLY_ATTR(TIME_TO_FULL_AVG),
223 	POWER_SUPPLY_ENUM_ATTR(TYPE),
224 	POWER_SUPPLY_ENUM_ATTR(USB_TYPE),
225 	POWER_SUPPLY_ENUM_ATTR(SCOPE),
226 	POWER_SUPPLY_ATTR(PRECHARGE_CURRENT),
227 	POWER_SUPPLY_ATTR(CHARGE_TERM_CURRENT),
228 	POWER_SUPPLY_ATTR(CALIBRATE),
229 	POWER_SUPPLY_ATTR(MANUFACTURE_YEAR),
230 	POWER_SUPPLY_ATTR(MANUFACTURE_MONTH),
231 	POWER_SUPPLY_ATTR(MANUFACTURE_DAY),
232 	POWER_SUPPLY_ATTR(INTERNAL_RESISTANCE),
233 	POWER_SUPPLY_ATTR(STATE_OF_HEALTH),
234 	/* Properties of type `const char *' */
235 	POWER_SUPPLY_ATTR(MODEL_NAME),
236 	POWER_SUPPLY_ATTR(MANUFACTURER),
237 	POWER_SUPPLY_ATTR(SERIAL_NUMBER),
238 };
239 #define POWER_SUPPLY_ATTR_CNT ARRAY_SIZE(power_supply_attrs)
240 
241 static struct attribute *
242 __power_supply_attrs[POWER_SUPPLY_ATTR_CNT + 1] __ro_after_init;
243 
244 static const struct power_supply_attr *to_ps_attr(const struct device_attribute *attr)
245 {
246 	return container_of_const(attr, struct power_supply_attr, dev_attr);
247 }
248 
249 static enum power_supply_property dev_attr_psp(const struct device_attribute *attr)
250 {
251 	return  to_ps_attr(attr) - power_supply_attrs;
252 }
253 
254 static void power_supply_escape_spaces(const char *str, char *buf, size_t bufsize)
255 {
256 	strscpy(buf, str, bufsize);
257 	strreplace(buf, ' ', '_');
258 }
259 
260 static int power_supply_match_string(const char * const *array, size_t n, const char *s)
261 {
262 	int ret;
263 
264 	/* First try an exact match */
265 	ret = __sysfs_match_string(array, n, s);
266 	if (ret >= 0)
267 		return ret;
268 
269 	/* Second round, try matching with spaces replaced by '_' */
270 	for (size_t i = 0; i < n; i++) {
271 		char buf[32];
272 
273 		power_supply_escape_spaces(array[i], buf, sizeof(buf));
274 		if (sysfs_streq(buf, s))
275 			return i;
276 	}
277 
278 	return -EINVAL;
279 }
280 
281 static ssize_t power_supply_show_enum_with_available(
282 			struct device *dev, const char * const labels[], int label_count,
283 			unsigned int available_values, int value, char *buf)
284 {
285 	bool match = false, available, active;
286 	char escaped_label[32];
287 	ssize_t count = 0;
288 	int i;
289 
290 	for (i = 0; i < label_count; i++) {
291 		available = available_values & BIT(i);
292 		active = i == value;
293 		power_supply_escape_spaces(labels[i], escaped_label, sizeof(escaped_label));
294 
295 		if (available && active) {
296 			count += sysfs_emit_at(buf, count, "[%s] ", escaped_label);
297 			match = true;
298 		} else if (available) {
299 			count += sysfs_emit_at(buf, count, "%s ", escaped_label);
300 		}
301 	}
302 
303 	if (!match) {
304 		dev_warn(dev, "driver reporting unavailable enum value %d\n", value);
305 		return -EINVAL;
306 	}
307 
308 	if (count)
309 		buf[count - 1] = '\n';
310 
311 	return count;
312 }
313 
314 static ssize_t power_supply_show_charge_behaviour(struct device *dev,
315 						  struct power_supply *psy,
316 						  union power_supply_propval *value,
317 						  char *buf)
318 {
319 	struct power_supply_ext_registration *reg;
320 
321 	scoped_guard(rwsem_read, &psy->extensions_sem) {
322 		power_supply_for_each_extension(reg, psy) {
323 			if (power_supply_ext_has_property(reg->ext,
324 							  POWER_SUPPLY_PROP_CHARGE_BEHAVIOUR))
325 				return power_supply_charge_behaviour_show(dev,
326 						reg->ext->charge_behaviours,
327 						value->intval, buf);
328 		}
329 	}
330 
331 	return power_supply_charge_behaviour_show(dev, psy->desc->charge_behaviours,
332 						  value->intval, buf);
333 }
334 
335 static ssize_t power_supply_show_charge_types(struct device *dev,
336 					      struct power_supply *psy,
337 					      enum power_supply_charge_type current_type,
338 					      char *buf)
339 {
340 	struct power_supply_ext_registration *reg;
341 
342 	scoped_guard(rwsem_read, &psy->extensions_sem) {
343 		power_supply_for_each_extension(reg, psy) {
344 			if (power_supply_ext_has_property(reg->ext,
345 							  POWER_SUPPLY_PROP_CHARGE_TYPES))
346 				return power_supply_charge_types_show(dev,
347 						reg->ext->charge_types,
348 						current_type, buf);
349 		}
350 	}
351 
352 	return power_supply_charge_types_show(dev, psy->desc->charge_types,
353 						  current_type, buf);
354 }
355 
356 static ssize_t power_supply_format_property(struct device *dev,
357 					    bool uevent,
358 					    struct device_attribute *attr,
359 					    char *buf)
360 {
361 	ssize_t ret;
362 	struct power_supply *psy = dev_to_psy(dev);
363 	const struct power_supply_attr *ps_attr = to_ps_attr(attr);
364 	enum power_supply_property psp = dev_attr_psp(attr);
365 	union power_supply_propval value;
366 
367 	if (psp == POWER_SUPPLY_PROP_TYPE) {
368 		value.intval = psy->desc->type;
369 	} else {
370 		ret = power_supply_get_property(psy, psp, &value);
371 
372 		if (ret < 0) {
373 			if (ret == -ENODATA)
374 				dev_dbg_ratelimited(dev,
375 					"driver has no data for `%s' property\n",
376 					attr->attr.name);
377 			else if (ret != -ENODEV && ret != -EAGAIN && ret != -EINVAL)
378 				dev_err_ratelimited(dev,
379 					"driver failed to report `%s' property: %zd\n",
380 					attr->attr.name, ret);
381 			return ret;
382 		}
383 	}
384 
385 	switch (psp) {
386 	case POWER_SUPPLY_PROP_USB_TYPE:
387 		ret = power_supply_show_enum_with_available(
388 				dev, POWER_SUPPLY_USB_TYPE_TEXT,
389 				ARRAY_SIZE(POWER_SUPPLY_USB_TYPE_TEXT),
390 				psy->desc->usb_types, value.intval, buf);
391 		break;
392 	case POWER_SUPPLY_PROP_CHARGE_BEHAVIOUR:
393 		if (uevent) /* no possible values in uevents */
394 			goto default_format;
395 		ret = power_supply_show_charge_behaviour(dev, psy, &value, buf);
396 		break;
397 	case POWER_SUPPLY_PROP_CHARGE_TYPES:
398 		if (uevent) /* no possible values in uevents */
399 			goto default_format;
400 		ret = power_supply_show_charge_types(dev, psy,
401 						     value.intval, buf);
402 		break;
403 	case POWER_SUPPLY_PROP_MODEL_NAME ... POWER_SUPPLY_PROP_SERIAL_NUMBER:
404 		ret = sysfs_emit(buf, "%s\n", value.strval);
405 		break;
406 	default:
407 default_format:
408 		if (ps_attr->text_values_len > 0 &&
409 				value.intval < ps_attr->text_values_len && value.intval >= 0) {
410 			ret = sysfs_emit(buf, "%s\n", ps_attr->text_values[value.intval]);
411 		} else {
412 			ret = sysfs_emit(buf, "%d\n", value.intval);
413 		}
414 	}
415 
416 	return ret;
417 }
418 
419 static ssize_t power_supply_show_property(struct device *dev,
420 					  struct device_attribute *attr,
421 					  char *buf)
422 {
423 	return power_supply_format_property(dev, false, attr, buf);
424 }
425 
426 static ssize_t power_supply_store_property(struct device *dev,
427 					   struct device_attribute *attr,
428 					   const char *buf, size_t count) {
429 	ssize_t ret;
430 	struct power_supply *psy = dev_to_psy(dev);
431 	const struct power_supply_attr *ps_attr = to_ps_attr(attr);
432 	enum power_supply_property psp = dev_attr_psp(attr);
433 	union power_supply_propval value;
434 
435 	ret = -EINVAL;
436 	if (ps_attr->text_values_len > 0) {
437 		ret = power_supply_match_string(ps_attr->text_values,
438 						ps_attr->text_values_len, buf);
439 	}
440 
441 	/*
442 	 * If no match was found, then check to see if it is an integer.
443 	 * Integer values are valid for enums in addition to the text value.
444 	 */
445 	if (ret < 0) {
446 		long long_val;
447 
448 		ret = kstrtol(buf, 10, &long_val);
449 		if (ret < 0)
450 			return ret;
451 
452 		ret = long_val;
453 	}
454 
455 	value.intval = ret;
456 
457 	ret = power_supply_set_property(psy, psp, &value);
458 	if (ret < 0)
459 		return ret;
460 
461 	return count;
462 }
463 
464 static umode_t power_supply_attr_is_visible(struct kobject *kobj,
465 					   struct attribute *attr,
466 					   int attrno)
467 {
468 	struct device *dev = kobj_to_dev(kobj);
469 	struct power_supply *psy = dev_to_psy(dev);
470 	umode_t mode = S_IRUSR | S_IRGRP | S_IROTH;
471 
472 	if (!power_supply_attrs[attrno].prop_name)
473 		return 0;
474 
475 	if (attrno == POWER_SUPPLY_PROP_TYPE)
476 		return mode;
477 
478 	guard(rwsem_read)(&psy->extensions_sem);
479 
480 	if (power_supply_has_property(psy, attrno)) {
481 		if (power_supply_property_is_writeable(psy, attrno) > 0)
482 			mode |= S_IWUSR;
483 		return mode;
484 	}
485 
486 	return 0;
487 }
488 
489 static const struct attribute_group power_supply_attr_group = {
490 	.attrs = __power_supply_attrs,
491 	.is_visible = power_supply_attr_is_visible,
492 };
493 
494 static struct attribute *power_supply_extension_attrs[] = {
495 	NULL
496 };
497 
498 static const struct attribute_group power_supply_extension_group = {
499 	.name = "extensions",
500 	.attrs = power_supply_extension_attrs,
501 };
502 
503 const struct attribute_group *power_supply_attr_groups[] = {
504 	&power_supply_attr_group,
505 	&power_supply_extension_group,
506 	NULL
507 };
508 
509 void __init power_supply_init_attrs(void)
510 {
511 	int i;
512 
513 	for (i = 0; i < ARRAY_SIZE(power_supply_attrs); i++) {
514 		struct device_attribute *attr;
515 
516 		if (!power_supply_attrs[i].prop_name) {
517 			pr_warn("%s: Property %d skipped because it is missing from power_supply_attrs\n",
518 				__func__, i);
519 			sprintf(power_supply_attrs[i].attr_name, "_err_%d", i);
520 		} else {
521 			string_lower(power_supply_attrs[i].attr_name,
522 				     power_supply_attrs[i].attr_name);
523 		}
524 
525 		attr = &power_supply_attrs[i].dev_attr;
526 
527 		attr->attr.name = power_supply_attrs[i].attr_name;
528 		attr->show = power_supply_show_property;
529 		attr->store = power_supply_store_property;
530 		__power_supply_attrs[i] = &attr->attr;
531 	}
532 }
533 
534 static int add_prop_uevent(const struct device *dev, struct kobj_uevent_env *env,
535 			   enum power_supply_property prop, char *prop_buf)
536 {
537 	int ret = 0;
538 	struct power_supply_attr *pwr_attr;
539 	struct device_attribute *dev_attr;
540 	char *line;
541 
542 	pwr_attr = &power_supply_attrs[prop];
543 	dev_attr = &pwr_attr->dev_attr;
544 
545 	ret = power_supply_format_property((struct device *)dev, true, dev_attr, prop_buf);
546 	if (ret == -ENODEV || ret == -ENODATA || ret == -EINVAL) {
547 		/*
548 		 * When a battery is absent, we expect -ENODEV. Don't abort;
549 		 * send the uevent with at least the PRESENT=0 property
550 		 */
551 		return 0;
552 	}
553 
554 	if (ret < 0)
555 		return ret;
556 
557 	line = strchr(prop_buf, '\n');
558 	if (line)
559 		*line = 0;
560 
561 	return add_uevent_var(env, "POWER_SUPPLY_%s=%s",
562 			      pwr_attr->prop_name, prop_buf);
563 }
564 
565 int power_supply_uevent(const struct device *dev, struct kobj_uevent_env *env)
566 {
567 	const struct power_supply *psy = dev_to_psy(dev);
568 	int ret = 0, j;
569 	char *prop_buf;
570 
571 	if (!psy || !psy->desc) {
572 		dev_dbg(dev, "No power supply yet\n");
573 		return ret;
574 	}
575 
576 	ret = add_uevent_var(env, "POWER_SUPPLY_NAME=%s", psy->desc->name);
577 	if (ret)
578 		return ret;
579 
580 	/*
581 	 * Kernel generates KOBJ_REMOVE uevent in device removal path, after
582 	 * resources have been freed. Exit early to avoid use-after-free.
583 	 */
584 	if (psy->removing)
585 		return 0;
586 
587 	prop_buf = (char *)get_zeroed_page(GFP_KERNEL);
588 	if (!prop_buf)
589 		return -ENOMEM;
590 
591 	ret = add_prop_uevent(dev, env, POWER_SUPPLY_PROP_TYPE, prop_buf);
592 	if (ret)
593 		goto out;
594 
595 	for (j = 0; j < POWER_SUPPLY_ATTR_CNT; j++) {
596 		ret = add_prop_uevent(dev, env, j, prop_buf);
597 		if (ret)
598 			goto out;
599 	}
600 
601 out:
602 	free_page((unsigned long)prop_buf);
603 
604 	return ret;
605 }
606 
607 ssize_t power_supply_charge_behaviour_show(struct device *dev,
608 					   unsigned int available_behaviours,
609 					   enum power_supply_charge_behaviour current_behaviour,
610 					   char *buf)
611 {
612 	return power_supply_show_enum_with_available(
613 				dev, POWER_SUPPLY_CHARGE_BEHAVIOUR_TEXT,
614 				ARRAY_SIZE(POWER_SUPPLY_CHARGE_BEHAVIOUR_TEXT),
615 				available_behaviours, current_behaviour, buf);
616 }
617 EXPORT_SYMBOL_GPL(power_supply_charge_behaviour_show);
618 
619 int power_supply_charge_behaviour_parse(unsigned int available_behaviours, const char *buf)
620 {
621 	int i = sysfs_match_string(POWER_SUPPLY_CHARGE_BEHAVIOUR_TEXT, buf);
622 
623 	if (i < 0)
624 		return i;
625 
626 	if (available_behaviours & BIT(i))
627 		return i;
628 
629 	return -EINVAL;
630 }
631 EXPORT_SYMBOL_GPL(power_supply_charge_behaviour_parse);
632 
633 ssize_t power_supply_charge_types_show(struct device *dev,
634 				       unsigned int available_types,
635 				       enum power_supply_charge_type current_type,
636 				       char *buf)
637 {
638 	return power_supply_show_enum_with_available(
639 				dev, POWER_SUPPLY_CHARGE_TYPE_TEXT,
640 				ARRAY_SIZE(POWER_SUPPLY_CHARGE_TYPE_TEXT),
641 				available_types, current_type, buf);
642 }
643 EXPORT_SYMBOL_GPL(power_supply_charge_types_show);
644 
645 int power_supply_charge_types_parse(unsigned int available_types, const char *buf)
646 {
647 	int i = power_supply_match_string(POWER_SUPPLY_CHARGE_TYPE_TEXT,
648 					  ARRAY_SIZE(POWER_SUPPLY_CHARGE_TYPE_TEXT),
649 					  buf);
650 
651 	if (i < 0)
652 		return i;
653 
654 	if (available_types & BIT(i))
655 		return i;
656 
657 	return -EINVAL;
658 }
659 EXPORT_SYMBOL_GPL(power_supply_charge_types_parse);
660 
661 int power_supply_sysfs_add_extension(struct power_supply *psy, const struct power_supply_ext *ext,
662 				     struct device *dev)
663 {
664 	return sysfs_add_link_to_group(&psy->dev.kobj, power_supply_extension_group.name,
665 				       &dev->kobj, ext->name);
666 }
667 
668 void power_supply_sysfs_remove_extension(struct power_supply *psy,
669 					 const struct power_supply_ext *ext)
670 {
671 	sysfs_remove_link_from_group(&psy->dev.kobj, power_supply_extension_group.name, ext->name);
672 }
673