单片机与物联网 / 系统课时
单元测试与硬件联调
单元测试与硬件联调
本课把“代码逻辑正确”和“硬件信号正确”拆成两个可验证层次:先在主机上测试纯逻辑,再用替代输入、串口脚本和仪器逐步联调真实板卡,最终形成可重复、可定位、可留证据的验证流程。
学习目标
- 将业务逻辑与寄存器、外设驱动解耦,建立可测试边界。
- 使用断言和替代输入验证阈值、状态保持与边界条件。
- 使用串口脚本、万用表、示波器或逻辑分析仪完成硬件联调。
建立可测试边界
单元测试不应直接依赖 ADC、GPIO 或中断寄存器。更稳妥的结构是把算法与状态转换放在纯 C 函数中,把硬件访问封装为输入接口;测试时注入固定数据,烧录后再把接口连接到真实驱动。这样,逻辑失败与电气失败不会混在同一条排查链上。

一个容易维护的接口通常只暴露“读取输入”和“写出结果”,而不是把寄存器地址扩散到上层。纯逻辑函数应保持确定性:相同输入和初始状态必须得到相同输出,这也是测试用例可重复的前提。
编写纯逻辑单元测试
下面的完整示例测试带 5 个单位回差的报警状态。controller_step 通过函数指针读取样本,测试代码用固定数组替代 ADC,因此可直接在主机编译器上运行。
将代码保存为 test_alarm.c:
#include <assert.h>
#include <stdbool.h>
#include <stddef.h>
#include <stdio.h>
typedef int (*ReadSample)(void);
static const int fake_values[] = {95, 100, 98, 94};
static size_t fake_index = 0;
static int read_fake_sample(void) {
return fake_values[fake_index++];
}
static bool next_alarm_state(int sample, int threshold, bool alarm_on) {
if (!alarm_on && sample >= threshold) {
return true;
}
if (alarm_on && sample <= threshold - 5) {
return false;
}
return alarm_on;
}
static bool controller_step(ReadSample read_sample, int threshold, bool alarm_on) {
return next_alarm_state(read_sample(), threshold, alarm_on);
}
int main(void) {
const bool expected[] = {false, true, true, false};
bool alarm_on = false;
for (size_t i = 0; i < 4; ++i) {
alarm_on = controller_step(read_fake_sample, 100, alarm_on);
assert(alarm_on == expected[i]);
printf("case=%zu alarm=%s\n", i + 1, alarm_on ? "on" : "off");
}
puts("all tests passed");
return 0;
}运行命令:
cc -std=c11 -Wall -Wextra -Werror test_alarm.c -o test_alarm
./test_alarm预期输出:
case=1 alarm=off
case=2 alarm=on
case=3 alarm=on
case=4 alarm=off
all tests passed测试用例至少覆盖阈值下方、等于阈值、回差区间和复位边界。测试构建不要定义 NDEBUG,否则标准 assert 会被关闭;持续集成中还应把编译警告提升为错误,避免未使用变量和类型转换问题被忽略。
用替代输入和串口脚本联调
板级联调时,可在测试固件中提供受控命令,例如 SET ADC 95 注入采样值,READ ALARM 读取状态。该接口应只在测试构建中启用,并通过编译选项与正式固件隔离,防止调试命令进入发布版本。
下面的脚本依赖 pyserial,并假定测试固件按行返回 OK 与 ALARM=0 或 ALARM=1。将代码保存为 serial_check.py:
import argparse
import time
import serial
CASES = [(95, 0), (100, 1), (98, 1), (94, 0)]
def request(port: serial.Serial, command: str) -> str:
port.write((command + "\n").encode("ascii"))
return port.readline().decode("ascii").strip()
def main() -> None:
parser = argparse.ArgumentParser()
parser.add_argument("--port", required=True)
args = parser.parse_args()
with serial.Serial(args.port, 115200, timeout=1) as port:
time.sleep(2)
port.reset_input_buffer()
for sample, expected in CASES:
if request(port, f"SET ADC {sample}") != "OK":
raise RuntimeError("device rejected test input")
reply = request(port, "READ ALARM")
actual = int(reply.split("=", 1)[1])
print(f"sample={sample} alarm={actual}")
if actual != expected:
raise AssertionError(
f"expected alarm={expected}, got alarm={actual}"
)
print("hardware integration passed")
if __name__ == "__main__":
main()运行命令中的 <PORT> 替换为实际串口名,例如 Linux 的 /dev/ttyACM0 或 Windows 的 COM5:
python serial_check.py --port <PORT>预期输出:
sample=95 alarm=0
sample=100 alarm=1
sample=98 alarm=1
sample=94 alarm=0
hardware integration passed如果设备打开串口后自动复位,脚本中的短暂等待用于避开启动阶段;若固件启动更慢,应以明确的 READY 握手代替盲目增加等待时间。
按证据完成硬件联调
硬件联调应从低风险、静态证据开始,再进入动态波形。先断电检查短路与焊接方向,再使用限流电源确认静态电流,随后检查时钟、复位、电源纹波和关键总线,最后才运行完整业务场景。
| 阶段 | 推荐工具 | 通过证据 |
|---|---|---|
| 上电前 | 万用表 | 电源与地无异常短路,极性正确 |
| 上电后 | 限流电源、万用表 | 电压稳定,静态电流未触发限流 |
| 时序检查 | 示波器 | 复位、时钟、PWM 的频率和电平符合设计 |
| 总线检查 | 逻辑分析仪 | UART、I2C、SPI 帧格式与时序正确 |
| 场景验收 | 串口脚本与负载 | 重复运行结果一致,无异常复位或超时 |
常见错误包括只测试正常值而遗漏边界、让测试直接访问真实寄存器、用肉眼观察 LED 代替时间证据,以及修改固件后仍使用旧脚本。修复时应先固定固件版本、脚本版本和接线图,再从最小命令逐步恢复完整场景。
本课练习
- 为报警逻辑增加传感器断线状态:输入小于 0 时进入故障,恢复到合法范围后退出故障。至少设计正常、阈值、回差、断线和恢复五类断言,验收条件是主机测试全部通过且无编译警告。
- 为一块开发板设计三条串口联调命令,分别注入输入、读取状态和复位测试状态。编写脚本连续运行 20 轮,验收条件是每轮结果一致,超时或响应格式错误会立即返回非零退出码。
本课总结
- 纯逻辑、驱动适配和真实硬件应分层验证,避免一次同时排查多类问题。
- 替代输入让边界条件可重复,串口脚本让板级验证可自动执行。
- 仪器测量必须留下电压、时序或协议证据,不能只依赖现象判断。
下一课预告
下一课将学习“工程配置与版本管理”,把源码、构建选项、测试脚本和发布标签组织成可复现、可追踪的工程。