Server以太网通信协议20060417

动力环境监控系统以太网通信协议一、报文说明此命令格式只限于客户端程序同服务器程序之间进行数据传输采用的命令，任何同服务器程序之间进行的通信的程序均被服务器视做客户端程序。报文说明基本格式如下：功能码：？？简短描述：[简短描述语]描述：[命令的详细介绍]数据区：[数据区的数据介绍]服务器同工作站画面通信：工作站画面服务器服务器同前置通信处理机通信：前置通信处理机服务器附加说明：[附加说明列表或说明文字]二、功能号码索引命令功能号码分配表速查功能码功能描述0保留1系统登录2系统退出3系统对钟4实时数据5告警6控制输出7数据库告警事件8系统全数据9系统全告警10参数上下装11告警确认12基站事件13电池冲放电14Ping15前置机登录状况三、报文结构定义3．1报文结构：服务功能码报文控制域报文传送原因数据区部分的数据长度数据区3．2报文字段结构C语言定义：3．2．1报文头部C语言结构定义typedefstruct{WORDwFunctionID;WORDwControl;WORDwReason;WORDwDataLen;}MESSAGEHEAD;结构成员说明：wFunctionID命令功能号码，此部分唯一的标示出了报文的功能。具体的命令含义及其相应的附加数据请参考2.2.2部分命令功能号码定义一节的详细介绍。wControl报文控制域。D0=1表示该报文为请求服务报文，D0=0表示该报文为应答服务报文；（注：请求、应答均相对于服务器而言）D1=1表示该报文需要对方的确认，D1=0表示该报文不需要对方的确认；wReason报文传送原因。D0-D7被采用，具体定义可以讨论修改：号码说明1系统初始化2查询实时数据3查询历史数据4查询告警数据5主动上发告警事件6响应查询命令7所请求的服务不被支持8确认服务9下发控制命令wDataLen参数部分的数据长度3．2．2命令功能号码定义此部分列出了详细的服务功能码及其对应的数据域部分的组织含义。四、命令分配详解功能码：0描述：保留功能码：1简短描述：系统登录描述：客户机登录系统时所使用的命令。客户机使用此命令向服务器声明自己的身份及用户信息，供服务器判断自己的合法性。服务器在接收到了此命令后对用户的身份进行确认，并返回登录结果。数据区：申请报文包括用户身份证号码、用户名字、用户密码三部分；前置通信机登录时，用户名字字段前15个字节采用以0结尾的字符串”前置通信处理机”填充，密码部分采用本前置通信处理机的编号（4字节）。服务器同工作站画面通信：工作站画面1（2字节）D0=1（2字节）报文传送原因（2字节）32（2字节）用户身份（2字节）用户名字（20字节）用户密码（10字节）服务器1（2字节）D0=0（2字节）报文传送原因（2字节）2（2字节）登录标示（2字节）服务器同前置通信处理机通信：前置通信处理机1（2字节）D0=1（2字节）报文传送原因（2字节）32（2字节）用户身份（2字节）前置通信处理机（14字节）0（6字节）前置机编号（4字节）0（6字节）服务器1（2字节）D0=0（2字节）报文传送原因（2字节）2（2字节）登录标示（2字节）附加说明：用户身份：登录标示描述0匿名客户机1前置通信机2用户工作站3报表工作站4服务器配置工具5数据库配置工具6数据库管理工具7系统管理员8图像监控客户机9上级局前置机登录标示含义：登录标示描述说明0登录失败1浏览用户此类型用户只可以进行数据的浏览，无权进行任何的控制操作。2一般用户此类型用户可以进行数据的浏览，并可以对受权范围内的控制操作进行命令的下发。3系统管理员此类型用户可以进行系统范围内的任何操作。4前置通信机5图像监控图像监控中完成自动录像软件。6上级局前置机三级网络SC前置机返回《功能号码索引》功能码：2简短描述：系统声明退出描述：客户机程序关闭时所使用的命令。客户机程序使用此命令来通知服务器自己需要正常关闭退出，这对于发生事故时检查日志有助于帮助发现问题。数据区：无客户机报文2（2字节）D0=1（2字节）报文传送原因（2字节）0（2字节）服务器应答报文无返回《功能号码索引》功能码：3简短描述：系统对钟描述：客户机程序需要知道系统时间（服务器的时间作为系统统一的时间）时所使用的申请命令及服务器定时向所有系统客户机程序对钟时所使用的命令。数据区：应答报文包括年、月、周、日、时、分、秒、毫秒共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字节）周（2字节）日（2字节）时（2字节）分（2字节）秒（2字节）毫秒（2字节）地区局服务器：无附加说明：无返回《功能号码索引》功能码：4简短描述：实时数据描述：客户程序使用此命令从服务器处获得需要的遥测、遥信数据，进而刷新自己的画面显示；服务器可以从前置通信机处获得此命令来更新服务器的实时数据库。数据区：包括遥测数量、遥测信息、遥信数量、遥信信息四个部分；服务器同工作站（及与上级局前置机）画面通信：工作站画面4（2字节）D0=1（2字节）报文传送原因（2字节）2+4*M+2+4*N（2字节）遥测数量M（2字节）遥测1编号（4字节）。。。遥测M编号（4字节）遥信数量N（2字节）遥信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字节）。。。。。。遥信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编号（4字节）遥测M数值（4字节）遥信数量N（2字节）遥信1编号（4字节）遥信1数值（2字节）。。。。。。遥信N编号（4字节）遥信N数值（2字节）服务器无附加说明：上述遥测遥信的数据区定义中，可以出现遥测或者遥信等于0的情况。若遥测数量M=0，下面的数据中没有数据，但是遥测数量M、遥信数量N两个字段必须存在。返回《功能号码索引》功能码：5简短描述：SOE描述：当服务器发现告警时，组织好此命令数据并发送给所有系统画面显示客户机程序。在此命令数据区中包含了告警的对象、编号和类型；同样当告警变成正常状态时，也使用这种命令格式。数据区：应答报文包括告警数量及所有的告警数据服务器同工作站画面通信：工作站画面无服务器5（2字节）D0=0（2字节）报文传送原因（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字节）服务器同前置通信处理机通信：前置通信处理机无服务器无附加说明：告警对象告警对象说明1遥测2遥信3设备4基站告警类型告警对象告警类型值说明遥测0正常2越上限3越下限遥信0正常1告警设备0正常1告警基站0正常1告警告警编号表示对应的告警（SOE）对象的数据库编号（遥测、遥信、设备、基站）告警级别告警级别说明0无告警1一级告警2二级告警3三级告警告警确认告警确认说明0没有确认1已得到确认返回《功能号码索引》功能码：6简短描述：控制输出描述：当工作站画面响应用户控制操作时，组织好此命令数据并发送给服务器程序，由服务器将此命令数据转发到相应的前置通信处理机；前置通信处理机同样使用此命令对执行控制的情况告知服务器，由服务器对此结果通知工作站画面。数据区：包含了控制操作所属的基站编号、站内的偏移和控制的目标数据（对遥调而言表示需要的遥调结果；对遥控而言表示需要控制的状态）。服务器同工作站画面通信：工作站画面6（2字节）D0=1（2字节）报文传送原因（2字节）16（2字节）操作类型（4字节）基站编号（4字节）站内偏移（4字节）数值（4字节）服务器6（2字节）D0=0（2字节）报文传送原因（2字节）20（2字节）操作类型（4字节）基站编号（4字节）站内偏移（4字节）数值（4字节）操作结果（4字节）服务器同前置通信处理机通信：前置通信处理机6（2字节）D0=0（2字节）报文传送原因（2字节）24（2字节）客户机编号（4字节）操作类型（4字节）基站编号（4字节）站内偏移（4字节）数值（4字节）操作结果（4字节）服务器6（2字节）D0=1（2字节）报文传送原因（2字节）20（2字节）客户机编号（4字节）操作类型（4字节）基站编号（4字节）站内偏移（4字节）数值（4字节）附加说明：操作类型操作类型说明1模拟量控制输出（遥调操作），数值字段包含了一个目标操作的浮点型（ANSICfloat）数值。2状态量控制输出（遥控操作），数值字段包含了目标操作的状态（0、1）操作结果操作结果说明1前置通信机命令成功下发（基站没有返校）2前置通信机命令下发失败（基站没有返校）3前置通信机接收到了基站执行成功的结果4前置通信机接收到了基站执行失败的结果5前置通信机没有接收到有效的基站应有的执行结果6挂接基站的前置通信机没有登录7网络操作超时（工作站保留）8操作失败（工作站保留）返回《功能号码索引》功能码：7简短描述：数据库告警描述：当数据库管理程序发现数据空间不足、日志空间不足、备份设备空间不足时，主动通知服务器程序，由服务器程序向各个工作站画面通知，产生告警提示。数据区：主要包含了数据库方面的事件类型、剩余空间数值（以K为单位）、总空间数值（以K为单位）三个方面的内容。服务器同数据库管理程序通信：数据库管理程序服务器7（2字节）D0=0（2字节）报文传送原因（2字节）8（2字节）事件类型（4字节）操作结果（4字节）服务器同工作站画面通信：工作站画面无服务器7（2字节）D0=0（2字节）报文传送原因（2字节）12（2字节）事件类型（4字节）剩余空间数值（4字节）总空间数值（4字节）附加说明：事件类型事件类型说明7（2字节）D0=1（2字节）报文传送原因（2字节）12（2字节）事件类型（4字节）剩余空间数值（4字节）总空间数值（4字节）1数据库数据存储空间越警戒线2数据库日志空间越警戒线3转储硬盘空间越警戒线4磁带存储空间越警戒线返回《功能号码索引》功能码：8简短描述：系统全数据描述：当工作站画面程序启动时，主动通知服务器程序，由服务器程序向工作站画面通知所有的系统实时数据（包括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字节）描述：当上级局前置机画面程序启动时，主动通知下级服务器程序，由下级服务器程序向上级前置机画面通知所有的需要上传至上级局的实时数据（包括YC、YX）数据区：包含系统实时数据的编号及数值（详请参考功能