这是 QP 状态机入门系列第七篇,文章重点拆解 QP 框架里层次状态机 HSM 和事件驱动运行机制,结合前面 Blinky 点灯实例解释 QP 为什么不需要轮询代码,核心是依靠事件投递、状态调度、Run-to-Completion 运行语义,把传统嵌入式里大量 if-else 标志位的面条代码换成标准化 UML 状态图实现;很多初学者容易混淆 QP 里信号、事件、活动对象 AO 这几个概念,这篇把 QEvt 结构体、事件投递接口、事件内存管理分开讲解,同时对比普通扁平有限状态机 FSM 和 QP 层次状态机 HSM 的差异,说明状态继承、父状态共享动作是 HSM 最大优势。QP 框架核心是 QEP 事件处理器,搭配 QF 事件框架,活动对象 AO 内部绑定一台层次状态机,事件有两种投递方式,点对点 POST 投递和全局 PUBLISH 订阅广播,事件本身只携带信号编号和引用计数,不绑定接收对象,一份事件可以发给单个或者多个 AO。Blinky 示例里定时器产生 TIMEOUT 事件,状态机收到事件之后完成状态跳转,执行进入动作、退出动作、转移动作,全程不阻塞、不轮询,main 函数只调用 QF_run () 进入事件循环。想要吃透这一节,重点理解事件生命周期、run-to-completion 语义、状态嵌套继承,这三点也是 QP 和普通手写状态机最大区别。
QP 状态机核心概念对照表
| 概念 | 说明 | 典型示例 |
|---|---|---|
| 信号 Signal | 事件类型 ID,数值常量 | TIMEOUT_SIG、BUTTON_PRESS_SIG |
| 事件 Event | QEvt 结构体实例,信号 + 引用计数 | 队列里等待处理的超时事件 |
| 活动对象 AO | 带独立事件队列的封装对象,内部挂载一台 HSM | Blinky 点灯对象 |
| 层次状态机 HSM | UML 状态图,支持状态嵌套、行为继承 | QP 主推,替代扁平 FSM |
| Run-to-Completion | 事件处理必须一次性跑完,中途不阻塞 | 收到事件→处理完成,再取下一个事件 |
| 投递接口 QACTIVE_POST | 点对点发给指定 AO | Blinky 内部给自己发超时事件 |
| 投递接口 QF_PUBLISH | 广播发布,订阅的 AO 都接收 | 按键事件广播给多个模块 |
QP 事件完整流转清单
- 事件源产生事件:定时器、外部中断、其他 AO、串口解析;
- 从事件池分配 QEvt 内存,标记信号 sig,初始化引用计数 refCtr_;
- 选择投递方式:QACTIVE_POST 单点投递 / QF_PUBLISH 广播;
- 事件进入目标 AO 的私有事件队列排队;
- QF 调度取出队首事件,交给 AO 内部 HSM 的 dispatch 分发函数;
- 状态机匹配当前状态 + 信号,执行转移、退出动作、进入动作;
- 事件处理完毕,引用计数递减,计数归零之后归还事件内存池。
边界区分
✅ HSM 优势:父状态公共行为可以复用,减少大量重复代码,解决扁平 FSM 状态爆炸
✅ Run-to-Completion:禁止在状态动作里面写 delay、阻塞等待
⚠️ 事件特点:事件本身无接收方信息,接收方由投递接口和订阅关系决定
❌ 误区:QP 不是 RTOS,QP 是事件驱动框架,可搭配 QV/QK 内核,也能对接第三方 RTOS
【常见问题】
问题 1:从零开始学 QP 状态机系列第七篇详解状态机,QP 里事件和信号有什么不一样?
回答 1:从零开始学 QP 状态机系列第七篇详解状态机,QP 中信号是代表事件类型的数字常量,事件是 QEvt 结构体实例,信号是类型,事件是存放在内存里的实例,同一个信号可以生成多个事件。
问题 2:从零开始学 QP 状态机系列第七篇详解状态机,QP 状态机为什么不需要轮询代码?
回答 2:从零开始学 QP 状态机系列第七篇详解状态机,QP 是事件驱动架构,依靠中断、定时器产生事件入队,框架调度分发事件,只有事件到来才执行对应逻辑,不需要 while 循环轮询标志位。
问题 3:从零开始学 QP 状态机系列第七篇详解状态机,QP 的层次状态机 HSM 对比普通 FSM 好在哪?
回答 3:从零开始学 QP 状态机系列第七篇详解状态机,QP 层次状态机 HSM 支持状态嵌套,子状态可以继承父状态的公共处理逻辑,避免扁平 FSM 出现大量重复转移代码,缓解状态爆炸问题。
问题 4:从零开始学 QP 状态机系列第七篇详解状态机,QP 中 QACTIVE_POST 和 QF_PUBLISH 两种发事件方式差别是什么?
回答 4:从零开始学 QP 状态机系列第七篇详解状态机,QACTIVE_POST 是点对点投递事件给指定单个活动对象 AO;QF_PUBLISH 是广播事件,所有订阅该信号的活动对象都能收到这个事件。
【参考资料】
[2026-11-14](从零开始学 QP 状态机系列 —— 第七篇:详解状态机)电子工程专辑
[2026-11-14](QP 状态机事件与信号机制详解)电子工程专辑
[2026-11-10](QP 框架入门:活动对象 AO 与事件驱动模型)Quantum Leaps 官网
[2026-11-08](QP HSM 层次状态机 UML 语义说明)Quantum Leaps 官网
[2026-11-05](从零开始学 QP 状态机第六篇:Blinky 工程跑通)电子工程专辑
【免责声明】
本文仅为 QP 状态机系列文章资讯整理,QP 框架属于轻量级嵌入式事件驱动框架,状态机代码、事件投递逻辑需要结合硬件 BSP、内核版本适配;本文不构成嵌入式产品开发、功能安全项目方案建议,QP 正式技术规范、授权协议以 Quantum Leaps 官方文档为准。
