1 // SPDX-License-Identifier: GPL-2.0
7 * Copyright (C) 2004 Intel Corp.
10 #include <linux/delay.h>
11 #include <linux/init.h>
12 #include <linux/irqdomain.h>
13 #include <linux/pci.h>
14 #include <linux/msi.h>
15 #include <linux/pci_hotplug.h>
16 #include <linux/module.h>
17 #include <linux/pci-acpi.h>
18 #include <linux/pm_runtime.h>
19 #include <linux/pm_qos.h>
20 #include <linux/rwsem.h>
24 * The GUID is defined in the PCI Firmware Specification available
25 * here to PCI-SIG members:
26 * https://members.pcisig.com/wg/PCI-SIG/document/15350
28 const guid_t pci_acpi_dsm_guid =
29 GUID_INIT(0xe5c937d0, 0x3553, 0x4d7a,
30 0x91, 0x17, 0xea, 0x4d, 0x19, 0xc3, 0x43, 0x4d);
32 #if defined(CONFIG_PCI_QUIRKS) && defined(CONFIG_ARM64)
33 static int acpi_get_rc_addr(struct acpi_device *adev, struct resource *res)
35 struct device *dev = &adev->dev;
36 struct resource_entry *entry;
37 struct list_head list;
41 INIT_LIST_HEAD(&list);
42 flags = IORESOURCE_MEM;
43 ret = acpi_dev_get_resources(adev, &list,
44 acpi_dev_filter_resource_type_cb,
47 dev_err(dev, "failed to parse _CRS method, error code %d\n",
53 dev_err(dev, "no IO and memory resources present in _CRS\n");
57 entry = list_first_entry(&list, struct resource_entry, node);
59 acpi_dev_free_resource_list(&list);
63 static acpi_status acpi_match_rc(acpi_handle handle, u32 lvl, void *context,
66 u16 *segment = context;
67 unsigned long long uid;
70 status = acpi_evaluate_integer(handle, METHOD_NAME__UID, NULL, &uid);
71 if (ACPI_FAILURE(status) || uid != *segment)
74 *(acpi_handle *)retval = handle;
75 return AE_CTRL_TERMINATE;
78 int acpi_get_rc_resources(struct device *dev, const char *hid, u16 segment,
81 struct acpi_device *adev;
86 status = acpi_get_devices(hid, acpi_match_rc, &segment, &handle);
87 if (ACPI_FAILURE(status)) {
88 dev_err(dev, "can't find _HID %s device to locate resources\n",
93 adev = acpi_fetch_acpi_dev(handle);
97 ret = acpi_get_rc_addr(adev, res);
99 dev_err(dev, "can't get resource from %s\n",
100 dev_name(&adev->dev));
108 phys_addr_t acpi_pci_root_get_mcfg_addr(acpi_handle handle)
110 acpi_status status = AE_NOT_EXIST;
111 unsigned long long mcfg_addr;
114 status = acpi_evaluate_integer(handle, METHOD_NAME__CBA,
116 if (ACPI_FAILURE(status))
119 return (phys_addr_t)mcfg_addr;
122 bool pci_acpi_preserve_config(struct pci_host_bridge *host_bridge)
124 if (ACPI_HANDLE(&host_bridge->dev)) {
125 union acpi_object *obj;
128 * Evaluate the "PCI Boot Configuration" _DSM Function. If it
129 * exists and returns 0, we must preserve any PCI resource
130 * assignments made by firmware for this host bridge.
132 obj = acpi_evaluate_dsm_typed(ACPI_HANDLE(&host_bridge->dev),
134 1, DSM_PCI_PRESERVE_BOOT_CONFIG,
135 NULL, ACPI_TYPE_INTEGER);
136 if (obj && obj->integer.value == 0)
144 /* _HPX PCI Setting Record (Type 0); same as _HPP */
146 u32 revision; /* Not present in _HPP */
147 u8 cache_line_size; /* Not applicable to PCIe */
148 u8 latency_timer; /* Not applicable to PCIe */
153 static struct hpx_type0 pci_default_type0 = {
155 .cache_line_size = 8,
156 .latency_timer = 0x40,
161 static void program_hpx_type0(struct pci_dev *dev, struct hpx_type0 *hpx)
163 u16 pci_cmd, pci_bctl;
166 hpx = &pci_default_type0;
168 if (hpx->revision > 1) {
169 pci_warn(dev, "PCI settings rev %d not supported; using defaults\n",
171 hpx = &pci_default_type0;
174 pci_write_config_byte(dev, PCI_CACHE_LINE_SIZE, hpx->cache_line_size);
175 pci_write_config_byte(dev, PCI_LATENCY_TIMER, hpx->latency_timer);
176 pci_read_config_word(dev, PCI_COMMAND, &pci_cmd);
177 if (hpx->enable_serr)
178 pci_cmd |= PCI_COMMAND_SERR;
179 if (hpx->enable_perr)
180 pci_cmd |= PCI_COMMAND_PARITY;
181 pci_write_config_word(dev, PCI_COMMAND, pci_cmd);
183 /* Program bridge control value */
184 if ((dev->class >> 8) == PCI_CLASS_BRIDGE_PCI) {
185 pci_write_config_byte(dev, PCI_SEC_LATENCY_TIMER,
187 pci_read_config_word(dev, PCI_BRIDGE_CONTROL, &pci_bctl);
188 if (hpx->enable_perr)
189 pci_bctl |= PCI_BRIDGE_CTL_PARITY;
190 pci_write_config_word(dev, PCI_BRIDGE_CONTROL, pci_bctl);
194 static acpi_status decode_type0_hpx_record(union acpi_object *record,
195 struct hpx_type0 *hpx0)
198 union acpi_object *fields = record->package.elements;
199 u32 revision = fields[1].integer.value;
203 if (record->package.count != 6)
205 for (i = 2; i < 6; i++)
206 if (fields[i].type != ACPI_TYPE_INTEGER)
208 hpx0->revision = revision;
209 hpx0->cache_line_size = fields[2].integer.value;
210 hpx0->latency_timer = fields[3].integer.value;
211 hpx0->enable_serr = fields[4].integer.value;
212 hpx0->enable_perr = fields[5].integer.value;
215 pr_warn("%s: Type 0 Revision %d record not supported\n",
222 /* _HPX PCI-X Setting Record (Type 1) */
230 static void program_hpx_type1(struct pci_dev *dev, struct hpx_type1 *hpx)
237 pos = pci_find_capability(dev, PCI_CAP_ID_PCIX);
241 pci_warn(dev, "PCI-X settings not supported\n");
244 static acpi_status decode_type1_hpx_record(union acpi_object *record,
245 struct hpx_type1 *hpx1)
248 union acpi_object *fields = record->package.elements;
249 u32 revision = fields[1].integer.value;
253 if (record->package.count != 5)
255 for (i = 2; i < 5; i++)
256 if (fields[i].type != ACPI_TYPE_INTEGER)
258 hpx1->revision = revision;
259 hpx1->max_mem_read = fields[2].integer.value;
260 hpx1->avg_max_split = fields[3].integer.value;
261 hpx1->tot_max_split = fields[4].integer.value;
264 pr_warn("%s: Type 1 Revision %d record not supported\n",
271 static bool pcie_root_rcb_set(struct pci_dev *dev)
273 struct pci_dev *rp = pcie_find_root_port(dev);
279 pcie_capability_read_word(rp, PCI_EXP_LNKCTL, &lnkctl);
280 if (lnkctl & PCI_EXP_LNKCTL_RCB)
286 /* _HPX PCI Express Setting Record (Type 2) */
289 u32 unc_err_mask_and;
291 u32 unc_err_sever_and;
292 u32 unc_err_sever_or;
293 u32 cor_err_mask_and;
297 u16 pci_exp_devctl_and;
298 u16 pci_exp_devctl_or;
299 u16 pci_exp_lnkctl_and;
300 u16 pci_exp_lnkctl_or;
301 u32 sec_unc_err_sever_and;
302 u32 sec_unc_err_sever_or;
303 u32 sec_unc_err_mask_and;
304 u32 sec_unc_err_mask_or;
307 static void program_hpx_type2(struct pci_dev *dev, struct hpx_type2 *hpx)
315 if (!pci_is_pcie(dev))
318 if (hpx->revision > 1) {
319 pci_warn(dev, "PCIe settings rev %d not supported\n",
325 * Don't allow _HPX to change MPS or MRRS settings. We manage
326 * those to make sure they're consistent with the rest of the
329 hpx->pci_exp_devctl_and |= PCI_EXP_DEVCTL_PAYLOAD |
330 PCI_EXP_DEVCTL_READRQ;
331 hpx->pci_exp_devctl_or &= ~(PCI_EXP_DEVCTL_PAYLOAD |
332 PCI_EXP_DEVCTL_READRQ);
334 /* Initialize Device Control Register */
335 pcie_capability_clear_and_set_word(dev, PCI_EXP_DEVCTL,
336 ~hpx->pci_exp_devctl_and, hpx->pci_exp_devctl_or);
338 /* Initialize Link Control Register */
339 if (pcie_cap_has_lnkctl(dev)) {
342 * If the Root Port supports Read Completion Boundary of
343 * 128, set RCB to 128. Otherwise, clear it.
345 hpx->pci_exp_lnkctl_and |= PCI_EXP_LNKCTL_RCB;
346 hpx->pci_exp_lnkctl_or &= ~PCI_EXP_LNKCTL_RCB;
347 if (pcie_root_rcb_set(dev))
348 hpx->pci_exp_lnkctl_or |= PCI_EXP_LNKCTL_RCB;
350 pcie_capability_clear_and_set_word(dev, PCI_EXP_LNKCTL,
351 ~hpx->pci_exp_lnkctl_and, hpx->pci_exp_lnkctl_or);
354 /* Find Advanced Error Reporting Enhanced Capability */
355 pos = pci_find_ext_capability(dev, PCI_EXT_CAP_ID_ERR);
359 /* Initialize Uncorrectable Error Mask Register */
360 pci_read_config_dword(dev, pos + PCI_ERR_UNCOR_MASK, ®32);
361 reg32 = (reg32 & hpx->unc_err_mask_and) | hpx->unc_err_mask_or;
362 pci_write_config_dword(dev, pos + PCI_ERR_UNCOR_MASK, reg32);
364 /* Initialize Uncorrectable Error Severity Register */
365 pci_read_config_dword(dev, pos + PCI_ERR_UNCOR_SEVER, ®32);
366 reg32 = (reg32 & hpx->unc_err_sever_and) | hpx->unc_err_sever_or;
367 pci_write_config_dword(dev, pos + PCI_ERR_UNCOR_SEVER, reg32);
369 /* Initialize Correctable Error Mask Register */
370 pci_read_config_dword(dev, pos + PCI_ERR_COR_MASK, ®32);
371 reg32 = (reg32 & hpx->cor_err_mask_and) | hpx->cor_err_mask_or;
372 pci_write_config_dword(dev, pos + PCI_ERR_COR_MASK, reg32);
374 /* Initialize Advanced Error Capabilities and Control Register */
375 pci_read_config_dword(dev, pos + PCI_ERR_CAP, ®32);
376 reg32 = (reg32 & hpx->adv_err_cap_and) | hpx->adv_err_cap_or;
378 /* Don't enable ECRC generation or checking if unsupported */
379 if (!(reg32 & PCI_ERR_CAP_ECRC_GENC))
380 reg32 &= ~PCI_ERR_CAP_ECRC_GENE;
381 if (!(reg32 & PCI_ERR_CAP_ECRC_CHKC))
382 reg32 &= ~PCI_ERR_CAP_ECRC_CHKE;
383 pci_write_config_dword(dev, pos + PCI_ERR_CAP, reg32);
386 * FIXME: The following two registers are not supported yet.
388 * o Secondary Uncorrectable Error Severity Register
389 * o Secondary Uncorrectable Error Mask Register
393 static acpi_status decode_type2_hpx_record(union acpi_object *record,
394 struct hpx_type2 *hpx2)
397 union acpi_object *fields = record->package.elements;
398 u32 revision = fields[1].integer.value;
402 if (record->package.count != 18)
404 for (i = 2; i < 18; i++)
405 if (fields[i].type != ACPI_TYPE_INTEGER)
407 hpx2->revision = revision;
408 hpx2->unc_err_mask_and = fields[2].integer.value;
409 hpx2->unc_err_mask_or = fields[3].integer.value;
410 hpx2->unc_err_sever_and = fields[4].integer.value;
411 hpx2->unc_err_sever_or = fields[5].integer.value;
412 hpx2->cor_err_mask_and = fields[6].integer.value;
413 hpx2->cor_err_mask_or = fields[7].integer.value;
414 hpx2->adv_err_cap_and = fields[8].integer.value;
415 hpx2->adv_err_cap_or = fields[9].integer.value;
416 hpx2->pci_exp_devctl_and = fields[10].integer.value;
417 hpx2->pci_exp_devctl_or = fields[11].integer.value;
418 hpx2->pci_exp_lnkctl_and = fields[12].integer.value;
419 hpx2->pci_exp_lnkctl_or = fields[13].integer.value;
420 hpx2->sec_unc_err_sever_and = fields[14].integer.value;
421 hpx2->sec_unc_err_sever_or = fields[15].integer.value;
422 hpx2->sec_unc_err_mask_and = fields[16].integer.value;
423 hpx2->sec_unc_err_mask_or = fields[17].integer.value;
426 pr_warn("%s: Type 2 Revision %d record not supported\n",
433 /* _HPX PCI Express Setting Record (Type 3) */
437 u16 config_space_location;
440 u16 pci_exp_vendor_id;
451 enum hpx_type3_dev_type {
452 HPX_TYPE_ENDPOINT = BIT(0),
453 HPX_TYPE_LEG_END = BIT(1),
454 HPX_TYPE_RC_END = BIT(2),
455 HPX_TYPE_RC_EC = BIT(3),
456 HPX_TYPE_ROOT_PORT = BIT(4),
457 HPX_TYPE_UPSTREAM = BIT(5),
458 HPX_TYPE_DOWNSTREAM = BIT(6),
459 HPX_TYPE_PCI_BRIDGE = BIT(7),
460 HPX_TYPE_PCIE_BRIDGE = BIT(8),
463 static u16 hpx3_device_type(struct pci_dev *dev)
465 u16 pcie_type = pci_pcie_type(dev);
466 static const int pcie_to_hpx3_type[] = {
467 [PCI_EXP_TYPE_ENDPOINT] = HPX_TYPE_ENDPOINT,
468 [PCI_EXP_TYPE_LEG_END] = HPX_TYPE_LEG_END,
469 [PCI_EXP_TYPE_RC_END] = HPX_TYPE_RC_END,
470 [PCI_EXP_TYPE_RC_EC] = HPX_TYPE_RC_EC,
471 [PCI_EXP_TYPE_ROOT_PORT] = HPX_TYPE_ROOT_PORT,
472 [PCI_EXP_TYPE_UPSTREAM] = HPX_TYPE_UPSTREAM,
473 [PCI_EXP_TYPE_DOWNSTREAM] = HPX_TYPE_DOWNSTREAM,
474 [PCI_EXP_TYPE_PCI_BRIDGE] = HPX_TYPE_PCI_BRIDGE,
475 [PCI_EXP_TYPE_PCIE_BRIDGE] = HPX_TYPE_PCIE_BRIDGE,
478 if (pcie_type >= ARRAY_SIZE(pcie_to_hpx3_type))
481 return pcie_to_hpx3_type[pcie_type];
484 enum hpx_type3_fn_type {
485 HPX_FN_NORMAL = BIT(0),
486 HPX_FN_SRIOV_PHYS = BIT(1),
487 HPX_FN_SRIOV_VIRT = BIT(2),
490 static u8 hpx3_function_type(struct pci_dev *dev)
493 return HPX_FN_SRIOV_VIRT;
494 else if (pci_find_ext_capability(dev, PCI_EXT_CAP_ID_SRIOV) > 0)
495 return HPX_FN_SRIOV_PHYS;
497 return HPX_FN_NORMAL;
500 static bool hpx3_cap_ver_matches(u8 pcie_cap_id, u8 hpx3_cap_id)
502 u8 cap_ver = hpx3_cap_id & 0xf;
504 if ((hpx3_cap_id & BIT(4)) && cap_ver >= pcie_cap_id)
506 else if (cap_ver == pcie_cap_id)
512 enum hpx_type3_cfg_loc {
514 HPX_CFG_PCIE_CAP = 1,
515 HPX_CFG_PCIE_CAP_EXT = 2,
516 HPX_CFG_VEND_CAP = 3,
521 static void program_hpx_type3_register(struct pci_dev *dev,
522 const struct hpx_type3 *reg)
524 u32 match_reg, write_reg, header, orig_value;
527 if (!(hpx3_device_type(dev) & reg->device_type))
530 if (!(hpx3_function_type(dev) & reg->function_type))
533 switch (reg->config_space_location) {
537 case HPX_CFG_PCIE_CAP:
538 pos = pci_find_capability(dev, reg->pci_exp_cap_id);
543 case HPX_CFG_PCIE_CAP_EXT:
544 pos = pci_find_ext_capability(dev, reg->pci_exp_cap_id);
548 pci_read_config_dword(dev, pos, &header);
549 if (!hpx3_cap_ver_matches(PCI_EXT_CAP_VER(header),
550 reg->pci_exp_cap_ver))
554 case HPX_CFG_VEND_CAP:
557 pci_warn(dev, "Encountered _HPX type 3 with unsupported config space location");
561 pci_read_config_dword(dev, pos + reg->match_offset, &match_reg);
563 if ((match_reg & reg->match_mask_and) != reg->match_value)
566 pci_read_config_dword(dev, pos + reg->reg_offset, &write_reg);
567 orig_value = write_reg;
568 write_reg &= reg->reg_mask_and;
569 write_reg |= reg->reg_mask_or;
571 if (orig_value == write_reg)
574 pci_write_config_dword(dev, pos + reg->reg_offset, write_reg);
576 pci_dbg(dev, "Applied _HPX3 at [0x%x]: 0x%08x -> 0x%08x",
577 pos, orig_value, write_reg);
580 static void program_hpx_type3(struct pci_dev *dev, struct hpx_type3 *hpx)
585 if (!pci_is_pcie(dev))
588 program_hpx_type3_register(dev, hpx);
591 static void parse_hpx3_register(struct hpx_type3 *hpx3_reg,
592 union acpi_object *reg_fields)
594 hpx3_reg->device_type = reg_fields[0].integer.value;
595 hpx3_reg->function_type = reg_fields[1].integer.value;
596 hpx3_reg->config_space_location = reg_fields[2].integer.value;
597 hpx3_reg->pci_exp_cap_id = reg_fields[3].integer.value;
598 hpx3_reg->pci_exp_cap_ver = reg_fields[4].integer.value;
599 hpx3_reg->pci_exp_vendor_id = reg_fields[5].integer.value;
600 hpx3_reg->dvsec_id = reg_fields[6].integer.value;
601 hpx3_reg->dvsec_rev = reg_fields[7].integer.value;
602 hpx3_reg->match_offset = reg_fields[8].integer.value;
603 hpx3_reg->match_mask_and = reg_fields[9].integer.value;
604 hpx3_reg->match_value = reg_fields[10].integer.value;
605 hpx3_reg->reg_offset = reg_fields[11].integer.value;
606 hpx3_reg->reg_mask_and = reg_fields[12].integer.value;
607 hpx3_reg->reg_mask_or = reg_fields[13].integer.value;
610 static acpi_status program_type3_hpx_record(struct pci_dev *dev,
611 union acpi_object *record)
613 union acpi_object *fields = record->package.elements;
614 u32 desc_count, expected_length, revision;
615 union acpi_object *reg_fields;
616 struct hpx_type3 hpx3;
619 revision = fields[1].integer.value;
622 desc_count = fields[2].integer.value;
623 expected_length = 3 + desc_count * 14;
625 if (record->package.count != expected_length)
628 for (i = 2; i < expected_length; i++)
629 if (fields[i].type != ACPI_TYPE_INTEGER)
632 for (i = 0; i < desc_count; i++) {
633 reg_fields = fields + 3 + i * 14;
634 parse_hpx3_register(&hpx3, reg_fields);
635 program_hpx_type3(dev, &hpx3);
641 "%s: Type 3 Revision %d record not supported\n",
648 static acpi_status acpi_run_hpx(struct pci_dev *dev, acpi_handle handle)
651 struct acpi_buffer buffer = {ACPI_ALLOCATE_BUFFER, NULL};
652 union acpi_object *package, *record, *fields;
653 struct hpx_type0 hpx0;
654 struct hpx_type1 hpx1;
655 struct hpx_type2 hpx2;
659 status = acpi_evaluate_object(handle, "_HPX", NULL, &buffer);
660 if (ACPI_FAILURE(status))
663 package = (union acpi_object *)buffer.pointer;
664 if (package->type != ACPI_TYPE_PACKAGE) {
669 for (i = 0; i < package->package.count; i++) {
670 record = &package->package.elements[i];
671 if (record->type != ACPI_TYPE_PACKAGE) {
676 fields = record->package.elements;
677 if (fields[0].type != ACPI_TYPE_INTEGER ||
678 fields[1].type != ACPI_TYPE_INTEGER) {
683 type = fields[0].integer.value;
686 memset(&hpx0, 0, sizeof(hpx0));
687 status = decode_type0_hpx_record(record, &hpx0);
688 if (ACPI_FAILURE(status))
690 program_hpx_type0(dev, &hpx0);
693 memset(&hpx1, 0, sizeof(hpx1));
694 status = decode_type1_hpx_record(record, &hpx1);
695 if (ACPI_FAILURE(status))
697 program_hpx_type1(dev, &hpx1);
700 memset(&hpx2, 0, sizeof(hpx2));
701 status = decode_type2_hpx_record(record, &hpx2);
702 if (ACPI_FAILURE(status))
704 program_hpx_type2(dev, &hpx2);
707 status = program_type3_hpx_record(dev, record);
708 if (ACPI_FAILURE(status))
712 pr_err("%s: Type %d record not supported\n",
719 kfree(buffer.pointer);
723 static acpi_status acpi_run_hpp(struct pci_dev *dev, acpi_handle handle)
726 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
727 union acpi_object *package, *fields;
728 struct hpx_type0 hpx0;
731 memset(&hpx0, 0, sizeof(hpx0));
733 status = acpi_evaluate_object(handle, "_HPP", NULL, &buffer);
734 if (ACPI_FAILURE(status))
737 package = (union acpi_object *) buffer.pointer;
738 if (package->type != ACPI_TYPE_PACKAGE ||
739 package->package.count != 4) {
744 fields = package->package.elements;
745 for (i = 0; i < 4; i++) {
746 if (fields[i].type != ACPI_TYPE_INTEGER) {
753 hpx0.cache_line_size = fields[0].integer.value;
754 hpx0.latency_timer = fields[1].integer.value;
755 hpx0.enable_serr = fields[2].integer.value;
756 hpx0.enable_perr = fields[3].integer.value;
758 program_hpx_type0(dev, &hpx0);
761 kfree(buffer.pointer);
765 /* pci_acpi_program_hp_params
767 * @dev - the pci_dev for which we want parameters
769 int pci_acpi_program_hp_params(struct pci_dev *dev)
772 acpi_handle handle, phandle;
773 struct pci_bus *pbus;
775 if (acpi_pci_disabled)
779 for (pbus = dev->bus; pbus; pbus = pbus->parent) {
780 handle = acpi_pci_get_bridge_handle(pbus);
786 * _HPP settings apply to all child buses, until another _HPP is
787 * encountered. If we don't find an _HPP for the input pci dev,
788 * look for it in the parent device scope since that would apply to
792 status = acpi_run_hpx(dev, handle);
793 if (ACPI_SUCCESS(status))
795 status = acpi_run_hpp(dev, handle);
796 if (ACPI_SUCCESS(status))
798 if (acpi_is_root_bridge(handle))
800 status = acpi_get_parent(handle, &phandle);
801 if (ACPI_FAILURE(status))
809 * pciehp_is_native - Check whether a hotplug port is handled by the OS
810 * @bridge: Hotplug port to check
812 * Returns true if the given @bridge is handled by the native PCIe hotplug
815 bool pciehp_is_native(struct pci_dev *bridge)
817 const struct pci_host_bridge *host;
820 if (!IS_ENABLED(CONFIG_HOTPLUG_PCI_PCIE))
823 pcie_capability_read_dword(bridge, PCI_EXP_SLTCAP, &slot_cap);
824 if (!(slot_cap & PCI_EXP_SLTCAP_HPC))
827 if (pcie_ports_native)
830 host = pci_find_host_bridge(bridge->bus);
831 return host->native_pcie_hotplug;
835 * shpchp_is_native - Check whether a hotplug port is handled by the OS
836 * @bridge: Hotplug port to check
838 * Returns true if the given @bridge is handled by the native SHPC hotplug
841 bool shpchp_is_native(struct pci_dev *bridge)
843 return bridge->shpc_managed;
847 * pci_acpi_wake_bus - Root bus wakeup notification fork function.
848 * @context: Device wakeup context.
850 static void pci_acpi_wake_bus(struct acpi_device_wakeup_context *context)
852 struct acpi_device *adev;
853 struct acpi_pci_root *root;
855 adev = container_of(context, struct acpi_device, wakeup.context);
856 root = acpi_driver_data(adev);
857 pci_pme_wakeup_bus(root->bus);
861 * pci_acpi_wake_dev - PCI device wakeup notification work function.
862 * @context: Device wakeup context.
864 static void pci_acpi_wake_dev(struct acpi_device_wakeup_context *context)
866 struct pci_dev *pci_dev;
868 pci_dev = to_pci_dev(context->dev);
870 if (pci_dev->pme_poll)
871 pci_dev->pme_poll = false;
873 if (pci_dev->current_state == PCI_D3cold) {
874 pci_wakeup_event(pci_dev);
875 pm_request_resume(&pci_dev->dev);
879 /* Clear PME Status if set. */
880 if (pci_dev->pme_support)
881 pci_check_pme_status(pci_dev);
883 pci_wakeup_event(pci_dev);
884 pm_request_resume(&pci_dev->dev);
886 pci_pme_wakeup_bus(pci_dev->subordinate);
890 * pci_acpi_add_bus_pm_notifier - Register PM notifier for root PCI bus.
891 * @dev: PCI root bridge ACPI device.
893 acpi_status pci_acpi_add_bus_pm_notifier(struct acpi_device *dev)
895 return acpi_add_pm_notifier(dev, NULL, pci_acpi_wake_bus);
899 * pci_acpi_add_pm_notifier - Register PM notifier for given PCI device.
900 * @dev: ACPI device to add the notifier for.
901 * @pci_dev: PCI device to check for the PME status if an event is signaled.
903 acpi_status pci_acpi_add_pm_notifier(struct acpi_device *dev,
904 struct pci_dev *pci_dev)
906 return acpi_add_pm_notifier(dev, &pci_dev->dev, pci_acpi_wake_dev);
910 * _SxD returns the D-state with the highest power
911 * (lowest D-state number) supported in the S-state "x".
913 * If the devices does not have a _PRW
914 * (Power Resources for Wake) supporting system wakeup from "x"
915 * then the OS is free to choose a lower power (higher number
916 * D-state) than the return value from _SxD.
918 * But if _PRW is enabled at S-state "x", the OS
919 * must not choose a power lower than _SxD --
920 * unless the device has an _SxW method specifying
921 * the lowest power (highest D-state number) the device
922 * may enter while still able to wake the system.
924 * ie. depending on global OS policy:
926 * if (_PRW at S-state x)
927 * choose from highest power _SxD to lowest power _SxW
928 * else // no _PRW at S-state x
929 * choose highest power _SxD or any lower power
932 pci_power_t acpi_pci_choose_state(struct pci_dev *pdev)
934 int acpi_state, d_max;
936 if (pdev->no_d3cold || !pdev->d3cold_allowed)
937 d_max = ACPI_STATE_D3_HOT;
939 d_max = ACPI_STATE_D3_COLD;
940 acpi_state = acpi_pm_device_sleep_state(&pdev->dev, NULL, d_max);
942 return PCI_POWER_ERROR;
944 switch (acpi_state) {
951 case ACPI_STATE_D3_HOT:
953 case ACPI_STATE_D3_COLD:
956 return PCI_POWER_ERROR;
959 static struct acpi_device *acpi_pci_find_companion(struct device *dev);
961 void pci_set_acpi_fwnode(struct pci_dev *dev)
963 if (!dev_fwnode(&dev->dev) && !pci_dev_is_added(dev))
964 ACPI_COMPANION_SET(&dev->dev,
965 acpi_pci_find_companion(&dev->dev));
969 * pci_dev_acpi_reset - do a function level reset using _RST method
970 * @dev: device to reset
971 * @probe: if true, return 0 if device supports _RST
973 int pci_dev_acpi_reset(struct pci_dev *dev, bool probe)
975 acpi_handle handle = ACPI_HANDLE(&dev->dev);
977 if (!handle || !acpi_has_method(handle, "_RST"))
983 if (ACPI_FAILURE(acpi_evaluate_object(handle, "_RST", NULL, NULL))) {
984 pci_warn(dev, "ACPI _RST failed\n");
991 bool acpi_pci_power_manageable(struct pci_dev *dev)
993 struct acpi_device *adev = ACPI_COMPANION(&dev->dev);
995 return adev && acpi_device_power_manageable(adev);
998 bool acpi_pci_bridge_d3(struct pci_dev *dev)
1000 struct pci_dev *rpdev;
1001 struct acpi_device *adev, *rpadev;
1002 const union acpi_object *obj;
1004 if (acpi_pci_disabled || !dev->is_hotplug_bridge)
1007 adev = ACPI_COMPANION(&dev->dev);
1010 * If the bridge has _S0W, whether or not it can go into D3
1011 * depends on what is returned by that object. In particular,
1012 * if the power state returned by _S0W is D2 or shallower,
1013 * entering D3 should not be allowed.
1015 if (acpi_dev_power_state_for_wake(adev) <= ACPI_STATE_D2)
1019 * Otherwise, assume that the bridge can enter D3 so long as it
1020 * is power-manageable via ACPI.
1022 if (acpi_device_power_manageable(adev))
1026 rpdev = pcie_find_root_port(dev);
1033 rpadev = ACPI_COMPANION(&rpdev->dev);
1039 * If the Root Port cannot signal wakeup signals at all, i.e., it
1040 * doesn't supply a wakeup GPE via _PRW, it cannot signal hotplug
1041 * events from low-power states including D3hot and D3cold.
1043 if (!rpadev->wakeup.flags.valid)
1047 * In the bridge-below-a-Root-Port case, evaluate _S0W for the Root Port
1048 * to verify whether or not it can signal wakeup from D3.
1050 if (rpadev != adev &&
1051 acpi_dev_power_state_for_wake(rpadev) <= ACPI_STATE_D2)
1055 * The "HotPlugSupportInD3" property in a Root Port _DSD indicates
1056 * the Port can signal hotplug events while in D3. We assume any
1057 * bridges *below* that Root Port can also signal hotplug events
1060 if (!acpi_dev_get_property(rpadev, "HotPlugSupportInD3",
1061 ACPI_TYPE_INTEGER, &obj) &&
1062 obj->integer.value == 1)
1068 static void acpi_pci_config_space_access(struct pci_dev *dev, bool enable)
1070 int val = enable ? ACPI_REG_CONNECT : ACPI_REG_DISCONNECT;
1071 int ret = acpi_evaluate_reg(ACPI_HANDLE(&dev->dev),
1072 ACPI_ADR_SPACE_PCI_CONFIG, val);
1074 pci_dbg(dev, "ACPI _REG %s evaluation failed (%d)\n",
1075 enable ? "connect" : "disconnect", ret);
1078 int acpi_pci_set_power_state(struct pci_dev *dev, pci_power_t state)
1080 struct acpi_device *adev = ACPI_COMPANION(&dev->dev);
1081 static const u8 state_conv[] = {
1082 [PCI_D0] = ACPI_STATE_D0,
1083 [PCI_D1] = ACPI_STATE_D1,
1084 [PCI_D2] = ACPI_STATE_D2,
1085 [PCI_D3hot] = ACPI_STATE_D3_HOT,
1086 [PCI_D3cold] = ACPI_STATE_D3_COLD,
1090 /* If the ACPI device has _EJ0, ignore the device */
1091 if (!adev || acpi_has_method(adev->handle, "_EJ0"))
1105 if (state == PCI_D3cold) {
1106 if (dev_pm_qos_flags(&dev->dev, PM_QOS_FLAG_NO_POWER_OFF) ==
1110 /* Notify AML lack of PCI config space availability */
1111 acpi_pci_config_space_access(dev, false);
1114 error = acpi_device_set_power(adev, state_conv[state]);
1118 pci_dbg(dev, "power state changed by ACPI to %s\n",
1119 acpi_power_state_string(adev->power.state));
1122 * Notify AML of PCI config space availability. Config space is
1123 * accessible in all states except D3cold; the only transitions
1124 * that change availability are transitions to D3cold and from
1127 if (state == PCI_D0)
1128 acpi_pci_config_space_access(dev, true);
1133 pci_power_t acpi_pci_get_power_state(struct pci_dev *dev)
1135 struct acpi_device *adev = ACPI_COMPANION(&dev->dev);
1136 static const pci_power_t state_conv[] = {
1137 [ACPI_STATE_D0] = PCI_D0,
1138 [ACPI_STATE_D1] = PCI_D1,
1139 [ACPI_STATE_D2] = PCI_D2,
1140 [ACPI_STATE_D3_HOT] = PCI_D3hot,
1141 [ACPI_STATE_D3_COLD] = PCI_D3cold,
1145 if (!adev || !acpi_device_power_manageable(adev))
1148 state = adev->power.state;
1149 if (state == ACPI_STATE_UNKNOWN)
1152 return state_conv[state];
1155 void acpi_pci_refresh_power_state(struct pci_dev *dev)
1157 struct acpi_device *adev = ACPI_COMPANION(&dev->dev);
1159 if (adev && acpi_device_power_manageable(adev))
1160 acpi_device_update_power(adev, NULL);
1163 static int acpi_pci_propagate_wakeup(struct pci_bus *bus, bool enable)
1165 while (bus->parent) {
1166 if (acpi_pm_device_can_wakeup(&bus->self->dev))
1167 return acpi_pm_set_device_wakeup(&bus->self->dev, enable);
1172 /* We have reached the root bus. */
1174 if (acpi_pm_device_can_wakeup(bus->bridge))
1175 return acpi_pm_set_device_wakeup(bus->bridge, enable);
1180 int acpi_pci_wakeup(struct pci_dev *dev, bool enable)
1182 if (acpi_pci_disabled)
1185 if (acpi_pm_device_can_wakeup(&dev->dev))
1186 return acpi_pm_set_device_wakeup(&dev->dev, enable);
1188 return acpi_pci_propagate_wakeup(dev->bus, enable);
1191 bool acpi_pci_need_resume(struct pci_dev *dev)
1193 struct acpi_device *adev;
1195 if (acpi_pci_disabled)
1199 * In some cases (eg. Samsung 305V4A) leaving a bridge in suspend over
1200 * system-wide suspend/resume confuses the platform firmware, so avoid
1201 * doing that. According to Section 16.1.6 of ACPI 6.2, endpoint
1202 * devices are expected to be in D3 before invoking the S3 entry path
1203 * from the firmware, so they should not be affected by this issue.
1205 if (pci_is_bridge(dev) && acpi_target_system_state() != ACPI_STATE_S0)
1208 adev = ACPI_COMPANION(&dev->dev);
1209 if (!adev || !acpi_device_power_manageable(adev))
1212 if (adev->wakeup.flags.valid &&
1213 device_may_wakeup(&dev->dev) != !!adev->wakeup.prepare_count)
1216 if (acpi_target_system_state() == ACPI_STATE_S0)
1219 return !!adev->power.flags.dsw_present;
1222 void acpi_pci_add_bus(struct pci_bus *bus)
1224 union acpi_object *obj;
1225 struct pci_host_bridge *bridge;
1227 if (acpi_pci_disabled || !bus->bridge || !ACPI_HANDLE(bus->bridge))
1230 acpi_pci_slot_enumerate(bus);
1231 acpiphp_enumerate_slots(bus);
1234 * For a host bridge, check its _DSM for function 8 and if
1235 * that is available, mark it in pci_host_bridge.
1237 if (!pci_is_root_bus(bus))
1240 obj = acpi_evaluate_dsm_typed(ACPI_HANDLE(bus->bridge), &pci_acpi_dsm_guid, 3,
1241 DSM_PCI_POWER_ON_RESET_DELAY, NULL, ACPI_TYPE_INTEGER);
1245 if (obj->integer.value == 1) {
1246 bridge = pci_find_host_bridge(bus);
1247 bridge->ignore_reset_delay = 1;
1252 void acpi_pci_remove_bus(struct pci_bus *bus)
1254 if (acpi_pci_disabled || !bus->bridge)
1257 acpiphp_remove_slots(bus);
1258 acpi_pci_slot_remove(bus);
1264 static DECLARE_RWSEM(pci_acpi_companion_lookup_sem);
1265 static struct acpi_device *(*pci_acpi_find_companion_hook)(struct pci_dev *);
1268 * pci_acpi_set_companion_lookup_hook - Set ACPI companion lookup callback.
1269 * @func: ACPI companion lookup callback pointer or NULL.
1271 * Set a special ACPI companion lookup callback for PCI devices whose companion
1272 * objects in the ACPI namespace have _ADR with non-standard bus-device-function
1275 * Return 0 on success or a negative error code on failure (in which case no
1276 * changes are made).
1278 * The caller is responsible for the appropriate ordering of the invocations of
1279 * this function with respect to the enumeration of the PCI devices needing the
1280 * callback installed by it.
1282 int pci_acpi_set_companion_lookup_hook(struct acpi_device *(*func)(struct pci_dev *))
1289 down_write(&pci_acpi_companion_lookup_sem);
1291 if (pci_acpi_find_companion_hook) {
1294 pci_acpi_find_companion_hook = func;
1298 up_write(&pci_acpi_companion_lookup_sem);
1302 EXPORT_SYMBOL_GPL(pci_acpi_set_companion_lookup_hook);
1305 * pci_acpi_clear_companion_lookup_hook - Clear ACPI companion lookup callback.
1307 * Clear the special ACPI companion lookup callback previously set by
1308 * pci_acpi_set_companion_lookup_hook(). Block until the last running instance
1309 * of the callback returns before clearing it.
1311 * The caller is responsible for the appropriate ordering of the invocations of
1312 * this function with respect to the enumeration of the PCI devices needing the
1313 * callback cleared by it.
1315 void pci_acpi_clear_companion_lookup_hook(void)
1317 down_write(&pci_acpi_companion_lookup_sem);
1319 pci_acpi_find_companion_hook = NULL;
1321 up_write(&pci_acpi_companion_lookup_sem);
1323 EXPORT_SYMBOL_GPL(pci_acpi_clear_companion_lookup_hook);
1325 static struct acpi_device *acpi_pci_find_companion(struct device *dev)
1327 struct pci_dev *pci_dev = to_pci_dev(dev);
1328 struct acpi_device *adev;
1329 bool check_children;
1335 down_read(&pci_acpi_companion_lookup_sem);
1337 adev = pci_acpi_find_companion_hook ?
1338 pci_acpi_find_companion_hook(pci_dev) : NULL;
1340 up_read(&pci_acpi_companion_lookup_sem);
1345 check_children = pci_is_bridge(pci_dev);
1346 /* Please ref to ACPI spec for the syntax of _ADR */
1347 addr = (PCI_SLOT(pci_dev->devfn) << 16) | PCI_FUNC(pci_dev->devfn);
1348 adev = acpi_find_child_device(ACPI_COMPANION(dev->parent), addr,
1352 * There may be ACPI device objects in the ACPI namespace that are
1353 * children of the device object representing the host bridge, but don't
1354 * represent PCI devices. Both _HID and _ADR may be present for them,
1355 * even though that is against the specification (for example, see
1356 * Section 6.1 of ACPI 6.3), but in many cases the _ADR returns 0 which
1357 * appears to indicate that they should not be taken into consideration
1358 * as potential companions of PCI devices on the root bus.
1360 * To catch this special case, disregard the returned device object if
1361 * it has a valid _HID, addr is 0 and the PCI device at hand is on the
1364 if (adev && adev->pnp.type.platform_id && !addr &&
1365 pci_is_root_bus(pci_dev->bus))
1372 * pci_acpi_optimize_delay - optimize PCI D3 and D3cold delay from ACPI
1373 * @pdev: the PCI device whose delay is to be updated
1374 * @handle: ACPI handle of this device
1376 * Update the d3hot_delay and d3cold_delay of a PCI device from the ACPI _DSM
1377 * control method of either the device itself or the PCI host bridge.
1379 * Function 8, "Reset Delay," applies to the entire hierarchy below a PCI
1380 * host bridge. If it returns one, the OS may assume that all devices in
1381 * the hierarchy have already completed power-on reset delays.
1383 * Function 9, "Device Readiness Durations," applies only to the object
1384 * where it is located. It returns delay durations required after various
1385 * events if the device requires less time than the spec requires. Delays
1386 * from this function take precedence over the Reset Delay function.
1388 * These _DSM functions are defined by the draft ECN of January 28, 2014,
1389 * titled "ACPI additions for FW latency optimizations."
1391 static void pci_acpi_optimize_delay(struct pci_dev *pdev,
1394 struct pci_host_bridge *bridge = pci_find_host_bridge(pdev->bus);
1396 union acpi_object *obj, *elements;
1398 if (bridge->ignore_reset_delay)
1399 pdev->d3cold_delay = 0;
1401 obj = acpi_evaluate_dsm_typed(handle, &pci_acpi_dsm_guid, 3,
1402 DSM_PCI_DEVICE_READINESS_DURATIONS, NULL,
1407 if (obj->package.count == 5) {
1408 elements = obj->package.elements;
1409 if (elements[0].type == ACPI_TYPE_INTEGER) {
1410 value = (int)elements[0].integer.value / 1000;
1411 if (value < PCI_PM_D3COLD_WAIT)
1412 pdev->d3cold_delay = value;
1414 if (elements[3].type == ACPI_TYPE_INTEGER) {
1415 value = (int)elements[3].integer.value / 1000;
1416 if (value < PCI_PM_D3HOT_WAIT)
1417 pdev->d3hot_delay = value;
1423 static void pci_acpi_set_external_facing(struct pci_dev *dev)
1427 if (pci_pcie_type(dev) != PCI_EXP_TYPE_ROOT_PORT)
1429 if (device_property_read_u8(&dev->dev, "ExternalFacingPort", &val))
1433 * These root ports expose PCIe (including DMA) outside of the
1434 * system. Everything downstream from them is external.
1437 dev->external_facing = 1;
1440 void pci_acpi_setup(struct device *dev, struct acpi_device *adev)
1442 struct pci_dev *pci_dev = to_pci_dev(dev);
1444 pci_acpi_optimize_delay(pci_dev, adev->handle);
1445 pci_acpi_set_external_facing(pci_dev);
1446 pci_acpi_add_edr_notifier(pci_dev);
1448 pci_acpi_add_pm_notifier(adev, pci_dev);
1449 if (!adev->wakeup.flags.valid)
1452 device_set_wakeup_capable(dev, true);
1454 * For bridges that can do D3 we enable wake automatically (as
1455 * we do for the power management itself in that case). The
1456 * reason is that the bridge may have additional methods such as
1457 * _DSW that need to be called.
1459 if (pci_dev->bridge_d3)
1460 device_wakeup_enable(dev);
1462 acpi_pci_wakeup(pci_dev, false);
1463 acpi_device_power_add_dependent(adev, dev);
1465 if (pci_is_bridge(pci_dev))
1466 acpi_dev_power_up_children_with_adr(adev);
1469 void pci_acpi_cleanup(struct device *dev, struct acpi_device *adev)
1471 struct pci_dev *pci_dev = to_pci_dev(dev);
1473 pci_acpi_remove_edr_notifier(pci_dev);
1474 pci_acpi_remove_pm_notifier(adev);
1475 if (adev->wakeup.flags.valid) {
1476 acpi_device_power_remove_dependent(adev, dev);
1477 if (pci_dev->bridge_d3)
1478 device_wakeup_disable(dev);
1480 device_set_wakeup_capable(dev, false);
1484 static struct fwnode_handle *(*pci_msi_get_fwnode_cb)(struct device *dev);
1487 * pci_msi_register_fwnode_provider - Register callback to retrieve fwnode
1488 * @fn: Callback matching a device to a fwnode that identifies a PCI
1491 * This should be called by irqchip driver, which is the parent of
1492 * the MSI domain to provide callback interface to query fwnode.
1495 pci_msi_register_fwnode_provider(struct fwnode_handle *(*fn)(struct device *))
1497 pci_msi_get_fwnode_cb = fn;
1501 * pci_host_bridge_acpi_msi_domain - Retrieve MSI domain of a PCI host bridge
1502 * @bus: The PCI host bridge bus.
1504 * This function uses the callback function registered by
1505 * pci_msi_register_fwnode_provider() to retrieve the irq_domain with
1506 * type DOMAIN_BUS_PCI_MSI of the specified host bridge bus.
1507 * This returns NULL on error or when the domain is not found.
1509 struct irq_domain *pci_host_bridge_acpi_msi_domain(struct pci_bus *bus)
1511 struct fwnode_handle *fwnode;
1513 if (!pci_msi_get_fwnode_cb)
1516 fwnode = pci_msi_get_fwnode_cb(&bus->dev);
1520 return irq_find_matching_fwnode(fwnode, DOMAIN_BUS_PCI_MSI);
1523 static int __init acpi_pci_init(void)
1525 if (acpi_gbl_FADT.boot_flags & ACPI_FADT_NO_MSI) {
1526 pr_info("ACPI FADT declares the system doesn't support MSI, so disable it\n");
1530 if (acpi_gbl_FADT.boot_flags & ACPI_FADT_NO_ASPM) {
1531 pr_info("ACPI FADT declares the system doesn't support PCIe ASPM, so disable it\n");
1535 if (acpi_pci_disabled)
1538 acpi_pci_slot_init();
1543 arch_initcall(acpi_pci_init);