固件烧录授权

更新时间:2024-11-20 08:51:24下载pdf

使用 Zigbee SDK 开发完应用功能后,您需要将编译生成的固件烧录到芯片内并进行授权才可以连接到云端实现相关功能。本文讲解了设备固件烧录授权的完整流程。

烧录授权方案

烧录授权一体方案

使用涂鸦上位机烧录和授权时使用,涂鸦上位机工具已经将芯片的烧录软件集成在涂鸦上位机内,您只需使用涂鸦上位机就可以完成烧录和授权。

使用此方案需要将生产固件按规范传到 涂鸦开发者平台,获取授权码并进行烧录授权测试。

烧录授权分立方案

不使用涂鸦上位机或者只使用涂鸦上位机授权时使用,涂鸦上位机不提供芯片的烧录功能,需要您自行使用芯片烧录软件烧录固件。

烧录授权分立方案根据授权方案差异又分为以下两种情况:

  • 使用涂鸦上位机写入授权码:涂鸦提供授权码,您填入涂鸦上位机,通过串口将授权码信息写入到芯片内完成授权。
  • 自行写入授权码:涂鸦以 MS Excel 文件形式提供 授权码清单,您自行解析授权码清单内容,写入到芯片内完成授权。

获取授权码

SDK 开发完成后,编译生成的固件如下图所示:

固件烧录授权

编译出的 bin 文件,名称中尾缀为 QIO 的是生产固件,生产时使用。名称中尾缀为 OTA 的是升级固件,OTA 时使用。

文件名 说明
sample_smart_plug_1_QIO_1.0.0.s37 生产固件,用于模组Flash工作方式为QIO的模组
sample_smart_plug_1_OTA_1.0.0.bin 升级固件,用于上传涂鸦 IoT 平台OTA 固件

您需要将编译生成的固件上传至涂鸦开发者平台,以便下单获取对应的授权码,详细的流程如下:

  1. 登录到 涂鸦开发者平台,选择一款您创建的产品。

  2. 在产品 硬件开发 页面,选择 涂鸦标准模组SDK开发,点击新增自定义固件
    固件烧录授权

  3. 在新增固件页面填入固件相关信息,点击上传固件。(注意此处的固件标识名要和编译出来待上传的文件名一样)
    固件烧录授权

  4. 将编译生成的固件对号上传至相应的位置,点击保存并上架固件。
    固件烧录授权

  5. 上架固件。
    固件烧录授权

    固件新增成功的示例如下:

    固件烧录授权

固件上传完成后即可获取授权码,涂鸦的授权码分为以下三种类型:

固件烧录授权

Zigbee SDK 暂不支持授权码清单这种授权模式。

授权码名称 适用方案 说明
生产凭证 适用于烧录授权一体方案 加密后的授权码信息,使用涂鸦上位机通过授权协议烧录到设备内,常用于固件烧录和授权一体方案,会对固件 Key 包含的固件标识名、固件版本等信息进行校验,防止出现固件烧录错误、版本错误等现象,是涂鸦标准模组使用的烧录方式 ,也是涂鸦最推荐的烧录方式,不过需要涂鸦生产系统支持相应芯片的烧录,不适用于非涂鸦标准芯片。
生产凭证-仅授权 适用于烧录授权分立方案 加密后的授权码信息,使用涂鸦上位机通过授权协议烧录到设备内,用于固件烧录和授权分立方案,不对固件 Key 包含的信息做校验,适用于非涂鸦标准芯片的授权。
授权码清单 不建议使用,如有需求,可以先通过工单与涂鸦进行沟通 授权码明文信息,由开发者自行开发上位机烧录到设备内,通常不建议使用。

获取烧录授权工具

使用生产凭证

  1. 登录 涂鸦 PMS 系统

  2. 选择 知识库管理 下的 软件下载 选项,下载并安装 云模组烧录授权平台 软件。

    固件烧录授权

使用生产凭证-仅授权

  • 测试阶段:下载 独立授权工具 快速授权验证。
  • 生产阶段:下载并安装 云模组烧录授权平台 软件,工具获取流程与 使用生产凭证 相同。

使用授权码清单

涂鸦提供授权码明文,需要您自己开发工具将授权码写入到固件中。

操作说明

涂鸦适配过的硬件芯片平台列表如下,您可以参考对应文档对芯片/模组进行烧录授权:

芯片平台 烧录授权文档链接
EFR32MG21A020 ZS&TYZS 系列模组烧录授权
EFR32MG13P732 ZS&TYZS 系列模组烧录授权
Z2 ZT 系列模组烧录授权