1. 课程导论与调试环境搭建：为什么需要分层架构？调试工具链的选型与配置

各位同学，咱们开始第一讲。

先问大家一个问题：你写STM32程序时，是不是经常把初始化、数据处理、协议解析全塞在一个main函数里？项目小的时候还好说，一旦外设多了、任务复杂了，那个文件能膨胀到几千行。我早年带团队时就吃过这个亏——一个I2C传感器驱动改了个延时，结果把整个系统的调度时序全打乱了。从那以后，我下定决心：必须分层。

1.1 为什么需要分层架构？

分层架构，说白了就是把代码按职责拆成几个独立的“层”。每一层只干自己的事，层与层之间通过定义好的接口通信。你想想看，这就像公司组织架构——销售部不用管研发怎么写代码，研发部也不用管财务怎么算账。

在STM32嵌入式系统里，我习惯把代码分成三层：

层级	职责	典型内容
应用层	业务逻辑、任务调度	状态机、协议解析、用户交互
驱动层	外设抽象、HAL封装	SPI/I2C/UART读写接口
硬件抽象层	寄存器操作、中断向量	HAL库、LL库、CMSIS

为什么要这么分？我举一个真实案例。之前有个项目用STM32F4驱动一个OLED屏，同时还要跑FreeRTOS做多任务。一开始驱动代码和应用逻辑混在一起，结果每次改显示内容都要重新编译整个驱动，而且调试时根本分不清是任务优先级问题还是I2C时序问题。后来我把驱动封装成独立模块，应用层只调用OLED_ShowString()，问题一下子就清晰了。

1.2 分层架构的核心价值

我总结了三句话：

• 可移植性——换芯片时只改硬件抽象层，驱动和应用基本不动。我从STM32F1迁移到F4时，驱动层只改了不到10%的代码。
• 可调试性——出问题能快速定位到层。是硬件时序不对？还是任务调度冲突？分层后一目了然。
• 可复用性——写好的驱动模块，下个项目直接拿来用。我手头有个UART驱动库，已经用了五年，横跨三个芯片系列。

1.3 调试工具链选型与配置

工具选不对，调试两行泪。我这些年用过的调试工具不下十种，踩过的坑能写本书。下面说说我的推荐。

1.3.1 调试器：J-Link vs ST-Link

特性	J-Link	ST-Link
速度	最高可达50 MHz	通常4-8 MHz
兼容性	支持ARM全系列	仅限STM32
价格	较贵（正版）	便宜（板载）
调试功能	支持RTT、ETM等高级功能	基础调试够用

我个人建议：项目初期用ST-Link就够了，毕竟便宜又方便。但如果你要做性能分析、实时数据输出，J-Link的RTT功能能让你省不少时间。我记得有一次调试一个音频播放的卡顿问题，用ST-Link断点一停，音频就断了，根本看不出问题。换成J-Link的RTT，边跑边输出日志，五分钟就定位到了缓冲区溢出。

1.3.2 串口：最朴素的调试利器

别小看串口。很多老工程师调试就靠一个串口加一个printf。为什么？因为它简单、可靠、不干扰时序。

配置要点：

• 波特率：115200是黄金标准，再高容易丢数据
• 使用DMA+环形缓冲区，避免阻塞任务调度
• 日志分级：ERROR > WARN > INFO > DEBUG，用宏控制输出级别

// 我常用的日志宏
#define LOG_LEVEL 3  // 0:ERROR 1:WARN 2:INFO 3:DEBUG

#if LOG_LEVEL >= 3
    #define LOG_DEBUG(fmt, ...) printf("[DEBUG] " fmt "\r\n", ##__VA_ARGS__)
#else
    #define LOG_DEBUG(fmt, ...)
#endif

1.3.3 逻辑分析仪：看时序的神器

说实话，没有逻辑分析仪，你根本不知道I2C的ACK信号是不是真的被拉低了，SPI的时钟相位对不对。我推荐入门级用Saleae Logic 8或者国产的DSLogic，采样率24MHz以上就够用。

什么时候用逻辑分析仪？

• 外设通信异常（I2C死锁、SPI数据错位）
• 中断响应时间测量
• 任务调度时序验证

1.4 本章知识体系总览

下面这张图是我自己画的分层架构与调试工具的关系图，你可以把它当作整个课程的“地图”。

1.5 环境搭建快速清单

最后，我列一个环境搭建的检查清单，你照着做就行：

1. IDE安装：STM32CubeIDE 或 Keil MDK（我推荐CubeIDE，免费且集成CubeMX）
2. 调试器驱动：ST-Link驱动（安装CubeIDE时自带）或J-Link驱动（从Segger官网下载）
3. 串口工具：Putty / SecureCRT / MobaXterm（我习惯用MobaXterm，支持多标签和日志保存）
4. 逻辑分析仪软件：Saleae Logic 或 PulseView（开源免费）
5. 版本管理：Git + 一个.gitignore模板（别问我为什么强调这个，你被覆盖过代码就懂了）