1. 课程导论与项目全景：单片机测试调试的重要性、课程目标、项目架构总览

各位同学，欢迎来到《单片机软件测试与调试架构系统化项目实战》的第一章。

说实话，做了十几年嵌入式开发，我见过太多“代码写完就跑、一跑就崩、一崩就抓瞎”的场面。我自己刚入行那会儿，也干过这种事——写完一个电机控制程序，直接烧片，结果电机原地起飞，差点把实验台掀了。从那以后，我养成了一个习惯：测试和调试，必须从一开始就纳入架构设计。

这一章，我们不急着写代码。先聊聊为什么测试调试这么重要，这门课到底要带你达成什么目标，以及整个项目的骨架长什么样。

1.1 为什么单片机软件需要系统化的测试与调试？

很多人觉得，单片机程序嘛，逻辑简单，跑一遍没问题就行了。嗯，这个想法很危险。

你想想看，一个稍微复杂点的项目——比如带Wi-Fi联网、传感器采集、LCD显示、电机控制的智能家居节点——代码量轻松上万行。中断、定时器、DMA、RTOS任务调度，这些模块互相耦合。一个全局变量被意外修改，一个中断优先级配错，都可能导致系统死机。

我在一个量产项目中遇到过：产品发出去三千台，客户反馈偶尔死机。查了两个月，最后发现是一个结构体指针在某个极端时序下被覆盖了。这种问题，靠“肉眼审查代码”根本看不出来，必须靠系统化的测试和调试工具链才能复现和定位。

所以，这门课要解决三个痛点：

• 怎么测 —— 搭建测试平台，设计测试用例，覆盖正常和异常场景。
• 怎么调 —— 使用调试工具链，断点、Trace、日志、波形分析。
• 怎么管 —— 把测试和调试流程化、架构化，融入项目开发周期。

1.2 课程目标：你学完能做什么？

我不喜欢讲虚的。这门课的目标很具体，你学完之后，应该具备以下能力：

1.3 项目架构总览：三大部分

整个课程围绕一个完整的项目展开——智能环境监测节点。它包含温湿度传感器、OLED显示、Wi-Fi通信、按键输入和蜂鸣器报警。这个项目不算复杂，但足够覆盖测试调试的典型场景。

项目的架构分为三大块：待测系统、测试平台、调试工具链。它们之间的关系，我画了一张图，你一看就明白。

这张图是整个课程的骨架。我简单解释一下：

• 待测系统 (DUT)：就是我们的单片机硬件和固件。它是被测试的对象。
• 测试平台：运行在PC上的Python程序。它负责发送测试指令、接收数据、判断结果、生成报告。说白了，它扮演“自动化测试工程师”的角色。
• 调试工具链：硬件调试器（J-Link/ST-Link）、IDE调试器、逻辑分析仪、串口Trace工具。它们用来深入系统内部，观察变量、寄存器、时序。

1.4 一个典型的测试调试流程

为了让你更直观地理解这三者如何协同工作，我描述一个实际场景：

1. 测试平台发起测试：PC通过串口发送指令“读取温湿度”。
2. 待测系统响应：STM32收到指令，通过I2C读取SHT30，返回温湿度数据。
3. 测试平台判断：如果返回数据在合理范围内（温度0~50°C，湿度20~90%RH），测试通过；否则失败。
4. 如果失败：测试平台记录失败用例，同时触发调试工具链——比如通过J-Link读取MCU内部变量，或者用逻辑分析仪抓取I2C总线波形。
5. 定位根因：通过波形发现I2C时钟线在某个时刻出现了毛刺，导致通信错误。最终定位到是GPIO配置问题。

这个流程，我们在后面的章节会反复练习。现在你只需要有个印象就行。

1.5 你需要准备什么？

工欲善其事，必先利其器。我建议你提前准备好以下硬件和软件：

1.6 本章小结

这一章我们做了三件事：

• 明确了测试调试的重要性——它不是可有可无的环节，而是项目质量的基石。
• 列出了课程目标——六项能力，对应六个阶段。
• 画出了项目架构总览——待测系统、测试平台、调试工具链，三者协同工作。