1. 课程导学与背景：为什么需要分层架构？
大家好，我是你们这门课的老朋友。做了十几年单片机开发，踩过的坑比写过的代码还多。今天咱们先不急着敲键盘，坐下来聊聊一个根本问题：为什么你的单片机代码，需要分层？
你想想看，是不是经常遇到这种情况——项目刚开始时信心满满，一个 main 函数从头写到尾，逻辑清晰得很。可三个月后，客户说要加个新功能，你打开工程文件，看着那一两千行的“大泥球”，头皮发麻。改一个定时器参数，结果串口不发了；调一下按键扫描，LED 闪烁频率全乱了。
嗯，这其实就是典型的“裸奔式开发”后遗症。
1.1 单片机软件开发的真实痛点
我刚开始带团队那会儿，接手过一个智能家居网关项目。代码是前任工程师留下的，一个 while 循环里塞了传感器采集、Wi-Fi 通信、OLED 显示、按键处理、还有三个状态机。你猜怎么着？每次加功能，都要把整个 main.c 翻一遍，生怕动错一个全局变量。
这种开发模式，我给它起了个名字——“大循环绞肉机”。它的典型症状包括：
- 耦合度极高：硬件操作和业务逻辑混在一起，换个 MCU 型号，代码基本重写
- 可读性差：三个月前的代码，自己都看不懂，更别说交接给新人
- 调试困难：一个 bug 可能藏在五个模块的交互里，断点都不知道往哪打
- 复用率低：这个项目的代码，下个项目基本不能用，每次都是“从零开始”
核心矛盾：硬件平台越来越复杂（多核、多外设、低功耗），但我们的软件架构还停留在“把所有代码塞进一个 while(1)”的原始时代。
为什么会这样？说白了，很多工程师把单片机开发等同于“写寄存器”。觉得分层、抽象、模块化是 Linux 或 PC 端才需要的东西。我早期也这么想，直到有一次产品量产了才发现一个时序 bug，需要改 PCB 才能解决……那次教训让我明白：软件架构的债，迟早要用硬件成本来还。
1.2 从“裸机”到“分层”的演进之路
咱们回顾一下单片机软件的进化史，其实很有意思。我把它分成三个阶段：
| 阶段 | 典型特征 | 痛点 | 适用场景 |
|---|---|---|---|
| 原始裸机 | 所有逻辑在 main 循环，轮询处理 | 耦合高、难维护、几乎不可移植 | 极简系统（如单按键控制 LED） |
| 中断+前后台 | 中断处理紧急事件，主循环处理后台任务 | 中断优先级冲突、共享资源竞争 | 中等复杂度（如家电控制板） |
| 分层架构 | 硬件抽象层、驱动层、中间件层、应用层 | 初期设计成本高，需要规划接口 | 复杂系统（如物联网网关、工业控制器） |
我记得第一次尝试分层架构，是在一个 STM32F4 的项目上。当时要把一个老项目的代码从 F1 移植到 F4，原来的代码里 GPIO 操作、定时器配置、甚至延时函数都散落在各个模块里。移植了三天，我差点把键盘砸了。
后来我痛定思痛，花了两个晚上把硬件操作全部抽出来，封装成 hal_gpio.c、hal_timer.c、hal_uart.c。应用层只调用这些接口，再也不直接操作寄存器。你猜结果如何？第二次移植到 G0 系列，只改了一个头文件，一天搞定。
我的经验：分层不是“过度设计”。对于超过 5000 行的项目，或者需要跨平台移植的代码，分层架构带来的维护效率提升，远超初期那点设计成本。
1.3 分层架构到底长什么样？
说了这么多，咱们直接上图。下面这张图是我个人习惯使用的四层架构，也是本课程的核心框架：
这张图我用了好多年，每次给新人培训都会拿出来讲。它的核心思想就一句话：上层只管“做什么”，下层只管“怎么做”。
- 应用层：你的业务逻辑、状态机、任务调度。比如“按键按下三次，进入配置模式”——这是应用层的事。
- 中间件层：通用的软件组件。比如 TCP/IP 协议栈、FreeRTOS、FATFS 文件系统。它们不关心你用什么 MCU。
- 硬件抽象层：把芯片厂商的 HAL 库再包一层，统一接口。比如
hal_uart_send()，不管底层是 STM32 还是 GD32，上层调用都一样。 - MCU驱动层：直接操作寄存器、中断服务函数、启动代码。这部分是芯片相关的，换 MCU 就换这一层。
避坑指南：我曾经在一个项目里，把 HAL 层和驱动层混在一起写。结果换了芯片型号，驱动层和 HAL 层都要改，等于白分层。记住：HAL 层是“接口标准”，驱动层是“芯片实现”，两者必须物理分离。
1.4 分层架构带来的实际收益
说了这么多理论，咱们来点实际的。我统计过几个项目的维护成本，数据如下：
| 项目类型 | 代码量 | 架构方式 | 新增功能平均耗时 | Bug 修复平均耗时 |
|---|---|---|---|---|
| 智能插座 | ~3000 行 | 裸机大循环 | 2.5 天 | 1.8 天 |
| 智能插座 v2 | ~4500 行 | 分层架构 | 0.8 天 | 0.5 天 |
| 工业数据采集器 | ~12000 行 | 裸机+中断 | 5.0 天 | 3.2 天 |
| 工业数据采集器 v2 | ~18000 行 | 分层+RTOS | 1.5 天 | 0.8 天 |
你看，分层架构在初期确实要多花一点时间设计接口和划分模块。但一旦进入维护期和迭代期，效率提升是几何级的。说白了，分层架构是对未来的投资——你现在省下的设计时间，将来会以十倍的时间还回来。
1.5 本课程能给你什么？
这门课不是讲空洞的理论。我会带着你，从零开始搭建一套完整的、可复用的单片机软件框架。内容包括：
- 任务调度器：从简单的轮询调度，到时间片轮转，再到协作式多任务
- 状态机设计：从 switch-case 到层次状态机，再到状态表驱动
- 分层实战：手把手教你划分模块、定义接口、实现解耦
- 代码模板：直接可用的工程模板，拿来就能用
我建议你准备好一个开发板（STM32 或 GD32 都行），跟着课程一步步敲代码。光看不练，永远学不会分层。