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

# Cypress CYW954907 AEVAL1 F 开发套件入门
<a name="getting_started_cypress_54"></a>

**重要**  <a name="deprecation-message"></a>
该参考集成托管在已弃用的 Amazon-FreeRTOS 存储库中。当您创建新项目时，我们建议[从此处开始](freertos-getting-started-modular.md)。如果您已经有一个基于现已弃用的 Amazon-FreeRTOS 存储库的 FreeRTOS 项目，请参阅 [Amazon-FreeRTOS Github 存储库迁移指南](github-repo-migration.md)。

本教程提供了 Cypress CYW954907 AEVAL1 F 开发套件的入门说明。如果您没有 Cypress CYW954907 AEVAL1 F 开发套件，请访问 AWS 合作伙伴设备目录从我们的[合作伙伴](https://devices.amazonaws.com/detail/a3G0L00000AAPg5UAH/CYW954907AEVAL1F)处购买。

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

在开始之前，必须进行配置 AWS IoT 并下载 FreeRTOS 才能将设备连接到云端。 AWS 有关说明，请参阅[初始步骤](freertos-prereqs.md)：在本教程中，FreeRTOS 下载目录的路径称为 `freertos`。

**重要**  
在本主题中，FreeRTOS 下载目录的路径称为 `freertos`。
`freertos` 路径中的空格字符可能会导致构建失败。克隆或复制存储库时，请确保您创建的路径不包含空格字符。
Microsoft Windows 上的文件路径最大长度为 260 个字符。FreeRTOS 下载目录路径过长可能会导致构建操作失败。
由于源代码可能包含符号链接，因此，如果您使用 Windows 提取存档，则可能必须：  
启用[开发者模式](https://docs.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development)，或者，
使用已提升为管理员的控制台。
这样，Windows 就可以在提取存档文件时正确创建符号链接。否则，符号链接将作为普通文件写入，该文件会将符号链接的路径作为文本，或者是空文件。有关更多信息，请参阅博客文章 [Windows 10 中的符号链接](https://blogs.windows.com/windowsdeveloper/2016/12/02/symlinks-windows-10/)。  
如果您在 Windows 下使用 Git，则必须启用开发者模式，或者必须：  
使用以下命令将 `core.symlinks` 设置为 true：  

    ```
    git config --global core.symlinks true
    ```
每当您使用写入系统的 git 命令（例如，**git pull**、**git clone** 和 **git submodule update --init --recursive**）时，请使用具有管理员权限的控制台。
如中所述[下载 FreeRTOS](freertos-prereqs.md#freertos-download)，赛普拉斯的 FreeRTOS 端口目前仅在上可用。[ GitHub](https://github.com/aws/amazon-freertos)

## 概述
<a name="overview-for-cypress-CYW954907AEVAL1F-tutorial"></a>

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

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

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

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

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

## 设置开发环境
<a name="cypress54-setup-env"></a>

### 下载并安装 WICED Studio 开发工具包
<a name="cypress54-install-wiced-studio"></a>

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

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

### 设置环境变量
<a name="cypress54-environment"></a>

在使用 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. 在**控制面板**上，依次选择**系统**和**高级系统设置**。

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

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

1. 对于**变量名称**，输入 **WICED\$1STUDIO\$1SDK\$1PATH**。对于**变量值**，输入 WICED Studio 开发工具包安装目录。

**在 Linux 或 macOS 中创建环境变量**

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

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

1. 重启计算机。

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

   ```
   cd freertos/vendors/cypress/WICED_SDK
   ```

   ```
   perl platform_adjust_make.pl
   ```

   ```
   chmod +x make
   ```

## 建立串行连接
<a name="cypress54-serial-connection"></a>

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

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

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

1. 启动一个串行终端，使用以下设置建立连接：
   + 波特率：115200
   + 数据：8 位
   + 奇偶校验：无
   + 停止位：1
   + 流控制：无

有关安装终端和设置串行连接的更多信息，请参阅[安装终端仿真器](gsg-troubleshooting.md#uart-term)。

## 在云上监控 MQTT 消息
<a name="cypress54-monitor-mqtt"></a>

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

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

1. 登录 [AWS IoT 控制台](https://console.aws.amazon.com/iotv2/)。

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

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

## 构建并运行 FreeRTOS 演示项目
<a name="cypress54-build-and-run-example"></a>

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

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

1. 启动 WICED Studio。

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

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

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

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

1. 在**制作目标**窗口中，展开 **aws\$1demo**，右键单击 `demo.aws_demo` 文件，然后选择**生成目标**以生成演示并将其下载到您的主板。生成演示并下载到主板后，该演示应自动运行。

## 问题排查
<a name="cypress54-troubleshooting"></a>
+ 如果您使用的是 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`。

  1. 浏览找到 `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 入门的常规故障排除信息，请参阅[问题排查入门](gsg-troubleshooting.md)。