我先核查电商清单技能可用性,并联网检索 QP 状态机框架与状态机详解的权威资料。
我再检索中文社区是否有该 QP 状态机系列教程及相关概念解释,补充交叉信源。
核心结论: QP(Quantum Platform)是 Quantum Leaps 推出的轻量级实时嵌入式框架,它用 "主动对象(Active Object/Actor)+层次状态机(HSM,UML statecharts)" 的方式组织事件驱动应用。所谓状态机,就是用一组有限的状态、事件和状态迁移来描述对象行为:外部事件进来后,当前状态判断是否处理,处理完执行对应动作或迁移到另一个状态。QP 框架在传统扁平有限状态机(FSM)之上引入状态嵌套,子状态只写与父状态不同的行为,公共行为上收到父状态复用,从而避免重复代码和 "状态迁移爆炸"。理解 QP 状态机需要同时掌握三层内容:UML 状态机本身的概念元素、主动对象与事件驱动的运行语义,以及 QP 框架组件(QEP/QF/ 内核 / QS)如何把状态机落地到裸机或 RTOS 之上。
一、QP 框架与状态机在其中的位置
QP 家族包含 QP/C、QP/C++ 和裁剪版 QP-nano,定位是可替代或补充传统 RTOS 的实时嵌入式框架。状态机不是孤立的一段代码,而是跑在框架提供的事件驱动基础设施之上:
| 框架组件 | 职责 |
|---|---|
| QEP | 层次事件处理器,负责按 UML statechart 语义分发事件、执行迁移和 entry/exit 动作 |
| QF | 事件驱动框架,提供事件队列、事件内存池、时间事件、直接投递与发布 - 订阅机制 |
| QV / QK / QXK | 内置内核:QV 协作式内核;QK 抢占式非阻塞内核;QXK 抢占式双模式内核,可与传统阻塞代码混合 |
| QS | 软件追踪组件(Q-Spy),用于实时监控、记录和基于追踪的测试 |
框架可在裸机单片机上独立运行,也可移植到第三方 RTOS 和 Windows、Linux、macOS 等桌面系统;官方概览口径下,QP/C 与 QP/C++ 约需 4KB 代码、1KB RAM,QP-nano 约需 2KB 代码、0.5KB RAM。配套有 QM 图形建模与代码生成工具,参考书为 Miro Samek 所著《Practical UML Statecharts in C/C++, 2nd Edition》。
二、状态机基本概念:FSM 与 HSM
1. 扁平有限状态机(FSM)
- 状态:只保存与系统行为相关的历史信息,用单一状态变量表示,而不是靠整个调用栈记录走到了哪一步。
- 事件:触发状态判断的输入,如按键、超时、串口接收、定时器到期。
- 迁移:在某个状态下收到特定事件后,从当前状态转到目标状态,并执行相应动作。
- 局限:所有状态平级排列,多个子状态共享的行为必须在每个状态里重复写;状态和事件一多,就容易出现重复代码和状态迁移数量爆炸。
2. 层次状态机(HSM)
HSM 允许一个状态嵌套在另一个状态内部,核心规则是:
- 事件进来后,先询问最内层的当前状态;
- 内层状态不处理,就把事件向上交给父状态;
- 父状态仍不处理,再继续向上交,直到顶层状态丢弃事件。
这种 "往上交" 的行为继承,本质类似面向对象里的方法继承:子状态只写自己跟父状态不一样的地方,公共行为放在父状态统一维护。以播放器为例,"运行中" 作为父状态统一处理音量、静音,"播放"" 暂停 " 作为子状态只处理各自的播放 / 暂停切换;子状态也可以认领某个事件但不做事,从而覆盖父状态的默认行为。
3. 状态机与流程图的区别
| 对比项 | 状态机(事件驱动) | 流程图(顺序处理) |
|---|---|---|
| 表达对象 | 系统的所有状态 | 处理过程的各个阶段 |
| 驱动方式 | 由显式事件驱动 | 节点完成后自动走向下一节点 |
| 处理位置 | 发生在迁移弧(transitions)上 | 发生在节点(nodes)内 |
| 时间概念 | 没有 "按进度推进" 的固定方向 | 从起点到终点顺序推进 |
三、UML 状态机核心元素
结合 QP 官方文档中的计算器示例,一个层次状态机通常包含以下元素:
| 元素 | 含义 |
|---|---|
| 初始伪状态(initial pseudo-state) | 状态机启动后的默认起点,每个状态机有且仅有一个,约定名为 initial |
| 简单状态(simple state) | 没有内部嵌套结构的状态 |
| 复合状态(composite state) | 包含子状态的父状态,也称超状态(superstate) |
| 子状态(substate) | 嵌套在超状态内部的状态,只定义差异行为 |
| 入口动作(entry action) | 进入该状态时执行一次的动作 |
| 出口动作(exit action) | 退出该状态时执行一次的动作 |
| 初始迁移(initial transition) | 进入复合状态后,默认落到哪个嵌套子状态 |
| 常规迁移(regular transition) | 满足事件 / 条件时从当前状态转到目标状态 |
| 选择点(choice)+守卫条件(guard) | 迁移前按条件分支判断,决定走哪条目标路径 |
| 顶层状态(top) | 隐含的根状态,所有未被认领的事件最终在此被忽略 |
四、事件、主动对象与 RTC 语义
1. 事件与通信
- 事件(QEvt):基础是信号(signal),可携带任意参数;QP 支持带动态参数的事件。
- 时间事件(QTimeEvt):用于超时、周期触发等基于事件的定时服务。
- 通信方式:主动对象之间通过事件队列异步投递事件,支持直接事件投递和发布 - 订阅模式;生产者把事件投递到接收方队列后不等待处理,事件始终在接收方线程上下文中处理。
2. 主动对象三要素
QP 中的主动对象(QActive)同时包含:
- 一个状态机(由 QHsm 层次状态机类派生);
- 一个事件队列;
- 一个带唯一优先级的执行线程。
主动对象把线程数据封装在对象内部,线程之间通过事件对象异步通信,主线程是一个事件循环,避免共享全局变量和显式互斥带来的并发风险。
3. Run-to-Completion(RTC)语义
- 每个主动对象一次只处理一个事件,必须把当前事件处理完,才开始处理队列中的下一个事件。
- RTC 是所有状态机形式化(包括 UML statecharts)通用的事件处理语义。
- RTC 不等于线程不能被抢占:在 QK 等抢占式内核中,线程可以被高优先级抢占,但单个事件的处理仍然是完整跑完的。
五、QP 框架中的状态机实现方式
1. 类与状态处理函数
- QP 中层次状态机表示为 QHsm 抽象基类的派生类;QMsm、QActive、QMActive 等也都继承自 QHsm。
- 每个状态对应一个状态处理函数,典型签名为:接收对象指针 me 和事件指针 e,返回一个状态机处理结果。
- 状态函数内部完成动作后,需要告诉事件处理器下一步做什么:
| 返回标识 | 含义 |
|---|---|
| Q_RET_HANDLED | 事件已在当前状态处理 |
| Q_RET_IGNORED | 事件被忽略,继续向上层交 |
| Q_RET_TRAN | 触发一次状态迁移到目标状态 |
| Q_RET_SUPER | 指定当前状态的父状态(行为继承方向) |
| Q_RET_EXIT | 状态出口动作处理 |
| Q_RET_ENTRY | 状态入口动作处理 |
2. 两种编码策略
- QHsm 策略:适合手工编码,状态机元素直接映射为可读、可移植的 C/C++ 代码。
- QMsm 策略:由 QM 图形建模工具自动生成代码,适合用模型化设计维护复杂状态机。
3. 可追溯性
QP 实现的一个特点是可追溯性:每个状态机元素都能直接、精确、无歧义地对应到代码。从需求到设计再到代码保持对应,对医疗器械、航空等安全关键系统尤其重要。
六、用 QP 落地一个状态机的步骤清单
- 划分主动对象:梳理系统需求,把具备独立行为的实体拆成主动对象,分配各自资源,明确对象之间交换的事件。
- 定义信号与事件:枚举事件信号,确定哪些事件需要携带参数(如串口数据、传感器读数)。
- 设计状态机:画出 UML statechart,确定状态层级、初始迁移、迁移路径、入口 / 出口动作和守卫条件。
- 编写状态处理函数:按 QHsm 或 QMsm 策略实现各状态函数,返回 HANDLED/TRAN/SUPER 等结果。
- 初始化与启动:为主动对象分配事件队列内存、设定优先级,初始化状态机并启动应用,把控制权交给 QP 内核。
- 追踪与测试:通过 QS/Q-Spy 软件追踪观察状态迁移和事件分发,必要时结合 QUTest 做基于追踪的单元测试。
七、常见误区对照
| 容易混淆的点 | 正确理解 |
|---|---|
| 状态机就是 switch-case 堆状态 | switch-case 只是实现手段;状态机的核心是状态、事件、迁移和封装的行为,HSM 还包含嵌套与行为继承 |
| 有状态函数就等于有完整状态机 | 状态机需要事件驱动基础设施:RTC 执行上下文、事件排队和定时服务;缺少框架支撑,状态机难以稳定运行 |
| HSM 是给每个子状态复制父状态逻辑 | 相反,子状态只写差异,公共行为上收到父状态复用,避免重复 |
| 状态机要按固定顺序跑完流程 | 状态机由事件驱动,不存在流程图式的固定进度,迁移由事件和条件决定 |
| QP 必须搭配传统 RTOS | QP 可在裸机上用内置内核独立运行,也可以移植到第三方 RTOS 或桌面 OS 上协同 |
【相关 FAQ】
问题 1: QP 状态机里的 FSM 和 HSM 有什么区别,为什么 QP 主推层次状态机?
回答 1: FSM 是扁平有限状态机,所有状态平级,共享行为要在每个状态重复实现;HSM 是层次状态机,状态可以嵌套,事件先由内层状态处理,不处理再上交父状态,子状态只写与父状态的差异。QP 主推 HSM,是因为状态嵌套能把公共行为上收到父状态复用,减少重复代码,避免扁平 FSM 常见的状态迁移爆炸,更适合描述复杂的事件驱动行为。
问题 2: 一个完整的 QP 状态机包含哪些 UML 元素?
回答 2: 通常包括初始伪状态、简单状态与复合状态(超状态)、子状态、入口动作、出口动作、复合状态内的初始迁移、常规迁移,以及带守卫条件的选择点;所有未被认领的事件最终交给隐含的顶层状态忽略。这些元素在 QP 中映射为状态处理函数、迁移目标和父状态指针,手工编码或由 QM 工具生成。
问题 3: QP 里的主动对象和状态机是什么关系,事件如何处理?
回答 3: 主动对象(QActive)由状态机、事件队列和带唯一优先级的执行线程三部分组成,状态机是主动对象行为的核心。外部事件投递到对象的事件队列,对象按 RTC 语义一次处理一个事件:当前状态判断是否处理,需要迁移时执行入口 / 出口动作并转到目标状态。事件在接收方线程上下文中处理,对象之间异步通信、不阻塞等待。
问题 4: 在 QP 中实现一个状态机大致分哪些步骤,框架由哪些组件组成?
回答 4: 步骤依次是划分主动对象、定义信号与事件、设计 UML 状态机、编写状态处理函数、初始化并启动对象、用追踪工具测试。框架组件包括 QEP 层次事件处理器、QF 事件驱动框架、QV/QK/QXK 内核以及 QS 软件追踪;状态机本身可以用 QHsm 策略手工编码,也可以通过 QM 建模工具用 QMsm 策略自动生成代码。
【参考资料】
- [2026-11-02](从零开始学 QP 状态机系列 —— 第三篇:状态嵌套的魅力:层次式状态机(HSM)思想入门)电子工程专辑
- [2026-10-20](qpc - Open Source RTOS)OSRTOS
- [2025-11-13](QP/C 状态机嵌入式系统中强大的威力)电子工程专辑
- [2026-11-16](QP/C++: About QP/C++)Quantum Leaps 官方文档
- [2026-11-16](Crash Course in UML State Machines)Quantum Leaps 应用笔记 PDF
- [2026-11-16](Overview of QP Frameworks and QM Modeling Tool)Quantum Leaps 演示文稿 PDF
- [2026-11-16](QP/C++: State Machines)Quantum Leaps 官方文档
- [2022-07-27](《UML 状态图的实用 C/C++ 设计》(QP 状态机) 学习笔记)普通人博客
【免责声明】
本文为 QP 官方文档、应用笔记及中文社区教程的概念整理,用于技术学习入门。QP 框架存在 QP/C、QP/C++、QP-nano 及不同版本差异,API 名称、返回标识、资源占用和内核特性以所使用版本的官方文档、头文件和配套书籍为准;文中代码概念和步骤不能直接替代具体工程的架构设计、编码规范与评审流程。UML 状态机语义以 OMG UML 规范和 Quantum Leaps 官方实现为准,若用于医疗、汽车、航空等安全关键项目,需结合对应功能安全标准做独立验证。
本文来自作者[磁波解码]投稿,不代表环球科技潮立场,如若转载,请注明出处:https://www.zennew.com/kjyw/202611/2097.html
评论列表(4条)
我是环球科技潮的签约作者“磁波解码”!
希望本篇文章《从零学 QP 状态机第七篇详解状态机 —— 从 FSM/HSM 概念、UML 元素到 QP 框架落地》能对你有所帮助!
本站[环球科技潮]内容主要涵盖:科技,科技新闻,黑科技
本文概览:我先核查电商清单技能可用性,并联网检索 QP 状态机框架与状态机详解的权威资料。