单片机与物联网 / 系统课时

单元测试与硬件联调

单元测试与硬件联调

本课把“代码逻辑正确”和“硬件信号正确”拆成两个可验证层次:先在主机上测试纯逻辑,再用替代输入、串口脚本和仪器逐步联调真实板卡,最终形成可重复、可定位、可留证据的验证流程。

学习目标

  • 将业务逻辑与寄存器、外设驱动解耦,建立可测试边界。
  • 使用断言和替代输入验证阈值、状态保持与边界条件。
  • 使用串口脚本、万用表、示波器或逻辑分析仪完成硬件联调。

建立可测试边界

单元测试不应直接依赖 ADC、GPIO 或中断寄存器。更稳妥的结构是把算法与状态转换放在纯 C 函数中,把硬件访问封装为输入接口;测试时注入固定数据,烧录后再把接口连接到真实驱动。这样,逻辑失败与电气失败不会混在同一条排查链上。

单元测试到硬件联调的分层验证流程

一个容易维护的接口通常只暴露“读取输入”和“写出结果”,而不是把寄存器地址扩散到上层。纯逻辑函数应保持确定性:相同输入和初始状态必须得到相同输出,这也是测试用例可重复的前提。

编写纯逻辑单元测试

下面的完整示例测试带 5 个单位回差的报警状态。controller_step 通过函数指针读取样本,测试代码用固定数组替代 ADC,因此可直接在主机编译器上运行。

将代码保存为 test_alarm.c:

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;
}

运行命令:

bash
cc -std=c11 -Wall -Wextra -Werror test_alarm.c -o test_alarm
./test_alarm

预期输出:

text
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:

python
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:

bash
python serial_check.py --port <PORT>

预期输出:

text
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 代替时间证据,以及修改固件后仍使用旧脚本。修复时应先固定固件版本、脚本版本和接线图,再从最小命令逐步恢复完整场景。

本课练习

  1. 为报警逻辑增加传感器断线状态:输入小于 0 时进入故障,恢复到合法范围后退出故障。至少设计正常、阈值、回差、断线和恢复五类断言,验收条件是主机测试全部通过且无编译警告。
  2. 为一块开发板设计三条串口联调命令,分别注入输入、读取状态和复位测试状态。编写脚本连续运行 20 轮,验收条件是每轮结果一致,超时或响应格式错误会立即返回非零退出码。

本课总结

  • 纯逻辑、驱动适配和真实硬件应分层验证,避免一次同时排查多类问题。
  • 替代输入让边界条件可重复,串口脚本让板级验证可自动执行。
  • 仪器测量必须留下电压、时序或协议证据,不能只依赖现象判断。

下一课预告

下一课将学习“工程配置与版本管理”,把源码、构建选项、测试脚本和发布标签组织成可复现、可追踪的工程。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

单元测试与硬件联调

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通