1. 课程导论与项目全景：为什么需要分层架构？状态机在嵌入式中的核心地位

各位同学，欢迎来到这门实战课。我是你们的老朋友，一个在单片机圈子里摸爬滚打了十几年的工程师。今天咱们不聊虚的，直接切入正题——为什么你的代码总是改一处崩一片？为什么别人写的程序能轻松移植到不同芯片上，你的却只能焊死在原平台？

说白了，这背后就两个核心问题：架构混乱和逻辑不清。而解决它们，正是本课程要教给你的本事。

1.1 我踩过的坑：没有分层架构的惨痛教训

我记得刚入行那会儿，接手过一个智能灯控项目。老板催得急，我图省事，把所有代码——LED驱动、按键扫描、定时逻辑、甚至Wi-Fi通信——全塞进了一个 main.c 文件里。当时觉得挺爽，两千行代码一把梭，编译通过就跑。

结果呢？三个月后客户要换MCU，从STM32F103换成GD32F103。我本以为只是改改寄存器，打开代码一看，头皮发麻——LED的GPIO配置和按键消抖逻辑混在一起，定时器中断里还调用了Wi-Fi的发送函数。改一处，崩三处。最后整整花了两周才把移植搞定，还被老板骂了一顿。

这个教训让我明白了一个道理：没有分层架构的代码，就是给自己埋雷。

1.2 分层架构到底长什么样？

咱们用一张图来直观感受一下。下面这个SVG图，就是我在实际项目中反复打磨出来的分层模型。

你看，从上到下分四层：

• 应用层：只管业务。比如“离家模式”要关灯、关空调、布防。它不关心用哪个GPIO口。
• 状态机调度层：这是本课程的重头戏。它负责事件分发和状态流转，是整个系统的“大脑”。
• 中间件层：封装通用组件。比如MQTT客户端、环形缓冲区、软件定时器。这些代码可以跨项目复用。
• 硬件抽象层：最底层。每个芯片的寄存器都不一样，但接口可以统一。比如 HAL_GPIO_WritePin()，换芯片后只改这个函数体。

1.3 状态机：嵌入式系统的“大脑”

好，架构有了，那逻辑怎么组织？很多新手喜欢用一堆 if-else 和 flag 变量来控制流程。你想想看，一个按键要处理单击、双击、长按、组合键，用 if 嵌套写出来是什么样子？

// 反面教材：flag地狱
if (key_pressed) {
    if (key_count == 1) {
        if (timer_10ms) {
            // 单击处理
        }
    } else if (key_count == 2) {
        // 双击处理
    }
    // 还有长按、超时... 写到后面自己都看不懂
}

这种代码，我称之为“面条代码”。看着能跑，但改起来要命。我曾经在一个项目中，因为加了一个“长按3秒进入配置模式”的功能，结果把双击逻辑搞崩了。排查了两天才发现是某个 flag 没清零。

状态机就是来解决这个问题的。它把系统的行为拆解成若干个“状态”，每个状态只处理自己该做的事。状态之间通过“事件”来迁移，逻辑清晰得像一张地图。

咱们用一张图来展示一个典型的状态机——智能家居中控面板的按键处理：

看到没？每个状态都是一个独立的“小世界”。在“空闲”状态，我只检测按键是否按下。在“单击等待”状态，我只等待超时或第二次按下。互不干扰。

1.4 本课程项目全景：智能家居中控面板

光讲理论没意思，咱们得动手干。本课程会带着大家从零到一，完成一个智能家居中控面板项目。这个项目麻雀虽小，五脏俱全。

模块	功能描述	涉及技术点
触摸按键	支持单击、双击、长按、组合键	状态机、消抖、定时器
LCD显示	显示时间、温度、设备状态	驱动分层、字库渲染、菜单框架
Wi-Fi通信	连接云端，接收控制指令	AT指令解析、MQTT协议、环形缓冲区
传感器采集	温湿度、光照强度	I2C驱动、数据滤波、校准算法
继电器控制	控制灯光、窗帘、插座	GPIO输出、过零检测、PWM调光
电源管理	低功耗模式、电池电量监测	休眠唤醒、ADC采样、电量曲线

这个项目我会带着大家一步步做。从需求分析、架构设计，到代码实现、调试排错，最后到移植适配——换一个不同品牌的MCU，看看我们的分层架构到底有多“硬”。

1.5 为什么这门课值得你花时间？

说实话，网上讲单片机的教程很多。但大部分都在教你怎么点亮一个LED、怎么用定时器。这些当然重要，但它们是“点”，不是“面”。

真正让一个工程师从“会写代码”升级到“会设计系统”的，是架构思维和状态机思维。这两样东西，不是靠看芯片手册能学会的，得靠实战、靠踩坑、靠复盘。

我在这个课程里，会把我在十几个项目中积累的“血泪经验”毫无保留地分享出来。包括：

• 分层时接口怎么定义才够“干净”？
• 状态机的事件队列用环形缓冲区还是链表？
• 移植时HAL层要封装到什么粒度？
• 调试状态机时，怎么打印状态迁移日志？

这些细节，才是决定项目成败的关键。