8.1 构建 MCU 固件
8.1.1 环境设置
操作系统版本： Ubuntu 22.04 这些步骤已在 Ubuntu 22.04 上验证。其他 Ubuntu 版本可能也可行，但未经验证。这些步骤未在 Windows 上验证。所需主机软件包
目前不支持在 Windows 上编译。Python 版本： 3.12.10 安装以下 Python 软件包：
注意： 有报告称在同一bin/目录中安装不同二进制版本的 Python 会导致行为不一致。一种解决方法是在临时目录中添加指向所需 Python 版本的符号链接，并更新PATH环境变量以使用它。
Zephyr OS 设置
- 在您偏好的位置创建一个文件夹，用于下载和安装所有 Zephyr 依赖项。
- 为保持构建环境一致，建议使用 Python 虚拟环境。
- 在虚拟环境中安装并初始化 Zephyr：
- 验证 Zephyr 版本。
- Zephyr 版本：3.7 LTS
- Zephyr SDK 版本：0.16.x
- 查看 Zephyr 兼容性矩阵：
- 创建 SDK 目录：
- 下载并设置所需的 Zephyr SDK 版本（0.16.x）。
Zephyr 故障排查资源
安装依赖项 https://docs.zephyrproject.org/latest/develop/getting_started/index.html#select-and-update-os Zephyr SDK 与 Python 依赖项 https://docs.zephyrproject.org/latest/develop/getting_started/index.html#get-zephyr-and-install-python-dependencies 安装 Zephyr SDK https://docs.zephyrproject.org/latest/develop/getting_started/index.html#install-the-zephyr-sdk 故障排查 https://docs.zephyrproject.org/latest/develop/getting_started/index.html#troubleshooting-installation8.1.2 LLVM 设置
-
从 QPM3 下载并安装 RISC-V Snapdragon LLVM。
当前支持的版本：
- Snapdragon LLVM (RISC-V)：21.1.1
- 要安装 QPM3 和 LLVM，请在 Windows 主机上从以下地址下载软件包： https://www.qpm.qualcomm.com 然后将软件包复制到 Ubuntu 主机。
- 如果已安装 QPM3 和 RISC-V 工具链，请跳过此步骤。
- 从以下位置安装 QIKService3：
- 在 QPM3 UI 中，安装 Snapdragon LLVM RISCV Toolchain OEM 工具链。 当前版本：21.1.1
8.1.3 设备树编译器安装
- 安装设备树编译器（DTC）。
8.1.4 编译子系统
环境变量
执行编译
进入以下目录：8.2 配置、镜像生成与启动流程
- 明确记录日志和控制台的选择，使首次成功路径有清晰的输出。
- 初期仅启用您需要的总线，例如串口或 I2C。
- 仅在较简单的路径稳定后再启用 DMA 或 GPI。
- 生成 ELF 文件、内存映射和打包后的 MCU 镜像。
- 使用平台认可的烧录流程加载镜像并进行验证。