物联网运营管理平台和业务网关接口规范.docx
《物联网运营管理平台和业务网关接口规范.docx》由会员分享，可在线阅读，更多相关《物联网运营管理平台和业务网关接口规范.docx（85页珍藏版）》请在冰点文库上搜索。
物联网运营管理平台和业务网关接口规范
物联网运营管理平台和业务网关接口规范
中国移动通信企业标准
版本号：
1.0.0
前言
本标准规定了物联网运营治理平台与物联网业务网关之间的技术接口。
本标准要紧包括以下几方面内容：
基础通信类接口、终端治理接口、治理信息同步接口等。
本标准是物联网业务系列标准之一，该系列标准的结构、名称或估量的名称如下：
序号
标准编号
标准名称
[1]
QB-D-174-2020
«中国移动物联网技术体制»
[2]
QB-E-015-2020
«中国移动物联网机器卡业务规范»
[3]
QB-D-077-2020
«中国移动物联通业务规范»
[4]
«中国移动物联网PBOSS业务技术规范»
[5]
QB-E-020-2020
«中国移动M2M模组规范»
[6]
QB-E-007-2020
«中国移动M2M（U）SIM卡设备规范»
[7]
QB-C-011-2020
«中国移动短消息中心设备规范»
[8]
QB-D-175-2020
«中国移动物联网运营治理平台设备规范»
[9]
QB-D-176-2020
«中国移动物联网业务网关设备规范»
[10]
«物联网HLR与全网物联网运营治理平台接口规范»
[11]
«中国移动物联网PBOSS与HLR接口规范»
[12]
QB-D-177-2020
«物联网运营治理平台和物联网业务网关接口规范»
[13]
«无线机器通信协议（WMMP）—终端接口分册（WMMP-T）»
[14]
«无线机器通信协议（WMMP）— 应用接口分册（WMMP-A）»
[15]
«中国移动一级BOSS枢纽接口规范〔物联网业务〕»
[16]
«中国移动BBOSS与物联网PBOSS接口规范»
[17]
«中国移动物联网PBOSS与物联网业务网关接口规范»
[18]
«中国移动物联网PBOSS与物联网业务平台接口规范»
[19]
«中国移动物联网全网运营治理平台与物联网PBOSS接口规范»
[20]
«中国移动物联网省运营治理平台与省级NGBOSS接口规范»
[21]
«业务平台与业务支撑系统数据一致性治理接口规范—物联网PBOSS分册»
[22]
«业务平台与业务支撑系统数据一致性治理接口规范—物联网PBOSS与物联网业务网关比对分册»
[23]
«业务平台与业务支撑系统数据一致性治理接口规范—物联网PBOSS与物联网业务平台比对分册»
[24]
«业务平台与业务支撑系统数据一致性治理接口规范——物联网PBOSS与全网运营治理平台分册»
[25]
«业务平台与业务支撑系统数据一致性治理接口规范—物联网PBOSS与一级BBOSS比对分册.
[26]
«物联网端到端业务流程测试规范»
[27]
«物联网运营治理平台设备测试规范»
[28]
«物联网业务网关设备测试规范»
本标准的附录为标准性附录，附录为资料性附录。
本标准由中移技﹝2020﹞361号印发。
本标准由中国移动通信集团公司数据部提出，集团公司技术部归口。
本标准起草单位：
中国移动通信研究院。
本标准要紧起草人：
刘玮、奚加荣、肖青、牛亚文、任晓东、匡尚超、彭巍、童小平、刘越、赵立君。
1范畴
本技术规范对物联网运营治理平台与物联网业务网关之间的接口制定了详细要求，原那么上在中国移动内部使用。
本标准适用于GSM/GPRS/EDGE/TD-SCDMA网络环境，是开展和运营物联网业务的技术依据。
2规范性引用文件
以下文件中的条款通过本标准的引用而成为本标准的条款。
凡是注日期的引用文件，其随后所有的修改单〔不包括勘误的内容〕或修订版均不适用于本标准，然而，鼓舞依照本标准达成协议的各方研究可使用这些文件的最新版本。
凡是不注日期的引用文件，其最新版本适用于本标准。
表2-1规范性引用文件
[1]
QB-D-034-2020
«基于行业应用网关的行业应用业务规范V1.0.0»
中国移动通信集团公司
[2]
QB-D-033-2020
«基于行业应用网关的行业应用总体技术要求V1.0.0»
中国移动通信集团公司
[3]
QB-D-035-2020
«行业应用网关接口规范V3.0.0»
中国移动通信集团公司
[4]
QB-GF-028-2003
«中国移动通信互联网短信网关接口协议〔CMPP〕V3.0.1»
中国移动通信集团公司
[5]
QB-C-011-2020
«中国移动短消息中心设备规范»
中国移动通信集团公司
[6]
QB-D-100-2020
«中国移动无线机器通信协议——M2M平台与终端接口分册»
中国移动通信集团公司
[7]
QB-D-101-2020
«中国移动无线机器通信协议——M2M平台与应用系统接口分册»
中国移动通信集团公司
[8]
QB-D-110-2007
«M2M数据业务系统通用网管接口技术规范»
中国移动通信集团公司
[9]
QB-E-015-2020
«物联网机器卡业务规范»
中国移动通信集团公司
[10]
QB-D-077-2020
«物联通业务规范»
中国移动通信集团公司
[11]
QB-E-020-2020
«中国移动M2M模组规范»
中国移动通信集团公司
[12]
QB-D-108-2007
«M2M业务总体技术要求»
中国移动通信集团公司
[13]
QB-D-111-2007
«M2M平台设备规范»
中国移动通信集团公司
[14]
QB-D-110-2007
«M2M数据业务系统通用网管接口技术规范»
中国移动通信集团公司
[15]
«中国移动物联网技术体制»
中国移动通信集团公司
[16]
«物联网运营治理平台设备规范»
中国移动通信集团公司
3术语、定义和缩略语
以下术语、定义和缩略语适用于本标准。
3.1.术语、定义
表3-1术语、定义
术语/定义
说明
物联网
物联网是指通过传感设备，按照约定的协议，把任何物品与信息网络连接起来，进行信息交换和通信，以实现智能化识别、定位、跟踪、监控和治理的一种网络
第三方应用
应用系统和终端差不多上由客户自行集成的应用
基础通信业务
中国移动提供的短信、GPRS、语音等基础通信服务
智能通道业务
中国移动在提供基础通信服务时，还提供通信状态治理、终端治理等增值服务。
自有业务和第三方应用都可能使用智能通道业务。
终端治理采纳中国移动WMMP协议承载
集成应用业务/自有业务
中国移动提供的端到端的应用集成和服务，终端治理和业务数据都通过中国移动WMMP协议承载。
按照中国移动标准产品治理模式，自有业务分为一类业务、二类业务和三类业务
物联网平台
包括物联网运营治理平台和物联网业务平台
能力
由能力提供者提供的信息资源或运算资源，通过WebService等接口向业务平台开放，依照不同的能力，业务平台可有偿或无偿使用。
例如位置平台能够作为能力系统入驻物联网。
物联网终端
连接各种感知设备〔包括传感器、摄像头、RFID读卡器、条码读卡器、GPS等〕并具备信息处理与通信能力的终端。
跨省集团客户
总部所在地在中国境内，组织机构跨省，以组织名义与中国移动签署业务协议，定购并使用中国移动的集团业务，在中国移动建立集团客户治理关系的法人单位及其附属的产业活动单位
终端治理
物联网终端治理是指通过中国移动WMMP协议，由运营治理平台与物联网终端通信，实现对物联网终端的注册治理、登录治理、差不多通信参数的远程配置、远程唤醒、远程重启、软件升级、通用故障信息上报等功能。
3.2.缩略语
表3-2缩略语
缩略语
英文全称
中文含义
APN
AccessPointName
接入点名称
BOSS
BusinessOperationSupportSystem
业务运营支撑系统
EC
EnterpriseCustomer
集团客户
EP
EnablerProvider
能力提供商
GGSN
GatewayGPRSSupportNode
GPRS网关支持节点
GPRS
GeneralPacketRadioService
通用无线分组业务
GSM
GlobalSystemforMobileCommunication
全球移动通讯系统
HLR
M2MHomeLocationRegister
归属位置寄存器
IOT
InternetofThings
物联网
LBS
LocationBasedService
位置业务
M2M
Machine-to-Machine
机器对机器通信
MO
MobileOriginated
个人用户发起的业务流程
MMS
MultimediaMessagingService
多媒体消息业务
MT
MobileTerminated
发送给个人用户的业务流程
SMS
ShortMessageService
短消息业务
SMSC
M2MShortMessageServiceCenter
短消息中心
SMPP
ShortMessagePointtoPoint
短信息点对点协议
CMPP
ChinaMobilePointtoPoint
中国移动点对点协议
SP
ServiceProvider
服务提供商
SI
SystemIntegrator
系统集成商
WMMP-A
WirelessMachineManagementProtocol-PartofInterfaceform2mplatformandApplicationPlatform
物联网业务网关与物联网平台之间的无线机器通信协议
WMMP-T
WirelessMachineManagementProtocol-PartofInterfaceform2mplatformandTerminal
物联网业务网关与物联网终端之间的无线机器通信协议
4基础通信接口
基础通信类接口要紧包括短信接口、彩信接口，其中短信接口遵循标准的CMPP3.0规范，而彩信接口遵循标准的MM7规范〔V6.3.0及以上版本〕。
4.1.短信接口
4.1.1.接口定义
该接口为治理平台与业务网关之间的双向实时短信接口。
4.1.2.接口功能
物联网业务运营治理平台通过该接口向手机用户收发短信。
4.1.3.业务流程
图4-1MO短信业务流程
MO流程：
1.业务网关收到手机用户通过通过行业网关上行的CMPP短信，成功接收后那么向行业网关返回响应消息；
2.业务网关消息报文头中取出目的号码〔治理平台短信服务代码〕，并将消息转发给对应的治理平台；
1）依照治理平台返回响应消息的情形，业务网关假如向治理平台投递消息失败，那么记录日志；
2）业务网关假如向治理平台投递消息成功，那么记录日志并出MO话单。
图4-2MT短信业务流程
MT流程：
1.业务网关收到治理平台下发的短信消息，返回响应消息；
2.业务网关将消息下发给行业网关；
1）依照接收响应消息的情形，假如业务网关向行业网关投递消息失败，那么向治理平台返回失败的状态报告；
2）业务网关假如向行业网关投递消息成功，那么将最终从行业网关返回的状态报告转发给治理平台；假如状态报告标示消息成功发送，那么记录日志并出MT话单。
4.1.4.报文格式
业务网关与运营治理平台、行业网关之间的短信报文遵循标准的CMPP3.0协议。
4.2.彩信接口
4.2.1.接口定义
该接口为治理平台与业务网关之间的双向实时彩信消息接口。
4.2.2.接口功能
物联网业务运营治理平台通过那个接口向手机用户收发彩信。
4.2.3.业务流程
图4-3MO彩信业务流程
MO流程：
1.业务网关收到手机用户通过行业网关上行的MM7彩信，成功接收那么向行业网关返回响应消息；
2.业务网关依照目的号码〔治理平台彩信服务代码〕，将彩信消息转发给对应的治理平台；
1）依照治理平台返回响应消息的情形，业务网关假如向治理平台投递消息失败，那么记录日志；
2）业务网关假如向治理平台投递消息成功，那么记录日志并出MO话单。
图4-4MT彩信业务流程
MT流程：
1.业务网关收到治理平台下发的彩信消息，返回响应消息；
2.业务网关将消息转发给行业网关；
1）依照接收响应消息的情形，假如业务网关向行业网关投递消息失败，那么向治理平台返回失败的状态报告；
2）业务网关假如向行业网关投递消息成功，那么将最终从行业网关返回的状态报告转发给治理平台；假如状态报告标示消息成功发送，那么记录日志并出MT话单；
4.2.4.报文格式
业务网关与运营治理平台之间的彩信报文遵循标准的MM7规范。
5终端治理接口
终端治理接口包括WMMP-A接口、终端注册要求鉴权接口、终端登录要求鉴权接口、终端退出登录通知接口、终端状态变更通知接口。
5.1.WMMP-A接口
5.1.1.接口定义
治理平台与业务网关之间的双向实时终端治理信息转发接口，TCP长连接下的标准承载的XML业务消息。
5.1.2.接口功能
终端和治理平台通过业务网关通过此接口实现数据交互。
接口功能包括：
T_TERMINFO_REPORT：
M2M终端经由业务网关向物联网治理平台上报信息；
T_CONFIG_REQ：
M2M终端经由业务网关通过本接口向治理平台要求终端的配置信息；
T_TRANSPARENT_DATA_UP：
终端通过业务网关通过本接口将数据转发送至治理平台；
T_TRANSPARENT_DATA_DOWN：
治理平台通过业务网关通过本接口将数据转发送至终端；
T_TERMINFO_GET：
治理平台通过业务网关通过本接口向终端猎取参数；
T_TERMINFO_SET：
治理平台通过业务网关通过本接口向终端设置参数；
T_TERM_CTRL：
治理平台通过业务网关通过本接口向终端下发远程操纵指令；
T_DOWNLOAD：
治理平台通过业务网关通过本接口向终端下发下载更新通知；
T_SECURITY_CONFIG：
治理平台通过业务网关通过本接口向终端下发安全参数。
5.1.3.业务流程
〔1〕上行消息流程
图5-1终端治理上行业务流程
MO流程：
1.业务网关接收到终端WMMP-T上行报文；
2.业务网关依照该报文中的报文头的CommandID判定为需要向治理平台转发的消息；
3.将消息转换为WMMP-A报文，然后转发给治理平台。
其中，WMMP-T报文头是每个WMMP-T报文必要的公共部分，它描述了每个WMMP-T报文的最差不多信息，其长度固定，为28个字节；而且其格式固定，依次为报文总长度、报文命令代码、报文流水号、报文协议版本、报文标识、保留字、终端序列号等7个字段。
而WMMP-T报文体是WMMP-T报文中承载交互数据的部分，其长度可变，格式不固定，甚至能够缺省，一样由内容体和摘要体构成。
〔2〕下行消息流程
图5-2终端治理下行业务流程
MT流程：
1.关于治理平台下发给终端的报文，业务网关将报文转换为WMMP-T消息，然后无条件地转发给终端。
2.假如终端不在线，那么业务网关向治理平台返回失败应答，其中RESULT字段填写1，表示终端不在线。
5.1.4.报文格式
报文格式详细内容能够参见WMMP-A协议中T_TERMINFO_REPORT、T_CONFIG_REQ、T_TRANSPARENT_DATA_UP、T_TERMINFO_GET、T_TERMINFO_SET、T_TERM_CTRL、T_DOWNLOAD、T_SECURITY_CONFIG、T_TRANSPARENT_DATA_DOWN报文。
5.2.终端注册要求鉴权接口
5.2.1.接口定义
治理平台与业务网关之间的单向实时终端注册要求鉴权接口，TCP长连接下的标准承载的XML业务消息。
报文方向：
业务网关发往治理平台。
5.2.2.接口功能
当终端经业务网关向治理平台注册时，业务网关通过该接口向治理平台转发终端注册消息。
治理平台对终端注册要求进行鉴权，并在鉴权通过后向业务网关返回应答消息，其中携带上下行接入密码、基础密钥信息。
5.2.3.业务流程
图5-3终端注册要求鉴权流程
消息流程：
1.业务网关在接收到终端WMMP-T报文，依照报文头中的CommandID判定为终端注册消息。
2.通过与运营治理平台的TCP长连接，向治理平台发送终端注册要求鉴权消息。
3.依照收到的治理平台鉴权结果，向终端返回注册应答。
网关储存的终端信息以治理平台返回值为准。
5.2.4.报文格式
〔1〕终端注册要求鉴权接口要求报文
报文定义如下：
参数标识
TRegistReq
消息格式
xmlversion="1.0"encoding="UTF-8"?
>
消息流水号
运营治理平台标识
消息体
消息摘要
名称
说明
数据类型
长度〔字节〕
SID
消息流水号
String
16
APPID
运营治理平台标识
String
16
未加密的消息体格式
消息体格式
终端序列号
终端的IMEI号
终端的IMSI号
终端MSISDN号码
操作代码
[TLV的值]
[TLV的值]
……
[TLV的值]
名称
说明
数据类型
长度〔字节〕
TERMID
终端序列号〔即终端注册后，治理平台为其分配的序列号，或终端预置的合法序列号〕
String
16
IMEI
终端的IMEI号。
长度16字节或15字节
String
16
IMSI
终端的IMSI号
String
15
MSISDN
终端MSISDN号码
String
21
OPERATION
WMMP-T注册报文中的操作码
Integer
4
PARAMLIST
WMMP-T注册报文中携带的TLV列表
不定长
PARAM
WMMP-T注册报文中携带的TLV
不定长
〔2〕终端注册要求鉴权接口应答报文
治理平台返回的TRegistRsp报文体定义如下：
参数标识
TRegistRsp
消息格式
xmlversion="1.0"encoding="UTF-8"?
>
消息流水号
运营治理平台标识
消息体
消息摘要
名称
说明
数据类型
长度〔字节〕
SID
消息流水号
String
16
APPID
运营治理平台标识
String
16
未加密的消息体格式
消息体格式
返回结果代码
终端序列号
终端SIM卡的IMSI
终端的IMEI
终端MSISDN号码
基础密钥
上行接入密码
下行接入密码
名称
说明
数据类型
长度〔字节〕
RESULTCODE
返回注册结果。
结果码定义如下：
0——注册成功，终端必须进入短信模式预备接收平台下发的接入密码和基础密钥
1——映射关系变更成功
2——注册/映射关系变更失败，无法验证IMSI订购关系，要求M2M终端改为短信注册
3——注册/映射关系变更失败，非法的MSISDN/IMSI，无该SIM卡订购关系
4——注册/映射关系变更失败，MSISDN/IMSI冲突，该SIM卡对应终端正在线工作
5——注册/映射关系变更失败，非法终端序列号
6——注册/映射关系变更失败，终端序列号冲突，该序列号对应的终端正在线工作
7——注册/映射关系变更失败，IMEI冲突，该IMEI所对应的终端正在线工作
8——注册/映射关系变更失败，通信协议版本不兼容
9——注册成功，终端预置的接入密码和基础密钥有效，赶忙发起首次登录。
A——注册失败，终端预置的接入密码校验信息验证无效。
B——注册失败，终端预置的基础密钥校验信息验证无效。
C——注册失败，终端预置的接入密码和基础密钥验证都无效。
D——注册失败，M2M平台无终端预置的接入密码校验信息。
E——注册失败，M2M平台无终端预置的基础密钥。
F——注册失败，M2M平台无终端预置的接入密码和基础密钥。
10——注册失败，M2M终端未上报预置的接入密码校验信息。
11——注册失败，M2M终端未上报预置的基础密钥校验信息。
12——注册失败，M2M终端未上报预置的接入密码和基础密钥校验信息。
其他：
保留。
String
2
TERMID
注册/映射关系变更成功，平台返回分配/预置的终端序列号；
注册/映射关系变更失败，平台返回终端上报的终端序列号。
String
16
IMSI
IMSI号码（String）
String
15
IMEI
终端的IMEI号
String
16
BASICKEY
终端的基础密钥的HEX字串
String
48
UPKEY
终端上行接入密码的HEX字串
String
16
DOWNKEY
终端下行接入密码的HEX字串
String
16
expireTime
BASICKEY、UPKEY、DOWNKEY都具有expireTime元素，表示该密钥的过期时刻，取值为1970年1月1日零点开始的秒数。
Integer
10
该报文采纳明文，不需要进行安全摘要验证。
业务网关在收到注册响应后，提取其中的订购关系、密钥信息，然后用治理平台返回的下行接入密码运算摘要，向终端返回WMMP-T中标准的REGIST_ACK报文。
5.3.终端登录要求鉴权接口
5.3.1.接口定义
治理平台与业务网关之间的单向实时终端登录要求鉴权接口，TCP长连接下的标准承载的XML业务消息。
报文方向：
业务网关发往治理平台。
5.3.2.接口功能
当终端向业务网关登录时，
升级会员 