附件五多形态终端上报接口v2.0.3多二期

1、多形态终端上报接口规范(公开)作者：日期： 2018-12-27审核：日期：批准：日期：（，）文件受控版次Vs2.0.3密级总页数附录1. 接口总体概述1.1 协议概述定义多形态终端与 DMP 服务端通信规范。接口采用基于COAP 协议的 LwM2M 协议进行通信。UE 按照协议规范将需要上报的数据进行封装，通过 COAP 地址与 DMP 服务端进行上报通信，DMP 进行响应上报结果进行回执。1.2-register是 UE 在使用 DMP 时，向 DMP 发起的流程，主要用于 UE首次向设备自身能力和 DMP 通讯以及设备离线后再次和服务器握手。根据 LwM2m 规范目前信息封装进 endp

2、o字段，拼接规则如下：endpo中包含 终端类型、CMEI/IMEI1、IMEI2、IMSI、DM 版本号、appkey 、标识 IMEI(若 imei1 不为空则上报 imei1,若为空则上报 imei2，此处为明文)、多形态校验迭代号(二期迭代号为 v2.0)八个信息。上报时间和 IP 地址由服务器获取。终端类型简称参见附录 2，以”#”拼接后面信息，CMEI/IMEI1、IMEI2、IMSI、DM 版本号这 4 条信息以”-”进行拼接，然后进行加密，若其中某条信息为空则以”*”代替这条信息，最后再用”#”拼接 appkey。例：A#imei1-imei2-imsi-v1.0#appkey

3、123456#IMEIFlag#iterationVer*注意* imei1-imei2-imsi-v1.0 这 4 条信息加密后再和终端类型、appkey、标识 IMEI、多形态校验迭代号用#拼接，一期的集成 DM 版本号上报 v1.0，二期的集成 DM 版本号和 iterationVer 都上报 V2.0。（加密）上报的信息除了终端类型、appkey、IMEIFlag、iterationVer 之外需进行 AES 加密，加密模式为(AES/CBC/PKCS7Padding),先 SHA256 摘要，再 AES256 加密，最后 BASE64 编码，伪代码表示为:base64encode(A

4、ES/CBC/PKCS7Padding(sha256(key),明文)，AES 偏移量默认 16 个 0。DMP 接受到数据后，将按 LwM2m 规范封装 LwM2mResponse 进行回执。例：上报成功 ResponseCode.CREATED （201）-UE 上报完信息后，DMP 对终端进行 Read 操作，相关设备信息，终端设备需配置相应资源属性，保证 read 操作成功。该操作由 DMP 发起 coap 请求例如：CON-GETMID=-1,Token=null,OptionSet=Uri-Path:666,0,6602,Accept:application/vnd.oma.lwm

5、2m+tlv, no payloadUE 收到 Read 消息后，获取相应的资源属性值，根据 Read 消息的格式，将到的资源值返回给 DMP，并携带返回码，资源属性值同样需要加密，如上。例如：ACK-2.05MID=42422, Token=ea32b4120279f851,OptionSet=Content-Format:application/vnd.oma.lwm2m+tlv,e8 19 ca 13 74 68 69 73 20 69 73 20 6d 79 20 6170702069 6e66 6f e8 19 c9 16 74 686973206973206d7920646576

6、6963 6520 69 6e 66 6f1.2.1Coap资源详细说明DMP 收到响应信息后对信息和设备信息进行保存。终端设备信息资源配置相应字段如下表:操作Read（资源）LwM2M 参数/Object ID/Object Instance ID/Resource ID参数说明Object ID：必选，如 UE 上的资源对象Object Instance ID：可选，如 UE 资源对象实例的Resource ID：可选，如 UE 上的资源CoAP-MethodGETCoAP-OptionOption 1：Uri-Path（11）：Object IDOption 2：Uri-Path（11）

7、：Object Instance ID Option 3：Uri-Path（11）：Resource IDOption 4：Accept（17）：第 1 节中的 Content Format 表中的类型，如application/vnd.oma.lwm2m+tlv 参数是表示数据的格式为tlvCoAP-payloadSucs2.05 ContentFailure4.00 Bad Request, 4.01 Unauthorized, 4.04 Not Found, 4.05 Method Not Allowed另附基于 LWM2M 规范的资源配置文件 XML 见附录 4 供参考配置。1.3 更

8、新-updateUE 向 DMP 发起 update-register，DMP 接收到上报数据进行保存并回执更新成功信息 update-response。根据 LwM2m 规范已有信息的终端设备，保存有 registionId 的设备上报终端类型、CMEI/IMEI1、IMEI2、IMSI、appkey、iterationVer 6 条信息。根据 LwM2m 规范目前信息封装进 endpoinfo()字段，拼接规则如下：endpoinfo 中包含终端类型、CMEI/IMEI1、IMEI2、IMSI、Object IDObjectInstance IDResource ID字段说明6660660

9、1Device Info备用(不上报)66606602App Info应用信息(App 集合，每条日志用rn 分隔，每条日志包含 App 名称、包名、 App 使用时长(毫秒)、App打开次数 并由|分隔 )66606603MACmac 地址66606604ROMrom 信息66606605RAMram 信息66606606CPUcpu 信息66606607SysVer操作系统版本号66606608SoftwareVer固件版本号66606609SoftwareName固件名称66606610Voltevolte 开关状态66606611NetType当前网络类型66606612Account

10、宽带账号66606613PhoneNumber本机号码66606614Location位置信息(包含经度，维度，定位模式，以逗号,分隔)appkey、IMEIFlag(标识 IMEI,若 imei1 不为空则上报 imei1,若为空则上报 imei2，此处为明文)、iterationVer 6 条信息，（上报时间和 ip 由服务器获取系统时间，iterationVer 是迭代版本默认 v2.0），终端类型简称参见附件 2，以”#”拼接后面的 4 条信息，CMEI/IMEI1、IMEI2、IMSI 这 3 条信息以”-”进行拼接，然后进行加密，若其中某条信息为空则以”*”代替这条信息，加密后再用

11、#拼接 appkey 等明文信息，详见附录 3。例：A#imei1-imei2-imsi#appkey123456#IMEIFlag#iterationVer*注意* imei1-imei2-imsi 这 3 条信息加密后再和终端类型、appkey、IMEIFlag、iterationVer 用#拼接，一期的集成 DM 版本号上报 v1.0，二期的集成 DM 版本号和 iterationVer 都上报 V2.0。和时相同。DMP 接受到数据后，将按 LwM2m 规范封装 LwM2mResponse 进行回执。例：成功 ResponseCode.CHANGED （204）附录 1-返回码对照表返

12、回码对应说明201成功202注销成功204更新成功205订阅成功400请求失败附录 2-终端类型简称对照表附录 3-各上报字段总览：（非必选字段为空仍以“*”作为默认值上报，需要加密的字段以“-”拼接例如：单独模组上报的，imei1 上报为*，imei2 上报模组的imei。）心跳：（非必选字段为空仍以“*”作为默认值上报，需要加密的字段以“-”拼接例如：单独模组上报的，imei1 上报为*，imei2 上报模组的imei。）字段说明安卓Linux接口是否加密字段说明安卓Linux接口是否加密Terminaltyp e终端类型 A、L、 I必选必选必选否Imei1终端 Imei必选必选必选是I

13、mei2模组 Imei非必选非必选非必选是imsiimsi必选必选必选是Dm_versio ndm 版本号必选必选必选是appkeyAppkey必选必选必选否imeiFlag标识 imei必选必选必选否multiVer多形态校验迭代号必选必选必选否终端类型简称安卓ALinuxL接口I403请求404资源失败附录 4-基于 LWM2M 规范的资源配置文件DeviceInfo666urn:oma:lwm2m:ext:666MultipleOptionalDevice InfoRSingleOptionalStringApp InfoRSingleOptionalStringTerminaltyp e终端类型 A、L、 I必选必选必选否Imei1终端 Imei必选必选必选是Imei2模组 Imei非必选非必选非必选是imsiimsi必选必选必选是Appkeyappkey必选必选必选否imeiFlag标识 imei必选必选必选否multiVer多形态校验迭代号必选必选必选否MACRSingleOptionalStringROMRSingleOptionalStringRAMRSingleOptionalStringCPURSingleOptionalString!CDpuSysVerRSingleOptionalString!