关于海菱光模块接口通信协议国扬090302.docx
- 文档编号:8781756
- 上传时间:2023-02-01
- 格式:DOCX
- 页数:19
- 大小:22.03KB
关于海菱光模块接口通信协议国扬090302.docx
《关于海菱光模块接口通信协议国扬090302.docx》由会员分享,可在线阅读,更多相关《关于海菱光模块接口通信协议国扬090302.docx(19页珍藏版)》请在冰豆网上搜索。
关于海菱光模块接口通信协议国扬090302
文件编号:
文件密级:
海菱光模块监控通信协议
拟制人:
审核人:
批准人:
版本号:
发布日期:
2007年3月12日
版本修改记录
目录
1.基本格式4
2.报文鉴权和检查4
3.数值和传输4
4.帧头帧尾4
5.逻辑监控单元地址5
6.命令编号5
7.应答标志6
8.数据长度7
9.监控数据7
(1)模块衰减(0x02)7
(2)ALC使能开关(0x04)7
(3)模块输入功率(0x0A)7
(4)模块输出功率(0x0B)7
(5)接收光功率(0xA0)8
(6)发射光功率(0xA1)8
(7)收发无光告警状态(0xA2)8
(8)LD使用寿命告警状态(0xA3)8
(9)模块地址(0xD0)8
(10)模块型号(0xD1)8
(11)模块软件版本号(0xD2)8
(12)设置模块开关(0x12)9
(13)设置射频功率检测校准点(0x40)9
(14)查询射频功率检测校准点(0x41)10
(15)设置ATT校准点10
(16)查询ATT校准点(0x43)11
(17)设置模块最大增益(0x45)12
(18)查询模块增益校准参数(0x46)12
(19)设置FSK发射功率(0x47)13
(20)设置告警门限(0x4A)13
(21)查询告警门限(0x4B)14
(22)FSK全1、全0测试(0x4C)14
(21)查询模块告警(0x90)15
报文格式
报文是数据交换与传输的载体,包含了通信双方用来实现数据交互的完整的信息与结构,报文按照一定的格式被组织起来进行发送,本章将对报文的结构、格式和数据定义进行描述。
1.基本格式
报文一般由帧头(FRH)、逻辑监控单元地址(LUA)、命令编号(CID)、应答标志(ACK)、数据长度(LEN)、监控数据(DATA)、校验单元(CRC)、帧尾(FRT)等组成。
报文中各部分所占位元组见下表:
帧头
逻辑监控单元地址
命令编号
应答标志
数据长度
监控资料
校验单元
帧尾
FRH
LUA
CID
ACK
LEN
DATA
CRC
FRT
1字节
2字节
1字节
1字节
1字节
N字节
2字节
1字节
2.报文鉴权和检查
逻辑监控单元在收到一帧报文后,应首先进行鉴权和检查,确保报文有效后方可进行处理。
收到报文后,应下按照下列顺序进行鉴权和检查:
帧头检查、逻辑监控单元地址过滤、数据长度检查、帧尾检查、CRC校验、命令编号检查、应答标志检查、数据格式检查等。
如果帧头检查、逻辑监控单元地址过滤、数据长度检查、帧尾检查、CRC校验中任何一个环节未通过,则丢弃该条报文(或被转发);如果命令编号检查、应答标志检查、数据格式检查中任何一个环节未通过,接收方应通过应答标志通知发送方具体的报文错误类型。
3.数值和传输
整数分为有符号整数和无符号整数,根据字节长度又分为1字节、2字节和4字节整数,有符号整数采用补码表示法。
布尔型整数是一种只由两个数值(0和1)组成的特殊整数,每个数值代表一种状态,0代表开关关闭、逻辑为假,1代表开关打开、逻辑为真。
2字节、4字节整数在传输时采用大端序(Big-endian),即高字节先传输,低字节后传输。
整数数组按照数组成员的先后顺序传输。
4.帧头帧尾
帧头帧尾是一帧报文的起始和结束标志,各占1个字节,帧头为0xEF,帧尾为0xEE。
5.逻辑监控单元地址
逻辑监控单元地址(LUA)用来区别一台直放站中不同的逻辑监控单元。
逻辑监控单元地址由两个字节组成,第一个字节为逻辑监控单元的类别编号,第二个字节为直放站中该类逻辑监控单元的地址编号。
其中地址编号可以由用户指定,但必须从0连续分配,对于直放站中数目唯一的逻辑监控单元,地址编号必须固定指定为0,例如,8载波选频直放站的8个功放地址编号应依次设为0、1……7。
逻辑监控单元类别定义如表3-1所示:
表1逻辑监控单元类别编号
单元地址
逻辑监控单元
0x84
光模块
其它…
<保留>
6.命令编号
命令编号(CID)是用来区分报文的功能命令的唯一标识,定义如表3-2所示:
表2命令编号
命令编号
命令含义
0x00
<无效>
0x02
模块衰减
0x04
ALC使能开关
0x0A
模块输入功率
0x0B
模块输出功率
0xA0
接收光功率
0xA1
发射光功率
0xA2
收发无光告警状态
0xA3
LD使用寿命告警状态
0xD0
模块地址
0xD1
模块型号
0xD2
模块软件版本号
0xF0
扩展子命令
0X12
设置模块开关
0X40
设置DET校准点
0X41
查询DET校准点
0X42
设置ATT校准点
0X43
查询ATT校准点
0X45
设置模块最大增益
0X46
查询模块增益校准参数
0X47
设置FSK发射功率
0X4A
设置告警门限
0X4B
查询告警门限
0X4C
FSK全1、全0测试
0X90
查询模块告警
其它…
<保留>
7.应答标志
应答标志(ACK)是报文的交互和应答标志。
命令发送方根据发送的命令类型(查询、设置、配置)填充应答标志,报文接收方对收到报文首先进行鉴权检查,如果鉴权失败,则通过应答标志返回错误编号,如果鉴权成功,则根据命令类型对监控数据进行相应的处理。
应答标志定义如表3-3所示:
表3应答标志
应答标志
含义
0x01
查询成功
0x02
设置成功
0x03
配置成功
0x11
查询失败
0x12
设置失败
0x13
配置失败
0x41
<保留>
0x42
命令编号错
0x43
监控资料错
0x44
应答标志错
0x81
查询命令
0x82
设置命令
0x83
配置命令
0X00
成功
0X05
校验错
0X04
操作失败
0xFE
其它错误
其它…
<保留>
其中,通过查询命令可以获取从监控单元的监控数据,通过设置命令可以将监控数据设置给从监控单元,而配置命令与设置命令相似,唯一的区别在于通过配置命令发送给从监控单元的监控数据必须存储在掉电不可挥发内存中,例如EEPROM、Flash、NVRAM等,而设置命令则无需保存,只对被控单元进行控制即可,区分设置与配置的目的在于,这样做可以在仅需对被控单元进行控制时,无须频繁擦写内存,从而大大延长内存的使用寿命,下文中如无特殊要求,将设置与配置统称为设置。
8.数据长度
数据长度(LEN)是监控数据域位的字节总数。
1字节无符号整数,取值范围为0~255。
9.监控数据
查询或设置时,监控数据无论是命令报文还是应答报文,均不得为空,必须与期望查询或设置的数据长度一致。
查询监控数据时,监控数据域位在发起方报文中用全0填充,并在接收方的应答报文中写入实时查询值。
设置监控资料时,监控数据域位在发起方报文中写入设置值,并在接收方的应答报文中写入实际设置值。
在监控通信协议中,不同命令所对应的数据格式是不相同的,当报文的监控数据格式不符合规定时,应答标志返回数据格式错。
具体格式定义如下所示:
(1)模块衰减(0x02)
描述:
用于查询、设置或配置模块增益的衰减值;
类型:
查询、设置、配置;
格式:
2字节无符号整数,单位dB,设置范围为0~模块衰减器的标称控制范围。
(2)ALC使能开关(0x04)
描述:
用于查询、设置或配置模块的ALC使能开关状态;
类型:
查询、设置、配置;
格式:
2字节布尔型整数,0表示禁止ALC功能,1表示使能ALC功能。
(3)模块输入功率(0x0A)
描述:
用于查询模块输入功率的AD值;
类型:
查询;
格式:
2字节无符号整数(当希望返回实际电平值时应将电平值+0x8000,转换为正整数)。
(4)模块输出功率(0x0B)
描述:
描述:
用于查询模块输出功率的AD值;
类型:
查询;
格式:
2字节无符号整数(当希望返回实际电平值时应将电平值+0x8000,转换为正整数)。
(5)接收光功率(0xA0)
描述:
用于查询模块接收的光功率值
类型:
查询;
格式:
2字节有符号整数,单位为dBm。
(6)发射光功率(0xA1)
描述:
用于查询、设置或配置模块发射的光功率值;
类型:
查询、设置、配置;
格式:
2字节有符号整数,单位为dBm。
(7)收发无光告警状态(0xA2)
描述:
用于查询模块收发无光告警状态;
类型:
查询;
格式:
2字节布尔型整数,0表示工作正常,1表示收无光或发无光。
(8)LD使用寿命告警状态(0xA3)
描述:
用于查询模块LD使用寿命告警状态;
类型:
查询;
格式:
2字节布尔型整数,0表示工作正常,1表示收无光或发无光。
(9)模块地址(0xD0)
描述:
用于查询、配置模块位址;
类型:
查询、配置;
格式:
1字节无符号整数。
(10)模块型号(0xD1)
描述:
用于查询模块的型号;
类型:
查询;
格式:
20字节ASCII码字符串,不满20字节的,用0x00填充至20字节。
(11)模块软件版本号(0xD2)
描述:
用于查询模块的软件版本号;
类型:
查询;
格式:
4成员1字节无符号整数数组,由低至高依次为主、次、修订、分支版本号。
(12)设置模块开关(0x12)
描述:
用于设置模块的开关状态;
类型:
设置;
格式:
设置模块开关命令格式(上位机—>模块)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
1Byte
模块地址
0X12
0X00
0X01
命令数据
设置模块开关命令的响应(模块—>上位机)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
1Byte
模块地址
0X12
应答标志
0X01
命令数据
设置模块开关的命令数据
位序号
编码
含义
Bit7~1
0
保留
Bit0
0
关
1
开
(13)设置射频功率检测校准点(0x40)
描述:
用于设置射频功率检测校准点的功率值;
类型:
设置;
格式:
设置射频功率检测校准点命令格式(上位机—>模块)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
2Byte
模块地址
0X40
0X00
0X02
命令数据
设置射频功率检测校准点命令的响应(模块—>上位机)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
2Byte
模块地址
0X40
应答标志
0X02
命令数据
设置射频功率检测校准点及响应的命令数据
字节序号
编码
含义
Byte1
0X00~0XFF
校准点的序号
Byte0
0X00~0XFF
校准点的实际功率
利用射频功率检测的线性,在线性最好的区间内取点,确定射频功率检测的电压与功率间的对应关系。
(14)查询射频功率检测校准点(0x41)
描述:
用于查询射频功率检测校准点的功率值;
类型:
查询;
格式:
查询射频功率检测校准点命令格式(上位机—>模块)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
0Byte
模块地址
0X41
0X00
0X00
无
查询射频功率检测校准点命令的响应(模块—>上位机)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
15Byte
模块地址
0X41
应答标志
0X0F
命令数据
查询射频功率检测校准点响应的命令数据
字节序号
编码
含义
Byte14
0X00~0XFF
实际功率1
Byte10~13
0X00000000~0XFFFFFFFF
对应实际功率1的电压,浮点数表示
Byte9
0X00~0XFF
实际功率2
Byte5~8
0X00000000~0XFFFFFFFF
对应实际功率2的电压,浮点数表示
Byte4
0X00~0XFF
实际功率3
Byte0~3
0X00000000~0XFFFFFFFF
对应实际功率3的电压,浮点数表示
(15)设置ATT校准点
描述:
用于设置模块ATT校准点;
类型:
设置;
格式:
设置ATT校准点命令格式(上位机—>模块)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
4Byte
模块地址
0X42
0X00
0X04
命令数据
设置ATT校准点命令的响应(模块—>上位机)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
4Byte
模块地址
0X42
应答标志
0X04
命令数据
设置ATT校准点及响应的命令数据
字节序号
编码
含义
Byte3
0X00~0XFF
校准点的ATT值1
Byte2
0X00~0XFF
校准值1
Byte1
0X00~0XFF
校准点的ATT值2
Byte0
0X00~0XFF
校准值2
为了保证模块ATT控制的精度,对不同ATT值可能需要进行不同的修正:
当ATT值<校准点1时,不进行ATT值修正;当校准点1≤ATT值<校准点2时,将ATT值+校准值1后控制模块;当ATT值≥校准点2时,将ATT值+校准值2后控制模块。
(16)查询ATT校准点(0x43)
描述:
用于查询模块ATT校准点;
类型:
查询;
格式:
查询ATT校准点命令格式(上位机—>模块)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
0Byte
模块地址
0X43
0X00
0X00
无
查询ATT校准点命令的响应(模块—>上位机)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
4Byte
模块地址
0X43
应答标志
0X04
命令数据
查询ATT校准点响应的命令数据
字节序号
编码
含义
Byte3
0X00~0XFF
校准点的ATT值1
Byte2
0X00~0XFF
校准值1
Byte1
0X00~0XFF
校准点的ATT值2
Byte0
0X00~0XFF
校准值2
(17)设置模块最大增益(0x45)
描述:
用于设置模块的最大增益;
类型:
设置;
格式:
设置模块最大增益命令格式(上位机—>模块)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
2Byte
模块地址
0X45
0X00
0X02
命令数据
设置模块最大增益命令的响应(模块—>上位机)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
2Byte
模块地址
0X45
应答标志
0X02
命令数据
设置模块最大增益及响应的命令数据
字节序号
编码
含义
Byte1
0X00~0XFF
模块最大增益
Byte0
0X00~0XFF
设置ATT值
(保证最大增益时需设置的ATT)
衰减值是实际衰减值,模块需校正后控制ATT
(18)查询模块增益校准参数(0x46)
描述:
用于查询模块增益校准参数;
类型:
查询;
格式:
查询模块增益校准参数命令格式(上位机—>模块)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
0Byte
模块地址
0X46
0X00
0X00
无
查询模块增益校准参数命令的响应(模块—>上位机)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
2Byte
模块地址
0X46
应答标志
0X02
命令数据
查询模块增益校正参数响应的命令数据
字节序号
编码
含义
Byte1
0X00~0XFF
模块的最大增益
Byte0
0X00~0XFF
增加的ATT值
(19)设置FSK发射功率(0x47)
描述:
用于设置模块的FSK发射功率;
类型:
设置;
格式:
设置FSK发射功率命令格式(上位机—>模块)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
1Byte
模块地址
0X47
0X00
0X01
命令数据
设置FSK发射功率命令的响应(模块—>上位机)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
1Byte
模块地址
0X47
应答标志
0X01
命令数据
设置FSK发射功率及响应的命令数据
字节序号
编码
含义
Byte0
0X00~0XFF
功率值
(20)设置告警门限(0x4A)
描述:
用于设置模块的发无光、收无光告警门限;
类型:
设置;
格式:
设置告警门限命令格式(上位机—>模块)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
2Byte
模块地址
0X4A
0X00
0X02
命令数据
设置告警门限命令的响应(模块—>上位机)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
2Byte
模块地址
0X4A
应答标志
0X02
命令数据
设置告警门限及响应的命令数据
字节序号
编码
含义
Byte1
0X00~0XFF
发光告警门限
Byte0
0X00~0XFF
收光告警门限
(21)查询告警门限(0x4B)
描述:
用于查询模块的发无光、收无光告警门限;
类型:
查询;
格式:
查询告警门限命令格式(上位机—>模块)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
0Byte
模块地址
0X4B
0X00
0X00
无
查询告警门限命令的响应(模块—>上位机)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
2Byte
模块地址
0X4B
应答标志
0X02
命令数据
查询告警门限响应的命令数据
字节序号
编码
含义
Byte1
0X00~0XFF
发光告警门限
Byte0
0X00~0XFF
收光告警门限
(22)FSK全1、全0测试(0x4C)
描述:
用于测试模块的FSK发射频谱特性;
类型:
设置;
格式:
FSK全1、全0测试命令格式(上位机—>模块)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
1Byte
模块地址
0X4C
0X00
0X01
命令数据
FSK全1、全0测试命令的响应(模块—>上位机)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
1Byte
模块地址
0X4C
应答标志
0X01
命令数据
FSK全1、全0测试的命令数据
位序号
编码
含义
Bit7~1
0
保留
Bit0
0
全0测试
1
全1测试
(21)查询模块告警(0x90)
描述:
用于查询模块的故障告警情况;
类型:
查询;
格式:
查询模块告警命令格式(上位机—>模块)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
4Byte
模块地址
0X90
0X00
0X04
命令数据
查询模块告警命令的响应(模块—>上位机)
模块地址
命令编号
应答标志
数据长度
命令数据
2Byte
1Byte
1Byte
1Byte
4Byte
模块地址
0X90
应答标志
0X04
命令数据
查询模块告警及响应的命令数据
字节序号
位序号
编码
含义
Byte3~1
Bit7~0
0X00
保留
Byte0
Bit7
1
有自激告警
0
无自激告警
Bit6
1
有发无光告警
0
无发无光告警
Bit5
1
有收无光告警
0
无收无光告警
Bit4
1
有低功率告警
0
无低功率告警
Bit3
1
有过功率告警
0
无过功率告警
Bit2
1
有过温度告警
0
无过温度告警
Bit1
1
有驻波告警
0
无驻波告警
Bit0
1
有模块故障告警
0
无模块故障告警
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 关于 海菱光 模块 接口 通信协议 090302