状态模式:让嵌入式行为随状态而变
嵌入式程序里的同一个事件,在不同状态下常常需要执行不同动作。播放器的播放事件,在待机时应从头开始,在暂停时应恢复进度;在关机时则不应该执行。
把这些规则散落在布尔变量和多层条件判断中,状态一多,非法组合和资源清理很容易遗漏。状态模式把变化集中到「当前状态 + 输入事件 → 允许的行为」上,让规则可以检查,也可以验证。
本文的实现方式
原项目是 C++17 的表驱动 / 状态处理函数有限状态机,没有为每个状态创建一个继承对象。它是嵌入式常用的状态模式落地方式,与经典 GoF 的状态对象实现形式有所不同。
四个概念
| 概念 | 含义 | 播放器中的例子 |
|---|---|---|
| 状态 State | 系统当前处境 | Off、Standby、Play、Pause |
| 事件 Event | 推动系统处理的一次输入 | On、Off、Play、Pause、LowBattery |
| 守卫 Guard | 执行动作之前必须满足的条件 | 电量必须大于 20% |
| 动作 Action | 转移或进入/退出时执行的操作 | 开电源、静音、启动、恢复 |
从播放器的转移表开始
| 当前状态 | On | Off | Pause | Play | LowBattery |
|---|---|---|---|---|---|
| Off | Standby | 忽略 | 忽略 | 忽略 | 忽略 |
| Standby | 忽略 | Off | 忽略 | Play(电量 > 20%) | Off |
| Play | 忽略 | Off | Pause | 忽略 | Off |
| Pause | 忽略 | Off | 忽略 | Play(电量 > 20%) | Off |
最常见的一条路径是:
text
Off --On--> Standby --Play--> Play --Pause--> Pause
↑ |
+-----Play------+Standby → Play 调用 start();Pause → Play 调用 resume()。进入 Off 关闭音频资源,退出 Play 先静音。把这些动作集中到转移和进入/退出钩子里,可以减少遗漏清理路径的机会。
一次事件如何被处理
共用引擎的处理顺序如下:
text
检查状态/事件范围
→ enabled?否:Ignored
→ guard 通过?否:GuardRejected
→ 状态变化时执行 onExit(old)
→ transition.action
→ 更新当前状态
→ 状态变化时执行 onEntry(new)相同状态视为内部转移,只执行 action,不执行进入/退出。例如 BLE 接收有效活动时刷新监督时间,不需要断开连接再重新进入 Connected。
核心逻辑直接引用项目源码,避免文章与实际实现不一致:
cpp
/**
* @file StateMachine.hpp
* @brief 固定内存、表驱动的有限状态机基础组件(C++17)。
* @author 兆鸣嵌入式
*/
#ifndef STATE_MACHINE_HPP
#define STATE_MACHINE_HPP
#include <array>
#include <cstddef>
#include <cstdint>
namespace fsm {
enum class Result { Handled, Ignored, GuardRejected, InvalidEvent };
template <typename Enum>
constexpr std::size_t index(Enum value) noexcept
{
return static_cast<std::size_t>(value);
}
// 无符号差值支持正常的计时回绕,但不支持时钟被重置。
constexpr bool elapsed(std::uint32_t now, std::uint32_t since,
std::uint32_t interval) noexcept
{
return static_cast<std::uint32_t>(now - since) >= interval;
}
template <typename Owner, typename State>
struct Transition {
using Action = void (Owner::*)() noexcept;
using Guard = bool (Owner::*)() const noexcept;
State next;
Action action = nullptr;
Guard guard = nullptr;
bool enabled = true;
};
// 先推导实际初始化条目数,再检查是否完整。
// 直接初始化 std::array<T, N> 会将缺失的单元静默补零。
template <std::size_t Count, typename... Cells>
constexpr auto row(Cells... cells) noexcept
{
static_assert(sizeof...(Cells) == Count, "Missing event cell");
return std::array{cells...};
}
template <std::size_t Count, typename... Rows>
constexpr auto table(Rows... rows) noexcept
{
static_assert(sizeof...(Rows) == Count, "Missing state row");
return std::array{rows...};
}
template <typename Table>
constexpr bool validTargets(const Table& transitions) noexcept
{
for (const auto& row : transitions) {
for (const auto& cell : row) {
if (index(cell.next) >= transitions.size()) {
return false;
}
}
}
return true;
}
template <typename Owner, typename State>
struct Hooks {
using Hook = void (Owner::*)(State) noexcept;
Hook entry;
Hook exit;
};
// 串行分发事件,每次处理到完成;回调和动作不得递归投递到本状态机。
// 目标与当前状态相同视为内部转移,不执行退出和进入动作。
template <typename Owner, typename State, typename Event, typename Table>
Result dispatch(Owner& owner, State& state, Event event,
const Table& transitions, Hooks<Owner, State> hooks) noexcept
{
if (index(state) >= transitions.size() ||
index(event) >= transitions[0].size()) {
return Result::InvalidEvent;
}
const auto& cell = transitions[index(state)][index(event)];
if (!cell.enabled) {
return Result::Ignored;
}
if (cell.guard != nullptr && !(owner.*cell.guard)()) {
return Result::GuardRejected;
}
const bool changes = cell.next != state;
if (changes) {
(owner.*hooks.exit)(state);
}
if (cell.action != nullptr) {
(owner.*cell.action)();
}
state = cell.next;
if (changes) {
(owner.*hooks.entry)(state);
}
return Result::Handled;
}
} // 状态机基础组件命名空间
#endif // 状态机头文件保护结束时间也是输入
按键消抖需要的是「进入候选状态后,电平在采样点上保持稳定满 20ms」,而不是在函数中延时 20ms。
text
Released → DebouncePress → Pressed → DebounceRelease → Released
| |
+→ Released +→ Pressed
(按下抖动撤销) (释放抖动撤销)sample(level, now_ms) 不阻塞,任务按固定周期调用即可。无符号 tick 差值可以处理正常的 32 位计时回绕,但不能处理随意重置的时钟。
UART 同样需要时间驱动。每次输入一个字节保留解析进度,没有新字节时调用 tick(now_ms),释放超时的半帧。解析器负责结构和校验,业务层再检查命令及参数。
四个示例怎样组合
| 示例 | 输入 | 对外行为 |
|---|---|---|
| Blue | 控制器事件 + 毫秒 tick | 广播、连接关闭、休眠、退避恢复 |
| Button | GPIO 电平 + 毫秒 tick | 稳定的按下/释放通知 |
| Phase | UART 字节 + 毫秒 tick | 完整帧回调 / 错误结果 |
| Mode | 应用事件 + 电量测量 | 播放、暂停、恢复、关闭资源 |
实际设备中,Button 的按下通知和 Phase 的合法命令都可以映射为 Mode 的事件。把它们汇聚到播放器所属任务的有界队列,避免多个任务直接修改同一状态机。
编译与验证
从源码页面下载 state-pattern.zip 并解压,在解压目录运行:
sh
cmake -S . -B build
cmake --build build --config Debug
ctest --test-dir build -C Debug --output-on-failureWindows 需要可用的 C++ 工具链:Visual Studio C++、MinGW 或 Ninja 对应的编译器。使用 MinGW 时可为第一条命令追加 -G "MinGW Makefiles"。
四个 .cpp 都有独立 main(),不能链接为同一个程序。每个程序运行内置场景,成功打印 PASS,失败返回非零退出码;这些判断在 NDEBUG 下也不会被移除。
实机落地前的边界
- 状态机实例由一个任务串行调用;ISR 只采集并投递事件。
- 端口对象生命周期长于状态机;动作和同步回调必须短且非阻塞。
- 硬件提交成功不代表已经就绪。异步驱动应增加 Starting / Stopping 等中间状态,并等待完成或失败事件。
- BLE 示例只负责应用层链路控制,射频时序与 Link Layer 交给 Controller / 协议栈。
- UART 的 XOR 校验用于教学,生产协议应按实际需求选择 CRC、序号等机制。
完整的场景说明、边界验证和 MCU / RTOS 移植契约保留在原项目说明中。