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.2.30. 平台健康评估表 (PHAT)

本节介绍平台运行状况评估表 (PHAT) 的格式,它提供了一种方法,平台可以通过该方法公开一组可扩展的平台运行状况相关遥测数据,这对于在操作系统限制内运行的软件可能很有用。这些元素通常包含在OS运行时阶段可能无法枚举的内容,例如OS之前组件的版本,或者在OS启动之前由平台执行的固件驱动程序的运行状况。预计OSPM不会对暴露的数据产生作用。

表 5.142 平台健康评估表 (PHAT) 格式 字段字节长度字节偏移描述
标题
- 签名40PHAT 平台健康评估表签名。
- 长度44整个PHAT 的表长度(以字节为单位)
- 修订18与该表的签名字段相对应的结构的修订版。对于确认该规范修订版的PHAT,修订版为1。
- 校验和19整个表(包括校验和字段)必须加为零才能被视为有效。
- OEMID61010 OEM 提供的字符串,用于标识 OEM。
- OEM 表 ID81616 OEM 提供的字符串,OEM 用于标识此特定数据表
- OEM 修订424OEM-提供的修订号。
- 创建者ID42828创建此表的实用程序的供应商ID。
- 创建者修订43232创建此表的实用程序的修订版。
平台遥测记录–3636平台遥测记录集

5.2.30.1. 平台健康评估记录格式

平台健康评估记录由包含记录类型和长度的子标头以及一组数据组成。记录布局的格式特定于记录类型。以这种方式,记录的大小仅与包含要传送的特定类型的数据所需的大小相同。

表 5.143 平台健康评估记录格式 字段字节长度字节偏移描述
平台健康评估记录类型20该值描述了平台健康评估记录的格式和内容。
记录长度22该值描述了平台运行状况评估记录的长度(以字节为单位)。
修订14如果扩展记录类型的格式,则更新该值。对平台健康评估记录布局的任何更改都必须向后兼容,因为所有先前定义的字段如果仍然适用,则必须保留,但新定义的字段允许增加平台健康记录的长度。以前定义的记录字段不得重新定义,但允许废弃。
数据–5该字段的内容由平台健康评估记录类型定义定义。

5.2.30.2. 平台健康评估记录类型格式

下表描述了PHAT中包含的各种类型的记录及其关联的平台运行状况评估记录类型。请注意,除非另有说明,对于给定类型,PHAT中允许有多个平台遥测记录。

表 5.144 平台健康评估记录类型格式 记录类型值类型描述
0x00000x0000固件版本数据记录OS之前的平台运行状况评估记录,包含平台固件、选项 ROM 和其他OS之前的平台组件内组件的版本数据。
0x00010x0001固件健康数据记录OS之前的平台健康评估记录包含OS之前的平台组件的健康相关信息。
0x0002 – 0x0FFF0x0002 – 0x0FFF 保留保留供ACPI规范使用。
0x1000 – 0x1FFF0x1000 – 0x1FFF 保留保留供平台供应商使用。
0x2000 – 0x2FFF0x2000 – 0x2FFF 保留保留供硬件供应商使用。
0x3000 – 0x3FFF0x3000 – 0x3FFF 保留保留供平台固件供应商使用。
0x4000 – 0x4FFF0x4000 – 0x4FFF 保留保留以供将来使用。

5.2.30.3. 固件版本数据记录结构

平台健康评估记录,其中包含与平台中OS之前的组件关联的版本相关信息。

表 5.145 PHAT 版本元素 字段字节长度字节偏移描述
组件ID1616 0与该组件关联的唯一GUID。
版本值81616 64 位版本值
制作人ID424ACPI 供应商 ID(例如“ABCD”): 0xFFFF – 未定义 ID 0x0000 – 无效值
表 5.146 固件版本数据记录 字段字节长度字节偏移描述
------------
平台记录类型200 – 固件版本数据记录
记录长度2212+28*RecordCount – 该值描述版本数据记录的长度(以字节为单位)。
修订141 – 本固件版本数据记录的修订。
保留35保留
记录数48PHAT 版本元素计数
PHAT 版本元素变化1212 PHAT版本元素数组。第一个条目是组件的原始生产者,如果有后续条目,则意味着第二个代理以某种方式修改了原始组件,无论最后一个条目是什么,它都是该组件当前运行的实例。这允许IHV/IBV/OEM/其他建立与给定组件关联的数据记录链。

5.2.30.4. 固件健康数据记录结构

平台健康评估记录,其中包含与平台中OS之前的组件相关的健康相关信息。该结构旨在用于以通用方式识别OS之前组件的准系统状态。此外,设备路径可以给出平台在OS之前的位置的标准化提示,无论它是众所周知的硬件节点(例如存储控制器)还是可能挂在另一条总线上的其他供应商特定位置。

这种结构还提供了一种方法,平台可以通过该方法公开设备特定的数据,而不仅仅是简单的健康和不健康声明。

表 5.147 固件健康数据记录结构 字段字节长度字节偏移描述
平台记录类型201 – 固件健康数据记录
记录长度22变化 – 该值描述健康数据记录的长度(以字节为单位)。
修订141 – 修订本固件健康数据记录。
保留25保留
健康17设备是否遇到任何问题?这允许解析此记录的任何代理了解设备是否健康,而无需解析特定于设备的健康数据。任何设备运行状况都可能会暴露设备特定的数据: 0= 发现错误 1= 未发现错误 2= 未知 3= 建议 – 暴露其他设备特定数据
设备签名1616 8与该设备关联的唯一GUID。
设备特定的数据偏移424从该数据记录开始到设备特定数据的偏移量。如果为 0,则没有设备特定数据。
设备路径变化2828与唱片制作人关联的UEFI设备路径。有关EFI_DEVICE_PATH_PROTOCOL定义,请参阅UEFI规范。
设备特定数据变化设备特定的数据偏移与特定设备关联的健康记录。它的定义特定于生成该记录的给定设备。
Prev
5.2.29. 处理器属性拓扑表 (PPTT)