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
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>
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 */
82 ARBITRARY_UNIT
, /* no translation */
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 */
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
,
106 /* per domain data, some are optional */
107 enum rapl_primitives
{
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 */
118 TIME_WINDOW1
, /* long term */
119 TIME_WINDOW2
, /* short term */
128 /* below are not raw primitive data */
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
;
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
;
160 static const char pl1_name
[] = "long_term";
161 static const char pl2_name
[] = "short_term";
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 */
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
,
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
{
226 enum rapl_domain_msr_id id
;
231 #define PRIMITIVE_INFO_INIT(p, m, s, i, u, 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
,
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
[] = {
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
) {
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
) {
290 static int get_energy_counter(struct powercap_zone
*power_zone
, u64
*energy_raw
)
292 struct rapl_domain
*rd
;
295 /* prevent CPU hotplug, make sure the RAPL domain does not go
296 * away while reading the counter.
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
;
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);
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
) {
337 static int find_nr_power_limit(struct rapl_domain
*rd
)
341 for (i
= 0; i
< NR_POWER_LIMITS
; i
++) {
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
)
357 rapl_write_data_raw(rd
, PL1_ENABLE
, mode
);
358 if (rapl_defaults
->set_floor_freq
)
359 rapl_defaults
->set_floor_freq(rd
, mode
);
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
);
370 if (rd
->state
& DOMAIN_STATE_BIOS_LOCKED
) {
375 if (rapl_read_data_raw(rd
, PL1_ENABLE
, true, &val
)) {
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
)
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
);
449 static int set_power_limit(struct powercap_zone
*power_zone
, int cid
,
452 struct rapl_domain
*rd
;
453 struct rapl_package
*rp
;
458 rd
= power_zone_to_rapl_domain(power_zone
);
459 id
= contraint_to_pl(rd
, cid
);
463 if (rd
->state
& DOMAIN_STATE_BIOS_LOCKED
) {
464 dev_warn(&power_zone
->dev
, "%s locked by BIOS, monitoring only\n",
470 switch (rd
->rpl
[id
].prim_id
) {
472 rapl_write_data_raw(rd
, POWER_LIMIT1
, power_limit
);
475 rapl_write_data_raw(rd
, POWER_LIMIT2
, power_limit
);
481 package_power_limit_irq_save(rp
);
487 static int get_current_power_limit(struct powercap_zone
*power_zone
, int cid
,
490 struct rapl_domain
*rd
;
497 rd
= power_zone_to_rapl_domain(power_zone
);
498 id
= contraint_to_pl(rd
, cid
);
499 switch (rd
->rpl
[id
].prim_id
) {
510 if (rapl_read_data_raw(rd
, prim
, true, &val
))
520 static int set_time_window(struct powercap_zone
*power_zone
, int cid
,
523 struct rapl_domain
*rd
;
528 rd
= power_zone_to_rapl_domain(power_zone
);
529 id
= contraint_to_pl(rd
, cid
);
531 switch (rd
->rpl
[id
].prim_id
) {
533 rapl_write_data_raw(rd
, TIME_WINDOW1
, window
);
536 rapl_write_data_raw(rd
, TIME_WINDOW2
, window
);
545 static int get_time_window(struct powercap_zone
*power_zone
, int cid
, u64
*data
)
547 struct rapl_domain
*rd
;
553 rd
= power_zone_to_rapl_domain(power_zone
);
554 id
= contraint_to_pl(rd
, cid
);
556 switch (rd
->rpl
[id
].prim_id
) {
558 ret
= rapl_read_data_raw(rd
, TIME_WINDOW1
, true, &val
);
561 ret
= rapl_read_data_raw(rd
, TIME_WINDOW2
, true, &val
);
574 static const char *get_constraint_name(struct powercap_zone
*power_zone
, int cid
)
576 struct rapl_domain
*rd
;
579 rd
= power_zone_to_rapl_domain(power_zone
);
580 id
= contraint_to_pl(rd
, cid
);
582 return rd
->rpl
[id
].name
;
588 static int get_max_power(struct powercap_zone
*power_zone
, int id
,
591 struct rapl_domain
*rd
;
597 rd
= power_zone_to_rapl_domain(power_zone
);
598 switch (rd
->rpl
[id
].prim_id
) {
600 prim
= THERMAL_SPEC_POWER
;
609 if (rapl_read_data_raw(rd
, prim
, true, &val
))
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
)
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
);
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
;
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
;
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
;
656 rd
->msrs
[3] = MSR_PP0_POLICY
;
658 rd
->rpl
[0].prim_id
= PL1_ENABLE
;
659 rd
->rpl
[0].name
= pl1_name
;
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
;
667 rd
->msrs
[3] = MSR_PP1_POLICY
;
669 rd
->rpl
[0].prim_id
= PL1_ENABLE
;
670 rd
->rpl
[0].name
= pl1_name
;
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
;
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
);
696 static u64
rapl_unit_xlate(struct rapl_domain
*rd
, enum unit_type type
,
697 u64 value
, int to_raw
)
700 struct rapl_package
*rp
= rd
->rp
;
705 units
= rp
->power_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
;
713 units
= rp
->energy_unit
;
716 return rapl_defaults
->compute_time_window(rp
, value
, to_raw
);
723 return div64_u64(value
, units
) * scale
;
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),
766 PRIMITIVE_INFO_INIT(AVERAGE_POWER
, 0, 0, 0, POWER_UNIT
,
767 RAPL_PRIMITIVE_DERIVED
),
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
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
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
)
790 struct rapl_primitive_info
*rp
= &rpi
[prim
];
793 if (!rp
->name
|| rp
->flag
& RAPL_PRIMITIVE_DUMMY
)
796 msr
= rd
->msrs
[rp
->id
];
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
;
807 /* non-hardware data are collected by the polling thread */
808 if (rp
->flag
& RAPL_PRIMITIVE_DERIVED
) {
809 *data
= rd
->rdd
.primitives
[prim
];
813 if (rdmsrl_safe_on_cpu(cpu
, msr
, &value
)) {
814 pr_debug("failed to read msr 0x%x on cpu %d\n", msr
, cpu
);
818 final
= value
& rp
->mask
;
819 final
= final
>> rp
->shift
;
821 *data
= rapl_unit_xlate(rd
, rp
->unit
, final
, 0);
829 static int msrl_update_safe(u32 msr_no
, u64 clear_mask
, u64 set_mask
)
834 err
= rdmsrl_safe(msr_no
, &val
);
841 err
= wrmsrl_safe(msr_no
, val
);
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
];
862 struct msrl_action ma
;
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
;
874 ret
= smp_call_function_single(cpu
, msrl_update_func
, &ma
, 1);
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.
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
)
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
);
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
);
920 static int rapl_check_unit_atom(struct rapl_package
*rp
, int cpu
)
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
);
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
);
945 static void power_limit_irq_save_cpu(void *info
)
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
);
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
))
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
)
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
;
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
))
1000 /* irq enable state not saved, nothing to restore */
1001 if (!(rp
->power_limit_irq
& PACKAGE_PLN_INT_SAVED
))
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
;
1028 if (!rapl_defaults
->floor_freq_reg_addr
) {
1029 pr_err("Invalid floor frequency config register\n");
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
;
1039 mdata
&= ~(0x7f << 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
,
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.
1056 f
= (value
& 0x60) >> 5;
1058 value
= (1 << y
) * (4 + f
) * rp
->time_unit
/ 4;
1060 do_div(value
, rp
->time_unit
);
1062 f
= div64_u64(4 * (value
- (1 << y
)), 1 << y
);
1063 value
= (y
& 0x1f) | ((f
& 0x3) << 5);
1068 static u64
rapl_compute_time_window_atom(struct rapl_package
*rp
, u64 value
,
1072 * Atom time unit encoding is straight forward val * time_unit,
1073 * where time_unit is default to 1 sec. Never 0.
1076 return (value
) ? value
*= rp
->time_unit
: rp
->time_unit
;
1078 value
= div64_u64(value
, rp
->time_unit
);
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, \
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
)
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,
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
;
1199 pr_debug("remove package, undo power limit on %d: %s\n",
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
) {
1211 powercap_unregister_zone(control_type
, &rd
->power_zone
);
1213 /* do the package zone last */
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
);
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
;
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",
1246 memset(dev_name
, 0, sizeof(dev_name
));
1247 snprintf(dev_name
, sizeof(dev_name
), "%s-%d",
1249 power_zone
= powercap_register_zone(&rd
->power_zone
,
1255 if (IS_ERR(power_zone
)) {
1256 pr_debug("failed to register package, %d\n",
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 */
1267 pr_err("no package domain found, unknown topology!\n");
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
)
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
,
1279 &zone_ops
[rd
->id
], nr_pl
,
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
);
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
);
1303 static int rapl_register_psys(void)
1305 struct rapl_domain
*rd
;
1306 struct powercap_zone
*power_zone
;
1309 if (rdmsrl_safe_on_cpu(0, MSR_PLATFORM_ENERGY_STATUS
, &val
) || !val
)
1312 if (rdmsrl_safe_on_cpu(0, MSR_PLATFORM_POWER_LIMIT
, &val
) || !val
)
1315 rd
= kzalloc(sizeof(*rd
), GFP_KERNEL
);
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
,
1331 &zone_ops
[RAPL_DOMAIN_PLATFORM
],
1332 2, &constraint_ops
);
1334 if (IS_ERR(power_zone
)) {
1336 return PTR_ERR(power_zone
);
1339 platform_rapl_domain
= rd
;
1344 static int rapl_register_powercap(void)
1346 struct rapl_domain
*rd
;
1347 struct rapl_package
*rp
;
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();
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
;
1370 pr_debug("unregister zone/package %d, %s domain\n",
1372 powercap_unregister_zone(control_type
, &rd
->power_zone
);
1379 static int rapl_check_domain(int cpu
, int domain
)
1385 case RAPL_DOMAIN_PACKAGE
:
1386 msr
= MSR_PKG_ENERGY_STATUS
;
1388 case RAPL_DOMAIN_PP0
:
1389 msr
= MSR_PP0_ENERGY_STATUS
;
1391 case RAPL_DOMAIN_PP1
:
1392 msr
= MSR_PP1_ENERGY_STATUS
;
1394 case RAPL_DOMAIN_DRAM
:
1395 msr
= MSR_DRAM_ENERGY_STATUS
;
1397 case RAPL_DOMAIN_PLATFORM
:
1398 /* PSYS(PLATFORM) is not a CPU domain, so avoid printng error */
1401 pr_err("invalid domain id %d\n", domain
);
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
)
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
)
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
)) {
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
)
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
);
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
),
1474 rapl_init_domains(rp
);
1476 for (rd
= rp
->domains
; rd
< rp
->domains
+ rp
->nr_domains
; rd
++)
1477 rapl_detect_powerlimit(rd
);
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
)
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
1504 static int rapl_detect_topology(void)
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
);
1515 rapl_cleanup_data();
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
);
1528 /* free up the packages already initialized */
1529 rapl_cleanup_data();
1532 INIT_LIST_HEAD(&new_package
->plist
);
1533 list_add(&new_package
->plist
, &rapl_packages
);
1535 rp
= find_package_by_id(phy_package_id
);
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
) {
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
);
1563 /* called from CPU hotplug notifier, hotplug lock held */
1564 static int rapl_add_package(int cpu
)
1568 struct rapl_package
*rp
;
1570 phy_package_id
= topology_physical_package_id(cpu
);
1571 rp
= kzalloc(sizeof(struct rapl_package
), GFP_KERNEL
);
1575 /* add the new package to the list */
1576 rp
->id
= phy_package_id
;
1580 /* check if the package contains valid domains */
1581 if (rapl_detect_domains(rp
, cpu
) ||
1582 rapl_defaults
->check_unit(rp
, cpu
)) {
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
);
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
1606 static int rapl_cpu_callback(struct notifier_block
*nfb
,
1607 unsigned long action
, void *hcpu
)
1609 unsigned long cpu
= (unsigned long)hcpu
;
1611 struct rapl_package
*rp
;
1614 phy_package_id
= topology_physical_package_id(cpu
);
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
);
1624 rapl_add_package(cpu
);
1626 case CPU_DOWN_PREPARE
:
1627 case CPU_DOWN_PREPARE_FROZEN
:
1628 rp
= find_package_by_id(phy_package_id
);
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",
1647 static struct notifier_block rapl_cpu_notifier
= {
1648 .notifier_call
= rapl_cpu_callback
,
1651 static int __init
rapl_init(void)
1654 const struct x86_cpu_id
*id
;
1656 id
= x86_match_cpu(rapl_ids
);
1658 pr_err("driver does not support CPU family %d model %d\n",
1659 boot_cpu_data
.x86
, boot_cpu_data
.x86_model
);
1664 rapl_defaults
= (struct rapl_defaults
*)id
->driver_data
;
1666 cpu_notifier_register_begin();
1668 /* prevent CPU hotplug during detection */
1670 ret
= rapl_detect_topology();
1674 if (rapl_register_powercap()) {
1675 rapl_cleanup_data();
1679 __register_hotcpu_notifier(&rapl_cpu_notifier
);
1682 cpu_notifier_register_done();
1687 static void __exit
rapl_exit(void)
1689 cpu_notifier_register_begin();
1691 __unregister_hotcpu_notifier(&rapl_cpu_notifier
);
1692 rapl_unregister_powercap();
1693 rapl_cleanup_data();
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");