View a markdown version of this page

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

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.

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

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 FreeRTOS-LTS GitHub repositorio 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. 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

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

Bibliotecas y demostraciones migradas
Name 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.

núcleo MQTT-Agent

demostraciones y biblioteca

Clona o descarga la MQTT-Agent biblioteca principal directamente desde el MQTT-Agent repositorio principal (submódulo si usas git) en la organización Github de FreeRTOS. Las MQTT-Agent demostraciones principales se encuentran en el repositorio principal MQTT-Agent-Demos. Para obtener más información, consulta la MQTT-Agent página principal.

device_defender_for_aws

demostraciones y biblioteca

La biblioteca AWS IoT Device Defender se encuentra en el repositorio de la AWS GitHub organización. Clónela o descárguela (submódulo si usa git) directamente desde el repositorio de AWS IoT Device Defender. Las demostraciones de AWS IoT Device Defender se encuentran en la distribución principal de Freertos. Para obtener más información, consulte la página de AWS IoT Device Defender.

device_shadow_for_aws

demostraciones y biblioteca

La biblioteca AWS IoT Device Shadow se encuentra en el repositorio de la AWS GitHub organización. Clónela o descárguela (submódulo si usa git) directamente desde el repositorio de sombra de dispositivo de AWS IoT. Las demos de AWS IoT Device Shadow se encuentran en la distribución principal de Freertos. 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 AWS IoT Jobs se encuentra en el repositorio de la AWS GitHub organización. Clónela o descárguela (submódulo si usa git) directamente desde el repositorio de trabajos de AWS IoT. Las demostraciones AWS IoT de Jobs 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 AWS IoT Over-The-Air (OTA) se encuentra en el repositorio de la AWS GitHub organización. Clónela o descárguela (submódulo si usa git) directamente desde el repositorio de OTA de AWS IoT. Las demostraciones de AWS IoT OTA 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 CLI en ejecución 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.

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 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] Este proyecto de demostración supuso que la conectividad a la nube estaba disponible antes de conectarse a un AWS IoT dispositivo 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
Name 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 FreeRTOS IoT destacadas en las plataformas NXP i.MX RT1060, STM32U5 o plataformas proporcionan ejemplos de aprovisionamiento crucial mediante una CLI. ESP32-C3

posix

abstracción y demostración

No se recomienda su uso.

wifi_provisioning

ejemplo

En este ejemplo, se muestra cómo aprovisionar credenciales en un dispositivo mediante la biblioteca BLE. WiFi Amazon-FreeRTOS Consulte la referencia de IoT destacado de FreeRTOS en la plataforma ESP32C3 para ver un ejemplo de aprovisionamiento mediante BLE. WiFi

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 WiFi abstracción, sockets seguros, etc. Se admiten en el Amazon-FreeRTOS repositorio 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.

Third-party bibliotecas

Cuando las demostraciones 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 hardware. platform/board

  • mbedtls: clónalo (submódulo si usas git Mbed-TLS) directamente desde el repositorio. 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ónalo (submódulo si usas 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 /tests carpeta necesarias para validar la integración de las bibliotecas de FreeRTOS se migraron al FreeRTOS-Libraries-Integration-Testsrepositorio. Se pueden usar para probar la implementación de PAL y la integración de la biblioteca. AWS IoT Device Tester (IDT) utiliza las mismas pruebas para el Programa de calificación de AWS dispositivos de FreeRTOS.