![附件五多形态终端上报接口v2.0.3多二期_第1页](http://file4.renrendoc.com/view/334838eafc597d50e6d3173edeb5ee33/334838eafc597d50e6d3173edeb5ee331.gif)
![附件五多形态终端上报接口v2.0.3多二期_第2页](http://file4.renrendoc.com/view/334838eafc597d50e6d3173edeb5ee33/334838eafc597d50e6d3173edeb5ee332.gif)
![附件五多形态终端上报接口v2.0.3多二期_第3页](http://file4.renrendoc.com/view/334838eafc597d50e6d3173edeb5ee33/334838eafc597d50e6d3173edeb5ee333.gif)
![附件五多形态终端上报接口v2.0.3多二期_第4页](http://file4.renrendoc.com/view/334838eafc597d50e6d3173edeb5ee33/334838eafc597d50e6d3173edeb5ee334.gif)
![附件五多形态终端上报接口v2.0.3多二期_第5页](http://file4.renrendoc.com/view/334838eafc597d50e6d3173edeb5ee33/334838eafc597d50e6d3173edeb5ee335.gif)
版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领
文档简介
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!
温馨提示
- 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
- 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
- 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
- 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
- 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
- 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
- 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
最新文档
- 上海2024年上海市精神卫生中心工作人员招聘笔试历年参考题库解题思路附带答案详解
- 小小翻译员:学习几个简单的外语单词
- 车联网技术进展与物联网融合应用策略报告
- 小学数学期中综合测验
- 小学体育模拟试卷
- 3.11 北洋政府的统治与军阀割据 课件-2024-2025学年统编版八年级历史上册
- 政治-人教版高中政治必修3《文化生活》全册教案、学案juf
- 2024年小班圣诞节活动策划方案范文(30篇)
- 2024年圣诞夜感言(3篇)
- 班主任季度工作总结(35篇)
- 推动城乡产业协同发展实施方案
- 《楞次定律》-完整版课件 省一等奖
- 关节腔积液检查共23张课件
- 伤口的分类评估课件
- 手术室护理质量管理组织架构及职责
- 2021苏教版小学科学一年上册《借助工具观察》说课稿(含反思)
- 小学数学西南师大五年级上册四小数混合运算教案
- 《煤矿矿井机电设备完好标准》
- 《综合商务英语4》课程教学大纲
- 中国旅游地理(第七版)第03章中国旅游资源地理
- 业主满意度调查表
评论
0/150
提交评论