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

# 开始使用恩智浦 LPC54018 物联网模块
<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)。

本教程提供了开始使用恩智浦 LPC54018 物联网模块的说明。如果您没有恩智浦 LPC54018 物联网模块，请访问 AWS 合作伙伴设备目录，从我们的[合作伙伴](https://devices.amazonaws.com/detail/a3G0L00000AANtAUAX/LPC54018-IoT-Solution)处购买一个。使用USB线将恩智浦 LPC54018 物联网模块连接到电脑。

在开始之前，您必须进行配置 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>

**设置恩智浦 LPC54018**
+ 将您的电脑连接到恩智浦 LPC54018的USB端口。

**设置 JTAG Debugger**

你需要一个JTAG调试器来启动和调试在恩 LPC54018智浦主板上运行的代码。FreeRTOS 使用物联网模块进行了测试。 OM40006 [有关支持的调试器的更多信息，请参阅物联网模块产品页面上的《*恩智浦物 LPC54018 联网模块用户手册*》 OM40007 LPC54018 。](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 物联网模块调试器，请使用转换器电缆将调试器的 20 针接头连接到恩智浦物联网模块上的 10 针接头。

1. 使用mini-USB转USB电缆将恩智浦 LPC54018 和 OM40006 物联网模块调试器连接到计算机上的USB端口。

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

FreeRTOS支持 IDEs 两个恩智浦 LPC54018 物联网模块：IAR嵌入式工作台和嵌入式工作台。 MCUXpresso

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

**安装 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. 在尝试运行任何演示之前，将引导加载程序置于设备上。

**要 MCUXpresso 从恩智浦安装**

1. 从[恩智浦](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)，然后选择 “**构建你的 SDK”。**
**注意**  
支持版本 2.5 及更高版本。

1. 选择 **Select Development Board (选择开发主板)**。

1. 在 **Select Development Board (选择开发主板)** 的 **Search by Name (按名称搜索)** 中，输入 **LPC54018-IoT-Module**。

1. 在 “**主板**” 下，选择 **LPC54018-IoT 模**块。

1. 验证硬件详细信息，然后选择 B **uild MCUXepresso SDK**。

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

1. 启动 MCUXpresso IDE，然后选择 “**已安装 SDKs**” 选项卡。

1. 将下载的 SDK 存档文件拖放到 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 客户端订阅 M AWS IoT QTT 主题**

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\$1demos.eww**。

1. 从 **Project (项目)** 菜单，选择 **Rebuild All (全部重新生成)**。

**将 FreeRTOS 示例代码导入 IDE MCUXpresso**

1. 打开 MCUXpresso，然后从 “**文件**” 菜单中选择 “**从文件系统打开项目**”。

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 Device Selection (J-Link 设备选择)** 对话框，请选择 **OK (确定)** 以继续。在 **Target Device Settings (目标设备设置)** 对话框中，依次选择 **Unspecified (未指定)**、**Cortex-M4** 和 **OK (确定)**。这些操作只需要执行一次。

**使用 IDE 运行 FreeRTOS 演示项目 MCUxpresso**

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) 可重置调试会话。（这是必需的，因为 NXP54018-IOT-Module 的 MCUXpresso 调试器存在错误）。

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

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

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