Server以太网通信协议.doc

Server以太网通信协议20060417一、报文说明 此命令格式只限于客户端程序同服务器程序之间进行数据传输采用的命令,任何同服务器程序之间进行的通信的程序均被服务器视做客户端程序。 报文说明基本格式如下: 功能码: ?? 简短描述: [简短描述语] 描述: [命令的详细介绍]数据区: [数据区的数据介绍]服务器同工作站画面通信: 工作站画面服务器服务器同前置通信处理机通信: 前置通信处理机服务器附加说明:[附加说明列表或说明文字]二、功能号码索引命令功能号码分配表速查功能码功能描述0保留1系统登录2系统退出3系统对钟4实时数据5告警6控制输出7数据库告警事件8系统全数据9系统全告警10参数上下装11告警确认12基站事件13电池冲放电14Ping15前置机登录状况三、:: C语言结构定义 typedefstruct{ WORDwFunctionID; WORDwControl; WORDwReason; WORDwDataLen;}MESSAGEHEAD;结构成员说明:wFunctionID命令功能号码,此部分唯一的标示出了报文的功能。<命令功能号码定义>一节的详细介绍。wControl 报文控制域。D0=1表示该报文为请求服务报文,D0=0表示该报文为应答服务报文;(注:请求、应答均相对于服务器而言)D1=1表示该报文需要对方的确认,D1=0表示该报文不需要对方的确认;wReason 报文传送原因。D0-D7被采用,具体定义可以讨论修改:号码说明1系统初始化2查询实时数据3查询历史数据4查询告警数据5主动上发告警事件6响应查询命令7所请求的服务不被支持8确认服务9下发控制命令wDataLen 此部分列出了详细的服务功能码及其对应的数据域部分的组织含义。四、命令分配详解 功能码: 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字节)上级局前置机同地区局