OTA 相关指令

相关AT指令列表

该AT指令主要实现OTA升级配置及读取OTA数据等功能。

指令名称	功能描述
AT+QIOTOTAREQ	请求OTA升级计划
AT+QIOTUPDATE	配置 OTA 升级行为
AT+QIOTOTARD	分片读取 SOTA 数据

相关AT指令详情

AT+QIOTOTAREQ (请求 OTA 升级计划)

• 说明：该命令用于向平台请求 OTA 升级计划。
• 最大响应时间 ：300 毫秒。
• 特性说明： 该命令立即生效。

测试命令

• 发送：

  AT+QIOTOTAREQ=?

• 响应：

  响应支持的设置参数范围

  +QIOTOTAREQ: <info>
  
  OK

设置/执行命令

• 发送：

  AT+QIOTOTAREQ[=<info>]

• 响应：

  执行成功，若有升级计划时将通过事件+QIOTEVT: 7 上报

  OK

  若出现任何错误

  ERROR

---

• 参数：

  • <info>： 整型。是否需要额外文件校验 SHA256 信息。
    • 0：不需要
    • 1：需要

• 备注：

  • 2.1.2及以上版本支持

---

示例

前提：在开发者中心启动升级计划。

示例1 (主动发起OTA请求)

i. 配置开启额外 SHA256 信息。

ii. 主动发起OTA请求。

AT+QIOTOTAREQ=1

OK
AT+QIOTOTAREQ

OK

AT+QIOTUPDATE (配置 OTA 升级行为)

• 说明：该命令用于配置 OTA 升级行为。
• 最大响应时间 300 毫秒。
• 特性说明：该命令立即生效。

测试命令

• 发送：

  AT+QIOTUPDATE=?

• 响应：

  响应支持的设置参数范围

  +QIOTUPDATE: (支持的<update_action>范围)
  
  OK

设置命令

• 发送：

  AT+QIOTUPDATE=<update_action>

• 响应：

  设置成功

  OK

  若出现任何错误

  ERROR

---

• 参数：

  • <update_action> 整型。配置 OTA 升级行为。
    • 0 ：拒绝升级
    • 1 ：确认升级
    • 2 ：MCU 请求下载下一块固件数据
    • 3 ：MCU 上报更新中状态

• 备注：

  • 2.1.2及以上版本支持

---

示例

前提：在开发者中心激活升级计划。

示例1 (响应升级计划确认升级)

AT+QIOTUPDATE=1

OK

---

AT+QIOTOTARD (分片读取 SOTA 数据)

• 说明：该命令用于分片读取 SOTA 数据。
• 最大响应时间 ：300 毫秒。
• 特性说明： 该命令立即生效。

测试命令

• 发送：

  AT+QIOTOTARD=?

• 响应：

  响应支持的设置参数范围

  +QIOTOTARD: <start>,(支持的<max_length>范围)
  
  OK

设置命令

• 发送：

  AT+QIOTOTARD=<start>,<length>

• 响应：

  设置成功

  +QIOTOTARD: <start>,<length>
  <data>
  
  OK

  若出现任何错误

  ERROR

---

• 参数：

  • <start>： 整型。读取数据开始位置。单位：字节。
    
  • 前提：第一包数据从0开始读取，后续读取地址一直叠加。
  • <max_length>： 整型。支持的一次读取数据的最大长度。长度范围以测试命令实际返回值为准。
  • <length> ：整型。实际返回的数据长度。
  • <data>： 字节流类型。固件数据。

• 备注：

  • 2.1.2及以上版本支持

---

示例

前提：在开发者中心启动升级计划。

示例1 (分片读取 SOTA 数据) 循环读取SOTA数据，直到读取完全。

AT+QIOTOTARD=0,1024
data...

OK
AT+QIOTOTARD=1024,1024
data...

OK
AT+QIOTOTARD=2048,1024
data...

OK
......

---