Guía de migración del repositorio Github de Amazon-FreeRTOS

Si tiene un proyecto FreeRTOS existente basado en el repositorio amazon-freertos, ahora obsoleto, siga estos pasos:

1. Manténgase al día con las últimas correcciones de seguridad disponibles públicamente. Consulte la página de Bibliotecas de FreeRTOS LTS para ver las actualizaciones o suscríbase al repositorio de GitHub de FreeRTOS-LTS para recibir los últimos parches de LTS con correcciones de errores críticos y de seguridad. Puede descargar o clonar los últimos parches de FreeRTOS LTS necesarios directamente desde los repositorios individuales de GitHub.

2. Considere la posibilidad de refactorizar la implementación de la interfaz de transporte de red para optimizar su plataforma de hardware. La biblioteca más reciente de coreMQTT no requiere API abstractas, como los sockets seguros y las API de WiFi. Consulte Interfaz de transporte para obtener más información.

Apéndice

En la siguiente tabla se proporcionan recomendaciones para todos los proyectos de demostración, las bibliotecas antiguas y las API abstractas del repositorio Amazon-FreeRTOS.

Bibliotecas y demostraciones migradas
Nombre	Tipo	Recomendaciones
coreHTTP	demostraciones y biblioteca	Clone o descargue la biblioteca coreHTTP directamente desde el repositorio coreHTTP (submódulo si usa git) en la organización Github de FreeRTOS. Las demostraciones de coreHTTP se encuentran en la distribución principal de FreeRTOS. Para obtener más detalles, consulte la página coreHTTP.
coreMQTT	demostraciones y biblioteca	Clone o descargue la biblioteca coreMQTT directamente desde el repositorio coreMQTT (submódulo si usa git) en la organización Github de FreeRTOS. Las demostraciones de coreMQTT se encuentran en la distribución principal de FreeRTOS. Para obtener más detalles, consulte la página coreMQTT.
coreMQTT-Agent	demostraciones y biblioteca	Clone o descargue la biblioteca coreMQTT-Agent directamente desde el repositorio coreMQTT-Agent (submódulo si usa git) en la organización Github de FreeRTOS. Las demostraciones de coreMQTT-Agent se encuentran en el repositorio coreMQTT-Agent-Demos. Para obtener más detalles, consulte la página coreMQTT-Agent.
device_defender_for_aws	demostraciones y biblioteca	La biblioteca AWS IoT Device Defender se encuentra en su repositorio, en la organización de GitHub de AWS. Clónela o descárguela (submódulo si usa git) directamente desde el repositorio de AWS IoT Device Defender. Las demostraciones de Device Defender se encuentran en la distribución principal de FreeRTOSAWS IoT. Para obtener más información, consulte la página de AWS IoT Device Defender.
device_shadow_for_aws	demostraciones y biblioteca	La biblioteca de sombra de dispositivo de AWS IoT se encuentra en su repositorio, en la organización de GitHub de AWS. Clónela o descárguela (submódulo si usa git) directamente desde el repositorio de sombra de dispositivo de AWS IoT. Las demostraciones de sombra de dispositivo de se encuentran en la distribución principal de FreeRTOSAWS IoT. Para obtener más información, consulte la página de sombra de dispositivo de AWS IoT.
jobs_for_aws	demostraciones y biblioteca	La biblioteca de trabajos de AWS IoT se encuentra en su repositorio, en la organización de GitHub de AWS. Clónela o descárguela (submódulo si usa git) directamente desde el repositorio de trabajos de AWS IoT. Las demostraciones de trabajos de AWS IoT se encuentran en la distribución principal de FreeRTOS. Para obtener más detalles, consulte la página de trabajos de AWS IoT.
OTA	demostraciones y biblioteca	La biblioteca de actualizaciones inalámbricas de AWS IoT se encuentra en su repositorio en la organización de GitHub de AWS. Clónela o descárguela (submódulo si usa git) directamente desde el repositorio de OTA de AWS IoT. Las demostraciones de OTA de AWS IoT se encuentran en la distribución principal de FreeRTOS. Para obtener más detalles, consulte la página de OTA de AWS IoT.
CLI y FreeRTOS_Plus_CLI	demostraciones y biblioteca	Hay un ejemplo de la CLI que se ejecuta en WinSim. Consulte la página de la interfaz de línea de comandos de FreeRTOS Plus para obtener más información. Las integraciones de referencia de FreeRTOS IoT destacadas en las plataformas NXP i.MX RT1060 y STM32U5 también proporcionan ejemplos de CLI en hardware real.
registro	macro	Algunas de las bibliotecas de FreeRTOS utilizan implementaciones de la macro de registro para plataformas de hardware específicas. Consulte la página de registro para saber cómo implementar la macro de registro. Consulte una de las referencias de IoT destacadas de FreeRTOS para ver un ejemplo que se ejecuta en hardware real.
greengrass_connectivity	demostración	[Migración en curso] Para este proyecto de demostración se asumió que la conectividad a la nube estaba disponible antes de conectarse a un dispositivo AWS IoT Greengrass. Se está desarrollando un nuevo proyecto que muestra la capacidad local de autenticación y detección. Se espera que el nuevo proyecto de demostración se publique en breve en la organización de Github de FreeRTOS.

Bibliotecas y demostraciones obsoletas
Nombre	Tipo	Recomendaciones
BLE	demostraciones y biblioteca	La biblioteca BLE de FreeRTOS implementa el protocolo propietario MQTT y admite la publicación y suscripción a temas MQTT sobre Bluetooth de bajo consumo (BLE) a través de un dispositivo proxy como un teléfono móvil. Esto ya no es obligatorio. Utilice su propia pila de BLE o una opción de terceros, como NimBLE, para optimizar mejor su proyecto.
dev_mode_key_provisioning	demostraciones	Las integraciones de referencia de IoT de FreeRTOS destacadas en las plataformas NXP i.MX RT1060, STM32U5 o ESP32-C3 proporcionan ejemplos de aprovisionamiento crucial mediante una CLI.
posix	abstracción y demostración	No se recomienda su uso.
wifi_provisioning	ejemplo	En este ejemplo se muestra cómo aprovisionar credenciales WiFi en un dispositivo mediante la biblioteca BLE de Amazon FreeRTOS. Consulte la referencia de IoT destacada de FreeRTOS en la plataforma ESP32C3 para ver un ejemplo de aprovisionamiento de WiFi mediante BLE.
API abstractas heredadas	code	Se trata de API que se crearon para proporcionar una interfaz abstracta para varios paquetes de software, módulos de conectividad y plataformas MCU de terceros de diversos proveedores. Por ejemplo, hay interfaces para la abstracción de WiFi, sockets seguros, etc. Se admiten en el repositorio de Amazon-FreeRTOS y se encuentran en la carpeta /libraries/abstractions/. Estas API no son necesarias cuando se utilizan las bibliotecas LTS de FreeRTOS.

Las bibliotecas y demostraciones de la tabla anterior no recibirán parches de seguridad ni correcciones de errores.

Bibliotecas de terceros

Cuando las demostraciones de Amazon-FreeRTOS utilicen bibliotecas de terceros, le recomendamos que las submodule directamente desde sus repositorios de terceros.

• cMock: clónela (submódulo si usa git) directamente desde el repositorio de Cmock.

• jsmn: no se recomienda y ya no se admite.

• Iwip: clónela (submódulo si usa git) directamente desde el repositorio de lwip-tcpip.

• lwip_osal: consulte las integraciones de referencia destacadas de FreeRTOS en i.MX RT1060 o STM32U5 para saber cómo implementar lwip_osal en su plataforma o placa de hardware.

• mbedtls: clónela (submódulo si usa git) directamente desde el repositorio de Mbed-TLS. La configuración y las utilidades de mbedtls se pueden reutilizar; en este caso, haga una copia local.

• pkcs11: clónela (submódulo si usa git) directamente desde la biblioteca corePKCS11 o desde el repositorio PKCS 11 de OASIS.

• tinycbor: clónela (submódulo si usa git) directamente desde el repositorio de tinycbor.

• tinycrypt: le recomendamos que utilice aceleradores criptográficos de su plataforma MCU, si están disponibles. Si desea seguir usando tinycrypt, clónela (submódulo si usa git) directamente desde el repositorio de tinycrypt.

• tracealyzer_recorder: clónela (submódulo si usa git) directamente desde el repositorio de grabadora de seguimientos de Percepio.

• unity: clónwlo (submódulo si usa git) directamente desde el repositorio ThrowTheSwitch/Unity.

• win_pcap: win_pcap ya no se mantiene. Le recomendamos que utilice libslirp, libpcap (posix) o npcap en su lugar.

Pruebas de portabilidad y pruebas de integración

Todas las pruebas de la carpeta /tests necesarias para validar la integración de las bibliotecas FreeRTOS se migraron al repositorio FreeRTOS-Libraries-Integration-Tests. Se pueden usar para probar la implementación de PAL y la integración de la biblioteca. AWS IoT Device Tester utiliza las mismas pruebas para el Programa de calificación de dispositivos de AWS para FreeRTOS.