開始使用新唐 NuMaker-IOT M487 系列產品 - FreeRTOS
概要設定開發環境建置並執行 FreeRTOS 示範專案搭配使用 FreeRTOS 體疑難排解

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

開始使用新唐 NuMaker-IOT M487 系列產品

重要

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

本教學提供如何開始使用新唐 NuMaker-IOT-M487 開發板的操作說明。該系列微控制器，並包括內置 RJ45 以太網和 Wi-Fi 模塊。如果您沒有新唐 NuMaker-IOT-M487，請造訪AWS合作夥伴裝置目錄，向我們的合作夥伴購買。

在開始之前，您必須先AWS IoT設定 FreeRTOS 軟體，才能將開發板連線到AWS雲端。如需相關指示，請參閱首要步驟。在此教學課程中，FreeRTOS 下載目錄的路徑稱為freertos。

概要

本教學課程將指引您完成下列步驟：

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

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

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

設定開發環境

Keil MDK Nuvoton 版本是適用於 Nuvoton M487 專為開發和偵錯的應用程式。Keil MDK v5 Essential、Plus 或 Pro 版本也應該適用於 Nuvoton M487 (Cortex-M4 核心) MCU。您可以下載 Keil MDK Nuvoton 版本，並獲得 Nuvoton Cortex-M4 系列 MCU 的價格折扣。Keil MDK 僅支援 Windows。

若要安裝 NuMaker-IOT M487 的開發工具

  1. 從 Keil MDK 網站下載 Keil MDK Nuvoton 版本。

  2. 在您的主機上使用授權安裝 Keil MDK。Keil MDK 包含 Keil µVision IDE、C/C++ 編譯工具鏈以及 µVision 除錯器。

    如果您在安裝期間遇到問題，請聯絡 Nuvoton 尋求協助。

  3. 安裝新唐開發工具頁面上的 NU L 連結驅動程式 (或最新版本)。

建置並執行 FreeRTOS 示範專案

若要建置 FreeRTOS 示範專案

  1. 開啟 Keil µVision IDE。

  2. 在 File (檔案) 功能表上，選擇 Open (開啟)。在 Open file (開啟檔案) 對話方塊中，確定檔案類型選擇器設定為 Project Files (專案檔案)。

  3. 選擇要建置的 Wi-Fi 或乙太網路示範專案。

    • 若要開啟 Wi-Fi 示範專案，請在 freertos\projects\nuvoton\numaker_iot_m487_wifi\uvision\aws_demos 目錄中選擇目標專案 aws_demos.uvproj。

    • 若要開啟乙太網路示範專案，請在 freertos\projects\nuvoton\numaker_iot_m487_wifi\uvision\aws_demos_eth 目錄中選擇目標專案 aws_demos_eth.uvproj。

  4. 為確保您的設定正確以刷入主機板，請在 IDE 中以滑鼠右鍵按一下 aws_demo 專案，然後選擇 Options (選項)。(請參閱 疑難排解 獲得詳細資訊。)

  5. 在 Utilities (公用程式) 標籤上，確認 Use Target Driver for Flash Programming (使用目標驅動程式進行 Flash 程式設計) 已選取，且 Nuvoton Nu-Link Debugger 已設為目標驅動程式。

  6. 在 Debug (除錯) 索引標籤的 Nuvoton Nu-Link Debugger (Nuvoton Nu-Link 除錯器) 旁，選擇 Settings (設定)。

  7. 確認 Chip Type (晶片類型) 設定為 M480。

  8. 在 Keil µVision IDE Project (Keil µVision IDE 專案) 導覽窗格中，選擇 aws_demos 專案。在 Project (專案) 功能表中，選擇 Build Target (建置目標)。

您可以在 AWS IoT 主控台中使用 MQTT 用戶端來監控裝置傳送至 AWS 雲端的訊息。

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

  1. 登入 AWS IoT 主控台。

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

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

執行執行執行 FreeRTOS 行免費

  1. 將 Numaker-IoT-M487 主機板連接到主機 (電腦)。

  2. 重新建置專案。

  3. 在 Keil µVision IDE 的 Flash 功能表上，選擇 Download (下載)。

  4. 在 Debug (偵錯) 選單上，選擇 Start/Stop Debug Session (啟動/停止偵錯工作階段)。

  5. 當除錯器停在中斷點 main() 時，開啟 Run (執行) 功能表，然後選擇 Run (執行) (F5))。

    在 AWS IoT 主控台的 MQTT 用戶端中，應該會顯示您裝置傳送的 MQTT 訊息。

搭配使用 FreeRTOS 體

您也可以使用 CMake 來建置和執行 FreeRTOS 示範應用程式或使用協力廠商程式碼編輯器和偵錯工具開發的應用程式。

確定您已安裝 CMake 建置系統。請按照 搭配使用 FreeRTOS 體 中的指示，再遵循本主題中的步驟。

注意

請確定編譯器 (Keil) 位置的路徑位於您的 Path (路徑) 系統變數中，例如 C:\Keil_v5\ARM\ARMCC\bin。

您也可以使用主控台中的 MQTT 用戶端監AWS IoT控裝置傳送至AWS雲端的訊息。

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

  1. 登入 AWS IoT 主控台。

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

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

從來源檔案產生建置檔案並執行示範專案

  1. 在您的主機上，開啟命令提示字元並導覽至 freertos 資料夾。

  2. 建立一個資料夾，其中應包含產生的建置檔案 我們將此資料夾稱為 BUILD_FOLDER。

  3. 產生 Wi-Fi 或乙太網路示範的建置檔案。

    • 若為 Wi-Fi：

      前往內含原始碼 FreeRTOS 的原始碼目錄。然後，執行下列命令來產生建置檔案。

      cmake -DVENDOR=nuvoton -DBOARD=numaker_iot_m487_wifi -DCOMPILER=arm-keil -S . -B BUILD_FOLDER -G Ninja

    • 若為乙太網路：

      前往內含原始碼 FreeRTOS 的原始碼目錄。然後，執行下列命令來產生建置檔案。

      cmake -DVENDOR=nuvoton -DBOARD=numaker_iot_m487_wifi -DCOMPILER=arm-keil -DAFR_ENABLE_ETH=1 -S . -B BUILD_FOLDER -G Ninja

  4. 執行以下命令，產生二進位以刷入至 M487。

    cmake --build BUILD_FOLDER

    此時，二進位檔案 aws_demos.bin 應該位於 BUILD_FOLDER/vendors/Nuvoton/boards/numaker_iot_m487_wifi 資料夾。

  5. 若要將主機板設定為刷入模式，請確保 MSG 切換 (ICE 上 ISW1 的 4 號) 已切換為 ON (開啟)。當您插入主機板時，將會指派一個視窗 (和磁碟機)。(請參閱 疑難排解)。

  6. 開啟終端機模擬器，透過 UART 檢視訊息。按照 安裝終端機模擬器 中的指示進行。

  7. 將產生的二進位檔複製到裝置來執行示範專案。

    如果您使用 AWS IoT MQTT 用戶端訂閱 MQTT 主題，您應該會在 AWS IoT 主控台中看到裝置傳送的 MQTT 訊息

疑難排解

如果您在設定開發環境或連接到主機板時遇到問題，請聯絡 Nuvoton。

在基爾微視野中調試 FreeRTOS 項目

在 Keil μVision 中啟動偵錯工作階段

  1. 開啟 Keil μVision。

  2. 請依照下列步驟在中建置 FreeRTOS 示範專案建置並執行 FreeRTOS 示範專案。

  3. 在 Debug (偵錯) 選單上，選擇 Start/Stop Debug Session (啟動/停止偵錯工作階段)。

    當您啟動偵錯工作階段時，會顯示 Call Stack+Locals 視窗。μVision 會刷入示範至主機板，執行示範，並在 main() 功能開始時停止。

  4. 在專案的原始程式碼中設定中斷點，然後執行程式碼。專案應類似以下所示：

故障診斷 μVision 偵錯設定

如果您在偵錯應用程式時遇到問題，請檢查您的偵錯設定是否在 Keil μVision 中正確設定。

若要驗證「μVision」偵錯設定是否正確

  1. 開啟 Keil μVision。

  2. 在 IDE 中以滑鼠右鍵按一下 aws_demo 專案，然後選擇 Options (選項)。

  3. 在 Utilities (公用程式) 標籤上，確認 Use Target Driver for Flash Programming (使用目標驅動程式進行 Flash 程式設計) 已選取，且 Nuvoton Nu-Link Debugger 已設為目標驅動程式。

  4. 在 Debug (除錯) 索引標籤的 Nuvoton Nu-Link Debugger (Nuvoton Nu-Link 除錯器) 旁，選擇 Settings (設定)。

  5. 確認 Chip Type (晶片類型) 設定為 M480。