OTA升级设备侧适配-华为云

设备接入 IOTDA-设备侧适配开发指导:上报升级结果

上报升级结果根据PCP协议约定的交互流程，设备在执行完软件升级后，将会向物联网平台上报升级的结果。设备发送的请求消息根据PCP消息结构的定义可以得出，设备向物联网平台上报升级结果，各个消息字段的填写如下：起始标识固定为：FFFE。版本号固定为：01。消息码：与请求的消息码一致，为18。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的字段的数据类型得出数据区长度为17字节，转换为十六进制为：0011。数据区：结果码，以上报升级成功为例，结果码为00。当前版本号：升级完成后的版本号，与物联网平台下发的软件版本一致，即v1.0，转换为十六进制为：56312E30000000000000000000000000。字段数据类型描述及要求结果码 BYTE 0X00升级成功。 0X01设备使用中。 0X04电量不足。 0X05剩余空间不足。 0X09内存不足。 0X0A安装升级包失败。 0X7F内部异常。当前版本号 BYTE[16] 设备当前版本号。设备向物联网平台上报升级结果的消息为：FFFE 01 18 0000 0011 0056312E30000000000000000000000000（CRC16校验前），经CRC16计算得到校验码为：C7D2。则替换校验码后设备向物联网平台上报升级结果码流为：FFFE0118C7D200110056312E30000000000000000000000000。物联网平台发送的应答消息物联网平台收到设备上报的升级结果消息后，将对设备进行应答，各个消息字段的填写如下。起始标识固定为：FFFE。版本号固定为：01。消息码：与请求的消息码一致：18。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的字段定义得出该数据长度为1个字节，转换为十六进制为：0001。数据区：处理成功，则返回00，升级任务不存在80。本示例以返回00处理成功为例进行说明。字段数据类型描述及要求结果码 BYTE 0X00处理成功。 0X80升级任务不存在。物联网平台向设备的应答消息为：FFFE 01 18 0000 0001 00 （CRC16校验前），经CRC16计算得到校验码为：AFA1。则替换校验码后物联网平台返回的应答消息为：FFFE0118AFA1000100 。

设备接入 IOTDA OTA升级设备侧适配

设备接入 IOTDA-设备侧适配开发指导:执行软件升级

执行软件升级根据PCP协议约定的交互流程，物联网平台收到设备发送的软件包下载结果通知后，需要通知设备进行升级操作。物联网平台发送的请求消息根据PCP消息结构的定义可以得出，物联网平台向设备发送执行软件升级消息，各个消息字段的填写如下：起始标识固定为：FFFE。版本号固定为：01。消息码：与请求的消息码一致，为17。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的字段的数据类型得出无数据区，即为0字节，转换为十六进制为：0000。数据区：无数据区，无需携带该字段。字段数据类型描述及要求无数据区物联网平台向设备下发的执行软件升级的消息为：FFFE 01 17 0000 0000（CRC16校验前），经CRC16计算得到校验码为：CF90。则替换校验码后物联网平台向设备发送的消息为：FFFE0117CF900000。设备发送的应答消息设备收到物联网平台下发的执行升级消息后，将对收到消息后的执行动作进行应答，各消息字段的填写如下。起始标识固定为：FFFE。版本号固定为：01。消息码：与请求的消息码一致：17。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的字段定义得出该数据长度为1个字节，转换为十六进制为：0001。数据区：处理成功，则返回00，其它处理结果请参考数据区定义。本示例以返回00处理成功为例进行说明。字段数据类型描述及要求结果码 BYTE 0X00处理成功。 0X01设备使用中。 0X04电量不足。 0X05剩余空间不足。 0X09内存不足。设备向物联网平台应答的消息为：FFFE 01 17 0000 0001 00 （CRC16校验前），经CRC16计算得到校验码为：B725。则替换校验码后设备返回的响应消息为：FFFE0117B725000100 。

设备接入 IOTDA OTA升级设备侧适配

设备接入 IOTDA-设备侧适配开发指导:上报下载结果

上报下载结果根据PCP协议约定的交互流程，设备接收完所有分片数据并组装完软件包后，需要向物联网平台上报软件包的下载结果。设备发送的请求消息根据PCP消息结构的定义可以得出，设备向物联网平台发送的上报软件包下载结果消息，各个消息字段的填写如下：起始标识固定为：FFFE。版本号固定为：01。消息码：与请求的消息码一致，为16。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的字段的数据类型得出数据区长度为1个字节，转换为十六进制为：0001。数据区：上报软件包的下载结果，比如下载成功，设备侧上报00。字段数据类型描述及要求下载状态 BYTE 0X00下载成功。 0X05剩余空间不足。 0X06下载超时。 0X07升级包校验失败。 0X08升级包类型不支持。设备向物联网平台发送升级包下载结果的消息为：FFFE 01 16 0000 0001 00（CRC16校验前），经CRC16计算得到校验码为：850E。则替换校验码后设备发送的升级包下载结果的消息为：FFFE0116850E000100。物联网平台的应答消息物联网平台收到设备上报的软件包下载结果后，将会向设备返回应答消息，各个消息字段的填写如下。起始标识固定为：FFFE。版本号固定为：01。消息码：与请求的消息码一致：16。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的字段定义得出该数据长度为1个字节，转换为十六进制为：0001。数据区：处理成功，则返回00，处理失败返回80。本示例以返回00处理成功为例进行说明。字段数据类型描述及要求结果码 BYTE 0X00处理成功。 0X80升级任务不存在。物联网平台向设备应答的消息为：FFFE 01 16 0000 0001 00 （CRC16校验前），经CRC16计算得到校验码为：850E。则替换校验码后物联网平台向设备应答的消息为：FFFE0116850E000100。

设备接入 IOTDA OTA升级设备侧适配

设备接入 IOTDA-设备侧适配开发指导:下载升级包

下载升级包根据PCP协议约定的交互流程，物联网平台通知设备有新的软件版本时，设备向物联网平台请求下载软件包，按照分片的序号进行下载。设备发送的请求消息根据PCP消息结构的定义可以得出，设备向物联网平台发送的请求软件包分片的第一条消息，各消息字段的填写如下。起始标识固定为：FFFE。版本号固定为：01。消息码：查询消息码表可知请求升级包的消息码为21，转换为十六进制为：15。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的字段的数据类型得出数据区长度为18个字节，转换为十六进制为：0012。数据区：目标版本号为平台下发的新版本通知版本号，即v1.0，转换为十六进制为56312E30000000000000000000000000，分片序号为第0个分片，即0000。字段数据类型描述及要求目的版本号 BYTE[16] 目的版本号，由ASCII字符组成，位数不足时，后补“0X00”。分片序号 WORD 表示请求获取的分片序号，从0开始计算，分片的总数为软件包大小除以每个分片的大小并向上取整获得。设备可以保存已经收到的分片，下次直接从缺失的分片开始请求，达到断点续传的效果。设备向物联网平台发送请求软件包分片的第一条消息为：FFFE 01 15 0000 0012 56312E30000000000000000000000000 0000（CRC16校验前），经CRC16计算得到校验码为：5618。则替换校验码后设备发送的第一条请求分片消息为：FFFE01155618001256312E300000000000000000000000000000。其它分片请求的消息流只需要替换分片序号后，重新计算并替换CRC16校验码即可，此处就不再展开。物联网平台的应答消息物联网平台收到设备的请求软件包分片消息后，将会给设备下发分片的数据。物联网平台向设备响应的第一条请求分片的消息，各消息字段的填写如下。起始标识固定为：FFFE。版本号固定为：01。消息码：与请求的消息码一致：15。校验码：CRC16计算前先用0000替代。数据区：先讲数据区再讲数据区长度。结果码：00，分片序号：第0个分片：0000，分片数据：跟软件包定义的内容有关，我们假设软件包内容为HELLO, IoT SOTA!，经ASCII码转换为十六进制为：48454C4C4F2C20496F5420534F544121，共16字节。用户上传软件包时手动输入升级包分片大小为500byte，即最大长度为500字节。这种情况下，无需在数据的后面补充0。数据区长度：根据数据区的字段定义得出该数据长度为19，转换为十六进制为：0013。字段数据类型描述及要求结果码 BYTE 0X00处理成功。 0X80升级任务不存在。 0X81指定的分片不存在。分片序号 WORD 表示返回的分片序号。分片数据 BYTE[n] 分片的内容，n为实际的分片大小。如果结果码不为0，则不带此字段。物联网平台向设备发送的第一个软件包分片消息为：FFFE 01 15 0000 0013 00 0000 48454C4C4F2C20496F5420534F544121（CRC16校验前），经CRC16计算得到校验码为：E107。则替换校验码后物联网平台向设备发送的第一个软件包分片消息为：FFFE0115E107001300000048454C4C4F2C20496F5420534F544121。其它软件包分片的消息流只需要替换分片序号和分片数据后，重新计算并替换CRC16校验码即可，此处就不再展开。

设备接入 IOTDA OTA升级设备侧适配

设备接入 IOTDA-设备侧适配开发指导:下载新版本软件包通知

下载新版本软件包通知根据PCP协议约定的交互流程，查询完版本号后，物联网平台下发指令让设备下载新版本的软件包。物联网平台发送消息根据PCP消息结构的定义可以得出，物联网平台向设备下发下载新版本软件包通知时，各消息字段的填写如下。起始标识固定为：FFFE。版本号固定为：01。消息码：此处为新版本通知，查询消息码表可以知道新版本通知为20，转换为十六进制为14。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的消息字段可以得出，数据区长度为22个字节，转换为十六进制为：0016。数据区：根据数据区的定义可知。目标版本号：由16个字节组成，假设升级的目标版本号为v1.0版本，转换为十六进制并在后面14个字节补充0后得到：56312E30000000000000000000000000。升级包分片大小：由2个字节组成，单位为byte，用户上传软件包时可以手动输入升级包分片大小，如果不设置默认为500byte，大小为32~500之间。假设为500byte，转换为十六进制后为：01F4。升级包分片总数：由2个字节组成，由软件包大小除以每个分片的大小并向上取整获得。假设软件包大小为500byte，则分片数量为1，转换为十六进制后为：0001。检验码：由2个字节组成，目前已废弃，固定为：0000。字段数据类型描述及要求目的版本号 BYTE[16] 目的版本号，由ASCII字符组成，位数不足时，后补“0X00”。升级包分片大小 WORD 每个分片的大小升级包分片总数 WORD 升级包分片总数升级包校验码 WORD 固定为：0000 将下载新版本软件包通知的消息流组合起来得到：FFFE 01 14 0000 0016 56312E30000000000000000000000000 01F4 0001 0000。前面说了，还要将消息流进行CRC16算法计算得到校验码为02F7。因此，物联网平台向设备通知下载新版本软件包的信息，物联网平台向设备发送的消息流为FFFE011402F7001656312E3000000000000000000000000001F400010000。设备返回的应答消息设备收到下载新版本软件包通知后，设备向物联网平台返回应答消息，是否允许设备进行升级，各消息字段的填写如下。起始标识固定为：FFFE。版本号固定为：01。消息码：与请求的消息码一致，为14。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的字段的数据类型得出数据区长度为1个字节，转换为十六进制为：0001。数据区：设备根据自身的情况对平台下发的新版本通知进行响应，本示例以设备应答“允许升级”为例进行介绍，得出数据区为：00。其它应答消息请根据应答消息字段进行适配。字段数据类型描述及要求结果码 BYTE “0X00”允许升级 “0X01”设备使用中 “0X02”信号质量差 “0X03”已经是最新版本 “0X04”电量不足 “0X05”剩余空间不足 “0X09”内存不足 “0X7F”内部异常将设备给物联网平台的应答消息流组合起来得到：FFFE 01 14 0000 0001 00。前面说了，还要将消息流进行CRC16算法计算得到校验码为D768。因此，设备向平台返回的应答消息流为FFFE0114D768000100。

设备接入 IOTDA OTA升级设备侧适配

设备接入 IOTDA-设备侧适配开发指导:概述

概述设备的OTA软件升级是基于华为定义的PCP协议进行的，设备侧需根据PCP协议定义的交互流程进行适配开发。下面我们将结合物联网平台与设备的软件升级交互流程，介绍终端设备将如何基于PCP协议构建交互过程中的请求消息和应答消息，帮助您更好的根据PCP协议进行终端侧的软件升级功能开发。下面我们先了解下PCP消息的结构，PCP协议的请求消息和应答消息都遵循相同的消息结构，主要由这几部分组成： PCP协议消息由：起始标识位、版本号、消息码、校验码、数据区长度和数据区组成，各字段的要求和描述如下表所示。字段名字段类型描述和要求起始标识 WORD 起始标识，固定为0XFFFE。版本号 BYTE 高四位预留；低四位表示协议版本号，当前为1。消息码 BYTE 标识物联网平台与设备之间的请求消息类型，应答消息的消息码和请求消息相同。消息码的定义为： 0-18：预留消息码，暂未使用。 19：查询设备版本。 20：下载新版本软件包通知。 21：请求下载升级包。 22：上报升级包下载结果。 23：执行软件升级。 24：上报升级结果。 25-127：预留消息码，暂未使用。校验码 WORD 从起始标识到数据区的最后一个字节的CRC16校验值，计算前先把校验码字段置为0，计算完成后把结果写到校验码字段。说明： CRC16算法：CRC16/CCITT x16+x12+x5+1 数据区长度 WORD 数据区的长度。数据区 BYTE[n] 可变长度，具体由各个指令定义，可参考下面介绍的各个指令对应的请求消息和应答消息定义。数据类型描述 BYTE 无符号一字节整数 WORD 无符号二字节整数 DWORD 无符号四字节整数 BYTE[n] n字节的十六进制数 STRING 字符串

设备接入 IOTDA OTA升级设备侧适配

设备接入 IOTDA-设备侧适配开发指导:查询设备版本号

查询设备版本号从设备的软件升级流程（本流程只描述物联网平台与设备基于PCP协议交互的流程）可以看到，首先物联网平台向设备下发查询版本号信息，设备进行应答。物联网平台发送消息根据PCP消息结构的定义可以得出，物联网平台向设备下发查询版本号时，各消息字段的填写如下：起始标识：固定为消息流的前2个字节，固定为FFFE。版本号：数据类型为1个字节整数，且固定为1，即在消息流中为01。消息码：数据类型为1个字节整数，查询设备版本的消息码为19，转换为十六进制为13。校验码：数据类型为2个字节整数，先将校验码置为0000，然后将完整的消息码流进行CRC16的算法计算得到校验码，再将得到的校验码替换原消息中的0000。数据区长度：数据类型为2个字节整数，代表数据区的消息长度，根据数据区的数据结构可以得出该条消息无数据区，即数据区长度为0000。数据区：数据区代表要真正发送给设备的数据，根据查询版本信息的数据区定义，该条消息是没有实际要传送的数据的，即无需数据区字段。字段数据类型描述及要求无数据区因此将查询版本消息的码流组合起来得到：FFFE 01 13 0000 0000。前面的校验码时讲了，需要将组合后的消息码流进行CRC16算法（物联网平台提供了基于JAVA和C语言的CRC16算法代码样例，您可以直接使用）得到校验码4C9A，然后将该校验码替换原码流中的0000后得到FFFE01134C9A0000，该消息码流即为物联网平台发送给设备的查询版本信息的消息码流。设备返回的应答消息设备收到物联网平台要查询设备的软件版本号消息，设备要向物联网平台反馈查询的结果，各消息字段的填写如下。起始标识固定为：FFFE。版本号固定为：01。消息码：与请求的消息码一致，为13。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的字段的数据类型得出数据区长度为17个字节，转换为十六进制为：0011。数据区：根据数据区的定义可知，处理成功的结果码为00，版本号信息假设为V0.9，将V0.9进行ASCII转码得到56302E39，由于版本号的数据类型为BYTE[16]，即16个字节，当前只有4个字节，因此需要在版本号数据后面补0，得到56302E39000000000000000000000000。因此，数据区合并后为0056302E39000000000000000000000000。字段数据类型描述及要求结果码 BYTE “0X00”处理成功当前版本号 BYTE[16] 当前版本号，由ASCII字符组成，位数不足时，后补“0X00”。将查询版本信息的消息流组合起来得到：FFFE 01 13 0000 0011 0056302E39000000000000000000000000。前面讲到，还要将消息流进行CRC16算法计算得到校验码为8DE3。因此，物联网平台向设备查询版本号信息，设备向平台返回的消息流为FFFE01138DE300110056302E39000000000000000000000000。

设备接入 IOTDA OTA升级设备侧适配

设备接入 IOTDA-PCP协议介绍:消息结构

消息结构字段名字段类型描述和要求起始标识 WORD 起始标识，固定为0XFFFE。版本号 BYTE 高四位预留；低四位表示协议版本号，当前为1。消息码 BYTE 标识物联网平台与设备之间的请求消息类型，应答消息的消息码和请求消息相同。消息码的定义为： 0-18：预留消息码，暂未使用。 19：查询设备版本。 20：下载新版本软件包通知。 21：请求下载升级包。 22：上报升级包下载结果。 23：执行软件升级。 24：上报升级结果。 25-127：预留消息码，暂未使用。校验码 WORD 从起始标识到数据区的最后一个字节的CRC16校验值，计算前先把校验码字段置为0，计算完成后把结果写到校验码字段。说明： CRC16算法：CRC16/CCITT x16+x12+x5+1 数据区长度 WORD 数据区的长度。数据区 BYTE[n] 可变长度，具体由各个指令定义，可参考下面介绍的各个指令对应的请求消息和应答消息定义。

设备接入 IOTDA OTA升级设备侧适配

设备接入 IOTDA-PCP协议介绍:PCP消息识别

PCP消息识别由于PCP协议消息和设备业务消息共用一个端口和URL通讯，平台收到设备的消息时，按照如下步骤判断是PCP协议消息还是业务消息：检查设备是否支持软件升级（根据设备profile的omCapability.upgradeCapability定义），如果不支持，则认为是业务消息。检查设备软件升级协议是否是PCP，如果不是，则认为是业务消息。检查消息前两个字节是否为0XFFFE，如果不是，则认为是业务消息。检查版本号是否合法，如果不合法，则认为是业务消息。检查消息码是否合法，如果不合法，则认为是业务消息。检查校验码是否正确，如果不正确，则认为是业务消息。检查数据区长度是否正确，如果不正确，则认为是业务消息。如果以上检查都通过，认为是PCP协议消息。对设备的要求：需要设备保证业务消息的起始字节不是0XFFFE。

设备接入 IOTDA OTA升级设备侧适配

云服务器内容精选

OTA升级设备侧适配

7*24

备案

专业服务

退订

建议反馈

售前咨询热线