📚 课程目录第1章环境搭建与工具链验证

1. 环境搭建与工具链验证

任务目标

本案例要求在一台x86_64 Linux主机上搭建面向嵌入式目标（ARM Cortex-M系列）的AI模型部署最小开发环境，包含：ARM交叉编译工具链、TensorFlow Lite Micro（TFLM）框架源码，以及用于本地验证的QEMU模拟器。最终通过交叉编译并运行TFLM自带的示例程序，确认工具链与框架可用。

环境依赖

主机系统：Ubuntu 22.04（或兼容的Linux发行版）
必要软件包：git、make、python3、gcc（用于编译主机端辅助工具）
网络：可访问GitHub（用于拉取TFLM源码）

环境搭建步骤

依次执行以下命令完成环境准备。所有操作均在用户主目录下进行。

# 1. 安装ARM交叉编译工具链（gcc-arm-none-eabi）
sudo apt update
sudo apt install -y gcc-arm-none-eabi qemu-system-arm

# 2. 验证交叉编译器安装
arm-none-eabi-gcc --version

# 3. 克隆TensorFlow Lite Micro源码（固定版本，保证可复现）
cd ~
git clone https://github.com/tensorflow/tflite-micro.git
cd tflite-micro
git checkout 3a3a5e5a2f1a0c3d4e5f6a7b8c9d0e1f2a3b4c5d  # 使用2024年1月稳定提交

若git checkout指定的提交不存在，可改用git checkout main拉取最新代码，但后续编译命令可能需要微调。

完整实现：交叉编译并运行TFLM示例

TFLM仓库自带hello_world示例，该示例训练了一个小型正弦波拟合模型，并在嵌入式设备上运行推理。我们将其交叉编译为ARM Cortex-M3格式（QEMU可模拟），然后通过QEMU验证执行结果。

# 进入示例目录
cd ~/tflite-micro/tensorflow/lite/micro/examples/hello_world

# 创建构建目录
mkdir -p build && cd build

# 使用CMake交叉编译（生成Makefile）
cmake .. \
  -DCMAKE_TOOLCHAIN_FILE=../../../../cmake/toolchain_arm_cortex_m3.cmake \
  -DTFLM_TARGET=arm_cortex_m3 \
  -DTFLM_TOOLCHAIN=gcc

# 编译生成可执行文件
make -j$(nproc)

# 编译产物位于 ./bin/hello_world
ls -la bin/

编译完成后，使用QEMU在模拟的ARM Cortex-M3环境中运行该程序：

# 运行QEMU模拟（无需额外镜像，TFLM的hello_world为裸机程序）
qemu-system-arm -machine mps2-an385 -cpu cortex-m3 -nographic -kernel bin/hello_world

程序启动后会在串口输出推理结果。预期输出为一系列x_value: 0.0, y_value: 0.0格式的数值对，其中y_value接近sin(x)的近似值。当输出约20组数据后程序结束，QEMU进程退出。

验证方法与判定标准

按以下顺序逐项检查，全部通过即视为环境搭建成功：

工具链验证：arm-none-eabi-gcc --version能输出版本号（如10.3.1或更高）。
编译验证：make命令无报错退出，且bin/hello_world文件存在，大小在100KB～500KB之间（说明包含TFLM推理代码）。
运行验证：QEMU命令执行后，终端出现类似以下格式的输出（数值因模型精度略有差异）：

x_value: 0.0, y_value: 0.0
x_value: 0.1, y_value: 0.0998334
x_value: 0.2, y_value: 0.198669
...

输出约20行后程序自动结束，QEMU返回命令行。若看到上述输出，说明交叉编译工具链、TFLM框架和QEMU模拟器三者配合正常，环境搭建完成。

常见问题排查

CMake报错找不到编译器：确认arm-none-eabi-gcc已安装，并检查cmake/toolchain_arm_cortex_m3.cmake文件中的编译器路径是否与系统实际路径一致（默认使用arm-none-eabi-gcc）。
QEMU无输出：确认使用-machine mps2-an385参数，该型号模拟Cortex-M3开发板，TFLM的hello_world默认链接脚本针对此板卡。若更换其他machine参数可能导致程序无法启动。
编译内存不足：TFLM编译需要约2GB内存，若主机内存较小，可减少并行编译数（如make -j2）。