

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Portage d'une pile TCP/IP
<a name="afr-porting-tcp"></a>

Cette section fournit des instructions pour le portage et le test des fonctionnalités TCP/IP stacks. If your platform offloads TCP/IP intégrées et TLS vers un processeur ou un module réseau distinct. Vous pouvez ignorer cette section sur le portage et consulter. [Portage de l'interface de transport réseau](afr-porting-network-transport-interface.md)

[FreeRTOS\$1TCP](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/index.html) est une pile native TCP/IP stack for the FreeRTOS kernel. FreeRTOS\$1TCP is developed and maintained by the FreeRTOS engineering team and is the recommended TCP/IP à utiliser avec FreeRTOS. Pour de plus amples informations, veuillez consulter [Portage FreeRTOS\$1TCP](#porting-freertos-tcp). [Vous pouvez également utiliser la pile TCP/IP tierce LWip.](https://savannah.nongnu.org/projects/lwip/) L'instruction de test fournie dans cette section utilise les tests d'interface de transport pour le texte brut TCP et ne dépend pas de la pile TCP/IP implémentée spécifique. 

## Portage FreeRTOS\$1TCP
<a name="porting-freertos-tcp"></a>

FreeRTOS\$1TCP est une pile TCP/IP native pour le noyau FreeRTOS. Pour plus d'informations, consultez [FreeRTOS.org](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/).

### Prérequis
<a name="porting-prereqs-freertos-tcp"></a>

Pour porter la bibliothèque FreeRTOS\$1TCP, 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](porting-set-up-project.md).
+ 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](afr-porting-kernel.md).

### Portage
<a name="porting-steps-freertos-tcp"></a>

Avant de commencer à porter la bibliothèque FreeRTOS\$1TCP, vérifiez [GitHub](https://github.com/FreeRTOS/FreeRTOS-Plus-TCP/tree/main/source/portable/NetworkInterface)dans le répertoire s'il existe déjà un port vers votre carte.

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

1. Suivez les instructions [Porting FreeRTOS\$1TCP to a Different Microcontroller](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/Embedded_Ethernet_Porting.html) sur FreeRTOS.org pour porter FreeRTOS\$1TCP vers votre appareil.

1. Si nécessaire, suivez les instructions [Porting FreeRTOS\$1TCP to a New Embedded C Compiler](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/Embedded_Compiler_Porting.html) sur FreeRTOS.org pour porter FreeRTOS\$1TCP vers un nouveau compilateur.

1. Implémentez un nouveau port qui utilise les pilotes Ethernet ou Wi-Fi fournis par le fournisseur dans un fichier appelé. `NetworkInterface.c` Consultez le [GitHub](https://github.com/FreeRTOS/FreeRTOS-Plus-TCP/tree/main/source/portable/NetworkInterface/board_family)référentiel pour trouver un modèle.

Après avoir créé un port, ou si un port existe déjà`FreeRTOSIPConfig.h`, créez et modifiez les options de configuration afin qu'elles soient adaptées à votre plate-forme. Pour plus d'informations sur les options de configuration, consultez [FreeRTOS\$1TCP Configuration](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/TCP_IP_Configuration.html) sur FreeRTOS.org.

## Test
<a name="testing-tcp"></a>

Que vous utilisiez la bibliothèque FreeRTOS\$1TCP ou une bibliothèque tierce, suivez les étapes ci-dessous pour les tests :
+ Fournir une implémentation pour `connect/disconnect/send/receive` APIs 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 portage d'une pile logicielle TCP/IP, vous devez valider le code source porté de l'appareil par rapport aux tests d'interface de transport en mode de connexion TCP en texte brut avec. AWS IoT Device Tester Suivez les instructions de la section [Utilisation AWS IoT Device Tester pour FreeRTOS](https://docs.aws.amazon.com/freertos/latest/userguide/device-tester-for-freertos-ug.html) du Guide de l'*utilisateur de FreeRTOS pour configurer la validation des ports*. AWS IoT Device Tester 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.