ACPI 中文文档ACPI 中文文档
首页
第 1 章
第 2 章
第 3 章
第 4 章
第 5 章
第 6 章
第 7 章
第 8 章
第 9 章
第 10 章
第 11 章
第 12 章
第 13 章
第 14 章
第 15 章
第 16 章
第 17 章
第 18 章
第 19 章
第 20 章
第 21 章
附录 A
首页
第 1 章
第 2 章
第 3 章
第 4 章
第 5 章
第 6 章
第 7 章
第 8 章
第 9 章
第 10 章
第 11 章
第 12 章
第 13 章
第 14 章
第 15 章
第 16 章
第 17 章
第 18 章
第 19 章
第 20 章
第 21 章
附录 A
  • 第 5 章

    • 总览
    • 5.1. 系统描述表架构概述
    • 5.2. ACPI 系统描述表
      • 5.2.1. 保留位和字段
      • 5.2.2. 兼容性
      • 5.2.3. 地址格式
      • 5.2.4. 通用唯一标识符 (UUID)
      • 5.2.5. 根系统描述指针 (RSDP)
      • 5.2.6. 系统描述表头
      • 5.2.7. 根系统描述表 (RSDT)
      • 5.2.8. 扩展系统描述表 (XSDT)
      • 5.2.9. 固定 ACPI 描述表 (FADT)
      • 5.2.10. 固件 ACPI 控制结构 (FACS)
      • 5.2.11. 定义块
      • 5.2.12. 多个APIC描述表(MADT)
      • 5.2.13. 全局系统中断
      • 5.2.14. 智能电池表 (SBST)
      • 5.2.15. 嵌入式控制器启动资源表 (ECDT)
      • 5.2.16. 系统资源关联表 (SRAT)
      • 5.2.17. 系统局部性信息表 (SLIT)
      • 5.2.18. 更正平台错误轮询表 (CPEP)
      • 5.2.19. 最大系统特性表 (MSCT)
      • 5.2.20. ACPI RAS 功能表 (RASF)
      • 5.2.21. 内存电源状态表 (MPST)
      • 5.2.22. 启动图形资源表 (BGRT)
      • 5.2.23. 固件性能数据表 (FPDT)
      • 5.2.24. 通用定时器描述表 (GTDT)
      • 5.2.25. NVDIMM 固件接口表 (NFIT)
      • 5.2.26. 安全设备 (SDEV) ACPI 表
      • 5.2.27. 异构内存属性表(HMAT)
      • 5.2.28. 平台调试触发器表 (PDTT)
      • 5.2.29. 处理器属性拓扑表 (PPTT)
      • 5.2.30. 平台健康评估表 (PHAT)
    • 5.3. ACPI 命名空间
    • 5.4. 定义块编码
    • 5.5. 控制方法和 ACPI 源语言 (ASL)
      • 5.5.1. ASL 报表
      • 5.5.2. 控制方法执行
        • 5.5.2.1. 论点
        • 5.5.2.2. 方法调用约定
        • 5.5.2.3. 局部变量和本地创建的数据对象
        • 5.5.2.4. 进入运营区域
          • 5.5.2.4.1. 运营地区
          • 5.5.2.4.2. CMOS 协议
          • 5.5.2.4.3. PCI 设备 BAR 目标协议
          • 5.5.2.4.4. 声明IPMI运营区域
          • 5.5.2.4.5. 声明 GeneralPurposeIO 操作区域
          • 5.5.2.4.6. 声明 GenericSerialBus 操作区域
            • 5.5.2.4.6.1. 声明 GenericSerialBus 字段
            • 5.5.2.4.6.2. 声明和使用 GenericSerialBus 数据缓冲区
            • 5.5.2.4.6.3. 使用通用串行总线协议
          • 5.5.2.4.7. 声明PCC运营区域
    • 5.6. ACPI 事件编程模型
      • 5.6.1. ACPI 事件编程模型组件
      • 5.6.2. ACPI 事件类型
      • 5.6.3. 固定事件处理
      • 5.6.4. 通用事件处理
      • 5.6.5. GPIO 信号 ACPI 事件
      • 5.6.6. 设备对象通知
      • 5.6.7. 设备类特定对象
      • 5.6.8. 对象、方法和资源的预定义ACPI名称
      • 5.6.9. 中断信号ACPI事件
      • 5.6.10. 使用设备 _PRW 对象管理唤醒事件
    • 5.7. 预定义对象
    • 5.8. 系统配置对象

5.6.8. 对象、方法和资源的预定义ACPI名称

下表总结了本规范中定义的ACPI命名空间对象、控制方法和资源描述符字段的预定义名称。为每个名称提供了简短的描述以及对名称实际定义的节号和页码的引用。 ACPI 由其他规范预定义的名称也与其相应的规范参考一起列出。

注意事项

所有以下划线开头的名称均保留仅供ACPI使用。

表 5.173 预定义 ACPI 名称 名称描述
_ACx主动冷却,返回主动冷却策略的阈值。
_ADR地址:(1) 返回设备在其父总线上的地址。(2) 返回显示输出设备的唯一 ID。(3) 资源描述符字段。
_AEI指定那些应由 OSPM 作为 ACPI 事件处理的 GPIO 中断。
_ALC环境光色度,返回环境光的颜色色度。
_ALI环境光照度,返回环境光亮度。
_ALN对齐,基本对齐,资源描述符字段。
_ALP环境光轮询,返回环境光传感器的轮询频率。
_ALR环境光响应,返回环境光亮度到显示亮度的映射。
_ALT环境光温度,返回环境光的色温。
_ALx主动列表,返回主动散热设备对象列表。
_ART主动冷却关系表,返回平台设备与风扇设备之间的热关系信息。
_ASI地址空间 ID,资源描述符字段。
_ASZ访问大小,资源描述符字段。
_ATT类型专用属性,资源描述符字段。
_BAS基地址,范围基地址,资源描述符字段。
_BBNBIOS 总线编号,返回平台固件返回的 PCI 总线编号。
_BCL亮度控制级别,返回受支持的亮度控制级别列表。
_BCM亮度控制方法,设置显示设备的亮度级别。
_BCT电池充电时间,返回电池完成充电所需的剩余时间。
_BDNBIOS 扩展坞名称,返回平台固件返回的 Dock ID。
_BIF电池信息,返回控制方法电池信息块。
_BIX扩展电池信息,返回控制方法电池扩展信息块。
_BLT电池电量阈值,设置电池电量阈值首选项。
_BM总线主控,资源描述符字段。
_BMA电池测量平均间隔,设置电池测量平均间隔。
_BMC电池维护控制,设置电池维护和控制功能。
_BMD电池维护数据,返回电池维护、控制和状态数据。
_BMS电池测量采样时间,设置电池测量采样时间。
_BPC电池供电特性。
_BPS电池供电状态。
_BPT电池供电阈值。
_BQC当前亮度查询,返回当前显示亮度级别。
_BST电池状态,返回控制方法电池状态块。
_BTH电池节流限制,指定固件在进行充电时对电池施加的热节流限制。
_BTM电池时间,返回电池运行时间。
_BTP电池跳变点,设置控制方法电池跳变点。
_CBA配置基地址,返回与 PCI Express 或 Compute Express Link 主机总线的增强配置访问机制对应的 MMIO 范围基地址。_CBA 对象的完整说明位于 PCI Firmware Specification 中。对该规范的引用可在“ACPI 相关文档链接”(http://uefi.org/acpi) 里 “PCI SIG” 标题下找到。
_CBRCXL 主机桥寄存器信息。
_CCA缓存一致性属性,指定设备及其后代是否支持硬件管理的缓存一致性。
_CDM时钟域,返回逻辑处理器的时钟域标识符。
_CID兼容 ID,返回设备的即插即用兼容 ID 列表。
_CLS类代码,向 OSPM 提供 PCI 定义的类、子类和设备编程接口。可选。
_CPC连续性能控制,声明一个接口,允许 OSPM 基于连续的允许值范围将处理器切换到某个性能状态。
_CRS当前资源设置,返回设备的当前资源设置。
_CRT临界温度,返回关机临界温度。
_CSDC 状态依赖关系,返回 C 状态依赖关系列表。
_CSTC 状态,返回受支持的 C 状态列表。
_CWS清除唤醒状态,清除时间和警报控制方法设备的唤醒状态。
_DBT去抖超时,GPIO 输入连接的去抖超时设置,资源描述符字段。
_DCK扩展坞,设置对接隔离。存在该对象表示该设备是扩展坞。
_DCS显示当前状态,返回显示输出设备的状态。
_DDC当前显示数据,返回显示输出设备的 EDID。
_DDNDOS 设备名称,返回设备逻辑名称。
_DEC解码,设备解码类型,资源描述符字段。
_DEP操作区域依赖关系,求值结果为一个包,并指定由于后续操作区域访问而应在启动顺序中被 OSPM 提高优先级的设备对象。
_DGS显示图形状态,返回输出设备的当前状态。
_DIS禁用,禁用设备。
_DLM设备锁互斥体,指定某个互斥体为设备锁。
_DMA直接内存访问,返回设备当前用于 DMA 事务的资源。
_DOD显示输出设备,枚举连接到显示适配器的所有设备。
_DOS禁用输出切换,设置显示输出切换模式。
_DPL设备选择极性,SPI SerialBus 连接上的设备选择信号极性,资源描述符字段。
_DRS驱动强度,GPIO 输出连接的驱动强度设置,资源描述符字段。
_DSD设备专用数据,返回设备专用信息。
_DSM设备专用方法,执行设备专用功能。
_DSS设备设置状态,设置显示设备状态。
_DSW设备睡眠唤醒,设置设备的睡眠和唤醒转换状态。
_DTI设备温度指示,将原生设备温度传递给平台。
_Exx边沿 GPE,作为通用事件结果执行的方法。
_EC嵌入式控制器,返回 EC 偏移和查询信息。
_EDL可弹出设备列表,返回依赖于某个设备(对接)的设备列表。
_EJD弹出依赖设备,返回依赖设备(父设备,对接)的名称。
_EJx弹出,发起或取消设备弹出请求(对接)。
_END字节序,UART SerialBus 连接的字节序方向,资源描述符字段。
_EVT事件方法,用于编号大于 255 的 GPIO 事件的方法。
_FDE软盘枚举,返回软盘配置信息。
_FDI软盘驱动器信息,返回软盘驱动器信息块。
_FDM软盘驱动器模式,设置软盘驱动器速度。
_FIF风扇信息,返回风扇设备信息。
_FIT固件接口表,返回 NFIT 结构列表。
_FIX固定寄存器资源提供者,返回实现 FADT 寄存器块的设备列表。
_FLC流量控制,UART SerialBus 连接的流量控制机制,资源描述符字段。
_FPS风扇性能状态,返回受支持的风扇性能状态列表。
_FSL风扇设置级别,用于设置风扇设备转速级别(性能状态)的控制方法。
_FST风扇状态,返回风扇设备的当前状态信息。
_GAI获取平均间隔,返回功率计平均间隔。
_GCP获取能力,返回时间和警报控制方法设备的能力。
_GHL获取硬件限制,返回功率计强制执行的硬件限制。
_GL全局锁,OS 定义的全局锁互斥对象。
_GLK全局锁,返回设备访问所需的全局锁要求。
_GPD获取 POST 数据,返回启动时将被 POST 的 VGA 设备值。
_GPE通用事件:(1) 预定义作用域 _GPE。(2) 返回与嵌入式控制器关联的 SCI 中断。
_GRA粒度,地址空间粒度,资源描述符字段。
_GRT获取实时时间,从时间和警报控制方法设备返回当前时间。
_GSB全局系统中断基值,返回 I/O APIC 设备的 GSB。
_GTF获取任务文件,返回一组 ATA 命令,以将驱动器恢复到默认状态。
_GTM获取时序模式,返回 IDE 控制器时序信息列表。
_GWS获取唤醒状态,获取时间和警报控制方法设备的唤醒状态。
_HE高电平边沿,中断触发方式,资源描述符字段。
_HID硬件 ID,返回设备的即插即用硬件 ID。
_HMA异构内存属性,返回 HMAT 结构列表。
_HOT高温阈值,返回进入 S4 睡眠的临界温度。
_HPP热插拔参数,返回 PCI 设备的热插拔信息列表。
_HPX热插拔参数扩展,返回 PCI 设备的热插拔信息列表,取代 _HPP。
_HRV硬件版本,向 OSPM 提供设备的硬件版本。可选。
_IFTIPMI 接口类型。请参阅“ACPI 相关文档链接”(http://uefi.org/acpi) 中 “Server Platform Management Interface Table” 标题下的 Intelligent Platform Management Interface Specification。
_INI初始化,执行设备专用初始化。
_INT中断,中断屏蔽位,资源描述符字段。
_IORIO 限制,GPIO IO 连接的 IO 限制设置,资源描述符字段。
_IRC浪涌电流,存在该对象表示设备具有显著的浪涌电流需求。
_Lxx电平 GPE,作为通用事件结果执行的控制方法。
_LCK锁定,锁定或解锁设备(对接)。
_LEN长度,范围长度,资源描述符字段。
_LID盖子,返回移动系统上盖的打开/关闭状态。
_LIN使用中的线路,UART SerialBus 连接中使用的握手线路,资源描述符字段。
_LL低电平,中断极性,资源描述符字段。
_LPI低功耗空闲状态,返回处理器或处理器容器支持的低功耗空闲状态列表。
_LSI标签存储信息,返回与 NVDIMM 对象关联的标签存储区信息,包括其大小。
_LSR标签存储读取,从 NVDIMM 对象的标签存储区返回标签数据。
_LSW标签存储写入,将标签数据写入 NVDIMM 对象的标签存储区。
_MAF最大地址固定,资源描述符字段。
_MAT多 APIC 表项,返回中断控制器结构列表。
_MAX最大基地址,资源描述符字段。
_MBM内存带宽监控数据,返回内存设备的带宽监控数据。
_MEM内存属性,资源描述符字段。
_MIF最小地址固定,资源描述符字段。
_MIN最小基地址,资源描述符字段。
_MLS多语言字符串,返回设备的多语言描述。
_MOD模式,资源描述符字段。
_MSG消息,设置系统消息等待状态指示器。
_MSM内存监控设置,设置内存设备的带宽监控参数。
_MTL最小节流限制,返回特定热对象的最小节流限制。
_MTP内存类型,资源描述符字段。
_NTT通知温度阈值,返回需要平台通知的设备温度变化阈值。
_OFF关闭,将电源资源设置为关闭状态。
_ON开启,将电源资源设置为开启状态。
_OS操作系统,返回标识操作系统的字符串。
_OSC操作系统能力,向 AML 通知主机特性和能力。
_OSI操作系统接口,返回受支持的接口、行为和功能。
_OSTOSPM 状态指示,向 AML 通知事件处理状态。
_PAI功率平均间隔,设置功率计的平均间隔。
_PAR奇偶校验,UART SerialBus 连接的奇偶校验设置,资源描述符字段。
_PCL用电设备列表,返回由某个电源供电的设备列表。
_PCT性能控制,返回处理器性能控制和状态寄存器。
_PDC处理器驱动能力,向 AML 通知处理器驱动的能力。
_PDLP 状态深度限制,返回最低可用性能 P 状态。
_PHA时钟相位,SPI SerialBus 连接的时钟相位,资源描述符字段。
_PICPIC,向 AML 通知当前使用的中断模型。
_PIF电源信息,返回电源信息块。
_PIN引脚列表,所描述的 GPIO 引脚列表,资源描述符字段。
_PLD设备的物理位置,返回设备的物理位置信息。
_PMC功率计能力,返回功率计能力信息列表。
_PMD功率计量设备,返回由功率计设备测量的设备列表。
_PMM功率计测量值,返回功率计当前值。
_POL极性,资源描述符字段。
_PPC当前性能能力,返回平台当前支持的性能状态列表。
_PPE平台错误轮询,返回检索已更正平台错误信息的轮询间隔。
_PPI引脚配置,GPIO 连接的引脚配置,资源描述符字段。
_PR处理器,处理器对象的预定义作用域。
_PR0D0 的电源资源,返回设备进入 D0(完全开启)状态所依赖的电源资源列表。
_PR1D1 的电源资源,返回设备进入 D1 状态所依赖的电源资源列表。
_PR2D2 的电源资源,返回设备进入 D2 状态所依赖的电源资源列表。
_PR3D3hot 的电源资源,返回设备进入 D3hot 状态所依赖的电源资源列表。
_PRE枚举用电源资源,返回在总线上枚举设备时所依赖的电源资源列表。
_PRL电源冗余列表,返回处于同一冗余分组中的电源设备列表。
_PRR复位用电源资源,对关联的一个或多个设备执行复位。
_PRS可能的资源设置,返回设备可能的资源设置列表。
_PRTPCI 路由表,返回 PCI 中断映射列表。
_PRW唤醒用电源资源,返回用于唤醒的相关电源资源列表。
_PS0电源状态 0,将设备电源状态设置为 D0(设备完全开启)。
_PS1电源状态 1,将设备电源状态设置为 D1。
_PS2电源状态 2,将设备电源状态设置为 D2。
_PS3电源状态 3,将设备电源状态设置为 D3(设备关闭)。
_PSC当前电源状态,返回设备当前的电源状态。
_PSD电源状态依赖关系,返回处理器 P 状态依赖关系。
_PSE枚举用电源状态。
_PSL被动列表,返回被动散热设备对象列表。
_PSR电源,返回当前正在使用的电源设备。
_PSS受支持的性能状态,返回受支持的处理器性能状态列表。
_PSV被动阈值,返回被动跳变点温度。
_PSW电源状态唤醒,设置设备的唤醒功能。
_PTC处理器节流控制,返回节流控制和状态寄存器。
_PTP功率跳变点,设置功率计设备的跳变点。
_PTS准备进入睡眠,通知平台即将发生睡眠转换。
_PUR处理器利用率请求,返回平台希望置为空闲的处理器数量。
_PXM邻近域,返回设备的邻近域标识符。
_Qxx查询,嵌入式控制器查询和 SMBus 警报控制方法。
_RBO寄存器位偏移,资源描述符字段。
_RBW寄存器位宽,资源描述符字段。
_RDI空闲状态资源依赖关系,返回系统级低功耗空闲状态的电源资源依赖列表。
_REG区域,向 AML 代码通知操作区域可用性发生变化。
_REV修订版,返回已实现的 ACPI 规范修订版本。
_RMV可移除,返回设备的可移除能力状态(对接)。
_RNG范围,内存范围类型,资源描述符字段。
_ROM只读存储器,返回显示设备 ROM 数据的副本。
_RST设备复位,对关联的一个或多个设备执行复位。
_RT资源类型,资源描述符字段。
_RTV相对温度值,返回温度值信息。
_RW读写状态,资源描述符字段。
_RXL接收缓冲区大小,UART SerialBus 连接中的接收缓冲区大小,资源描述符字段。
_S0S0 系统状态,返回使系统进入 S0 状态所需的值。
_S1S1 系统状态,返回使系统进入 S1 状态所需的值。
_S2S2 系统状态,返回使系统进入 S2 状态所需的值。
_S3S3 系统状态,返回使系统进入 S3 状态所需的值。
_S4S4 系统状态,返回使系统进入 S4 状态所需的值。
_S5S5 系统状态,返回使系统进入 S5 状态所需的值。
_S1DS1 设备状态,返回设备在 S1 状态下支持的最高 D 状态。
_S2DS2 设备状态,返回设备在 S2 状态下支持的最高 D 状态。
_S3DS3 设备状态,返回设备在 S3 状态下支持的最高 D 状态。
_S4DS4 设备状态,返回设备在 S4 状态下支持的最高 D 状态。
_S0WS0 设备唤醒状态,返回设备能够从 S0 自行唤醒的最低 D 状态。
_S1WS1 设备唤醒状态,返回该设备可从 S1 唤醒系统的最低 D 状态。
_S2WS2 设备唤醒状态,返回该设备可从 S2 唤醒系统的最低 D 状态。
_S3WS3 设备唤醒状态,返回该设备可从 S3 唤醒系统的最低 D 状态。
_S4WS4 设备唤醒状态,返回该设备可从 S4 唤醒系统的最低 D 状态。
_SB系统总线,设备和总线对象的作用域。
_SBS智能电池子系统,返回子系统配置。
_SCP设置冷却策略,设置冷却策略(主动或被动)。
_SDD设置设备数据,设置 SATA 设备的数据。
_SEG段,返回设备的 PCI Segment Group 编号。
_SHL设置硬件限制,设置功率计强制执行的硬件限制。
_SHR可共享,中断共享状态,资源描述符字段。
_SI系统指示器,预定义作用域。
_SIZ大小,DMA 传输大小,资源描述符字段。
_SLI系统局部性信息,返回 NUMA 系统局部性列表。
_SLV从模式,SerialBus 连接的从模式设置,资源描述符字段。
_SPD设置 POST 设备,设置启动时要进行 POST 的视频设备。
_SPE连接速度,SerialBus 连接的连接速度,资源描述符字段。
_SRS设置资源,设置设备的资源分配。
_SRT设置实时时间,将当前时间设置到时间和警报控制方法设备。
_SRVIPMI 规范修订版本。请参阅“ACPI 相关文档链接”(http://uefi.org/acpi) 中 “Server Platform Management Interface Table” 标题下的 Intelligent Platform Management Interface Specification。
_SST系统状态,设置系统状态指示器。
_STA状态:(1) 返回设备当前状态。(2) 返回电源资源当前的开启或关闭状态。
_STB停止位,UART SerialBus 连接中使用的停止位数量,资源描述符字段。
_STM设置时序模式,设置 IDE 控制器的传输时序。
_STP设置定时器到期唤醒策略,设置唤醒警报设备的定时器到期策略。
_STR字符串,返回设备的描述字符串。
_STV设置定时器值,设置唤醒警报设备的定时器值。
_SUB向 OSPM 提供设备的子系统 ID。可选。
_SUN插槽用户编号,返回插槽的唯一 ID 编号。
_SWS系统唤醒源,返回导致系统唤醒的源事件。
_T_x临时,保留供 ASL 编译器使用。
_TC1热常数 1,返回被动冷却公式中的 TC1。
_TC2热常数 2,返回被动冷却公式中的 TC2。
_TDLT 状态深度限制,返回最低功耗节流状态对应的 _TSS 条目编号。
_TFP热快速采样周期,返回被动冷却的热采样周期。
_TIP定时器到期唤醒策略,返回唤醒警报设备的定时器策略。
_TIV定时器值,返回唤醒警报设备的剩余时间。
_TMP温度,返回热区当前温度。
_TPC当前节流能力,返回当前受支持的节流状态数量。
_TPT跳变点温度,通知 AML 某设备的内置温度传感器已越过某个温度跳变点。
_TRA转换,地址转换偏移,资源描述符字段。
_TRS稀疏转换,稀疏/密集标志,资源描述符字段。
_TRT热关系表,返回平台设备之间的热关系。
_TSD节流状态依赖关系,返回 T 状态依赖关系列表。
_TSF类型专用标志,资源描述符字段。
_TSN热传感器设备,返回报告某热区温度的热传感器引用。
_TSP热采样周期,返回被动冷却的热采样周期。
_TSS受支持的节流状态,返回受支持的节流状态信息。
_TST温度传感器阈值,返回设备温度跳变点之间的最小间隔。
_TTP转换类型,转换/静态标志,资源描述符字段。
_TTS转换到状态,向 AML 通知一次 S 状态转换。
_TXL发送缓冲区大小,UART SerialBus 连接中的发送缓冲区大小,资源描述符字段。
_TYP类型,DMA 通道类型(速度),资源描述符字段。
_TZ热区,预定义作用域:ACPI 1.0。
_TZD热区设备,返回与热区关联的设备名称列表。
_TZM热区成员,返回设备所属热区的引用。
_TZP热区轮询,返回热区的轮询频率。
_UID唯一 ID,返回设备唯一的持久 ID。
_UPCUSB 端口能力,返回 USB 端口能力列表。
_UPD用户存在检测,返回用户检测信息。
_UPP用户存在轮询,返回建议的用户存在轮询间隔。
_VEN供应商定义数据,GPIO 或 SerialBus 连接的供应商定义数据,资源描述符字段。
_VPO视频 POST 选项,返回已实现的视频 POST 选项。
_WAK唤醒,通知 AML 系统刚刚被唤醒。
_WPC无线供电校准,返回无线供电控制器的通知器。
_WPP无线供电轮询,返回建议的轮询频率。
_Wxx唤醒事件,作为唤醒事件结果执行的方法。
Prev
5.6.7. 设备类特定对象
Next
5.6.9. 中断信号ACPI事件