使用 MQTT 的 OTA 更新的先决条件 - FreeRTOS
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

使用 MQTT 的 OTA 更新的先决条件

此部分介绍了使用 MQTT 执行无线 (OTA) 更新的一般要求。

最低要求

  • 设备固件必须包含必要的 FreeRTOS 库(MQTT、OTA 代理及其依赖关系)。

  • 要求安装 FreeRTOS 1.4.0 版或更高版本。但是,我们建议您尽可能使用最新的版本。

配置

从版本 201912.00 开始,FreeRTOS OTA 可使用 HTTP 或 MQTT 协议将固件更新映像从 AWS IoT 传输到设备。如果在 FreeRTOS 中创建 OTA 更新时指定两个协议,则每个设备都将确定用于传输映像的协议。参阅 使用 HTTP 的 OTA 更新的先决条件 了解更多信息。

默认情况下,aws_ota_agent_config.h 中的 OTA 协议配置将使用 MQTT 协议:

/** * @brief The protocol selected for OTA control operations. * This configuration parameter sets the default protocol for all the OTA control * operations like requesting OTA job, updating the job status etc. * * Note - Only MQTT is supported at this time for control operations. */ #define configENABLED_CONTROL_PROTOCOL ( OTA_CONTROL_OVER_MQTT ) /** * @brief The protocol selected for OTA data operations. * This configuration parameter sets the protocols selected for the data operations * like requesting file blocks from the service. * * Note - Both MQTT and HTTP are supported for data transfer. This configuration parameter * can be set to the following - * Enable data over MQTT - ( OTA_DATA_OVER_MQTT ) * Enable data over HTTP - ( OTA_DATA_OVER_HTTP) * Enable data over both MQTT & HTTP ( OTA_DATA_OVER_MQTT | OTA_DATA_OVER_HTTP ) */ #define configENABLED_DATA_PROTOCOLS ( OTA_DATA_OVER_MQTT ) /** * @brief The preferred protocol selected for OTA data operations. * * Primary data protocol will be the protocol used for downloading files if more than * one protocol is selected while creating OTA job. Default primary data protocol is MQTT * and the following update here switches to HTTP as primary. * * Note - use OTA_DATA_OVER_HTTP for HTTP as primary data protocol. */ #define configOTA_PRIMARY_DATA_PROTOCOL ( OTA_DATA_OVER_MQTT )

设备特定的配置

无。

内存使用量

在将 MQTT 用于数据传输时,MQTT 连接不需要额外的内存,因为它将在控制操作和数据操作之间共享。

设备策略

每个使用 MQTT 接收 OTA 更新的设备都必须在 AWS IoT 中注册为事物,并且该设备必须具有类似此处所列策略的附加策略。您可以在 AWS IoT 核心策略操作AWS IoT 核心操作资源"Action""Resource" 对象中找到有关这些项的更多信息。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iot:Connect", "Resource": "arn:partition:iot:region:account:client/${iot:Connection.Thing.ThingName}" }, { "Effect": "Allow", "Action": "iot:Subscribe", "Resource": [ "arn:partition:iot:region:account:topicfilter/$aws/things/${iot:Connection.Thing.ThingName}/streams/*", "arn:partition:iot:region:account:topicfilter/$aws/things/${iot:Connection.Thing.ThingName}/jobs/*" ] }, { "Effect": "Allow", "Action": [ "iot:Publish", "iot:Receive" ], "Resource": [ "arn:partition:iot:region:account:topic/$aws/things/${iot:Connection.Thing.ThingName}/streams/*", "arn:partition:iot:region:account:topic/$aws/things/${iot:Connection.Thing.ThingName}/jobs/*" ] } ] }

备注

  • 利用 iot:Connect 权限,您的设备可以通过 MQTT 连接到 AWS IoT。

  • 利用 AWS IoT 作业 (.../jobs/*) 主题的 iot:Subscribeiot:Publish 权限,连接的设备能够接收作业通知和作业文档,并发布作业执行的完成状态。

  • 利用 AWS IoT OTA 流 (.../streams/*) 主题的 iot:Subscribeiot:Publish 权限,连接的设备能够从 AWS IoT 中提取 OTA 更新数据。在通过 MQTT 执行固件更新时,需要这些权限。

  • 利用 iot:Receive 权限,AWS IoT Core 能够将有关这些主题的消息发布到连接的设备。每次传输 MQTT 消息时,都将检查此权限。您可以使用此权限,撤消对当前订阅主题的客户端的访问权限。