第二章：测试环境搭建——交叉编译工具链配置、目标板与宿主机通信、依赖库安装

说实话，嵌入式测试环境搭建这件事，看着简单，做起来全是坑。我见过太多团队，代码写得漂亮，结果环境没配好，一编译就报错，一烧录就黑屏。今天咱们就把这块硬骨头啃下来。

2.1 交叉编译工具链配置

先说说交叉编译。你想想看，你的宿主机是x86架构，目标板可能是ARM、MIPS或者RISC-V。宿主机上编译出来的程序，目标板跑不了。这就好比你在北京做的川菜，拿到成都去卖，口味得调一调。

工具链的选择，我个人习惯用Linaro提供的GCC工具链。为什么？因为它在ARM生态里最成熟，社区活跃，遇到问题好找答案。

核心要点：工具链版本必须与目标板内核版本匹配。版本差太多，编译出来的程序可能无法运行。

安装步骤其实不复杂，但每一步都有讲究：

  1. 下载工具链：从Linaro官网或芯片厂商官网下载预编译包。我建议用gcc-arm-none-eabi系列，对裸机或RTOS场景支持很好。
  2. 解压到指定目录：比如/opt/toolchains/。别放桌面，别放下载目录，规范一点。
  3. 配置环境变量：把工具链的bin目录加到PATH里。
# 解压工具链
tar -xvf gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2 -C /opt/toolchains/

# 配置环境变量（加到 ~/.bashrc 或 ~/.zshrc）
export PATH=$PATH:/opt/toolchains/gcc-arm-none-eabi-10.3-2021.10/bin
export CROSS_COMPILE=arm-none-eabi-
export ARCH=arm

# 验证安装
arm-none-eabi-gcc --version

嗯，这里要注意。配置完环境变量后，记得source ~/.bashrc或者重新打开终端。我曾经有个同事，配完环境变量没刷新，折腾了一下午才发现问题。

小技巧：写个简单的测试程序，交叉编译后放到目标板上跑一下。比如一个打印"Hello, Embedded!"的C程序。能跑通，说明工具链没问题。

2.2 目标板与宿主机通信

环境搭好了，怎么把程序弄到目标板上？通信方式有好几种，我按优先级排个序：

通信方式 适用场景 速度 稳定性
串口（UART） 调试、日志输出 慢（115200bps） 高
网络（SSH/TFTP） 文件传输、远程调试 快 中
JTAG/SWD 硬件调试、烧录 中 高
USB（ADB/DFU） Android设备、固件升级 快 中

串口通信是最基础的方式。说白了，就是一根USB转串口线，连上目标板的调试串口。宿主机上用minicom或screen打开就行。

# 安装 minicom
sudo apt-get install minicom

# 配置串口（通常 /dev/ttyUSB0 或 /dev/ttyACM0）
minicom -D /dev/ttyUSB0 -b 115200

我曾经在项目里遇到过一个问题：串口能连上，但输出全是乱码。查了半天，发现是波特率没对上。目标板用的是115200，我设成了9600。你想想看，这种低级错误，排查起来最浪费时间。

网络通信更适合传输大文件。目标板启动后，通过DHCP获取IP地址，或者手动配置静态IP。宿主机用SSH登录，或者用TFTP传文件。

避坑指南：我曾经在调试一个网络协议栈时，发现目标板ping不通宿主机。排查了两天，最后发现是网线插错了口。目标板有两个网口，一个接外网，一个接调试网络。我插反了。所以，物理连接一定要先确认清楚。

2.3 依赖库安装

嵌入式测试框架跑起来，需要一些依赖库。比如libpthread、librt、libm这些基础库，还有libcmocka、Check这样的测试框架库。

依赖库的安装方式有两种：

  • 宿主机安装：用apt-get或yum安装开发包。比如sudo apt-get install libcmocka-dev。这种方式简单，但库版本可能和目标板不一致。
  • 交叉编译安装：下载源码，用交叉编译器编译，然后安装到目标板的根文件系统里。这种方式更可控，但步骤多。

我个人更推荐第二种方式。为什么？因为嵌入式环境千差万别，宿主机上的库版本可能跟目标板不兼容。你想想看，你在宿主机上编译了一个测试程序，依赖了glibc 2.31，结果目标板上是glibc 2.28，程序跑起来直接报FATAL: kernel too old。这种问题，排查起来很头疼。

# 以交叉编译 libcmocka 为例
# 下载源码
wget https://gitlab.com/cmocka/cmocka/-/archive/master/cmocka-master.tar.gz
tar -xvf cmocka-master.tar.gz
cd cmocka-master

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

# 配置交叉编译
cmake -DCMAKE_C_COMPILER=arm-none-eabi-gcc \
      -DCMAKE_INSTALL_PREFIX=/opt/arm-rootfs/usr \
      ..

# 编译并安装
make -j4
make install

小技巧：把交叉编译好的库放到目标板的根文件系统里，然后打包成镜像烧录。或者用NFS挂载，宿主机上的库目录直接映射到目标板上。这样调试时不用反复烧录，效率高很多。

2.4 环境验证与常见问题

环境搭好了，怎么验证？我一般会写一个简单的测试脚本，把工具链、通信、依赖库全测一遍。

#!/bin/bash
# 环境验证脚本

echo "=== 1. 检查交叉编译器 ==="
arm-none-eabi-gcc --version
if [ $? -ne 0 ]; then
    echo "❌ 交叉编译器未找到"
    exit 1
fi

echo "=== 2. 检查串口通信 ==="
ls -l /dev/ttyUSB*
if [ $? -ne 0 ]; then
    echo "⚠️ 串口设备未找到，请检查连接"
fi

echo "=== 3. 检查依赖库 ==="
arm-none-eabi-gcc -print-file-name=libcmocka.a
if [ $? -ne 0 ]; then
    echo "❌ libcmocka 未安装"
    exit 1
fi

echo "✅ 环境验证通过"

常见问题我列几个，你遇到了可以对照排查：

  • 编译报错：找不到头文件——检查-I路径是否指向了目标板的头文件目录。
  • 链接报错：undefined reference——检查库路径-L和库名-l是否正确。
  • 运行报错：No such file or directory——检查动态链接库是否在目标板的/lib或/usr/lib下。
  • 串口连不上——检查权限，把用户加到dialout组：sudo usermod -a -G dialout $USER。

核心总结：测试环境搭建，说白了就是三件事——工具链能编译、通信能传文件、依赖库能链接。这三件事都验证通过，后面的测试工作才能顺利开展。

好了，环境搭好了，下一章咱们就开始写测试用例了。到时候我会分享一些我在项目中踩过的坑，保证让你少走弯路。

公众号:蓝海资料掘金营，微信deep3321

← 上一章 📖 返回目录 下一章 →