医疗应急指挥系统与PDA终端接口协议.doc

医疗应急指挥系统与PDA终端接口协议 （V1.0） 2011年10月 21日 目 录 前 言 本规范为医疗公共卫生应急指挥系统与PDA接口规范，简称YJPADPP. 本规范描述了医疗应急指挥系统与手持终端PDA（国产平板电脑）之间业务通讯的相关消息的类型和定义。根据业务的发展，规范中的信令操作和参数将会做进一步的调整和增加。 本规范解释权属于 中科软科技股份有限公司。 本规范起草单位：中科软科技股份有限公司应急指挥组。  范围 本规范规定了以下三方面的内容： 应急指挥系统与国产平板电脑的接口协议； 应急指挥视频指挥中心与国产平板电脑的接口协议； 本规范适用于指挥系统和PDA上应用的开发厂商。 缩略语 英文缩写 英文全称 说明 PDA Personal Digital Assistant 比如国产平板电脑 YJZH YING JI ZHI HUI XI TONG 医疗省突发公共卫生应急指挥系统 YJPDAPP the peer to peer protocol of peer ying ji zhi hui xitong 医疗省突发公共卫生应急指挥系统与PDA 接口协议 3功能流程概述 5. 协议栈 CMPP协议以TCP/IP作为底层通信承载，具体结构由图4所示： PDA YJZH 图4YJPDAPP协议栈 6. 通信方式 6.1短连接 通信双方以客户-服务器方式建立TCP连接，应答与请求在同一个连接中完成。系统采用客户/服务器模式，操作以客户端驱动方式发起连接请求，完成一次操作后关闭此连接。 消息发送后等待T秒后未收到响应，应立即重发，再连续发送N-1次后仍未得到响应则停发。现阶段建议取值为：T=60秒，N=3。 短连接的操作流程举例如图6所示： 图6 短连接的操作流程 6.2本协议中涉及的端口号 端口号 应用 9168 短连接（应急系统指挥与PDA之间） 6.3 交互过程中的应答方式 在应急系统指挥与PDA之间之间的交互过程中均采用异步方式，即收到请求消息后应立即回送响应消息。 7．消息定义 7.1基本数据类型 Unsigned Integer 无符号整数 Integer 整数，可为正整数、负整数或零 HexString 16进制字符串（中文采用UNICODE编码） String 正常字符串 7.2消息结构 项目 说明 Message Header 消息头(所有消息公共包头) Message Body 消息体，统一采用 属性长度+属性值格式 属性长度2个字节采用16进制表示 7.3 消息头格式（Message Header） 字段名 字节数 类型 描述 Total_Length 2 HexString 消息总长度(含消息头及消息体) Command_Id 1 Unsigned Integer 命令或响应类型（见附表1） Sequence_Id 2 HexString 消息流水号,顺序累加,步长为1,循环使用（一对请求和应答消息的流水号必须相同） 7.4 PDA登陆YJZH的消息定义 PDA是登陆请求的客户端，YJZH为服务端，登陆之后才可以进行数据传输。 7.4.1 PDA请求连接到YJZH操作 PDA 刚开机时，点击任何连接，都弹出登陆框，提出先登陆YJZH。 7.4.1.1登陆消息定义（PDA(YJZH） 字段名 属性 描述 Source_Addr Unsigned Integer 源地址 1 代表应急指挥系统 2 代表视频指挥中心 username String 字母和数字的组合 password String 字母和数字的组合，用MD5加密 Timestamp Unsigned Integer 时间戳的明文,由客户端产生,格式为MMDDHHMMSS，即月日时分秒，10位数字的整型，右对齐。 7.4.1.2登陆回馈消息定义（YJZH ( PDA） 字段名 属性 描述 Status Unsigned Integer 状态 0：正确 1：消息结构错 2：非法源地址 3：认证错 4：其他错误 Command_Type Unsigned Integer 0: 重新登陆 1： 填写不明原因肺炎病例调查表 2 ：填写现场调查 3：打开实时视频 JOBID String 任务ID Command_Type为0时，可为空） JOBNAME HexString 任务名称（Command_Type为