1. 课程导入

在服务器、嵌入式与操作系统底层开发领域，ACPI（Advanced Configuration and Power Interface，高级配置与电源接口）是连接固件与操作系统的关键桥梁。操作系统通过 ACPI 表获知平台的处理器拓扑、内存映射、中断路由、电源域、设备树替代信息以及热插拔能力。可以说，ACPI 表是平台硬件能力的“声明式契约”：固件负责如实描述，操作系统负责按描述驱动硬件。一旦表内容有误，轻则设备无法识别，重则系统无法启动或电源管理失效。

本课程《ACPI表定制开发实战》面向 BIOS/UEFI 固件工程师、BSP 移植工程师、Linux 内核与驱动开发者，以及需要做平台适配的系统软件人员。课程不满足于“读懂 ASL 语法”，而是围绕真实平台定制需求，从表结构、编译工具链、内核解析路径，到调试与量产验证，形成一条可落地的工程路线。

一、学习目标：从“看得懂”到“改得对、验得准”

完成本课程后，学习者应达到以下四个层次的目标：

• 结构层：能准确说出 RSDP、XSDT、DSDT、SSDT、FADT、MADT、SRAT、SLIT、PPTT、NFIT 等常见表的职责边界与相互引用关系。
• 语法层：能独立编写 ASL 代码，熟练使用 Name、Device、Method、Scope、OperationRegion、Field、_CRS、_DSM、_STA 等核心对象。
• 工具层：能使用 iasl 编译/反编译、acpidump/acpiexec 提取与模拟执行、dmesg 与 ACPICA debug 定位解析错误。
• 工程层：能针对多路 CPU、NUMA、PCIe 热插拔、GPIO/I2C 设备枚举等场景，设计并验证 SSDT 覆盖方案。

二、核心价值：为什么 ACPI 表定制不可替代

在 ARM 平台广泛使用 Device Tree 的今天，x86 与部分 ARM 服务器仍以 ACPI 为唯一标准启动路径。其价值体现在三方面：

1. 标准化枚举：操作系统无需为每块主板写专用驱动，只需按 ACPI 命名空间中的设备对象加载通用驱动。
2. 动态能力声明：通过 _DSM、_OST、_EJ0 等方法，平台可在运行时向 OS 报告热插拔、性能状态与错误恢复能力。
3. 电源与性能管理：C-State、P-State、D-State、S0ix 等低功耗特性均依赖 ACPI 表与 AML 方法协同完成。

因此，ACPI 表定制是平台差异化的“最后一公里”。同一颗 SoC，不同整机厂商通过 SSDT 覆盖即可实现不同的设备使能、GPIO 映射与电源时序，而无需修改内核。

三、整体知识框架与实战路线图

本课程共 30 章，知识框架可归纳为“一条主线、四个阶段”。主线是：需求 → 表设计 → ASL 实现 → 编译集成 → 内核验证 → 量产固化。四个阶段分别是基础认知、语法与工具、典型表定制、调试与量产。

下图给出本章专属的实战路线图，展示从平台需求到 ACPI 表交付的完整信号与数据流，以及各阶段的关键产物。

路线图强调闭环：需求分析决定表设计，表设计约束 ASL 实现，编译集成后必须回到内核验证，验证结果又反向修正需求与设计。量产固化阶段则把验证通过的 AML 与版本号绑定，防止后续改动引入回归。

四、典型场景：一张 SSDT 如何解决设备枚举问题

假设某服务器主板使用 ACPI 启动，但板载 I2C 触摸控制器未被操作系统识别。排查发现 DSDT 中缺少该设备的 Device 对象与 _CRS 资源描述。此时无需修改 DSDT，而是新增一张 SSDT 覆盖：

DefinitionBlock ("i2c_touch.aml", "SSDT", 2, "OEMID", "I2CTCH", 0x00000001)
{
    External (_SB_.PCI0.I2C0, DeviceObj)

    Scope (_SB_.PCI0.I2C0)
    {
        Device (TPAD)
        {
            Name (_HID, "MYTOUCH0001")
            Name (_UID, 0x01)
            Method (_CRS, 0, NotSerialized)
            {
                Name (RBUF, ResourceTemplate ()
                {
                    I2cSerialBus (0x002C, ControllerInitiated, 0x00061A80,
                                  AddressingMode7Bit, "\\_SB.PCI0.I2C0",
                                  0x00, ResourceConsumer, ,)
                    GpioInt (Edge, ActiveLow, ExclusiveAndWake, PullUp, 0x0000,
                             "\\_SB.GPI0", 0x00, ResourceConsumer, ,)
                })
                Return (RBUF)
            }
        }
    }
}

编译后通过固件更新机制加载，内核启动时即可在 /sys/bus/i2c/devices 下看到对应设备，并自动匹配驱动。这个案例说明：ACPI 表定制的核心是“用最小的表改动，精确表达硬件事实”。

五、常见误区与复盘要点

复盘时应建立检查清单：表头校验和是否正确、OEM ID 与版本是否规范、命名空间是否唯一、资源描述是否与原理图一致、_STA 返回值是否符合预期、热插拔方法是否完整。下表给出本章建议的入门检查清单。