YD/T 3126.2-2016.lintegrable tunable laser assembly Part 2: Software procotol.
1范围
YD/T 3126.2规定了集成可调谐光源模块的软件协议要求，包括集成可调谐光源模块与主机的通信流程、物理层、传输层、应用层等要求。
YD/T 3126.2适用于集成可调谐光源模块(以下简称模块)。
2术语和定义
下列术语和定义均适用于本文件。
2.1
主机Host
与集成可调谐光源组件通信，发起命令的光收发模块。
2.2
空操作Nop
用来查询挂起命令执行状态，模块就绪位及错误域。
2.3
主机发起的命令帧In-Bound
主机下发给模块的命令帧，由4个字节组成。
2.4
模块响应主机的命令帧Out- Bound
模块执行主机命令结果的响应帧，由4个字节组成。
3缩略语
下列缩略语适用于本文件。
ADT                 Alarm During Tuning Or Disable                  波长调谐期间或关闭光输出时的告警
AEA                  Automatic Extended Addressing                                  自动扩展地址
ALMT                                Alarm Trigger                                                   告警触发
4通信流程
主机与模块通信命令的传输流程见图1。
主机与模块通信命令传输过程分为三层:应用程、传输层、物理层。
主机发启命令时，首先在应用层组成28位比特命令帧，传输层添加校验和组成32位比特的命令帧，物理层将32位比特帧重组成40位比特帧发送给模块。

ICS33.180.01
中华人民共和宝玉通信行标准
YD/T3126.2-2016
集成可调谐光源模块
第2部分：软件协议
lintegrabletunablelaserassemblyPart2：Softwareprocotol
(OIF-ITLA-MSA-01.2,Optical Internetworking Forum IntegrableTunable Laser Assembly Multi Source Agreemet,NEQ2016-07-11发布
2016-10-01实施
中华人民共和国工业和信息化部发布前
范围·
2术语和定义
缩略语·
通信流程
物理层
传输层·
应用层
命令格式
命令分类
通用命令
模块状态命令，
模块光信息配置命令·
7.6模块调谐能力命令
7.7MSA命令
7.8厂商扩展命令（0x80—0xFE）附录A（资料性附录）Bip4检验算法·附录B（规范性附录）时间规范…附录C（规范性附录）复位挂起规定附录D（规范性附录）告警要求
YD/T3126.2-2016
YD/T3126.2-2016
YD/T3126《集成可调谐光源模块》分为以下两部分：第1部分：接口：
第2部分：软件协议，
本部分是YD/T3126的第2部分。
本部分按照GB/T1.1-2009给出的规则起草。本部分使用重新起草法参考OIF-ITLA-MSA-01.2《光互联网论坛集成可调谐光源模块多源协议01.2》编制，与OIF-ITLA-MSA-01.2的一致性程度为非等效。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本部分由中国通信标准化协会提出并归口。本部分起草单位：华为技术有限公司、深圳新飞通光电子技术有限公司、中兴通讯股份有限公司、武汉烽火科技集团有限公司。
本部分主要起草人：李籽泽、汪永忠、严雄武、陈悦、武成宾、傅焰峰。Ⅱ
HiiKAoNiKAca
1范围
集成可调谐光源模块
第2部分：软件协议
YD/T3126.2-2016
本部分规定了集成可调谐光源模块的软件协议要求，包括集成可调谐光源模块与主机的通信流程、物理层、传输层、应用层等要求。本部分适用于集成可调谐光源模块（以下简称模块）。2术语和定义
下列术语和定义均适用于本文件。2.1
主机Host
与集成可调谐光源组件通信，发起命令的光收发模块。2.2
空操作Nop
用来查询挂起命令执行状态，模块就绪位及错误域。2.3
主机发起的命令顿In-Bound
主机下发给模块的命令顿，由4个字节组成。2.4
模块响应主机的命令帧Out-Bound模块执行主机命令结果的响应顿，由4个字节组成。3缩略语
下列缩略语适用于本文件。
Alarm During Tuning Or DisableAutomatic Extended AddressingAlarmTrigger
Application Software
AmericanStandard CodeforInformationInterchangeBit Interleared Parity 4 Code波长调谐期间或关闭光输出时的告警自动扩展地址
告警触发
应用软件
美国信息互换标准代码
比特间插奇偶校验4位码
CommandIgnoredWhileModule'sOpticalOutputIs命令由于光输出使能被忽略Enabled
CommandIgnoredWhileModuleIsInitializing,Warming由于模块初始化，热启动或无效配置Up,Or Contains An Invalid ConfigurationCommand Ignored Due To Pending OperationCommand Pending
Cyclic Redundancy Check
Disable
引起的命令忽略
由于挂起操作引起的命令忽略
命令挂起
循环允余校验
禁止使能
HiiKAoNiKAca
YD/T3126.2-2016
LstRsp
4通信流程
Extended Address
Extended Address ConfigurationExtended Address Access RegisterExtendedAddressRangeError
Extended Address Mode
Extended Address Is Read OnlyExecution General Failure
Firmware
Hardware
Increment Register
Invalid Configuration, Command IgnoredLast Response
Module Ready
Protocl Version
ReadAuto Increment
The Addressed Register Is Not Implemented扩展地址
扩展地址配置
扩展地址访问寄存器
扩展地址错误
扩展地址模式
扩展地址只读
执行失败
自增寄存器
命令由于无效配置被忽略
前一条响应帧
模块就绪
协议版本
读操作
读地址自增
寄存器不可用
RegisterNotWrite-able,RegisterCanNotBeWritten寄存器不可写Register Value Range Erron
Synchronous Digital HierarchyShutDownOptical OutputOnFatal ConditionService Request
ThermoelectricCooler
Vendor Specific Error
Write Auto Increment
Execution Error
主机与模块通信命令的传输流程见图1。参数错误
同步数字体系
致命告警关闭光输出
服务请求
热电制冷器
厂商自定义错误
写操作
写操作地址自增
执行错误
主机与模块通信命令传输过程分为三层：应用程、传输层、物理层。主机发启命令时.首先在应用层组成28位比特命令顿，传输层添加校验和组成32位比特的命令帧，物理层将32位比特顿重组成40位比特帧发送给模块。模块接收到数据包后，首先通过物理层解帧传送给传输层，传输层对数据进行校验，将28比特的数据帧传给应用层，最后应用层将28位比特的数据解帧，执行命令。模块执行命令结束后，在应用层组成26位比特的数据。传输层添加校验和及通信状态位,封装成32比特的数据顿，经过物理层封装成40位比特数据帧返回给主机。主机接收到后经物理层、传输层、应用层处理命令。
TiikANniKAca
应用层
传输层
物理层
5物理层
主机命令请求
发起命令
组装命令帧
组串口顿
主机驱动
模块响应顿
响应顿返回
解命令顿
解串口帧
可调谐光源模块
模块执行主机命令请求
模块驱动
发起命令
组装命令顿
组串口顿
图1主机与模块通信命令的传输流程YD/T3126.2-2016
响应赖返回
解命令顿
解串口顿
本章描述与软件技术相关的物理层约束。传送32比特的命令帧时高字节低比特优先传输。6传输层
传输层负责解析、封装命令顿，最高权值比特是第31位。如图2所示，In-bound帧的比特31至比特28由传输层负责：如图3所示，Out-bound帧的比特31至比特26由传输层负责。31
校验和
校验和
图2 In-bound顿
Out-bound顿
比特31:28校验和采用Bip4算法校验。校验和为通信传输提供了基本级别的一致性检查。Bip4校验算法参见附录A。
7应用层
7.1命令格式
7.1.1In-bound主机发起的命令帧命令帧由4字节组成，应用层负责低28个比特。各字节定义如下：a）In-bound字节o定义见图4。
0x0（传输层定义）
图4In-bound字节0
读写位（0为读，1为写）
iiKAoNiKAca
YD/T3126.2-2016
b）In-bound字节1定义见图5。
c）In-bound字节2定义见图6。
d）In-bound字节3定义见图7，
2out-bound模块响应主机的命令帧7.1.2
寄存器序号
图5In-bound字节1
数据15：8
图6In-bound字节2
数据7：0
图7In-bound字节3
模块响应主机的命令顿由4字节组成，应用层完成低26比特数据的封装。各字节定义如下：a）Out-bound字节o定义见图8。31
0x0（传输层定义）
图8Out-bound字节o
b）Out-bound字节1定义见图9
c）Out-bound字节2定义见图10。15
d）Out-bound字节3定义见图11。6
状态位取值含义见表1。
状态位取值（比特25:24）
7.2命令分类
寄存器序号
Out-bound字节1
数据15：8
Out-bound字节2
数据7：0
Out-bound字节3
表1状态位取值含义
成功标志，无执行错误。
XE标志，表示命令执行错误。
AEA标志，表示要进行多字节传输CP标志，表示命令挂起
状态位
主机与模块通信命令分为六组，包括通用命令、模块状态命令、模块光信息配置命令、模块调谐能力命令、多源协议命令以及厂商扩展命令。命令列表见表2。TiiKAoNiKAca
寄存器序号
命令名称
设备类型
制造厂商
模块名称
序列号
生产日期
发行版本
兼容版本
通用模块配置
AEA-EAC
AEA-EA
AEA-EAR
通信接口配置
前一次响应包
加载配置
加载状态
致命告警寄存器
一般告警寄存器
光功率致命告警门限
光功率一般告警门限
光频率致命告警门限
光频率一般告警门限
管芯温度致命告警门限
管芯温度一般告警门限
SRQ*屏蔽寄存器
FatalT屏蔽寄存器
ALMT屏蔽寄存器
光通道号寄存器
光功率寄存器
复位/使能激光器寄存器
模块操作配置寄存器
读/写属性
可读写
可读写
可读写
可读写
可读写
可读写
可读写
可读写
可读写
可读写
可读写
可读写
可读写
可读写
可读写
可读写
可读写
可读写
可读写
可读写
可读写
可读写
可读写
可读写
表2命令列表
AEA属性
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
非易失性
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
YD/T3126.2-2016
功能描述
查询模块状态，挂起操作的执行状态和当前错误域的值
查询设备类型
查询制造厂商
查询模块名称
查询序列号
查询生产日期
查询发行版本
查询兼容版本
保存具有非易失性的寄存器
自动扩展地址模式配置
自动扩展地址
自动扩展地址访问寄存器
配置串口速率
扩展地址模式配置
扩展地址
扩展地址访问寄存器
读取上一次主机命令的模块的响应包加载配置寄存器
加载状态机寄存器
致命告警寄存器
般告警寄存器
光功率致命告警门限，相对门限光功率一般告警门限，相对门限光频率致命告警门限，相对门限光功率一般告警门限，相对门限管芯温度致命告警门限，相对门限管芯温度一般告警门限，相对门限SRQ*屏蔽寄存器，决定告警寄存器中SRQ告警位告警触发源
FatalT屏蔽寄存器，决定告警寄存器中FatalT告警位告警触发源
ALMT屏蔽寄存器，决定告警寄存器中ALMT告警位告警触发源
设置/读取光波长通道号
设置/读取光功率
使能/禁止激光器光输出
软复位激光器
配置致命告警产生时是否禁止光输出标志，配置波长调谐/激光器开启阶段是否产生告警
iiKAoNiKAca
YD/T3126.2-2016
寄存器序号
0x80-0xFE
命令名称
通道间隔寄存器
第一通道频率整数部分
第一通道频率小数部分
当前通道频率整数部分
当前通道频率小数部分
光功率上报寄存器
控制温度上报寄存器
光频率微调寄存器
可调最小光功率
可调最大光功率
可调最小光频率整数部分
可调最小光频率小数部分
可调最大光频率整数部分
可调最大光频率小数部分
最小通道间隔
电流组
温度组
扰动使能
扰动速率
扰动幅度
扰动频率
壳温告警低门限
壳温告警高门限
寿命致命告警门限
寿命一般告警门限
寿命寄存器
微调频率寄存器
厂商自定义
3通用命令
7.3.1nop状态(0x00)
读/写属性
可读写
可读写
可读写
可读写
可读写
可读写
可读写
可续写
可读写
可读写
可读写
可读写
可读写
表2（续）
AEA属性
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
非易失性
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
不具有
功能描述
读写通道间隔寄存器
设置/读取第一通道频率的整数部分设置/读取第一通道频率的小数部分设置/读取当前通道频率的整数部分设置/读取当前频率的小数部分
读取实际光功率
读取模块实际控制温度
设置/读取光频率微调值
读取模块可配置的最小光功率
读取模块可配置的最大光功率
读取模块可调的最小光频率的整数部分读取模块可调的最小光频率的整数部分读取模块可调的最大光频率的整数部分读取模块可调的最大光频率的整数部分读取模块支持的最小通道间隔
读取模块的实际电流值
读取模块的实际温度值
设置/读取扰动使能/禁止
设置/读取扰动速率
设置/读取扰动幅度
设置/读取扰动频率
设置/读取模块壳温告警低门限
设置/读取模块壳温告警高门限
设置/读取寿命致命告警门限
设置/读取一般告警门限
读取当前模块寿命
设置/读取模块微调
厂商自定义厂商自定义
厂商自定义
厂商自定义
nop寄存器用来查询模块状态、挂起操作的执行状态和上一条命令触发的错误码。如果对该寄存器执行写操作，不会改变寄存器的值。除非模块发生故障，否则nop寄存器任何时间都可以访问成功。nop寄存器基本属性见表3，nop寄存器响应顿描述见表4，nop寄存器数据域参数见表5，nop寄存器错误域的取值含义见表6。
表3nop寄存器基本属性
寄存器序号
读/写
数据类型
无符号短整型
无符号短整型
响应时间
见附录B
见附录B
是否可挂起
非易失性
不具有
不具有
默认值
0x00*0
TiiKAoNiKAca
状态位
错误域
数据域
模块的影响
执行时间
挂起操作
比特位
读操作成功
模块实际结果
见附录B
挂起状态标志
保留位
模块就绪位
错误域
数值（比特3：0）
Ox0B-0xOC
设备类型(0x01)
表4nop寄存器响应顿描述
nop寄存器响应顿
写操作成功
与接收参数相同
见附录B
读操作失败
不涉及
不涉及
0x0000
错误域被设置
见附录B
表5nop寄存器数据域参数
功能约束
YD/T3126.2-2016
写操作失败
不涉及
不涉及
0x0000
错误域被设置
见附录B
8个比特指示某一挂起操作是否正在执行中。当有挂起操作执行，其中某一位会被设置。主机可以周期性的轮询来判断挂起操作是否完成。0x0表示无挂起操作保留位
1表示模块做好光输出准备，0表示模块未做好光输出准备通过读nop寄存器可以查询到上一条执行完成的命令的错误状态，读取nop寄存器后错误域会被置0x0
表6nop寄存器错误域的取值含义标识
无执行错误
寄存器不支持
只读不可写寄存器，或具有锁保护不可写写寄存器参数错误，原寄存器参数不变由于有挂起操作此条命令被忽略命令被忽略由于模块正在初始化，或包含无效配置扩展地址错误
扩展地址是只读
执行失败
由于承载业务命令被忽略
无效配置
厂商自定义
该寄存器通过AEA机制返回模块的设备类型。对于所有使用本部分的可调光源，该寄存器字符串应是“CWITLAIO”。主机可以通过设备类型寄存器区分不同类型的可调设备。如果对该寄存器执行写操作将返回执行错误。读该寄存器返回ASCII字符串的长度。设备类型响应帧寄存器描述见表8。设备类型寄存器基本属性见表7，表7
设备类型寄存器基本属性
设备类型
寄存器序号
读/写
数据类型
AEA字符串
响应时间
见附录B
是否可挂起
不支持
非易失性
不具有
默认值
CWITLAIO
YD/T3126.2-2016
状态位
错误域
数据域
模块的影响
执行时间
挂起操作
表8设备类型寄存器响应顿描述
设备类型寄存器响应帧
读操作成功
0x0008
AEA相关寄存器配置就绪
见附录B
7.3.3制造厂商(0x02）
写操作成功
不支持
读操作失败
EXF或VSE
0x0000
错误域被设置
见附录B
写操作失败
不支持
通过AEA机制返回模块的制造商，并且是以“VO”终止符结束的ASCII字符串。写该寄存器会返回执行错误。制造厂商返回字符串的长度包括终止符。制造厂商寄存器基本属性见表9，制造厂商寄存器响应顿见表10。表9制造厂商寄存器基本属性
制造厂商
状态位
错误域
数据域
状态位
错误域
数据域
模块影响
执行时间
挂起操作
寄存器序号
读/写
数据类型
AEA字符串
响应时间
见附录B
是否可挂起
不支持
表10制造厂商寄存器响应顿描述制造厂商寄存器响应顿
读操作成功
模块实际结果
模块实际结果
AEA相关寄存器配置就绪
见附录B
7.3.4模块名称(0x03)
写操作成功
不支持
非易失性
读操作失败
EXF或VSE
0x0000
EXF或VSE
0x0000
错误域被设置
见附录B
默认值
0x00xx
写操作失败
不支持
将通过AEA机制返回模块的名称，模块名称由各厂家自定义，但不能超过80个字节。是以“10”终止符结束的ASCII字符串。写该寄存器会返回执行错误。读该寄存器返回ASCII字符串的长度包括结束符模块名称寄存器基本属性见表11，模块名称寄存器响应顿见表12。表11模块名称寄存器基本属性
模块名称
寄存器序号
读/写bZxz.net
数据类型
AEA字符串
响应时间
见附录B
是否可挂起
不支持
非易失性
不具有
默认值
0x00xx
状态位
错误域
数据域
模块影响
执行时间
挂起操作
7.3.5序列号（0x0）
表12模块名称寄存器响应顿描述模块名称寄存器响应
读操作成功
模块实际结果
AEA相关寄存器配置就绪
见附录B
写操作成功
不支持
读操作失败
EXF或VSE
YD/T3126.2-2016
写操作失败
不支持
0x0000
错误域被设置
见附录B
该寄存器通过AEA机制返回模块的序列号，序列号由各厂家自定义，但不能超过80个字节。是以“10终止符结束的ASCII字符串。写该寄存器会返回执行错误，读该寄存器返回ASCII字符串的长度包括终止符。序列号寄存器基本属性见表13，序列号寄存器响应帧见表14。表13序列号寄存器基本属性
序列号
状态位
错误域
数据域
模块影响
执行时间
挂起操作
寄存器序号
读/写
数据类型
AEA字符串
响应时间
见附录B
是否可挂起
不支持
表14序列号寄存器响应帧描述
序列号寄存器响应顿
读操作成功
模块实际运行结果
AEA相关寄存器配置就绪
见附录B
7.3.6生产日期（0x05）
写操作成功
不支持
非易失性
不具有
读操作失败
EXF或VSE
0x0000
错误域被设置
见附录B
默认值
0x00xx
写操作失败
不支持
该寄存器通过AEA机制返回模块的生产日期，生产日期是包含“10’终止符的12字节。格式为“DD-MON-YYYY”。DD段两字符，带前导零，代表一个月中的第几天：MON段3个字符，代表月份（月份使用英文3个字母缩写）：YYYY为4位数的年份。例如“04-APR-2001”。写该寄存器会返回执行错误。生产日期寄存器基本属性见表15，生产日期寄存器响应帧描述见表16。表15生产日期寄存器基本属性
生产日期
状态位
错误域
数据域
寄存器序号
读/写
数据类型
AEA字符串
响应时间
见附录B
是否可挂起
不支持
表16生产日期寄存器响应顿描述生产日期寄存器响应顿描述
读操作成功
模块实际运行结果
写操作成功
不支持
非易失性
不具有
读操作失败
EXF或VSE
0x0000
默认值
0x000c
写操作失败
不支持
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。