If you have an existing FreeRTOS project based on the now deprecated amazon-freertos repository, follow these steps:
Stay up to date with the latest, publicly available security fixes. Check the FreeRTOS LTS libraries page for updates, or subscribe to the FreeRTOS-LTS GitHub repository to receive the latest LTS patches with critical and security bug fixes. You can download or clone the latest FreeRTOS LTS patches required directly from the individual GitHub repositories.
Consider refactoring the network transport interface implementation to optimize your hardware platform. The abstract APIs like secure sockets and Wifi APIs are not required by the latest coreMQTT library. See Transport Interface for further details.
The following table provides recommendations for all demo projects, legacy libraries, and abstract APIs within the Amazon-FreeRTOS repository.
Deprecated libraries and demos Name Type RecommendationsBLE
demos and libraries
The FreeRTOS BLE library implements the proprietary MQTT protocol and supports publishing and subscribing to MQTT topics over Bluetooth Low Energy (BLE) through a proxy device such as a mobile phone. This is no longer mandated. Use either your own BLE stack or a third-party option such as NimBLE to best optimize your project.
dev_mode_key_provisioning
demos
The Featured FreeRTOS IoT reference integrations on the NXP i.MX RT1060, STM32U5, or ESP32-C3 platforms provide examples of crucial provisioning using a CLI.
posix
abstraction and demo
Not recommended for use.
wifi_provisioning
example
This example demonstrated how to provision WiFi credentials on a device using the Amazon-FreeRTOS BLE library. Refer to the FreeRTOS Featured IoT reference on the ESP32C3 platform for an example of WiFi provisioning via BLE.
Legacy abstract APIs
code
These are APIs that were created to provide an abstract interface for various third-party software stacks, connectivity modules, and MCU platforms from a variety of vendors. For example, there are interfaces for WiFi abstraction, secure sockets, and so on. They are supported in the Amazon-FreeRTOS repository and are in the folder /libraries/abstractions/
. These APIs are not required when using the FreeRTOS LTS libraries.
The libraries and demos in the table above will not get security patches or bug fixes.
Third-party libraries
When demos in Amazon-FreeRTOS use third-party libraries, we recommend that you sub-module them directly from their third-party repositories.
CMock: clone it (submodule if you use git) directly from the Cmock repository.
jsmn: not recommended and no longer supported.
lwip: clone it (submodule if you use git) directly from the lwip-tcpip repository.
lwip_osal: refer to the FreeRTOS Featured Reference Integrations on i.MX RT1060 or STM32U5 for how to implement lwip_osal on your hardware platform/board.
mbedtls: clone it (submodule if you use git) directly from the Mbed-TLS repository. The mbedtls config and utilities can be reused; make a local copy in this case.
pkcs11: clone it (submodule if you use git) directly from either the corePKCS11 library or the OASIS PKCS 11 repository.
tinycbor: clone it (submodule if you use git) directly from thetinycbor repository.
tinycrypt: we recommend that you use crypto accelerators from your MCU platform, if available. If you want to continue to use tinycrypt, clone it (submodule if you use git) directly from the tinycrypt repository.
tracealyzer_recorder: clone it (submodule if you use git) directly from Percepio's trace recorder repository.
unity: clone it (submodule if you use git) directly from the ThrowTheSwitch/Unity repository.
win_pcap: win_pcap is no longer maintained. We recommend that you use libslirp, libpcap (posix), or npcap instead.
Porting tests and integration tests
All tests under the /tests
folder that are required to validate integration of FreeRTOS libraries were migrated to the FreeRTOS-Libraries-Integration-Tests repository. These can be used to test PAL implementation and library integration. The same tests are used by AWS IoT Device Tester (IDT) for the AWS Device Qualification Program for FreeRTOS.
Infrastructure security
Archive
Did this page help you? - Yes
Thanks for letting us know we're doing a good job!
If you've got a moment, please tell us what we did right so we can do more of it.
Did this page help you? - No
Thanks for letting us know this page needs work. We're sorry we let you down.
If you've got a moment, please tell us how we can make the documentation better.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4