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

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

Cypress CYW954907AEVAL1F 开发工具包入门

重要

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

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

注意

此教程引导您完成设置和运行 CoreMQTT 双向身份验证演示的过程。该主板的 FreeRTOS 端口目前不支持 TCP 服务器和客户端演示。

在开始之前，您必须进行配置Amazon IoT并下载 FreeRTOS 才能将设备连接到Amazon云端。有关说明，请参阅初始步骤：在本教程中，FreeRTOS 下载目录的路径被称为freertos。

重要

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

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

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

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

    这样，Windows 可以在提取存档时正确创建符号链接。否则，符号链接将被写成普通文件，其中包含符号链接的路径为文本或为空。有关更多信息，请参阅 Windows 10 中的 Symlinks 的博客文章 Symlinks！ 。

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

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

      git config --global core.symlinks true

    • 每当你使用写入系统的 git 命令（例如、、git pull和git submodule update --init --recursive）时，都要使用升级为管理员的控制台。git clone

  • 如中所述下载FreeRTOS，赛普拉斯的 FreeRTOS 端口目前仅在上可用 GitHub。

概览

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

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

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

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

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

设置开发环境

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

在本入门指南中，您将使用 Cypress WICED Studio SDK 通过 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/CYW954907AEVAL1F/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 入门的一般疑难解答信息，请参阅问题排查入门。