Portabilidad de una pila TCP/IP

Esta sección proporciona instrucciones para realizar la portabilidad y probar las pilas TCP/IP integradas. Si su plataforma descarga la funcionalidad TCP/IP y TLS en un procesador o módulo de red distinto, puede omitir esta sección de la portabilidad y continuar en Portabilidad de la interfaz de transporte de red.

FreeRTOS+TCP es una pila TCP/IP nativa para el kernel de FreeRTOS. El mantenimiento y desarrollo de FreeRTOS+TCP corre a cargo del equipo de ingeniería de FreeRTOS, por lo que es la pila TCP/IP recomendada para su uso con FreeRTOS. Para obtener más información, consulte Portabilidad de FreeRTOS+TCP. Como alternativa, puede utilizar la pila TCP/IP de terceros IwIP. La instrucción de prueba que se proporciona en esta sección utiliza las pruebas de la interfaz de transporte para texto simple de TCP y no depende de la pila de TCP/IP específica implementada.

Portabilidad de FreeRTOS+TCP

FreeRTOS+TCP es una pila TCP/IP nativa para el kernel FreeRTOS. Para obtener más información, consulte FreeRTOS.org.

Requisitos previos

Para realizar la portabilidad de la biblioteca FreeRTOS+TCP, necesita lo siguiente:

• Un proyecto de IDE que incluya los controladores de Ethernet o Wi-Fi suministrados por el proveedor.

  Para obtener información sobre el modo de configurar un proyecto de prueba, consulte Configuración del espacio de trabajo y el proyecto para la portabilidad.

• Una configuración validada del kernel de FreeRTOS.

  Para obtener información sobre cómo configurar el kernel de FreeRTOS para su plataforma, consulte Configuración de un puerto de kernel FreeRTOS.

Portabilidad

Antes de empezar a realizar la portabilidad de la biblioteca FreeRTOS+TCP, compruebe el directorio GitHub para ver si ya se existe una portabilidad a la placa.

Si no existe ningún puerto, haga lo siguiente:

1. Siga las instrucciones ofrecidas en Porting FreeRTOS+TCP to a Different Microcontroller en FreeRTOS.org para realizar la portabilidad de FreeRTOS+TCP al dispositivo.

2. Si es necesario, siga las instrucciones de Porting FreeRTOS+TCP to a New Embedded C Compiler en FreeRTOS.org para realizar la portabilidad de FreeRTOS+TCP a un nuevo compilador.

3. Implemente una nueva portabilidad que use los controladores Ethernet o Wi-Fi proporcionados por el proveedor en un archivo llamado NetworkInterface.c. Consulte el repositorio de GitHub para obtener una plantilla.

Después de crear una portabilidad, o si ya existe una, cree FreeRTOSIPConfig.h y edite las opciones de configuración para que sean correctas para su plataforma. Para obtener más información acerca de las opciones de configuración, consulte FreeRTOS+TCP Configuration en FreeRTOS.org.

Pruebas

Tanto si utiliza la biblioteca FreeRTOS+TCP o una biblioteca de terceros, siga los pasos que se indican a continuación para realizar las pruebas:

• Proporcione una implementación para las API connect/disconnect/send/receive en las pruebas de interfaz de transporte.

• Configure un servidor echo en el modo de conexión TCP de texto plano y ejecute las pruebas de la interfaz de transporte.

nota

Para calificar oficialmente un dispositivo para FreeRTOS, si su arquitectura requiere realizar la portabilidad de una pila de software TCP/IP, debe validar el código fuente portado del dispositivo con las pruebas de interfaz de transporte en modo de conexión TCP de texto plano con AWS IoT Device Tester. Siga las instrucciones de Uso de AWS IoT Device Tester para FreeRTOS en la Guía del usuario de FreeRTOS para configurar AWS IoT Device Tester para la validación de la portabilidad. Para probar el puerto de una biblioteca concreta, se debe habilitar el grupo de pruebas correcto en el archivo device.json de la carpeta configs de Device Tester.