Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Einen TCP/IP Stack portieren
<a name="afr-porting-tcp"></a>

Dieser Abschnitt enthält Anweisungen zum Portieren und Testen von integrierten TCP/IP Stacks. Wenn Ihre Plattform die TLS-Funktionalität auf einen separaten Netzwerkprozessor oder ein separates Netzwerkmodul auslagert, können Sie diesen Abschnitt zur Portierung überspringen und die Seite aufrufen. TCP/IP [Portierung der Netzwerktransportschnittstelle](afr-porting-network-transport-interface.md)

[FreeRTOS\+TCP](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/index.html) ist ein nativer TCP/IP Stack für den FreeRTOS-Kernel. FreeRTOS\+TCP wird vom FreeRTOS-Engineering-Team entwickelt und gewartet und ist der empfohlene TCP/IP Stack für die Verwendung mit FreeRTOS. Weitere Informationen finden Sie unter [Portierung von FreeRTOS\+TCP](#porting-freertos-tcp). Alternativ können Sie den TCP/IP Drittanbieter-Stack [lwIP](https://savannah.nongnu.org/projects/lwip/) verwenden. Die in diesem Abschnitt bereitgestellte Testanweisung verwendet die Transportschnittstellentests für TCP-Klartext und ist nicht vom spezifischen implementierten TCP/IP Stack abhängig. 

## Portierung von FreeRTOS\+TCP
<a name="porting-freertos-tcp"></a>

FreeRTOS\+TCP ist ein nativer TCP/IP Stack für den FreeRTOS-Kernel. Weitere Informationen finden Sie unter [FreeRTOS.org](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/).

### Voraussetzungen
<a name="porting-prereqs-freertos-tcp"></a>

Um die FreeRTOS\+TCP-Bibliothek zu portieren, benötigen Sie Folgendes:
+ Ein IDE-Projekt, das das vom Hersteller bereitgestellte Ethernet oder die Treiber enthält. Wi-Fi 

  Weitere Informationen zum Einrichten eines Testprojekts finden Sie unter [Deinen Workspace und dein Projekt für die Portierung einrichten](porting-set-up-project.md).
+ Eine validierte Konfiguration des FreeRTOS-Kernels.

  Informationen zur Konfiguration des FreeRTOS-Kernels für Ihre Plattform finden Sie unter [Konfigurieren eines FreeRTOS-Kernel-Ports](afr-porting-kernel.md).

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

Bevor Sie mit der Portierung der FreeRTOS\+TCP-Bibliothek beginnen, überprüfen Sie im [GitHub](https://github.com/FreeRTOS/FreeRTOS-Plus-TCP/tree/main/source/portable/NetworkInterface)Verzeichnis, ob bereits ein Port zu Ihrem Board existiert.

Wenn kein Port vorhanden ist, führen Sie die folgenden Schritte aus:

1. Folgen Sie den Anweisungen zum [Portieren von FreeRTOS\+TCP auf einen anderen Mikrocontroller, um](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/Embedded_Ethernet_Porting.html) FreeRTOS\+TCP auf Ihr Gerät FreeRTOS.org zu portieren.

1. Folgen Sie bei Bedarf den Anweisungen [Portieren von FreeRTOS\+TCP auf einen neuen Embedded C-Compiler](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/Embedded_Compiler_Porting.html) unter Portieren von FreeRTOS\+TCP FreeRTOS.org auf einen neuen Compiler.

1. Implementieren Sie einen neuen Port, der das vom Hersteller bereitgestellte Ethernet oder Treiber verwendet, in einer Datei namens. Wi-Fi `NetworkInterface.c` Eine Vorlage finden Sie im [GitHub](https://github.com/FreeRTOS/FreeRTOS-Plus-TCP/tree/main/source/portable/NetworkInterface/board_family)Repository.

Nachdem Sie einen Port erstellt haben oder falls bereits ein Port vorhanden ist`FreeRTOSIPConfig.h`, erstellen und bearbeiten Sie die Konfigurationsoptionen, sodass sie für Ihre Plattform korrekt sind. Weitere Informationen zu den Konfigurationsoptionen finden Sie unter [FreeRTOS\+TCP](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/TCP_IP_Configuration.html) Configuration on. FreeRTOS.org

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

Unabhängig davon, ob Sie die FreeRTOS\+TCP-Bibliothek oder eine Bibliothek eines Drittanbieters verwenden, folgen Sie zum Testen den folgenden Schritten:
+ Stellen Sie eine Implementierung für `connect/disconnect/send/receive` APIs in Transportschnittstellentests bereit.
+ Richten Sie einen Echoserver im TCP-Verbindungsmodus im Klartext-Modus ein und führen Sie Transportschnittstellentests durch.

**Anmerkung**  
Um ein Gerät offiziell für FreeRTOS zu qualifizieren, müssen Sie, wenn Ihre Architektur die Portierung eines TCP/IP Software-Stacks erfordert, den portierten Quellcode des Geräts anhand von Transportschnittstellentests im Klartext-TCP-Verbindungsmodus mit validieren. AWS IoT Device Tester Folgen Sie den Anweisungen [unter Using AWS IoT Device Tester for FreeRTOS](https://docs.aws.amazon.com/freertos/latest/userguide/device-tester-for-freertos-ug.html) im *FreeRTOS User Guide, um die Port-Validierung* einzurichten AWS IoT Device Tester . Um den Port einer bestimmten Bibliothek zu testen, muss die korrekte Testgruppe in der Datei `device.json` im Ordner `configs` in Device Tester aktiviert sein.