动力环境监控系统以太网通信协议一、报文说明此命令格式只限于客户端程序同服务器程序之间进行数据传输采用的命令,任何同服务器程序之间进行的通信的程序均被服务器视做客户端程序。
报文说明基本格式如下:功能码:??简短描述:[简短描述语]描述:[命令的详细介绍]数据区:[数据区的数据介绍]服务器同工作站画面通信:工作站画面服务器服务器同前置通信处理机通信:前置通信处理机服务器附加说明:[附加说明列表或说明文字]二、功能号码索引命令功能号码分配表速查三、报文结构定义3.1 报文结构:3.2 报文字段结构C3.2.1 报文头部C语言结构定义typedef struct {WORD wFunctionID;WORD wControl;WORD wReason;WORD wDataLen;} MESSAGEHEAD;结构成员说明:wFunctionID命令功能号码,此部分唯一的标示出了报文的功能。
具体的命令含义及其相应的附加数据请参考2.2.2部分<命令功能号码定义>一节的详细介绍。
wControl报文控制域。
D0=1表示该报文为请求服务报文,D0=0表示该报文为应答服务报文;(注:请求、应答均相对于服务器而言)D1=1表示该报文需要对方的确认,D1=0表示该报文不需要对方的确认;wReason报文传送原因。
D0-D7被采用,具体定义可以讨论修改:参数部分的数据长度3.2.2命令功能号码定义此部分列出了详细的服务功能码及其对应的数据域部分的组织含义。
四、命令分配详解功能码:0描述:保留功能码: 1简短描述:系统登录描述:客户机登录系统时所使用的命令。
客户机使用此命令向服务器声明自己的身份及用户信息,供服务器判断自己的合法性。
服务器在接收到了此命令后对用户的身份进行确认,并返回登录结果。
数据区:申请报文包括用户身份证号码、用户名字、用户密码三部分;前置通信机登录时,用户名字字段前15个字节采用以0结尾的字符串”前置通信处理机”填充,密码部分采用本前置通信处理机的编号(4字节)。
服务器同工作站画面通信:工作站画面服务器服务器同前置通信处理机通信:前置通信处理机附加说明:用户身份:登录标示含义:返回《功能号码索引》功能码: 2简短描述:系统声明退出描述:客户机程序关闭时所使用的命令。
客户机程序使用此命令来通知服务器自己需要正常关闭退出,这对于发生事故时检查日志有助于帮助发现问题。
数据区:无客户机报文无返回《功能号码索引》功能码: 3简短描述:系统对钟描述:客户机程序需要知道系统时间(服务器的时间作为系统统一的时间)时所使用的申请命令及服务器定时向所有系统客户机程序对钟时所使用的命令。
数据区:应答报文包括年、月、周、日、时、分、秒、毫秒共8个字(16字节)。
服务器同客户机通信客户机服务器上级局前置机同地区局服务器通信上级局前置机地区局服务器:无附加说明:无返回《功能号码索引》功能码: 4简短描述:实时数据描述:客户程序使用此命令从服务器处获得需要的遥测、遥信数据,进而刷新自己的画面显示;服务器可以从前置通信机处获得此命令来更新服务器的实时数据库。
数据区:包括遥测数量、遥测信息、遥信数量、遥信信息四个部分;服务器同工作站(及与上级局前置机)画面通信:工作站画面服务器服务器同同级前置通信处理机通信:前置通信处理机附加说明:上述遥测遥信的数据区定义中,可以出现遥测或者遥信等于0的情况。
若遥测数量M=0,下面的数据中没有数据,但是遥测数量M、遥信数量N两个字段必须存在。
返回《功能号码索引》功能码: 5简短描述:SOE描述:当服务器发现告警时,组织好此命令数据并发送给所有系统画面显示客户机程序。
在此命令数据区中包含了告警的对象、编号和类型;同样当告警变成正常状态时,也使用这种命令格式。
数据区:应答报文包括告警数量及所有的告警数据服务器同工作站画面通信:工作站画面无服务器服务器同前置通信处理机通信:前置通信处理机无服务器无附加说明:告警对象告警类型告警编号表示对应的告警(SOE)对象的数据库编号(遥测、遥信、设备、基站)告警级别返回《功能号码索引》功能码: 6简短描述:控制输出描述:当工作站画面响应用户控制操作时,组织好此命令数据并发送给服务器程序,由服务器将此命令数据转发到相应的前置通信处理机;前置通信处理机同样使用此命令对执行控制的情况告知服务器,由服务器对此结果通知工作站画面。
数据区:包含了控制操作所属的基站编号、站内的偏移和控制的目标数据(对遥调而言表示需要的遥调结果;对遥控而言表示需要控制的状态)。
服务器同工作站画面通信:工作站画面服务器服务器同前置通信处理机通信:前置通信处理机附加说明:操作类型操作结果返回《功能号码索引》功能码:7简短描述:数据库告警描述:当数据库管理程序发现数据空间不足、日志空间不足、备份设备空间不足时,主动通知服务器程序,由服务器程序向各个工作站画面通知,产生告警提示。
数据区:主要包含了数据库方面的事件类型、剩余空间数值(以K为单位)、总空间数值(以K为单位)三个方面的内容。
服务器同数据库管理程序通信:数据库管理程序服务器服务器同工作站画面通信:工作站画面无服务器附加说明:事件类型返回《功能号码索引》功能码:8简短描述:系统全数据描述:当工作站画面程序启动时,主动通知服务器程序,由服务器程序向工作站画面通知所有的系统实时数据(包括YC、YX)数据区:包含系统实时数据的编号及数值(详请参考功能码:4)服务器同工作站画面通信:工作站画面服务器描述:当上级局前置机画面程序启动时,主动通知下级服务器程序,由下级服务器程序向上级前置机画面通知所有的需要上传至上级局的实时数据(包括YC、YX)数据区:包含系统实时数据的编号及数值(详请参考功能码:4)服务器同上级局前置机画面通信:上级局前置机画面附加说明:(详请参考功能码:4)返回《功能号码索引》功能码:9简短描述:系统全告警描述:当工作站画面程序启动时,主动通知服务器程序,由服务器程序向工作站画面通知所有的系统告警数据(包括YC、YX、设备通信状态、基站通信状态)数据区:包含告警数据的编号及告警值(详请参考功能码:4)服务器同工作站画面通信:工作站画面服务器附加说明:(详请参考功能码:5)返回《功能号码索引》功能码:10简短描述:参数上下装描述:当工作站画面需要上下装设备(电源)参数时,使用此命令来通知服务器,由服务器向相关的前置通信处理机发送命令。
前置通信处理机返回的数据或结果同样使用此命令通知服务器,由服务器对此命令进行转发。
数据区:包括站号、参数序列号及具体的参数服务器同工作站画面通信:工作站画面服务器同前置通信处理机通信:前置通信处理机服务器附加说明:报文传送原因返回《功能号码索引》功能码:11简短描述:告警确认描述:当工作站画面发生告警的确认时,使用此命令来通知服务器,由服务器对此操作结果进行存入数据库。
数据区:包括告警对象、告警编号、告警时间、确认人员服务器同工作站画面通信:工作站画面附加说明:告警对象部分的定义(详请参考功能码:5)返回《功能号码索引》功能码:12简短描述:基站事件描述:前置通信机从基站监控单元那里获得基站环境状态情况,利用此命令上报服务器,服务器直接将此状态事件通知工作站并完成存盘操作。
数据区:应答报文包括告警数量及所有的告警数据服务器同工作站画面通信:工作站画面无服务器服务器同前置通信处理机通信:前置通信处理机服务器附加说明:告警数据部分的定义(详请参考功能码:5)返回《功能号码索引》功能码:13简短描述:电池充放电描述:工作站需要知道基站电池的充放电数据时,使用此命令告诉服务器,服务器重新组织此命令并转发给前置通信机,前置通信机从基站监控单元那里获得基站电池的充放电数据后,利用此命令上报服务器,服务器将命令数据通知工作站,最后工作站完成必要的画面刷新工作。
数据区:应答报文包括基站和记录号服务器同工作站画面通信:工作站画面服务器服务器同前置通信处理机通信:前置通信处理机服务器附加说明:无返回《功能号码索引》功能码:14简短描述:Ping描述:此命令主要目的在于测试目前网络的通信状态。
工作站需要知道同服务器的网络连接状态时,可以采用定时发送此命令的方式获知目前同服务器的连接情况,服务器若接收到此命令会将此命令转发回去;前置通信机使用此命令来定时(暂定5分钟)Ping服务器的方法,让服务器知道目前前置通信机的连接情况,否则视为前置通信机非法关闭或退出,服务器对此命令会给予应答。
数据区:空服务器同所有客户机通信:客户机(包括前置通信处理机、工作站画面)服务器附加说明:无返回《功能号码索引》功能码:15简短描述:前置机登录状况描述:此命令主要目的在于让工作站程序知道目前系统中前置通信机的登录情况。
工作站需要知道目前系统中前置通信机的登录情况时,可以采用发送此命令的方式获得;系统中发生系统中前置通信机的登录和退出事件时,服务器主动通知系统在线的所有工作站程序。
所有的工作站程序都会接收到前置通信机的登录和退出事件。
数据区:空服务器同工作站画面通信:工作站画面服务器附加说明:标志字段为0表示前置机退出系统,否则表示登录系统。
返回《功能号码索引》五、修改记录5.1在功能表里添加了Ping(功能码:14)功能来实现测试系统网络连接情况。
……7/31/2001 11:56:42 AM 5.2在功能表里添加了前置机登录状况(功能码:15)功能。
……7/31/2001 6:47:19 PM 5.3修改了Ping(功能码:14)功能的数据域字段定义,请注意描述部分及附加说明。
……8/1/2001 8:43:46 AM 5.4修改了前置机登录状况(功能码:15)功能的数据域字段定义,请注意描述部分及附加说明。
……8/1/2001 9:43:46 AM 5.5删除了Ping(功能码:14)功能的数据域字段。
……8/2/2001 11:52:44 AM 5.6Ping(功能码:14)功能的描述和附加说明部分做了修改。
……8/6/2001 9:08:43 AM 5.7系统登录(功能码:1)的登录标示中增加了“录像监视”条目。
……5/6/2003 11:43:36 AM 5.8系统登录(功能码:1)的登录标示中增加了“上级局前置机”条目。
(jiangli 2006-4-29)5.9系统全数据(功能码:8)增加了上级局前置机请求全数据功能。
(jiangli 2006-4-30)5.10系统对钟(功能码3)增加了上级局前置机给地区局服务器对钟。
(jiangli 20006-5-10)2001年6月11日最新更改日期:2006年5月10日。