本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Cypress CYW954907AEVAL1F 開發套件入門
<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)。 FreeRTOS 

本教學課程提供 Cypress CYW954907AEVAL1F 開發套件入門的指示。如果您沒有 Cypress CYW954907AEVAL1F 開發套件，請造訪 AWS Partner Device Catalog，向我們的[合作夥伴](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！ 中的部落格項目 Symlinks](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)，Cypress 的 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 UI 的安裝路徑。在 Windows 和 macOS 中，系統依預設會在 `Documents` 資料夾中為軟體開發套件建立 `WICED-Studio-m.n` 資料夾。

**在 Windows 上建立環境變數**

1. 開啟 **Control Panel (控制台)** 並選擇 **System (系統)**，接著選擇 **Advanced System Settings (進階系統設定)**。

1. 在 **Advanced (進階)** 索引標籤上，選擇 **Environment Variables (環境變數)**。

1. 在 **User variables (使用者變數)** 下方，選擇 **New (新增)**。

1. 在 **Variable name (變數名稱)** 中，輸入 **WICED\$1STUDIO\$1SDK\$1PATH**。在 **Variable value (變數值)** 中，輸入 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 用戶端訂閱 AWS IoT MQTT 主題**

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

1. 在導覽窗格中，選擇**測試**，然後選擇 **MQTT 測試用戶端**以開啟 MQTT 用戶端。

1. 在**訂閱主題**中輸入 ***your-thing-name*/example/topic**，然後選擇**訂閱主題**。

## 建置並執行 FreeRTOS 示範專案
<a name="cypress54-build-and-run-example"></a>

設定電路板的序列連線後，您可以建置 FreeRTOS 示範專案、將示範刷到電路板，然後執行示範。

**在 WICED Studio 中建置和執行 FreeRTOS 示範專案**

1. 啟動 WICED Studio。

1. 從 **File (檔案)** 功能表中，選擇 **Import (匯入)**。展開 `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. 在 **Make Target (製作目標)** 視窗中，展開 **aws\$1demo**，以滑鼠右鍵按一下 `demo.aws_demo` 檔案，然後選擇 **Build Target (建置目標)** 來建置示範並將其下載至您的主機板。示範應會在建置和下載到您的主機板後自動執行。

## 疑難排解
<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)。