Amazon FreeRTOS
User Guide

Amazon FreeRTOS Console User Guide

Managing Amazon FreeRTOS Configurations

You can use the Amazon FreeRTOS console to manage software configurations and download Amazon FreeRTOS software for your device. The Amazon FreeRTOS software is prequalified on a variety of platforms. It includes the required hardware drivers, libraries, and example projects to help get you started quickly. You can choose between predefined configurations or create custom configurations.

Predefined Amazon FreeRTOS Configurations

Predefined configurations are defined for the prequalified platforms:

  • TI CC3220SF-LAUNCHXL

  • STM32 IoT Discovery Kit

  • NXP LPC54018 IoT Module

  • Microchip Curiosity PIC32MZEF

  • Espressif ESP32-DevKitC

  • Espressif ESP3-WROVER-KIT

  • Infineon XMC4800 IoT Connectivity Kit

  • Xilinx Avnet MicroZed Industrial IoT Starter Kit

  • FreeRTOS Windows Simulator

The predefined configurations make it possible for you to get started quickly with the supported use cases without thinking about which libraries are required. To use a predefined configuration, browse to the Amazon FreeRTOS console, find the configuration you want to use, and then choose Download.

You can also customize a predefined configuration if you want to change the Amazon FreeRTOS version, hardware platform, or libraries of the configuration. Customizing a predefined configuration creates a new custom configuration and does not overwrite the predefined configuration in the Amazon FreeRTOS console.

To create a custom configuration from a predefined configuration

  1. Browse to the Amazon FreeRTOS console.

  2. In the navigation pane, choose Software.

  3. Under Amazon FreeRTOS Device Software, choose Configure download.

  4. Choose the ellipsis next to the predefined configuration that you want to customize, and then choose Customize.

  5. On the Configure Amazon FreeRTOS Software page, choose the Amazon FreeRTOS version, hardware platform, and libraries, and give the new configuration a name and a description.

  6. At the bottom of the page, choose Create and download to create and download the custom configuration.

Custom Amazon FreeRTOS Configurations

Custom configurations allow you to specify your hardware platform, integrated development platform (IDE), compiler, and only those RTOS libraries you require. This leaves more space on your devices for application code.

To create a custom configuration

  1. Browse to the Amazon FreeRTOS console and choose Create new.

  2. Select the version of Amazon FreeRTOS that you want to use. The latest version is used by default.

  3. On the New Software Configuration page, choose Select a hardware platform, and choose one of the prequalified platforms.

  4. Choose the IDE and compiler you want use.

  5. For the Amazon FreeRTOS libraries you require, choose Add Library. If you choose a library that requires another library, it is added for you. If you want to choose more libraries, choose Add another library.

  6. In the Demo Projects section, enable one of the demo projects. This enables the demo in the project files.

  7. In Name required, enter a name for your custom configuration.

    Note

    Do not use any personally identifiable information in your custom configuration name.

  8. In Description, enter a description for your custom configuration.

  9. At the bottom of the page, choose Create and download to create and download your custom configuration.

To edit a custom configuration

  1. Browse to the Amazon FreeRTOS console.

  2. In the navigation pane, choose Software.

  3. Under Amazon FreeRTOS Device Software, choose Configure download.

  4. Choose the ellipsis next to the configuration you want to edit, and then choose Edit.

  5. On the Configure Amazon FreeRTOS Software page, you can change your configuration's Amazon FreeRTOS version, hardware platform, libraries, and description.

  6. At the bottom of the page, choose Save and download to save and download the configuration.

To delete a custom configuration

  1. Browse to the Amazon FreeRTOS console.

  2. In the navigation pane, choose Software.

  3. Under Amazon FreeRTOS Device Software, choose Configure download.

  4. Choose the ellipsis next to the configuration you want to delete, and then choose Delete.