中国移动无线机器通信协议—M2M平台与应用系统接口分册V1.0.0

更新时间:2023-03-08 07:40:16 阅读量: 综合文库 文档下载

说明:文章内容仅供预览,部分内容可能不全。下载后的文档,内容与下面显示的完全一致。下载之前请确认下面内容是否您想要的,是否完整无缺。

中国移动通信企业标准

QB-D-101-2008

中 国移动无线机器通信协议—— M2M平台与应用系统接口分册

W

ireless Machine-to-Machine Protocol

Interface Specification for M2M Service P latform and Application Platform Part

09-1-21发布 20 版本号:1.0.0

2009-1-21实施

中国移动通信集团公司 发布

QB-D-101-2008

目 录

1. 范围.......................................................................................................................... 1 2. 规范性引用文件 ........................................................................................................ 1 3. 术语、定义和缩略语 ................................................................................................. 1 4. M2M系统概述 .......................................................................................................... 2

4.1. 4.1.1. 4.1.2. 4.2. 4.2.1. 4.2.2.

M2M系统结构 ............................................................................................ 2 M2M系统结构图 ........................................................................................ 2 网元功能描述.............................................................................................. 2 M2M应用模式 ............................................................................................ 3 管理流-业务流并行模式 .............................................................................. 4 管理流-业务流分离模式 .............................................................................. 5

5. WMMP协议概述 ...................................................................................................... 6 6. M2M平台与应用系统接口协议 ................................................................................. 8

6.1. 6.2. 6.3. 6.4. 6.4.1.

基本协议..................................................................................................... 8 接口描述..................................................................................................... 8 消息格式..................................................................................................... 8 消息安全性 ................................................................................................. 9 数据安全..................................................................................................... 9

6.4.2. 网络安全................................................................................................... 10 7. M2M平台与应用系统接口描述 ................................................................................11

7.1. 7.1.1. 7.1.2. 7.2. 7.2.1. 7.2.2. 7.3.

M2M平台提供给应用系统的接口(应用系统->M2M平台).......................11 应用对终端下行消息接口 ...........................................................................11 应用对M2M平台下行消息接口 ................................................................ 24 应用系统提供给M2M平台的接口(M2M平台->M2M应用系统) ............ 35 终端对应用上行消息接口 .......................................................................... 35 M2M平台对应用的上行消息接口 .............................................................. 56 WMMP协议应用扩展功能 ........................................................................ 60

8. 编制历史................................................................................................................. 60 附录A 终端序列号的定义..................................................................................... 61 附录B TLV说明 .................................................................................................. 62

(1) TAG配置参数相关内容 ............................................................................. 63

(2) (3) (4) (5) (6)

软件下载升级相关内容: .......................................................................... 65 终端统计相关内容: ................................................................................. 66 终端监控相关内容:注册信息、终端状态、终端告警等。 ......................... 71 控制参数相关内容: ................................................................................. 74 安全控制相关内容: ................................................................................... 1

附录C 68个行业分类及编码.......................................................................................... 1

I

QB-D-101-2008

前 言

本标准规定了M2M业务过程中涉及的M2M平台与接入M2M平台的应用系统的通信接口,是M2M业务所涉及M2M平台设备及M2M应用系统设备需要遵从的技术文件。

本标准主要包括网络结构、接口定义等方面的内容。

本标准是M2M业务系列标准之一,该系列标准的结构、名称或预计的名称如下:

序号 [1] [2] [3] [4] [5] [6] [7] [8]

标准编号 QB-D-108-2007

标准名称

中国移动M2M业务总体技术要求 中国移动M2M业务规范

中国移动M2M平台设备规范

中国移动M2M数据业务系统通用网管接口技术规范

M2M平台与行业应用移动终端监控平台接口规范

中国移动无线机器通信协议——M2M平台与终端接口分册

中国移动无线机器通信协议——M2M平台与应用系统接口分册

中国移动M2M终端规范——WMMP协议分册

QB-D-053-2006

QB-D-111-2007 QB-D-110-2007 QB-D-147-2007 QB-D-100-2008 QB-D-101-2008 QB-E-007-2008

本标准的附录A-B为标准性附录。 本标准由中移技〔2009〕26号印发。

本标准由中国移动通信集团公司技术部提出并归口。 本标准起草单位:中国移动通信有限公司研究院

本标准主要起草人:刘玮、肖青、王哲伟、董晓莉、朱暐、童小平、刘越、赵立君

II

QB-D-101-2008

1. 范围

本标准规定了M2M应用系统与M2M平台之间的接口及协议,供中国移动集团内部与合作厂商共同开发M2M应用业务使用;适用于指导M2M应用系统与M2M平台接口的实现和M2M业务的运营管理。

2. 规范性引用文件

下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本标准。

表2-1

[1] [2] [3] [4] [5] [6]

3. 术语、定义和缩略语

下列术语、定义和缩略语适用于本标准:

表3-1

M2M EC SI ADC

Machine To Machine Enterprise Customer Service Integrator

Application Data Center

QB-D-053-2006 《M2M业务规范V1.0》

QB-D-108-2007 QB-D-109-2007 QB-D-003-2005 QB-D-030-2005 QB-D-100-2008

中国移动通信有限公司

《M2M业务总体技术要求》 中国移动通信有限公司 《M2M平台与终端接口规范中国移动通信有限公司 V2.0.0》

《全网行业应用业务规范》 《全网行业应用接口规范》 《无线机器通信协议—M2M平台与终端接口分册》

中国移动通信有限公司 中国移动通信有限公司 中国移动通信有限公司

1

QB-D-101-2008

4. M2M系统概述

M2M是Machine-to-Machine/Man的简称,是一种以机器终端智能交互为核心的、网络化的应用与服务。它通过在机器内部嵌入无线通信模块,以无线通信等为接入手段,为客户提供综合的信息化解决方案,以满足客户对监控、指挥调度、数据采集和测量等方面的信息化需求。M2M根据其应用服务对象可以分为个人、家庭、行业三大类。 4.1. M2M系统结构

4.1.1. M2M系统结构图

M2M终端BOSSM2M系统行业终端网管系统监控平台用户个人及家庭用户SMSC短信网关M2M平台USSDCGGSN个人家庭行业M2M应用业务PORTAL/专线PORTAL中小企业企业代理服务器大型企业

图4.1 M2M业务系统结构图

4.1.2. 网元功能描述

M2M终端:M2M终端基于WMMP协议并具有以下功能:接收远程M2M平台激活指令、本地故障告警、数据通信、远程升级、数据统计以及端到端的通信交互功能。

M2M平台:为M2M应用服务的客户提供统一的M2M终端管理、终端设备鉴权,并对目前短信网关尚未实现的接入方式进行鉴权。支持多种网络接入方式,提供标准化的接口使得数据传输简单直接。提供数据路由、监控,用户鉴权、计费等管理功能。

M2M应用业务平台:为M2M应用服务客户提供各类M2M应用服务业务,由多个M2M应用业务平台构成,主要包括个人、家庭、行业三大类M2M应用业务平台。

短信网关:由行业应用网关或梦网网关组成,与短信中心等业务中心或业务网关连接,提供通信能力。负责短信等通信接续过程中的业务鉴权、设置黑白名单、EC/SI签约关系/黑白名单导入。行业网关产生短信等通信原始使用话单,送给BOSS计费。

2

QB-D-101-2008

USSDC:负责建立M2M终端与M2M平台的USSD通信。

GGSN:负责建立M2M终端与M2M平台的GPRS通信。提供数据路由、地址分配及必要的网间安全机制。

BOSS:与短信网关、M2M平台相连,完成客户管理、业务受理、计费结算和收费功能。对EC/SI提供的业务进行数据配置和管理,支持签约关系受理功能,支持通过HTTP/FTP接口与行业网关、M2M平台、EC/SI进行签约关系以及黑白名单等同步的功能。

行业终端监控平台:M2M平台提供FTP目录,将每月统计文件存放在FTP目录,供行业终端监控平台下载,以同步M2M平台的终端管理数据。

网管系统:网管系统与平台网络管理模块通信,完成配置管理,性能管理,故障管理,安全管理及系统自身管理等功能。 4.2. M2M应用模式

M2M应用分为管理流–业务流并行模式和管理流–业务流分离模式。管理流指承载M2M终端管理相关信息的数据流,业务流是指承载M2M应用相关的数据流。对于终端管理流,两种模式都由终端发送给M2M平台,或再由M2M平台转发给应用。对于业务流,在管理流–业务流并行模式下,业务流通过终端传递到M2M平台,再由M2M平台转发给M2M应用业务平台或者对端的M2M终端;在管理流–业务流分离模式下,业务流直接从终端送到M2M应用业务平台或者对端的M2M终端,不通过M2M平台转发。

3

QB-D-101-2008

4.2.1. 管理流-业务流并行模式

M2M终端M2M终端GSM业务数据管理数据M2M平台管理数据业务数据用户访问终端管理流M2M业务流企业网企业网M2M应用 图4.2 M2M管理流-业务流并行模式

业务数据从M2M终端传送到M2M平台,再由M2M平台转发给M2M应用业务平台或者对端的M2M终端。这种模式下,管理数据和业务数据均由M2M平台统一接收,再根据不同的消息类型和目标地址进行分发或处理。

4

QB-D-101-2008

4.2.2. 管理流-业务流分离模式

M2M终端M2M终端GSM业务数据管理数据M2M平台管理数据终端管理流M2M业务流业务数据用户访问企业网企业网企业应用 图4.3 M2M管理流业务流分离模式

业务数据不通过M2M平台,直接从M2M终端传送到M2M应用业务平台或者对端的M2M终端。管理数据发送到M2M平台,再根据目标地址进行转发或者处理。

5

QB-D-101-2008

5. WMMP协议概述

WMMP(Wireless M2M Protocol)协议是为实现M2M业务中M2M终端与M2M平台之间、M2M终端之间、M2M平台与M2M应用平台之间的数据通信过程而设计的应用层协议,其体系如图5.1所示。

M2M应用WMMP-A各种通信方式MPWMWMMPM2M平台WWMMP-T无线通信方式有线通信方式WMMPTP-MMM2M终端

M2M终端

图5.1 WMMP协议体系

WMMP协议由M2M平台与M2M终端接口协议(WMMP-T)和M2M平台与M2M应用接口协议(WMMP-A)两部分协议组成。WMMP-T协议完成M2M平台与M2M终端之间的数据通信,以及M2M终端之间借助M2M平台转发、路由所实现的端到端数据通信。WMMP-A协议完成M2M平台与M2M应用之间的数据通信,以及M2M终端与M2M应用之间借助M2M平台转发、路由所实现的端到端数据通信。

WMMP协议的功能构架如图5.2所示。WMMP协议的核心是其可扩展的协议栈及报文结构,而在其外层是由WMMP协议核心衍生的接入方式无关通信机制和安全机制。在此基础之上,由内向外依次为WMMP的M2M终端管理功能和WMMP的M2M应用扩展功能。

6

QB-D-101-2008

智能家居状态查询电力能源远程控制企业安防数据传输参数配置登录控制交通物流接入方式无关通信机制可扩展的协议栈及报文结构制造加工异常告警软件升级公共管理安全机制金融商业连接检查环境监测WMMPM2M终端管理功能

WMMPM2M应用扩展功能

图5.2 WMMP协议的功能架构

本规范着重描述的是WMMP协议核心构架以及其M2M终端管理功能,同时描述了通过扩展WMMP通用协议来实现WMMP协议的M2M应用扩展机制,具体的M2M应用WMMP协议则由补充的M2M应用规范对其进行规范。

7

QB-D-101-2008

6.

M2M平台与应用系统接口协议

本M2M平台与应用系统接口协议是WMMP协议的一部分(WMMP-A),它对M2M平台与终端的接口规范进行了封装,对应用系统提供了对M2M终端进行监控管理的能力。同时,通过本协议,M2M终端与M2M应用之间可以通过M2M平台传递业务流程,实现定制化的M2M应用。

6.1. 基本协议

双方的消息交互采用SOAP(Simple Object Access Protocol,简单对象访问协议)接口。这是一个可以运行在任何传输协议上的轻量级协议,它包含三个方面:XML-envelop为描述信息内容和如何处理内容定义了框架;将程序对象编码成为XML对象的规则;执行远程调用(RPC,Remote Procedure Call)的约定。

6.2. 接口描述

本协议支持两种连接方式:

1. 基于HTTP的标准WEB Service方式。应用系统和M2M平台采用WSDL(Web Services

Description Language)来对接口进行描述。WSDL是用来定义Web服务的属性以及

如何调用它的一种XML语言。一个完整的WSDL服务描述是由一个服务接口和一个服务实现文档组成的。通过查阅Web服务的WSDL文档,开发者可以知道Web提供了哪些方法和如何用正确的参数调用他们。因为WSDL包含了对服务接口的完整描述,所以我们可以使用它来创建能简化服务访问的存根,该存根为一段Java代码(假设使用Java),它自动生成了访问Web服务的类。如果我们需要访问Web服务,只需调用该类中对应的方法即可,而不用在客户端程序中再写入配置信息。

要求通信双方作为WEB Service服务端时,应实现HTTP会话的超时机制。即一定时间内,如果客户端没有新的HTTP请求,则服务端主动断开连接。会话维持的时间要求可配置。

2. 长连接。应用系统可以选择采用长连接和M2M平台交互,以提高效率。消息格式的

定义和WEB Service方式一致。 6.3. 消息格式

所有的协议数据单元PDU由如下表的消息头和消息体组成:

PDU组成 Message Header Message BODY Message HASH 消息头 消息体 消息摘要,计算方法为: 8

描述 QB-D-101-2008

MD5(消息头+3DES(消息体)+用户名+密码)

消息头和消息体在xml中的表现形式如下: 消息头属性一 消息头属性二 消息头属性三 加密后的消息体 消息摘要

未加密的消息体也是一个完整的xml文件,如下例所示: 消息体属性一 消息体属性二 消息体属性三 消息摘要

本规范报文为文本格式,对于二进制内容,应进行BASE64编码。 加密后的消息体通过BASE64编码放入BODY标签。 6.4. 消息安全性

6.4.1. 数据安全

本规范采用3DES算法对数据进行加密。M2M平台与应用之间的交互消息均要求携带摘要字段,算法如下:

MD5(消息头+3DES(消息体)+用户名+密码)。

其中用户名和密码由M2M平台为应用分配,应用发往M2M平台的消息以及M2M平台发往应用的消息,均要求用上述算法计算摘要。

应用系统和M2M平台的交互包含两种密钥:

1. 基础密钥,不同的M2M应用系统由M2M平台分配不同的基础密钥;M2M平台负责统一

分配和保存所有M2M应用系统密钥。M2M应用系统的密钥通过Email的方式由M2M平台发送给各M2M应用系统。

9

QB-D-101-2008

2. 会话密钥,应用系统与M2M平台的每次会话均有M2M平台分配会话密钥。一次会话

只允许持续一定的时间,如果超出该时间,应用系统必须重新登录,分配新的会话密钥。否则M2M平台将拒绝应用系统的消息。

基础密钥用于应用向平台登录启动新会话时加密消息体,以及M2M平台返回会话密钥时用于加密消息体。应用系统需要先向M2M平台登录,登录消息包含M2M平台分配的用户名和密码,并用基础密钥加密(3DES算法)。M2M平台为本次会话分配会话密钥,并用基础密钥加密后返回给应用系统。然后在会话中,双方用会话密钥加密和解密消息体。

消息交互流程如下:

M2M平台TAppLoginReqTAppLoginRsp数据包1数据包1响应应用系统??数据包n数据包n响应 应用系统首先通过TAppLoginReq向M2M平台进行登录,由M2M平台分配并返回会话密钥。在后续的消息交互的数据包中,双方通过会话密钥加密消息体。 6.4.2. 网络安全

M2M平台接口采用如下的手段保证和M2M应用系统之间通信的网络安全:IP鉴权及业务ID控制列表。

1. M2M应用系统接入M2M平台时需提供其业务系统出访IP和URL(根据其业务特性确

定);

2. M2M平台为M2M应用系统的每一个业务分配一个全局唯一的业务ID;

3. M2M平台侧防火墙配置安全策略,只有有效的IP和业务ID才能够访问M2M平台; 4. M2M应用系统端配置相应策略,以拒绝非M2M平台的接口调用; 5. 建议M2M应用系统和M2M平台之间采用VPN通道。

10

QB-D-101-2008

7. M2M平台与应用系统接口描述

7.1. M2M平台提供给应用系统的接口(应用系统->M2M平台)

7.1.1. 应用对终端下行消息接口

7.1.1.1. T_TERMINFO_GET请求终端信息接口

应用通过本接口读取M2M终端的相应配置信息、统计信息、监控信息。该接口为异步接口,应用向M2M平台发出请求后,M2M平台的应答只表示收到该请求。终端通过T_TERMINFO_GET_RESULT消息向应用上报应用所请求的终端信息。

调用名称:TTermInfoGet

TTermInfoGetReq请求终端信息消息: 参数标识 消息格式 TTermInfoGetReq 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP SERVICEID 消息体格式 说明 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 终端序列号 ?? 终端型号 终端厂家 11

数据类型 String String String 长度(字节) 16 18 16 QB-D-101-2008

终端安装的地区 ?? ?? ?? 名称 TERMLIST 说明 需要操作的终端序列号列表。该标签和FILTER标签互斥。 过滤条件,即需要进行操作的终端的选择条件。该标签和TERMLIST互斥。FILTER包含如下几个子元素: TERMIDRANGE:终端序列号的起始号段,FILTER 包含开始和终止号码两个子元素; MODEL:终端型号编码; PRODUCTOR:终端厂家代码; REGISTDATE:终端上线注册的日期范围; AREA:安装终端的地区。采用电话区号。 需要采集的终端监控内容,为4位16进制字MONITOR 符串(附录A(4)终端监控相关内容),可重复使用。 要求采集的故障信息,固定值为300D。在请求消息中最多出现一次。 需要采集的配置信息,为4位16进制字符串CONFIG (参见附录A:(1)配置参数相关内容),可重复使用 需要采集的统计数据,为4位16进制字符串(参见附录A:(3)终端统计相关内容),可重复使用。

12

数据类型 String 长度(字节) 不定长 String 不定长 String 4 ALRAM String 4 String 4 STATISTIC String 4

QB-D-101-2008

TTermInfoGetRsp请求终端信息响应消息 参数标识 消息格式 TTermInfoGetRsp 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP SERVICEID 消息体格式 说明 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 返回结果代码 名称 说明 返回结果代码。 RESULTCODE 0——M2M平台接受请求 1——M2M平台拒绝请求 2——该应用未登录 其他:失败,原因待定。

String 2 数据类型 长度(字节) 数据类型 String String String 长度(字节) 16 18 16 7.1.1.2. T_TERM_CTRL远程控制接口

应用通过本接口对终端发送控制指令,控制终端重启、复位等操作。该接口为异步接口,应用向M2M平台发出请求后,M2M平台的应答只表示收到该请求。M2M平台接收到该消息之后,将其转换成WMMP-T协议的REMOTE_CTRL发送给M2M终端,M2M终端响应该控制消息后,M2M平台通过T_TERM_CTRL_RESULT接口转发给应用。

调用名称:TTermCtrl

TTermCtrlReq远程控制请求消息: 参数标识 消息格式 TTermCtrlReq 13

QB-D-101-2008

消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP SERVICEID 消息体格式 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 终端序列号 ?? 终端型号 终端厂家 终端安装的地区 ?? 强制终端登出的原因 名称 TERMLIST 说明 需要操作的终端序列号列表。该标签和FILTER标签互斥。 过滤条件,即需要进行操作的终端的选择条件。该标签和TERMLIST互斥。FILTER包含如下几个子元素: FILTER TERMIDRANGE:终端序列号的起始号段,包含开始和终止号码两个子元素; MODEL:终端型号编码; PRODUCTOR:终端厂家代码; 14

说明 数据类型 String String String 长度(字节) 16 18 16 数据类型 String 长度(字节) 不定长 String 不定长 QB-D-101-2008

REGISTDATE:终端上线注册的日期范围; AREA:安装终端的地区。采用电话区号。 远程控制指令TAG,为4位16进制REMOTECTRL 字符串(参见附录A(5)下行控制相关内容)。可重复使用。REMOTECTRL与LOGOUT指令互斥,在本消息中只能出现一个。 0:正常退出,进入等待激活模式; 1:准备升级;(此项一般由M2M终端发起) 2:故障断开; 3:应用新配置;(此项一般由LOGOUT M2M终端发起); 4:心跳超时; 5:故障退出,进入等待激活模式 其他:保留。 LOGOUT指令与REMOTECTRL指令互斥,在本消息中只能出现一个。

TTermCtrlRsp远程控制响应消息 参数标识 消息格式 TTermCtrlRsp 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP SERVICEID 消息体格式 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 返回结果代码 无效远程控制指令TAG 15

String 4 String 2

名称 说明 返回结果代码。 0——M2M平台接受请求 1——M2M平台拒绝请求 2——该应用未登录 其他:失败,原因待定。

数据类型 长度(字节) RESULTCODE String 2 7.1.1.3. T_CONFIG_SET参数设置接口

应用通过本接口发送指令设置M2M终端的某些参数。该接口为异步接口,应用向M2M平台发出请求后,M2M平台的应答只表示收到该请求。终端响应该参数设置请求后,M2M平台通过CONFIG_SET_RESULT接口向应用转发终端处理结果。

调用名称:TConfigSet

TConfigSetReq 参数设置请求消息 参数标识 消息格式 TConfigSetReq 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP SERVICEID 消息体格式 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 终端序列号 ?? 终端型号 终端厂家 16

说明 数据类型 String String String 长度(字节) 16 18 16 QB-D-101-2008

终端安装的地区 配置项的值 ?? 名称 TERMLIST 说明 需要操作的终端序列号列表。该标签和FILTER标签互斥。 过滤条件,即需要进行操作的终端的选择条件。该标签和TERMLIST互斥。FILTER包含如下几个子元素: TERMIDRANGE:终端序列号的起始号段,包含开始和终止号码两个FILTER 子元素; MODEL:终端型号编码; PRODUCTOR:终端厂家代码; REGISTDATE:终端上线注册的日期范围; AREA:安装终端的地区。采用电话区号。 应用向终端设置的配置数据(参见CONFIG 附录A:(1)配置参数相关内容),可重复使用 String 4 VALUE长度与配置数据TAG有关 String 不定长 数据类型 String 长度(字节) 不定长

TConfigSetRsp 参数设置响应消息: 参数标识 消息格式 TConfigSetRsp 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 说明 数据类型 String String 长度(字节) 16 18 17

QB-D-101-2008

SERVICEID 消息体格式 业务应用标识 未加密的消息体格式 返回结果代码 名称 说明 返回结果代码。 RESULTCODE 0——M2M平台接受请求 1——M2M平台拒绝请求 2——该应用未登录 其他:失败,原因待定。

String 2 数据类型 长度(字节) String 16 7.1.1.4. T_TRANSPARENT_DATA_DOWN发送应用数据接口

应用和终端之间可以通过本接口进行双向的透明数据传输。企业应用服务器可以通过本接口将数据发送至M2M终端(必要的话,M2M终端再转发给它连接的下端设备)。

调用名称:TTransparentDataDown

TTransparentDataDownReq 发送应用数据请求消息 参数标识 消息格式 TTransparentDataDownReq 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP SERVICEID 消息体格式 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 终端序列号 ?? 18

说明 数据类型 String String String 长度(字节) 16 18 16 QB-D-101-2008

终端型号 终端厂家 终端安装的地区 应用数据 名称 TERMLIST 说明 需要操作的终端序列号列表。该标签和FILTER标签互斥。 过滤条件,即需要进行操作的终端的选择条件。该标签和TERMLIST互斥。FILTER包含如下几个子元素: TERMIDRANGE:终端序列号的起始号段,包含开始和终止号码两个FILTER 子元素; MODEL:终端型号编码; PRODUCTOR:终端厂家代码; REGISTDATE:终端上线注册的日期范围; AREA:安装终端的地区。采用电话区号。 应用向终端发送的应用数据。如果DATA 应用需要发送二进制数据,可以采用BASE64编码。

TTransparentDataDownRsp应用数据响应消息: 参数标识 消息格式 TTransparentDataDownRsp 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP 说明 消息流水号 系统时间戳,格式为 数据类型 String String 长度(字节) 16 18 19

数据类型 String 长度(字节) 不定长 String 不定长 String 不限

YYYYMMDDHHmmssnnnn SERVICEID 消息体格式 业务应用标识 未加密的消息体格式 返回结果代码 名称 说明 返回结果代码。 0——M2M平台接受请求 1——M2M平台拒绝请求 2——该应用未登录 其他:失败,原因待定。

7.1.1.5. T_DOWNLOAD应用发起下载更新通知接口

应用通过本接口向终端发送下载更新通知。该接口为异步接口,应用向M2M平台发出请求后,M2M平台的应答只表示收到该请求。终端响应该通知消息后,M2M通过T_DOWNLOAD_RESULT接口转发给应用。

调用名称:TDownloadNotify

TDownloadNotifyReq 下载更新通知请求消息 参数标识 消息格式 TDownloadNotifyReq 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP SERVICEID 消息体格式 说明 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 终端序列号 ?? 20

String 16 数据类型 长度(字节) RESULTCODE String 2 数据类型 String String String 长度(字节) 16 18 16 QB-D-101-2008

终端型号 终端厂家 终端安装的地区 下载地址 名称 TERMLIST 说明 需要操作的终端序列号列表。该标签和FILTER标签互斥。 过滤条件,即需要进行操作的终端的选择条件。该标签和TERMLIST互斥。FILTER包含如下几个子元素: TERMIDRANGE:终端序列号的FILTER 起始号段,包含开始和终止号码两个子元素; MODEL:终端型号编码; PRODUCTOR:终端厂家代码; REGISTDATE:终端上线注册的日期范围; AREA:安装终端的地区。采用电话区号。 DOWNLOADURL 下载地址 String 1024

TDownloadNotifyRsp 下载更新响应消息: 参数标识 消息格式 TDownloadNotifyRsp 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP 说明 消息流水号 系统时间戳,格式为 数据类型 String String 长度(字节) 16 18 21

数据类型 String 长度(字节) 不定长 String 不定长

YYYYMMDDHHmmssnnnn SERVICEID 消息体格式 业务应用标识 未加密的消息体格式 返回结果代码 名称 说明 返回结果代码。 0——M2M平台接受请求 1——M2M平台拒绝请求 2——该应用未登录 其他:失败,原因待定。

7.1.1.6. T_SECURITY_CONFIG应用发起终端安全参数配置接口

应用通过本接口向终端发送终端安全参数配置。该接口为异步接口,应用向M2M平台发出请求后,M2M平台的应答只表示收到该请求。终端响应该通知消息后,M2M通过T_SECURITY_CONFIG_RESULT接口转发给应用。

调用名称:TSecurityConfig

TSecurityConfigReq 应用发起终端安全参数配置的请求消息 参数标识 消息格式 TSecurityConfigReq 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP SERVICEID 消息体格式 说明 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 终端序列号 对终端的操作 22

String 16 数据类型 长度(字节) RESULTCODE String 2 数据类型 String String String 长度(字节) 16 18 16

QB-D-101-2008

安全项配置的值 ?? (SECURITY_CONFIG报文+接入密码)的摘要值 名称 TERMID 说明 需要操作的终端的序列号 0x00——平台以明文设置终端安全参数(M2M平台只能通过短信方式下发) 0x01——平台以密文设置终端安全参数(任何通信方式) OPERATION 0x02——平台读取终端安全参数 0x03——平台下发安全参数更新通知,要求终端进入短信模式,准备接收明文安全参数 0x04——终端上报安全参数 0x05——终端请求以明文更新安全参数 0x06——终端请求以密文更新安全参数 0x07——终端启用各类安全参数 可选安全相关参数(参见附录A(6),安全控制相关内容): OPERATION=0x00 OPERATION=0x01 OPERATION=0x02 SECURITY OPERATION=0x03 OPERATION=0x04 OPERATION=0x05/0x06 OPERATION=0x07 上报的安全参数为表示密码或密钥值的安全摘要、启用标识、有效期的TLV 请求的安全参数为表示密码或密钥值、启用标识、有效期的TLV,其中L=0 启用的安全参数的启用标识的TLV 读取的安全参数为表示密码或密钥值的摘要、启用标识、有效期的TLV,其中L=0 要更新的安全参数的TLV 设置的安全参数为表示密码或密钥值、启用标识、有效期的TLV 经过加密的安全参数 Intiger 3 数据类型 String 长度(字节) 16 String 不定长 23

QB-D-101-2008

TAG id=E021: (SECURITY_CONFIG报文+接入密码)的摘要值: MD5(SECURITY_CONFIG报文+上行接入密码) String 16

TSecurityConfigRsp M2M平台对应用发起终端安全参数配置请求的应答: 参数标识 消息格式 TSecurityConfigRsp 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP SERVICEID 消息体格式 说明 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 返回结果代码 名称 说明 返回结果代码。 0——M2M平台接受请求 RESULTCODE 1——M2M平台拒绝请求 2——该应用未登录 其他:失败,原因待定。

String 2 数据类型 长度(字节) 数据类型 String String String 长度(字节) 16 18 16 7.1.2. 应用对M2M平台下行消息接口

7.1.2.1. P_APP_LOGIN应用向M2M平台注册接口

应用需要连接M2M平台时,必须通过本接口向M2M平台注册。

调用名称:TAppLogin

24

QB-D-101-2008

TAppLoginReq 应用系统向M2M平台发起的注册接口 参数标识 消息格式 TAppLoginReq 消息流水号 时间戳 业务应用标识 消息体为空 消息摘要 名称 SID TIMESTAMP SERVICEID 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 说明 数据类型 String String String 长度(字节) 16 18 16

TAppLoginRsp M2M平台对应用注册请求的应答信息: 参数标识 消息格式 TAppLoginRsp 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP SERVICEID 消息体格式 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 返回结果代码 会话密钥 会话有效期 名称 RESULTCODE 返回注册结果 说明 数据类型 String 长度(字节) 2 说明 数据类型 String String String 长度(字节) 16 18 16

QB-D-101-2008

0:注册成功 1:无该用户名 2:密码和用户名不匹配 3:加密的消息体错误 其他:保留。 CONVKEY EXPIRATION

7.1.2.2. P_APP_LOGOUT应用向M2M平台注销接口

应用需要退出M2M平台时,必须通过本接口登出M2M平台。

调用名称:TAppLogout

TAppLogoutReq 应用系统向M2M平台发起的退出登录接口 参数标识 消息格式 TAppLogoutReq 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP SERVICEID 消息体格式 说明 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 用户名 密码 名称 USERNAME PASSWORD 说明 应用系统登录M2M平台的用户名 应用系统登录M2M平台的密码 数据类型 String String 长度(字节) 12 12 数据类型 String String String 长度(字节) 16 18 16 本次会话密钥 本次会话有效期(单位分钟),采用相对时间。 String 整形 16 4

TAppLogoutRsp M2M平台对应用注册请求的应答信息: 参数标识 TAppLogoutRsp 26

QB-D-101-2008

消息格式 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP SERVICEID 消息体格式 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 返回结果代码 说明 返回注册结果 0:退出成功 2:无该用户名 3:密码和用户名不匹配 4:加密的消息体错误 其他:保留。

7.1.2.3. P_TERMINFO_QUERY查询终端信息接口

应用通过本接口,从M2M平台的数据库中查询M2M终端的相应配置信息、统计信息、监控信息。该接口为同步接口,应用向M2M平台发出请求后,M2M平台从数据库记录中查询被请求终端的信息,然后返回给应用。

调用名称:PTermInfoQuery

PTermInfoQueryReq请求终端信息消息: 参数标识 消息格式 PTermInfoQueryReq 消息流水号 时间戳 业务应用标识 27

说明 数据类型 String String String 长度(字节) 16 18 16 名称 数据类型 长度(字节) RESULTCODE String 2

QB-D-101-2008

加密后的消息体 消息摘要 名称 SID TIMESTAMP SERVICEID 消息体格式 说明 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 终端序列号 ?? ?? ?? 名称 TERMID MONITOR 终端序列号 需要采集的终端监控内容,为4位16进制字符串(附录A(4)终端监控相关内容),可重复使用。 ALRAM 要求采集的故障信息,固定值为300D。在请求消息中最多出现一次。 需要采集的配置信息,为4位16进制字符串(参见附录A:(1)配置参数相关内容),可重复使用 需要采集的统计数据,为4位16进制字符串STATISTIC (参见附录A:(3)终端统计相关内容),可重复使用。

PTermInfoQueryRsp请求终端信息响应消息

String 4 String 4 说明 数据类型 String String 长度(字节) 16 4 数据类型 String String String 长度(字节) 16 18 16 CONFIG String 4 28

QB-D-101-2008

参数标识 消息格式 PTermInfoQueryRsp 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP SERVICEID 消息体格式 说明 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 终端序列号 终端监控数据 ?? 故障代码1 ?? 已恢复的故障代码1 已恢复的故障代码2 ?? 配置项的值 ?? 统计值 ?? 名称 TERMID MONITOR 说明 终端序列号 终端返回的终端监控数据TAG,包含数据类型 String String 长度(字节) 16 4 29

数据类型 String String String 长度(字节) 16 18 16 QB-D-101-2008

一个VALUE子节点,为该TAG的值。(附录A(4)终端监控相关内容)。消息中可重复使用MONITOR。 ALARM 终端返回故障代码列表(参见附录A(4)终端监控相关内容,0x300D(报警代码))。 终端返回已恢复的故障代码列表(参RECOVERY 见附录A(4)终端监控相关内容,0x300D(报警代码))。 终端返回的配置数据(参见附录A:(1)配置参数相关内容),可重复使用 终端返回的统计数据(参见附录A:(3)终端统计相关内容),可重复使用 String String VALUE长度与监控数据TAG有关 CODE值的长度为4 CODE值的长度为4 4 VALUE长度与配置数据TAG有关 4 VALUE长度与配置数据TAG有关 CONFIG String STATISTIC String

7.1.2.4. P_STATISTIC_QUERY查询统计信息接口

应用通过本接口,从M2M平台的数据库中查询统计数据。该接口为同步接口,应用向M2M平台发出请求后,M2M平台从数据库记录中查询被请求终端的信息,然后返回给应用。

调用名称:PStatisticQuery

PStatisticQueryReq请求终端信息消息: 参数标识 消息格式 PStatisticQueryReq 消息流水号 时间戳 业务应用标识 消息摘要 加密后的消息体 名称 SID TIMESTAMP SERVICEID 说明 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 30

数据类型 String String String 长度(字节) 16 18 16 QB-D-101-2008

消息体格式 终端厂家 地区编码 查询的日期 查询的月份 终端厂家 地区 终端型号 故障代码 查询的日期 查询的月份 终端厂家 地区 终端型号 终端序列号 名称 说明 终端数量统计数据查询,可返回产生业务终端数量、已注册终端数量、当日新增终端数量。 TERMCOUNT包含如下几个子元素: PRODUCER:终端厂家 AREA:终端所在的区域 DATE:查询的日期,如果使用该元素,则M2M平台返回该天的统计量; MONTH:查询的月份,如果使用该元素,则M2M平台返回该月的统计量; 以上子元素作为查询的组合过滤条件,调用方可选择使用这些子元素。 查询终端上报的故障情况。TERMFAULT包含如下几个子元素: PRODUCER:终端厂家 AREA:终端所在的区域 TERMFAULT TERMMODEL:终端型号 ERRCODE:故障代码 DATE:查询的日期,如果使用该元素,则M2M平台返回该天的统计量; MONTH:查询的月份,如果使用该元素,31

数据类型 长度(字节) TERMCOUNT String 不定长 String 不定长 QB-D-101-2008

则M2M平台返回该月的统计量; 以上子元素作为查询的组合过滤条件,调用方可选择使用这些子元素。 对终端状态进行统计。TERMSTATUS包含如下几个子元素: PRODUCER:终端厂家 AREA:终端所在地区 TERMMODEL:终端型号 TS:终端序列号 以上子元素作为查询的组合过滤条件,调用方可选择使用这些子元素。

PStatisticQueryRsp请求终端信息响应消息 参数标识 PStatisticQueryRsp 消息格式 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP SERVICEID 消息体格式 说明 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 产生业务的终端数量 已注册的终端数量 当日新增终端数量 当月新增终端数量 累计终端数量 当日产生终端数量 当月产生终端数量 故障终端总数 32

TERMSTATUS String 4 数据类型 String String String 长度(字节) 16 18 16

QB-D-101-2008

状态正常终端数量 状态异常终端数量 已禁用的终端数量 名称 说明 根据请求的查询条件得到的终端统计数量。TERMCOUNT_RESULT包含以下几个子元素: TERMCOUNT_RESULT WORKING:产生业务的终端数量 REGISTED:已注册的终端数量DATENEW:当日新增终端数量 MONTHNEW:当月新增终端数量 TOTAL:累计终端数量 根据请求的查询条件得到的故障终端数量。TERMFAULT_RESULT包含如下几个子元素: TERMFAULT_RESULT DATENUM:查询日期当日产生故障的终端数量 MONTHNUM:查询月份当月产生终端数量 TOTAL:故障终端总数 根据请求的查询条件得到的不同状态的终端数量。 TERMSTATUS_RESULT包含如下TERMSTATUS_RESULT 几个子元素: NORMAL:状态正常终端数量 EXCEPTION:状态异常终端数量 FORBIDDEN:已禁用的终端数量

String 不定长 String 不定长 String 不定长 数据类型 长度(字节) 7.1.2.5. P_TERM_STATISTIC_QUERY查询终端统计信息接口

应用通过本接口,从M2M平台的数据库中查询单个终端的统计数据。该接口为同步接口,应用向M2M平台发出请求后,M2M平台从数据库记录中查询被请求终端的信息,然后返回给应用。

调用名称:PTermStatisticQuery

PTermStatisticQueryReq请求终端信息消息: 参数标识 消息格式 PTermStatisticQueryReq 33

QB-D-101-2008

消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP SERVICEID 消息体格式 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 终端序列号 名称 TERMID DATERANGE 终端序列号 统计时间段。该元素有两个属性: (1) start:统计起始时间; (2) end:统计终止时间 ALARMCOUNT 终端发生的告警次数 LOGINCOUNT LASTLOGIN 终端登录次数 终端最后一次登录时间 0 0 0 说明 数据类型 String 长度(字节) 16 0 说明 数据类型 String String String 长度(字节) 16 18 16

PTermStatisticQueryRsp请求终端信息响应消息 参数标识 消息格式 PTermStatisticQueryRsp 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID 说明 消息流水号 数据类型 String 长度(字节) 16 34

QB-D-101-2008

TIMESTAMP SERVICEID 消息体格式 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 终端序列号 终端告警次数 终端登录次数 最后一次登录时间 名称 TERMID ALARMCOUNT LOGINCOUNT LASTLOGIN

7.2. 应用系统提供给M2M平台的接口(M2M平台->M2M应用系统)

终端序列号 终端发生的告警次数 终端登录次数 终端最后一次登录时间 说明 数据类型 String 整数 整数 整数 长度(字节) 16 4 4 4 String String 18 16 7.2.1. 终端对应用上行消息接口

7.2.1.1. T_REGIST终端注册通知接口

终端向M2M平台注册成功后,M2M平台根据终端的订购关系,向为该终端提供业务的应用系统发送终端注册通知消息。

调用名称:TRegist

TRegistReq 应用系统接收M2M平台转发的终端注册请求

参数标识 消息格式 TRegistReq 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID 消息流水号 说明 数据类型 String 长度(字节) 16 35

QB-D-101-2008

TIMESTAMP SERVICEID 消息体格式 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 终端序列号 终端的IMEI号 终端的IMSI号 名称 TERMID IMEI IMSI 说明 终端序列号(即终端注册后,平台为其分配的序列号,或终端预置的合法序列号) 终端的IMEI号。长度16字节或15字节 终端的IMSI号 String String String 16 16或15 15 数据类型 长度(字节) String String 18 16

TRegistRsp终端注册应答信息: 参数标识 消息格式 TRegistRsp 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP SERVICEID 消息体格式 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 返回结果代码 名称 返回注册结果 0:注册成功 RESULTCODE 1:登录成功,但需要下发配置 2:应用拒绝该终端的注册 其他:保留。 String 2 说明 数据类型 长度(字节) 说明 数据类型 String String String 长度(字节) 16 18 16 36

QB-D-101-2008

7.2.1.2. T_LOGIN终端向应用系统登录

当终端在M2M平台注册成功,并登录到M2M平台时,M2M平台根据终端的订购关系,向相应的应用系统发送该终端的登录信息。

调用名称:TLogin

TLoginReq 应用系统接收M2M平台转发的终端登录请求 参数标识 消息格式 TLoginReq 消息流水号 时间戳 业务应用标识 加密后的消息体 消息摘要 名称 SID TIMESTAMP SERVICEID 消息体格式 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式 终端序列号 终端的IMEI号 终端的IMSI号 终端版本号 终端配置参数的CRC32校验 参数值1 参数值2 ?? 名称 TERMID IMEI IMSI TERMVER CONFIGCRC 终端序列号 终端的IMEI号。长度16字节或15字节 终端的IMSI号 终端版本号 终端全部配置信息CRC32校验和:校验值为终端所有配置参数,如37

说明 数据类型 String String String 长度(字节) 16 18 16 说明 数据类型 String String String String String 长度(字节) 16 16或15 15 8 8

本文来源:https://www.bwwdw.com/article/cog3.html

Top