Server以太网通信协议20060417.doc

1、动力环境监控系统以太网通信协议一、报文说明此命令格式只限于客户端程序同服务器程序之间进行数据传输采用的命令，任何同服务器程序之间进行的通信的程序均被服务器视做客户端程序。报文说明基本格式如下：功能码：？简短描述： 简短描述语 描述： 命令的详细介绍数据区： 数据区的数据介绍服务器同工作站画面通信：工作站画面服务器服务器同前置通信处理机通信：前置通信处理机服务器附加说明： 附加说明列表或说明文字二、功能号码索引命令功能号码分配表速查功能码功能描述0 保留1 系统登录2 系统退出3 系统对钟4 实时数据5 告警6 控制输出7 数据库告警事件8 系统全数据9 系统全告警10 参数上下装11 告警确认

2、12 基站事件13 电池冲放电14 Ping15 前置机登录状况1三、报文结构定义3 1 报文结构：服务功能码报文控制域报文传送原因数据区部分的数据长度数据区3 2 报文字段结构C 语言定义：321 报文头部C 语言结构定义 typedef struct WORD wFunctionID; WORD wControl; WORD wReason; WORD wDataLen; MESSAGEHEAD;结构成员说明：wFunctionID命令功能号码，此部分唯一的标示出了报文的功能。具体的命令含义及其相应的附加数据请参考wControl报文控制域。D0=1表示该报文为请求服务报文，D0=0表示该

3、报文为应答服务报文；（注：请求、应答均相对于服务器而言）D1=1表示该报文需要对方的确认，D1=0表示该报文不需要对方的确认；wReason报文传送原因。 D0-D7被采用，具体定义可以讨论修改：号码说明1系统初始化2查询实时数据3查询历史数据4查询告警数据5主动上发告警事件6响应查询命令7所请求的服务不被支持8确认服务9下发控制命令wDataLen参数部分的数据长度3 2 2 命令功能号码定义此部分列出了详细的服务功能码及其对应的数据域部分的组织含义。四、命令分配详解2功能码：0描述：保留功能码 ：1简短描述：系统登录描述：客户机登录系统时所使用的命令。客户机使用此命令向服务器声明自己的身份

4、及用户信息，供服务器判断自己的合法性。服务器在接收到了此命令后对用户的身份进行确认，并返回登录结果。数据区：申请报文包括用户身份证号码、用户名字、用户密码三部分；前置通信机登录时，用户名字字段前 15 个字节采用以0 结尾的字符串 ”前置通信处理机 ”填充，密码部分采用本前置通信处理机的编号（ 4字节）。服务器同工作站画面通信：工作站画面1（ 2字节）D0=1（ 2字节）报文传送原因（ 2字节）32（ 2字节）用户身份（ 2字节）用户名字（ 20字节）用户密码（ 10字节）服务器1（ 2字节）D0=0（ 2字节）报文传送原因（ 2字节）2（ 2字节）登录标示（ 2字节）服务器同前置通信处理机通

5、信：前置通信处理机1（ 2字节）D0=1（ 2字节）报文传送原因（ 2字节）32（ 2字节）用户身份（ 2字节）前置通信处理机（ 14字节）0（ 6字节）前置机编号（ 4字节）0（ 6字节）服务器1（ 2字节）D0=0（ 2字节）报文传送原因（ 2字节）2（ 2字节）3登录标示（2 字节）附加说明：用户身份：登录标示描述0 匿名客户机1 前置通信机2 用户工作站3 报表工作站4 服务器配置工具5 数据库配置工具6 数据库管理工具7 系统管理员8 图像监控客户机9 上级局前置机登录标示含义：登录标示描述说明0 登录失败1浏览用户此类型用户只可以进行数据的浏览，无权进行任何的控制操作。2一般用户此

6、类型用户可以进行数据的浏览， 并可以对受权范围内的控制操作进行命令的下发。3系统管理员此类型用户可以进行系统范围内的任何操作。4 前置通信机5图像监控图像监控中完成自动录像软件。6上级局前置机三级网络 SC 前置机返回功能号码索引功能码：2简短描述：系统声明退出描述：客户机程序关闭时所使用的命令。客户机程序使用此命令来通知服务器自己需要正常关闭退出，这对于发生事故时检查日志有助于帮助发现问题。数据区：无客户机报文2（ 2字节）D0=1（ 2字节）报文传送原因（ 2字节）0（ 2字节）服务器应答报文无返回功能号码索引4功能码：3简短描述：系统对钟描述：客户机程序需要知道系统时间（服务器的时间作为

7、系统统一的时间）时所使用的申请命令及服务器定时向所有系统客户机程序对钟时所使用的命令。数据区：应答报文包括年、月、周、日、时、分、秒、毫秒共8 个字（ 16 字节）。服务器同客户机通信客户机3（ 2字节）D0=1（ 2字节）报文传送原因（ 2字节）0（ 2字节）服务器3（ 2字节）D0=0（ 2字节）报文传送原因（ 2字节）16（ 2字节）年（ 2字节）月（ 2字节）周（ 2字节）日（ 2字节）时（ 2字节）分（ 2字节）秒（ 2字节）毫秒（ 2字节）上级局前置机同地区局服务器通信上级局前置机3（ 2字节）D0=0（ 2字节）报文传送原因（ 2字节）16（ 2字节）年（ 2字节）月（ 2字节）

8、周（ 2字节）日（ 2字节）时（ 2字节）分（ 2字节）秒（ 2字节）毫秒（ 2字节）地区局服务器：无5附加说明：无返回功能号码索引功能码：4简短描述：实时数据描述：客户程序使用此命令从服务器处获得需要的遥测、遥信数据，进而刷新自己的画面显示；服务器可以从前置通信机处获得此命令来更新服务器的实时数据库。数据区：包括遥测数量、遥测信息、遥信数量、遥信信息四个部分；服务器同工作站（ 及与上级局前置机 ）画面通信：工作站画面4（2字节）D0=1（2字节）报文传送原因（2字节）2+4*M+2+4*N（2字节）遥测数量 M（2字节）遥测 1编号（4字节）。遥测 M编号（4字节）遥信数量 N（2字节）遥信

9、 1编号（4字节）。遥信 N编号（4字节）服务器4（2字节）D0=0（2字节）报文传送原因（2字节）2+M*(4+4)+2+N*(4+2)（2字节）遥测数量 M（2字节）遥测 1编号（4字节）遥测 1数值（4字节）。遥测 M编号（4字节）遥测 M数值（4字节）遥信数量 N（2字节）遥信 1编号（4字节）遥信 1数值（2字节）。6遥信 N编号（4字节）遥信 N数值（2字节）服务器同同级前置通信处理机通信：前置通信处理机4（2字节）D0=0（2字节）报文传送原因（2字节）2+M*(4+4)+2+N*(4+2)（2字节）遥测数量 M（2字节）遥测 1编号（4字节）遥测 1数值（4字节）。遥测 M编号

10、（4字节）遥测 M数值（4字节）遥信数量 N（2字节）遥信 1编号（4字节）遥信 1数值（2字节）。遥信 N编号（4字节）遥信 N数值（2字节）服务器无附加说明：上述遥测遥信的数据区定义中，可以出现遥测或者遥信等于0 的情况。若遥测数量M=0 ，下面的数据中没有数据，但是遥测数量M、遥信数量N 两个字段必须存在。返回功能号码索引功能码：5简短描述：SOE描述：当服务器发现告警时，组织好此命令数据并发送给所有系统画面显示客户机程序。在此命令数据区中包含了告警的对象、编号和类型；同样当告警变成正常状态时，也使用这种命令格式。数据区：应答报文包括告警数量及所有的告警数据服务器同工作站画面通信：工作站

11、画面无服务器5D0=0（ 2 字节）（ 2 字节）7报文传送原因（ 2字节）2+M*18（ 2字节）告警数量 M（ 2字节）告警 1对象（ 1字节）告警 1类型（ 1字节）告警 1编号（ 4字节）告警 1数值（ 4字节）告警 1级别（ 1字节）告警 1确认（ 1字节）告警 1时间（ 6字节）。（ 1字节）。（ 1字节）。（ 4字节）。（ 4字节）。（ 1字节）。（ 1字节）。（ 6字节）告警M对象（ 1字节）告警M类型（ 1字节）告警M编号（ 4字节）告警M数值（ 4字节）告警M级别（ 1字节）告警M确认（ 1字节）告警M时间（ 6字节）服务器同前置通信处理机通信：前置通信处理机无服务器无附加

12、说明：告警对象告警对象说明1遥测2遥信3设备4基站告警类型告警对象告警类型值说明0正常遥测2越上限3越下限遥信0正常1告警设备0正常81告警基站0正常1告警告警编号表示对应的告警（ SOE ）对象的数据库编号（遥测、遥信、设备、基站）告警级别告警级别说明0无告警1一级告警2二级告警3三级告警告警确认告警确认说明0没有确认1已得到确认返回功能号码索引功能码 ：6简短描述：控制输出描述：当工作站画面响应用户控制操作时，组织好此命令数据并发送给服务器程序，由服务器将此命令数据转发到相应的前置通信处理机；前置通信处理机同样使用此命令对执行控制的情况告知服务器，由服务器对此结果通知工作站画面。数据区：包

13、含了控制操作所属的基站编号、站内的偏移和控制的目标数据（对遥调而言表示需要的遥调结果；对遥控而言表示需要控制的状态）。服务器同工作站画面通信：工作站画面6（ 2字节）D0=1（ 2字节）报文传送原因（ 2字节）16（ 2字节）操作类型（ 4字节）基站编号（ 4字节）站内偏移（ 4字节）数值（ 4字节）服务器6（ 2字节）D0=0（ 2字节）报文传送原因（ 2字节）20（ 2字节）操作类型（ 4字节）9基站编号（ 4字节）站内偏移（ 4字节）数值（ 4字节）操作结果（ 4字节）服务器同前置通信处理机通信：前置通信处理机6（ 2字节）D0=0（ 2字节）报文传送原因（ 2字节）24（ 2字节）客户

14、机编号（ 4字节）操作类型（ 4字节）基站编号（ 4字节）站内偏移（ 4字节）数值（ 4字节）操作结果（ 4字节）服务器6（ 2字节）D0=1（ 2字节）报文传送原因（ 2字节）20（ 2字节）客户机编号（ 4字节）操作类型（ 4字节）基站编号（ 4字节）站内偏移（ 4字节）数值（ 4字节）附加说明：操作类型操作类型说明1模拟量控制输出（遥调操作），数值字段包含了一个目标操作的浮点型（ ANSI C float）数值。2状态量控制输出（遥控操作），数值字段包含了目标操作的状态（ 0 、1 ）操作结果操作结果说明1前置通信机命令成功下发（基站没有返校）2前置通信机命令下发失败（基站没有返校）3前

15、置通信机接收到了基站执行成功的结果4前置通信机接收到了基站执行失败的结果5前置通信机没有接收到有效的基站应有的执行结果6挂接基站的前置通信机没有登录7网络操作超时（工作站保留）108操作失败（工作站保留）返回功能号码索引功能码 ：7简短描述：数据库告警描述：当数据库管理程序发现数据空间不足、日志空间不足、备份设备空间不足时，主动通知服务器程序，由服务器程序向各个工作站画面通知，产生告警提示。数据区：主要包含了数据库方面的事件类型、剩余空间数值（以K 为单位）、总空间数值（以K 为单位）三个方面的内容。服务器同数据库管理程序通信：数据库管理程序7（ 2字节）D0=1（ 2字节）报文传送原因（ 2

16、字节）12（ 2字节）事件类型（ 4字节）剩余空间数值（ 4字节）总空间数值（ 4字节）服务器7（ 2字节）D0=0（ 2字节）报文传送原因（ 2字节）8（ 2字节）事件类型（ 4字节）操作结果（ 4字节）服务器同工作站画面通信：工作站画面无服务器7（ 2字节）D0=0（ 2字节）报文传送原因（ 2字节）12（ 2字节）事件类型（ 4字节）剩余空间数值（ 4字节）总空间数值（ 4字节）附加说明：事件类型事件类型说明1 数据库数据存储空间越警戒线112 数据库日志空间越警戒线3 转储硬盘空间越警戒线4 磁带存储空间越警戒线返回功能号码索引功能码：8简短描述：系统全数据描述：当工作站画面程序启动时

17、，主动通知服务器程序，由服务器程序向工作站画面通知所有的系统实时数据（包括YC 、YX ）数据区：包含系统实时数据的编号及数值（详请参考功能码： 4 ）服务器同工作站画面通信：工作站画面8（ 2字节）D0=1（ 2字节）报文传送原因（ 2字节）0（ 2字节）服务器8（2字节）D0=0（2字节）报文传送原因（2字节）2+M*(4+4)+2+N*(4+2)（2字节）遥测数量 M（2字节）遥测 1编号（4字节）遥测 1数值（4字节）。遥测 M编号（4字节）遥测 M数值（4字节）遥信数量 N（2字节）遥信 1编号（4字节）遥信 1数值（2字节）。遥信 N编号（4字节）遥信 N数值（2字节）描述：当上级

18、局前置机画面程序启动时，主动通知下级服务器程序，由下级服务器程序向上级前置机画面通知所有的需要上传至上级局的实时数据（包括YC 、YX ）数据区：包含系统实时数据的编号及数值（详请参考功能码： 4 ）12服务器同上级局前置机画面通信：上级局前置机画面8（2字节）D0=1（2字节）上级前置机用户身份 （ 9 ）| 报文传（2字节）用户送原因身份占高字节0（2字节）服务器8（2字节）D0=0（2字节）报文传送原因（2字节）2+M*(4+4)+2+N*(4+2)（2字节）遥测数量 M（2字节）遥测 1编号（4字节）遥测 1数值（4字节）。遥测 M编号（4字节）遥测 M数值（4字节）遥信数量 N（2字

19、节）遥信 1编号（4字节）遥信 1数值（2字节）。遥信 N编号（4字节）遥信 N数值（2字节）附加说明：（详请参考 功能码： 4 ）返回功能号码索引功能码：9简短描述：系统全告警描述：当工作站画面程序启动时，主动通知服务器程序，由服务器程序向工作站画面通知所有的系统告警数据（包括YC 、YX 、设备通信状态、基站通信状态）数据区：包含告警数据的编号及告警值（详请参考功能码： 4 ）服务器同工作站画面通信：工作站画面9（2 字节）13D0=1（ 2字节）报文传送原因（ 2字节）0（ 2字节）服务器9（ 2字节）D0=0（ 2字节）报文传送原因（ 2字节）2+M*18（ 2字节）告警数量 M（ 2

20、字节）告警 1对象（ 1字节）告警 1类型（ 1字节）告警 1编号（ 4字节）告警 1数值（ 4字节）告警 1级别（ 1字节）告警 1确认（ 1字节）告警 1时间（ 6字节）。（ 1字节）。（ 1字节）。（ 4字节）。（ 4字节）。（ 1字节）。（ 1字节）。（ 6字节）告警M对象（ 1字节）告警M类型（ 1字节）告警M编号（ 4字节）告警M数值（ 4字节）告警M级别（ 1字节）告警M确认（ 1字节）告警M时间（ 6字节）附加说明：（详请参考 功能码： 5 ）返回功能号码索引功能码 ：10简短描述：参数上下装描述：当工作站画面需要上下装设备（电源）参数时，使用此命令来通知服务器，由服务器向相关

21、的前置通信处理机发送命令。前置通信处理机返回的数据或结果同样使用此命令通知服务器，由服务器对此命令进行转发。数据区：包括站号、参数序列号及具体的参数14服务器同工作站画面通信：工作站画面10（ 2字节）D0=1（ 2字节）报文传送原因（ 2字节）4+4+2+M*4（ 2字节）站号（ 4字节）参数序列号（ 4字节）参数个数 M（ 2字节）参数 1（ 4字节）。（ 4字节）参数 M（ 4字节）服务器10（ 2字节）D0=0（ 2字节）报文传送原因（ 2字节）4+4+4+2+M*4（ 2字节）站号（ 4字节）参数序列号（ 4字节）参数个数 M（ 2字节）参数 1（ 4字节）。（ 4字节）参数 M（

22、4字节）服务器同前置通信处理机通信：前置通信处理机10（ 2字节）D0=0（ 2字节）报文传送原因（ 2字节）4+4+4+2+M*4（ 2字节）客户机编号（ 4字节）站号（ 4字节）参数序列号（ 4字节）参数个数 M（ 2字节）参数 1（ 4字节）。（ 4字节）参数 M（ 4字节）服务器10（ 2字节）D0=1（ 2字节）报文传送原因（ 2字节）4+4+4+2+M*4（ 2字节）客户机编号（ 4字节）站号（ 4字节）15参数序列号（ 4字节）参数个数 M（ 2字节）参数 1（ 4字节）。（ 4字节）参数 M（ 4字节）附加说明：报文传送原因报文传送原因说明参数个数 M1工作站画面请求前置机的基

23、站参数有效2前置机应答工作站画面请求的基站参数有效3前置机参数上装操作失败04工作站画面下装前置机的基站参数有效5前置机参数下装操作成功06前置机参数下装操作失败07网络操作超时（工作站保留）无意义8操作失败（工作站保留）无意义返回功能号码索引功能码 ：11简短描述：告警确认描述：当工作站画面发生告警的确认时，使用此命令来通知服务器，由服务器对此操作结果进行存入数据库。数据区：包括告警对象、告警编号、告警时间、确认人员服务器同工作站画面通信：工作站画面11（ 2字节）D0=1（ 2字节）报文传送原因（ 2字节）34（ 2字节）告警对象（ 4字节）告警编号（ 4字节）告警时间（ 6字节）确认人员

24、名字（ 20 字节）服务器11（ 2字节）D0=0（ 2字节）报文传送原因（ 2字节）34（ 2字节）告警对象（ 4字节）告警编号（ 4字节）16告警时间（6 字节）确认人员名字（ 20 字节）附加说明：告警对象部分的定义（详请参考功能码： 5 ）返回功能号码索引功能码 ：12简短描述：基站事件描述：前置通信机从基站监控单元那里获得基站环境状态情况，利用此命令上报服务器，服务器直接将此状态事件通知工作站并完成存盘操作。数据区：应答报文包括告警数量及所有的告警数据服务器同工作站画面通信：工作站画面无服务器12（ 2字节）D0=0（ 2字节）报文传送原因（ 2字节）2+M*18（ 2字节）告警数量

25、 M（ 2字节）告警 1对象（ 1字节）告警 1类型（ 1字节）告警 1编号（ 4字节）告警 1数值（ 4字节）告警 1级别（ 1字节）告警 1确认（ 1字节）告警 1时间（ 6字节）。（ 1字节）。（ 1字节）。（ 4字节）。（ 4字节）。（ 1字节）。（ 1字节）。（ 6字节）告警M对象（ 1字节）告警M类型（ 1字节）告警M编号（ 4字节）告警M数值（ 4字节）告警M级别（ 1字节）告警M确认（ 1字节）告警M时间（ 6字节）17服务器同前置通信处理机通信：前置通信处理机12（ 2字节）D0=0（ 2字节）报文传送原因（ 2字节）2+M*18（ 2字节）告警数量 M（ 2字节）告警 1对

26、象（ 1字节）告警 1类型（ 1字节）告警 1编号（ 4字节）告警 1数值（ 4字节）告警 1级别（ 1字节）告警 1 信息编号（ 1字节）告警 1时间（ 6字节）。（ 1字节）。（ 1字节）。（ 4字节）。（ 4字节）。（ 1字节）。（ 1字节）。（ 6字节）告警M对象（ 1字节）告警M类型（ 1字节）告警M编号（ 4字节）告警M数值（ 4字节）告警M级别（ 1字节）告警 M 信息编号（ 1字节）告警M时间（ 6字节）服务器无附加说明：告警数据部分的定义（详请参考功能码： 5 ）返回功能号码索引功能码 ：13简短描述：电池充放电描述：工作站需要知道基站电池的充放电数据时，使用此命令告诉服务器

27、，服务器重新组织此命令并转发给前置通信机，前置通信机从基站监控单元那里获得基站电池的充放电数据后，利用此命令上报服务器，服务器将命令数据通知工作站，最后工作站完成必要的画面刷新工作。数据区：应答报文包括基站和记录号18服务器同工作站画面通信：工作站画面13（ 2字节）D0=1（ 2字节）报文传送原因（ 2字节）8（ 2字节）基站号（ 4字节）记录号（ 4字节）服务器13（ 2字节）D0=0（ 2字节）报文传送原因（ 2字节）4+4+ ？（ 2字节）基站号（ 4字节）记录号（ 4字节）遥测数据表（？字节）服务器同前置通信处理机通信：前置通信处理机13（ 2字节）D0=0（ 2字节）报文传送原因（

28、 2字节）12+ ？（ 2字节）客户机编号（ 4字节）基站号（ 4字节）记录号（ 4字节）遥测数据表（？字节）服务器13（ 2字节）D0=1（ 2字节）报文传送原因（ 2字节）12（ 2字节）客户机编号（ 4字节）基站号（ 4字节）记录号（ 4字节）附加说明：无返回功能号码索引功能码 ：14简短描述：Ping描述：此命令主要目的在于测试目前网络的通信状态。工作站需要知道同服务器的网络连接19状态时，可以采用定时发送此命令的方式获知目前同服务器的连接情况，服务器若接收到此命令会将此命令转发回去；前置通信机使用此命令来定时（暂定 5 分钟） Ping服务器的方法，让服务器知道目前前置通信机的连接情况，否则视为前置通信机非法关闭或退出，服务器对此命令会给予应答。数据区：空服务器同所有客户机通信：客户机（包括前置通信处理机、工作站画面）14（ 2字节）D0=1（ 2字节）报文传送原因（ 2字节）0（ 2字节）服务器14（ 2字节）D0=0（ 2字节）报文传送原因（ 2字节）0（ 2字节）附加说明：无返回功能号码索引功能码 ：15简短描述：前置机登录状况描述：此命令主要目的在于让工作站程序知道目