3. ACPI命名空间：设备路径命名规则、作用域与对象规范

ACPI命名空间（Namespace）是嵌入式设备电源管理与硬件拓扑描述的核心数据结构。它采用树形层次结构，将系统中的所有设备、电源资源、热区、处理器等抽象为命名对象。理解命名空间的构建规则、作用域划分与对象命名规范，是进行ACPI表编写、设备路径调试与电源集成优化的基础。

3.1 命名空间树形结构与绝对路径

ACPI命名空间从根节点“\”开始，向下逐级展开。每个节点（对象）的名称由父级作用域和本地名称组合而成，形成类似文件系统的路径表示。路径分隔符为“\”或“.”，其中“\”表示绝对路径起始，“.”用于分隔作用域层级。

// 命名空间路径示例
\_SB_.PCI0.I2C1.TPM0        // 绝对路径：根 -> 系统总线 -> PCI0 -> I2C1 -> TPM设备
\_SB_.PCI0.GPIO0            // 绝对路径：根 -> 系统总线 -> PCI0 -> GPIO控制器
\_PR_.CPU0                  // 绝对路径：根 -> 处理器作用域 -> CPU0

3.2 核心作用域：\_SB、\_PR、\_TZ 与 \_GPE

ACPI规范预定义了若干顶级作用域（Scope），用于组织不同类型的系统资源。嵌入式开发中最常接触的是以下四个作用域：

3.3 ACPI对象命名规范

ACPI对象命名遵循严格的4字符规则，同时区分“预定义对象”与“用户定义对象”。预定义对象以下划线“_”开头，由ACPI规范定义其含义与行为；用户定义对象由OEM或开发者自行命名，不能以下划线开头。

3.3.1 预定义对象（Method & Control Method）

预定义对象是ACPI规范中固定名称的方法或控制方法，用于向OSPM（操作系统电源管理）暴露设备能力。以下为嵌入式设备中最常用的预定义对象：

3.3.2 用户定义对象命名规则

用户定义对象（如设备实例、自定义方法、数据包）必须遵循以下规范：

• 名称长度： 固定4个字符，不足部分用下划线“_”补齐（例如“TPM0”实际存储为“TPM_”）。
• 首字符： 不能以下划线开头（下划线开头为ACPI规范保留）。
• 允许字符： 大写字母A-Z、数字0-9、下划线“_”。
• 命名建议： 使用设备类型缩写+序号，如“I2C0”、“UART1”、“GPIO0”、“PMIC0”。
• 避免冲突： 同一作用域内名称必须唯一，不能与预定义对象重名。

// 用户定义对象命名示例
Device (TPM0) {                // 有效：TPM0 -> TPM_
    Name (_HID, "MSFT0101")    // 预定义对象，以下划线开头
    Name (MYID, 0x1234)        // 用户定义数据对象，不能以下划线开头
    Method (INIT, 0) {         // 用户定义方法，不能以下划线开头
        // 自定义初始化序列
    }
}

// 错误命名示例
Device (_TPM) { }              // 错误：以下划线开头，与预定义保留冲突
Device (TPM) { }               // 错误：名称不足4字符，ASL编译器报错
Device (TPM00) { }             // 错误：名称超过4字符，ASL编译器截断或报错

3.4 作用域嵌套与设备路径调试

在实际嵌入式项目中，ACPI命名空间的嵌套深度直接影响设备路径的解析与调试效率。以下是一个典型的嵌入式设备命名空间布局：

Scope (\_SB_) {
    Device (PCI0) {                    // PCIe Root Complex
        Name (_HID, "PNP0A08")         // PCI Express Root Bridge
        Device (I2C1) {                // I2C控制器 #1
            Name (_HID, "AMDI0010")    // AMD I2C控制器
            Name (_CRS, ResourceTemplate() {
                Memory32Fixed (ReadWrite, 0xFEDC0000, 0x1000)
                Interrupt (ResourceConsumer, Level, ActiveHigh, Exclusive) { 42 }
            })
            Device (TPM0) {            // TPM安全芯片，挂载在I2C1下
                Name (_HID, "MSFT0101")
                Name (_CRS, ResourceTemplate() {
                    I2cSerialBus (0x50, ControllerInitiated, 400000, AddressingMode7Bit, "\\_SB_.PCI0.I2C1", 0, ResourceConsumer)
                })
                Method (_PS0, 0) {      // 电源恢复序列
                    // 使能TPM电源轨
                    Store (0x01, \_SB_.GPIO0.PWR_EN)
                    Sleep (10)
                }
                Method (_PS3, 0) {      // 电源关闭序列
                    Store (0x00, \_SB_.GPIO0.PWR_EN)
                }
            }
        }
    }
}

# 查看完整命名空间树
cat /sys/firmware/acpi/tables/DSDT | xxd | head -20
# 或使用acpidump工具
acpidump -o dsdt.dat
iasl -d dsdt.dat
# 查看设备路径与电源状态
ls -la /sys/bus/acpi/devices/
cat /sys/bus/acpi/devices/TPM0:00/power_state

3.5 命名空间与电源状态的关系

ACPI命名空间的结构直接影响电源管理的粒度。每个设备节点可以独立定义电源控制方法（_PS0/_PS3），而作用域层级决定了电源管理的范围：

• 设备级电源管理： 每个Device节点独立控制自己的电源状态，适用于外设、传感器等。
• 总线级电源管理： 在Scope或Device内定义_PSC（电源状态能力），可批量控制子设备。
• 系统级电源状态： 通过\_S0、\_S3、\_S4、\_S5等全局对象定义系统睡眠状态。

3.6 实战案例：嵌入式设备命名空间设计

以一款基于ARM架构的嵌入式IoT网关为例，其ACPI命名空间设计如下：