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.

# Portieren eines TCP/IP-Stacks
<a name="afr-porting-tcp"></a>

Dieser Abschnitt enthält Anweisungen zum Portieren und Testen der integrierten TCP/IP stacks. If your platform offloads TCP/IP und TLS-Funktionalität auf einen separaten Netzwerkprozessor oder ein separates Netzwerkmodul. Sie können diesen Abschnitt zur Portierung überspringen und besuchen[Portierung der Netzwerktransportschnittstelle](afr-porting-network-transport-interface.md).

[FreeRTOS\$1TCP](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/index.html) ist ein nativer TCP/IP stack for the FreeRTOS kernel. FreeRTOS\$1TCP is developed and maintained by the FreeRTOS engineering team and is the recommended TCP/IP Stack zur Verwendung mit FreeRTOS. Weitere Informationen finden Sie unter [Portierung von FreeRTOS\$1TCP](#porting-freertos-tcp). [Alternativ können Sie den TCP/IP-Stack LwIP eines Drittanbieters verwenden.](https://savannah.nongnu.org/projects/lwip/) Die Testanweisung in diesem Abschnitt verwendet die Transportschnittstellentests für TCP-Klartext und ist nicht vom spezifisch implementierten TCP/IP-Stack abhängig. 

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

FreeRTOS\$1TCP 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\$1TCP-Bibliothek zu portieren, benötigen Sie Folgendes:
+ Ein IDE-Projekt, das die vom Hersteller bereitgestellten Ethernet- oder Wi-Fi-Treiber enthält.

  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\$1TCP-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 in [Portierung von FreeRTOS\$1TCP zu einem anderen Microcontroller](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/Embedded_Ethernet_Porting.html) auf FreeRTOS.org, um FreeRTOS\$1TCP auf Ihr Gerät zu portieren.

1. Falls erforderlich, folgen Sie den Anweisungen in [Portierung von FreeRTOS\$1TCP auf einen neuen Embedded C Compiler](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/Embedded_Compiler_Porting.html) auf FreeRTOS.org, um FreeRTOS\$1TCP auf einen neuen Compiler zu portieren.

1. Implementieren Sie einen neuen Port, der die vom Hersteller bereitgestellten Ethernet- oder Wi-Fi-Treiber verwendet, in einer Datei namens. `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 in [FreeRTOS\$1TCP-Konfiguration](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/TCP_IP_Configuration.html) unter FreeRTOS.org.

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

Unabhängig davon, ob Sie die FreeRTOS\$1TCP-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-Transport-Schnittstellentests 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-Softwarestacks 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.