QSFP/QSFP-DD/OSFP 通用管理接口规范（CMIS）解读：10 Page 12h

摘要：此专栏主要介绍光模块通用管理接口规范（Common Management Interface Specification, CMIS）协议规范 V5.0 的解读。本文主要关注协议文档的 8.10 节关于 Page 12h 的内容。不仅是对文档的简单翻译，还会剖析协议规定背后的深层含义。为了方便与协议文档内容对应，本文的章节编号与协议文档保持一致。

8.10 带 Bank 的 Page 12h（可调谐激光器控制与状态）

（1）概述

Page 12h 是专门为可调谐激光器准备的“遥控器操作面板”。用来控制、监测和标记激光器的状态。通过 Page 01h: Byte 155: bit 6（见表 8-44）通告对 Page 12h 的支持。Page 12h 的 1 个 Bank 对应 8 个媒体通道（光口通道）。

• Page 12h和 Page 04h 的关系
  • Page 04h：是“说明书”，能力通告，告诉你支持哪些频率网格、调谐范围多大（能力广告）。上电时读一次就行。
  • Page 12h：是“遥控器”，实际下发调谐命令、看当前频率和锁定状态（实时控制与监控）。运行中需要频繁操作。

• 在每通道占一个字节的字节寄存器数组中，最低的字节地址代表通道 1。
• 在每通道占一个比特的位数组（位于一个字节内）中，最低有效位（位 0）代表通道 1。

（2）可调谐激光器的控制

“网格间距 + 偏移编号 + 精细调节偏移量” 决定了激光器的工作频率：如第 8.7 节所述，所有通道的激光器频率都以 193.1 THz 为参考基准（相当于“原点”）。以通道1为例，如果：

• GridSpacingsTx<1>=0100b，即网格间距为50G；
• ChannelNumberTx<1>=1b，通道偏移编号为1；
• 模块支持精细调谐 FineTuningEnableTx<n>=1b；
• 精细调谐偏移量 FineTuningOffsetTx<1>=0x0A，即精细调谐偏移量为 10x0.001GHz=0.01GHz。

那么，通道1的激光器工作频率为：193.1THz + 1x50GHz + 10x0.001GHz = 193150.01GHz。字节 168-171 中 CurrentLaserFrequencyTx<1>会显示为 0x0B833C3A，也就是193150010，单位为0.001GHz。

（3）可调谐激光器的状态

• 激光器调谐标志汇总（Byte 230） 和 各通道调谐标志（Byte 231-238）

  • 字节230是通道标志的汇总字节，每个通道只占 1 个比特，用最精简的方式告诉主机：哪个通道出事了。只要通道的任意一个调谐相关标志变为1，则该通道的汇总标志就变为1。
  • 字节 231–238 为 8 个媒体通道各准备了一套独立的调谐状态标志，详细记录通道内出现了的各个故障。
  • 二者都是读后自清除（RO/COR）。

• 波长失锁状态（WavelengthUnlockStatusTx<n>） 和 波长失锁记录（WavelengthUnlockedFlagTx<n>）

  • 字节222-229的 WavelengthUnlockedStatusTx 表示实时状态： 它就像监控屏幕上的实时心电图。如果波长现在锁定了，它就显示 0；如果现在失锁了，它就显示 1。一旦故障恢复，它立刻变回 0。
  • 字节231–238的 WavelengthUnlockedFlagTx<n> 表示锁存记录：它就像黑匣子里的飞行记录——只要发生过一次故障，记录就会永远保留，直到你主动去读取它。
  • 为什么要设计两套？ 就是为了不漏掉任何一次瞬态故障。波长可能因温度抖动、震动或器件老化瞬间失锁几微秒又自行恢复，若只靠实时状态位，主机可能永远看不到这个瞬间事件，但链路已因此产生大量误码。有了锁存记录，主机就能发现并提前预警。它们都是读后清除（RO/COR）。

（4）可调谐激光器的掩码

总结

本文解读了 CMIS V5.0 中 Page 12h 可调谐激光器的控制与状态机制，涵盖频率计算、状态标志与掩码。若模块是固定波长的（比如 1310nm 不可调），那这一页完全不需要。但如果是一个可调谐 DWDM 模块（能在 C 波段几十个波长之间切换），这一页就是核心控制界面，为主机提供了完备的激光调谐控制和监测。欢迎有疑问的小伙伴在评论区留言讨论。