WMMP协议终端开发说明V1.0.docVIP

WMMP协议终端开发说明V1.0 1. WMMP协议概述 本协议为实现行业终端与M2M平台数据通信过程而设计。协议建立在UDP协议之上,如下图所示。 由于GPRS网络带宽较窄，延迟较大，不适于采用TCP协议进行通信。而采用UDP协议无连接方式传输，其优点是效率高，流量小，节省网络带宽资源。缺点是没有确认机制，有可能引起丢包，根据实际经验发现，采用UDP方式传输，丢包率能控制在1%以下，通过在UDP的上层应用层协议实现类似TCP的包确认和重传机制，从而提高通信效率及可靠性。 本协议使用的端口暂定为 9991，数据包以同步方式交互，每一个数据包必须有一个响应。 2.2短连接 行业终端平时处于下线，当本地由于数据需要传输或达到定时上线时间等类似策略时，行业终端作为客户端以客户-服务器方式建立WMMP过程，传送数据完成后，结束该过程。 通信消息发送后等待T秒后未收到响应，应立即重发，再连续发送N-1 次后仍未得到响应则停发。现阶段建议取值为：T=15 秒，N=3。 尽管是短连接，为了M2M平台对终端的监控和管理，终端仍然需要通过短信向平台发送心跳包。短连接的操作流程与长连接一致，唯一的区别在于平台并非通过心跳包来判断终端链路的存在，而是判断终端是否处于工作状态。 3. WMMP协议命令说明 消息类型 Command_id 说明 LOGIN 0x0001 登录包 LOGIN_ACK 0x001 平台向终端发送的连接登录响应包 LOGOUT 0x000断开连接包 LOGOUT_ACK 0x800断开连接响应包 HEART_BEAT 0x000维持过程连接包 HEART_BEAT_ACK 0x800维持过程连接回应包 0x0004 可以双向传输的透明数据包 TRANSPARENT_DATA_ACK 0x8004 对可以双向传输的透明数据包的响应 CONFIG_GET 0x0005 平台向终端发送的读取行业终端的配置信息 CONFIG_GET_ACK 0x8005 终端向平台发送的响应包，上报配置信息 CONFIG_SET 0x000设置 CONFIG_SET_ACK 0x8006 终端向平台发送的设置 CONFIG_TRAP 0x0007 行业终端向M2M平台上报的TRAP信息，包括告警信息。 CONFIG_TRAP_ACK 0x8007 M2M平台对行业终端上报的响应 CONFIG_REQ 0x000A 终端向平台发起请求配置参数 CONFIG_REQ_ACK 0x800平台向终端发送的请求配置参数的响应包 REMOTE_CTRL 0x00平台向终端发送的远程控制包 REMOTE_CTRL_ACK 0x00终端向平台发送的远程控制响应包 PL_DOWNLOAD 0x00平台发起下载更新通知 PL_DOWNLOAD_ACK 0x80终端对平台发起下载更新通知的响应 字段 长度(字节) 备注 2 消息类型代码2 Command ID 流水号 报文协议版本 保留字 2 取值始终为0 终端序列号 16 3．2 终端注册（LOGIN） 注册流程：（终端平台分配序列号模式使用，预制序列号的终端直接登录） 终端发送注册包时，包头中的终端序列号后8位必须为‘0’。 终端注册成功后，必须保存终端序列号和注册成功状态。 下次终端重新启动或者换卡重新启动后，读取终端保存的注册状态和终端序列号，注册状态是注册成功时，终端直接登录。 LOGIN 字段名 字节数 描述 IMEI 16 定长字段，16字节，对于15字节的IMEI号，则后面补0。 IMSI 15 IMSI号码 字段 长度(字节) 消息头 报文总长度 2 0x003B 消息类型代码2 0x0001 流水号0 报文协议版本 0x0101 保留字 2 0x0000 终端序列号 16 ‘’ 包体 IMEI 16 9012345’ IMSI 15 ‘460001369435781’ LOGIN_ACK 字段名 字节数 描述 定长字段部分 Status 返回注册结果0：成功1：非法终端序列号； ：通信协议版本不兼容；其他：保留。 16 平台分配/记录的终端序列号 例如： 字段 长度(字节) 消息头 报文总长度 2 0x002d 消息类型代码2 0x8001 流水号0 报文协议版本 0x0101 保留字 2 0x0000 终端序列号 16 ‘’ 包体 Status 1 Ox00 终端序列号 16 ‘A0010001 3．3 终端登录（LOGIN） 终端发送登录包时，包头中的终端序