固件上传

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

自定义固件

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

固件类型

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

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

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

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

上传及上架操作步骤

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

操作步骤

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

   

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 的企业客户。

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

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