Skip to main content

检测、响应与恢复

机器人和智能设备经常需要检测倾角、温度、碰撞、跟踪误差、输入失效或通信中断。同一种现象在不同任务中可能需要不同响应:大倾角可能来自倾倒,也可能是攀爬或翻转动作的一部分。设计上应将事实检测、响应决策和动作执行分开,避免检测模块直接绑定整机停止、故障锁存或进程退出。

本文说明检测、响应和恢复的职责边界。核心现已提供进程内通用告警组件,统一告警状态、事件队列和 warning/error 日志;检测算法、行为响应和恢复状态机仍由相应模块与产品实现。下述完整事件语义包含后续设计目标,不等于全部已有公共消息契约。

职责与数据流​

反馈进入检测器后形成状态快照和变化事件;产品响应策略结合当前动作与控制上下文作出决策,再由控制仲裁与动作执行模块处理。日志、遥测和诊断独立订阅检测结果及执行结果。

职责输入与输出拥有的决策
检测器有效反馈进入,测量值、条件状态与变化事件输出条件是否成立,数据是否足以判断
响应策略检测结果、当前动作、能力与控制权进入,响应请求输出继续、提示、降级、停止当前动作、恢复或请求故障锁存
动作执行与仲裁经校验的请求进入,执行状态与结果输出唯一输出所有权、执行顺序、取消和结束条件
日志与诊断消费状态、事件和处理结果记录、显示与上报,不直接取得执行权

检测器应尽量只依赖输入数据与检测参数,不依赖遥控按键、某个动作策略、仿真窗口或进程管理。响应策略可以随产品、机型、动作和运行状态变化;处理方不能把检测结果改写为“未发生”来适应某个动作。

条件、事件与故障​

持续条件、条件变化事件、控制故障和动作处理结果应分别表达。例如“倾角超过阈值”是条件,“开始超限”是事件,“请求翻身恢复”是处理决策,“恢复失败并进入被动状态”是处理结果,不能只靠一个 fault=true 混合表示。

严重程度、实际响应、是否锁存和解除条件分别定义。日志等级不自动决定所有产品都一样的停机动作。条件消失可以产生恢复事件,但不代表控制权限自动恢复,也不代表先前已锁存的故障自动清除。

拟定检测输出时至少考虑以下语义,具体字段、枚举和版本由后续契约设计确定:

信息用途
设备或机器人、来源模块、会话、检测器及条件标识避免不同设备、旧进程与旧控制会话混淆
采样序号、采样时间、接收时间与时钟域判断新鲜度、去重和重放,不直接混算不同时间域
测量值、单位、参考坐标系、阈值与检测配置版本解释触发原因,复现实验
有效性及 ACTIVE、CLEARED、UNKNOWN 等条件状态将数据无效与正常区分,未知不能解释为未超限
进入时间、持续时间、滞回与去抖后的状态变化区分短暂经过和持续异常,减少事件抖动
决策引用的事件、上下文版本、响应请求和执行结果追踪检测、决策与实际执行

条件边沿事件与持续状态快照配合使用,订阅者重连后不应只靠已经丢失的边沿推断当前状态。日志采用限频、边沿记录和必要的持续摘要,避免每个控制周期重复刷屏。数据过期或传感器不可用应显式报告未知或相应可用性条件,再由处理策略选择响应。

动作上下文与独立约束​

同一个检测结果可以对应不同响应。行走中的大倾角可以请求倒地判定和恢复;已准入的翻转动作允许经过倒置姿态,同时仍受自身时长、轨迹、能力和结束条件约束。允许大倾角不等于关闭检测,也不等于无限期忽略异常。

响应策略应在确定的控制 owner 中执行,使用一致的检测快照、动作阶段、控制会话与能力信息。并发日志订阅者和多个检测器不能各自直接写电机。动作切换时明确响应规则何时生效,旧动作的恢复请求不能在新会话中继续执行。上报阻塞或网络中断不能成为本地决策无法执行的原因。

关节和电机能力、非法或非有限指令、控制授权、反馈有效期、通信失效及急停等仍按各自约定校验。取消“倾角超限直接锁死”不意味着这些机制也改为仅记录日志;需要低时延执行的本地约束不能等待异步事件上报完成后再动作。

恢复与解除条件​

恢复是受管理的动作,拥有进入条件、所需策略或轨迹、输出能力、有效控制权、超时、重试预算、成功判据、取消和失败回退。恢复期间继续检测,停止和急停请求仍优先。新命令、条件恢复或进程重启都不能隐式恢复已经失效的控制权。

产品应明确哪些情况允许自动恢复,哪些需要操作者请求,以及何时真正需要故障锁存。没有可用恢复动作时,应报告能力不足并进入明确的等待或被动状态,不能因为模型仍可推理就继续执行不适合当前姿态的行走策略,也不能宣称已经具备自主起身能力。

在仿真中,停止控制输出与停止物理时间也是不同操作。控制故障后可继续模拟重力和碰撞;显式暂停才冻结物理步进,物理引擎自身不能继续运行的错误则按仿真器生命周期处理。

工程归属与参数​

OpenEmber 核心适合提供稳定且可复用的输入输出约定、事件元数据、时间与会话语义,以及日志、配置和通信基础。具体检测算法放在合适的可复用组件或产品模块;行为响应、机型动作、恢复策略和整机状态机由产品拥有。先用真实产品场景验证,再提取通用能力,不要求第一步就创建通用安全服务或统一事件总线。

公共诊断状态可对接现有 diagnostics/v1,日志使用现有日志能力;节点生命周期与机器人运动状态分别建模。需要跨进程共享的领域条件、动作请求和恢复结果,应在 openember-msgs 中评审和版本化契约,避免产品复制协议;现有消息并不自动提供上述完整语义。职责边界见公共消息协议和架构概览。

按构建配置与运行参数划分配置:Kconfig 决定是否编译检测、事件适配或恢复能力;模块 YAML 定义阈值、时间窗、滞回、去抖、动作上下文下的响应和恢复预算。检测阈值与处理策略分别配置,配置版本进入诊断记录;支持启动加载与在线更新是不同能力,在线更新必须另行规定应用时机和校验规则。

落地与验收​

先从产品已有倾角检测入手,保留测量与诊断,将检测输出与响应解耦,由产品明确选择仅上报、结束当前动作、等待恢复或请求锁存。随后增加倒地确认和显式恢复动作,具备模型与能力后再开放自动恢复及翻转等动作上下文。出现多个实际复用场景后,再提取通用接口和公共消息。

验收覆盖同一检测在不同动作中的不同响应,以及阈值边界、滞回和去抖、传感器失效、重复和旧会话事件、上报阻塞、动作取消、恢复超时与重试耗尽。尤其验证“超限不锁死”不会隐式使能设备、“事件消失”不会自动清除已有控制故障,以及控制故障不会冻结仿真物理时间。

产品落地进度​

四足产品已实现第一阶段:在产品 quadruped_policy 中加入无I/O的纯阈值检测器,倾角和有效低根高度支持滞回、去抖、持续提醒、未知状态和会话隔离,响应明确选择 report_only。运行中姿态超限仅记录本地事件与显示告警,不直接撤销输出或要求重置;有效初态准入与底层反馈、能力和控制权校验继续保留。产品检测事件现已映射到核心 openember::alerts,由独立派发线程通过现有日志模块记录 warning 日志,界面仍显示告警。现已通过独立 Link 通道发布公共 alerts/v1 事件与周期状态快照,供后续整机管理模块订阅;集中服务、倒地确认、动作上下文和翻身起身仍待实现。