龙芯固件ACPI表详解：从UEFI源码（Platform.asl）到Linux `/sys/firmware/acpi/tables` 的完整流程
龙芯固件ACPI表详解：从UEFI源码到Linux系统的完整解析
在国产CPU龙芯平台的开发过程中，ACPI（高级配置与电源管理接口）扮演着连接固件与操作系统的关键角色。对于系统工程师和固件开发者而言，深入理解ACPI表从固件源码到操作系统呈现的完整生命周期，是解决硬件兼容性问题、优化系统启动流程的重要基础。
龙芯UEFI固件通过Platform.asl、PcieTree.asl等ASL源码文件定义硬件拓扑结构，这些代码经过ACPI编译器处理后生成二进制表嵌入固件。当系统启动时，这些表被传递给Linux内核，最终呈现在/sys/firmware/acpi/tables目录下。本文将带您完整走查这一技术链条，揭示龙芯平台ACPI实现的独特之处。
1. 龙芯UEFI固件中的ACPI源码架构
龙芯平台的ACPI实现始于UEFI固件源码中的ASL（ACPI Source Language）文件。与x86平台不同，龙芯的ACPI定义更加注重对国产芯片组特性的适配。
1.1 核心ASL文件解析
龙芯固件中主要包含以下关键ASL文件：
- Platform.asl：定义基础硬件设备，包括GPIO、I2C、SPI等控制器
- PcieTree.asl：描述PCIe拓扑结构
- PciDevice.asl：包含特定PCI设备的补充定义
以LS7A2000桥片的GPIO定义为例，其ASL代码展示了龙芯特有的硬件ID命名规范：
1.2 龙芯特有硬件标识
龙芯ACPI实现中使用了特殊的硬件ID前缀：
| 硬件类型 | HID前缀 | 示例设备 |
|---|---|---|
| GPIO控制器 | LOON0002 | LS7A2000 GPIO |
| I2C控制器 | LOON0004 | I2C0/I2C1 |
| 桥片特定设备 | LOON0007 | LS3A6000 GPIO |
这些标识符在Linux内核驱动中会有对应的兼容性匹配，是龙芯硬件能够被正确识别的关键。
1.3 ACPI表编译流程
龙芯固件构建时，ACPI表的生成经历以下关键步骤：
- ASL源码预处理：根据目标平台选择不同的设备定义
- ACPI编译器处理：使用iasl工具将ASL编译为AML字节码
- 表整合：将DSDT、SSDT等表整合到固件镜像中
- 校验：通过acpixtract验证表结构的完整性
提示：龙芯开发环境下可以使用
make acpi命令单独触发ACPI表的编译过程，方便调试。
2. 从固件到操作系统：ACPI表的传递机制
系统启动过程中，ACPI表经历了从固件静态存储到操作系统动态识别的完整传递链条。理解这一机制对调试硬件兼容性问题至关重要。
2.1 启动阶段的ACPI加载流程
龙芯平台特有的ACPI表加载时序：
- PEI阶段：固件初始化基础硬件后，建立ACPI表的物理内存区域
- DXE阶段：根据硬件检测结果动态修补ACPI表内容
- BDS阶段：最终确认表结构并准备传递给操作系统
- Linux内核：通过UEFI系统表获取ACPI区域地址
与x86平台不同，龙芯在传递ACPI表时会额外处理：
- 国产桥片特有的内存区域映射
- 多芯片互联情况下的NUMA节点信息
- 自定义电源管理状态转换
2.2 Linux下的ACPI表呈现
系统启动后，可以在/sys/firmware/acpi/tables目录下看到完整的ACPI表集合。龙芯平台通常会包含以下关键表：
使用hexdump可以查看原始表内容：
2.3 龙芯特有表解析
除了标准ACPI表外，龙芯平台还引入了专有表：
- LOON：包含龙芯芯片组特有功能定义
- LISA：记录多芯片互联拓扑信息
- LPCM：低功耗控制模块寄存器映射
这些表通常以自定义签名开头，需要配合龙芯提供的工具链进行解析：
3. ACPI工具链实战应用
掌握ACPI相关工具的使用方法，是开发和调试龙芯平台的重要技能。下面介绍几个关键工具的实际应用场景。
3.1 acpidump与iasl组合使用
完整提取和反编译ACPI表的流程：
- 获取原始ACPI表数据：
- 分离出单个表文件：
- 反编译DSDT表：
注意：龙芯平台的DSDT表可能包含标准ACPI语法之外的扩展定义，需要确保使用配套版本的iasl工具。
3.2 常见问题排查技巧
当遇到硬件识别问题时，可以按以下步骤排查：
- 检查原始表完整性：
- 对比固件与内存中的表：
- 动态调试ACPI方法：
3.3 龙芯平台特有工具
龙芯提供了一些增强工具来简化ACPI开发：
| 工具名称 | 功能描述 | 使用示例 |
|---|---|---|
| loonacpi | 验证龙芯特有表结构 | loonacpi -c LOON |
| lsdsdt | 生成DSDT差异报告 | lsdsdt old.dsl new.dsl |
| acpi_patcher | 运行时修补ACPI表 | acpi_patcher -p fix.dsl |
4. 内核与ACPI的交互机制
Linux内核如何解析和处理龙芯平台的ACPI表，是确保硬件正常工作的最后关键环节。
4.1 ACPI子系统初始化流程
龙芯平台特有的内核启动时序：
- early ACPI：解析FADT、MADT等基础表
- NUMA初始化：根据SRAT表建立内存拓扑
- 设备枚举：通过DSDT/SSDT发现硬件设备
- 驱动绑定：匹配设备HID与驱动兼容性
在龙芯3A5000/3A6000系列中，内核会特别处理：
- 自定义的LOONxxxx硬件ID
- 桥片寄存器访问语义
- 多芯片一致性协议
4.2 设备资源映射示例
以I2C控制器为例，内核通过ACPI获取的资源信息包括：
对应的设备树节点会自动生成：
4.3 常见问题与解决方案
龙芯平台ACPI实现的典型问题及应对：
-
GPIO映射冲突：
- 症状：GPIO编号与预期不符
- 解决：检查_DSD中的gsi_idx_map定义
-
中断路由错误：
- 症状：设备中断无法触发
- 解决：验证MADT中的GSI分配
-
电源状态异常：
- 症状：系统无法正常休眠
- 解决：检查FADT中的电源管理寄存器定义
在龙芯开发板上调试ACPI问题时，可以结合硬件原理图和ASL源码进行交叉验证，特别注意寄存器地址和中断号的正确性。