1 // SPDX-License-Identifier: GPL-2.0
3 * Enable PCIe link L0s/L1 state and Clock Power Management
5 * Copyright (C) 2007 Intel
6 * Copyright (C) Zhang Yanmin (yanmin.zhang@intel.com)
7 * Copyright (C) Shaohua Li (shaohua.li@intel.com)
10 #include <linux/kernel.h>
11 #include <linux/module.h>
12 #include <linux/moduleparam.h>
13 #include <linux/pci.h>
14 #include <linux/pci_regs.h>
15 #include <linux/errno.h>
17 #include <linux/init.h>
18 #include <linux/slab.h>
19 #include <linux/jiffies.h>
20 #include <linux/delay.h>
21 #include <linux/pci-aspm.h>
24 #ifdef MODULE_PARAM_PREFIX
25 #undef MODULE_PARAM_PREFIX
27 #define MODULE_PARAM_PREFIX "pcie_aspm."
29 /* Note: those are not register definitions */
30 #define ASPM_STATE_L0S_UP (1) /* Upstream direction L0s state */
31 #define ASPM_STATE_L0S_DW (2) /* Downstream direction L0s state */
32 #define ASPM_STATE_L1 (4) /* L1 state */
33 #define ASPM_STATE_L1_1 (8) /* ASPM L1.1 state */
34 #define ASPM_STATE_L1_2 (0x10) /* ASPM L1.2 state */
35 #define ASPM_STATE_L1_1_PCIPM (0x20) /* PCI PM L1.1 state */
36 #define ASPM_STATE_L1_2_PCIPM (0x40) /* PCI PM L1.2 state */
37 #define ASPM_STATE_L1_SS_PCIPM (ASPM_STATE_L1_1_PCIPM | ASPM_STATE_L1_2_PCIPM)
38 #define ASPM_STATE_L1_2_MASK (ASPM_STATE_L1_2 | ASPM_STATE_L1_2_PCIPM)
39 #define ASPM_STATE_L1SS (ASPM_STATE_L1_1 | ASPM_STATE_L1_1_PCIPM |\
41 #define ASPM_STATE_L0S (ASPM_STATE_L0S_UP | ASPM_STATE_L0S_DW)
42 #define ASPM_STATE_ALL (ASPM_STATE_L0S | ASPM_STATE_L1 | \
46 u32 l0s
; /* L0s latency (nsec) */
47 u32 l1
; /* L1 latency (nsec) */
50 struct pcie_link_state
{
51 struct pci_dev
*pdev
; /* Upstream component of the Link */
52 struct pci_dev
*downstream
; /* Downstream component, function 0 */
53 struct pcie_link_state
*root
; /* pointer to the root port link */
54 struct pcie_link_state
*parent
; /* pointer to the parent Link state */
55 struct list_head sibling
; /* node in link_list */
56 struct list_head children
; /* list of child link states */
57 struct list_head link
; /* node in parent's children list */
60 u32 aspm_support
:7; /* Supported ASPM state */
61 u32 aspm_enabled
:7; /* Enabled ASPM state */
62 u32 aspm_capable
:7; /* Capable ASPM state with latency */
63 u32 aspm_default
:7; /* Default ASPM state by BIOS */
64 u32 aspm_disable
:7; /* Disabled ASPM state */
67 u32 clkpm_capable
:1; /* Clock PM capable? */
68 u32 clkpm_enabled
:1; /* Current Clock PM state */
69 u32 clkpm_default
:1; /* Default Clock PM state by BIOS */
72 struct aspm_latency latency_up
; /* Upstream direction exit latency */
73 struct aspm_latency latency_dw
; /* Downstream direction exit latency */
75 * Endpoint acceptable latencies. A pcie downstream port only
76 * has one slot under it, so at most there are 8 functions.
78 struct aspm_latency acceptable
[8];
80 /* L1 PM Substate info */
82 u32 up_cap_ptr
; /* L1SS cap ptr in upstream dev */
83 u32 dw_cap_ptr
; /* L1SS cap ptr in downstream dev */
84 u32 ctl1
; /* value to be programmed in ctl1 */
85 u32 ctl2
; /* value to be programmed in ctl2 */
89 static int aspm_disabled
, aspm_force
;
90 static bool aspm_support_enabled
= true;
91 static DEFINE_MUTEX(aspm_lock
);
92 static LIST_HEAD(link_list
);
94 #define POLICY_DEFAULT 0 /* BIOS default setting */
95 #define POLICY_PERFORMANCE 1 /* high performance */
96 #define POLICY_POWERSAVE 2 /* high power saving */
97 #define POLICY_POWER_SUPERSAVE 3 /* possibly even more power saving */
99 #ifdef CONFIG_PCIEASPM_PERFORMANCE
100 static int aspm_policy
= POLICY_PERFORMANCE
;
101 #elif defined CONFIG_PCIEASPM_POWERSAVE
102 static int aspm_policy
= POLICY_POWERSAVE
;
103 #elif defined CONFIG_PCIEASPM_POWER_SUPERSAVE
104 static int aspm_policy
= POLICY_POWER_SUPERSAVE
;
106 static int aspm_policy
;
109 static const char *policy_str
[] = {
110 [POLICY_DEFAULT
] = "default",
111 [POLICY_PERFORMANCE
] = "performance",
112 [POLICY_POWERSAVE
] = "powersave",
113 [POLICY_POWER_SUPERSAVE
] = "powersupersave"
116 #define LINK_RETRAIN_TIMEOUT HZ
118 static int policy_to_aspm_state(struct pcie_link_state
*link
)
120 switch (aspm_policy
) {
121 case POLICY_PERFORMANCE
:
122 /* Disable ASPM and Clock PM */
124 case POLICY_POWERSAVE
:
125 /* Enable ASPM L0s/L1 */
126 return (ASPM_STATE_L0S
| ASPM_STATE_L1
);
127 case POLICY_POWER_SUPERSAVE
:
128 /* Enable Everything */
129 return ASPM_STATE_ALL
;
131 return link
->aspm_default
;
136 static int policy_to_clkpm_state(struct pcie_link_state
*link
)
138 switch (aspm_policy
) {
139 case POLICY_PERFORMANCE
:
140 /* Disable ASPM and Clock PM */
142 case POLICY_POWERSAVE
:
143 case POLICY_POWER_SUPERSAVE
:
144 /* Enable Clock PM */
147 return link
->clkpm_default
;
152 static void pcie_set_clkpm_nocheck(struct pcie_link_state
*link
, int enable
)
154 struct pci_dev
*child
;
155 struct pci_bus
*linkbus
= link
->pdev
->subordinate
;
156 u32 val
= enable
? PCI_EXP_LNKCTL_CLKREQ_EN
: 0;
158 list_for_each_entry(child
, &linkbus
->devices
, bus_list
)
159 pcie_capability_clear_and_set_word(child
, PCI_EXP_LNKCTL
,
160 PCI_EXP_LNKCTL_CLKREQ_EN
,
162 link
->clkpm_enabled
= !!enable
;
165 static void pcie_set_clkpm(struct pcie_link_state
*link
, int enable
)
167 /* Don't enable Clock PM if the link is not Clock PM capable */
168 if (!link
->clkpm_capable
)
170 /* Need nothing if the specified equals to current state */
171 if (link
->clkpm_enabled
== enable
)
173 pcie_set_clkpm_nocheck(link
, enable
);
176 static void pcie_clkpm_cap_init(struct pcie_link_state
*link
, int blacklist
)
178 int capable
= 1, enabled
= 1;
181 struct pci_dev
*child
;
182 struct pci_bus
*linkbus
= link
->pdev
->subordinate
;
184 /* All functions should have the same cap and state, take the worst */
185 list_for_each_entry(child
, &linkbus
->devices
, bus_list
) {
186 pcie_capability_read_dword(child
, PCI_EXP_LNKCAP
, ®32
);
187 if (!(reg32
& PCI_EXP_LNKCAP_CLKPM
)) {
192 pcie_capability_read_word(child
, PCI_EXP_LNKCTL
, ®16
);
193 if (!(reg16
& PCI_EXP_LNKCTL_CLKREQ_EN
))
196 link
->clkpm_enabled
= enabled
;
197 link
->clkpm_default
= enabled
;
198 link
->clkpm_capable
= (blacklist
) ? 0 : capable
;
202 * pcie_aspm_configure_common_clock: check if the 2 ends of a link
203 * could use common clock. If they are, configure them to use the
204 * common clock. That will reduce the ASPM state exit latency.
206 static void pcie_aspm_configure_common_clock(struct pcie_link_state
*link
)
209 u16 reg16
, parent_reg
, child_reg
[8];
210 unsigned long start_jiffies
;
211 struct pci_dev
*child
, *parent
= link
->pdev
;
212 struct pci_bus
*linkbus
= parent
->subordinate
;
214 * All functions of a slot should have the same Slot Clock
215 * Configuration, so just check one function
217 child
= list_entry(linkbus
->devices
.next
, struct pci_dev
, bus_list
);
218 BUG_ON(!pci_is_pcie(child
));
220 /* Check downstream component if bit Slot Clock Configuration is 1 */
221 pcie_capability_read_word(child
, PCI_EXP_LNKSTA
, ®16
);
222 if (!(reg16
& PCI_EXP_LNKSTA_SLC
))
225 /* Check upstream component if bit Slot Clock Configuration is 1 */
226 pcie_capability_read_word(parent
, PCI_EXP_LNKSTA
, ®16
);
227 if (!(reg16
& PCI_EXP_LNKSTA_SLC
))
230 /* Port might be already in common clock mode */
231 pcie_capability_read_word(parent
, PCI_EXP_LNKCTL
, ®16
);
232 if (same_clock
&& (reg16
& PCI_EXP_LNKCTL_CCC
)) {
233 bool consistent
= true;
235 list_for_each_entry(child
, &linkbus
->devices
, bus_list
) {
236 pcie_capability_read_word(child
, PCI_EXP_LNKCTL
,
238 if (!(reg16
& PCI_EXP_LNKCTL_CCC
)) {
245 pci_warn(parent
, "ASPM: current common clock configuration is broken, reconfiguring\n");
248 /* Configure downstream component, all functions */
249 list_for_each_entry(child
, &linkbus
->devices
, bus_list
) {
250 pcie_capability_read_word(child
, PCI_EXP_LNKCTL
, ®16
);
251 child_reg
[PCI_FUNC(child
->devfn
)] = reg16
;
253 reg16
|= PCI_EXP_LNKCTL_CCC
;
255 reg16
&= ~PCI_EXP_LNKCTL_CCC
;
256 pcie_capability_write_word(child
, PCI_EXP_LNKCTL
, reg16
);
259 /* Configure upstream component */
260 pcie_capability_read_word(parent
, PCI_EXP_LNKCTL
, ®16
);
263 reg16
|= PCI_EXP_LNKCTL_CCC
;
265 reg16
&= ~PCI_EXP_LNKCTL_CCC
;
266 pcie_capability_write_word(parent
, PCI_EXP_LNKCTL
, reg16
);
269 reg16
|= PCI_EXP_LNKCTL_RL
;
270 pcie_capability_write_word(parent
, PCI_EXP_LNKCTL
, reg16
);
272 /* Wait for link training end. Break out after waiting for timeout */
273 start_jiffies
= jiffies
;
275 pcie_capability_read_word(parent
, PCI_EXP_LNKSTA
, ®16
);
276 if (!(reg16
& PCI_EXP_LNKSTA_LT
))
278 if (time_after(jiffies
, start_jiffies
+ LINK_RETRAIN_TIMEOUT
))
282 if (!(reg16
& PCI_EXP_LNKSTA_LT
))
285 /* Training failed. Restore common clock configurations */
286 pci_err(parent
, "ASPM: Could not configure common clock\n");
287 list_for_each_entry(child
, &linkbus
->devices
, bus_list
)
288 pcie_capability_write_word(child
, PCI_EXP_LNKCTL
,
289 child_reg
[PCI_FUNC(child
->devfn
)]);
290 pcie_capability_write_word(parent
, PCI_EXP_LNKCTL
, parent_reg
);
293 /* Convert L0s latency encoding to ns */
294 static u32
calc_l0s_latency(u32 encoding
)
297 return (5 * 1000); /* > 4us */
298 return (64 << encoding
);
301 /* Convert L0s acceptable latency encoding to ns */
302 static u32
calc_l0s_acceptable(u32 encoding
)
306 return (64 << encoding
);
309 /* Convert L1 latency encoding to ns */
310 static u32
calc_l1_latency(u32 encoding
)
313 return (65 * 1000); /* > 64us */
314 return (1000 << encoding
);
317 /* Convert L1 acceptable latency encoding to ns */
318 static u32
calc_l1_acceptable(u32 encoding
)
322 return (1000 << encoding
);
325 /* Convert L1SS T_pwr encoding to usec */
326 static u32
calc_l1ss_pwron(struct pci_dev
*pdev
, u32 scale
, u32 val
)
336 pci_err(pdev
, "%s: Invalid T_PwrOn scale: %u\n", __func__
, scale
);
340 static void encode_l12_threshold(u32 threshold_us
, u32
*scale
, u32
*value
)
342 u32 threshold_ns
= threshold_us
* 1000;
344 /* See PCIe r3.1, sec 7.33.3 and sec 6.18 */
345 if (threshold_ns
< 32) {
347 *value
= threshold_ns
;
348 } else if (threshold_ns
< 1024) {
350 *value
= threshold_ns
>> 5;
351 } else if (threshold_ns
< 32768) {
353 *value
= threshold_ns
>> 10;
354 } else if (threshold_ns
< 1048576) {
356 *value
= threshold_ns
>> 15;
357 } else if (threshold_ns
< 33554432) {
359 *value
= threshold_ns
>> 20;
362 *value
= threshold_ns
>> 25;
366 struct aspm_register_info
{
369 u32 latency_encoding_l0s
;
370 u32 latency_encoding_l1
;
379 static void pcie_get_aspm_reg(struct pci_dev
*pdev
,
380 struct aspm_register_info
*info
)
385 pcie_capability_read_dword(pdev
, PCI_EXP_LNKCAP
, ®32
);
386 info
->support
= (reg32
& PCI_EXP_LNKCAP_ASPMS
) >> 10;
387 info
->latency_encoding_l0s
= (reg32
& PCI_EXP_LNKCAP_L0SEL
) >> 12;
388 info
->latency_encoding_l1
= (reg32
& PCI_EXP_LNKCAP_L1EL
) >> 15;
389 pcie_capability_read_word(pdev
, PCI_EXP_LNKCTL
, ®16
);
390 info
->enabled
= reg16
& PCI_EXP_LNKCTL_ASPMC
;
392 /* Read L1 PM substate capabilities */
393 info
->l1ss_cap
= info
->l1ss_ctl1
= info
->l1ss_ctl2
= 0;
394 info
->l1ss_cap_ptr
= pci_find_ext_capability(pdev
, PCI_EXT_CAP_ID_L1SS
);
395 if (!info
->l1ss_cap_ptr
)
397 pci_read_config_dword(pdev
, info
->l1ss_cap_ptr
+ PCI_L1SS_CAP
,
399 if (!(info
->l1ss_cap
& PCI_L1SS_CAP_L1_PM_SS
)) {
405 * If we don't have LTR for the entire path from the Root Complex
406 * to this device, we can't use ASPM L1.2 because it relies on the
407 * LTR_L1.2_THRESHOLD. See PCIe r4.0, secs 5.5.4, 6.18.
410 info
->l1ss_cap
&= ~PCI_L1SS_CAP_ASPM_L1_2
;
412 pci_read_config_dword(pdev
, info
->l1ss_cap_ptr
+ PCI_L1SS_CTL1
,
414 pci_read_config_dword(pdev
, info
->l1ss_cap_ptr
+ PCI_L1SS_CTL2
,
418 static void pcie_aspm_check_latency(struct pci_dev
*endpoint
)
420 u32 latency
, l1_switch_latency
= 0;
421 struct aspm_latency
*acceptable
;
422 struct pcie_link_state
*link
;
424 /* Device not in D0 doesn't need latency check */
425 if ((endpoint
->current_state
!= PCI_D0
) &&
426 (endpoint
->current_state
!= PCI_UNKNOWN
))
429 link
= endpoint
->bus
->self
->link_state
;
430 acceptable
= &link
->acceptable
[PCI_FUNC(endpoint
->devfn
)];
433 /* Check upstream direction L0s latency */
434 if ((link
->aspm_capable
& ASPM_STATE_L0S_UP
) &&
435 (link
->latency_up
.l0s
> acceptable
->l0s
))
436 link
->aspm_capable
&= ~ASPM_STATE_L0S_UP
;
438 /* Check downstream direction L0s latency */
439 if ((link
->aspm_capable
& ASPM_STATE_L0S_DW
) &&
440 (link
->latency_dw
.l0s
> acceptable
->l0s
))
441 link
->aspm_capable
&= ~ASPM_STATE_L0S_DW
;
444 * Every switch on the path to root complex need 1
445 * more microsecond for L1. Spec doesn't mention L0s.
447 * The exit latencies for L1 substates are not advertised
448 * by a device. Since the spec also doesn't mention a way
449 * to determine max latencies introduced by enabling L1
450 * substates on the components, it is not clear how to do
451 * a L1 substate exit latency check. We assume that the
452 * L1 exit latencies advertised by a device include L1
453 * substate latencies (and hence do not do any check).
455 latency
= max_t(u32
, link
->latency_up
.l1
, link
->latency_dw
.l1
);
456 if ((link
->aspm_capable
& ASPM_STATE_L1
) &&
457 (latency
+ l1_switch_latency
> acceptable
->l1
))
458 link
->aspm_capable
&= ~ASPM_STATE_L1
;
459 l1_switch_latency
+= 1000;
466 * The L1 PM substate capability is only implemented in function 0 in a
467 * multi function device.
469 static struct pci_dev
*pci_function_0(struct pci_bus
*linkbus
)
471 struct pci_dev
*child
;
473 list_for_each_entry(child
, &linkbus
->devices
, bus_list
)
474 if (PCI_FUNC(child
->devfn
) == 0)
479 /* Calculate L1.2 PM substate timing parameters */
480 static void aspm_calc_l1ss_info(struct pcie_link_state
*link
,
481 struct aspm_register_info
*upreg
,
482 struct aspm_register_info
*dwreg
)
484 u32 val1
, val2
, scale1
, scale2
;
485 u32 t_common_mode
, t_power_on
, l1_2_threshold
, scale
, value
;
487 link
->l1ss
.up_cap_ptr
= upreg
->l1ss_cap_ptr
;
488 link
->l1ss
.dw_cap_ptr
= dwreg
->l1ss_cap_ptr
;
489 link
->l1ss
.ctl1
= link
->l1ss
.ctl2
= 0;
491 if (!(link
->aspm_support
& ASPM_STATE_L1_2_MASK
))
494 /* Choose the greater of the two Port Common_Mode_Restore_Times */
495 val1
= (upreg
->l1ss_cap
& PCI_L1SS_CAP_CM_RESTORE_TIME
) >> 8;
496 val2
= (dwreg
->l1ss_cap
& PCI_L1SS_CAP_CM_RESTORE_TIME
) >> 8;
497 t_common_mode
= max(val1
, val2
);
499 /* Choose the greater of the two Port T_POWER_ON times */
500 val1
= (upreg
->l1ss_cap
& PCI_L1SS_CAP_P_PWR_ON_VALUE
) >> 19;
501 scale1
= (upreg
->l1ss_cap
& PCI_L1SS_CAP_P_PWR_ON_SCALE
) >> 16;
502 val2
= (dwreg
->l1ss_cap
& PCI_L1SS_CAP_P_PWR_ON_VALUE
) >> 19;
503 scale2
= (dwreg
->l1ss_cap
& PCI_L1SS_CAP_P_PWR_ON_SCALE
) >> 16;
505 if (calc_l1ss_pwron(link
->pdev
, scale1
, val1
) >
506 calc_l1ss_pwron(link
->downstream
, scale2
, val2
)) {
507 link
->l1ss
.ctl2
|= scale1
| (val1
<< 3);
508 t_power_on
= calc_l1ss_pwron(link
->pdev
, scale1
, val1
);
510 link
->l1ss
.ctl2
|= scale2
| (val2
<< 3);
511 t_power_on
= calc_l1ss_pwron(link
->downstream
, scale2
, val2
);
515 * Set LTR_L1.2_THRESHOLD to the time required to transition the
516 * Link from L0 to L1.2 and back to L0 so we enter L1.2 only if
517 * downstream devices report (via LTR) that they can tolerate at
518 * least that much latency.
520 * Based on PCIe r3.1, sec 5.5.3.3.1, Figures 5-16 and 5-17, and
521 * Table 5-11. T(POWER_OFF) is at most 2us and T(L1.2) is at
524 l1_2_threshold
= 2 + 4 + t_common_mode
+ t_power_on
;
525 encode_l12_threshold(l1_2_threshold
, &scale
, &value
);
526 link
->l1ss
.ctl1
|= t_common_mode
<< 8 | scale
<< 29 | value
<< 16;
529 static void pcie_aspm_cap_init(struct pcie_link_state
*link
, int blacklist
)
531 struct pci_dev
*child
= link
->downstream
, *parent
= link
->pdev
;
532 struct pci_bus
*linkbus
= parent
->subordinate
;
533 struct aspm_register_info upreg
, dwreg
;
536 /* Set enabled/disable so that we will disable ASPM later */
537 link
->aspm_enabled
= ASPM_STATE_ALL
;
538 link
->aspm_disable
= ASPM_STATE_ALL
;
542 /* Get upstream/downstream components' register state */
543 pcie_get_aspm_reg(parent
, &upreg
);
544 pcie_get_aspm_reg(child
, &dwreg
);
547 * If ASPM not supported, don't mess with the clocks and link,
550 if (!(upreg
.support
& dwreg
.support
))
553 /* Configure common clock before checking latencies */
554 pcie_aspm_configure_common_clock(link
);
557 * Re-read upstream/downstream components' register state
558 * after clock configuration
560 pcie_get_aspm_reg(parent
, &upreg
);
561 pcie_get_aspm_reg(child
, &dwreg
);
566 * Note that we must not enable L0s in either direction on a
567 * given link unless components on both sides of the link each
570 if (dwreg
.support
& upreg
.support
& PCIE_LINK_STATE_L0S
)
571 link
->aspm_support
|= ASPM_STATE_L0S
;
572 if (dwreg
.enabled
& PCIE_LINK_STATE_L0S
)
573 link
->aspm_enabled
|= ASPM_STATE_L0S_UP
;
574 if (upreg
.enabled
& PCIE_LINK_STATE_L0S
)
575 link
->aspm_enabled
|= ASPM_STATE_L0S_DW
;
576 link
->latency_up
.l0s
= calc_l0s_latency(upreg
.latency_encoding_l0s
);
577 link
->latency_dw
.l0s
= calc_l0s_latency(dwreg
.latency_encoding_l0s
);
580 if (upreg
.support
& dwreg
.support
& PCIE_LINK_STATE_L1
)
581 link
->aspm_support
|= ASPM_STATE_L1
;
582 if (upreg
.enabled
& dwreg
.enabled
& PCIE_LINK_STATE_L1
)
583 link
->aspm_enabled
|= ASPM_STATE_L1
;
584 link
->latency_up
.l1
= calc_l1_latency(upreg
.latency_encoding_l1
);
585 link
->latency_dw
.l1
= calc_l1_latency(dwreg
.latency_encoding_l1
);
587 /* Setup L1 substate */
588 if (upreg
.l1ss_cap
& dwreg
.l1ss_cap
& PCI_L1SS_CAP_ASPM_L1_1
)
589 link
->aspm_support
|= ASPM_STATE_L1_1
;
590 if (upreg
.l1ss_cap
& dwreg
.l1ss_cap
& PCI_L1SS_CAP_ASPM_L1_2
)
591 link
->aspm_support
|= ASPM_STATE_L1_2
;
592 if (upreg
.l1ss_cap
& dwreg
.l1ss_cap
& PCI_L1SS_CAP_PCIPM_L1_1
)
593 link
->aspm_support
|= ASPM_STATE_L1_1_PCIPM
;
594 if (upreg
.l1ss_cap
& dwreg
.l1ss_cap
& PCI_L1SS_CAP_PCIPM_L1_2
)
595 link
->aspm_support
|= ASPM_STATE_L1_2_PCIPM
;
597 if (upreg
.l1ss_ctl1
& dwreg
.l1ss_ctl1
& PCI_L1SS_CTL1_ASPM_L1_1
)
598 link
->aspm_enabled
|= ASPM_STATE_L1_1
;
599 if (upreg
.l1ss_ctl1
& dwreg
.l1ss_ctl1
& PCI_L1SS_CTL1_ASPM_L1_2
)
600 link
->aspm_enabled
|= ASPM_STATE_L1_2
;
601 if (upreg
.l1ss_ctl1
& dwreg
.l1ss_ctl1
& PCI_L1SS_CTL1_PCIPM_L1_1
)
602 link
->aspm_enabled
|= ASPM_STATE_L1_1_PCIPM
;
603 if (upreg
.l1ss_ctl1
& dwreg
.l1ss_ctl1
& PCI_L1SS_CTL1_PCIPM_L1_2
)
604 link
->aspm_enabled
|= ASPM_STATE_L1_2_PCIPM
;
606 if (link
->aspm_support
& ASPM_STATE_L1SS
)
607 aspm_calc_l1ss_info(link
, &upreg
, &dwreg
);
609 /* Save default state */
610 link
->aspm_default
= link
->aspm_enabled
;
612 /* Setup initial capable state. Will be updated later */
613 link
->aspm_capable
= link
->aspm_support
;
615 * If the downstream component has pci bridge function, don't
618 list_for_each_entry(child
, &linkbus
->devices
, bus_list
) {
619 if (pci_pcie_type(child
) == PCI_EXP_TYPE_PCI_BRIDGE
) {
620 link
->aspm_disable
= ASPM_STATE_ALL
;
625 /* Get and check endpoint acceptable latencies */
626 list_for_each_entry(child
, &linkbus
->devices
, bus_list
) {
628 struct aspm_latency
*acceptable
=
629 &link
->acceptable
[PCI_FUNC(child
->devfn
)];
631 if (pci_pcie_type(child
) != PCI_EXP_TYPE_ENDPOINT
&&
632 pci_pcie_type(child
) != PCI_EXP_TYPE_LEG_END
)
635 pcie_capability_read_dword(child
, PCI_EXP_DEVCAP
, ®32
);
636 /* Calculate endpoint L0s acceptable latency */
637 encoding
= (reg32
& PCI_EXP_DEVCAP_L0S
) >> 6;
638 acceptable
->l0s
= calc_l0s_acceptable(encoding
);
639 /* Calculate endpoint L1 acceptable latency */
640 encoding
= (reg32
& PCI_EXP_DEVCAP_L1
) >> 9;
641 acceptable
->l1
= calc_l1_acceptable(encoding
);
643 pcie_aspm_check_latency(child
);
647 static void pci_clear_and_set_dword(struct pci_dev
*pdev
, int pos
,
652 pci_read_config_dword(pdev
, pos
, &val
);
655 pci_write_config_dword(pdev
, pos
, val
);
658 /* Configure the ASPM L1 substates */
659 static void pcie_config_aspm_l1ss(struct pcie_link_state
*link
, u32 state
)
662 struct pci_dev
*child
= link
->downstream
, *parent
= link
->pdev
;
663 u32 up_cap_ptr
= link
->l1ss
.up_cap_ptr
;
664 u32 dw_cap_ptr
= link
->l1ss
.dw_cap_ptr
;
666 enable_req
= (link
->aspm_enabled
^ state
) & state
;
669 * Here are the rules specified in the PCIe spec for enabling L1SS:
670 * - When enabling L1.x, enable bit at parent first, then at child
671 * - When disabling L1.x, disable bit at child first, then at parent
672 * - When enabling ASPM L1.x, need to disable L1
673 * (at child followed by parent).
674 * - The ASPM/PCIPM L1.2 must be disabled while programming timing
677 * To keep it simple, disable all L1SS bits first, and later enable
681 /* Disable all L1 substates */
682 pci_clear_and_set_dword(child
, dw_cap_ptr
+ PCI_L1SS_CTL1
,
683 PCI_L1SS_CTL1_L1SS_MASK
, 0);
684 pci_clear_and_set_dword(parent
, up_cap_ptr
+ PCI_L1SS_CTL1
,
685 PCI_L1SS_CTL1_L1SS_MASK
, 0);
687 * If needed, disable L1, and it gets enabled later
688 * in pcie_config_aspm_link().
690 if (enable_req
& (ASPM_STATE_L1_1
| ASPM_STATE_L1_2
)) {
691 pcie_capability_clear_and_set_word(child
, PCI_EXP_LNKCTL
,
692 PCI_EXP_LNKCTL_ASPM_L1
, 0);
693 pcie_capability_clear_and_set_word(parent
, PCI_EXP_LNKCTL
,
694 PCI_EXP_LNKCTL_ASPM_L1
, 0);
697 if (enable_req
& ASPM_STATE_L1_2_MASK
) {
699 /* Program T_POWER_ON times in both ports */
700 pci_write_config_dword(parent
, up_cap_ptr
+ PCI_L1SS_CTL2
,
702 pci_write_config_dword(child
, dw_cap_ptr
+ PCI_L1SS_CTL2
,
705 /* Program Common_Mode_Restore_Time in upstream device */
706 pci_clear_and_set_dword(parent
, up_cap_ptr
+ PCI_L1SS_CTL1
,
707 PCI_L1SS_CTL1_CM_RESTORE_TIME
,
710 /* Program LTR_L1.2_THRESHOLD time in both ports */
711 pci_clear_and_set_dword(parent
, up_cap_ptr
+ PCI_L1SS_CTL1
,
712 PCI_L1SS_CTL1_LTR_L12_TH_VALUE
|
713 PCI_L1SS_CTL1_LTR_L12_TH_SCALE
,
715 pci_clear_and_set_dword(child
, dw_cap_ptr
+ PCI_L1SS_CTL1
,
716 PCI_L1SS_CTL1_LTR_L12_TH_VALUE
|
717 PCI_L1SS_CTL1_LTR_L12_TH_SCALE
,
722 if (state
& ASPM_STATE_L1_1
)
723 val
|= PCI_L1SS_CTL1_ASPM_L1_1
;
724 if (state
& ASPM_STATE_L1_2
)
725 val
|= PCI_L1SS_CTL1_ASPM_L1_2
;
726 if (state
& ASPM_STATE_L1_1_PCIPM
)
727 val
|= PCI_L1SS_CTL1_PCIPM_L1_1
;
728 if (state
& ASPM_STATE_L1_2_PCIPM
)
729 val
|= PCI_L1SS_CTL1_PCIPM_L1_2
;
731 /* Enable what we need to enable */
732 pci_clear_and_set_dword(parent
, up_cap_ptr
+ PCI_L1SS_CTL1
,
733 PCI_L1SS_CAP_L1_PM_SS
, val
);
734 pci_clear_and_set_dword(child
, dw_cap_ptr
+ PCI_L1SS_CTL1
,
735 PCI_L1SS_CAP_L1_PM_SS
, val
);
738 static void pcie_config_aspm_dev(struct pci_dev
*pdev
, u32 val
)
740 pcie_capability_clear_and_set_word(pdev
, PCI_EXP_LNKCTL
,
741 PCI_EXP_LNKCTL_ASPMC
, val
);
744 static void pcie_config_aspm_link(struct pcie_link_state
*link
, u32 state
)
746 u32 upstream
= 0, dwstream
= 0;
747 struct pci_dev
*child
= link
->downstream
, *parent
= link
->pdev
;
748 struct pci_bus
*linkbus
= parent
->subordinate
;
750 /* Enable only the states that were not explicitly disabled */
751 state
&= (link
->aspm_capable
& ~link
->aspm_disable
);
753 /* Can't enable any substates if L1 is not enabled */
754 if (!(state
& ASPM_STATE_L1
))
755 state
&= ~ASPM_STATE_L1SS
;
757 /* Spec says both ports must be in D0 before enabling PCI PM substates*/
758 if (parent
->current_state
!= PCI_D0
|| child
->current_state
!= PCI_D0
) {
759 state
&= ~ASPM_STATE_L1_SS_PCIPM
;
760 state
|= (link
->aspm_enabled
& ASPM_STATE_L1_SS_PCIPM
);
763 /* Nothing to do if the link is already in the requested state */
764 if (link
->aspm_enabled
== state
)
766 /* Convert ASPM state to upstream/downstream ASPM register state */
767 if (state
& ASPM_STATE_L0S_UP
)
768 dwstream
|= PCI_EXP_LNKCTL_ASPM_L0S
;
769 if (state
& ASPM_STATE_L0S_DW
)
770 upstream
|= PCI_EXP_LNKCTL_ASPM_L0S
;
771 if (state
& ASPM_STATE_L1
) {
772 upstream
|= PCI_EXP_LNKCTL_ASPM_L1
;
773 dwstream
|= PCI_EXP_LNKCTL_ASPM_L1
;
776 if (link
->aspm_capable
& ASPM_STATE_L1SS
)
777 pcie_config_aspm_l1ss(link
, state
);
780 * Spec 2.0 suggests all functions should be configured the
781 * same setting for ASPM. Enabling ASPM L1 should be done in
782 * upstream component first and then downstream, and vice
783 * versa for disabling ASPM L1. Spec doesn't mention L0S.
785 if (state
& ASPM_STATE_L1
)
786 pcie_config_aspm_dev(parent
, upstream
);
787 list_for_each_entry(child
, &linkbus
->devices
, bus_list
)
788 pcie_config_aspm_dev(child
, dwstream
);
789 if (!(state
& ASPM_STATE_L1
))
790 pcie_config_aspm_dev(parent
, upstream
);
792 link
->aspm_enabled
= state
;
795 static void pcie_config_aspm_path(struct pcie_link_state
*link
)
798 pcie_config_aspm_link(link
, policy_to_aspm_state(link
));
803 static void free_link_state(struct pcie_link_state
*link
)
805 link
->pdev
->link_state
= NULL
;
809 static int pcie_aspm_sanity_check(struct pci_dev
*pdev
)
811 struct pci_dev
*child
;
815 * Some functions in a slot might not all be PCIe functions,
816 * very strange. Disable ASPM for the whole slot
818 list_for_each_entry(child
, &pdev
->subordinate
->devices
, bus_list
) {
819 if (!pci_is_pcie(child
))
823 * If ASPM is disabled then we're not going to change
824 * the BIOS state. It's safe to continue even if it's a
832 * Disable ASPM for pre-1.1 PCIe device, we follow MS to use
833 * RBER bit to determine if a function is 1.1 version device
835 pcie_capability_read_dword(child
, PCI_EXP_DEVCAP
, ®32
);
836 if (!(reg32
& PCI_EXP_DEVCAP_RBER
) && !aspm_force
) {
837 pci_info(child
, "disabling ASPM on pre-1.1 PCIe device. You can enable it with 'pcie_aspm=force'\n");
844 static struct pcie_link_state
*alloc_pcie_link_state(struct pci_dev
*pdev
)
846 struct pcie_link_state
*link
;
848 link
= kzalloc(sizeof(*link
), GFP_KERNEL
);
852 INIT_LIST_HEAD(&link
->sibling
);
853 INIT_LIST_HEAD(&link
->children
);
854 INIT_LIST_HEAD(&link
->link
);
856 link
->downstream
= pci_function_0(pdev
->subordinate
);
859 * Root Ports and PCI/PCI-X to PCIe Bridges are roots of PCIe
860 * hierarchies. Note that some PCIe host implementations omit
861 * the root ports entirely, in which case a downstream port on
862 * a switch may become the root of the link state chain for all
863 * its subordinate endpoints.
865 if (pci_pcie_type(pdev
) == PCI_EXP_TYPE_ROOT_PORT
||
866 pci_pcie_type(pdev
) == PCI_EXP_TYPE_PCIE_BRIDGE
||
867 !pdev
->bus
->parent
->self
) {
870 struct pcie_link_state
*parent
;
872 parent
= pdev
->bus
->parent
->self
->link_state
;
878 link
->parent
= parent
;
879 link
->root
= link
->parent
->root
;
880 list_add(&link
->link
, &parent
->children
);
883 list_add(&link
->sibling
, &link_list
);
884 pdev
->link_state
= link
;
889 * pcie_aspm_init_link_state: Initiate PCI express link state.
890 * It is called after the pcie and its children devices are scanned.
891 * @pdev: the root port or switch downstream port
893 void pcie_aspm_init_link_state(struct pci_dev
*pdev
)
895 struct pcie_link_state
*link
;
896 int blacklist
= !!pcie_aspm_sanity_check(pdev
);
898 if (!aspm_support_enabled
|| aspm_disabled
)
901 if (pdev
->link_state
)
905 * We allocate pcie_link_state for the component on the upstream
906 * end of a Link, so there's nothing to do unless this device has a
907 * Link on its secondary side.
909 if (!pdev
->has_secondary_link
)
912 /* VIA has a strange chipset, root port is under a bridge */
913 if (pci_pcie_type(pdev
) == PCI_EXP_TYPE_ROOT_PORT
&&
917 down_read(&pci_bus_sem
);
918 if (list_empty(&pdev
->subordinate
->devices
))
921 mutex_lock(&aspm_lock
);
922 link
= alloc_pcie_link_state(pdev
);
926 * Setup initial ASPM state. Note that we need to configure
927 * upstream links also because capable state of them can be
928 * update through pcie_aspm_cap_init().
930 pcie_aspm_cap_init(link
, blacklist
);
932 /* Setup initial Clock PM state */
933 pcie_clkpm_cap_init(link
, blacklist
);
936 * At this stage drivers haven't had an opportunity to change the
937 * link policy setting. Enabling ASPM on broken hardware can cripple
938 * it even before the driver has had a chance to disable ASPM, so
939 * default to a safe level right now. If we're enabling ASPM beyond
940 * the BIOS's expectation, we'll do so once pci_enable_device() is
943 if (aspm_policy
!= POLICY_POWERSAVE
&&
944 aspm_policy
!= POLICY_POWER_SUPERSAVE
) {
945 pcie_config_aspm_path(link
);
946 pcie_set_clkpm(link
, policy_to_clkpm_state(link
));
950 mutex_unlock(&aspm_lock
);
952 up_read(&pci_bus_sem
);
955 /* Recheck latencies and update aspm_capable for links under the root */
956 static void pcie_update_aspm_capable(struct pcie_link_state
*root
)
958 struct pcie_link_state
*link
;
959 BUG_ON(root
->parent
);
960 list_for_each_entry(link
, &link_list
, sibling
) {
961 if (link
->root
!= root
)
963 link
->aspm_capable
= link
->aspm_support
;
965 list_for_each_entry(link
, &link_list
, sibling
) {
966 struct pci_dev
*child
;
967 struct pci_bus
*linkbus
= link
->pdev
->subordinate
;
968 if (link
->root
!= root
)
970 list_for_each_entry(child
, &linkbus
->devices
, bus_list
) {
971 if ((pci_pcie_type(child
) != PCI_EXP_TYPE_ENDPOINT
) &&
972 (pci_pcie_type(child
) != PCI_EXP_TYPE_LEG_END
))
974 pcie_aspm_check_latency(child
);
979 /* @pdev: the endpoint device */
980 void pcie_aspm_exit_link_state(struct pci_dev
*pdev
)
982 struct pci_dev
*parent
= pdev
->bus
->self
;
983 struct pcie_link_state
*link
, *root
, *parent_link
;
985 if (!parent
|| !parent
->link_state
)
988 down_read(&pci_bus_sem
);
989 mutex_lock(&aspm_lock
);
991 * All PCIe functions are in one slot, remove one function will remove
992 * the whole slot, so just wait until we are the last function left.
994 if (!list_empty(&parent
->subordinate
->devices
))
997 link
= parent
->link_state
;
999 parent_link
= link
->parent
;
1001 /* All functions are removed, so just disable ASPM for the link */
1002 pcie_config_aspm_link(link
, 0);
1003 list_del(&link
->sibling
);
1004 list_del(&link
->link
);
1005 /* Clock PM is for endpoint device */
1006 free_link_state(link
);
1008 /* Recheck latencies and configure upstream links */
1010 pcie_update_aspm_capable(root
);
1011 pcie_config_aspm_path(parent_link
);
1014 mutex_unlock(&aspm_lock
);
1015 up_read(&pci_bus_sem
);
1018 /* @pdev: the root port or switch downstream port */
1019 void pcie_aspm_pm_state_change(struct pci_dev
*pdev
)
1021 struct pcie_link_state
*link
= pdev
->link_state
;
1023 if (aspm_disabled
|| !link
)
1026 * Devices changed PM state, we should recheck if latency
1027 * meets all functions' requirement
1029 down_read(&pci_bus_sem
);
1030 mutex_lock(&aspm_lock
);
1031 pcie_update_aspm_capable(link
->root
);
1032 pcie_config_aspm_path(link
);
1033 mutex_unlock(&aspm_lock
);
1034 up_read(&pci_bus_sem
);
1037 void pcie_aspm_powersave_config_link(struct pci_dev
*pdev
)
1039 struct pcie_link_state
*link
= pdev
->link_state
;
1041 if (aspm_disabled
|| !link
)
1044 if (aspm_policy
!= POLICY_POWERSAVE
&&
1045 aspm_policy
!= POLICY_POWER_SUPERSAVE
)
1048 down_read(&pci_bus_sem
);
1049 mutex_lock(&aspm_lock
);
1050 pcie_config_aspm_path(link
);
1051 pcie_set_clkpm(link
, policy_to_clkpm_state(link
));
1052 mutex_unlock(&aspm_lock
);
1053 up_read(&pci_bus_sem
);
1056 static void __pci_disable_link_state(struct pci_dev
*pdev
, int state
, bool sem
)
1058 struct pci_dev
*parent
= pdev
->bus
->self
;
1059 struct pcie_link_state
*link
;
1061 if (!pci_is_pcie(pdev
))
1064 if (pdev
->has_secondary_link
)
1066 if (!parent
|| !parent
->link_state
)
1070 * A driver requested that ASPM be disabled on this device, but
1071 * if we don't have permission to manage ASPM (e.g., on ACPI
1072 * systems we have to observe the FADT ACPI_FADT_NO_ASPM bit and
1073 * the _OSC method), we can't honor that request. Windows has
1074 * a similar mechanism using "PciASPMOptOut", which is also
1075 * ignored in this situation.
1077 if (aspm_disabled
) {
1078 pci_warn(pdev
, "can't disable ASPM; OS doesn't have ASPM control\n");
1083 down_read(&pci_bus_sem
);
1084 mutex_lock(&aspm_lock
);
1085 link
= parent
->link_state
;
1086 if (state
& PCIE_LINK_STATE_L0S
)
1087 link
->aspm_disable
|= ASPM_STATE_L0S
;
1088 if (state
& PCIE_LINK_STATE_L1
)
1089 link
->aspm_disable
|= ASPM_STATE_L1
;
1090 pcie_config_aspm_link(link
, policy_to_aspm_state(link
));
1092 if (state
& PCIE_LINK_STATE_CLKPM
) {
1093 link
->clkpm_capable
= 0;
1094 pcie_set_clkpm(link
, 0);
1096 mutex_unlock(&aspm_lock
);
1098 up_read(&pci_bus_sem
);
1101 void pci_disable_link_state_locked(struct pci_dev
*pdev
, int state
)
1103 __pci_disable_link_state(pdev
, state
, false);
1105 EXPORT_SYMBOL(pci_disable_link_state_locked
);
1108 * pci_disable_link_state - Disable device's link state, so the link will
1109 * never enter specific states. Note that if the BIOS didn't grant ASPM
1110 * control to the OS, this does nothing because we can't touch the LNKCTL
1114 * @state: ASPM link state to disable
1116 void pci_disable_link_state(struct pci_dev
*pdev
, int state
)
1118 __pci_disable_link_state(pdev
, state
, true);
1120 EXPORT_SYMBOL(pci_disable_link_state
);
1122 static int pcie_aspm_set_policy(const char *val
,
1123 const struct kernel_param
*kp
)
1126 struct pcie_link_state
*link
;
1130 i
= sysfs_match_string(policy_str
, val
);
1133 if (i
== aspm_policy
)
1136 down_read(&pci_bus_sem
);
1137 mutex_lock(&aspm_lock
);
1139 list_for_each_entry(link
, &link_list
, sibling
) {
1140 pcie_config_aspm_link(link
, policy_to_aspm_state(link
));
1141 pcie_set_clkpm(link
, policy_to_clkpm_state(link
));
1143 mutex_unlock(&aspm_lock
);
1144 up_read(&pci_bus_sem
);
1148 static int pcie_aspm_get_policy(char *buffer
, const struct kernel_param
*kp
)
1151 for (i
= 0; i
< ARRAY_SIZE(policy_str
); i
++)
1152 if (i
== aspm_policy
)
1153 cnt
+= sprintf(buffer
+ cnt
, "[%s] ", policy_str
[i
]);
1155 cnt
+= sprintf(buffer
+ cnt
, "%s ", policy_str
[i
]);
1159 module_param_call(policy
, pcie_aspm_set_policy
, pcie_aspm_get_policy
,
1162 #ifdef CONFIG_PCIEASPM_DEBUG
1163 static ssize_t
link_state_show(struct device
*dev
,
1164 struct device_attribute
*attr
,
1167 struct pci_dev
*pci_device
= to_pci_dev(dev
);
1168 struct pcie_link_state
*link_state
= pci_device
->link_state
;
1170 return sprintf(buf
, "%d\n", link_state
->aspm_enabled
);
1173 static ssize_t
link_state_store(struct device
*dev
,
1174 struct device_attribute
*attr
,
1178 struct pci_dev
*pdev
= to_pci_dev(dev
);
1179 struct pcie_link_state
*link
, *root
= pdev
->link_state
->root
;
1185 if (kstrtouint(buf
, 10, &state
))
1187 if ((state
& ~ASPM_STATE_ALL
) != 0)
1190 down_read(&pci_bus_sem
);
1191 mutex_lock(&aspm_lock
);
1192 list_for_each_entry(link
, &link_list
, sibling
) {
1193 if (link
->root
!= root
)
1195 pcie_config_aspm_link(link
, state
);
1197 mutex_unlock(&aspm_lock
);
1198 up_read(&pci_bus_sem
);
1202 static ssize_t
clk_ctl_show(struct device
*dev
,
1203 struct device_attribute
*attr
,
1206 struct pci_dev
*pci_device
= to_pci_dev(dev
);
1207 struct pcie_link_state
*link_state
= pci_device
->link_state
;
1209 return sprintf(buf
, "%d\n", link_state
->clkpm_enabled
);
1212 static ssize_t
clk_ctl_store(struct device
*dev
,
1213 struct device_attribute
*attr
,
1217 struct pci_dev
*pdev
= to_pci_dev(dev
);
1220 if (strtobool(buf
, &state
))
1223 down_read(&pci_bus_sem
);
1224 mutex_lock(&aspm_lock
);
1225 pcie_set_clkpm_nocheck(pdev
->link_state
, state
);
1226 mutex_unlock(&aspm_lock
);
1227 up_read(&pci_bus_sem
);
1232 static DEVICE_ATTR_RW(link_state
);
1233 static DEVICE_ATTR_RW(clk_ctl
);
1235 static char power_group
[] = "power";
1236 void pcie_aspm_create_sysfs_dev_files(struct pci_dev
*pdev
)
1238 struct pcie_link_state
*link_state
= pdev
->link_state
;
1243 if (link_state
->aspm_support
)
1244 sysfs_add_file_to_group(&pdev
->dev
.kobj
,
1245 &dev_attr_link_state
.attr
, power_group
);
1246 if (link_state
->clkpm_capable
)
1247 sysfs_add_file_to_group(&pdev
->dev
.kobj
,
1248 &dev_attr_clk_ctl
.attr
, power_group
);
1251 void pcie_aspm_remove_sysfs_dev_files(struct pci_dev
*pdev
)
1253 struct pcie_link_state
*link_state
= pdev
->link_state
;
1258 if (link_state
->aspm_support
)
1259 sysfs_remove_file_from_group(&pdev
->dev
.kobj
,
1260 &dev_attr_link_state
.attr
, power_group
);
1261 if (link_state
->clkpm_capable
)
1262 sysfs_remove_file_from_group(&pdev
->dev
.kobj
,
1263 &dev_attr_clk_ctl
.attr
, power_group
);
1267 static int __init
pcie_aspm_disable(char *str
)
1269 if (!strcmp(str
, "off")) {
1270 aspm_policy
= POLICY_DEFAULT
;
1272 aspm_support_enabled
= false;
1273 printk(KERN_INFO
"PCIe ASPM is disabled\n");
1274 } else if (!strcmp(str
, "force")) {
1276 printk(KERN_INFO
"PCIe ASPM is forcibly enabled\n");
1281 __setup("pcie_aspm=", pcie_aspm_disable
);
1283 void pcie_no_aspm(void)
1286 * Disabling ASPM is intended to prevent the kernel from modifying
1287 * existing hardware state, not to clear existing state. To that end:
1288 * (a) set policy to POLICY_DEFAULT in order to avoid changing state
1289 * (b) prevent userspace from changing policy
1292 aspm_policy
= POLICY_DEFAULT
;
1297 bool pcie_aspm_support_enabled(void)
1299 return aspm_support_enabled
;
1301 EXPORT_SYMBOL(pcie_aspm_support_enabled
);