powercap/intel_rapl: Add missing domain data update on hotplug
[linux/fpc-iii.git] / drivers / powercap / intel_rapl.c
blob94b9901d192fec7daf7315801c01edc3728d20cd
1 /*
2 * Intel Running Average Power Limit (RAPL) Driver
3 * Copyright (c) 2013, Intel Corporation.
5 * This program is free software; you can redistribute it and/or modify it
6 * under the terms and conditions of the GNU General Public License,
7 * version 2, as published by the Free Software Foundation.
9 * This program is distributed in the hope it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
12 * more details.
14 * You should have received a copy of the GNU General Public License along with
15 * this program; if not, write to the Free Software Foundation, Inc.
18 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
20 #include <linux/kernel.h>
21 #include <linux/module.h>
22 #include <linux/list.h>
23 #include <linux/types.h>
24 #include <linux/device.h>
25 #include <linux/slab.h>
26 #include <linux/log2.h>
27 #include <linux/bitmap.h>
28 #include <linux/delay.h>
29 #include <linux/sysfs.h>
30 #include <linux/cpu.h>
31 #include <linux/powercap.h>
32 #include <asm/iosf_mbi.h>
34 #include <asm/processor.h>
35 #include <asm/cpu_device_id.h>
36 #include <asm/intel-family.h>
38 /* Local defines */
39 #define MSR_PLATFORM_POWER_LIMIT 0x0000065C
41 /* bitmasks for RAPL MSRs, used by primitive access functions */
42 #define ENERGY_STATUS_MASK 0xffffffff
44 #define POWER_LIMIT1_MASK 0x7FFF
45 #define POWER_LIMIT1_ENABLE BIT(15)
46 #define POWER_LIMIT1_CLAMP BIT(16)
48 #define POWER_LIMIT2_MASK (0x7FFFULL<<32)
49 #define POWER_LIMIT2_ENABLE BIT_ULL(47)
50 #define POWER_LIMIT2_CLAMP BIT_ULL(48)
51 #define POWER_PACKAGE_LOCK BIT_ULL(63)
52 #define POWER_PP_LOCK BIT(31)
54 #define TIME_WINDOW1_MASK (0x7FULL<<17)
55 #define TIME_WINDOW2_MASK (0x7FULL<<49)
57 #define POWER_UNIT_OFFSET 0
58 #define POWER_UNIT_MASK 0x0F
60 #define ENERGY_UNIT_OFFSET 0x08
61 #define ENERGY_UNIT_MASK 0x1F00
63 #define TIME_UNIT_OFFSET 0x10
64 #define TIME_UNIT_MASK 0xF0000
66 #define POWER_INFO_MAX_MASK (0x7fffULL<<32)
67 #define POWER_INFO_MIN_MASK (0x7fffULL<<16)
68 #define POWER_INFO_MAX_TIME_WIN_MASK (0x3fULL<<48)
69 #define POWER_INFO_THERMAL_SPEC_MASK 0x7fff
71 #define PERF_STATUS_THROTTLE_TIME_MASK 0xffffffff
72 #define PP_POLICY_MASK 0x1F
74 /* Non HW constants */
75 #define RAPL_PRIMITIVE_DERIVED BIT(1) /* not from raw data */
76 #define RAPL_PRIMITIVE_DUMMY BIT(2)
78 #define TIME_WINDOW_MAX_MSEC 40000
79 #define TIME_WINDOW_MIN_MSEC 250
80 #define ENERGY_UNIT_SCALE 1000 /* scale from driver unit to powercap unit */
81 enum unit_type {
82 ARBITRARY_UNIT, /* no translation */
83 POWER_UNIT,
84 ENERGY_UNIT,
85 TIME_UNIT,
88 enum rapl_domain_type {
89 RAPL_DOMAIN_PACKAGE, /* entire package/socket */
90 RAPL_DOMAIN_PP0, /* core power plane */
91 RAPL_DOMAIN_PP1, /* graphics uncore */
92 RAPL_DOMAIN_DRAM,/* DRAM control_type */
93 RAPL_DOMAIN_PLATFORM, /* PSys control_type */
94 RAPL_DOMAIN_MAX,
97 enum rapl_domain_msr_id {
98 RAPL_DOMAIN_MSR_LIMIT,
99 RAPL_DOMAIN_MSR_STATUS,
100 RAPL_DOMAIN_MSR_PERF,
101 RAPL_DOMAIN_MSR_POLICY,
102 RAPL_DOMAIN_MSR_INFO,
103 RAPL_DOMAIN_MSR_MAX,
106 /* per domain data, some are optional */
107 enum rapl_primitives {
108 ENERGY_COUNTER,
109 POWER_LIMIT1,
110 POWER_LIMIT2,
111 FW_LOCK,
113 PL1_ENABLE, /* power limit 1, aka long term */
114 PL1_CLAMP, /* allow frequency to go below OS request */
115 PL2_ENABLE, /* power limit 2, aka short term, instantaneous */
116 PL2_CLAMP,
118 TIME_WINDOW1, /* long term */
119 TIME_WINDOW2, /* short term */
120 THERMAL_SPEC_POWER,
121 MAX_POWER,
123 MIN_POWER,
124 MAX_TIME_WINDOW,
125 THROTTLED_TIME,
126 PRIORITY_LEVEL,
128 /* below are not raw primitive data */
129 AVERAGE_POWER,
130 NR_RAPL_PRIMITIVES,
133 #define NR_RAW_PRIMITIVES (NR_RAPL_PRIMITIVES - 2)
135 /* Can be expanded to include events, etc.*/
136 struct rapl_domain_data {
137 u64 primitives[NR_RAPL_PRIMITIVES];
138 unsigned long timestamp;
141 struct msrl_action {
142 u32 msr_no;
143 u64 clear_mask;
144 u64 set_mask;
145 int err;
148 #define DOMAIN_STATE_INACTIVE BIT(0)
149 #define DOMAIN_STATE_POWER_LIMIT_SET BIT(1)
150 #define DOMAIN_STATE_BIOS_LOCKED BIT(2)
152 #define NR_POWER_LIMITS (2)
153 struct rapl_power_limit {
154 struct powercap_zone_constraint *constraint;
155 int prim_id; /* primitive ID used to enable */
156 struct rapl_domain *domain;
157 const char *name;
160 static const char pl1_name[] = "long_term";
161 static const char pl2_name[] = "short_term";
163 struct rapl_package;
164 struct rapl_domain {
165 const char *name;
166 enum rapl_domain_type id;
167 int msrs[RAPL_DOMAIN_MSR_MAX];
168 struct powercap_zone power_zone;
169 struct rapl_domain_data rdd;
170 struct rapl_power_limit rpl[NR_POWER_LIMITS];
171 u64 attr_map; /* track capabilities */
172 unsigned int state;
173 unsigned int domain_energy_unit;
174 struct rapl_package *rp;
176 #define power_zone_to_rapl_domain(_zone) \
177 container_of(_zone, struct rapl_domain, power_zone)
180 /* Each physical package contains multiple domains, these are the common
181 * data across RAPL domains within a package.
183 struct rapl_package {
184 unsigned int id; /* physical package/socket id */
185 unsigned int nr_domains;
186 unsigned long domain_map; /* bit map of active domains */
187 unsigned int power_unit;
188 unsigned int energy_unit;
189 unsigned int time_unit;
190 struct rapl_domain *domains; /* array of domains, sized at runtime */
191 struct powercap_zone *power_zone; /* keep track of parent zone */
192 int nr_cpus; /* active cpus on the package, topology info is lost during
193 * cpu hotplug. so we have to track ourselves.
195 unsigned long power_limit_irq; /* keep track of package power limit
196 * notify interrupt enable status.
198 struct list_head plist;
199 int lead_cpu; /* one active cpu per package for access */
202 struct rapl_defaults {
203 u8 floor_freq_reg_addr;
204 int (*check_unit)(struct rapl_package *rp, int cpu);
205 void (*set_floor_freq)(struct rapl_domain *rd, bool mode);
206 u64 (*compute_time_window)(struct rapl_package *rp, u64 val,
207 bool to_raw);
208 unsigned int dram_domain_energy_unit;
210 static struct rapl_defaults *rapl_defaults;
212 /* Sideband MBI registers */
213 #define IOSF_CPU_POWER_BUDGET_CTL_BYT (0x2)
214 #define IOSF_CPU_POWER_BUDGET_CTL_TNG (0xdf)
216 #define PACKAGE_PLN_INT_SAVED BIT(0)
217 #define MAX_PRIM_NAME (32)
219 /* per domain data. used to describe individual knobs such that access function
220 * can be consolidated into one instead of many inline functions.
222 struct rapl_primitive_info {
223 const char *name;
224 u64 mask;
225 int shift;
226 enum rapl_domain_msr_id id;
227 enum unit_type unit;
228 u32 flag;
231 #define PRIMITIVE_INFO_INIT(p, m, s, i, u, f) { \
232 .name = #p, \
233 .mask = m, \
234 .shift = s, \
235 .id = i, \
236 .unit = u, \
237 .flag = f \
240 static void rapl_init_domains(struct rapl_package *rp);
241 static int rapl_read_data_raw(struct rapl_domain *rd,
242 enum rapl_primitives prim,
243 bool xlate, u64 *data);
244 static int rapl_write_data_raw(struct rapl_domain *rd,
245 enum rapl_primitives prim,
246 unsigned long long value);
247 static u64 rapl_unit_xlate(struct rapl_domain *rd,
248 enum unit_type type, u64 value,
249 int to_raw);
250 static void package_power_limit_irq_save(struct rapl_package *rp);
252 static LIST_HEAD(rapl_packages); /* guarded by CPU hotplug lock */
254 static const char * const rapl_domain_names[] = {
255 "package",
256 "core",
257 "uncore",
258 "dram",
259 "psys",
262 static struct powercap_control_type *control_type; /* PowerCap Controller */
263 static struct rapl_domain *platform_rapl_domain; /* Platform (PSys) domain */
265 /* caller to ensure CPU hotplug lock is held */
266 static struct rapl_package *find_package_by_id(int id)
268 struct rapl_package *rp;
270 list_for_each_entry(rp, &rapl_packages, plist) {
271 if (rp->id == id)
272 return rp;
275 return NULL;
278 /* caller must hold cpu hotplug lock */
279 static void rapl_cleanup_data(void)
281 struct rapl_package *p, *tmp;
283 list_for_each_entry_safe(p, tmp, &rapl_packages, plist) {
284 kfree(p->domains);
285 list_del(&p->plist);
286 kfree(p);
290 static int get_energy_counter(struct powercap_zone *power_zone, u64 *energy_raw)
292 struct rapl_domain *rd;
293 u64 energy_now;
295 /* prevent CPU hotplug, make sure the RAPL domain does not go
296 * away while reading the counter.
298 get_online_cpus();
299 rd = power_zone_to_rapl_domain(power_zone);
301 if (!rapl_read_data_raw(rd, ENERGY_COUNTER, true, &energy_now)) {
302 *energy_raw = energy_now;
303 put_online_cpus();
305 return 0;
307 put_online_cpus();
309 return -EIO;
312 static int get_max_energy_counter(struct powercap_zone *pcd_dev, u64 *energy)
314 struct rapl_domain *rd = power_zone_to_rapl_domain(pcd_dev);
316 *energy = rapl_unit_xlate(rd, ENERGY_UNIT, ENERGY_STATUS_MASK, 0);
317 return 0;
320 static int release_zone(struct powercap_zone *power_zone)
322 struct rapl_domain *rd = power_zone_to_rapl_domain(power_zone);
323 struct rapl_package *rp = rd->rp;
325 /* package zone is the last zone of a package, we can free
326 * memory here since all children has been unregistered.
328 if (rd->id == RAPL_DOMAIN_PACKAGE) {
329 kfree(rd);
330 rp->domains = NULL;
333 return 0;
337 static int find_nr_power_limit(struct rapl_domain *rd)
339 int i, nr_pl = 0;
341 for (i = 0; i < NR_POWER_LIMITS; i++) {
342 if (rd->rpl[i].name)
343 nr_pl++;
346 return nr_pl;
349 static int set_domain_enable(struct powercap_zone *power_zone, bool mode)
351 struct rapl_domain *rd = power_zone_to_rapl_domain(power_zone);
353 if (rd->state & DOMAIN_STATE_BIOS_LOCKED)
354 return -EACCES;
356 get_online_cpus();
357 rapl_write_data_raw(rd, PL1_ENABLE, mode);
358 if (rapl_defaults->set_floor_freq)
359 rapl_defaults->set_floor_freq(rd, mode);
360 put_online_cpus();
362 return 0;
365 static int get_domain_enable(struct powercap_zone *power_zone, bool *mode)
367 struct rapl_domain *rd = power_zone_to_rapl_domain(power_zone);
368 u64 val;
370 if (rd->state & DOMAIN_STATE_BIOS_LOCKED) {
371 *mode = false;
372 return 0;
374 get_online_cpus();
375 if (rapl_read_data_raw(rd, PL1_ENABLE, true, &val)) {
376 put_online_cpus();
377 return -EIO;
379 *mode = val;
380 put_online_cpus();
382 return 0;
385 /* per RAPL domain ops, in the order of rapl_domain_type */
386 static const struct powercap_zone_ops zone_ops[] = {
387 /* RAPL_DOMAIN_PACKAGE */
389 .get_energy_uj = get_energy_counter,
390 .get_max_energy_range_uj = get_max_energy_counter,
391 .release = release_zone,
392 .set_enable = set_domain_enable,
393 .get_enable = get_domain_enable,
395 /* RAPL_DOMAIN_PP0 */
397 .get_energy_uj = get_energy_counter,
398 .get_max_energy_range_uj = get_max_energy_counter,
399 .release = release_zone,
400 .set_enable = set_domain_enable,
401 .get_enable = get_domain_enable,
403 /* RAPL_DOMAIN_PP1 */
405 .get_energy_uj = get_energy_counter,
406 .get_max_energy_range_uj = get_max_energy_counter,
407 .release = release_zone,
408 .set_enable = set_domain_enable,
409 .get_enable = get_domain_enable,
411 /* RAPL_DOMAIN_DRAM */
413 .get_energy_uj = get_energy_counter,
414 .get_max_energy_range_uj = get_max_energy_counter,
415 .release = release_zone,
416 .set_enable = set_domain_enable,
417 .get_enable = get_domain_enable,
419 /* RAPL_DOMAIN_PLATFORM */
421 .get_energy_uj = get_energy_counter,
422 .get_max_energy_range_uj = get_max_energy_counter,
423 .release = release_zone,
424 .set_enable = set_domain_enable,
425 .get_enable = get_domain_enable,
431 * Constraint index used by powercap can be different than power limit (PL)
432 * index in that some PLs maybe missing due to non-existant MSRs. So we
433 * need to convert here by finding the valid PLs only (name populated).
435 static int contraint_to_pl(struct rapl_domain *rd, int cid)
437 int i, j;
439 for (i = 0, j = 0; i < NR_POWER_LIMITS; i++) {
440 if ((rd->rpl[i].name) && j++ == cid) {
441 pr_debug("%s: index %d\n", __func__, i);
442 return i;
446 return -EINVAL;
449 static int set_power_limit(struct powercap_zone *power_zone, int cid,
450 u64 power_limit)
452 struct rapl_domain *rd;
453 struct rapl_package *rp;
454 int ret = 0;
455 int id;
457 get_online_cpus();
458 rd = power_zone_to_rapl_domain(power_zone);
459 id = contraint_to_pl(rd, cid);
461 rp = rd->rp;
463 if (rd->state & DOMAIN_STATE_BIOS_LOCKED) {
464 dev_warn(&power_zone->dev, "%s locked by BIOS, monitoring only\n",
465 rd->name);
466 ret = -EACCES;
467 goto set_exit;
470 switch (rd->rpl[id].prim_id) {
471 case PL1_ENABLE:
472 rapl_write_data_raw(rd, POWER_LIMIT1, power_limit);
473 break;
474 case PL2_ENABLE:
475 rapl_write_data_raw(rd, POWER_LIMIT2, power_limit);
476 break;
477 default:
478 ret = -EINVAL;
480 if (!ret)
481 package_power_limit_irq_save(rp);
482 set_exit:
483 put_online_cpus();
484 return ret;
487 static int get_current_power_limit(struct powercap_zone *power_zone, int cid,
488 u64 *data)
490 struct rapl_domain *rd;
491 u64 val;
492 int prim;
493 int ret = 0;
494 int id;
496 get_online_cpus();
497 rd = power_zone_to_rapl_domain(power_zone);
498 id = contraint_to_pl(rd, cid);
499 switch (rd->rpl[id].prim_id) {
500 case PL1_ENABLE:
501 prim = POWER_LIMIT1;
502 break;
503 case PL2_ENABLE:
504 prim = POWER_LIMIT2;
505 break;
506 default:
507 put_online_cpus();
508 return -EINVAL;
510 if (rapl_read_data_raw(rd, prim, true, &val))
511 ret = -EIO;
512 else
513 *data = val;
515 put_online_cpus();
517 return ret;
520 static int set_time_window(struct powercap_zone *power_zone, int cid,
521 u64 window)
523 struct rapl_domain *rd;
524 int ret = 0;
525 int id;
527 get_online_cpus();
528 rd = power_zone_to_rapl_domain(power_zone);
529 id = contraint_to_pl(rd, cid);
531 switch (rd->rpl[id].prim_id) {
532 case PL1_ENABLE:
533 rapl_write_data_raw(rd, TIME_WINDOW1, window);
534 break;
535 case PL2_ENABLE:
536 rapl_write_data_raw(rd, TIME_WINDOW2, window);
537 break;
538 default:
539 ret = -EINVAL;
541 put_online_cpus();
542 return ret;
545 static int get_time_window(struct powercap_zone *power_zone, int cid, u64 *data)
547 struct rapl_domain *rd;
548 u64 val;
549 int ret = 0;
550 int id;
552 get_online_cpus();
553 rd = power_zone_to_rapl_domain(power_zone);
554 id = contraint_to_pl(rd, cid);
556 switch (rd->rpl[id].prim_id) {
557 case PL1_ENABLE:
558 ret = rapl_read_data_raw(rd, TIME_WINDOW1, true, &val);
559 break;
560 case PL2_ENABLE:
561 ret = rapl_read_data_raw(rd, TIME_WINDOW2, true, &val);
562 break;
563 default:
564 put_online_cpus();
565 return -EINVAL;
567 if (!ret)
568 *data = val;
569 put_online_cpus();
571 return ret;
574 static const char *get_constraint_name(struct powercap_zone *power_zone, int cid)
576 struct rapl_domain *rd;
577 int id;
579 rd = power_zone_to_rapl_domain(power_zone);
580 id = contraint_to_pl(rd, cid);
581 if (id >= 0)
582 return rd->rpl[id].name;
584 return NULL;
588 static int get_max_power(struct powercap_zone *power_zone, int id,
589 u64 *data)
591 struct rapl_domain *rd;
592 u64 val;
593 int prim;
594 int ret = 0;
596 get_online_cpus();
597 rd = power_zone_to_rapl_domain(power_zone);
598 switch (rd->rpl[id].prim_id) {
599 case PL1_ENABLE:
600 prim = THERMAL_SPEC_POWER;
601 break;
602 case PL2_ENABLE:
603 prim = MAX_POWER;
604 break;
605 default:
606 put_online_cpus();
607 return -EINVAL;
609 if (rapl_read_data_raw(rd, prim, true, &val))
610 ret = -EIO;
611 else
612 *data = val;
614 put_online_cpus();
616 return ret;
619 static const struct powercap_zone_constraint_ops constraint_ops = {
620 .set_power_limit_uw = set_power_limit,
621 .get_power_limit_uw = get_current_power_limit,
622 .set_time_window_us = set_time_window,
623 .get_time_window_us = get_time_window,
624 .get_max_power_uw = get_max_power,
625 .get_name = get_constraint_name,
628 /* called after domain detection and package level data are set */
629 static void rapl_init_domains(struct rapl_package *rp)
631 int i;
632 struct rapl_domain *rd = rp->domains;
634 for (i = 0; i < RAPL_DOMAIN_MAX; i++) {
635 unsigned int mask = rp->domain_map & (1 << i);
636 switch (mask) {
637 case BIT(RAPL_DOMAIN_PACKAGE):
638 rd->name = rapl_domain_names[RAPL_DOMAIN_PACKAGE];
639 rd->id = RAPL_DOMAIN_PACKAGE;
640 rd->msrs[0] = MSR_PKG_POWER_LIMIT;
641 rd->msrs[1] = MSR_PKG_ENERGY_STATUS;
642 rd->msrs[2] = MSR_PKG_PERF_STATUS;
643 rd->msrs[3] = 0;
644 rd->msrs[4] = MSR_PKG_POWER_INFO;
645 rd->rpl[0].prim_id = PL1_ENABLE;
646 rd->rpl[0].name = pl1_name;
647 rd->rpl[1].prim_id = PL2_ENABLE;
648 rd->rpl[1].name = pl2_name;
649 break;
650 case BIT(RAPL_DOMAIN_PP0):
651 rd->name = rapl_domain_names[RAPL_DOMAIN_PP0];
652 rd->id = RAPL_DOMAIN_PP0;
653 rd->msrs[0] = MSR_PP0_POWER_LIMIT;
654 rd->msrs[1] = MSR_PP0_ENERGY_STATUS;
655 rd->msrs[2] = 0;
656 rd->msrs[3] = MSR_PP0_POLICY;
657 rd->msrs[4] = 0;
658 rd->rpl[0].prim_id = PL1_ENABLE;
659 rd->rpl[0].name = pl1_name;
660 break;
661 case BIT(RAPL_DOMAIN_PP1):
662 rd->name = rapl_domain_names[RAPL_DOMAIN_PP1];
663 rd->id = RAPL_DOMAIN_PP1;
664 rd->msrs[0] = MSR_PP1_POWER_LIMIT;
665 rd->msrs[1] = MSR_PP1_ENERGY_STATUS;
666 rd->msrs[2] = 0;
667 rd->msrs[3] = MSR_PP1_POLICY;
668 rd->msrs[4] = 0;
669 rd->rpl[0].prim_id = PL1_ENABLE;
670 rd->rpl[0].name = pl1_name;
671 break;
672 case BIT(RAPL_DOMAIN_DRAM):
673 rd->name = rapl_domain_names[RAPL_DOMAIN_DRAM];
674 rd->id = RAPL_DOMAIN_DRAM;
675 rd->msrs[0] = MSR_DRAM_POWER_LIMIT;
676 rd->msrs[1] = MSR_DRAM_ENERGY_STATUS;
677 rd->msrs[2] = MSR_DRAM_PERF_STATUS;
678 rd->msrs[3] = 0;
679 rd->msrs[4] = MSR_DRAM_POWER_INFO;
680 rd->rpl[0].prim_id = PL1_ENABLE;
681 rd->rpl[0].name = pl1_name;
682 rd->domain_energy_unit =
683 rapl_defaults->dram_domain_energy_unit;
684 if (rd->domain_energy_unit)
685 pr_info("DRAM domain energy unit %dpj\n",
686 rd->domain_energy_unit);
687 break;
689 if (mask) {
690 rd->rp = rp;
691 rd++;
696 static u64 rapl_unit_xlate(struct rapl_domain *rd, enum unit_type type,
697 u64 value, int to_raw)
699 u64 units = 1;
700 struct rapl_package *rp = rd->rp;
701 u64 scale = 1;
703 switch (type) {
704 case POWER_UNIT:
705 units = rp->power_unit;
706 break;
707 case ENERGY_UNIT:
708 scale = ENERGY_UNIT_SCALE;
709 /* per domain unit takes precedence */
710 if (rd && rd->domain_energy_unit)
711 units = rd->domain_energy_unit;
712 else
713 units = rp->energy_unit;
714 break;
715 case TIME_UNIT:
716 return rapl_defaults->compute_time_window(rp, value, to_raw);
717 case ARBITRARY_UNIT:
718 default:
719 return value;
722 if (to_raw)
723 return div64_u64(value, units) * scale;
725 value *= units;
727 return div64_u64(value, scale);
730 /* in the order of enum rapl_primitives */
731 static struct rapl_primitive_info rpi[] = {
732 /* name, mask, shift, msr index, unit divisor */
733 PRIMITIVE_INFO_INIT(ENERGY_COUNTER, ENERGY_STATUS_MASK, 0,
734 RAPL_DOMAIN_MSR_STATUS, ENERGY_UNIT, 0),
735 PRIMITIVE_INFO_INIT(POWER_LIMIT1, POWER_LIMIT1_MASK, 0,
736 RAPL_DOMAIN_MSR_LIMIT, POWER_UNIT, 0),
737 PRIMITIVE_INFO_INIT(POWER_LIMIT2, POWER_LIMIT2_MASK, 32,
738 RAPL_DOMAIN_MSR_LIMIT, POWER_UNIT, 0),
739 PRIMITIVE_INFO_INIT(FW_LOCK, POWER_PP_LOCK, 31,
740 RAPL_DOMAIN_MSR_LIMIT, ARBITRARY_UNIT, 0),
741 PRIMITIVE_INFO_INIT(PL1_ENABLE, POWER_LIMIT1_ENABLE, 15,
742 RAPL_DOMAIN_MSR_LIMIT, ARBITRARY_UNIT, 0),
743 PRIMITIVE_INFO_INIT(PL1_CLAMP, POWER_LIMIT1_CLAMP, 16,
744 RAPL_DOMAIN_MSR_LIMIT, ARBITRARY_UNIT, 0),
745 PRIMITIVE_INFO_INIT(PL2_ENABLE, POWER_LIMIT2_ENABLE, 47,
746 RAPL_DOMAIN_MSR_LIMIT, ARBITRARY_UNIT, 0),
747 PRIMITIVE_INFO_INIT(PL2_CLAMP, POWER_LIMIT2_CLAMP, 48,
748 RAPL_DOMAIN_MSR_LIMIT, ARBITRARY_UNIT, 0),
749 PRIMITIVE_INFO_INIT(TIME_WINDOW1, TIME_WINDOW1_MASK, 17,
750 RAPL_DOMAIN_MSR_LIMIT, TIME_UNIT, 0),
751 PRIMITIVE_INFO_INIT(TIME_WINDOW2, TIME_WINDOW2_MASK, 49,
752 RAPL_DOMAIN_MSR_LIMIT, TIME_UNIT, 0),
753 PRIMITIVE_INFO_INIT(THERMAL_SPEC_POWER, POWER_INFO_THERMAL_SPEC_MASK,
754 0, RAPL_DOMAIN_MSR_INFO, POWER_UNIT, 0),
755 PRIMITIVE_INFO_INIT(MAX_POWER, POWER_INFO_MAX_MASK, 32,
756 RAPL_DOMAIN_MSR_INFO, POWER_UNIT, 0),
757 PRIMITIVE_INFO_INIT(MIN_POWER, POWER_INFO_MIN_MASK, 16,
758 RAPL_DOMAIN_MSR_INFO, POWER_UNIT, 0),
759 PRIMITIVE_INFO_INIT(MAX_TIME_WINDOW, POWER_INFO_MAX_TIME_WIN_MASK, 48,
760 RAPL_DOMAIN_MSR_INFO, TIME_UNIT, 0),
761 PRIMITIVE_INFO_INIT(THROTTLED_TIME, PERF_STATUS_THROTTLE_TIME_MASK, 0,
762 RAPL_DOMAIN_MSR_PERF, TIME_UNIT, 0),
763 PRIMITIVE_INFO_INIT(PRIORITY_LEVEL, PP_POLICY_MASK, 0,
764 RAPL_DOMAIN_MSR_POLICY, ARBITRARY_UNIT, 0),
765 /* non-hardware */
766 PRIMITIVE_INFO_INIT(AVERAGE_POWER, 0, 0, 0, POWER_UNIT,
767 RAPL_PRIMITIVE_DERIVED),
768 {NULL, 0, 0, 0},
771 /* Read primitive data based on its related struct rapl_primitive_info.
772 * if xlate flag is set, return translated data based on data units, i.e.
773 * time, energy, and power.
774 * RAPL MSRs are non-architectual and are laid out not consistently across
775 * domains. Here we use primitive info to allow writing consolidated access
776 * functions.
777 * For a given primitive, it is processed by MSR mask and shift. Unit conversion
778 * is pre-assigned based on RAPL unit MSRs read at init time.
779 * 63-------------------------- 31--------------------------- 0
780 * | xxxxx (mask) |
781 * | |<- shift ----------------|
782 * 63-------------------------- 31--------------------------- 0
784 static int rapl_read_data_raw(struct rapl_domain *rd,
785 enum rapl_primitives prim,
786 bool xlate, u64 *data)
788 u64 value, final;
789 u32 msr;
790 struct rapl_primitive_info *rp = &rpi[prim];
791 int cpu;
793 if (!rp->name || rp->flag & RAPL_PRIMITIVE_DUMMY)
794 return -EINVAL;
796 msr = rd->msrs[rp->id];
797 if (!msr)
798 return -EINVAL;
800 cpu = rd->rp->lead_cpu;
802 /* special-case package domain, which uses a different bit*/
803 if (prim == FW_LOCK && rd->id == RAPL_DOMAIN_PACKAGE) {
804 rp->mask = POWER_PACKAGE_LOCK;
805 rp->shift = 63;
807 /* non-hardware data are collected by the polling thread */
808 if (rp->flag & RAPL_PRIMITIVE_DERIVED) {
809 *data = rd->rdd.primitives[prim];
810 return 0;
813 if (rdmsrl_safe_on_cpu(cpu, msr, &value)) {
814 pr_debug("failed to read msr 0x%x on cpu %d\n", msr, cpu);
815 return -EIO;
818 final = value & rp->mask;
819 final = final >> rp->shift;
820 if (xlate)
821 *data = rapl_unit_xlate(rd, rp->unit, final, 0);
822 else
823 *data = final;
825 return 0;
829 static int msrl_update_safe(u32 msr_no, u64 clear_mask, u64 set_mask)
831 int err;
832 u64 val;
834 err = rdmsrl_safe(msr_no, &val);
835 if (err)
836 goto out;
838 val &= ~clear_mask;
839 val |= set_mask;
841 err = wrmsrl_safe(msr_no, val);
843 out:
844 return err;
847 static void msrl_update_func(void *info)
849 struct msrl_action *ma = info;
851 ma->err = msrl_update_safe(ma->msr_no, ma->clear_mask, ma->set_mask);
854 /* Similar use of primitive info in the read counterpart */
855 static int rapl_write_data_raw(struct rapl_domain *rd,
856 enum rapl_primitives prim,
857 unsigned long long value)
859 struct rapl_primitive_info *rp = &rpi[prim];
860 int cpu;
861 u64 bits;
862 struct msrl_action ma;
863 int ret;
865 cpu = rd->rp->lead_cpu;
866 bits = rapl_unit_xlate(rd, rp->unit, value, 1);
867 bits |= bits << rp->shift;
868 memset(&ma, 0, sizeof(ma));
870 ma.msr_no = rd->msrs[rp->id];
871 ma.clear_mask = rp->mask;
872 ma.set_mask = bits;
874 ret = smp_call_function_single(cpu, msrl_update_func, &ma, 1);
875 if (ret)
876 WARN_ON_ONCE(ret);
877 else
878 ret = ma.err;
880 return ret;
884 * Raw RAPL data stored in MSRs are in certain scales. We need to
885 * convert them into standard units based on the units reported in
886 * the RAPL unit MSRs. This is specific to CPUs as the method to
887 * calculate units differ on different CPUs.
888 * We convert the units to below format based on CPUs.
889 * i.e.
890 * energy unit: picoJoules : Represented in picoJoules by default
891 * power unit : microWatts : Represented in milliWatts by default
892 * time unit : microseconds: Represented in seconds by default
894 static int rapl_check_unit_core(struct rapl_package *rp, int cpu)
896 u64 msr_val;
897 u32 value;
899 if (rdmsrl_safe_on_cpu(cpu, MSR_RAPL_POWER_UNIT, &msr_val)) {
900 pr_err("Failed to read power unit MSR 0x%x on CPU %d, exit.\n",
901 MSR_RAPL_POWER_UNIT, cpu);
902 return -ENODEV;
905 value = (msr_val & ENERGY_UNIT_MASK) >> ENERGY_UNIT_OFFSET;
906 rp->energy_unit = ENERGY_UNIT_SCALE * 1000000 / (1 << value);
908 value = (msr_val & POWER_UNIT_MASK) >> POWER_UNIT_OFFSET;
909 rp->power_unit = 1000000 / (1 << value);
911 value = (msr_val & TIME_UNIT_MASK) >> TIME_UNIT_OFFSET;
912 rp->time_unit = 1000000 / (1 << value);
914 pr_debug("Core CPU package %d energy=%dpJ, time=%dus, power=%duW\n",
915 rp->id, rp->energy_unit, rp->time_unit, rp->power_unit);
917 return 0;
920 static int rapl_check_unit_atom(struct rapl_package *rp, int cpu)
922 u64 msr_val;
923 u32 value;
925 if (rdmsrl_safe_on_cpu(cpu, MSR_RAPL_POWER_UNIT, &msr_val)) {
926 pr_err("Failed to read power unit MSR 0x%x on CPU %d, exit.\n",
927 MSR_RAPL_POWER_UNIT, cpu);
928 return -ENODEV;
930 value = (msr_val & ENERGY_UNIT_MASK) >> ENERGY_UNIT_OFFSET;
931 rp->energy_unit = ENERGY_UNIT_SCALE * 1 << value;
933 value = (msr_val & POWER_UNIT_MASK) >> POWER_UNIT_OFFSET;
934 rp->power_unit = (1 << value) * 1000;
936 value = (msr_val & TIME_UNIT_MASK) >> TIME_UNIT_OFFSET;
937 rp->time_unit = 1000000 / (1 << value);
939 pr_debug("Atom package %d energy=%dpJ, time=%dus, power=%duW\n",
940 rp->id, rp->energy_unit, rp->time_unit, rp->power_unit);
942 return 0;
945 static void power_limit_irq_save_cpu(void *info)
947 u32 l, h = 0;
948 struct rapl_package *rp = (struct rapl_package *)info;
950 /* save the state of PLN irq mask bit before disabling it */
951 rdmsr_safe(MSR_IA32_PACKAGE_THERM_INTERRUPT, &l, &h);
952 if (!(rp->power_limit_irq & PACKAGE_PLN_INT_SAVED)) {
953 rp->power_limit_irq = l & PACKAGE_THERM_INT_PLN_ENABLE;
954 rp->power_limit_irq |= PACKAGE_PLN_INT_SAVED;
956 l &= ~PACKAGE_THERM_INT_PLN_ENABLE;
957 wrmsr_safe(MSR_IA32_PACKAGE_THERM_INTERRUPT, l, h);
961 /* REVISIT:
962 * When package power limit is set artificially low by RAPL, LVT
963 * thermal interrupt for package power limit should be ignored
964 * since we are not really exceeding the real limit. The intention
965 * is to avoid excessive interrupts while we are trying to save power.
966 * A useful feature might be routing the package_power_limit interrupt
967 * to userspace via eventfd. once we have a usecase, this is simple
968 * to do by adding an atomic notifier.
971 static void package_power_limit_irq_save(struct rapl_package *rp)
973 if (!boot_cpu_has(X86_FEATURE_PTS) || !boot_cpu_has(X86_FEATURE_PLN))
974 return;
976 smp_call_function_single(rp->lead_cpu, power_limit_irq_save_cpu, rp, 1);
979 static void power_limit_irq_restore_cpu(void *info)
981 u32 l, h = 0;
982 struct rapl_package *rp = (struct rapl_package *)info;
984 rdmsr_safe(MSR_IA32_PACKAGE_THERM_INTERRUPT, &l, &h);
986 if (rp->power_limit_irq & PACKAGE_THERM_INT_PLN_ENABLE)
987 l |= PACKAGE_THERM_INT_PLN_ENABLE;
988 else
989 l &= ~PACKAGE_THERM_INT_PLN_ENABLE;
991 wrmsr_safe(MSR_IA32_PACKAGE_THERM_INTERRUPT, l, h);
994 /* restore per package power limit interrupt enable state */
995 static void package_power_limit_irq_restore(struct rapl_package *rp)
997 if (!boot_cpu_has(X86_FEATURE_PTS) || !boot_cpu_has(X86_FEATURE_PLN))
998 return;
1000 /* irq enable state not saved, nothing to restore */
1001 if (!(rp->power_limit_irq & PACKAGE_PLN_INT_SAVED))
1002 return;
1004 smp_call_function_single(rp->lead_cpu, power_limit_irq_restore_cpu, rp, 1);
1007 static void set_floor_freq_default(struct rapl_domain *rd, bool mode)
1009 int nr_powerlimit = find_nr_power_limit(rd);
1011 /* always enable clamp such that p-state can go below OS requested
1012 * range. power capping priority over guranteed frequency.
1014 rapl_write_data_raw(rd, PL1_CLAMP, mode);
1016 /* some domains have pl2 */
1017 if (nr_powerlimit > 1) {
1018 rapl_write_data_raw(rd, PL2_ENABLE, mode);
1019 rapl_write_data_raw(rd, PL2_CLAMP, mode);
1023 static void set_floor_freq_atom(struct rapl_domain *rd, bool enable)
1025 static u32 power_ctrl_orig_val;
1026 u32 mdata;
1028 if (!rapl_defaults->floor_freq_reg_addr) {
1029 pr_err("Invalid floor frequency config register\n");
1030 return;
1033 if (!power_ctrl_orig_val)
1034 iosf_mbi_read(BT_MBI_UNIT_PMC, MBI_CR_READ,
1035 rapl_defaults->floor_freq_reg_addr,
1036 &power_ctrl_orig_val);
1037 mdata = power_ctrl_orig_val;
1038 if (enable) {
1039 mdata &= ~(0x7f << 8);
1040 mdata |= 1 << 8;
1042 iosf_mbi_write(BT_MBI_UNIT_PMC, MBI_CR_WRITE,
1043 rapl_defaults->floor_freq_reg_addr, mdata);
1046 static u64 rapl_compute_time_window_core(struct rapl_package *rp, u64 value,
1047 bool to_raw)
1049 u64 f, y; /* fraction and exp. used for time unit */
1052 * Special processing based on 2^Y*(1+F/4), refer
1053 * to Intel Software Developer's manual Vol.3B: CH 14.9.3.
1055 if (!to_raw) {
1056 f = (value & 0x60) >> 5;
1057 y = value & 0x1f;
1058 value = (1 << y) * (4 + f) * rp->time_unit / 4;
1059 } else {
1060 do_div(value, rp->time_unit);
1061 y = ilog2(value);
1062 f = div64_u64(4 * (value - (1 << y)), 1 << y);
1063 value = (y & 0x1f) | ((f & 0x3) << 5);
1065 return value;
1068 static u64 rapl_compute_time_window_atom(struct rapl_package *rp, u64 value,
1069 bool to_raw)
1072 * Atom time unit encoding is straight forward val * time_unit,
1073 * where time_unit is default to 1 sec. Never 0.
1075 if (!to_raw)
1076 return (value) ? value *= rp->time_unit : rp->time_unit;
1077 else
1078 value = div64_u64(value, rp->time_unit);
1080 return value;
1083 static const struct rapl_defaults rapl_defaults_core = {
1084 .floor_freq_reg_addr = 0,
1085 .check_unit = rapl_check_unit_core,
1086 .set_floor_freq = set_floor_freq_default,
1087 .compute_time_window = rapl_compute_time_window_core,
1090 static const struct rapl_defaults rapl_defaults_hsw_server = {
1091 .check_unit = rapl_check_unit_core,
1092 .set_floor_freq = set_floor_freq_default,
1093 .compute_time_window = rapl_compute_time_window_core,
1094 .dram_domain_energy_unit = 15300,
1097 static const struct rapl_defaults rapl_defaults_byt = {
1098 .floor_freq_reg_addr = IOSF_CPU_POWER_BUDGET_CTL_BYT,
1099 .check_unit = rapl_check_unit_atom,
1100 .set_floor_freq = set_floor_freq_atom,
1101 .compute_time_window = rapl_compute_time_window_atom,
1104 static const struct rapl_defaults rapl_defaults_tng = {
1105 .floor_freq_reg_addr = IOSF_CPU_POWER_BUDGET_CTL_TNG,
1106 .check_unit = rapl_check_unit_atom,
1107 .set_floor_freq = set_floor_freq_atom,
1108 .compute_time_window = rapl_compute_time_window_atom,
1111 static const struct rapl_defaults rapl_defaults_ann = {
1112 .floor_freq_reg_addr = 0,
1113 .check_unit = rapl_check_unit_atom,
1114 .set_floor_freq = NULL,
1115 .compute_time_window = rapl_compute_time_window_atom,
1118 static const struct rapl_defaults rapl_defaults_cht = {
1119 .floor_freq_reg_addr = 0,
1120 .check_unit = rapl_check_unit_atom,
1121 .set_floor_freq = NULL,
1122 .compute_time_window = rapl_compute_time_window_atom,
1125 #define RAPL_CPU(_model, _ops) { \
1126 .vendor = X86_VENDOR_INTEL, \
1127 .family = 6, \
1128 .model = _model, \
1129 .driver_data = (kernel_ulong_t)&_ops, \
1132 static const struct x86_cpu_id rapl_ids[] __initconst = {
1133 RAPL_CPU(INTEL_FAM6_SANDYBRIDGE, rapl_defaults_core),
1134 RAPL_CPU(INTEL_FAM6_SANDYBRIDGE_X, rapl_defaults_core),
1136 RAPL_CPU(INTEL_FAM6_IVYBRIDGE, rapl_defaults_core),
1137 RAPL_CPU(INTEL_FAM6_IVYBRIDGE_X, rapl_defaults_core),
1139 RAPL_CPU(INTEL_FAM6_HASWELL_CORE, rapl_defaults_core),
1140 RAPL_CPU(INTEL_FAM6_HASWELL_ULT, rapl_defaults_core),
1141 RAPL_CPU(INTEL_FAM6_HASWELL_GT3E, rapl_defaults_core),
1142 RAPL_CPU(INTEL_FAM6_HASWELL_X, rapl_defaults_hsw_server),
1144 RAPL_CPU(INTEL_FAM6_BROADWELL_CORE, rapl_defaults_core),
1145 RAPL_CPU(INTEL_FAM6_BROADWELL_GT3E, rapl_defaults_core),
1146 RAPL_CPU(INTEL_FAM6_BROADWELL_XEON_D, rapl_defaults_core),
1147 RAPL_CPU(INTEL_FAM6_BROADWELL_X, rapl_defaults_hsw_server),
1149 RAPL_CPU(INTEL_FAM6_SKYLAKE_DESKTOP, rapl_defaults_core),
1150 RAPL_CPU(INTEL_FAM6_SKYLAKE_MOBILE, rapl_defaults_core),
1151 RAPL_CPU(INTEL_FAM6_SKYLAKE_X, rapl_defaults_hsw_server),
1152 RAPL_CPU(INTEL_FAM6_KABYLAKE_MOBILE, rapl_defaults_core),
1153 RAPL_CPU(INTEL_FAM6_KABYLAKE_DESKTOP, rapl_defaults_core),
1155 RAPL_CPU(INTEL_FAM6_ATOM_SILVERMONT1, rapl_defaults_byt),
1156 RAPL_CPU(INTEL_FAM6_ATOM_AIRMONT, rapl_defaults_cht),
1157 RAPL_CPU(INTEL_FAM6_ATOM_MERRIFIELD, rapl_defaults_tng),
1158 RAPL_CPU(INTEL_FAM6_ATOM_MOOREFIELD, rapl_defaults_ann),
1159 RAPL_CPU(INTEL_FAM6_ATOM_GOLDMONT, rapl_defaults_core),
1160 RAPL_CPU(INTEL_FAM6_ATOM_DENVERTON, rapl_defaults_core),
1162 RAPL_CPU(INTEL_FAM6_XEON_PHI_KNL, rapl_defaults_hsw_server),
1165 MODULE_DEVICE_TABLE(x86cpu, rapl_ids);
1167 /* Read once for all raw primitive data for domains */
1168 static void rapl_update_domain_data(struct rapl_package *rp)
1170 int dmn, prim;
1171 u64 val;
1173 for (dmn = 0; dmn < rp->nr_domains; dmn++) {
1174 pr_debug("update package %d domain %s data\n", rp->id,
1175 rp->domains[dmn].name);
1176 /* exclude non-raw primitives */
1177 for (prim = 0; prim < NR_RAW_PRIMITIVES; prim++) {
1178 if (!rapl_read_data_raw(&rp->domains[dmn], prim,
1179 rpi[prim].unit, &val))
1180 rp->domains[dmn].rdd.primitives[prim] = val;
1186 static int rapl_unregister_powercap(void)
1188 struct rapl_package *rp;
1189 struct rapl_domain *rd, *rd_package = NULL;
1191 /* unregister all active rapl packages from the powercap layer,
1192 * hotplug lock held
1194 list_for_each_entry(rp, &rapl_packages, plist) {
1195 package_power_limit_irq_restore(rp);
1197 for (rd = rp->domains; rd < rp->domains + rp->nr_domains;
1198 rd++) {
1199 pr_debug("remove package, undo power limit on %d: %s\n",
1200 rp->id, rd->name);
1201 rapl_write_data_raw(rd, PL1_ENABLE, 0);
1202 rapl_write_data_raw(rd, PL1_CLAMP, 0);
1203 if (find_nr_power_limit(rd) > 1) {
1204 rapl_write_data_raw(rd, PL2_ENABLE, 0);
1205 rapl_write_data_raw(rd, PL2_CLAMP, 0);
1207 if (rd->id == RAPL_DOMAIN_PACKAGE) {
1208 rd_package = rd;
1209 continue;
1211 powercap_unregister_zone(control_type, &rd->power_zone);
1213 /* do the package zone last */
1214 if (rd_package)
1215 powercap_unregister_zone(control_type,
1216 &rd_package->power_zone);
1219 if (platform_rapl_domain) {
1220 powercap_unregister_zone(control_type,
1221 &platform_rapl_domain->power_zone);
1222 kfree(platform_rapl_domain);
1225 powercap_unregister_control_type(control_type);
1227 return 0;
1230 static int rapl_package_register_powercap(struct rapl_package *rp)
1232 struct rapl_domain *rd;
1233 char dev_name[17]; /* max domain name = 7 + 1 + 8 for int + 1 for null*/
1234 struct powercap_zone *power_zone = NULL;
1235 int nr_pl, ret;;
1237 /* Update the domain data of the new package */
1238 rapl_update_domain_data(rp);
1240 /* first we register package domain as the parent zone*/
1241 for (rd = rp->domains; rd < rp->domains + rp->nr_domains; rd++) {
1242 if (rd->id == RAPL_DOMAIN_PACKAGE) {
1243 nr_pl = find_nr_power_limit(rd);
1244 pr_debug("register socket %d package domain %s\n",
1245 rp->id, rd->name);
1246 memset(dev_name, 0, sizeof(dev_name));
1247 snprintf(dev_name, sizeof(dev_name), "%s-%d",
1248 rd->name, rp->id);
1249 power_zone = powercap_register_zone(&rd->power_zone,
1250 control_type,
1251 dev_name, NULL,
1252 &zone_ops[rd->id],
1253 nr_pl,
1254 &constraint_ops);
1255 if (IS_ERR(power_zone)) {
1256 pr_debug("failed to register package, %d\n",
1257 rp->id);
1258 return PTR_ERR(power_zone);
1260 /* track parent zone in per package/socket data */
1261 rp->power_zone = power_zone;
1262 /* done, only one package domain per socket */
1263 break;
1266 if (!power_zone) {
1267 pr_err("no package domain found, unknown topology!\n");
1268 return -ENODEV;
1270 /* now register domains as children of the socket/package*/
1271 for (rd = rp->domains; rd < rp->domains + rp->nr_domains; rd++) {
1272 if (rd->id == RAPL_DOMAIN_PACKAGE)
1273 continue;
1274 /* number of power limits per domain varies */
1275 nr_pl = find_nr_power_limit(rd);
1276 power_zone = powercap_register_zone(&rd->power_zone,
1277 control_type, rd->name,
1278 rp->power_zone,
1279 &zone_ops[rd->id], nr_pl,
1280 &constraint_ops);
1282 if (IS_ERR(power_zone)) {
1283 pr_debug("failed to register power_zone, %d:%s:%s\n",
1284 rp->id, rd->name, dev_name);
1285 ret = PTR_ERR(power_zone);
1286 goto err_cleanup;
1289 return 0;
1291 err_cleanup:
1292 /* clean up previously initialized domains within the package if we
1293 * failed after the first domain setup.
1295 while (--rd >= rp->domains) {
1296 pr_debug("unregister package %d domain %s\n", rp->id, rd->name);
1297 powercap_unregister_zone(control_type, &rd->power_zone);
1300 return ret;
1303 static int rapl_register_psys(void)
1305 struct rapl_domain *rd;
1306 struct powercap_zone *power_zone;
1307 u64 val;
1309 if (rdmsrl_safe_on_cpu(0, MSR_PLATFORM_ENERGY_STATUS, &val) || !val)
1310 return -ENODEV;
1312 if (rdmsrl_safe_on_cpu(0, MSR_PLATFORM_POWER_LIMIT, &val) || !val)
1313 return -ENODEV;
1315 rd = kzalloc(sizeof(*rd), GFP_KERNEL);
1316 if (!rd)
1317 return -ENOMEM;
1319 rd->name = rapl_domain_names[RAPL_DOMAIN_PLATFORM];
1320 rd->id = RAPL_DOMAIN_PLATFORM;
1321 rd->msrs[0] = MSR_PLATFORM_POWER_LIMIT;
1322 rd->msrs[1] = MSR_PLATFORM_ENERGY_STATUS;
1323 rd->rpl[0].prim_id = PL1_ENABLE;
1324 rd->rpl[0].name = pl1_name;
1325 rd->rpl[1].prim_id = PL2_ENABLE;
1326 rd->rpl[1].name = pl2_name;
1327 rd->rp = find_package_by_id(0);
1329 power_zone = powercap_register_zone(&rd->power_zone, control_type,
1330 "psys", NULL,
1331 &zone_ops[RAPL_DOMAIN_PLATFORM],
1332 2, &constraint_ops);
1334 if (IS_ERR(power_zone)) {
1335 kfree(rd);
1336 return PTR_ERR(power_zone);
1339 platform_rapl_domain = rd;
1341 return 0;
1344 static int rapl_register_powercap(void)
1346 struct rapl_domain *rd;
1347 struct rapl_package *rp;
1348 int ret = 0;
1350 control_type = powercap_register_control_type(NULL, "intel-rapl", NULL);
1351 if (IS_ERR(control_type)) {
1352 pr_debug("failed to register powercap control_type.\n");
1353 return PTR_ERR(control_type);
1356 list_for_each_entry(rp, &rapl_packages, plist)
1357 if (rapl_package_register_powercap(rp))
1358 goto err_cleanup_package;
1360 /* Don't bail out if PSys is not supported */
1361 rapl_register_psys();
1363 return ret;
1365 err_cleanup_package:
1366 /* clean up previously initialized packages */
1367 list_for_each_entry_continue_reverse(rp, &rapl_packages, plist) {
1368 for (rd = rp->domains; rd < rp->domains + rp->nr_domains;
1369 rd++) {
1370 pr_debug("unregister zone/package %d, %s domain\n",
1371 rp->id, rd->name);
1372 powercap_unregister_zone(control_type, &rd->power_zone);
1376 return ret;
1379 static int rapl_check_domain(int cpu, int domain)
1381 unsigned msr;
1382 u64 val = 0;
1384 switch (domain) {
1385 case RAPL_DOMAIN_PACKAGE:
1386 msr = MSR_PKG_ENERGY_STATUS;
1387 break;
1388 case RAPL_DOMAIN_PP0:
1389 msr = MSR_PP0_ENERGY_STATUS;
1390 break;
1391 case RAPL_DOMAIN_PP1:
1392 msr = MSR_PP1_ENERGY_STATUS;
1393 break;
1394 case RAPL_DOMAIN_DRAM:
1395 msr = MSR_DRAM_ENERGY_STATUS;
1396 break;
1397 case RAPL_DOMAIN_PLATFORM:
1398 /* PSYS(PLATFORM) is not a CPU domain, so avoid printng error */
1399 return -EINVAL;
1400 default:
1401 pr_err("invalid domain id %d\n", domain);
1402 return -EINVAL;
1404 /* make sure domain counters are available and contains non-zero
1405 * values, otherwise skip it.
1407 if (rdmsrl_safe_on_cpu(cpu, msr, &val) || !val)
1408 return -ENODEV;
1410 return 0;
1415 * Check if power limits are available. Two cases when they are not available:
1416 * 1. Locked by BIOS, in this case we still provide read-only access so that
1417 * users can see what limit is set by the BIOS.
1418 * 2. Some CPUs make some domains monitoring only which means PLx MSRs may not
1419 * exist at all. In this case, we do not show the contraints in powercap.
1421 * Called after domains are detected and initialized.
1423 static void rapl_detect_powerlimit(struct rapl_domain *rd)
1425 u64 val64;
1426 int i;
1428 /* check if the domain is locked by BIOS, ignore if MSR doesn't exist */
1429 if (!rapl_read_data_raw(rd, FW_LOCK, false, &val64)) {
1430 if (val64) {
1431 pr_info("RAPL package %d domain %s locked by BIOS\n",
1432 rd->rp->id, rd->name);
1433 rd->state |= DOMAIN_STATE_BIOS_LOCKED;
1436 /* check if power limit MSRs exists, otherwise domain is monitoring only */
1437 for (i = 0; i < NR_POWER_LIMITS; i++) {
1438 int prim = rd->rpl[i].prim_id;
1439 if (rapl_read_data_raw(rd, prim, false, &val64))
1440 rd->rpl[i].name = NULL;
1444 /* Detect active and valid domains for the given CPU, caller must
1445 * ensure the CPU belongs to the targeted package and CPU hotlug is disabled.
1447 static int rapl_detect_domains(struct rapl_package *rp, int cpu)
1449 int i;
1450 int ret = 0;
1451 struct rapl_domain *rd;
1453 for (i = 0; i < RAPL_DOMAIN_MAX; i++) {
1454 /* use physical package id to read counters */
1455 if (!rapl_check_domain(cpu, i)) {
1456 rp->domain_map |= 1 << i;
1457 pr_info("Found RAPL domain %s\n", rapl_domain_names[i]);
1460 rp->nr_domains = bitmap_weight(&rp->domain_map, RAPL_DOMAIN_MAX);
1461 if (!rp->nr_domains) {
1462 pr_debug("no valid rapl domains found in package %d\n", rp->id);
1463 ret = -ENODEV;
1464 goto done;
1466 pr_debug("found %d domains on package %d\n", rp->nr_domains, rp->id);
1468 rp->domains = kcalloc(rp->nr_domains + 1, sizeof(struct rapl_domain),
1469 GFP_KERNEL);
1470 if (!rp->domains) {
1471 ret = -ENOMEM;
1472 goto done;
1474 rapl_init_domains(rp);
1476 for (rd = rp->domains; rd < rp->domains + rp->nr_domains; rd++)
1477 rapl_detect_powerlimit(rd);
1481 done:
1482 return ret;
1485 static bool is_package_new(int package)
1487 struct rapl_package *rp;
1489 /* caller prevents cpu hotplug, there will be no new packages added
1490 * or deleted while traversing the package list, no need for locking.
1492 list_for_each_entry(rp, &rapl_packages, plist)
1493 if (package == rp->id)
1494 return false;
1496 return true;
1499 /* RAPL interface can be made of a two-level hierarchy: package level and domain
1500 * level. We first detect the number of packages then domains of each package.
1501 * We have to consider the possiblity of CPU online/offline due to hotplug and
1502 * other scenarios.
1504 static int rapl_detect_topology(void)
1506 int i;
1507 int phy_package_id;
1508 struct rapl_package *new_package, *rp;
1510 for_each_online_cpu(i) {
1511 phy_package_id = topology_physical_package_id(i);
1512 if (is_package_new(phy_package_id)) {
1513 new_package = kzalloc(sizeof(*rp), GFP_KERNEL);
1514 if (!new_package) {
1515 rapl_cleanup_data();
1516 return -ENOMEM;
1518 /* add the new package to the list */
1519 new_package->id = phy_package_id;
1520 new_package->nr_cpus = 1;
1521 /* use the first active cpu of the package to access */
1522 new_package->lead_cpu = i;
1523 /* check if the package contains valid domains */
1524 if (rapl_detect_domains(new_package, i) ||
1525 rapl_defaults->check_unit(new_package, i)) {
1526 kfree(new_package->domains);
1527 kfree(new_package);
1528 /* free up the packages already initialized */
1529 rapl_cleanup_data();
1530 return -ENODEV;
1532 INIT_LIST_HEAD(&new_package->plist);
1533 list_add(&new_package->plist, &rapl_packages);
1534 } else {
1535 rp = find_package_by_id(phy_package_id);
1536 if (rp)
1537 ++rp->nr_cpus;
1541 return 0;
1544 /* called from CPU hotplug notifier, hotplug lock held */
1545 static void rapl_remove_package(struct rapl_package *rp)
1547 struct rapl_domain *rd, *rd_package = NULL;
1549 for (rd = rp->domains; rd < rp->domains + rp->nr_domains; rd++) {
1550 if (rd->id == RAPL_DOMAIN_PACKAGE) {
1551 rd_package = rd;
1552 continue;
1554 pr_debug("remove package %d, %s domain\n", rp->id, rd->name);
1555 powercap_unregister_zone(control_type, &rd->power_zone);
1557 /* do parent zone last */
1558 powercap_unregister_zone(control_type, &rd_package->power_zone);
1559 list_del(&rp->plist);
1560 kfree(rp);
1563 /* called from CPU hotplug notifier, hotplug lock held */
1564 static int rapl_add_package(int cpu)
1566 int ret = 0;
1567 int phy_package_id;
1568 struct rapl_package *rp;
1570 phy_package_id = topology_physical_package_id(cpu);
1571 rp = kzalloc(sizeof(struct rapl_package), GFP_KERNEL);
1572 if (!rp)
1573 return -ENOMEM;
1575 /* add the new package to the list */
1576 rp->id = phy_package_id;
1577 rp->nr_cpus = 1;
1578 rp->lead_cpu = cpu;
1580 /* check if the package contains valid domains */
1581 if (rapl_detect_domains(rp, cpu) ||
1582 rapl_defaults->check_unit(rp, cpu)) {
1583 ret = -ENODEV;
1584 goto err_free_package;
1586 if (!rapl_package_register_powercap(rp)) {
1587 INIT_LIST_HEAD(&rp->plist);
1588 list_add(&rp->plist, &rapl_packages);
1589 return ret;
1592 err_free_package:
1593 kfree(rp->domains);
1594 kfree(rp);
1596 return ret;
1599 /* Handles CPU hotplug on multi-socket systems.
1600 * If a CPU goes online as the first CPU of the physical package
1601 * we add the RAPL package to the system. Similarly, when the last
1602 * CPU of the package is removed, we remove the RAPL package and its
1603 * associated domains. Cooling devices are handled accordingly at
1604 * per-domain level.
1606 static int rapl_cpu_callback(struct notifier_block *nfb,
1607 unsigned long action, void *hcpu)
1609 unsigned long cpu = (unsigned long)hcpu;
1610 int phy_package_id;
1611 struct rapl_package *rp;
1612 int lead_cpu;
1614 phy_package_id = topology_physical_package_id(cpu);
1615 switch (action) {
1616 case CPU_ONLINE:
1617 case CPU_ONLINE_FROZEN:
1618 case CPU_DOWN_FAILED:
1619 case CPU_DOWN_FAILED_FROZEN:
1620 rp = find_package_by_id(phy_package_id);
1621 if (rp)
1622 ++rp->nr_cpus;
1623 else
1624 rapl_add_package(cpu);
1625 break;
1626 case CPU_DOWN_PREPARE:
1627 case CPU_DOWN_PREPARE_FROZEN:
1628 rp = find_package_by_id(phy_package_id);
1629 if (!rp)
1630 break;
1631 if (--rp->nr_cpus == 0)
1632 rapl_remove_package(rp);
1633 else if (cpu == rp->lead_cpu) {
1634 /* choose another active cpu in the package */
1635 lead_cpu = cpumask_any_but(topology_core_cpumask(cpu), cpu);
1636 if (lead_cpu < nr_cpu_ids)
1637 rp->lead_cpu = lead_cpu;
1638 else /* should never go here */
1639 pr_err("no active cpu available for package %d\n",
1640 phy_package_id);
1644 return NOTIFY_OK;
1647 static struct notifier_block rapl_cpu_notifier = {
1648 .notifier_call = rapl_cpu_callback,
1651 static int __init rapl_init(void)
1653 int ret = 0;
1654 const struct x86_cpu_id *id;
1656 id = x86_match_cpu(rapl_ids);
1657 if (!id) {
1658 pr_err("driver does not support CPU family %d model %d\n",
1659 boot_cpu_data.x86, boot_cpu_data.x86_model);
1661 return -ENODEV;
1664 rapl_defaults = (struct rapl_defaults *)id->driver_data;
1666 cpu_notifier_register_begin();
1668 /* prevent CPU hotplug during detection */
1669 get_online_cpus();
1670 ret = rapl_detect_topology();
1671 if (ret)
1672 goto done;
1674 if (rapl_register_powercap()) {
1675 rapl_cleanup_data();
1676 ret = -ENODEV;
1677 goto done;
1679 __register_hotcpu_notifier(&rapl_cpu_notifier);
1680 done:
1681 put_online_cpus();
1682 cpu_notifier_register_done();
1684 return ret;
1687 static void __exit rapl_exit(void)
1689 cpu_notifier_register_begin();
1690 get_online_cpus();
1691 __unregister_hotcpu_notifier(&rapl_cpu_notifier);
1692 rapl_unregister_powercap();
1693 rapl_cleanup_data();
1694 put_online_cpus();
1695 cpu_notifier_register_done();
1698 module_init(rapl_init);
1699 module_exit(rapl_exit);
1701 MODULE_DESCRIPTION("Driver for Intel RAPL (Running Average Power Limit)");
1702 MODULE_AUTHOR("Jacob Pan <jacob.jun.pan@intel.com>");
1703 MODULE_LICENSE("GPL v2");