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

source code of linux/drivers/power/supply/power_supply_sysfs.c