Cypress CYW954907AEVAL1F 开发工具包入门 - FreeRTOS
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

Cypress CYW954907AEVAL1F 开发工具包入门

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

注意

本教程将指导您完成设置和运行 MQTT Hello World 演示的步骤。此主板的 FreeRTOS 端口当前不支持 TCP 服务器和客户端演示。

在开始之前,您必须配置 AWS IoT 和 FreeRTOS 下载以将您的设备连接到 AWS 云。有关说明,请参阅初始步骤。在本教程中,FreeRTOS 下载目录的路径称为 freertos

重要
  • 在本主题中,FreeRTOS 下载目录的路径称为 freertos

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

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

  • 下载 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 的单独文件夹,其中 mn 分别是主要版本号和次要版本号。本文档假定文件夹名称为 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

    • 流控制:无

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

构建并运行 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 (生成目标) 以生成演示并将其下载到您的主板。生成演示并下载到主板后,该演示应自动运行。

在云上监控 MQTT 消息

您可以使用 AWS IoT 控制台中的 MQTT 客户端监控您的设备发送到 AWS 云的消息。

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

  1. 登录 AWS IoT 控制台

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

  3. Subscription topic (订阅主题)中,输入 iotdemo/#,然后选择 Subscribe to topic (订阅主题)

故障排除

  • 如果您使用的是 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 入门的常规故障排除信息,请参阅 问题排查入门