Amazon FreeRTOS
Porting Guide

Porting the Amazon FreeRTOS Libraries

Before you start porting, follow the instructions in Setting Up Your Amazon FreeRTOS Source Code for Porting.

To port Amazon FreeRTOS to your device, follow the instructions in the topics below.

  1. Implementing the configPRINT_STRING() macro

  2. Configuring a FreeRTOS Kernel Port

  3. Porting the Wi-Fi Library

    Note

    If your device does not support Wi-Fi, you can use an ethernet connection to connect to the AWS Cloud instead. A port of the Amazon FreeRTOS Wi-Fi library is not necessarily required.

  4. Porting a TCP/IP Stack

  5. Porting the Secure Sockets Library

  6. Porting the PKCS #11 Library

  7. Porting the TLS Library

  8. Configuring the MQTT Library for Testing

  9. Configuring the HTTPS Client Library for Testing

    Note

    A port of the Amazon FreeRTOS HTTPS library is currently not required for qualification.

  10. Porting the OTA Library

    Note

    A port of the Amazon FreeRTOS OTA update library is currently not required for qualification.

  11. Porting the Bluetooth Low Energy Library

    Note

    A port of the Amazon FreeRTOS Bluetooth Low Energy library is currently not required for qualification.

After you port Amazon FreeRTOS to your board, you can officially validate the ports for Amazon FreeRTOS qualification with AWS IoT Device Tester for Amazon FreeRTOS. For more information about AWS IoT Device Tester for Amazon FreeRTOS, see Using AWS IoT Device Tester for Amazon FreeRTOS in the Amazon FreeRTOS User Guide.

Note

Before you validate your port of Amazon FreeRTOS using the AWS IoT Device Tester for Amazon FreeRTOS you must remove any logging messages that you might have inserted in your code for testing purposes, otherwise the validation may fail.

For information about qualifying your device for Amazon FreeRTOS, see the Amazon FreeRTOS Qualification Guide.