1. 课程导入与故障日志认知

水下机器人（ROV/AUV）一旦下潜，人就在水面，看不见、摸不着。设备是否正常、推进器有没有堵转、电池电压是否跌落、通信是否中断，操作员唯一能依赖的"现场证人"，就是设备自己记录下来的故障日志。可以说，故障日志是水下机器人可观测性的底座：没有日志，排障只能靠猜；有了日志，排障才能从"猜"变成"查"。

本课程面向刚接触水下机器人的工程人员、操作员与维护人员，目标不是背下几百条事件码，而是建立一套"看得懂、查得到、判得准"的方法。下面先厘清三个最基本的概念：故障日志是什么、事件码是什么、两者如何配合工作。

一、故障日志：设备的"黑匣子"与"体检报告"

故障日志是系统在运行过程中按时间顺序自动记录的事件集合。它通常包含五类信息：时间戳（何时发生）、来源模块（谁报告的，如推进器驱动、电池管理、深度传感器、主控）、事件码（发生了什么类型的异常）、严重等级（提示/警告/故障/致命）、以及上下文数据（当时的电流、电压、温度、深度、姿态等快照）。

这五类信息决定了日志的用途。时间戳让多个模块的异常可以对齐到同一时刻，判断谁是"因"、谁是"果"；来源模块把问题定位到具体部件；事件码提供标准化的异常分类；严重等级决定是否需要立即上浮或返航；上下文数据则是复现问题的关键证据。举例来说，一条记录"14:32:07，推进器驱动，电流 8.6 A（额定 5 A），等级：警告"，比一句"推进器有点问题"有价值得多——它直接指向了过流这一物理现象。

需要强调的是，日志不是"出故障才看"的东西。日常下潜前后对比日志基线，能发现缓慢劣化的趋势，例如某推进器空载电流从 0.8 A 逐步升到 1.3 A，往往意味着密封件摩擦增大或异物缠绕，这时处理成本远低于海上失效。

二、事件码：给异常一个"标准名字"

事件码是厂商为每一类可检测异常分配的唯一标识符，通常由字母前缀加数字组成，例如 THR-012 表示推进器类第 12 号事件，BAT-003 表示电池类第 3 号事件。它的价值在于三点：

• 消除歧义：不同人描述同一故障的说法千差万别，事件码只有一个含义，便于交接班和远程支持。
• 可检索、可统计：按码检索日志、按码统计频次，能快速看出"哪个部件最爱出问题"。
• 可联动处置：每个码背后对应固定的处置建议，操作员不必临场推理。

理解事件码，要抓住"触发条件"这一核心。事件码不是凭空产生的，而是固件中的判断逻辑在满足条件时写入的。例如某推进器过流事件的触发逻辑可简化为：

if (motor_current > 5.0 A 持续 500 ms)
    记录 THR-012（过流警告），快照：电流、转速、水温
if (motor_current > 7.5 A 持续 200 ms)
    记录 THR-013（过流故障），并触发降功率保护

看懂这段逻辑，就能明白两件事：一是短时冲击电流不会误报，因为有持续时间门槛；二是警告与故障是两级阈值，处置紧迫性不同。排障时若只看到 THR-012 而没有 THR-013，说明异常尚未达到保护动作的程度，但仍需关注。

三、日志与事件码如何协同工作

可以把整个链路理解为：传感器采集物理量 → 固件按阈值和持续时间判断 → 命中则写入事件码与上下文 → 日志按时间归档 → 操作员或维护人员检索、判读、处置。下图展示了这一信号与数据链路，以及一次典型的过流事件从产生到被读取的路径。

图中下半部分的示例时间线值得注意：14:32:07 先出现警告，两秒后升级为故障并触发降功率。判读时不能只看最后一条"故障"，而要顺着时间线看升级过程——这能帮助判断是突发冲击（如异物瞬间缠绕）还是持续过载（如推进器轴承磨损）。

四、本课程的学习路径

后续内容按"认知—读码—排障—复盘"四层递进展开。第一层建立概念与日志结构认知，弄清一条日志由哪些字段构成、存放在哪里、如何导出；第二层掌握事件码的编码规则与常见类别，学会按码查手册、按码定位模块；第三层进入实战排障，围绕推进器、电池、通信、传感器、密封进水等典型故障，练习从多条日志中还原故障链；第四层是复盘与预防，用日志统计做趋势分析、建立基线、优化维护周期。