1*980309d9SYanteng Si.. SPDX-License-Identifier: GPL-2.0 2*980309d9SYanteng Si.. include:: ../disclaimer-zh_CN.rst 3*980309d9SYanteng Si 4*980309d9SYanteng Si:Original: Documentation/PCI/acpi-info.rst 5*980309d9SYanteng Si 6*980309d9SYanteng Si:翻译: 7*980309d9SYanteng Si 8*980309d9SYanteng Si 司延腾 Yanteng Si <siyanteng@loongson.cn> 9*980309d9SYanteng Si 10*980309d9SYanteng Si:校译: 11*980309d9SYanteng Si 12*980309d9SYanteng Si 13*980309d9SYanteng Si===================== 14*980309d9SYanteng SiPCI主桥的ACPI注意事项 15*980309d9SYanteng Si===================== 16*980309d9SYanteng Si 17*980309d9SYanteng Si一般的规则是，ACPI命名空间应该描述操作系统可能使用的所有东西，除非有其他方法让操作系 18*980309d9SYanteng Si统找到它[1, 2]。 19*980309d9SYanteng Si 20*980309d9SYanteng Si例如，没有标准的硬件机制来枚举PCI主桥，所以ACPI命名空间必须描述每个主桥、访问它 21*980309d9SYanteng Si下面的PCI配置空间的方法、主桥转发到PCI的地址空间窗口（使用_CRS）以及传统的INTx 22*980309d9SYanteng Si中断的路由（使用_PRT）。 23*980309d9SYanteng Si 24*980309d9SYanteng Si在主桥下面的PCI设备，通常不需要通过ACPI描述。操作系统可以通过标准的PCI枚举机制来 25*980309d9SYanteng Si发现它们，使用配置访问来发现和识别设备，并读取和测量它们的BAR。然而，如果ACPI为它们 26*980309d9SYanteng Si提供电源管理或热插拔功能，或者如果设备有由平台中断控制器连接的INTx中断，需要一个_PRT 27*980309d9SYanteng Si来描述这些连接，这种情况下ACPI可以描述PCI设备。 28*980309d9SYanteng Si 29*980309d9SYanteng SiACPI资源描述是通过ACPI命名空间中设备的_CRS对象完成的[2]。_CRS就像一个通用的PCI BAR： 30*980309d9SYanteng Si操作系统可以读取_CRS并找出正在消耗的资源，即使它没有该设备的驱动程序[3]。这一点很重要， 31*980309d9SYanteng Si因为它意味着一个旧的操作系统可以正确地工作，即使是在操作系统不知道的新设备的系统上。新设 32*980309d9SYanteng Si备可能什么都不做，但操作系统至少可以确保没有资源与它们冲突。 33*980309d9SYanteng Si 34*980309d9SYanteng Si像MCFG、HPET、ECDT等静态表，不是保留地址空间的机制。静态表是在操作系统在启动初期且在它 35*980309d9SYanteng Si能够解析ACPI命名空间之前需要知道的东西。如果定义了一个新的表，即使旧的操作系统忽略了这 36*980309d9SYanteng Si个表，它也需要正常运行。_CRS允许这样做，因为它是通用的，可以被旧的操作系统解析；而静态表 37*980309d9SYanteng Si则不允许。 38*980309d9SYanteng Si 39*980309d9SYanteng Si如果操作系统要管理一个通过ACPI描述的不可发现的设备，该设备将有一个特定的_HID/_CID，以 40*980309d9SYanteng Si告诉操作系统与之绑定的驱动程序，并且_CRS告诉操作系统和驱动程序该设备的寄存器在哪里。 41*980309d9SYanteng Si 42*980309d9SYanteng SiPCI主桥是PNP0A03或PNP0A08设备。它们的_CRS应该描述它们所消耗的所有地址空间。这包括它 43*980309d9SYanteng Si们转发到PCI总线上的所有窗口，以及不转发到PCI的主桥本身的寄存器。主桥的寄存器包括次要/下 44*980309d9SYanteng Si级总线寄存器，决定了桥下面的总线范围，窗口寄存器描述了桥洞，等等。这些都是设备相关的，非 45*980309d9SYanteng Si架构相关的东西，所以PNP0A03/PNP0A08驱动可以管理它们的唯一方法是通过_PRS/_CRS/_SRS， 46*980309d9SYanteng Si它包含了特定于设备的细节。主桥寄存器也包括ECAM空间，因为它是由主桥消耗的。 47*980309d9SYanteng Si 48*980309d9SYanteng SiACPI定义了一个Consumer/Producer位来区分桥寄存器（“Consumer”下文译作消费者）和 49*980309d9SYanteng Si桥洞（“Producer”下文译作生产者）[4, 5]，但是早期的BIOS没有正确使用这个位。其结果 50*980309d9SYanteng Si是，目前的ACPI规范只为扩展地址空间描述符定义了消费者/生产者；在旧的QWord/Word/Word地 51*980309d9SYanteng Si址空间描述符中，该位应该被忽略。因此，操作系统必须假定所有的QWord/Word/Word描述符都是 52*980309d9SYanteng Si窗口。 53*980309d9SYanteng Si 54*980309d9SYanteng Si在增加扩展地址空间描述符之前，消费者/生产者的失败意味着没有办法描述PNP0A03/PNP0A08设 55*980309d9SYanteng Si备本身的桥寄存器。解决办法是在PNP0C02捕捉器中描述桥寄存器（包括ECAM空间）[6]。 56*980309d9SYanteng Si除了ECAM之外，桥寄存器空间反正是特定于设备的，所以通用的PNP0A03/PNP0A08驱动程 57*980309d9SYanteng Si序(pci_root.c)没有必要了解它。 58*980309d9SYanteng Si 59*980309d9SYanteng Si新的架构应该能够在PNP0A03设备中使用“消费者”扩展地址空间描述符，用于桥寄存器，包括 60*980309d9SYanteng SiECAM，尽管对[6]的严格解释可能禁止这样做。旧的x86和ia64内核假定所有的地址空间描述 61*980309d9SYanteng Si符，包括“消费者”扩展地址空间的描述符，都是窗口，所以在这些架构上以这种方式描述桥寄 62*980309d9SYanteng Si存器是不安全的。 63*980309d9SYanteng Si 64*980309d9SYanteng SiPNP0C02“主板”设备基本上是万能的。除了“不要将这些资源用于其他用途”之外，没有其他的编 65*980309d9SYanteng Si程模型。因此，PNP0C02 _CRS应该声明ACPI命名空间中(1)没有被_CRS声明的任何其他设备对 66*980309d9SYanteng Si象的地址空间，(2)不应该被OS分配给其他东西。 67*980309d9SYanteng Si 68*980309d9SYanteng Si除非有一个标准的固件接口用于配置访问，例如ia64 SAL接口[7]，否则PCIe规范要求使用增强 69*980309d9SYanteng Si型配置访问方法（ECAM）。主桥消耗ECAM内存地址空间并将内存访问转换为PCI配置访问。该规范 70*980309d9SYanteng Si定义了ECAM地址空间的布局和功能；只有地址空间的基础是特定于设备的。ACPI操作系统从静态 71*980309d9SYanteng SiMCFG表或PNP0A03设备中的_CBA方法中了解基础地址。 72*980309d9SYanteng Si 73*980309d9SYanteng SiMCFG表必须描述非热插拔主桥的ECAM空间[8]。由于MCFG是一个静态表，不能通过热插拔更新， 74*980309d9SYanteng SiPNP0A03设备中的_CBA方法描述了可热插拔主桥的ECAM空间[9]。请注意，对于MCFG和_CBA， 75*980309d9SYanteng Si基址总是对应于总线0，即使桥器下面的总线范围（通过_CRS报告）不从0开始。 76*980309d9SYanteng Si 77*980309d9SYanteng Si 78*980309d9SYanteng Si[1] ACPI 6.2, sec 6.1: 79*980309d9SYanteng Si 对于任何在非枚举类型的总线上的设备（例如，ISA总线），OSPM会枚举设备的标识符，ACPI 80*980309d9SYanteng Si 系统固件必须为每个设备提供一个_HID对象...以使OSPM能够做到这一点。 81*980309d9SYanteng Si 82*980309d9SYanteng Si[2] ACPI 6.2, sec 3.7: 83*980309d9SYanteng Si 操作系统枚举主板设备时，只需通过读取ACPI命名空间来寻找具有硬件ID的设备。 84*980309d9SYanteng Si 85*980309d9SYanteng Si ACPI枚举的每个设备都包括ACPI命名空间中ACPI定义的对象，该对象报告设备可能占用的硬 86*980309d9SYanteng Si 件资源[_PRS]，报告设备当前使用的资源[_CRS]的对象，以及配置这些资源的对象[_SRS]。 87*980309d9SYanteng Si 这些信息被即插即用操作系统（OSPM）用来配置设备。 88*980309d9SYanteng Si 89*980309d9SYanteng Si[3] ACPI 6.2, sec 6.2: 90*980309d9SYanteng Si OSPM使用设备配置对象来配置通过ACPI列举的设备的硬件资源。设备配置对象提供了关于当前 91*980309d9SYanteng Si 和可能的资源需求的信息，共享资源之间的关系，以及配置硬件资源的方法。 92*980309d9SYanteng Si 93*980309d9SYanteng Si 当OSPM枚举一个设备时，它调用_PRS来确定该设备的资源需求。它也可以调用_CRS来找到该设 94*980309d9SYanteng Si 备的当前资源设置。利用这些信息，即插即用系统决定设备应该消耗什么资源，并通过调用设备 95*980309d9SYanteng Si 的_SRS控制方法来设置这些资源。 96*980309d9SYanteng Si 97*980309d9SYanteng Si 在ACPI中，设备可以消耗资源（例如，传统的键盘），提供资源（例如，一个专有的PCI桥）， 98*980309d9SYanteng Si 或者两者都做。除非另有规定，设备的资源被假定为来自设备层次结构中设备上方最近的匹配资 99*980309d9SYanteng Si 源。 100*980309d9SYanteng Si 101*980309d9SYanteng Si[4] ACPI 6.2, sec 6.4.3.5.1, 2, 3, 4: 102*980309d9SYanteng Si QWord/DWord/Word 地址空间描述符 (.1, .2, .3) 103*980309d9SYanteng Si 常规标志: Bit [0] 被忽略。 104*980309d9SYanteng Si 105*980309d9SYanteng Si 扩展地址空间描述符 (.4) 106*980309d9SYanteng Si 常规标志: Bit [0] 消费者/生产者: 107*980309d9SYanteng Si 108*980309d9SYanteng Si * 1 – 这个设备消费这个资源 109*980309d9SYanteng Si * 0 – 该设备生产和消费该资源 110*980309d9SYanteng Si 111*980309d9SYanteng Si[5] ACPI 6.2, sec 19.6.43: 112*980309d9SYanteng Si ResourceUsage指定内存范围是由这个设备（ResourceConsumer）消费还是传递给子设备 113*980309d9SYanteng Si （ResourceProducer）。如果没有指定，那么就假定是ResourceConsumer。 114*980309d9SYanteng Si 115*980309d9SYanteng Si[6] PCI Firmware 3.2, sec 4.1.2: 116*980309d9SYanteng Si 如果操作系统不能原生的懂得保留MMCFG区域，MMCFG区域必须由固件保留。在MCFG表中或通 117*980309d9SYanteng Si 过_CBA方法（见第4.1.3节）报告的地址范围必须通过声明主板资源来保留。对于大多数系统， 118*980309d9SYanteng Si 主板资源将出现在ACPI命名空间的根部（在_SB下），在一个节点的_HID为EISAID（PNP0C0 119*980309d9SYanteng Si 2），在这种情况下的资源不应该要求在根PCI总线的_CRS。这些资源可以选择在Int15 E820 120*980309d9SYanteng Si 或EFIGetMemoryMap中作为保留内存返回，但必须始终通过ACPI作为主板资源报告。 121*980309d9SYanteng Si 122*980309d9SYanteng Si[7] PCI Express 4.0, sec 7.2.2: 123*980309d9SYanteng Si 对于PC兼容的系统，或者没有实现允许访问配置空间的处理器架构特定固件接口标准的系统，需 124*980309d9SYanteng Si 要使用本节中定义的ECAM。 125*980309d9SYanteng Si 126*980309d9SYanteng Si[8] PCI Firmware 3.2, sec 4.1.2: 127*980309d9SYanteng Si MCFG表是一个ACPI表，用于沟通的基础地址对应的非热的可移动的PCI段组范围内的PCI段组在 128*980309d9SYanteng Si 启动时提供给操作系统。这对PC兼容系统来说是必需的。 129*980309d9SYanteng Si 130*980309d9SYanteng Si MCFG表仅用于沟通在启动时系统可用的PCI段组对应的基址。 131*980309d9SYanteng Si 132*980309d9SYanteng Si[9] PCI Firmware 3.2, sec 4.1.3: 133*980309d9SYanteng Si _CBA (Memory mapped Configuration Base Address) 控制方法是一个可选的ACPI对 134*980309d9SYanteng Si 象，用于返回热插拔主桥的64位内存映射的配置基址。_CBA 返回的基址是与处理器相关的地址。 135*980309d9SYanteng Si _CBA 控制方法被评估为一个整数。 136*980309d9SYanteng Si 137*980309d9SYanteng Si 这个控制方法出现在主桥对象下。当_CBA方法出现在一个活动的主桥对象下时，操作系统会评 138*980309d9SYanteng Si 估这个结构，以确定内存映射的配置基址，对应于_CRS方法中指定的总线编号范围的PCI段组。 139*980309d9SYanteng Si 一个包含_CBA方法的ACPI命名空间对象也必须包含一个相应的_SEG方法。 140