Amazon FreeRTOS
User Guide

Getting Started with the NXP LPC54018 IoT Module

This tutorial provides instructions for getting started with the NXP LPC54018 IoT Module. If you do not have an NXP LPC54018 IoT Module, visit the AWS Partner Device Catalog to purchase one from our partner. Use a USB cable to connect your NXP LPC54018 IoT Module to your computer.

Before you begin, you must configure AWS IoT and your Amazon FreeRTOS download to connect your device to the AWS Cloud. See First Steps for instructions. In this tutorial, the path to the Amazon FreeRTOS download directory is referred to as <amazon-freertos>.

Overview

This tutorial contains instructions for the following getting started steps:

  1. Connecting your board to a host machine.

  2. Installing software on the host machine for developing and debugging embedded applications for your microcontroller board.

  3. Cross compiling an Amazon FreeRTOS demo application to a binary image.

  4. Loading the application binary image to your board, and then running the application.

Set Up the NXP Hardware

To set up the NXP LPC54018

  • Connect your computer to the USB port on the NXP LPC54018.

To set up the JTAG Debugger

You need a JTAG debugger to launch and debug your code running on the NXP LPC54018 board. Amazon FreeRTOS was tested using a Segger J-Link probe. For more information about supported debuggers, see the User Manual for NXP LPC54018 IoT Module that is available from the OM40007 LPC54018 IoT Module product page.

  1. If you are using a Segger J-Link debugger, use a converter cable to connect the 20-pin connector from the debugger to the 10-pin connector on the NXP IoT module.

  2. Connect the NXP LPC54018 and the Segger J-Link Debugger to the USB ports on your computer using mini-USB to USB cables.

Set Up Your Development Environment

Amazon FreeRTOS supports two IDEs for the NXP LPC54018 IoT Module: IAR Embedded Workbench and MCUXpresso.

Before you begin, install one of these IDEs.

To install IAR Embedded Workbench for ARM

  1. Browse to Software for NXP Kits and choose Download Software.

    Note

    IAR Embedded Workbench for ARM requires Microsoft Windows.

  2. Unzip and run the installer. Follow the prompts.

  3. In the License Wizard, choose Register with IAR Systems to get an evaluation license.

To install MCUXpresso from NXP

  1. Download and run the MCUXpresso installer from NXP.

    Note

    Versions 10.3.x and later are supported.

  2. Browse to MCUXpresso SDK and choose Build your SDK.

    Note

    Versions 2.5 and later are supported.

  3. Choose Select Development Board.

  4. Under Select Development Board, in Search by Name, enter LPC54018-IoT-Module.

  5. Under Boards, choose LPC54018-IoT-Module.

  6. Verify the hardware details, and then choose Build MCUXepresso SDK.

  7. The SDK for Windows using the MCUXpresso IDE is already built. Choose Download SDK. If you are using another operating system, under Host OS, choose your operating system, and then choose Download SDK.

  8. Start the MCUXpresso IDE, and choose the Installed SDKs tab.

  9. Drag and drop the downloaded SDK archive file into the Installed SDKs window.

If you experience issues during installation, see NXP Support or NXP Developer Resources.

Build and Run the Amazon FreeRTOS Demo Project

Import the Amazon FreeRTOS Demo into Your IDE

To import the Amazon FreeRTOS sample code into the IAR Embedded Workbench IDE

  1. Open IAR Embedded Workbench, and from the File menu, choose Open Workspace.

  2. In the search-directory text box, enter projects/nxp/lpc54018iotmodule/iar/aws_demos, and choose aws_demos.eww.

  3. From the Project menu, choose Rebuild All.

To import the Amazon FreeRTOS sample code into the MCUXpresso IDE

  1. Open MCUXpresso, and from the File menu, choose Open Projects From File System.

  2. In the Directory text box, enter projects/nxp/lpc54018iotmodule/mcuxpresso/aws_demos, and choose Finish

  3. From the Project menu, choose Build All.

Run the Amazon FreeRTOS Demo Project

To run the Amazon FreeRTOS demo project with the IAR Embedded Workbench IDE

  1. In your IDE, from the Project menu, choose Make.

  2. From the Project menu, choose Download and Debug.

  3. From the Debug menu, choose Start Debugging.

  4. When the debugger stops at the breakpoint in main, from the Debug menu, choose Go.

    Note

    If a J-Link Device Selection dialog box opens, choose OK to continue. In the Target Device Settings dialog box, choose Unspecified, choose Cortex-M4, and then choose OK. You only need to be do this once.

To run the Amazon FreeRTOS demo project with the MCUxpresso IDE

  1. In your IDE, from the Project menu, choose Build.

  2. If this is your first time debugging, choose the aws_demos project and from the Debug toolbar, choose the blue debug button.

  3. Any detected debug probes are displayed. Choose the probe you want to use, and then choose OK to start debugging.

    Note

    When the debugger stops at the breakpoint in main(), press the debug restart button once to reset the debugging session. (This is required due to a bug with MCUXpresso debugger for NXP54018-IoT-Module).

  4. When the debugger stops at the breakpoint in main(), from the Debug menu, choose Go.

Monitoring MQTT Messages on the Cloud

You can use the MQTT client in the AWS IoT console to monitor the messages that your device sends to the AWS Cloud.

To subscribe to the MQTT topic with the AWS IoT MQTT client

  1. Sign in to the AWS IoT console.

  2. In the navigation pane, choose Test to open the MQTT client.

  3. In Subscription topic, enter iotdemo/#, and then choose Subscribe to topic.

Troubleshooting

For general troubleshooting information about Getting Started with Amazon FreeRTOS, see Troubleshooting Getting Started.