1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * A hwmon driver for ACPI 4.0 power meters
4 * Copyright (C) 2009 IBM
9 #include <linux/module.h>
10 #include <linux/hwmon.h>
11 #include <linux/hwmon-sysfs.h>
12 #include <linux/jiffies.h>
13 #include <linux/mutex.h>
14 #include <linux/dmi.h>
15 #include <linux/slab.h>
16 #include <linux/kdev_t.h>
17 #include <linux/sched.h>
18 #include <linux/time.h>
19 #include <linux/err.h>
20 #include <linux/acpi.h>
22 #define ACPI_POWER_METER_NAME "power_meter"
23 #define ACPI_POWER_METER_DEVICE_NAME "Power Meter"
24 #define ACPI_POWER_METER_CLASS "pwr_meter_resource"
26 #define NUM_SENSORS 17
28 #define POWER_METER_CAN_MEASURE (1 << 0)
29 #define POWER_METER_CAN_TRIP (1 << 1)
30 #define POWER_METER_CAN_CAP (1 << 2)
31 #define POWER_METER_CAN_NOTIFY (1 << 3)
32 #define POWER_METER_IS_BATTERY (1 << 8)
33 #define UNKNOWN_HYSTERESIS 0xFFFFFFFF
35 #define METER_NOTIFY_CONFIG 0x80
36 #define METER_NOTIFY_TRIP 0x81
37 #define METER_NOTIFY_CAP 0x82
38 #define METER_NOTIFY_CAPPING 0x83
39 #define METER_NOTIFY_INTERVAL 0x84
41 #define POWER_AVERAGE_NAME "power1_average"
42 #define POWER_CAP_NAME "power1_cap"
43 #define POWER_AVG_INTERVAL_NAME "power1_average_interval"
44 #define POWER_ALARM_NAME "power1_alarm"
46 static int cap_in_hardware;
47 static bool force_cap_on;
49 static int can_cap_in_hardware(void)
51 return force_cap_on || cap_in_hardware;
54 static const struct acpi_device_id power_meter_ids[] = {
58 MODULE_DEVICE_TABLE(acpi, power_meter_ids);
60 struct acpi_power_meter_capabilities {
74 struct acpi_power_meter_resource {
75 struct acpi_device *acpi_dev;
78 struct device *hwmon_dev;
79 struct acpi_power_meter_capabilities caps;
80 acpi_string model_number;
81 acpi_string serial_number;
87 unsigned long sensors_last_updated;
88 struct sensor_device_attribute sensors[NUM_SENSORS];
91 int num_domain_devices;
92 struct acpi_device **domain_devices;
93 struct kobject *holders_dir;
96 struct sensor_template {
98 ssize_t (*show)(struct device *dev,
99 struct device_attribute *devattr,
101 ssize_t (*set)(struct device *dev,
102 struct device_attribute *devattr,
103 const char *buf, size_t count);
107 /* Averaging interval */
108 static int update_avg_interval(struct acpi_power_meter_resource *resource)
110 unsigned long long data;
113 status = acpi_evaluate_integer(resource->acpi_dev->handle, "_GAI",
115 if (ACPI_FAILURE(status)) {
116 acpi_evaluation_failure_warn(resource->acpi_dev->handle, "_GAI",
121 resource->avg_interval = data;
125 static ssize_t show_avg_interval(struct device *dev,
126 struct device_attribute *devattr,
129 struct acpi_device *acpi_dev = to_acpi_device(dev);
130 struct acpi_power_meter_resource *resource = acpi_dev->driver_data;
132 mutex_lock(&resource->lock);
133 update_avg_interval(resource);
134 mutex_unlock(&resource->lock);
136 return sprintf(buf, "%llu\n", resource->avg_interval);
139 static ssize_t set_avg_interval(struct device *dev,
140 struct device_attribute *devattr,
141 const char *buf, size_t count)
143 struct acpi_device *acpi_dev = to_acpi_device(dev);
144 struct acpi_power_meter_resource *resource = acpi_dev->driver_data;
145 union acpi_object arg0 = { ACPI_TYPE_INTEGER };
146 struct acpi_object_list args = { 1, &arg0 };
149 unsigned long long data;
152 res = kstrtoul(buf, 10, &temp);
156 if (temp > resource->caps.max_avg_interval ||
157 temp < resource->caps.min_avg_interval)
159 arg0.integer.value = temp;
161 mutex_lock(&resource->lock);
162 status = acpi_evaluate_integer(resource->acpi_dev->handle, "_PAI",
164 if (ACPI_SUCCESS(status))
165 resource->avg_interval = temp;
166 mutex_unlock(&resource->lock);
168 if (ACPI_FAILURE(status)) {
169 acpi_evaluation_failure_warn(resource->acpi_dev->handle, "_PAI",
174 /* _PAI returns 0 on success, nonzero otherwise */
182 static int update_cap(struct acpi_power_meter_resource *resource)
184 unsigned long long data;
187 status = acpi_evaluate_integer(resource->acpi_dev->handle, "_GHL",
189 if (ACPI_FAILURE(status)) {
190 acpi_evaluation_failure_warn(resource->acpi_dev->handle, "_GHL",
195 resource->cap = data;
199 static ssize_t show_cap(struct device *dev,
200 struct device_attribute *devattr,
203 struct acpi_device *acpi_dev = to_acpi_device(dev);
204 struct acpi_power_meter_resource *resource = acpi_dev->driver_data;
206 mutex_lock(&resource->lock);
207 update_cap(resource);
208 mutex_unlock(&resource->lock);
210 return sprintf(buf, "%llu\n", resource->cap * 1000);
213 static ssize_t set_cap(struct device *dev, struct device_attribute *devattr,
214 const char *buf, size_t count)
216 struct acpi_device *acpi_dev = to_acpi_device(dev);
217 struct acpi_power_meter_resource *resource = acpi_dev->driver_data;
218 union acpi_object arg0 = { ACPI_TYPE_INTEGER };
219 struct acpi_object_list args = { 1, &arg0 };
222 unsigned long long data;
225 res = kstrtoul(buf, 10, &temp);
229 temp = DIV_ROUND_CLOSEST(temp, 1000);
230 if (temp > resource->caps.max_cap || temp < resource->caps.min_cap)
232 arg0.integer.value = temp;
234 mutex_lock(&resource->lock);
235 status = acpi_evaluate_integer(resource->acpi_dev->handle, "_SHL",
237 if (ACPI_SUCCESS(status))
238 resource->cap = temp;
239 mutex_unlock(&resource->lock);
241 if (ACPI_FAILURE(status)) {
242 acpi_evaluation_failure_warn(resource->acpi_dev->handle, "_SHL",
247 /* _SHL returns 0 on success, nonzero otherwise */
254 /* Power meter trip points */
255 static int set_acpi_trip(struct acpi_power_meter_resource *resource)
257 union acpi_object arg_objs[] = {
261 struct acpi_object_list args = { 2, arg_objs };
262 unsigned long long data;
265 /* Both trip levels must be set */
266 if (resource->trip[0] < 0 || resource->trip[1] < 0)
269 /* This driver stores min, max; ACPI wants max, min. */
270 arg_objs[0].integer.value = resource->trip[1];
271 arg_objs[1].integer.value = resource->trip[0];
273 status = acpi_evaluate_integer(resource->acpi_dev->handle, "_PTP",
275 if (ACPI_FAILURE(status)) {
276 acpi_evaluation_failure_warn(resource->acpi_dev->handle, "_PTP",
281 /* _PTP returns 0 on success, nonzero otherwise */
288 static ssize_t set_trip(struct device *dev, struct device_attribute *devattr,
289 const char *buf, size_t count)
291 struct sensor_device_attribute *attr = to_sensor_dev_attr(devattr);
292 struct acpi_device *acpi_dev = to_acpi_device(dev);
293 struct acpi_power_meter_resource *resource = acpi_dev->driver_data;
297 res = kstrtoul(buf, 10, &temp);
301 temp = DIV_ROUND_CLOSEST(temp, 1000);
303 mutex_lock(&resource->lock);
304 resource->trip[attr->index - 7] = temp;
305 res = set_acpi_trip(resource);
306 mutex_unlock(&resource->lock);
315 static int update_meter(struct acpi_power_meter_resource *resource)
317 unsigned long long data;
319 unsigned long local_jiffies = jiffies;
321 if (time_before(local_jiffies, resource->sensors_last_updated +
322 msecs_to_jiffies(resource->caps.sampling_time)) &&
323 resource->sensors_valid)
326 status = acpi_evaluate_integer(resource->acpi_dev->handle, "_PMM",
328 if (ACPI_FAILURE(status)) {
329 acpi_evaluation_failure_warn(resource->acpi_dev->handle, "_PMM",
334 resource->power = data;
335 resource->sensors_valid = 1;
336 resource->sensors_last_updated = jiffies;
340 static ssize_t show_power(struct device *dev,
341 struct device_attribute *devattr,
344 struct acpi_device *acpi_dev = to_acpi_device(dev);
345 struct acpi_power_meter_resource *resource = acpi_dev->driver_data;
347 mutex_lock(&resource->lock);
348 update_meter(resource);
349 mutex_unlock(&resource->lock);
351 return sprintf(buf, "%llu\n", resource->power * 1000);
355 static ssize_t show_str(struct device *dev,
356 struct device_attribute *devattr,
359 struct sensor_device_attribute *attr = to_sensor_dev_attr(devattr);
360 struct acpi_device *acpi_dev = to_acpi_device(dev);
361 struct acpi_power_meter_resource *resource = acpi_dev->driver_data;
365 mutex_lock(&resource->lock);
366 switch (attr->index) {
368 val = resource->model_number;
371 val = resource->serial_number;
374 val = resource->oem_info;
377 WARN(1, "Implementation error: unexpected attribute index %d\n",
382 ret = sprintf(buf, "%s\n", val);
383 mutex_unlock(&resource->lock);
387 static ssize_t show_val(struct device *dev,
388 struct device_attribute *devattr,
391 struct sensor_device_attribute *attr = to_sensor_dev_attr(devattr);
392 struct acpi_device *acpi_dev = to_acpi_device(dev);
393 struct acpi_power_meter_resource *resource = acpi_dev->driver_data;
396 switch (attr->index) {
398 val = resource->caps.min_avg_interval;
401 val = resource->caps.max_avg_interval;
404 val = resource->caps.min_cap * 1000;
407 val = resource->caps.max_cap * 1000;
410 if (resource->caps.hysteresis == UNKNOWN_HYSTERESIS)
411 return sprintf(buf, "unknown\n");
413 val = resource->caps.hysteresis * 1000;
416 if (resource->caps.flags & POWER_METER_IS_BATTERY)
422 if (resource->power > resource->cap)
429 if (resource->trip[attr->index - 7] < 0)
430 return sprintf(buf, "unknown\n");
432 val = resource->trip[attr->index - 7] * 1000;
435 WARN(1, "Implementation error: unexpected attribute index %d\n",
440 return sprintf(buf, "%llu\n", val);
443 static ssize_t show_accuracy(struct device *dev,
444 struct device_attribute *devattr,
447 struct acpi_device *acpi_dev = to_acpi_device(dev);
448 struct acpi_power_meter_resource *resource = acpi_dev->driver_data;
449 unsigned int acc = resource->caps.accuracy;
451 return sprintf(buf, "%u.%u%%\n", acc / 1000, acc % 1000);
454 static ssize_t show_name(struct device *dev,
455 struct device_attribute *devattr,
458 return sprintf(buf, "%s\n", ACPI_POWER_METER_NAME);
461 #define RO_SENSOR_TEMPLATE(_label, _show, _index) \
468 #define RW_SENSOR_TEMPLATE(_label, _show, _set, _index) \
476 /* Sensor descriptions. If you add a sensor, update NUM_SENSORS above! */
477 static struct sensor_template meter_attrs[] = {
478 RO_SENSOR_TEMPLATE(POWER_AVERAGE_NAME, show_power, 0),
479 RO_SENSOR_TEMPLATE("power1_accuracy", show_accuracy, 0),
480 RO_SENSOR_TEMPLATE("power1_average_interval_min", show_val, 0),
481 RO_SENSOR_TEMPLATE("power1_average_interval_max", show_val, 1),
482 RO_SENSOR_TEMPLATE("power1_is_battery", show_val, 5),
483 RW_SENSOR_TEMPLATE(POWER_AVG_INTERVAL_NAME, show_avg_interval,
484 set_avg_interval, 0),
488 static struct sensor_template misc_cap_attrs[] = {
489 RO_SENSOR_TEMPLATE("power1_cap_min", show_val, 2),
490 RO_SENSOR_TEMPLATE("power1_cap_max", show_val, 3),
491 RO_SENSOR_TEMPLATE("power1_cap_hyst", show_val, 4),
492 RO_SENSOR_TEMPLATE(POWER_ALARM_NAME, show_val, 6),
496 static struct sensor_template ro_cap_attrs[] = {
497 RO_SENSOR_TEMPLATE(POWER_CAP_NAME, show_cap, 0),
501 static struct sensor_template rw_cap_attrs[] = {
502 RW_SENSOR_TEMPLATE(POWER_CAP_NAME, show_cap, set_cap, 0),
506 static struct sensor_template trip_attrs[] = {
507 RW_SENSOR_TEMPLATE("power1_average_min", show_val, set_trip, 7),
508 RW_SENSOR_TEMPLATE("power1_average_max", show_val, set_trip, 8),
512 static struct sensor_template misc_attrs[] = {
513 RO_SENSOR_TEMPLATE("name", show_name, 0),
514 RO_SENSOR_TEMPLATE("power1_model_number", show_str, 0),
515 RO_SENSOR_TEMPLATE("power1_oem_info", show_str, 2),
516 RO_SENSOR_TEMPLATE("power1_serial_number", show_str, 1),
520 #undef RO_SENSOR_TEMPLATE
521 #undef RW_SENSOR_TEMPLATE
523 /* Read power domain data */
524 static void remove_domain_devices(struct acpi_power_meter_resource *resource)
528 if (!resource->num_domain_devices)
531 for (i = 0; i < resource->num_domain_devices; i++) {
532 struct acpi_device *obj = resource->domain_devices[i];
536 sysfs_remove_link(resource->holders_dir,
537 kobject_name(&obj->dev.kobj));
541 kfree(resource->domain_devices);
542 kobject_put(resource->holders_dir);
543 resource->num_domain_devices = 0;
546 static int read_domain_devices(struct acpi_power_meter_resource *resource)
550 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
551 union acpi_object *pss;
554 status = acpi_evaluate_object(resource->acpi_dev->handle, "_PMD", NULL,
556 if (ACPI_FAILURE(status)) {
557 acpi_evaluation_failure_warn(resource->acpi_dev->handle, "_PMD",
562 pss = buffer.pointer;
564 pss->type != ACPI_TYPE_PACKAGE) {
565 dev_err(&resource->acpi_dev->dev, ACPI_POWER_METER_NAME
566 "Invalid _PMD data\n");
571 if (!pss->package.count)
574 resource->domain_devices = kcalloc(pss->package.count,
575 sizeof(struct acpi_device *),
577 if (!resource->domain_devices) {
582 resource->holders_dir = kobject_create_and_add("measures",
583 &resource->acpi_dev->dev.kobj);
584 if (!resource->holders_dir) {
589 resource->num_domain_devices = pss->package.count;
591 for (i = 0; i < pss->package.count; i++) {
592 struct acpi_device *obj;
593 union acpi_object *element = &(pss->package.elements[i]);
595 /* Refuse non-references */
596 if (element->type != ACPI_TYPE_LOCAL_REFERENCE)
599 /* Create a symlink to domain objects */
600 obj = acpi_bus_get_acpi_device(element->reference.handle);
601 resource->domain_devices[i] = obj;
605 res = sysfs_create_link(resource->holders_dir, &obj->dev.kobj,
606 kobject_name(&obj->dev.kobj));
609 resource->domain_devices[i] = NULL;
617 kfree(resource->domain_devices);
619 kfree(buffer.pointer);
623 /* Registration and deregistration */
624 static int register_attrs(struct acpi_power_meter_resource *resource,
625 struct sensor_template *attrs)
627 struct device *dev = &resource->acpi_dev->dev;
628 struct sensor_device_attribute *sensors =
629 &resource->sensors[resource->num_sensors];
632 while (attrs->label) {
633 sensors->dev_attr.attr.name = attrs->label;
634 sensors->dev_attr.attr.mode = 0444;
635 sensors->dev_attr.show = attrs->show;
636 sensors->index = attrs->index;
639 sensors->dev_attr.attr.mode |= 0200;
640 sensors->dev_attr.store = attrs->set;
643 sysfs_attr_init(&sensors->dev_attr.attr);
644 res = device_create_file(dev, &sensors->dev_attr);
646 sensors->dev_attr.attr.name = NULL;
650 resource->num_sensors++;
658 static void remove_attrs(struct acpi_power_meter_resource *resource)
662 for (i = 0; i < resource->num_sensors; i++) {
663 if (!resource->sensors[i].dev_attr.attr.name)
665 device_remove_file(&resource->acpi_dev->dev,
666 &resource->sensors[i].dev_attr);
669 remove_domain_devices(resource);
671 resource->num_sensors = 0;
674 static int setup_attrs(struct acpi_power_meter_resource *resource)
678 res = read_domain_devices(resource);
682 if (resource->caps.flags & POWER_METER_CAN_MEASURE) {
683 res = register_attrs(resource, meter_attrs);
688 if (resource->caps.flags & POWER_METER_CAN_CAP) {
689 if (!can_cap_in_hardware()) {
690 dev_warn(&resource->acpi_dev->dev,
691 "Ignoring unsafe software power cap!\n");
692 goto skip_unsafe_cap;
695 if (resource->caps.configurable_cap)
696 res = register_attrs(resource, rw_cap_attrs);
698 res = register_attrs(resource, ro_cap_attrs);
703 res = register_attrs(resource, misc_cap_attrs);
709 if (resource->caps.flags & POWER_METER_CAN_TRIP) {
710 res = register_attrs(resource, trip_attrs);
715 res = register_attrs(resource, misc_attrs);
721 remove_attrs(resource);
725 static void free_capabilities(struct acpi_power_meter_resource *resource)
730 str = &resource->model_number;
731 for (i = 0; i < 3; i++, str++) {
737 static int read_capabilities(struct acpi_power_meter_resource *resource)
741 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
742 struct acpi_buffer state = { 0, NULL };
743 struct acpi_buffer format = { sizeof("NNNNNNNNNNN"), "NNNNNNNNNNN" };
744 union acpi_object *pss;
748 status = acpi_evaluate_object(resource->acpi_dev->handle, "_PMC", NULL,
750 if (ACPI_FAILURE(status)) {
751 acpi_evaluation_failure_warn(resource->acpi_dev->handle, "_PMC",
756 pss = buffer.pointer;
758 pss->type != ACPI_TYPE_PACKAGE ||
759 pss->package.count != 14) {
760 dev_err(&resource->acpi_dev->dev, ACPI_POWER_METER_NAME
761 "Invalid _PMC data\n");
766 /* Grab all the integer data at once */
767 state.length = sizeof(struct acpi_power_meter_capabilities);
768 state.pointer = &resource->caps;
770 status = acpi_extract_package(pss, &format, &state);
771 if (ACPI_FAILURE(status)) {
772 dev_err(&resource->acpi_dev->dev, ACPI_POWER_METER_NAME
773 "_PMC package parsing failed: %s\n",
774 acpi_format_exception(status));
779 if (resource->caps.units) {
780 dev_err(&resource->acpi_dev->dev, ACPI_POWER_METER_NAME
781 "Unknown units %llu.\n",
782 resource->caps.units);
787 /* Grab the string data */
788 str = &resource->model_number;
790 for (i = 11; i < 14; i++) {
791 union acpi_object *element = &(pss->package.elements[i]);
793 if (element->type != ACPI_TYPE_STRING) {
798 *str = kcalloc(element->string.length + 1, sizeof(u8),
805 strncpy(*str, element->string.pointer, element->string.length);
809 dev_info(&resource->acpi_dev->dev, "Found ACPI power meter.\n");
812 free_capabilities(resource);
814 kfree(buffer.pointer);
818 /* Handle ACPI event notifications */
819 static void acpi_power_meter_notify(struct acpi_device *device, u32 event)
821 struct acpi_power_meter_resource *resource;
824 if (!device || !acpi_driver_data(device))
827 resource = acpi_driver_data(device);
830 case METER_NOTIFY_CONFIG:
831 mutex_lock(&resource->lock);
832 free_capabilities(resource);
833 res = read_capabilities(resource);
834 mutex_unlock(&resource->lock);
838 remove_attrs(resource);
839 setup_attrs(resource);
841 case METER_NOTIFY_TRIP:
842 sysfs_notify(&device->dev.kobj, NULL, POWER_AVERAGE_NAME);
844 case METER_NOTIFY_CAP:
845 sysfs_notify(&device->dev.kobj, NULL, POWER_CAP_NAME);
847 case METER_NOTIFY_INTERVAL:
848 sysfs_notify(&device->dev.kobj, NULL, POWER_AVG_INTERVAL_NAME);
850 case METER_NOTIFY_CAPPING:
851 sysfs_notify(&device->dev.kobj, NULL, POWER_ALARM_NAME);
852 dev_info(&device->dev, "Capping in progress.\n");
855 WARN(1, "Unexpected event %d\n", event);
859 acpi_bus_generate_netlink_event(ACPI_POWER_METER_CLASS,
860 dev_name(&device->dev), event, 0);
863 static int acpi_power_meter_add(struct acpi_device *device)
866 struct acpi_power_meter_resource *resource;
871 resource = kzalloc(sizeof(struct acpi_power_meter_resource),
876 resource->sensors_valid = 0;
877 resource->acpi_dev = device;
878 mutex_init(&resource->lock);
879 strcpy(acpi_device_name(device), ACPI_POWER_METER_DEVICE_NAME);
880 strcpy(acpi_device_class(device), ACPI_POWER_METER_CLASS);
881 device->driver_data = resource;
883 res = read_capabilities(resource);
887 resource->trip[0] = resource->trip[1] = -1;
889 res = setup_attrs(resource);
891 goto exit_free_capability;
893 resource->hwmon_dev = hwmon_device_register(&device->dev);
894 if (IS_ERR(resource->hwmon_dev)) {
895 res = PTR_ERR(resource->hwmon_dev);
903 remove_attrs(resource);
904 exit_free_capability:
905 free_capabilities(resource);
912 static int acpi_power_meter_remove(struct acpi_device *device)
914 struct acpi_power_meter_resource *resource;
916 if (!device || !acpi_driver_data(device))
919 resource = acpi_driver_data(device);
920 hwmon_device_unregister(resource->hwmon_dev);
922 remove_attrs(resource);
923 free_capabilities(resource);
929 #ifdef CONFIG_PM_SLEEP
931 static int acpi_power_meter_resume(struct device *dev)
933 struct acpi_power_meter_resource *resource;
938 resource = acpi_driver_data(to_acpi_device(dev));
942 free_capabilities(resource);
943 read_capabilities(resource);
948 #endif /* CONFIG_PM_SLEEP */
950 static SIMPLE_DEV_PM_OPS(acpi_power_meter_pm, NULL, acpi_power_meter_resume);
952 static struct acpi_driver acpi_power_meter_driver = {
953 .name = "power_meter",
954 .class = ACPI_POWER_METER_CLASS,
955 .ids = power_meter_ids,
957 .add = acpi_power_meter_add,
958 .remove = acpi_power_meter_remove,
959 .notify = acpi_power_meter_notify,
961 .drv.pm = &acpi_power_meter_pm,
964 /* Module init/exit routines */
965 static int __init enable_cap_knobs(const struct dmi_system_id *d)
971 static const struct dmi_system_id pm_dmi_table[] __initconst = {
973 enable_cap_knobs, "IBM Active Energy Manager",
975 DMI_MATCH(DMI_SYS_VENDOR, "IBM")
981 static int __init acpi_power_meter_init(void)
988 dmi_check_system(pm_dmi_table);
990 result = acpi_bus_register_driver(&acpi_power_meter_driver);
997 static void __exit acpi_power_meter_exit(void)
999 acpi_bus_unregister_driver(&acpi_power_meter_driver);
1003 MODULE_DESCRIPTION("ACPI 4.0 power meter driver");
1004 MODULE_LICENSE("GPL");
1006 module_param(force_cap_on, bool, 0644);
1007 MODULE_PARM_DESC(force_cap_on, "Enable power cap even it is unsafe to do so.");
1009 module_init(acpi_power_meter_init);
1010 module_exit(acpi_power_meter_exit);