开始使用赛普拉斯 CY8CKIT-064S0S2-4343W 套件 - FreeRTOS
开始使用开发环境Hardware (硬件)构建并运行调试OTA 更新
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

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

开始使用赛普拉斯 CY8CKIT-064S0S2-4343W 套件

本教程提供有关入门的说明CY8CKIT-064S0S2-4343W工具包。如果您还没有套件，可以使用该链接购买套件。你也可以使用该链接访问套件用户指南。

开始使用

在开始之前，您必须配置Amazon IoT和 FreeRTOS 将您的设备连接到Amazon云。有关说明，请参阅 初始步骤。完成先决条件后，您将拥有 FreeRTOS 软件包Amazon IoT Core凭证。

注意

在本教程中，在 “第一步” 部分创建的 FreeRTOS 下载目录的路径称为freertos.

设置开发环境

FreeRTOS 可以与 CMake 或 Make 构建流程配合使用。您可以使用ModusToolbox对于你的 Make 构建流程。你可以使用随附的 Eclipse IDEModusToolbox或合作伙伴 IDE，例如 IAR EWarm、Arm MDK 或微软 Visual Studio 代码。Eclipse IDE 与 Windows、macOS 和 Linux 操作系统兼容。

在开始之前，请下载并安装最新的ModusToolbox软件. 有关更多信息，请参阅 。ModusToolbox安装指南.

更新用于的工具ModusToolbox2.1 或更高版本

如果您使用的是ModusToolbox2.1 Eclipse IDE 要对此套件进行编程，您需要更新 OpenOCD 和固件加载器工具。

在以下步骤中，默认情况下ModusToolbox路径：

  • Windows 是C:\Users\user_name\ModusToolbox.

  • Linux 是user_home/ModusToolbox或者你选择提取存档文件的位置。

  • macOS 位于您在向导中选择的卷中的 “应用程序” 文件夹下。

更新 OpenOCD

该套件需要赛普拉斯 OpenOCD 4.0.0 或更高版本才能成功擦除和编程芯片。

更新赛普拉斯 OpenOCD

  1. 转至赛普拉斯 OpenOCD 发布页面.

  2. 下载操作系统的存档文件（Windows/mac/Linux）。

  3. 删除中的现有文件ModusToolbox/tools_2.x/openocd.

  4. 替换中的文件ModusToolbox/tools_2.x/openocd使用上一步中下载的档案中提取的内容。

更新固件加载器

此套件需要 Cypress 固件加载器 3.0.0 或更高版本。

更新 Cypress 固件加载器

  1. 转至Cypress 固件加载器发布页面.

  2. 下载操作系统的存档文件（Windows/mac/Linux）。

  3. 删除中的现有文件ModusToolbox/tools_2.x/fw-loader.

  4. 替换中的文件ModusToolbox/tools_2.x/fw-loader使用上一步中下载的档案中提取的内容。

或者，您可以使用 CMake 从 FreeRTOS 应用程序源代码生成项目构建文件，使用首选的构建工具构建项目，然后使用 OpenOCD 对工具包进行编程。如果你更喜欢使用 GUI 工具来编程 CMake 流程，请从Cypress 编程解决方案网页。有关更多信息，请参阅 将 CMake 与 FreeRTOS 结合使用。

设置硬件

请按照以下步骤设置套件的硬件。

  1. 预置你的套件

    跟随CY8CKIT-064S0S2-4343W 套件的配置指南安全配置套件的说明Amazon IoT.

    该套件需要CySecure工具 3.1.0 或更高版本。

  2. 设置串行连接

    1. 将套件 Connect 到主机。

    2. 该套件的 USB 串行端口会在主机上自动枚举。确定端口号。在 Windows 中，您可以使用Device Manager下端口（COM & LPT）。

    3. 启动一个串行终端，使用以下设置建立连接：

      • 波特率：115200

      • 数据：8 位

      • 奇偶校验：无

      • 停止位：1

      • 流控制：无

构建并运行 FreeRTOS 演示项目

在本节中，您构建并运行演示。

  1. 请务必按照中的步骤操作CY8CKIT-064S0S2-4343W 套件的配置指南.

  2. 构建 FreeRTOS 演示。

    1. 以下权限打开 Eclipse IDEModusToolbox然后选择或创建工作区。

    2. 从 File (文件) 菜单，选择 Import (导入)。

      Expand普通的，选择现有的项目到工作区，然后选择下一步.

    3. In根目录输入，freertos/projects/cypress/CY8CKIT-064S0S2-4343W/mtb/aws_demos然后选择项目名称aws_demos. 默认处于选中状态。

    4. 选择Finish将项目导入到工作区。

    5. 执行以下操作之一来构建应用程序：

      • 从快速面板选择，构建 aws_demos 应用程序.

      • 选择项目然后选择构建所有.

      确保项目进行编译，没有错误。

  3. 在云上监控 MQTT 消息

    在运行演示之前，您可以在Amazon IoT控制台，监控您的设备发送到Amazon云。使用订阅 MQTT 主题Amazon IoT请按照以下步骤操作 MQTT 客户端。

    1. 登录到 Amazon IoT 控制台。

    2. 在导航窗格中，选择测试选择，然后选择MQTT 测试客户端打开 MQTT 客户端。

    3. 适用于订阅主题输入，your-thing-name/example/topic，然后选择订阅主题.

  4. 运行 FreeRTOS 演示项目

    1. 选择项目aws_demos在工作区中。

    2. 从快速面板选择，aws_demos 计划 (KitProg3). 这将对主板进行编程，演示应用程序在编程完成后开始运行。

    3. 您可以在串行终端中查看运行的应用程序的状态。下图展示了终端输出的一部分。

      构建后终端输出的屏幕截图aws_demo项目。

      MQTT 演示发布了关于四个不同主题的消息（iotdemo/topic/n，其中 n=1 到 4) 并订阅所有这些主题以接收相同的消息。收到消息后，演示会发布有关主题的确认消息。iotdemo/acknowledgements. 下面的列表描述了出现在终端输出中的调试消息，并引用了消息的序列号。在输出中，首先打印 WICD 主机驱动程序 (WHD) 驱动程序详细信息，而不进行序列编号。

      1. 1 到 4 — 设备连接到配置的接入点 (AP) 并通过连接到Amazon服务器使用配置的终端节点和证书。

      2. 5 至 13 — CoreMQTT 库已初始化，设备建立了 MQTT 连接。

      3. 14 至 17 — 设备订阅所有主题以接收已发布的消息。

      4. 18 至 30 — 设备发布两条消息并等待接收回来。收到每条消息后，设备会发送确认消息。

      发布、接收和确认的相同周期一直持续到所有消息发布为止。在配置的周期数完成之前，每个周期会发布两条消息。

  5. 将 CMake 与 FreeRTOS 结合使用

    您还可以使用 CMake 构建并运行演示应用程序。要设置 CMake 和本机构建系统，请参阅先决条件.

    1. 使用以下命令可生成构建文件。使用指定目标主板-DBOARD选项。

      cmake -DVENDOR=cypress -DBOARD=CY8CKIT_064S0S2_4343W -DCOMPILER=arm-gcc -S freertos -B build_dir

      如果使用的是 Windows，则必须使用-G选项是因为 CMake 默认情况下使用 Visual Studio。

      cmake -DVENDOR=cypress -DBOARD=CY8CKIT_064S0S2_4343W -DCOMPILER=arm-gcc -S freertos -B build_dir -G Ninja

      如果 arm-none-eabi-gcc 不在 Shell 路径中，您还需要设置 AFR_TOOLCHAIN_PATH CMake 变量。

       -DAFR_TOOLCHAIN_PATH=/home/user/opt/gcc-arm-none-eabi/bin

    2. 使用以下命令使用 CMake 构建项目。

      cmake --build build_dir

    3. 最后，编程cm0.hex和cm4.hex下生成的文件build_dir通过使用赛普拉斯程序员。

运行其他演示

以下演示应用程序已经过测试和验证，可与当前版本配合使用。你可以在下面找到这些演示freertos/demos目录。有关如何运行演示的信息，请参阅FreeRTOS 演示.

  • 低功耗蓝牙演示

  • 无线更新演示

  • 安全插座 Echo 客户端演示

  • Amazon IoTDevice Shadow 演

调试

这些区域有：KitProg套件上的 3 支持通过 SWD 协议进行调试。

  • 要调试 FreeRTOS 应用程序，请选择aws_demos 项目在工作区中，然后选择aws_demos 调试 (KitProg3)来自 的快速面板.

OTA 更新

PSoC 64 MCU 已通过所有必要的 FreeRTOS 资格测试。但是，可选over-the-air在 PSoC 64 标准安全中实现了 (OTA) 功能Amazon固件库仍在等待评估。实施的 OTA 功能目前通过了所有 OTA 资格测试，但aws_ota_test_case_rollback_if_unable_to_connect_after_update.py.

当使用 pSoC64 标准安全将成功验证的 OTA 映像应用于设备时 —AmazonMCU 和设备无法与之通信Amazon IoT Core，设备无法自动回滚到原始已知良好的映像。这可能会导致无法从访问设备Amazon IoT Core以获取进一步更新。赛普拉斯团队仍在开发此功能。

有关更多信息，请参阅 。与 OTA 更新Amazon和 CY8CKIT-064S0S2-4343W 套件. 如果您有其他问题或需要技术支持，请联系赛普拉斯开发者社区.