CMIS的Alarm和Warning有什么区别？——给上位机同事解释告警体系的三套方案
一句话: 给上位机同事写通讯协议时，CMIS 标准里的 Alarm 和 Warning 怎么翻译？"故障/预警"偏离原文，"严重/常规"容易混淆。本文讲了三套方案的取舍——最终保留英文，让上位机同事能对照规范查。
适合谁读：在写通讯协议文档或代码注释，需要给 Alarm/Warning 取中文名又纠结的嵌入式开发者。
背景
CMIS（Common Management Interface Specification）是光模块的管理接口标准。里面定义了两类告警：
- Alarm— 触发后模块进 FAULT 状态，关激光
- Warning— 只通知主机，不影响运行
我要给上位机同事写一张寄存器表，里面每个 bit 都在告警，bit 名全是XXX_Alarm、XXX_Warning。表格里的"告警类型"列得填个中文描述。
三套方案
| 方案 | Alarm 翻译 | Warning 翻译 | 问题 |
|---|---|---|---|
| A：功能描述 | 故障 | 预警 | "故障"太重了——Alarm 触发后可以恢复，不是硬件坏了。"预警"暗示"还没发生"，但 Warning 是已经发生的 |
| B：严重程度 | 严重告警 | 常规告警 | 上位机同事问"什么叫常规？到底要不要处理？"——区分度不够 |
| C：保留英文 | Alarm | Warning | 表格里混中英文不够"纯"，但对照 CMIS 规范时不会混淆 |
选了 C。
为什么不用中文翻译
上位机同事拿到通讯协议后，第一件事是去翻 CMIS 规范确认 bit 定义。如果表格里写了"故障"，他在规范里搜Fault搜不到——规范里写的是Alarm。
翻译过的术语在"文档→规范"这条查找链上制造了断点。
反过来想：通讯协议表格的读者不是普通用户，是另一个工程师。他要的不是"中文好懂"，而是"和规范对得上"。
CMIS 告警体系简述
| Alarm | Warning | |
|---|---|---|
| 触发后果 | 模块进 FAULT 状态 | 不影响运行 |
| 激光 | 强制关闭 | 保持出光 |
| 恢复方式 | 清除条件后自动退出 FAULT | 条件消失自动清除 |
| 典型例子 | 温度超限、偏流失效 | 温度偏高但未超限、供电略低 |
| CMIS 里的 Flag | AlarmFlag寄存器 | WarningFlag寄存器 |
对固件来说，区别更直白：
Alarm → Fault 状态机跳转 → 关激光 → 等条件恢复 Warning → 不跳状态机 → 只置标志位 → 上位机自己决定处不处理延伸：什么时候该保留英文
写技术文档时，这几种情况保留英文比翻译好：
- 标准协议里的专有名词：CMIS Alarm/Warning、I2C NACK、SPI CPOL/CPHA
- 寄存器位段名：
TX_Enable翻译成"发送使能"反而比原文长 - 调用链上的函数名：注释里写"调用 App_CMIS_WriteRegInt"比"调用寄存器写整数接口"好
翻译的底线：读者拿着你的文档能对照原规范找到对应的定义。如果翻译后断了这条链，就翻坏了。
有用的话点个收藏，下次调试直接用。有问题欢迎评论区交流，看到了都会回。