Amazon FreeRTOS
Qualification Guide

What Is Amazon FreeRTOS Qualification?

Amazon Partner Network Partners can use the AWS Device Qualification Program to officially qualify a microcontroller (MCU) development board for Amazon FreeRTOS.

Amazon FreeRTOS qualification gives developers a reliable and consistent experience across a range of qualified, MCU-based development boards. By abstracting some of the complexity of embedded development, Amazon FreeRTOS qualification makes it possible for developers to focus on designing the application code for their product, so they can rapidly evaluate, prototype, and productize IoT solutions. This qualification process helps bridge the gap between cloud developers and embedded engineers.

Qualified boards are eligible for listing on the AWS Partner Device Catalog.

To qualify a device for Amazon FreeRTOS, you must port Amazon FreeRTOS to your device, and then follow the Device Qualification Program steps. For information, see the AWS Device Qualification Program page and the AWS Device Qualification Program Guide.

For information about qualifying your device for Amazon FreeRTOS, see Qualifying Your Device.

Qualification FAQs

If a version of Amazon FreeRTOS is released after I have started porting a previous version, do I need to start over using the latest version?

Always start porting the latest version of Amazon FreeRTOS. If we release a new version of Amazon FreeRTOS while you are working on your port, you can contact us with questions about how the release might affect your qualification effort.

My device does not support Wi-Fi. Is a port of the Amazon FreeRTOS Wi-Fi library required to qualify for Amazon FreeRTOS?

The primary requirement is that your device can connect to the AWS Cloud. If your device can connect to the AWS Cloud across a secure ethernet connection, the Wi-Fi library is not a requirement.

My device does not support Bluetooth Low Energy or over-the-air (OTA) updates. Are ports for these Amazon FreeRTOS libraries required to qualify for Amazon FreeRTOS?

Bluetooth Low Energy and OTA ports are optional for qualification.

My board does not have on-chip TCP/IP functionality. Is a particular TCP/IP stack required for Amazon FreeRTOS qualification?

If your board does not have on-chip TCP/IP functionality, you can use either the FreeRTOS+TCP TCP/IP stack or version 2.0.3 of the lwIP TCP/IP stack to pass TCP/IP qualification requirements. For more information, see Porting a TCP/IP Stack in the Amazon FreeRTOS Porting Guide.

Is a particular TLS stack required for qualification?

Amazon FreeRTOS supports mbedTLS and off-chip TLS implementations, such as those found on some network processors. No matter which TLS implementation is used by your device's port of Amazon FreeRTOS, the port must pass the Device Tester validation tests for TLS. For more information, see Porting the TLS Library in the Amazon FreeRTOS Porting Guide.

Does my device need to pass all of the AWS IoT Device Tester validation tests to qualify? Is there a way to qualify without passing all of the tests?

Your device must pass all of the required validation tests to qualify for Amazon FreeRTOS. The only exceptions are for Wi-Fi, Bluetooth Low Energy, and OTA.

If you have questions about qualification that are not answered on this page or in the rest of the Amazon FreeRTOS Qualification Guide, contact your AWS representative or the Amazon FreeRTOS engineering team.

Documentation History

Revision History of Amazon FreeRTOS Porting and Qualification Documentation


Porting and Qualification Documentation Version

Change History

Amazon FreeRTOS Version

June 17, 2019

201906.00 (Porting Guide)

201906.00 (Qualification Guide)

  • Release 201906.00

  • Directory structured updated

201906.00 Major

May 21, 2019

1.4.8 (Porting Guide)

1.4.8 (Qualification Guide)


February 25, 2019


  • Removed download and configuration instructions from Getting Started Guide Template Appendix (page 84)




December 27, 2018


  • Updated Checklist for Qualification appendix with CMake requirement (page 70)



December 12, 2018


  • Added lwIP porting instructions to TCP/IP porting appendix (page 31)


November 26, 2018


  • Added Bluetooth Low Energy porting appendix (page 52)

  • Added AWS IoT Device Tester for Amazon FreeRTOS testing information throughout document

  • Added CMake link to Information for listing on the Amazon FreeRTOS Console appendix (page 85)


November 7, 2018


  • Updated PKCS #11 PAL interface porting instructions in PKCS #11 porting appendix (page 38)

  • Updated path to CertificateConfigurator.html (page 76)

  • Updated Getting Started Guide Template appendix (page 80)


October 8, 2018


  • Added new "Required for AFQP" column to aws_test_runner_config.h test configuration table (page 16)

  • Updated Unity module directory path in Create the Test Project section (page 14)

  • Updated "Recommended Porting Order" chart (page 22)

  • Updated client certificate and key variable names in TLS appendix, Test Setup (page 40)

  • File paths changed in Secure Sockets porting appendix, Test Setup (page 34); TLS porting appendix, Test Setup (page 40); and TLS Server Setup appendix (page 57)


August 27, 2018


  • Added OTA Updates porting appendix (page 47)

  • Added Bootloader porting appendix (page 51)



August 9, 2018


  • Updated "Recommended Porting Order" chart (page 22)

  • Updated PKCS #11 porting appendix (page 36)

  • File paths changed in TLS porting appendix, Test Setup (page 40), and TLS Server Setup appendix, step 9 (page 51)

  • Fixed hyperlinks in MQTT porting appendix, Prerequisites (page 45)

  • Added AWS CLI config instructions to examples in Instructions to Create a BYOC appendix (page 57)



July 31, 2018


Initial version of the Amazon FreeRTOS Qualification Program Guide