1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * A hwmon driver for ACPI 4.0 power meters
4 * Copyright (C) 2009 IBM
6 * Author: Darrick J. Wong <darrick.wong@oracle.com>
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];
537 sysfs_remove_link(resource->holders_dir,
538 kobject_name(&obj->dev.kobj));
542 kfree(resource->domain_devices);
543 kobject_put(resource->holders_dir);
544 resource->num_domain_devices = 0;
547 static int read_domain_devices(struct acpi_power_meter_resource *resource)
551 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
552 union acpi_object *pss;
555 status = acpi_evaluate_object(resource->acpi_dev->handle, "_PMD", NULL,
557 if (ACPI_FAILURE(status)) {
558 acpi_evaluation_failure_warn(resource->acpi_dev->handle, "_PMD",
563 pss = buffer.pointer;
565 pss->type != ACPI_TYPE_PACKAGE) {
566 dev_err(&resource->acpi_dev->dev, ACPI_POWER_METER_NAME
567 "Invalid _PMD data\n");
572 if (!pss->package.count)
575 resource->domain_devices = kcalloc(pss->package.count,
576 sizeof(struct acpi_device *),
578 if (!resource->domain_devices) {
583 resource->holders_dir = kobject_create_and_add("measures",
584 &resource->acpi_dev->dev.kobj);
585 if (!resource->holders_dir) {
590 resource->num_domain_devices = pss->package.count;
592 for (i = 0; i < pss->package.count; i++) {
593 struct acpi_device *obj;
594 union acpi_object *element = &pss->package.elements[i];
596 /* Refuse non-references */
597 if (element->type != ACPI_TYPE_LOCAL_REFERENCE)
600 /* Create a symlink to domain objects */
601 obj = acpi_get_acpi_dev(element->reference.handle);
602 resource->domain_devices[i] = obj;
606 res = sysfs_create_link(resource->holders_dir, &obj->dev.kobj,
607 kobject_name(&obj->dev.kobj));
610 resource->domain_devices[i] = NULL;
618 kfree(resource->domain_devices);
620 kfree(buffer.pointer);
624 /* Registration and deregistration */
625 static int register_attrs(struct acpi_power_meter_resource *resource,
626 struct sensor_template *attrs)
628 struct device *dev = &resource->acpi_dev->dev;
629 struct sensor_device_attribute *sensors =
630 &resource->sensors[resource->num_sensors];
633 while (attrs->label) {
634 sensors->dev_attr.attr.name = attrs->label;
635 sensors->dev_attr.attr.mode = 0444;
636 sensors->dev_attr.show = attrs->show;
637 sensors->index = attrs->index;
640 sensors->dev_attr.attr.mode |= 0200;
641 sensors->dev_attr.store = attrs->set;
644 sysfs_attr_init(&sensors->dev_attr.attr);
645 res = device_create_file(dev, &sensors->dev_attr);
647 sensors->dev_attr.attr.name = NULL;
651 resource->num_sensors++;
659 static void remove_attrs(struct acpi_power_meter_resource *resource)
663 for (i = 0; i < resource->num_sensors; i++) {
664 if (!resource->sensors[i].dev_attr.attr.name)
666 device_remove_file(&resource->acpi_dev->dev,
667 &resource->sensors[i].dev_attr);
670 remove_domain_devices(resource);
672 resource->num_sensors = 0;
675 static int setup_attrs(struct acpi_power_meter_resource *resource)
679 res = read_domain_devices(resource);
683 if (resource->caps.flags & POWER_METER_CAN_MEASURE) {
684 res = register_attrs(resource, meter_attrs);
689 if (resource->caps.flags & POWER_METER_CAN_CAP) {
690 if (!can_cap_in_hardware()) {
691 dev_warn(&resource->acpi_dev->dev,
692 "Ignoring unsafe software power cap!\n");
693 goto skip_unsafe_cap;
696 if (resource->caps.configurable_cap)
697 res = register_attrs(resource, rw_cap_attrs);
699 res = register_attrs(resource, ro_cap_attrs);
704 res = register_attrs(resource, misc_cap_attrs);
710 if (resource->caps.flags & POWER_METER_CAN_TRIP) {
711 res = register_attrs(resource, trip_attrs);
716 res = register_attrs(resource, misc_attrs);
722 remove_attrs(resource);
726 static void free_capabilities(struct acpi_power_meter_resource *resource)
731 str = &resource->model_number;
732 for (i = 0; i < 3; i++, str++) {
738 static int read_capabilities(struct acpi_power_meter_resource *resource)
742 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
743 struct acpi_buffer state = { 0, NULL };
744 struct acpi_buffer format = { sizeof("NNNNNNNNNNN"), "NNNNNNNNNNN" };
745 union acpi_object *pss;
749 status = acpi_evaluate_object(resource->acpi_dev->handle, "_PMC", NULL,
751 if (ACPI_FAILURE(status)) {
752 acpi_evaluation_failure_warn(resource->acpi_dev->handle, "_PMC",
757 pss = buffer.pointer;
759 pss->type != ACPI_TYPE_PACKAGE ||
760 pss->package.count != 14) {
761 dev_err(&resource->acpi_dev->dev, ACPI_POWER_METER_NAME
762 "Invalid _PMC data\n");
767 /* Grab all the integer data at once */
768 state.length = sizeof(struct acpi_power_meter_capabilities);
769 state.pointer = &resource->caps;
771 status = acpi_extract_package(pss, &format, &state);
772 if (ACPI_FAILURE(status)) {
773 dev_err(&resource->acpi_dev->dev, ACPI_POWER_METER_NAME
774 "_PMC package parsing failed: %s\n",
775 acpi_format_exception(status));
780 if (resource->caps.units) {
781 dev_err(&resource->acpi_dev->dev, ACPI_POWER_METER_NAME
782 "Unknown units %llu.\n",
783 resource->caps.units);
788 /* Grab the string data */
789 str = &resource->model_number;
791 for (i = 11; i < 14; i++) {
792 union acpi_object *element = &pss->package.elements[i];
794 if (element->type != ACPI_TYPE_STRING) {
799 *str = kcalloc(element->string.length + 1, sizeof(u8),
806 strncpy(*str, element->string.pointer, element->string.length);
810 dev_info(&resource->acpi_dev->dev, "Found ACPI power meter.\n");
813 free_capabilities(resource);
815 kfree(buffer.pointer);
819 /* Handle ACPI event notifications */
820 static void acpi_power_meter_notify(struct acpi_device *device, u32 event)
822 struct acpi_power_meter_resource *resource;
825 if (!device || !acpi_driver_data(device))
828 resource = acpi_driver_data(device);
831 case METER_NOTIFY_CONFIG:
832 mutex_lock(&resource->lock);
833 free_capabilities(resource);
834 res = read_capabilities(resource);
835 mutex_unlock(&resource->lock);
839 remove_attrs(resource);
840 setup_attrs(resource);
842 case METER_NOTIFY_TRIP:
843 sysfs_notify(&device->dev.kobj, NULL, POWER_AVERAGE_NAME);
845 case METER_NOTIFY_CAP:
846 sysfs_notify(&device->dev.kobj, NULL, POWER_CAP_NAME);
848 case METER_NOTIFY_INTERVAL:
849 sysfs_notify(&device->dev.kobj, NULL, POWER_AVG_INTERVAL_NAME);
851 case METER_NOTIFY_CAPPING:
852 sysfs_notify(&device->dev.kobj, NULL, POWER_ALARM_NAME);
853 dev_info(&device->dev, "Capping in progress.\n");
856 WARN(1, "Unexpected event %d\n", event);
860 acpi_bus_generate_netlink_event(ACPI_POWER_METER_CLASS,
861 dev_name(&device->dev), event, 0);
864 static int acpi_power_meter_add(struct acpi_device *device)
867 struct acpi_power_meter_resource *resource;
872 resource = kzalloc(sizeof(*resource), GFP_KERNEL);
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] = -1;
888 resource->trip[1] = -1;
890 res = setup_attrs(resource);
892 goto exit_free_capability;
894 resource->hwmon_dev = hwmon_device_register(&device->dev);
895 if (IS_ERR(resource->hwmon_dev)) {
896 res = PTR_ERR(resource->hwmon_dev);
904 remove_attrs(resource);
905 exit_free_capability:
906 free_capabilities(resource);
913 static void acpi_power_meter_remove(struct acpi_device *device)
915 struct acpi_power_meter_resource *resource;
917 if (!device || !acpi_driver_data(device))
920 resource = acpi_driver_data(device);
921 hwmon_device_unregister(resource->hwmon_dev);
923 remove_attrs(resource);
924 free_capabilities(resource);
929 static int acpi_power_meter_resume(struct device *dev)
931 struct acpi_power_meter_resource *resource;
936 resource = acpi_driver_data(to_acpi_device(dev));
940 free_capabilities(resource);
941 read_capabilities(resource);
946 static DEFINE_SIMPLE_DEV_PM_OPS(acpi_power_meter_pm, NULL,
947 acpi_power_meter_resume);
949 static struct acpi_driver acpi_power_meter_driver = {
950 .name = "power_meter",
951 .class = ACPI_POWER_METER_CLASS,
952 .ids = power_meter_ids,
954 .add = acpi_power_meter_add,
955 .remove = acpi_power_meter_remove,
956 .notify = acpi_power_meter_notify,
958 .drv.pm = pm_sleep_ptr(&acpi_power_meter_pm),
961 /* Module init/exit routines */
962 static int __init enable_cap_knobs(const struct dmi_system_id *d)
968 static const struct dmi_system_id pm_dmi_table[] __initconst = {
970 enable_cap_knobs, "IBM Active Energy Manager",
972 DMI_MATCH(DMI_SYS_VENDOR, "IBM")
978 static int __init acpi_power_meter_init(void)
985 dmi_check_system(pm_dmi_table);
987 result = acpi_bus_register_driver(&acpi_power_meter_driver);
994 static void __exit acpi_power_meter_exit(void)
996 acpi_bus_unregister_driver(&acpi_power_meter_driver);
999 MODULE_AUTHOR("Darrick J. Wong <darrick.wong@oracle.com>");
1000 MODULE_DESCRIPTION("ACPI 4.0 power meter driver");
1001 MODULE_LICENSE("GPL");
1003 module_param(force_cap_on, bool, 0644);
1004 MODULE_PARM_DESC(force_cap_on, "Enable power cap even it is unsafe to do so.");
1006 module_init(acpi_power_meter_init);
1007 module_exit(acpi_power_meter_exit);