Zephyr RTOS 在 AMD ACP 7.0 音频 DSP 上的移植与 SOF 音频固件构建指南

Zephyr RTOS 在 AMD ACP 7.0 音频 DSP 上的移植与 SOF 音频固件构建指南【免费下载链接】zephyrPrimary Git Repository for the Zephyr Project. Zephyr is a new generation, scalable, optimized, secure RTOS for multiple hardware architectures.项目地址: https://gitcode.com/GitHub_Trending/ze/zephyr导读本指南围绕 Zephyr 仓库中 AMD ACP 7.0 音频协处理器Audio Co-processor板级支持文档展开说明如何基于 Zephyr RTOS 为基于 HiFi5 DSPXtensa 架构的 ACP 7.0 平台构建、烧录音频与语音处理固件并驱动 Sound Open FirmwareSOF框架运行。读完本文你将掌握 ACP 7.0 板的硬件资源与设备树布局、Zephyr SDK 与 Cadence Xtensa 两套工具链的配置方法、west构建流程以及通过 ACP Linux 驱动加载签名固件的完整操作与启动验证手段。平台概览AMD SoC 中的音频协处理器ACP 7.0Audio Co-Processor是集成在 AMD SoC 中的专用音频协处理器采用 Cadence HiFi5 DSP 的 Xtensa 架构。Zephyr OS 被移植到该平台用于在SOFSound Open Firmware框架之上承载各类音频audio与语音speech应用场景例如音频编解码、语音唤醒、智能音箱麦克风阵列处理等。SOF 固件既可以使用 Zephyr 工具链构建也可以使用 XCCXtensa C/C Compiler工具链构建两种方式均可运行在 ACP 7.0 AMD 平台上。从板级元数据看见 acp_7_0_adsp.yml该板标识为acp_7_0_adsp/acp_7_0名称为 AMD ACP7.0 Audio DSP类型为 mpuMemory Protection Unit 类架构为xtensa官方声明支持zephyr与xcc两种工具链。对应的 Kconfig.acp_7_0_adsp 中BOARD_ACP_7_0_ADSP会直接select SOC_ACP_7_0完成板级与 SoC 级的绑定。硬件特性板级资源根据板级文档ACP 7.0 的关键硬件特性如下RAM2.5 MB HP SRAM外加 512 KB 可配置 IRAM/DRAM指令/数据 RAM 可按需分配音频接口1 x SDWSoundWire1 x HSI2S、PCM 高速串行音频接口DMIC数字麦克风阵列接口。SoC 设备树视角板级设备树 acp_7_0_adsp.dts 非常精简仅声明model AMD ACP_7_0 Audio DSP、compatible acp_7_0并包含 SoC 级设备树amd/acp_7_0.dtsi。真正的外设布局在 dts/xtensa/amd/acp_7_0.dtsi 中定义从中可以看到CPU单个cpu0compatible cdns,tensilica-xtensa-lx7即 HiFi5 所属的 LX7 内核家族clock-frequency 600000000600 MHz中断控制器amd,acp-intc单单元中断号#interrupt-cells 1DMA 引擎amd,acp-host-dma主机侧 DMA与amd,acp-sdw-dmaSoundWire DMA12 通道、amd,acp-tdm-dmaTDM DMA6 通道DAI 接口acp-sdw-dai0~acp-sdw-dai11共 12 个 SoundWire DAI 端点dai-index取值 0~5 与 64~69以及tdm-dai0~tdm-dai2共 3 个 TDM DAI 端点。这一设备树布局与文档中1 x SDW HS(I2S/PCM) DMIC的音频接口描述相互印证SDW 端点通过多个 DAI 通道接入TDM/HS 通道则服务于 I2S/PCM 等传统音频总线DMIC 接口用于数字麦克风采集。这些设备树节点是后续 SOF 拓扑topology与 PCM 管线映射到具体硬件 DMA 通道的依据。支持的特性板级文档通过.. zephyr:board-supported-hw::指令动态列出受支持的硬件特性渲染时由仓库构建系统自动生成。结合板级默认配置 acp_7_0_adsp_defconfig可以确认该板默认启用了以下内核与体系结构能力中断体系CONFIG_GEN_ISR_TABLESy、CONFIG_GEN_SW_ISR_TABLEy、CONFIG_DYNAMIC_INTERRUPTSy动态中断分配同时关闭 IRQ 向量表直接生成与共享/多级中断GEN_IRQ_VECTOR_TABLEn、SHARED_INTERRUPTSn、MULTI_LEVEL_INTERRUPTSn定时器CONFIG_XTENSA_TIMERy且CONFIG_XTENSA_TIMER_ID0使用 Xtensa 内置定时器 0并启用CONFIG_TICKLESS_KERNELy无节拍内核适合音频这类对功耗与调度确定性敏感的负载缓存CONFIG_CACHE_MANAGEMENTy、CONFIG_DCACHEy数据缓存管理开启与 SoC 级 Kconfig 中CPU_HAS_DCACHE的选择一致堆配置CONFIG_SYS_HEAP_HARDENING_NONEy关闭系统堆加固以降低开销契合 DSP 固件对低延迟与确定性的要求。在 SoC 级 soc/amd/acp_7_0/Kconfig.soc 中SOC_ACP_7_0会select XTENSA、select ATOMIC_OPERATIONS_C原子操作由 C 实现提供避免依赖特定指令扩展、select CPU_HAS_DCACHE特别值得注意的是仅当工具链不是xcc或xt-clang时才select XTENSA_HAL即使用 Zephyr SDKGCC构建时需要引入 Xtensa HAL 支持而使用 Cadence 专有工具链时则由其自带的运行时库承担。SoC 的工具链名称通过 soc/amd/acp_7_0/Kconfig 中的SOC_TOOLCHAIN_NAME定义为amd_acp_7_0_adsp供 Zephyr 工具链探测机制定位。系统时钟ACP 7.0 SoC 以音频时钟audio clock运行频率范围为200 MHz 至 800 MHz。设备树中 CPU 节点声明的工作频率为 600 MHzdts/xtensa/amd/acp_7_0.dtsi处于该范围之内。实际运行频率由 SOF 固件在启动阶段根据拓扑与电源管理策略动态配置这一点在开发低功耗音频管线时需要特别留意——频率切换会影响音频采样时钟的稳定性。系统需求与工具链配置Zephyr SDKGCC构建 ACP 7.0 板级镜像的默认方式是使用 Zephyr SDK 提供的基于 GCC 的 Xtensa 工具链无需任何额外配置west构建系统会自动完成探测与使用。Cadence Xtensa 专有工具链可选对于追求更高优化等级如更低的代码体积与更高的 DSP 指令利用率的场景可以改用 Cadence 提供的专有 Xtensa 工具链。注意以下操作前提是你已经按 Xtensa 官方文档购买了并安装好对应板卡的 toolchain 与 core处理器配置。使用 Xtensa 工具链时除按 Cadence 指引设置许可证license环境变量外还需为 ACP 7.0 板卡设置以下环境变量其中后三个变量是acp_7_0特有的export XTENSA_TOOLCHAIN_PATHtools installed path export XTENSA_BUILDS_DIRuser build directory path export ZEPHYR_TOOLCHAIN_VARIANTZephyr GCC export TOOLCHAIN_VERRI-2023.11-linux export XTENSA_COREACP_7_0_HiFi5_NNE_PROD各变量含义变量作用XTENSA_TOOLCHAIN_PATHXtensa 工具链安装路径指向 Cadence 安装目录XTENSA_BUILDS_DIR用户构建目录路径工具链构建中间产物存放位置ZEPHYR_TOOLCHAIN_VARIANT指定 Zephyr 使用 Xtensa 工具链变体此处为Zephyr GCC之外的专有工具链路径分支TOOLCHAIN_VER工具链版本标识示例为RI-2023.11-linux应按你实际安装的版本填写XTENSA_COREXtensa 处理器内核配置名ACP_7_0_HiFi5_NNE_PROD对应带 NNE神经网络引擎的 HiFi5 生产配置这里给出的版本号RI-2023.11-linux与内核名ACP_7_0_HiFi5_NNE_PROD仅为板级文档中的示例值实际使用前请以你手中工具链的真实版本与核配置为准。工具链选择在构建系统中的体现无论采用哪套工具链板级 KconfigBOARD_ACP_7_0_ADSP→SOC_ACP_7_0都会确保正确的 SoC 标识与工具链名称被选中区别仅在于是否引入XTENSA_HAL见上文 Kconfig 分析。此外board.cmake 中调用board_set_rimage_target(acp_7_0)意味着固件构建后会经过 SOF 生态的rimage工具封装这是后续生成签名镜像的必要前提。编程与调试构建使用 Zephyr 标准的west流程即可完成构建。以下命令以hello_world示例为目标构建acp_7_0_adsp/acp_7_0板卡west build -b acp_7_0_adsp/acp_7_0 samples/hello_world构建产物会包含由 rimage 封装后的镜像文件由 board.cmake 中的board_set_rimage_target驱动该镜像才是后续烧录到 ACP 7.0 平台的文件。烧录与普通 MCU 板卡不同AMD 仅支持通过 ACP Linux 驱动烧录经过签名的镜像到 ACP 7.0 平台。也就是说镜像必须经过签名signed image后由主机侧 Linux 上的 ACP 驱动加载到 DSP 的 HP SRAM 中执行。烧录与加载动作完成后可以观察 Linux 内核日志dmesg来确认固件是否成功启动典型的启动序列如下- booting DSP firmware - ACP_DSP0_RUNSTALL : 0x0 - ipc rx: 0x70000000 - Firmware info: version 2:14:99-b5961 - Firmware: ABI 3:29:1 Kernel ABI 3:23:0 - mailbox upstream 0x0 - size 0x400 - mailbox downstream 0x400 - size 0x400 - stream region 0x1000 - size 0x400 - debug region 0x800 - size 0x400 - fw_state change: 3 - 6 - ipc rx done: 0x70000000 - firmware boot complete对这段日志的解读有助于排查启动失败问题booting DSP firmware/ACP_DSP0_RUNSTALL : 0x0Linux 驱动解除 DSP 的 runstall 复位状态开始引导固件ipc rx: 0x70000000与ipc rx done: 0x70000000主机与 DSP 之间完成一次 IPC进程间通信握手Firmware info/Firmware: ABI ... Kernel ABI ...固件版本与 ABI 兼容性信息。ABI 不匹配例如固件 ABI 高于内核 ABI通常是常见的加载失败原因mailbox upstream / downstream、stream region、debug regionDSP 与主机共享内存区域的地址与大小分配其中 mailbox 用于 IPC 消息stream 区用于音频数据流debug 区用于日志与调试数据fw_state change: 3 - 6与firmware boot complete固件状态机推进到运行态标志着整个引导流程完成。开发建议与后续探索在 ACP 7.0 上开发实际音频/语音应用时建议按以下路径深入阅读 SoC 层实现从 soc/amd/acp_7_0 入手其中include/acp70_chip_offsets.h、acp70_chip_reg.h定义了寄存器与内存偏移linker.ld描述了 HP SRAM / IRAM / DRAM 的链接布局acp70_fw_scratch_mem.h则涉及固件暂存内存区域的约定核对设备树外设在 dts/xtensa/amd/acp_7_0.dtsi 中确认 DAI 与 DMA 通道编号再对照 SOF 拓扑文件中的 PCM 路由调试固件优先借助debug region0x800 大小输出的日志与dmesg中的 IPC 消息定位问题必要时结合 ACP 驱动侧工具检查 mailbox 状态。总结AMD ACP 7.0 是 Zephyr 在音频 DSP 领域的重要落地平台它以内置 HiFi5Xtensa LX7的专用音频协处理器为核心通过 SOF 框架承载音频与语音处理负载。本文覆盖了其硬件资源、设备树布局、两套工具链Zephyr SDK 与 Cadence Xtensa的配置方法、west build构建流程以及经 ACP Linux 驱动加载签名镜像后的启动验证手段。无论你是想为 ACP 7.0 开发自定义音频管线还是研究 Zephyr 在 DSP 类 SoC 上的移植范式都可以直接复用本指南中的配置与调试方法论。【免费下载链接】zephyrPrimary Git Repository for the Zephyr Project. Zephyr is a new generation, scalable, optimized, secure RTOS for multiple hardware architectures.项目地址: https://gitcode.com/GitHub_Trending/ze/zephyr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考