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 a FreeRTOS demo application to a binary image.

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

5. Interacting with the application running on your board across a serial connection, for monitoring and debugging purposes.

To download and install Segger Embedded Studio

1. Go to theSegger Embedded Studio Downloads page, and choose the Embedded Studio for ARM option for your operating system.

2. Run the installer and follow the prompts to completion.

To set up the FreeRTOS Bluetooth Low Energy Mobile SDK Demo application

1. Follow the instructions inMobile SDKs for FreeRTOS Bluetooth devices to download and install the SDK for your mobile platform on your host computer.

2. Follow the instructions inFreeRTOS Bluetooth Low Energy Mobile SDK demo application to set up the demo mobile application on your mobile device.

To establish a serial connection with Segger Embedded Studio

1. Open Segger Embedded Studio.

2. From the top menu, chooseTarget,Connect J-Link.

3. From the top menu, chooseTools,Terminal Emulator,Properties, and set the properties as instructed inInstalling a terminal emulator.

4. From the top menu, chooseTools,Terminal Emulator,Connectport (115200,N,8,1).

To configure your AWS IoT endpoint

1. Sign in to theAWS IoT console.

2. In the navigation pane, chooseSettings.

   Your AWS IoT endpoint appears in theDevice data endpoint text box. It should look like1234567890123-ats.iot.us-east-1.amazonaws.com. Make a note of this endpoint.

3. In the navigation pane, chooseManage, and then chooseThings. Make a note of the AWS IoT thing name for your device.

4. With your AWS IoT endpoint and your AWS IoT thing name on hand, openfreertos/demos/include/aws_clientcredential.h in your IDE, and specify values for the following#define constants:

   • clientcredentialMQTT_BROKER_ENDPOINTYour AWS IoT endpoint

   • clientcredentialIOT_THING_NAMEYour board's AWS IoT thing name

To enable the demo

1. Check that the Bluetooth Low Energy GATT Demo is enabled. Go tovendors/nordic/boards/nrf52840-dk/aws_demos/config_files/iot_ble_config.h, and add#define IOT_BLE_ADD_CUSTOM_SERVICES ( 1 ) to the list of define statements.

2. Openvendors/nordic/boards/nrf52840-dk/aws_demos/config_files/aws_demo_config.h, and define eitherCONFIG_OTA_MQTT_BLE_TRANSPORT_DEMO_ENABLED orCONFIG_OTA_HTTP_BLE_TRANSPORT_DEMO_ENABLED as in this example.

   /* To run a particular demo you need to define one of these. * Only one demo can be configured at a time * *          CONFIG_BLE_GATT_SERVER_DEMO_ENABLED *          CONFIG_MQTT_BLE_TRANSPORT_DEMO_ENABLED *          CONFIG_SHADOW_BLE_TRANSPORT_DEMO_ENABLED *          CONFIG_OTA_MQTT_BLE_TRANSPORT_DEMO_ENABLED *          CONFIG_OTA_HTTP_BLE_TRANSPORT_DEMO_ENABLED *          CONFIG_POSIX_DEMO_ENABLED * *  These defines are used in iot_demo_runner.h for demo selection */#define CONFIG_OTA_MQTT_BLE_TRANSPORT_DEMO_ENABLED

3. Since the Nordic chip comes with very little RAM (250KB), the BLE configuration might need to be changed to allow for larger GATT table entries compared to the size of each attribute. In this way you can adjust the amount of memory the application gets. To do this, override the definitions of the following attributes in the filefreertos/vendors/nordic/boards/nrf52840-dk/aws_demos/config_files/sdk_config.h:

   • NRF_SDH_BLE_VS_UUID_COUNT

     The number of vendor-specific UUIDs. Increase this count by 1 when you add a new vendor-specific UUID.

   • NRF_SDH_BLE_GATTS_ATTR_TAB_SIZE

     Attribute Table size in bytes. The size must be a multiple of 4. This value indicates the set amount of memory dedicated for the attribute table (including the characteristic size), so this will vary from project to project. If you exceed the size of the attribute table you will get a NRF_ERROR_NO_MEM error. If you modify the NRF_SDH_BLE_GATTS_ATTR_TAB_SIZE usually you must also reconfigure the RAM settings.

   (For tests, the location of the file isfreertos/vendors/nordic/boards/nrf52840-dk/aws_tests/config_files/sdk_config.h.)

To build and run the FreeRTOS Bluetooth Low Energy demo from Segger Embedded Studio

1. Open Segger Embedded Studio. From the top menu, chooseFile, chooseOpen Solution, and then navigate to the project fileprojects/nordic/nrf52840-dk/ses/aws_demos/aws_demos.emProject

2. If you are using the Segger Embedded Studio terminal emulator, chooseTools from the top menu, and then chooseTerminal Emulator,Terminal Emulator to display information from your serial connection.

   If you are using another terminal tool, you can monitor that tool for output from your serial connection.

3. Right-click theaws_demos demo project in theProject Explorer, and chooseBuild.

   Note

   If this is your first time using Segger Embedded Studio, you might see you a warning "No license for commercial use". Segger Embedded Studio can be used free of charge for Nordic Semiconductor devices.Request a free license then, during setup chooseActivate Your Free License, and follow the instructions.

4. ChooseDebug, and then chooseGo.

   After the demo starts, it waits to pair with a mobile device across Bluetooth Low Energy.

5. Follow the instructions for theMQTT over Bluetooth Low Energy Demo Application to complete the demo with the FreeRTOS Bluetooth Low Energy Mobile SDK demo application as the mobile MQTT proxy.