zmkfirmware/zmk-build-xtensa-nxp_imx8m_adsp

xtensa-nxp_imx8m_adsp构建镜像

镜像概述

本Docker镜像专为xtensa-nxp_imx8m_adsp目标架构提供预配置的构建环境，集成了该架构所需的交叉编译工具链、依赖库及构建脚本，简化基于NXP i.MX8M系列处理器ADSP（音频数字信号处理器）的应用程序或固件开发流程。

核心功能与特性

• 预配置工具链：包含xtensa-nxp_imx8m_adsp架构专用的GCC交叉编译器、链接器及调试工具
• 目标架构SDK：集成NXP官方针对i.MX8M ADSP的软件开发套件（SDK）
• 依赖管理：预装常用构建依赖库（如音频处理库、DSP算法库等）
• 环境隔离：通过Docker容器化确保构建环境一致性，避免主机系统依赖冲突

使用场景与适用范围

• 为NXP i.MX8M系列处理器（如i.MX8M Mini、i.MX8M Nano）的ADSP模块开发音频处理应用
• 构建基于xtensa-nxp_imx8m_adsp架构的固件镜像或驱动程序
• 自动化CI/CD流程中集成该镜像实现跨平台构建

使用方法与配置说明

基本使用命令

bash
docker run -it --rm \
  -v $(pwd):/workspace \
  xtensa-nxp_imx8m_adsp-build-image \
  /bin/bash -c "cd /workspace && make"

参数说明

• -v $(pwd):/workspace：将主机当前工作目录挂载到容器内的/workspace目录，用于传递源代码和输出构建产物
• xtensa-nxp_imx8m_adsp-build-image：镜像名称（实际使用时需替换为具体镜像标签）
• /bin/bash -c "cd /workspace && make"：容器启动后执行的构建命令（可根据项目构建系统替换为cmake、ninja等）

高级配置

自定义构建命令

bash
docker run -it --rm \
  -v $(pwd):/workspace \
  -e BUILD_TARGET=firmware \
  xtensa-nxp_imx8m_adsp-build-image \
  /bin/bash -c "cd /workspace && ./build.sh \$BUILD_TARGET"

• -e BUILD_TARGET=firmware：通过环境变量指定构建目标

持久化构建缓存

bash
docker run -it --rm \
  -v $(pwd):/workspace \
  -v build-cache:/root/.cache \
  xtensa-nxp_imx8m_adsp-build-image \
  make -j$(nproc)

• -v build-cache:/root/.cache：挂载持久化卷保存构建缓存，加速重复构建

注意事项

• 确保主机Docker环境已配置正确的镜像仓库访问权限
• 构建大型项目时建议增加容器内存限制（如--memory=4g）
• 构建产物默认输出至挂载的/workspace目录，需确保主机目录有写入权限