4. 事件码的基本结构与编码规则

水下机器人一旦在任务中抛出事件码，运维人员面对的第一件事往往不是“修”，而是“读”。事件码不是一串随机数字，它是设备内部对某次异常或状态变化的压缩表达。能否在几十秒内从一串码里拆出“谁出的问题、有多严重、属于哪类故障”，直接决定了后续排障是有的放矢还是盲目试错。本节围绕事件码的字段组成、等级划分、模块标识和常见编码规范展开，目标是让读者拿到一条真实日志时，能按固定套路把它拆解成可判断的信息。

一、事件码为什么需要结构化

早期小型水下机器人常把故障信息写成一句自然语言，例如“推进器过流”。这种写法直观，但存在三个硬伤：一是无法被上位机程序自动分类统计；二是不同固件版本措辞不一致，日志检索困难；三是信息量不稳定，有时只写现象不写位置。结构化事件码用固定长度的字段把“模块、类别、具体故障、等级”分开存放，使机器可解析、人可速读。可以把它理解为一种面向故障的“微型报文格式”。

一个典型的事件码在日志中常以“码值 + 时间戳 + 附加参数”的形式出现，例如：

[2024-06-11 09:32:17.482] EVT 0x2A13 L2 THR_R  I=18.6A T=71C
[2024-06-11 09:32:19.105] EVT 0x2A13 L2 THR_R  I=19.2A T=73C
[2024-06-11 09:32:25.640] EVT 0x1105 L1 NAV    depth_err=0.42m

这里 0x2A13 是事件码本体，L2 是等级，THR_R 是模块标识，后面的 I、T 是触发时的关键参数。理解这条日志，就要理解码值内部如何切分。

二、字段组成：把码值拆开看

工程上最常见的是 16 位事件码，按位段划分字段。以 0x2A13 为例，二进制为 0010 1010 0001 0011，一种常见的位段约定如下：

• bit15～bit12（4 位）：等级字段，取值 0～15，对应 L0～L15 或分级枚举；
• bit11～bit8（4 位）：模块标识，标识故障所属子系统；
• bit7～bit4（4 位）：故障类别，如过流、超温、通信超时、越限；
• bit3～bit0（4 位）：具体实例或子码，用于区分同类故障下的细分原因。

按此约定拆 0x2A13：等级段 0010=2，模块段 1010=10，类别段 0001=1，子码段 0011=3。若模块表规定 10 对应右推进器、类别 1 对应过流、子码 3 对应堵转嫌疑，那么这条码读作“右推进器过流，子因堵转，等级 2”。这正是结构化编码的价值：同一串码，人和程序都能得到一致结论。

需要强调，位段划分没有唯一标准，不同厂商可能采用 8 位、24 位或 32 位码，也可能把等级单独放在日志字段而不编入码值。阅读任何设备的事件码手册时，第一件事就是找到它的位段定义表，而不是凭经验套用。

三、等级划分：决定响应动作的优先级

等级字段回答的是“这件事有多急”。工程上通常按“对任务与设备安全的影响程度”分级，而不是按发生频率。一个可操作的划分思路是：

• L0 提示：状态变化或可自恢复的小偏差，如某传感器短时丢帧后恢复，仅记录，不干预；
• L1 告警：参数接近阈值或性能轻微下降，如电池电压偏低、深度偏差偏大，提示操作员关注；
• L2 故障：功能已受影响，如推进器过流、通信间歇中断，应触发限速、切换冗余通道等降级动作；
• L3 严重：关键功能失效，如主推进器停转、主控通信中断，应执行上浮或返航；
• L4 致命：危及设备生存，如舱内进水、电池热失控前兆，立即执行紧急上浮与断电保护。

分级的关键在于“等级与动作绑定”。如果 L2 和 L3 在系统里都只是记一条日志、不触发任何行为，那分级就失去了意义。实际配置时，应把每个等级映射到明确的处置策略，并在联调中验证：人为注入一个 L3 事件，观察机器人是否真的执行了上浮流程。这一步常被忽略，却是事件码体系能否落地的分水岭。

四、模块标识：定位到子系统

模块字段解决“哪里出的问题”。水下机器人典型子系统可分配固定编号，例如：01 主控、02 导航（NAV）、03 深度/姿态传感、04 电池与电源管理、05 左推进器、06 右推进器、07 垂推、08 机械臂、09 声呐、0A 通信（含光纤/水声）、0B 照明与云台。编号一旦确定就应写入接口文档并冻结，避免固件升级时随意改动导致历史日志无法回溯。

模块标识的粒度需要权衡。分得太粗（如只分“动力”和“控制”），排障时仍要二次定位；分得太细（每个传感器一个编号），码表膨胀且维护成本高。经验做法是：以“可独立更换的部件或可独立下发的控制单元”为划分边界，这样事件码定位到的位置，基本就是维修人员要动手的位置。

五、常见编码规范与落地建议

行业内没有强制统一的事件码标准，但有几类常见做法值得了解。一是位段式，如前所述的 16 位划分，优点是解析快、可位运算提取字段，适合资源受限的嵌入式端；二是分段十进制，如 05-02-013 表示模块 05、类别 02、序号 013，可读性好，适合人读日志；三是枚举式，每个故障一个独立编号，码表由文档维护，灵活但需要严格版本管理。选型时应考虑：解析端算力、码表规模、是否需要跨版本兼容。

无论采用哪种，建议遵守几条通用规则：码值全局唯一，不复用已废弃编号；等级不编入码值时，必须在日志行单独给出且位置固定；每个码在码表中至少包含“码值、名称、等级、模块、触发条件、建议动作”六项；固件与上位机的码表版本号要能对上，日志中应记录码表版本。下面是一份可直接参考的码表条目示例：

码值: 0x2A13
名称: 右推进器过流
等级: L2
模块: 06 THR_R
触发条件: 相电流 > 18A 持续 500ms
建议动作: 降速至 60%，连续 3 次触发则停转该推进器并上浮
码表版本: EVT-1.3

实际排障时，可按“先看等级定响应、再看模块定位置、后看类别与子码定原因、最后结合附加参数确认”的顺序读码。例如连续出现三条 0x2A13，电流从 18.6A 升到 19.2A、温度从 71℃ 升到 73℃，说明不是瞬时尖峰而是持续过流且伴随温升，应优先排查螺旋桨缠绕与轴承阻力，而不是简单复位了事。把事件码读成“有依据的判断”，才是这套编码规则真正的用途。