Amazon IoT Jobs 库演示 - FreeRTOS
简介源代码组织配置 Amazon IoT MQTT 代理连接功能
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Amazon IoT Jobs 库演示

重要

该演示托管在已弃用的 Amazon-FreeRTOS 存储库中。当您创建新项目时，我们建议从此处开始。如果您已经有一个基于现已弃用的 Amazon-FreeRTOS 存储库的 FreeRTOS 项目，请参阅 Amazon-FreeRTOS Github 存储库迁移指南。

简介

Amazon IoT Jobs 库演示展示了如何通过 MQTT 连接连接到 Amazon IoT Jobs 服务、从 Amazon IoT 设备检索作业以及在设备上处理作业。Amazon IoT Jobs 演示项目使用 FreeRTOS Windows 端口，因此可以在 Windows 上使用 Visual Studio 社区版本进行构建和评估。无需微控制器硬件。该演示使用 TLS 与 Amazon IoT MQTT 代理建立安全连接，其方式与 coreMQTT 双向身份验证演示相同。

注意

要设置和运行 FreeRTOS 演示，请按照开始使用 FreeRTOS中的步骤操作。

源代码组织

演示代码位于 jobs_demo.c 文件中，可在 GitHub 网站或 freertos/demos/jobs_for_aws/ 目录中找到。

配置 Amazon IoT MQTT 代理连接

在本演示中，您将使用与 MQTT 代理的 Amazon IoT MQTT 连接。此连接的配置方式与 coreMQTT 双向身份验证演示相同。

功能

该演示展示了用于从 Amazon IoT 接收任务并在设备上处理这些任务的工作流程。该演示是交互式的，需要您使用 Amazon IoT 控制台或 Amazon Command Line Interface (Amazon CLI) 来创建作业。有关创建作业的更多信息，请参阅 Amazon CLI 命令参考中的 create-job。该演示要求将作业文档的 action 键设置为 print 才能将消息输出到控制台。

请参阅此作业文档的以下格式。

{
    "action": "print",
    "message": "ADD_MESSAGE_HERE"
}

您可以使用 Amazon CLI 创建作业，如以下示例命令所示。


aws iot create-job \
    --job-id t12 \
    --targets arn:aws:iot:region:123456789012:thing/device1 \
    --document '{"action":"print","message":"hello world!"}'

该演示还使用将 action 键设置为 publish 的作业文档来将消息重新发布到主题。请参阅此作业文档的以下格式。

{
    "action": "publish",
    "message": "ADD_MESSAGE_HERE",
    "topic": "topic/name/here"
}

该演示会循环执行，直到收到一个将 action 键设置为 exit 的作业文档才会退出。作业文档的格式如下所示。

{
    "action: "exit"
}

Jobs 演示的入口点

Jobs 演示入口点函数的源代码可以在 GitHub 上找到。该函数执行以下操作：

  1. 使用 mqtt_demo_helpers.c 中的帮助程序函数建立 MQTT 连接。

  2. 使用 mqtt_demo_helpers.c 中的帮助程序函数为 NextJobExecutionChanged API 订阅 MQTT 主题。主题字符串是之前使用 Amazon IoT Jobs 库定义的宏汇编而成的。

  3. 使用 mqtt_demo_helpers.c 中的帮助程序函数为 StartNextPendingJobExecution API 发布 MQTT 主题。主题字符串是之前使用 Amazon IoT Jobs 库定义的宏汇编而成的。

  4. 反复调用 MQTT_ProcessLoop 以接收传入的消息，这些消息将交给 prvEventCallback 进行处理。

  5. 演示收到退出操作后，使用文件中的帮助程序函数取消订阅 MQTT 主题并断开连接。mqtt_demo_helpers.c

收到的 MQTT 消息的回调

prvEventCallback 函数从 Amazon IoT Jobs 库调用 Jobs_MatchTopic，以便对传入的 MQTT 消息进行分类。如果消息类型对应于新作业，则会调用 prvNextJobHandler()。

prvNextJobHandler 函数及其调用的函数从 JSON 格式的消息中解析作业文档，然后运行作业指定的操作。prvSendUpdateForJob 函数非常让人感兴趣。

为正在运行的作业发送更新

函数 prvSendUpdateForJob() 从 Jobs 库调用 Jobs_Update()，以便填充在紧随其后的 MQTT 发布操作中使用的主题字符串。