Amazon FreeRTOS
User Guide

Getting Started with Amazon FreeRTOS

This Getting Started with Amazon FreeRTOS tutorial shows you how to download and configure Amazon FreeRTOS on a host machine, and then compile and run a simple demo application on a qualified microcontroller board.

Throughout this tutorial, we assume that you are familiar with AWS IoT and the AWS IoT console. If not, we recommend that you complete the AWS IoT Getting Started tutorial before you continue.

Amazon FreeRTOS Demo Application

The demo application in this tutorial is the Hello World MQTT demo defined in the /demos/common/mqtt/aws_hello_world.c file. It uses the Amazon FreeRTOS MQTT library to connect to the AWS Cloud and then periodically publish messages to an MQTT topic hosted by the AWS IoT MQTT broker.

Only a single Amazon FreeRTOS demo application can run at a time. When you build an Amazon FreeRTOS demo project, the first demo enabled in the demos/common/demo_runner/aws_demo_runner.c file is the application that runs. For this tutorial, you do not need to enable or disable any demos. The Hello World MQTT demo is enabled by default.

For more information about the demo applications included with Amazon FreeRTOS, see Amazon FreeRTOS Demos.

First Steps

To get started, see First Steps.

Board-specific Getting Started Guides

After you complete the First Steps, you can set up your platform's hardware and its software development environment, and then compile and run the demo on your board. For board-specific instructions, see the Board-specific Getting Started Guides.


For help troubleshooting any issues that you encounter while getting started, see Troubleshooting Getting Started. For board-specific troubleshooting tips, see the Getting Started guide for your board in Board-specific Getting Started Guides.