Cypress CYW954907AEVAL1F 開發套件入門 - FreeRTOS
概要設定開發環境建立序列連線監控雲端的 MQTT 訊息建置並執行 FreeRTOS 示範專案疑難排解

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

Cypress CYW954907AEVAL1F 開發套件入門

重要

此參考集成託管在亞馬遜的 FreeRTOS 存儲庫上，該存儲庫已被棄用。建議您在建立新的專案時，從這裡開始建立新的專案。如果您已經有一個現有的 FreeRTOS 專案以目前已取代的亞馬遜免費伺服器儲存庫為基礎，請參閱亞馬遜自由 Github 存儲庫遷移指南.

本教學課程提供 Cypress CYW954907AEVAL1F 開發套件入門的指示。如果您沒有 Cypress CYW954907AEVAL1F 開發套件，請造訪 AWS Partner Device Catalog，向我們的合作夥伴購買。

注意

此教學課程會帶您逐步說明如何設定並執行 CoremQtt 相互驗證的設定並執行 CoremQtt 此主機板的 FreeRTOS 連接埠目前不支援 TCP 伺服器和用戶端示範。

在開始之前，您必須先設定 FreeRTOSAWS IoT 並下載，才能將裝置連線到AWS雲端。如需說明，請參閱 首要步驟。在此教學課程中，FreeRTOS 下載目錄的路徑稱為freertos。

重要

  • 在本主題中，FreeRTOS 下載目錄的路徑稱為freertos。

  • freertos 路徑中的空格字元可能會導致建置失敗。當您複製或拷貝儲存庫時，請確定您建立的路徑不包含空格字元。

  • Microsoft Windows 的檔案路徑長度上限為 260 個字元。長 FreeRTOS 下載目錄路徑可能會導致建置失敗。

  • 由於原始程式碼可能包含符號連結，因此如果您使用 Windows 來擷取歸檔，您可能必須：

    • 啟用開發人員模式，或

    • 使用以系統管理員身分提高權限的主控台。

    如此一來，Windows 可以在擷取歸檔時正確建立符號連結。否則，符號鏈接將被寫入為普通文件，其中包含符號鏈接的路徑作為文本或為空。如需詳細資訊，請參閱部落格條目部落格條目：部落格條目文章： 。

    如果您在 Windows 下使用 Git，您必須啟用開發人員模式，或者您必須：

    • 使用下列命令設定core.symlinks為 true：

      git config --global core.symlinks true

    • 每當您使用寫入系統的 git 命令時，請使用以管理員身份提升的主控台 (例如git pullgit clone、、和git submodule update --init --recursive)。

  • 如中所述下載 FreeRTOS，Cypress 的 FreeRTOS 連接埠目前僅適用於 GitHub。

概要

本教學課程包含以下入門步驟的指示：

  1. 在主機機器上安裝軟體以對微控制器主機板的內嵌應用程式進行開發和除錯。

  2. 將 FreeRTOS 示範應用程式交叉編譯為二進位映像檔。

  3. 將應用程式二進位映像載入主機板，然後執行應用程式。

  4. 透過序列連線與在開發板上執行的應用程式互動，以便進行監控和除錯。

設定開發環境

下載並安裝 WICED Studio 軟體開發套件

在這份入門指南中，您可以使用賽普拉斯 WICED 工作室 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 UI 的安裝路徑。在 Windows 和 macOS 中，系統依預設會在 Documents 資料夾中為軟體開發套件建立 WICED-Studio-m.n 資料夾。

在 Windows 上建立環境變數

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

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

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

  4. 在 Variable name (變數名稱) 中，輸入 WICED_STUDIO_SDK_PATH。在 Variable value (變數值) 中，輸入 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 示範專案之前，您可以在主控台中設定 MQTT 用戶端，以監AWS IoT控裝置傳送至AWS雲端的訊息。

使用 AWS IoT MQTT 用戶端訂閱 MQTT 主題

  1. 登入 AWS IoT 主控台。

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

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

建置並執行 FreeRTOS 示範專案

在您設定主機板的序列連線之後，您可以建置 FreeRTOS 示範專案，將示範快閃到您的主機板，然後執行示範。

在 WICED 工作室中構建和運行 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 入門的一般疑難排解資訊，請參閱故障診斷入門。