中国电信物联网开放平台软件升级协议.docx

《中国电信物联网开放平台软件升级协议.docx》由会员分享，可在线阅读，更多相关《中国电信物联网开放平台软件升级协议.docx（9页珍藏版）》请在得力文库 - 分享文档赚钱的网站上搜索。

1、中困电信CHINA TELECOM国电信物联网开放平台一软件升级协议(V0.8)中国电信股份物联网分公司二0二二年六月.编制单位:编制单位中国电信股份物联网分公司平台运营部修订记录:版本号日期描述012018/02/03请求升级包响应增加分片序号；上报升级结果增 加当前版本号一前言本协议规定设备和中国电信物联网开放平台（以下简称“平台”）之间的 应用层升级协议（简称PCP协议），用于实现设备的升级二、通讯方式1、PCP协议运行在应用层，底层可以是LWM2M/C0AP/MQTT或者其他非流式 协议2、由于PCP协议消息没有使用单独的端口号，并且不依赖于底层协议，为 了和设备业务消息区分，PCP协

2、议固定以OXFFFE作为起始字节。因此要 求设备的业务消息的前两个字节不能是OXFFFE,更多细节参考附录包43、本协议消息采用一问一答模式，所有请求消息都有一个响应消息三、数据类型数据类型描述和要求BYTE无符号一字节整数WORD无符号二字节整数DWORD无符号四字节整数BYTEnn字节的十六进制数STRING字符串注：本协议采用网络序来传输WORD和DWORD四、消息结构消息码定义:字段名字段类型描述和要求起始标识WORD起始标识，固定为OXFFFE版本号BYTE局四位预留；低四位表不协议版本号， 当前为1消息码BYTE标识一个请求消息，应答消息的消息码 和请求消息相同校验码WORD从起始

3、标识到数据区的最后一个字节的 CRC16校验值，计算前先把校验码字段 置为3计算完成后把结果写到校验码 字段。数据区长度WORD数据区的长度数据区BYTE Ln参见具体指令的定义消息码描述0-18平台预留19查询设备版本20新版本通知21请求升级包22上报升级包下载状态23执行升级24上报升级结果25-127平台预留五、消息定义5.1查询设备版本方向：平台-设备字段数据类型描述及要求无数据区响应消息:字段数据类型描述及要求结果码BYTE0X00 处理成功当前版本号BYTEL16当前版本号，由ASCH字符组成，位数缺乏 时,后补“0X00”。正常处理：平台根据版本号判断设备是否需要升级，如果需要

4、，下发请求升级 异常处理：如果响应超时，平台中止升级任务5.2新版本通知方向：平台-设备字段数据类型描述及要求目的版本号BYTE16目的版本号，由ASCH字符组成，位数缺乏 时，后补“0X00”。升级包分片大小WORD每个分片的大小升级包分片总数WORD升级包分片总数升级包校验码WORD升级包校验码。用户上传升级包时，需要在升 级包描述文件里填写校验码应答消息:字段数据类型描述及要求结果码BYTE0X00允许升级0X01 设备使用中0X02 信号质量差0X03 已经是最新版本0X04 电量缺乏0X05 剩余空间缺乏0X09 内存缺乏0X7F 内部异常正常处理：如果设备不允许升级，平台中止升级任

5、务异常处理：如果响应超时，而且没收到请求升级包消息，平台中止升级任务5.2请求升级包方向：设备-平台字段数据类型描述及要求目的版本号BYTEL16目的版本号，由ASCII字符组成，位数缺乏 时,后补“0X00”。分片序号WORD表示请求获取的分片序号，从0开始计算。 设备可以保存已经收到的分片，下次直接从缺 失的分片开始请求，到达断点续传的效果。响应消息:字段数据类型描述及要求结果码BYTE0X00 处理成功0X80 升级任务不存在0X81指定的分片不存在分片序号WORD表示返回的分片序号分片数据BYTEn分片的内容，n为实际的分片大小。如果错误码 不为3那么不带此字段5.4上报升级包下载状态

6、方向:设备-平台字段数据类型描述及要求下载状态BYTE0X00 下载成功0X05 剩余空间缺乏0X06 下载超时0X07 升级包校验失败0X08 升级包类型不支持响应消息:字段数据类型描述及要求结果码BYTE0X00 处理成功0X80 升级任务不存在5.5执行升级方向：平台-设备字段数据类型描述及要求 无数据区响应消息:字段数据类型描述及要求结果码BYTE0X00 处理成功0X01设备使用中0X04 电量缺乏0X05 剩余空间缺乏0X09 内存缺乏5.6上报升级结果方向：设备-平台字段数据类型描述及要求结果码BYTE0X00 升级成功0X01设备使用中0X04 电量缺乏0X05 剩余空间缺乏0

7、X09 内存缺乏0X0A 安装升级包失败0X7F 内部异常当前版本号BYTEE16设备当前版本号响应消息:字段数据类型描述及要求结果码BYTE0X00 处理成功0X80 升级任务不存在6.1结果码定义结果码描述备注0X00处理成功0X01设备使用中0X02信号质量差0X03已经是最新版本0X04电量缺乏0X05剩余空间缺乏0X06下载超时0X07升级包校验失败0X08升级包类型不支持0X09内存缺乏0X0A安装升级包失败0X0B-0X7E预留错误码0X7F内部异常表示无法识别的异常0X80升级任务不存在0X80开始的为平台返回的错误码0X81指定的分片不存在6.2升级流程SP user平台设备

8、 上传升级包 7选择需要升级的设备组;|查询版本:K-应答-)新版本通知之之应答二请求分片1II!应答!IIK-请求分片2-IIIIIIIi应答片IIII I组装升级包，校验!-上报下载结果tIII应答!执行升级应答上报升级结果-应答6.3 断点续传6.4 PCP协议消息的识别由于PCP协议消息和设备业务消息共用一个端口和URL通讯，平台收到设备的消息时，按 照如下步骤判断是PCP协议消息还是业务消息：1、检查设备是否支持软件升级（根据设备profile的deC叩ability定义），如果不支持，那么 认为是业务消息2、检查设备软件升级协议是否是PCP,如果不是，那么认为是业务消息3、检查消息前两个字节是否为0XFFFE,如果不是，那么认为是业务消息4、检查版本号是否合法，如果不合法，那么认为是业务消息5、检查消息码是否合法，如果不合法，那么认为是业务消息6、检查校验码是否正确，如果不正确，那么认为是业务消息7、检查数据区长度是否正确，如果不正确，那么认为是业务消息8、如果以上检查都通过，认为是PCP协议消息对设备的要求：需要设备保证业务消息的起始字节不是OXFFFEo