Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Porting tumpukan TCP/IP
<a name="afr-porting-tcp"></a>

Bagian ini memberikan instruksi untuk porting dan pengujian fungsionalitas on-board TCP/IP stacks. If your platform offloads TCP/IP dan TLS ke prosesor atau modul jaringan terpisah, Anda dapat melewati bagian porting ini dan mengunjungi. [Porting Antarmuka Transportasi Jaringan](afr-porting-network-transport-interface.md)

[FreerTos\$1TCP](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/index.html) adalah tumpukan TCP/IP stack for the FreeRTOS kernel. FreeRTOS\$1TCP is developed and maintained by the FreeRTOS engineering team and is the recommended TCP/IP asli untuk digunakan dengan FreeRTOS. Untuk informasi selengkapnya, lihat [Porting Freertos\$1TCP](#porting-freertos-tcp). [Atau, Anda dapat menggunakan LWiP stack TCP/IP pihak ketiga.](https://savannah.nongnu.org/projects/lwip/) Instruksi pengujian yang disediakan di bagian ini menggunakan tes antarmuka transport untuk teks biasa TCP, dan tidak tergantung pada tumpukan TCP/IP yang diterapkan secara spesifik. 

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

FreerTos\$1TCP adalah tumpukan TCP/IP asli untuk kernel FreeRTOS. Untuk informasi selengkapnya, lihat [Freertos.org](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/).

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

Untuk mem-port pustaka FreerTos\$1TCP, Anda memerlukan yang berikut ini:
+ Proyek IDE yang mencakup driver Ethernet atau Wi-Fi yang disediakan vendor.

  Untuk informasi tentang menyiapkan proyek pengujian, lihat[Menyiapkan ruang kerja dan proyek Anda untuk porting](porting-set-up-project.md).
+ Konfigurasi kernel FreeRTOS yang divalidasi.

  Untuk informasi tentang mengonfigurasi kernel FreeRTOS untuk platform Anda, lihat. [Mengkonfigurasi port kernel FreeRTOS](afr-porting-kernel.md)

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

Sebelum Anda mulai mem-porting pustaka Freertos\$1TCP, periksa [GitHub](https://github.com/FreeRTOS/FreeRTOS-Plus-TCP/tree/main/source/portable/NetworkInterface)direktori untuk melihat apakah port ke papan Anda sudah ada.

Jika port tidak ada, lakukan hal berikut:

1. Ikuti petunjuk [Porting Freertos\$1TCP ke Mikrokontroler yang Berbeda di Freertos.org untuk mem-port Freertos\$1TCP ke](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/Embedded_Ethernet_Porting.html) perangkat Anda.

1. Jika perlu, ikuti instruksi [Porting Freertos\$1TCP ke New Embedded C Compiler di FreerTos.org untuk mem-port Freertos\$1TCP ke kompiler baru](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/Embedded_Compiler_Porting.html).

1. Menerapkan port baru yang menggunakan driver Ethernet atau Wi-Fi yang disediakan vendor dalam file yang disebut. `NetworkInterface.c` Kunjungi [GitHub](https://github.com/FreeRTOS/FreeRTOS-Plus-TCP/tree/main/source/portable/NetworkInterface/board_family)repositori untuk template.

Setelah Anda membuat port, atau jika port sudah ada, buat`FreeRTOSIPConfig.h`, dan edit opsi konfigurasi sehingga benar untuk platform Anda. Untuk informasi selengkapnya tentang opsi konfigurasi, lihat Konfigurasi [Freertos\$1TCP di Freertos.org](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/TCP_IP_Configuration.html).

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

Baik Anda menggunakan pustaka FreerTos\$1TCP atau pustaka pihak ketiga, ikuti langkah-langkah di bawah ini untuk pengujian:
+ Menyediakan implementasi untuk `connect/disconnect/send/receive` APIs dalam pengujian antarmuka transport.
+ Siapkan server gema dalam mode koneksi TCP teks biasa, dan jalankan tes antarmuka transport.

**catatan**  
Untuk secara resmi memenuhi syarat perangkat untuk FreeRTOS, jika arsitektur Anda memerlukan port tumpukan perangkat lunak TCP/IP, Anda perlu memvalidasi kode sumber porting perangkat terhadap pengujian antarmuka transport dalam mode koneksi TCP teks biasa dengan. AWS IoT Device Tester Ikuti petunjuk di [Menggunakan FreeRTOS di Panduan Pengguna FreerTOS AWS IoT Device Tester untuk](https://docs.aws.amazon.com/freertos/latest/userguide/device-tester-for-freertos-ug.html) *mengatur validasi port*. AWS IoT Device Tester Untuk menguji port pustaka tertentu, grup pengujian yang benar harus diaktifkan dalam `device.json` file di `configs` folder Device Tester.