Skip to content

状态模式:让嵌入式行为随状态而变 ​

嵌入式程序里的同一个事件,在不同状态下常常需要执行不同动作。播放器的播放事件,在待机时应从头开始,在暂停时应恢复进度;在关机时则不应该执行。

把这些规则散落在布尔变量和多层条件判断中,状态一多,非法组合和资源清理很容易遗漏。状态模式把变化集中到「当前状态 + 输入事件 → 允许的行为」上,让规则可以检查,也可以验证。

本文的实现方式

原项目是 C++17 的表驱动 / 状态处理函数有限状态机,没有为每个状态创建一个继承对象。它是嵌入式常用的状态模式落地方式,与经典 GoF 的状态对象实现形式有所不同。

四个概念 ​

概念含义播放器中的例子
状态 State系统当前处境Off、Standby、Play、Pause
事件 Event推动系统处理的一次输入On、Off、Play、Pause、LowBattery
守卫 Guard执行动作之前必须满足的条件电量必须大于 20%
动作 Action转移或进入/退出时执行的操作开电源、静音、启动、恢复

从播放器的转移表开始 ​

当前状态OnOffPausePlayLowBattery
OffStandby忽略忽略忽略忽略
Standby忽略Off忽略Play(电量 > 20%)Off
Play忽略OffPause忽略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广播、连接关闭、休眠、退避恢复
ButtonGPIO 电平 + 毫秒 tick稳定的按下/释放通知
PhaseUART 字节 + 毫秒 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-failure

Windows 需要可用的 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 移植契约保留在原项目说明中。

记录实践,持续学习。