嵌入式状态模式:四个真实场景的 C++17 示例
这里模拟电池供电、带 BLE 和 UART 接口的播放器控制面板。 四个 .cpp 各有独立的 main(),可以单独编译;不要把四个文件 链接为同一个可执行程序。Phase.cpp 沿用现有文件名,实际演示协议解析。
| 文件 | 真实使用场景 | 状态模式解决的问题 |
|---|---|---|
Blue.cpp | BLE 传感器、电子锁、播放器外设 | 广播、连接、超时恢复随链路状态改变 |
Button.cpp | 播放键、工业面板、低有效机械按键 | 抖动不会触发重复按下/释放 |
Phase.cpp | UART/DMA 控制帧、RS485 串口设备 | 数据分批到达时保留解析进度 |
Mode.cpp | 电池供电播放器、便携仪表 | 操作许可、资源启停随设备模式改变 |
StateMachine.hpp | Blue/Mode 共用的轻量基础设施 | 统一守卫、转移动作和进入/退出动作 |
这些是表驱动/状态处理函数形式的有限状态机,属于嵌入式常用的 状态模式实现。没有为每个状态构造一个继承对象;当状态需要独立的数据 与复杂行为时,再考虑 GoF 的 IState 对象形式或层级状态机。 硬件依赖通过小型虚接口注入,虚调用不要求动态内存,模拟对象在栈上创建。
编译和运行
在仓库根目录打开 PowerShell,使用 GCC:
powershell
New-Item -ItemType Directory -Force "State Mode/build" | Out-Null
g++ -std=c++17 -Wall -Wextra -Wpedantic -Wconversion -Wsign-conversion `
-Werror -fno-exceptions -fno-rtti "State Mode/Blue.cpp" `
-o "State Mode/build/Blue.exe"
& "./State Mode/build/Blue.exe"将 Blue 替换成 Button、Phase、Mode,即可分别运行。 Linux/macOS 同样使用 g++,去掉 PowerShell 换行符和 .exe 即可。 也提供 CMake/CTest:
powershell
cmake -S "State Mode" -B "State Mode/build/cmake" -G "MinGW Makefiles"
cmake --build "State Mode/build/cmake"
ctest --test-dir "State Mode/build/cmake" --output-on-failureWindows 使用该生成器需要 mingw32-make 在 PATH 中;也可换成 Ninja。 Visual Studio 可使用其默认生成器,运行 CTest 时加 -C Debug。 每个程序输出动作日志,最后打印 <名称>: PASS;验证失败退出码为 1。 验证采用运行时判断,即使定义 NDEBUG 也不会被移除。
Blue:BLE 外设链路控制
场景:传感器上电开始广播,手机连接后由控制器报告有效链路活动。 超过监督超时时间没有活动,则清理连接、复位控制器、退避后重新广播。
text
Idle --Start / radio.ready()--> Advertising
Advertising --Connected--> Connected
Advertising --Timeout(5000ms) / Fault--> Backoff
Connected --RxValid--> Connected(刷新监督时间)
Connected --Timeout(1000ms) / Fault--> Backoff
Backoff --Timeout(200ms) / radio.ready()--> Advertising
活动状态 --Stop--> Idle进入 Advertising 提交广播;退出时停止广播。退出 Connected 关闭连接; 进入 Backoff 复位控制器;进入 Idle 使无线电休眠。广播停止、连接关闭、 休眠和复位接口必须可重复调用,构造前无线电驱动应已初始化。
RadioPort::nextEvent() 每次最多取一个事件,不等待无线电。 驱动自己的工作任务周期调用 poll(now_ms),演示中的 main() 代替任务推进时间。当前批次的连接完成或有效接收优先于软件超时; 无关事件不会阻止超时检查。实际事件队列应有容量限制和溢出处理, 并使用控制器事件时间戳/会话编号处理积压、断连后迟到的旧事件。
边界:这不是完整 BLE Link Layer 实现。 广播信道调度、连接事件、 CRC、重传、加密和微秒级射频时序交给芯片的 Controller/协议栈。 这里的超时值用于模拟,不代表所有 BLE 连接都采用 1000ms;实机应使用 协商后的 connection supervision timeout。RxValid 指控制器确认的 有效链路活动,不等同于应用收到一条 GATT 通知。
验证包含控制器未就绪的守卫拒绝、连接、有效接收刷新、监督超时、 无关事件下的超时、广播超时、退避守卫、故障恢复、停止和无效事件。
Button:面板按键消抖
场景:GPIO 配置上拉,按下为 Low,释放为 High。
text
Released --Low--> DebouncePress
DebouncePress --High--> Released(抖动撤销)
DebouncePress --Low 持续20ms--> Pressed(仅通知一次 Pressed)
Pressed --High--> DebounceRelease
DebounceRelease --Low--> Pressed(抖动撤销)
DebounceRelease --High 持续20ms--> Released(仅通知一次 Released)驱动任务建议每 1~5ms 读取一次 GPIO,再调用 sample(level, now_ms)。 函数不延时、不忙等;进入候选状态时记下时间,相同电平不会重复重置计时。 这里的“持续”是采样点观测到的持续:无法检测两次采样之间的短脉冲。 示例中的稀疏时间点仅为了展示边界条件,实机必须保证采样周期。
初始状态为 Released,因此启动时已按住也会在消抖后产生 Pressed。 通知接收者应将 Pressed 映射为设备事件,而不是在 GPIO ISR 中播放音频。 长按、双击可以在稳定 Pressed/Released 事件之上另建手势状态机, 不要把手势识别混进底层消抖逻辑。
验证包含按下/释放抖动、恰好20ms的阈值、长时间按住不重复通知、 32位 tick 回绕和非法电平值。
Phase:UART 流式协议解析
场景:上位机通过 UART 发送读取状态、播放和参数设置命令; DMA 的一块数据可能只有半帧,也可能包含多帧。
演示协议(所有字段为字节):
text
AA 55 | LEN | CMD | PAYLOAD[LEN] | XOR
XOR = LEN ^ CMD ^ PAYLOAD[0] ^ ... ^ PAYLOAD[LEN-1]
LEN 范围为 0~16,不包含 CMD 或校验字节。
示例:AA 55 02 10 01 02 11状态:SyncFirst -> SyncSecond -> Length -> Command -> Payload -> Checksum。 零长度从 Command 直接进入 Checksum。每次 feed(byte, now_ms) 处理一个 字节,因此天然支持拆包和粘包;负载中的 AA/55 不会被误当成帧头。 AA AA 55 保留第二个 AA 作为候选帧头。
长度超限返回 InvalidLength;校验失败返回 ChecksumError; 失败后重新搜帧头,拒绝的字节本身若为 AA,会保留为下一帧起点。 这属于简单恢复策略:丢字节或插入字节后,不能保证立即找回真实帧界; 可能需要下一完整帧或超时后恢复。 生产协议可采用 CRC16/CRC32、转义编码、序号和版本字段。 XOR 只用于教学,无法检测所有多字节错误,更不提供认证。
任务在每块 DMA 数据中依序遍历字节,检查每次返回值;没有新字节时 也要调用 tick(now_ms),使部分帧在50ms字节间超时后释放。 超时后的新字节仍会被当作新帧候选处理;超时恰好50ms即生效。 实机超时要兼顾波特率、DMA 批次间隔与任务延迟。当前 now_ms 是交付时间而非线上的到达时间;需要精确字节间超时时应传入采集时间。
完整帧通过 FrameSink::onFrame() 同步交付。该引用仅在回调期间有效, 只读取 payload[0..length);排队时必须复制有效负载或整个 Frame。 解析器只做结构/校验检查,命令白名单与参数合法性由命令处理层负责。
验证包含独立固定校验向量、半包、连续帧、零负载、最大负载、 负载内帧头、坏校验、超长长度、噪声、重复 AA、接收静默超时、 tick 回绕以及“超时同时到来下一帧头”的恢复。
Mode:电池供电播放器模式
| 当前状态 | On | Off | Pause | Play | LowBattery |
|---|---|---|---|---|---|
| Off | Standby | 忽略 | 忽略 | 忽略 | 忽略 |
| Standby | 忽略 | Off | 忽略 | Play,电量>20% | Off |
| Play | 忽略 | Off | Pause | 忽略 | Off |
| Pause | 忽略 | Off | 忽略 | Play,电量>20% | Off |
Standby 的 Play 从头启动解码;Pause 的 Play 恢复保存的位置。 退出 Play 先静音;进入 Off 停止解码并断电;进入 Standby 打开电源。 AudioPort::start()/resume() 应恢复输出,powerOff() 必须清理音频资源。 启动时硬件初始化应已完成,构造会执行 Off 的进入动作以确保关闭输出。
低电量由电源管理模块检测并投递 LowBattery;setBattery() 只更新测量, 不会自动关机,因此播放中必须继续监测电量。关机后 On 可进入 Standby, 但电量不足时仍不能开始/恢复播放。电量20%恰好不满足 >20%。
相较原示例,修正了 Standby + Pause 错误跳到 Off 的条目; 无效事件在索引前拒绝,状态和转移表不再公开。 验证覆盖原有开机/播放/暂停/恢复/关机链路、守卫拒绝、低电量关机、 重复事件、非法电量和无效枚举。
共用机制与扩展方式
Transition 使用成员函数指针和统一签名,守卫是 const noexcept 成员函数;表是 static constexpr,所有实例共享,无捕获 this。 状态机、缓冲区和示例对象自身不动态分配内存;桌面 printf/puts 属于模拟端口的日志,标准 I/O 内部的资源使用不属于这个保证。 std::function 可能使用 SBO 或分配堆内存,不能假定捕获 this 一定分配; 这里移除它以获得固定大小和更明确的调用开销。
fsm::row<EventCount>() 和 fsm::table<StateCount>() 先推导实际条目数量, 再静态检查,缺一个事件单元或状态行会编译失败;validTargets() 校验每个目标状态。Button/Phase 同样以推导数组检查状态处理函数数量。 这些检查不能证明业务转移正确,也不能检测“交换了两个事件列”,因此 枚举必须从0连续递增、Count 放最后,修改时保持表顺序一致并运行场景。
真正的状态变化执行:
text
检查事件范围 -> 检查 enabled -> guard
-> onExit(old) -> transition.action -> 更新状态 -> onEntry(new)忽略和守卫失败不执行任何动作。相同状态是内部转移,仅执行其 action, 不会调用退出/进入动作,例如 BLE 接收刷新。初始进入动作由构造函数 显式调用。基础引擎没有“退出后失败再回滚”的语义:当前硬件命令约定 为立即返回的幂等提交。若存在异步失败或电源稳定时间,应增加 Starting/Stopping/Powering 等状态,等待完成/失败事件并设置超时, 不能在 action 中延时或等待,也不能假装命令一提交硬件就已经就绪。
扩展示例:增加设备状态/事件,补齐 Mode 表及对应动作;增加协议命令 只修改命令处理层;更换 MCU 只替换端口适配器;多个按键各创建一个 Button 实例,共享事件接收者。状态很多且重复转移增多时,采用层级 状态机,不要继续无限扩大密集的 State×Event 表。
MCU/RTOS 移植契约
- 先初始化时钟、GPIO、UART/DMA、BLE 和音频驱动,再构造对应状态机。 端口和接收者的生命周期必须长于状态机;对象不可复制。
- 移除桌面
main()和 Sim 类,生产模块拆为.hpp/.cpp并移出匿名 命名空间;保留此处的接口、状态和时间逻辑。头文件示例已包含保护宏。 - 从平台时间服务传入单调递增的32位毫秒 tick,不在业务层直接访问 HAL。 当前无符号差值支持正常回绕,不支持重置时钟或随意倒退;所有配置 间隔应小于2^31ms,服务间隔要足够短且不能漏掉整个2^32ms周期。
- 所有 API 都由同一个所属任务串行调用;这些对象不是线程安全的。 ISR 只采集/投递至有界队列,DMA 使用前处理好缓冲区所有权与缓存一致性。 不靠
volatile解决队列同步或数据竞争。 - 回调在调用 sample/feed 的任务上下文同步执行,必须短且非阻塞, 不可递归进入同一状态机。耗时业务投递到其它任务,并处理队列满。
- 实机端口必须非阻塞且不抛异常;桌面控制台输出可能阻塞,不能照搬为 ISR/实时任务日志。引擎本身无 sleep、忙等、堆分配、递归或 HAL 依赖。
- 使用完成后先向 BLE 投递 Stop、播放器投递 Off 并处理完,再停任务、 注销外部事件来源并销毁对象;析构函数不会自动发出硬件关闭指令。
- 本例仅验证桌面控制逻辑。实际栈预算、任务周期、队列溢出、驱动延迟、 DMA/寄存器行为和射频参数需要在选定 MCU/BSP 上测量验证。
这些接口可直接组合为控制面板:Button 的 Pressed 经应用映射为 Mode 事件;Phase 的合法命令转换为同类事件;BLE 的控制器事件进入 BleLink。 三个输入来源应汇聚到播放器所属任务的事件队列,避免跨任务直接修改状态。