固件上传

更新时间:2024-06-25 03:10:47下载pdf

MCU 通用对接方案和 SDK 对接方案是常用的接入涂鸦生态的开发模式,除了能够获得涂鸦生态互联互通的能力以外,还可以利用 涂鸦开发者平台 上传自定义固件进行 OTA 升级。本文档着重介绍如何上传自定义固件。

自定义固件

自定义固件指您在涂鸦开发者平台自定义上传的固件,由您自行维护更新。

固件类型

固件类型:分为生产固件、用户区固件和升级固件。

  • 生产固件和用户区固件:主要用于涂鸦工厂生产烧录,仅针对使用涂鸦生产的产品需上传。
  • 升级固件:主要用于设备远程更新(即固件升级 OTA),对所有产品生效。

自定义固件配置的准备工作

  • 编译需要上传的固件
  • 准备验证固件的设备样品
  • 在涂鸦开发者平台创建自定义对接产品 PID,账号具有开发者权限

上传及上架操作步骤

  • 找到对应的产品 PID,进入开发界面
  • 硬件选型
  • 新增自定义固件信息填写
  • 上传固件
  • 固件上架

操作步骤

  1. 登录 涂鸦开发者平台,打开产品列表,找到需要上传配置固件的产品,单击 继续开发

    固件上传
  2. 在产品开发界面,单击 硬件开发 页签,根据设备硬件,进行主芯片和模组的选型。如平台上没有对应的芯片选型,请联系对接的 PM 同学。

    固件上传
  3. 单击 新增自定义固件,填写固件信息后,单击 上传固件

    固件上传 固件上传
  4. 填写固件版本信息,并上传对应的固件文件。固件上传完成后,单击 保存。页面提示是否要进行固件上架,可以根据需求,暂不上架或进行固件上架。

    固件上传
  5. 单击 固件上架设置上架内容设置允许使用范围,填写完成后单击 确认上架

    固件上传

FAQ

固件未上架状态和已上架状态有什么区别?

  • 未上架(默认),表示该固件版本暂时无法使用,期间产品开发暂不支持领取或采购云端授权码,需要完成上架操作后支持领取和购买。

  • 已上架,表示该固件版本可以被产品使用。

    • 若上架生产固件和用户区固件,则允许在产品开发中选择。
    • 若上架升级固件,则允许在固件升级中选择。如果后续有 OTA 升级的需求,建议勾选升级固件。

设置允许使用范围功能如何理解?

设置允许使用范围是指设定支持使用此固件的账号和 PID 权限。

示例说明

  1. 账号 A 将自己账号下的包含固件 key1 的产品 PID1,通过复制产品或 OEM 产品至账号 B 和账号 C。
  2. 账号 B 和账号 C 接收复制或 OEM 链接,分别创建产品 PID2 和 PID3,此时两个产品都包含固件 key1 的 v1.0.0 版本。
  3. 当账号 A 对固件 key1 进行新的版本迭代,新建一个固件版本 v1.0.1。
  4. 设置上架范围。
    • 若允许账号 B 和账号 C 都能使用此版本,则需要进行固件上架,上架范围设置为不限范围,则账号 B 和账号 C 将同时收到可用于固件升级的版本 v1.0.1。
    • 若只允许账号 B 使用此版本,则上架范围设置为 B 即可,此时只有账号 B 将收到可用于固件升级的版本 v1.0.1。
  5. 以此类推,若固件 key1 被使用到 N 个客户的产品 PID 中,则可根据此范围控制。

允许使用范围中增加的白名单(客户账号和产品 PID)是指什么?

指可以在固件升级和产品开发中,选择使用当前上架固件版本的产品 PID 和客户清单,一般指通过产品 OEM 或产品复制方式获取到的固件 key 的企业客户。

如何查看管理上传的固件?

单击 固件管理 > 我的固件 中查看属于当前账号的固件信息,进行管理操作。