Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# 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](https://www.freertos.org/lts-libraries.html) para ver las actualizaciones o suscríbase al repositorio de GitHub de [FreeRTOS-LTS](https://github.com/FreeRTOS/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.
1. 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](https://www.freertos.org/mqtt/index.html) no requiere API abstractas, como los [sockets seguros](https://docs.aws.amazon.com/freertos/latest/userguide/secure-sockets.html) y las [API de WiFi](https://docs.aws.amazon.com/freertos/latest/userguide/freertos-wifi.html). Consulte [Interfaz de transporte](https://www.freertos.org/network-interface.html) 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](https://github.com/FreeRTOS/coreHTTP) (submódulo si usa git) en la [organización Github de FreeRTOS](https://github.com/FreeRTOS). Las demostraciones de coreHTTP se encuentran en la [ distribución principal de FreeRTOS](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/coreHTTP_Windows_Simulator). Para obtener más detalles, consulte la [página coreHTTP.](https://www.freertos.org/http/index.html) |
| coreMQTT | demostraciones y biblioteca | Clone o descargue la biblioteca coreMQTT directamente desde el repositorio [coreMQTT](https://github.com/FreeRTOS/coreMQTT) (submódulo si usa git) en la [organización Github de FreeRTOS](https://github.com/FreeRTOS). Las demostraciones de coreMQTT se encuentran en la [ distribución principal de FreeRTOS](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/coreMQTT_Windows_Simulator). Para obtener más detalles, consulte la [página coreMQTT.](https://www.freertos.org/mqtt/index.html) |
| coreMQTT-Agent | demostraciones y biblioteca | Clone o descargue la biblioteca coreMQTT-Agent directamente desde el repositorio [coreMQTT-Agent](https://github.com/FreeRTOS/coreMQTT-Agent) (submódulo si usa git) en la [organización Github de FreeRTOS](https://github.com/FreeRTOS). Las demostraciones de coreMQTT-Agent se encuentran en el repositorio [coreMQTT-Agent-Demos](https://github.com/FreeRTOS/coreMQTT-Agent-Demos). Para obtener más detalles, consulte la [página coreMQTT-Agent](https://www.freertos.org/mqtt-agent/index.html). |
| device\$1defender\$1for\$1aws | demostraciones y biblioteca | La biblioteca AWS IoT Device Defender se encuentra en su repositorio, en la [organización de GitHub de AWS](https://github.com/AWS). Clónela o descárguela (submódulo si usa git) directamente desde el repositorio de [AWS IoT Device Defender](https://github.com/aws/Device-Defender-for-AWS-IoT-embedded-sdk). Las demostraciones de [ Device Defender se encuentran en la ](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Device_Defender_Windows_Simulator/Device_Defender_Demo) distribución principal de FreeRTOSAWS IoT. Para obtener más información, consulte la [página de AWS IoT Device Defender](https://www.freertos.org/iot-device-defender/index.html). |
| device\$1shadow\$1for\$1aws | 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](https://github.com/AWS). Clónela o descárguela (submódulo si usa git) directamente desde el repositorio de [sombra de dispositivo de AWS IoT](https://github.com/aws/Device-Shadow-for-AWS-IoT-embedded-sdk). Las demostraciones de sombra de dispositivo de [ se encuentran en la ](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Device_Shadow_Windows_Simulator) distribución principal de FreeRTOSAWS IoT. Para obtener más información, consulte la [página de sombra de dispositivo de AWS IoT](https://www.freertos.org/iot-device-shadow/index.html). |
| jobs\$1for\$1aws | demostraciones y biblioteca | La biblioteca de trabajos de AWS IoT se encuentra en su repositorio, en la [organización de GitHub de AWS](https://github.com/AWS). Clónela o descárguela (submódulo si usa git) directamente desde el repositorio de [trabajos de AWS IoT](https://github.com/aws/Jobs-for-AWS-IoT-embedded-sdk). Las demostraciones de trabajos de AWS IoT se encuentran en la [ distribución principal de FreeRTOS](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Jobs_Windows_Simulator/Jobs_Demo). Para obtener más detalles, consulte la [página de trabajos de AWS IoT.](https://www.freertos.org/iot-jobs/index.html) |
| OTA | demostraciones y biblioteca | La biblioteca de actualizaciones vía inalámbrica (OTA) de AWS IoT se encuentra en su repositorio en la [organización de GitHub de AWS](https://github.com/AWS). Clónela o descárguela (submódulo si usa git) directamente desde el repositorio de [OTA de AWS IoT](https://github.com/aws/ota-for-aws-iot-embedded-sdk). Las demostraciones de OTA de AWS IoT se encuentran en la [ distribución principal de FreeRTOS](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Ota_Windows_Simulator). Para obtener más detalles, consulte la [página de OTA de AWS IoT.](https://www.freertos.org/ota/index.html) |
| CLI y FreeRTOS\$1Plus\$1CLI | 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](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_CLI/FreeRTOS_Plus_Command_Line_Interface.html) para obtener más información. Las integraciones de referencia de FreeRTOS IoT destacadas en las plataformas [ NXP i.MX RT1060](https://github.com/FreeRTOS/iot-reference-nxp-rt1060/tree/main/examples/common/cli) y [STM32U5](https://github.com/FreeRTOS/iot-reference-stm32u5/tree/main/Common/cli) también proporcionan ejemplos de CLI en hardware real. |
| registrar | 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](https://www.freertos.org/logging.html) para saber cómo implementar la macro de registro. Consulte [ una de las referencias de IoT destacadas de FreeRTOS](https://github.com/FreeRTOS/iot-reference-nxp-rt1060/tree/main/examples/common/logging) para ver un ejemplo que se ejecuta en hardware real. |
| greengrass\$1connectivity | 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](https://github.com/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](https://mynewt.apache.org/latest/network/), para optimizar mejor su proyecto. |
| dev\$1mode\$1key\$1provisioning | demostraciones | Las integraciones de referencia de IoT de FreeRTOS destacadas en las plataformas [NXP i.MX RT1060](https://github.com/FreeRTOS/iot-reference-nxp-rt1060/blob/main/examples/common/cli/cli.c), [STM32U5](https://github.com/FreeRTOS/iot-reference-stm32u5/blob/main/Common/cli/cli_pki.c) o [ ESP32-C3](https://github.com/FreeRTOS/iot-reference-esp32c3/blob/main/GettingStartedGuide.md) proporcionan ejemplos de aprovisionamiento crucial mediante una CLI. |
| posix | abstracción y demostración | No se recomienda su uso. |
| wifi\$1provisioning | 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](https://github.com/FreeRTOS/iot-reference-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](https://www.freertos.org/lts-libraries.html). |
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](https://github.com/ThrowTheSwitch/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](https://github.com/lwip-tcpip/lwip).
+ **lwip\$1osal**: consulte las integraciones de referencia destacadas de FreeRTOS en [i.MX RT1060](https://github.com/FreeRTOS/iot-reference-nxp-rt1060) o [STM32U5](https://github.com/FreeRTOS/iot-reference-stm32u5) para saber cómo implementar lwip\$1osal en su plataforma o placa de hardware.
+ **mbedtls**: clónela (submódulo si usa git) directamente desde el repositorio de [Mbed-TLS](https://github.com/Mbed-TLS/mbedtls). 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](https://github.com/FreeRTOS/corePKCS11) o desde el repositorio [PKCS 11 de OASIS](https://github.com/oasis-tcs/pkcs11).
+ **tinycbor**: clónela (submódulo si usa git) directamente desde el repositorio de [tinycbor](https://github.com/intel/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](https://github.com/intel/tinycrypt).
+ **tracealyzer\$1recorder**: clónela (submódulo si usa git) directamente desde el repositorio de [grabadora de seguimientos](https://github.com/percepio/TraceRecorderSource) de Percepio.
+ **unity**: clónelo (submodúlelo si usa git) directamente desde el repositorio [ThrowTheSwitch/Unity](https://github.com/ThrowTheSwitch/Unity).
+ **win\$1pcap**: win\$1pcap 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](https://github.com/FreeRTOS/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](https://docs.aws.amazon.com/freertos/latest/qualificationguide/afr-qualification.html).