Amazon FreeRTOS
Qualification Guide

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Creating the Demo Project

After you configure your Amazon FreeRTOS download, you can create an IDE project with the required project structure for the Hello World demo.

Follow the instructions below to create an IDE project with the required IDE project structure for demo applications.

Important

If you are using an Eclipse-based IDE, do not configure the project to build all the files in any folder. Instead, add source files to a project by linking to each source file individually.

  1. Create a project named aws_demos and save the project to the projects/vendors/<vendor>/boards/<board>/<ide> directory.

  2. In your IDE, create two virtual folders under aws_demos:

    • application_code

    • config_files

    Under aws_demos, there should now be two virtual subdirectories in the IDE project: application_code and config_files.

    Note

    Eclipse generates an additional includes folder. This folder is not a part of the required structure.

  3. Import all of the folders and files in aws_demos/application_code and its subdirectories into the application_code virtual folder in your IDE.

  4. Import all of the files from aws_demos/config_files into the config_files virtual folder in your IDE.

  5. Import all of the folders and files from the following directories into the application_code virtual folder in your IDE:

    • <amazon-freertos>/demos/demo_runner

    • <amazon-freertos>/demos/mqtt

    • <amazon-freertos>/demos/logging

    • <amazon-freertos>/libraries/.../provisioning/src

  6. Import the <amazon-freertos>/demos/include directory and its contents into the application_code virtual folder in your IDE.

  7. Import the following directories and their contents into the aws_demos IDE project:

    Note

    Only import the files and directories that apply to your platform and port.

    • <amazon-freertos>/libraries

    • <amazon-freertos>/freertos_kernel

    • <amazon-freertos>/vendors/<vendor>/boards/<board>/<driver_library>/<driver_library_version>

  8. Open your project's IDE properties, and add the following paths to your compiler's include path:

    • <amazon-freertos>/demos/include

    • <amazon-freertos>/freertos_kernel/portable/<compiler>/<architecture>

    • <amazon-freertos>/libraries/3rdparty/mbedtls/include

    • <amazon-freertos>/vendors/<vendor>/boards/<board>/aws_demos/config_files

    • Any paths required for vendor-supplied driver libraries.