Troubleshooting getting started - FreeRTOS

Troubleshooting getting started


This page refers to the Amazon-FreeRTOS repository which is deprecated. We recommend that you start here when you create a new project. If you already have an existing FreeRTOS project based on the now deprecated Amazon-FreeRTOS repository, see the Amazon-FreeRTOS Github Repository Migration Guide.

The following topics can help you troubleshoot issues that you encounter while getting started with FreeRTOS:

For board-specific troubleshooting, see the Getting Started with FreeRTOS guide for your board.

General getting started troubleshooting tips

No messages appear in the AWS IoT console after I run the Hello World demo project. What do I do?

Try the following:

  1. Open a terminal window to view the logging output of the sample. This can help you determine what is going wrong.

  2. Check that your network credentials are valid.

The logs shown in my terminal when running a demo are truncated. How can I increase their length?

Increase the value of configLOGGING_MAX_MESSAGE_LENGTH to 255 in the FreeRTOSconfig.h file for the demo you are running:


Installing a terminal emulator

A terminal emulator can help you diagnose problems or verify that your device code is running properly. There are a variety of terminal emulators available for Windows, macOS, and Linux.

You must connect your board to your computer before you attempt to establish a serial connection to your board with a terminal emulator.

Use the following settings to configure your terminal emulator:

Terminal Setting Value

BAUD rate



8 bit




1 bit

Flow control


Finding your board's serial port

If you do not know your board's serial port, you can issue one of the following commands from the command line or terminal to return the serial ports for all devices connected to your host computer:

ls /dev/tty*
ls /dev/cu.*