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

# 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)

本教程提供有关 NXP LPC54018 IoT Module 入门的说明。如果您没有恩智浦 LPC54018 物联网模块，请访问 AWS 合作伙伴设备目录，从我们的[合作伙伴](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**
+ 将您的计算机连接到 NXP LPC54018 上的 USB 端口。

**设置 JTAG Debugger**

您需要使用 JTAG 调试器来启动并调试在 NXP LPC54018 主板上运行的代码。FreeRTOS 已使用 OM40006 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 Module 调试器，则使用转换电缆将 20 针连接器从调试器连接到 NXP IoT Module 上的 10 针连接器。

1. 使用迷你 USB 转 USB 线缆，将 NXP LPC54018 和 OM40006 IoT Module 调试器连接到计算机上的 USB 端口。

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

FreeRTOS 支持 NXP LPC54018 IoT Module 的两个 IDE：IAR Embedded Workbench 和 MCUXpresso。

在开始之前，请安装其中一个 IDE。

**安装 IAR Embedded Workbench for ARM**

1. 浏览[适用于 ARM 的 IAR Embedded Workbench](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 (MCUXpresso 开发工具包)](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. 在 “**看板**” 下，选择**LPC54018-IoT-Module**。

1. 验证硬件详细信息，然后选择 **Build MCUXepresso SDK (生成 MCUXepresso 开发工具包)**。

1. 使用 MCUXpresso IDE 的适用于 Windows 的开发工具包已生成。选择 **Download SDK**。如果您在使用其他操作系统，在 **Host OS (主机操作系统)** 下，选择您的操作系统，然后选择 **Download SDK (下载开发工具包)**。

1. 启动 MCUXpresso IDE，然后选择 **Installed SDKs (已安装开发工具包)** 选项卡。

1. 将下载的开发工具包存档文件拖放到 **Installed SDKs (已安装开发工具包)** 窗口中。

如果您在安装期间遇到问题，请参阅 [NXP 技术支持](https://www.nxp.com/support/support:SUPPORTHOME?tid=sbmenu)或 [NXP 开发人员资源](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 IoT MQTT 客户端**

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

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

1. 在 **Subscription topic (订阅主题)**中，输入 **{{your-thing-name}}/example/topic**，然后选择 **Subscribe to 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\_demos.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 (项目)** 菜单，选择 **Build (生成)**。

1. 从 **Project (项目)** 菜单，选择 **Download and Debug (下载并调试)**。

1. 从 **Debug (调试)** 菜单，选择 **Start Debugging (启动调试)**。

1. 当调试器在 `main` 中的断点停止时，从 **Debug (调试)** 菜单中选择 **Go (执行)**。
**注意**  
如果打开 “**J-Link 设备选择**” 对话框，请选择 “**确定”** 继续。在 “**目标设备设置**” 对话框中，选择 “**未指定**”，选择 **Cortex-M4**，然后选择 “**确定”**。这些操作只需要执行一次。

**使用 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_cn/freertos/latest/userguide/images/reset.png) 可重置调试会话。（这是必需的，因为 mcuxPresso 的调试器存在错误）。 NXP54018-IoT-Module

1. 当调试器在 `main()` 中的断点停止时，从 **Debug (调试)** 菜单中选择 **Go (执行)**。

## 问题排查
<a name="getting_started_nxp_troubleshooting"></a>

有关 FreeRTOS 入门的常规故障排除信息，请参阅[问题排查入门](gsg-troubleshooting.md)。