Cypress CYW943907AEVAL1F 开发工具包入门 - FreeRTOS
概述设置开发环境建立串行连接在云上监控 MQTT 消息构建并运行 FreeRTOS 演示项目故障排除
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

Cypress CYW943907AEVAL1F 开发工具包入门

重要

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

本教程提供有关 Cypress CYW943907AEVAL1F 开发工具包入门的说明。如果您没有 Cypress CYW943907AEVAL1F 开发工具包，请访问 Amazon 合作伙伴设备目录来从我们的合作伙伴购买一个。

注意

本教程将指导您完成设置和运行 coreMQTT 双向身份验证演示。此主板的 FreeRTOS 移植当前不支持 TCP 服务器和客户端演示。

在开始之前，您必须配置 Amazon IoT 和 FreeRTOS 下载以将您的设备连接到 Amazon 云。有关说明，请参阅初始步骤：

重要

  • 在本主题中，FreeRTOS 下载目录的路径称为 freertos。

  • freertos 路径中的空格字符可能会导致构建失败。克隆或复制存储库时，请确保您创建的路径不包含空格字符。

  • Microsoft Windows 上的文件路径最大长度为 260 个字符。FreeRTOS 下载目录路径过长可能会导致构建操作失败。

  • 由于源代码可能包含符号链接，因此，如果您使用 Windows 提取存档，则可能必须：

    • 启用开发者模式，或者，

    • 使用已提升为管理员的控制台。

    这样，Windows 就可以在提取存档文件时正确创建符号链接。否则，符号链接将作为普通文件写入，该文件会将符号链接的路径作为文本，或者是空文件。有关更多信息，请参阅博客文章 Windows 10 中的符号链接。

    如果您在 Windows 下使用 Git，则必须启用开发者模式，或者必须：

    • 使用以下命令将 core.symlinks 设置为 true：

      git config --global core.symlinks true

    • 每当您使用写入系统的 git 命令（例如，git pull、git clone 和 git submodule update --init --recursive）时，请使用具有管理员权限的控制台。

  • 如下载 FreeRTOS中所述，适用于 Cypress 的 FreeRTOS 移植目前仅在 GitHub 上提供。

概述

本教程包含有关以下入门步骤的说明：

  1. 在主机上安装软件来开发和调试微控制器主板的嵌入式应用程序。

  2. 将 FreeRTOS 演示应用程序交叉编译为二进制映像。

  3. 将应用程序二进制映像加载到您的主板上，然后运行该应用程序。

  4. 跨串行连接与主板上运行的应用程序进行交互，以便进行监视和调试。

设置开发环境

下载并安装 WICED Studio 开发工具包

在本入门指南中，您可以使用 Cypress WICED Studio 开发工具包通过 FreeRTOS 演示对主板进行编程。访问 WICED Software 网站，从 Cypress 下载 WICED Studio 开发工具包。您必须注册免费的 Cypress 账户才能下载该软件。WICED Studio 开发工具包与 Windows、macOS 和 Linux 操作系统兼容。

注意

某些操作系统需要额外的安装步骤。确保您阅读并遵循所安装的操作系统和 WICED Studio 版本的所有安装说明。

设置环境变量

在使用 WICED Studio 对主板进行编程之前，必须为 WICED Studio 开发工具包安装目录创建一个环境变量。如果在创建变量时 WICED Studio 正在运行，则您需要在设置变量后重新启动该应用程序。

注意

WICED Studio 安装程序会在您的计算机上创建两个名为 WICED-Studio-m.n 的单独文件夹，其中 m 和 n 分别是主要版本号和次要版本号。本文档假定文件夹名称为 WICED-Studio-6.2，但请确保为您安装的版本使用正确的名称。定义 WICED_STUDIO_SDK_PATH 环境变量时，请确保指定 WICED Studio 开发工具包的完整安装路径，而不是 WICED Studio IDE 的安装路径。在 Windows 和 macOS 中，开发工具包的 WICED-Studio-m.n 文件夹默认情况下在 Documents 文件夹中创建。

在 Windows 上创建环境变量

  1. 在控制面板上，依次选择系统和高级系统设置。

  2. 在高级选项卡上，选择环境变量。

  3. 在用户变量下，选择新建。

  4. 对于变量名称，输入 WICED_STUDIO_SDK_PATH。对于变量值，输入 WICED Studio 开发工具包安装目录。

在 Linux 或 macOS 中创建环境变量

  1. 打开您计算机上的 /etc/profile 文件，然后将以下内容添加到该文件最后一行：

    export WICED_STUDIO_SDK_PATH=installation-path/WICED-Studio-6.2

  2. 重启计算机。

  3. 打开一个终端，并运行以下命令：

    cd freertos/vendors/cypress/WICED_SDK
    perl platform_adjust_make.pl
    chmod +x make

建立串行连接

在主机和主板之间建立串行连接

  1. 使用 USB Standard-A 到 Micro-B 线缆将主板连接到主机。

  2. 标识与主机上主板的连接的 USB 串行端口号。

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

    • 波特率：115200

    • 数据：8 位

    • 奇偶校验：无

    • 停止位：1

    • 流控制：无

有关安装终端和设置串行连接的更多信息，请参阅安装终端仿真器。

在云上监控 MQTT 消息

在运行 FreeRTOS 演示项目之前，您可以在 Amazon IoT 控制台中设置 MQTT 客户端来监控您的设备发送到 Amazon 云的消息。

使用 Amazon IoT MQTT 客户端订阅 MQTT 主题

  1. 登录到 Amazon IoT 控制台。

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

  3. 在 Subscription topic (订阅主题)中，输入 your-thing-name/example/topic，然后选择 Subscribe to topic (订阅主题)。

构建并运行 FreeRTOS 演示项目

建立与主板的串行连接后，您可以构建 FreeRTOS 演示项目，将演示刷入主板，然后运行演示。

在 WICED Studio 中构建并运行 FreeRTOS 演示项目

  1. 启动 WICED Studio。

  2. 从 File (文件) 菜单，选择 Import (导入)。展开 General 文件夹，选择 Existing Projects into Workspace (现有项目到工作区)，然后选择 Next (下一步)。

  3. 在 Select root directory (选择根目录) 中，选择 Browse... (浏览...)，导航到路径 freertos/projects/cypress/CYW943907AEVAL1F/wicedstudio，然后选择 OK (确定)。

  4. 在 Projects (项目) 下，选中与 aws_demo 项目对应的复选框。选择 Finish (完成) 以导入项目。目标项目 aws_demo 应显示在 Make Target (制作目标) 窗口中。

  5. 展开 WICED Platform (WICED 平台) 菜单，然后选择 WICED Filters off (WICED 滤除)。

  6. 在 Make Target (制作目标) 窗口中，展开 aws_demo，右键单击 demo.aws_demo 文件，然后选择 Build Target (生成目标) 以生成演示并将其下载到您的主板。生成演示并下载到主板后，该演示应自动运行。

故障排除

  • 如果您使用的是 Windows，则在构建和运行演示项目时可能会看到以下错误：

    : recipe for target 'download_dct' failed
make.exe[1]: *** [download_dct] Error 1

    要排查该错误，请执行以下操作：

    1. 浏览找到 WICED-Studio-SDK-PATH\WICED-Studio-6.2\43xxx_Wi-Fi\tools\OpenOCD\Win32，然后双击 openocd-all-brcm-libftdi.exe。

    2. 浏览找到 WICED-Studio-SDK-PATH\WICED-Studio-6.2\43xxx_Wi-Fi\tools\drivers\CYW9WCD1EVAL1，然后双击 InstallDriver.exe。

  • 如果您使用的是 Linux 或 macOS，则在构建和运行演示项目时可能会看到以下错误：

    make[1]: *** [download_dct] Error 127

    要排查此错误，请使用以下命令更新 libusb-dev 程序包：

    sudo apt-get install libusb-dev

有关 FreeRTOS 入门的常规故障排除信息，请参阅问题排查入门。