一句话: CMIS 标准里的 Alarm 和 Warning 怎么翻译?"故障/预警"偏离原文,"严重/常规"区分度不够。最终保留英文------因为读通讯协议的人要对照规范查定义,翻译会制造断点。
适合谁读:写通讯协议文档,纠结 Alarm/Warning 该叫什么中文名的开发者。
背景
CMIS(Common Management Interface Specification)是光模块的管理接口标准,定义了两类告警:
- Alarm --- 触发后模块进异常状态,关输出
- Warning --- 只通知主机,不影响运行
给上位机同事写寄存器表,bit 名全是 XXX_Alarm、XXX_Warning,表格里要填中文描述。
三套方案
| 方案 | Alarm | Warning | 问题 |
|---|---|---|---|
| A | 故障 | 预警 | "故障"太重------Alarm 触发后可恢复。"预警"暗示还没发生,但 Warning 已经发生了 |
| B | 严重告警 | 常规告警 | "常规是什么意思?到底要不要处理?"------区分度不够 |
| C | Alarm | Warning | 表格里混中英文不够"纯",但对照规范时不会混淆 |
选了 C。
为什么
上位机同事拿到协议后第一件事是翻 CMIS 规范确认 bit 定义。表格写"故障",他在规范里搜 Fault 搜不到------规范写的是 Alarm。翻译过的术语在"文档→规范"查找链上制造了断点。
通讯协议表格的读者不是普通用户,是另一个工程师。他要的不是"中文好懂",是"和规范对得上"。
告警体系
| Alarm | Warning | |
|---|---|---|
| 触发后果 | 模块进异常状态 | 不影响运行 |
| 输出 | 强制关闭 | 保持 |
| 恢复 | 条件清除后自动恢复 | 条件消失自动清除 |
| 典型例子 | 温度超限、偏流失效 | 温度偏高未超限、供电略低 |
对固件来说:
Alarm → 状态机跳转 → 关输出 → 等条件恢复
Warning → 不跳状态机 → 只置标志 → 上位机自己决定
什么时候该保留英文
- 标准协议专有名词:Alarm/Warning、I2C NACK、SPI CPOL/CPHA
- 寄存器位段名:
TX_Enable翻译成"发送使能"反而更长 - 函数名:注释写"调用 WriteReg"比"调用寄存器写接口"好
底线:读者拿着文档能对照原规范找到定义。翻译断了这条链就翻坏了。
有用的话点个收藏 ,下次直接查。有问题欢迎评论区交流。