配置 CoreMQTT 库以进行测试 - FreeRTOS
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

配置 CoreMQTT 库以进行测试

边缘设备可以使用 MQTT 协议与 Amazon 云通信。Amazon IoT 中托管一个 MQTT 代理,可与连接的边缘设备相互发送和接收消息。

CoreMQTT 库会为运行 FreeRTOS 的设备实现 MQTT 协议。不需要移植 CoreMQTT 库,但您设备的测试项目必须通过资格认证中的所有 MQTT 测试。有关更多信息,请参阅 。科里姆 QTT 库中的FreeRTOS 用户指南。

Prerequisites

要设置 CoreMQTT 库测试,需要具备以下条件:

  • TLS 库移植。

    有关将 TLS 库移植到您的平台的信息,请参阅移植 TLS 库

如果使用 IDE 构建测试项目,您需要在 IDE 项目中设置库移植。

设置 IDE 测试项目

在 IDE 项目中设置 CoreMQTT 库

  1. 将所有库源文件添加到freertos/libraries/coreMQTT/source目录及其子目录添加到aws_testsIDE 项目。

  2. 将网络图层的所有源文件(在测试中使用)添加到freertos/libraries/abstractions/transport目录和secure_sockets子目录添加到aws_testsIDE 项目。

  3. 添加core_mqtt_config.h文件,用于构建 CoremQtt 库所需的配置文件目录freertos/vendors/vendor/boards/board/aws_tests/config_files.

  4. 将添加到freertos/tests/integration_test/core_mqtt_system.c添加到aws_testsIDE 项目。

设置本地测试环境

在 IDE 项目中设置库后,您需要配置其他文件以进行测试。

为 MQTT 测试配置源文件和标头文件

  • 要启用 MQTT 测试,请打开 freertos/vendors/vendor-name/boards/board-name/aws_tests/config_files/aws_test_runner_config.h 并将 testrunnerFULL_CORE_MQTT_AWS_IOT_ENABLED 宏设置为 1

运行测试

执行 MQTT 测试

  1. 构建测试项目,然后将其刷写到您的设备以执行该项目。

  2. 在 UART 控制台中检查测试结果。如果通过所有测试,则测试完成。

Validation

要正式对设备进行 FreeRTOS 资格认证,您需要使用Amazon IoTDevice Tester。按照中的说明进行操作使用Amazon IoT适用于的 Device Tester在 FreeRTOS 用户指南中设置设备测试器以进行端口验证。要测试特定库的移植,必须在 Device Tester configs 文件夹下面的 device.json 文件中启用正确的测试组。

为您的设备设置 CoreMQTT 库后,即可开始移植 OTA 代理库。有关说明,请参阅移植Amazon IoT无线更新库

如果您的设备不支持 OTA 功能,您可以开始移植低功耗蓝牙库。有关说明,请参阅移植低功耗蓝牙库

如果您的设备不支持 OTA 和低功耗蓝牙功能,则您已完成移植,可以开始 FreeRTOS 资格认证流程。请参阅FreeRTOS 资格认证指南了解更多信息。