一、目的

介绍天猫精灵IoT开放平台OTA规范及平台操作指导。当前已开放OTA升级的接入方式为：

• 蓝牙Mesh
• 蓝牙BLE

蓝牙协议层规范，请查看《蓝牙设备GATT OTA规范》

二、概览

目前已开放协议OTA能力如下：

三、开发者开放平台升级指导

开发者可在天猫精灵IoT开放平台上完成OTA全流程

• 固件上传
• 固件版本描述
• 固件测试验证
• 升级引导配置
• 固件全量发布
• 升级详情查看，设备固件版本查看

1、固件上传及版本描述

登陆天猫精灵IoT平台，在设备管理-设备升级区域，按Product ID或产品名称，搜索查找对应待升级产品。点击“查看固件列表”

点击新增固件，在弹窗中补充如下信息：

• 固件名称：用于开发者区分该Product ID的固件
• 固件版本：版本格式为xx.xx.xx，最大版本号为99.99.99，如1.1.1，针对已有固件的升级，版本号需叠加
• 上传固件：上传格式为.bin的固件文件
• 升级方式：勾选App提醒方式，生效后将会在天猫精灵App提醒
• 版本描述：面向用户描述此版本升级的内容，如功能功能更新或bug修复，视觉规范请参考“四、用户升级指导”

2、固件测试验证

新固件版本上传成功后，点击验证固件，弹窗中输入待验证设备的MAC地址，搜索后添加到验证列表中。可同时添加多个MAC地址验证。点击添加后，将推送新固件至待测试对应MAC地址设备中。

3、升级引导配置

面向用户的升级指导，请对应Product ID的产品开发-人机交互-触屏交互-升级引导中添加对应图文说明并保存。

• 升级引导图：用于向用户图形展示如何升级，建议采用GIF动态图
• 升级引导文案：用于向用户文字说明如何升级，建议与图匹配
• 版本更新内容：会同步开发者在固件上传-版本描述中的结果

4、固件全量发布

开发者实验室环境及产线抽测固件升级通过后，可在固件管理列表-操作-发布，进行全量发布。
注意！请确保在测试环境充分验证通过后再发布给线上用户

5、升级详情查看

已验证或发布推送的固件，可在升级详情中查看，并查看具体MAC地址设备升级情况、版本号、升级状态及详情

四、用户天猫精灵App升级指导

平台验证发布后，用户可在天猫精灵App上查看并完成升级

1、查看升级提醒

发布后，可在天猫精灵App-消息中查看，或点击App-我家-对应设备的设置页，设备升级出现立即更新提醒

2、升级引导

将手机靠近设备，参考图文指导，设备与手机建立蓝牙GATT连接后，点击开始升级。