单片机软件架构分层架构与通信协议栈整合设计调试实战 - 第1节
一、课程导论：为什么我们需要分层架构？
各位同学，大家好。我是你们这门课的主讲。在嵌入式这行摸爬滚打了十几年，我见过太多“能跑就行”的代码，也亲手填过不少自己挖的坑。今天咱们开篇第一讲，不急着敲代码，先聊聊一个根本问题：为什么你的单片机软件需要分层？
说白了，分层架构不是理论家的空谈。它是被无数项目逼出来的生存法则。我早期做一款工业采集器，功能简单，一个 while 循环搞定所有。后来客户要加协议、要升级、要远程配置……那代码改得，真是牵一发而动全身。从那以后，我养成了一个习惯：写代码前，先画架构图。
核心观点：分层架构的本质是“分离关注点”。把硬件驱动、业务逻辑、通信协议拆成独立模块，让每一层只关心自己的事。这样做的直接好处是——可移植、可测试、可复用。
1.1 课程目标与学习路径
这门课的目标很明确：让你从“调通外设”进阶到“设计系统”。我们会以 STM32/GD32 为硬件平台，手把手带你搭建一套真正可商用的分层软件架构，并把常见的通信协议栈（Modbus、CANopen、自定义协议）整合进去。
学习路径我建议这样走：
- 先理解分层思想（就是本章内容）
- 搭建开发环境（Keil/IAR/VS Code + GCC）
- 实现基础分层框架（驱动层、抽象层、业务层）
- 整合通信协议栈（Modbus RTU、CAN、TCP/IP）
- 调试与优化（状态机、日志、性能分析）
你想想看，如果一开始就把所有代码揉在一起，后面每加一个功能都是噩梦。而分层之后，换一个 MCU 只需要改驱动层，业务代码几乎不用动。这就是架构的力量。
1.2 为什么我坚持用分层架构？
我记得有一次，项目需要把主控从 STM32F103 换成 GD32F303。如果代码是分层写的，我只需要重写最底层的 GPIO、UART、Timer 驱动，上层的 Modbus 协议栈和业务逻辑完全不用动。那次换芯，我只花了 3 天。而隔壁团队，因为代码耦合严重，整整折腾了两周。
这就是现实。分层架构不是让你多写代码，而是让你少改代码。
个人经验：我建议你在项目一开始就定义好层与层之间的接口。哪怕初期接口设计不完美，也比没有强。接口就是契约，契约清晰了，团队协作才顺畅。
二、开发环境搭建：选对工具，事半功倍
环境搭建是入门的第一道坎。很多新手在这上面浪费了大量时间。我帮你梳理一下主流方案，你根据自己的情况选就行。
2.1 Keil MDK vs IAR EWARM vs VS Code + GCC
| 特性 | Keil MDK | IAR EWARM | VS Code + GCC |
|---|---|---|---|
| 上手难度 | 低（IDE 集成度高） | 中（配置项较多） | 高（需要手动配置） |
| 编译效率 | 中 | 高（优化能力强） | 中（取决于 GCC 版本） |
| 调试体验 | 好（J-Link/ST-Link 原生支持） | 好（C-SPY 调试器强大） | 一般（需要插件配合） |
| 许可证费用 | 高（商业版数千元） | 高（商业版上万元） | 免费（GCC 开源） |
| 跨平台 | 仅 Windows | Windows/Linux | Windows/Linux/macOS |
| 适合场景 | 企业量产项目 | 对代码大小/速度要求苛刻 | 个人学习/开源项目 |
我个人习惯是：公司项目用 Keil，因为团队协作方便，调试器支持好。个人玩票用 VS Code + GCC，免费且灵活。IAR 我用的不多，但它在代码优化上确实有两把刷子，适合对 Flash 空间抠得紧的产品。
避坑指南：我曾经在 VS Code 上折腾了整整一天，就为了配置 J-Link 的调试路径。后来发现是插件版本不兼容。如果你也是新手，我建议先从 Keil 入手，等熟悉了再尝试 VS Code 方案。
2.2 STM32/GD32：标准库 vs HAL 库
这是另一个让新手纠结的问题。我直接说结论：
- 标准库：直接操作寄存器，代码执行效率高，但开发周期长。适合对时序要求苛刻的场景，或者你希望深入理解 MCU 底层。
- HAL 库：封装了底层细节，API 统一，开发速度快。适合项目周期紧、或者需要快速验证方案的情况。
我的建议是：学的时候用标准库打基础，做项目用 HAL 库提效率。但不管用哪个，分层架构的思想是一样的。我们会在驱动层对 HAL 库或标准库再做一层封装，这样上层代码就与具体库解耦了。
关键点：无论你选标准库还是 HAL 库，最终都要在它们之上构建一层“硬件抽象层（HAL，Hardware Abstraction Layer）”。这层的作用是：让上层业务代码不直接调用 ST 或 GD 的库函数，而是调用你自己定义的接口。这样以后换芯片，只需要重写这层抽象。
三、本章知识体系：一张图看懂分层架构
下面这张 SVG 图，是我手绘的分层架构核心逻辑。你仔细看一遍，就能明白我们这门课要做什么。
这张图就是我们这门课的骨架。从上到下依次是：应用层 → 协议层 → 硬件抽象层 → MCU 硬件层。每一层只通过固定的接口与相邻层通信。你想想看，如果每一层都做好自己的事，整个系统就像搭积木一样清晰。
四、本章小结
这一章我们主要做了三件事：
- 理解了分层架构的必要性——不是为了炫技，而是为了少改代码、好维护。
- 明确了课程目标与学习路径——从环境搭建到协议栈整合，一步步来。
- 对比了开发环境与库的选择——Keil 适合量产，VS Code 适合学习；标准库打基础，HAL 库提效率。