讯风通信北向接口协议.doc

BxViewIV文档 讯风通信
BxViewIV告警上报方案
文档前导表
创建部分
文档名称
BxViewIV告警上报方案
版本号
1.00.0000.20050330
编写工具
Microsoft Word of OfficeXP
创建日期
2005年3月30日星期三
作者
祝司占
作用
描述BxViewIV告警上报方案
执行日期
2005年3月30日 星期三 2005年4月18日星期一
执行人
软件组
修改部分
修改日期

修改目的

修改人

版本更改

修改日期

修改目的

修改人

版本更改

结论部分
执行结论

结论日期

签名部分
作者

日期

修改者

日期

执行者

日期

BxViewIV会定时向告警收集服务器发送设备的告警情况，BxViewIV也可以接受告警收集服务器的查询。
用户可以设置定时间隔的时间值，时间间隔以分钟为单位，系统设置了一个保护时间间隔，此值的最小值为20秒，系统默认的间隔时间是5分钟。
BxViewIV最多可以同时上报两个服务器，用户可以对服务器的IP地址和端口进行设置。
在出于对安全方面的考虑，BxViewIV对两个方向上的通信都加上了密码保护，如果密码不正确系统将拒绝接受查询。两个方向的默认密码都是123456。

通信方式
采用以太网UDP/IP方式，TCP方式

通信端口
主动上报的服务器端口：默认值10300，用户可以设置。
被查询时的客户端端口：默认值10400，用户可以设置。

通信数据结构

上报告警信息格式：
帧头【3个字节】【A5】【A5】【A5】
帧类型【1个字节】【01】
帧长【2个字节】
密码【12个字节】
告警时间【7个字节】（年月日时分秒）
网络地址【1个字节】
设备地址【1个字节】
节点名称长度【1个字节】
节点名称【N个字节】【N最大值为255】
槽个数【1个字节】【决定接下来的功能盘结构个数】
[00] 槽位地址【1个字节】
功能盘名称长度【1个字节】
功能盘名称【N个字节】【N最大值为255】
告警个数【1个字节】【决定接下来的告警结构个数】
[00] 告警名称长度【1个字节】
告警名称【N个字节】【N最大值为255】
告警解释长度【1个字节】
告警解释【N个字节】【N最大值为255】
告警端口信息长度【1个字节】
告警端口信息【N个字节】【N最大值为255】
告警状态【1个字节】【01表示告警，00表示正常】
[02] 告警名称长度【1个字节】
告警名称【N个字节】【N最大值为255】
告警解释长度【1个字节】
告警解释【N个字节】【N最大值为255】
告警端口信息长度【1个字节】
告警端口信息【N个字节】【N最大值为255】
告警状态【1个字节】【01表示告警，00表示正常】
……
[FF] 告警名称长度【1个字节】
告警名称【N个字节】【N最大值为255】
告警解释长度【1个字节】
告警解释【N个字节】【N最大值为255】
告警端口信息长度【1个字节】
告警端口信息【N个字节】【N最大值为255】
告警状态【1个字节】【01表示告警，00表示正常】
[01] 槽位地址【1个字节】
功能盘名称长度【1个字节】
功能盘名称【N个字节】【N最大值为255】
告警个数【1个字节】
[00] 告警名称长度【1个字节】
告警名称【N个字节】【N最大值为255】
告警解释长度【1个字节】
告警解释【N个字节】【N最大值为255】
告警端口信息长度【1个字节】
告警端口信息【N个字节】【N最大值为255】
告警状态【1个字节】【01表示告警，00表示正常】
[02] 告警名称长度【1个字节】
告警名称【N个字节】【N最大值为255】
告警解释长度【1个字节】
告警解释【N个字节】【N最大值为255】
告警端口信息长度【1个字节】
告警端口信息【N个字节】【N最大值为255】
告警状态【1个字节】【01表示告警，00表示正常】
……
[FF] 告警名称长度【1个字节】
告警名称【N个字节】【N最大值为255】
告警解释长度【1个字节】
告警解释【N个字节】【N最大值为255】
告警端口信息长度【1个字节】
告警端口信息【N个字节】【N最大值为255】
告警状态【1个字节】【01表示告警，00表示正常】
校验和【1个字节】【校验区中所有字节的和】【校验区是从帧长字节到校验和字节之前】
帧尾【3个字节】【5A】【5A】【5A】

查询告警信息格式：固定帧长22个字节
帧头【3个字节】【93】【93】【93】
帧类型【1个字节】【01】
密码【12个字节】
网络地址【1个字节】
设备地址【1个字节】
服务器序号【1个字节】
校验和【1个字节】【校验区中所有字节的和】【校验区是从密码字节到校验和字节之前】
帧尾【3个字节】【39】【39】【39】

例如：
环境：地址为（1.1）的设备上报6槽（从0开始）V35功能盘RLS的告警。
上报告警信息格式(16进制)：如图：

,
解释说明：
A5H,a5H,a5H: 帧头
01 H：类型
73 H，00H：帧长
31H，31H，31H, 31H，31H，31H, 00H,00H,00H,00H, 00H,00H：密码（111111）
D5H,7H,bH,08H,10H,16H,28H：时间（2005-11-8-16-22-40）
01H,01H:网络地址和设备地址
06H：节点名称长度
D0H,c2H,c9H,e8H,b1H,b8H：节点名称（新设备）
10H :设备槽位个数（16槽）
0H：槽位地址
0H：功能盘名称长度
0H：告警个数
1H：槽位地址
0H：功能盘名称长度
0H：告警个数
2H：槽位地址
0H：功能盘名称长度
0H：告警个数
3H：槽位地址
0H：功能盘名称长度
0H：告警个数
…..
…..
06H：槽位地址
0aH：功能盘名称长度
56H,33H,35H,00H,caH,d3H,cdH,bcH,00H,d3H：功能盘名称
01H：告警个数
03H：告警名称长度
52H，4CH，53H：告警名称。
06H：告警解释长度
CaH,d5H,cfH,fbH,caH,a7H：告警解释
05H：告警端口信息长度
B6H,cbH,bfH,daH,31H：告警端口信息
01H：表示告警

7H：槽位地址
0H：功能盘名称长度
0H：告警个数
….
…..
fH：槽位地址
0H：功能盘名称长度
0H：告警个数
00H:校验和
5a,5a,5a：帧尾。

注：本次修改内容：
1． 修改上报结构，分别添加告警注释和告警的端口信息。
2． 添加TCP方式，客户端需要connect，然后接收数据，TCP上报方式的结构同UDP。
3． 添加告警翻转上报。
4． 添加告警过滤，选择上报所有告警还是上报有告警的告警。

文档结束表
最终修改人
孙忠义
日期
2005年11月8日星期二
最终审核人
孙忠义
日期
2005年11月8日星期二

最终状态
□执行

日期

√完成
孙忠义
日期
2005年11月8日星期二
□废弃

日期

第5页 共5页 软件组 2003