Portage d'une pile TCP/IP

Cette section fournit des instructions pour le portage et le test des piles TCP/IP intégrées. Si votre plateforme décharge les fonctionnalités TCP/IP et TLS vers un processeur ou un module réseau distinct, vous pouvez ignorer cette section sur le portage et visiterPortage de l'interface de transport réseau.

RTOS+TCP gratuitsest une pile TCP/IP native pour le noyau FreeRTOS. FreeRTOS+TCP est développé et maintenu par l'équipe d'ingénierie de FreeRTOS et constitue la pile TCP/IP recommandée à utiliser avec FreeRTOS. Pour plus d'informations, veuillez consulter Portage FreeRTOS+TCP. Vous pouvez également utiliser la pile TCP/IP tierceLWiP. Les instructions de test fournies dans cette section utilisent les tests d'interface de transport pour le texte brut TCP et ne dépendent pas de la pile TCP/IP spécifique implémentée.

Portage FreeRTOS+TCP

FreeRTOS+TCP est une pile TCP/IP native pour le noyau FreeRTOS. Pour plus d'informations, consultez FreeRTOS.org.

Prérequis

Pour porter la bibliothèque FreeRTOS+TCP, vous avez besoin des éléments suivants :

• Un projet IDE qui inclut les pilotes Ethernet ou Wi-Fi fournis par le fournisseur.

  Pour de plus amples informations sur la configuration d'un projet de test, veuillez consulter Configuration de votre espace de travail et de votre projet pour le portage.

• Configuration validée du noyau FreeRTOS.

  Pour plus d’informations sur la configuration du noyau FreeRTOS pour votre plateforme, consultez Configuration d'un port du noyau FreeRTOS.

Portage

Avant de commencer le portage de la bibliothèque FreeRTOS+TCP, consultezGitHubrépertoire pour voir si un port vers votre carte existe déjà.

S’il n'existe pas de portage, procédez comme suit :

1. Suivez les instructions Porting FreeRTOS+TCP to a Different Microcontroller sur FreeRTOS.org pour porter FreeRTOS+TCP vers votre appareil.

2. Si nécessaire, suivez les instructions Porting FreeRTOS+TCP to a New Embedded C Compiler sur FreeRTOS.org pour porter FreeRTOS+TCP vers un nouveau compilateur.

3. Implémentez un nouveau port qui utilise les pilotes Ethernet ou Wi-Fi fournis par le fournisseur dans un fichier appeléNetworkInterface.c. Visitez leGitHubréférentiel pour un modèle.

Après avoir créé un port, ou si un port existe déjà, créezFreeRTOSIPConfig.h, et modifiez les options de configuration afin qu'elles soient adaptées à votre plateforme. Pour plus d'informations sur les options de configuration, consultez FreeRTOS+TCP Configuration sur FreeRTOS.org.

Test

Que vous utilisiez la bibliothèque FreeRTOS+TCP ou une bibliothèque tierce, suivez les étapes ci-dessous pour les tests :

• Fournir une implémentation pourconnect/disconnect/send/receiveLes API utilisées dans les tests d'interface de transport.

• Configurez un serveur d'écho en mode de connexion TCP en texte brut et exécutez des tests d'interface de transport.

Note

Pour qualifier officiellement un appareil pour FreeRTOS, si votre architecture nécessite le port d'une pile logicielle TCP/IP, vous devez valider le code source porté de l'appareil par rapport à des tests d'interface de transport en mode de connexion TCP en texte brut avecAWS IoT Device Tester. Suivez les instructions figurant dansEn utilisantAWS IoT Device Testerpour FreeRTOSdans leGuide de l'utilisateur de FreeRTOSà configurerAWS IoT Device Testerpour la validation des ports. Pour tester le port d'une bibliothèque spécifique, le groupe de test correct doit être activé dans le fichier device.json du dossier configs de Device Tester.