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

# NXP LPC54018 IoT Module 入門
<a name="getting_started_nxp"></a>

**重要**  <a name="deprecation-message"></a>
此參考整合託管在已棄用的 Amazon-FreeRTOS 儲存庫上。我們建議您在建立新專案時從[這裡開始](freertos-getting-started-modular.md)。如果您已經有以現在已棄用的 Amazon-FreeRTOS 儲存庫為基礎的現有 FreeRTOS 專案，請參閱 [Amazon-FreeRTOS Github 儲存庫遷移指南](github-repo-migration.md)。 FreeRTOS 

本教學課程提供 NXP LPC54018 IoT 模組的入門指示。如果您沒有 NXP LPC54018 IoT 模組，請造訪 AWSPartner Device Catalog 向[我們的合作夥伴](https://devices.amazonaws.com/detail/a3G0L00000AANtAUAX/LPC54018-IoT-Solution)購買。使用 USB 纜線將 NXP LPC54018 IoT Module 接到您的電腦。

開始之前，您必須設定 AWS IoT和 FreeRTOS 下載，將您的裝置AWS連線至 雲端。如需說明，請參閱 [首要步驟](freertos-prereqs.md)。在本教學課程中，FreeRTOS 下載目錄的路徑稱為 `freertos`。

## 概觀
<a name="w2aac31b9b7c25c42c11"></a>

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

1. 將主機板連線到主機機器。

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

1. 將 FreeRTOS 示範應用程式跨編譯至二進位映像。

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

## 設定 NXP 硬體
<a name="nxp-setup-hardware"></a>

**設定 NXP LPC54018**
+ 將您的電腦連接到 LPC54018 NXP 上的 USB 連接埠。

**設定 JTAG 偵錯工具**

您需要 JTAG 除錯器才能啟動和除錯在 NXP LPC54018 主機板上執行的程式碼。FreeRTOS 已使用 OM40006 IoT 模組進行測試。如需支援偵錯工具的詳細資訊，請參閱 OM40*007 LPC54018 IoT 模組產品頁面提供的 NXP LPC54018 IoT 模組使用手冊*。 [ OM40007 LPC54018 IoT ](https://www.nxp.com/products/processors-and-microcontrollers/arm-microcontrollers/general-purpose-mcus/lpc54018-iot-module-for-the-lpc540xx-family-of-mcus:OM40007) 

1. 如果您使用的是 OM40006 IoT 模組除錯器，請使用轉換器纜線，才能從除錯器 20 pin 的連接器接到 NXP IoT 模組的 10 pin 連接器。

1. 使用 mini-USB 對 USB 纜線，將 NXP LPC54018 和 OM40006 IoT 模組除錯器接到電腦的 USB 連接埠。

## 設定開發環境
<a name="setup-env_nxp"></a>

FreeRTOS 支援 NXP LPC54018 IoT 模組的兩個 IDEs：IAR Embedded Workbench 和 MCUXpresso。

開始之前，請先安裝其中一種 IDE。

**安裝 IAR Embedded Workbench for ARM**

1. 瀏覽至 [ IAR Embedded Workbench for ARM](https://www.iar.com/iar-embedded-workbench/#!?architecture=Arm) 並下載軟體。
**注意**  
IAR Embedded Workbench for ARM 必須使用 Microsoft Windows。

1. 執行安裝程式並依照提示操作。

1. 在 **License Wizard (授權精靈)** 中，選擇 **Register with IAR Systems to get an evaluation license (註冊 IAR 系統以取得評估授權)**。

1. 在嘗試執行任何示範之前，請先將開機載入器放在裝置上。

**從 NXP 安裝 MCUXpresso**

1. 從 [NXP](https://www.nxp.com/support/developer-resources/software-development-tools/mcuxpresso-software-and-tools/mcuxpresso-integrated-development-environment-ide:MCUXpresso-IDE) 下載並執行 MCUXpresso 安裝程式。
**注意**  
支援 10.3.x 版和更新版本。

1. 瀏覽至 [MCUXpresso SDK](https://www.nxp.com/support/developer-resources/software-development-tools/mcuxpresso-software-and-tools/mcuxpresso-software-development-kit-sdk:MCUXpresso-SDK)，然後選擇 **Build your SDK (建置您的軟體開發套件)**。
**注意**  
支援 2.5 版和更新版本。

1. 選擇 **Select Development Board (選取電路板)**。

1. 在 **Select Development Board (選取電路板)** 下方的 **Search by Name (依名稱搜尋)** 中，輸入 **LPC54018-IoT-Module**。

1. 在 **Boards (電路板)** 中，選擇 **LPC54018-IoT-Module (LPC54018 IoT 模組)**。

1. 驗證硬體詳細資訊，然後選擇 **Build MCUXepresso SDK (建置 MCUXepresso 軟體開發套件)**。

1. 已建置使用 MCUXpresso IDE 的 Windows 軟體開發套件。選擇 **Download SDK (下載軟體開發套件)**。如果您使用其他作業系統，請在 **Host OS (主機作業系統)** 下方，選擇您的作業系統，然後選擇 **Download SDK (下載軟體開發套件)**。

1. 啟動 MCUXpresso IDE，然後選擇 **Installed SDKs (已安裝的軟體開發套件)** 標籤。

1. 將已下載的軟體開發套件封存檔案拖放到 **Installed SDKs (已安裝的軟體開發套件)** 視窗中。

如果您在安裝時遇到問題，請參閱 [NXP Support](https://www.nxp.com/support/support:SUPPORTHOME?tid=sbmenu) 或 [NXP Developer Resources](https://www.nxp.com/support/developer-resources:DEVELOPER_HOME)。

## 監控雲端的 MQTT 訊息
<a name="getting_started_nxp_mqtt_monitoring"></a>

在執行 FreeRTOS 示範專案之前，您可以在 AWS IoT主控台中設定 MQTT 用戶端，以監控裝置傳送至 AWS雲端的訊息。

**使用 MQTT 用戶端訂閱 AWS IoTMQTT 主題**

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

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

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

當示範專案在您的裝置上成功執行時，您會看到「Hello World！」 多次傳送到您訂閱的主題。

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

### 將 FreeRTOS 示範匯入 IDE
<a name="nxp-freertos-import-project"></a><a name="nxp-load-project"></a>

**將 FreeRTOS 範例程式碼匯入 IAR Embedded Workbench IDE**

1. 開啟 IAR Embedded Workbench，並從 **File (檔案)** 功能表中，選擇 **Open Workspace (開啟工作空間)**。

1. 在 **search-directory (搜尋目錄)** 文字方塊中，輸入 `projects/nxp/lpc54018iotmodule/iar/aws_demos`，然後選擇 **aws\$1demos.eww**。

1. 在 **Project (專案)** 功能表中，選擇 **Rebuild All (全部重建)**。

**將 FreeRTOS 範例程式碼匯入 MCUXpresso IDE**

1. 開啟 MCUXpresso，並從 **File (檔案)** 功能表中，選擇 **Open Projects From File System (從檔案系統開啟專案)**。

1. 在 **Directory (目錄)** 文字方塊中，輸入 `projects/nxp/lpc54018iotmodule/mcuxpresso/aws_demos`，然後選擇 **Finish (完成)**

1. 在 **Project (專案)** 功能表中，選擇 **Build All (全部建置)**。

### 執行 FreeRTOS 示範專案
<a name="nxp-run-example"></a>

**使用 IAR Embedded Workbench IDE 執行 FreeRTOS 示範專案**

1. 在您 IDE 的 **Project (專案)** 功能表中，選擇 **Make (Make)**。

1. 從 **Project (專案)** 功能表中，選擇 **Download and Debug (下載並除錯)**。

1. 在 **Debug (除錯)** 功能表中，選擇 **Start Debugging (開始除錯)**。

1. 當除錯器停在 `main` 中斷點時，請從 **Debug (除錯)** 功能表，選擇 **Go (開始)**。
**注意**  
如果 **J-Link Device Selection (J-Link 選取裝置)** 對話方塊開啟，請選擇 **OK (確認)** 以繼續。在 **Target Device Settings (目標裝置設定)** 對話方塊中，選擇 **Unspecified (未指定)** 和 **Cortex-M4**，然後選擇 **OK (確認)**。您只需要執行此步驟一次。

**使用 MCUxpresso IDE 執行 FreeRTOS 示範專案**

1. 在您 IDE 的 **Project (專案)** 功能表中，選擇 **Build (建置)**。

1. 如果這是您第一次除錯，請選擇 `aws_demos` 專案，並從 **Debug (除錯)** 工具列，選擇藍色除錯按鈕。

1. 隨即顯示任何偵測到的除錯探查。選擇您想要使用的探查，然後選擇 **OK (確認)** 開始除錯。
**注意**  
當除錯器停在 `main()` 中斷點時，請按一下重新啟動除錯按鈕 ![\[Colorful logo with overlapping circles representing cloud services integration.\]](http://docs.aws.amazon.com/zh_tw/freertos/latest/userguide/images/reset.png) 以重新啟動除錯工作階段。(這是必要的步驟，因為適用於 NXP54018 IoT 模組的 MCUXpresso 除錯器有錯誤)。

1. 當除錯器停在 `main()` 中斷點時，請從 **Debug (除錯)** 功能表，選擇 **Go (開始)**。

## 疑難排解
<a name="getting_started_nxp_troubleshooting"></a>

如需 FreeRTOS 入門的一般疑難排解資訊，請參閱 [故障診斷入門](gsg-troubleshooting.md)。