Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Panduan Migrasi Repositori Github Amazon-freertos
Jika Anda memiliki proyek FreeRTOS yang sudah ada berdasarkan repositori amazon-freertos yang sekarang tidak digunakan lagi, ikuti langkah-langkah ini:
1. Tetap up to date dengan perbaikan keamanan terbaru yang tersedia untuk umum. [Periksa halaman pustaka [FreerTOS LTS](https://www.freertos.org/lts-libraries.html) untuk pembaruan, atau berlangganan repositori GitHub Freertos-LTS untuk menerima patch LTS terbaru dengan perbaikan bug kritis dan keamanan.](https://github.com/FreeRTOS/FreeRTOS-LTS) Anda dapat mengunduh atau mengkloning patch FreerTOS LTS terbaru yang diperlukan langsung dari masing-masing repositori. GitHub
1. Pertimbangkan refactoring implementasi antarmuka transportasi jaringan untuk mengoptimalkan platform perangkat keras Anda. Abstrak APIs seperti [soket aman](https://docs.aws.amazon.com/freertos/latest/userguide/secure-sockets.html) dan [Wifi](https://docs.aws.amazon.com/freertos/latest/userguide/freertos-wifi.html) tidak APIs diperlukan oleh perpustakaan [CoreMQTT](https://www.freertos.org/mqtt/index.html) terbaru. Lihat [Transport Interface](https://www.freertos.org/network-interface.html) untuk detail lebih lanjut.
## Lampiran
Tabel berikut memberikan rekomendasi untuk semua proyek demo, pustaka lama, dan abstrak APIs dalam repositori Amazon-Freertos.
**Perpustakaan dan demo yang dimigrasi**
| Nama | Tipe | Rekomendasi |
| --- | --- | --- |
| **CoreHTTP** | demo dan perpustakaan | [Kloning atau unduh pustaka CoreHTTP langsung dari repositori [CoreHTTP (sub-modul](https://github.com/FreeRTOS/coreHTTP) jika menggunakan git) di organisasi FreerTOS Github.](https://github.com/FreeRTOS) Demo CoreHTTP berada dalam distribusi [FreerTOS](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/coreHTTP_Windows_Simulator) utama. Untuk lebih jelasnya, lihat halaman [CoreHTTP](https://www.freertos.org/http/index.html). |
| CoreMQTT | demo dan perpustakaan | [Kloning atau unduh pustaka CoreMQTT langsung dari repositori [CoreMQTT (sub-modul jika menggunakan git) di organisasi FreeRTOS](https://github.com/FreeRTOS/coreMQTT) Github.](https://github.com/FreeRTOS) [Demo CoreMQTT berada dalam distribusi FreeRTOS utama.](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/coreMQTT_Windows_Simulator) Untuk detail lebih lanjut, lihat halaman [CoreMQTT](https://www.freertos.org/mqtt/index.html). |
| Agen CoreMQTT | demo dan perpustakaan | [Kloning atau unduh pustaka CoreMQTT-Agent langsung dari [repositori CoreMQTT-Agent (sub-modul jika menggunakan git) di organisasi FreeRTOS](https://github.com/FreeRTOS/coreMQTT-Agent) Github.](https://github.com/FreeRTOS) [Demo CoreMQTT-Agent ada di repositori CoreMQTT-Agent-Demos.](https://github.com/FreeRTOS/coreMQTT-Agent-Demos) Untuk detail lebih lanjut, lihat halaman Agen [CoreMQTT](https://www.freertos.org/mqtt-agent/index.html). |
| device\$1defender\$1for\$1aws | demo dan perpustakaan | [Pustaka AWS IoT Device Defender ada di repositorinya di organisasi.AWS GitHub ](https://github.com/AWS) Kloning atau unduh (sub-modul jika menggunakan git) langsung dari repositori [AWS IoT Device Defender](https://github.com/aws/Device-Defender-for-AWS-IoT-embedded-sdk). Demo AWS IoT Device Defender berada dalam distribusi [FreeRTOS](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Device_Defender_Windows_Simulator/Device_Defender_Demo) utama. Untuk detail selengkapnya, lihat [halaman AWS IoT Device Defender](https://www.freertos.org/iot-device-defender/index.html). |
| device\$1shadow\$1for\$1aws | demo dan perpustakaan | [Pustaka AWS IoT Device Shadow ada di repositorinya di organisasi.AWS GitHub ](https://github.com/AWS) Kloning atau unduh (sub-modul jika menggunakan git) langsung dari repositori [AWS IoT Device Shadow](https://github.com/aws/Device-Shadow-for-AWS-IoT-embedded-sdk)). Demo AWS IoT Device Shadow berada di distribusi [FreerTOS utama](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Device_Shadow_Windows_Simulator). Untuk detail selengkapnya, lihat [halaman AWS IoT Device Shadow](https://www.freertos.org/iot-device-shadow/index.html). |
| jobs\$1for\$1aws | demo dan perpustakaan | [Perpustakaan AWS IoT Jobs ada di repositori di organisasi.AWS GitHub ](https://github.com/AWS) Kloning atau unduh (sub-modul jika menggunakan git) langsung dari repositori [AWS IoT Jobs](https://github.com/aws/Jobs-for-AWS-IoT-embedded-sdk). Demo AWS IoT Jobs berada di distribusi [FreeRTOS utama](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Jobs_Windows_Simulator/Jobs_Demo). Untuk detail selengkapnya, lihat [halaman AWS IoT Pekerjaan](https://www.freertos.org/iot-jobs/index.html). |
| OTA | demo dan perpustakaan | [Pustaka Pembaruan AWS IoT Over-The-Air (OTA) ada di repositori di organisasi.AWS GitHub ](https://github.com/AWS) Kloning atau unduh (sub-modul jika menggunakan git) langsung dari repositori [AWS IoT OTA](https://github.com/aws/ota-for-aws-iot-embedded-sdk). Demo AWS IoT OTA berada dalam distribusi [FreeRTOS utama](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Ota_Windows_Simulator). Untuk lebih jelasnya, lihat [halaman AWS IoT OTA](https://www.freertos.org/ota/index.html). |
| CLI dan Freertos\$1Plus\$1CLI | demo dan perpustakaan | Ada contoh CLI yang berjalan di. WinSim Lihat halaman Antarmuka [Baris Perintah FreeRTOS Plus](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_CLI/FreeRTOS_Plus_Command_Line_Interface.html) untuk lebih jelasnya. Integrasi referensi IoT FreeRTOS Unggulan [pada platform RT1 NXP](https://github.com/FreeRTOS/iot-reference-nxp-rt1060/tree/main/examples/common/cli) i.MX [ STM32060](https://github.com/FreeRTOS/iot-reference-stm32u5/tree/main/Common/cli) dan U5, juga memberikan contoh CLI pada perangkat keras yang sebenarnya. |
| pencatatan log | makro | Ada implementasi makro logging untuk platform perangkat keras tertentu yang digunakan oleh beberapa pustaka FreeRTOS. Lihat [halaman logging](https://www.freertos.org/logging.html) untuk cara menerapkan makro logging. Lihat [salah satu referensi IoT unggulan FreeRTOS](https://github.com/FreeRTOS/iot-reference-nxp-rt1060/tree/main/examples/common/logging) untuk contoh yang berjalan pada perangkat keras yang sebenarnya. |
| greengrass\$1connectivity | demo | [Migrasi sedang berlangsung] Proyek demo ini mengasumsikan bahwa konektivitas cloud tersedia sebelum menghubungkan ke perangkat AWS IoT Greengrass. Sebuah proyek baru yang menunjukkan otentikasi lokal dan kemampuan penemuan sedang dalam pengembangan. Harapkan proyek demo baru akan segera diterbitkan di organisasi [FreerTOS Github](https://github.com/FreeRTOS). |
**Pustaka dan demo usang**
| Nama | Tipe | Rekomendasi |
| --- | --- | --- |
| BLE | demo dan perpustakaan | Pustaka FreeRTOS BLE mengimplementasikan protokol MQTT berpemilik dan mendukung penerbitan dan berlangganan topik MQTT melalui Bluetooth Low Energy (BLE) melalui perangkat proxy seperti ponsel. Ini tidak lagi diamanatkan. Gunakan tumpukan BLE Anda sendiri atau opsi pihak ketiga seperti [Nimble](https://mynewt.apache.org/latest/network/) untuk mengoptimalkan proyek Anda dengan sebaik-baiknya. |
| dev\$1mode\$1key\$1provisioning | demo | Integrasi referensi IoT FreeRTOS Unggulan [pada platform RT1 NXP](https://github.com/FreeRTOS/iot-reference-nxp-rt1060/blob/main/examples/common/cli/cli.c) i.MX [ STM32060](https://github.com/FreeRTOS/iot-reference-stm32u5/blob/main/Common/cli/cli_pki.c), U5, [ ESP32atau](https://github.com/FreeRTOS/iot-reference-esp32c3/blob/main/GettingStartedGuide.md) -C3 memberikan contoh penyediaan penting menggunakan CLI. |
| posix | abstraksi dan demo | Tidak direkomendasikan untuk digunakan. |
| wifi\$1provisioning | contoh | Contoh ini menunjukkan cara menyediakan WiFi kredensyal pada perangkat menggunakan library Amazon-Freertos BLE. Lihat referensi IoT Unggulan FreeRTOS [ESP32pada](https://github.com/FreeRTOS/iot-reference-esp32c3) platform C3 untuk contoh penyediaan melalui BLE. WiFi |
| Abstrak warisan APIs | code | Ini adalah APIs yang dibuat untuk menyediakan antarmuka abstrak untuk berbagai tumpukan perangkat lunak pihak ketiga, modul konektivitas, dan platform MCU dari berbagai vendor. Misalnya, ada antarmuka untuk WiFi abstraksi, soket aman, dan sebagainya. Mereka didukung di repositori Amazon-Freertos dan ada di folder. `/libraries/abstractions/` Ini tidak APIs diperlukan saat menggunakan pustaka [FreerTOS LTS](https://www.freertos.org/lts-libraries.html). |
Pustaka dan demo pada tabel di atas tidak akan mendapatkan patch keamanan atau perbaikan bug.
**Perpustakaan pihak ketiga**
Ketika demo di Amazon-Freertos menggunakan pustaka pihak ketiga, kami sarankan Anda mensub-modulnya langsung dari repositori pihak ketiga mereka.
+ **CMock**: kloning (submodule jika Anda menggunakan git) langsung dari repositori [Cmock](https://github.com/ThrowTheSwitch/CMock).
+ **jsmn**: tidak direkomendasikan dan tidak lagi didukung.
+ **lwip**[: kloningnya (submodule jika Anda menggunakan git) langsung dari repositori lwip-tcpip.](https://github.com/lwip-tcpip/lwip)
+ **lwip\$1osal**[: lihat Integrasi Referensi Unggulan FreeRTOS di [i.MX RT1 060 atau U5 untuk cara mengimplementasikan lwip\$1osal pada platform/papan](https://github.com/FreeRTOS/iot-reference-nxp-rt1060) perangkat keras Anda. STM32](https://github.com/FreeRTOS/iot-reference-stm32u5)
+ **mbedtls**[: kloningnya (submodule jika Anda menggunakan git) langsung dari repositori MBed-TLS.](https://github.com/Mbed-TLS/mbedtls) Konfigurasi dan utilitas mbedtls dapat digunakan kembali; buat salinan lokal dalam kasus ini.
+ **pkcs11**[: kloningnya (submodule jika Anda menggunakan git) langsung dari PKCS11 pustaka [inti](https://github.com/FreeRTOS/corePKCS11) atau repositori OASIS PKCS 11.](https://github.com/oasis-tcs/pkcs11)
+ **tinycbor**[: kloningnya (submodule jika Anda menggunakan git) langsung dari repositori tinycbor.](https://github.com/intel/tinycbor)
+ **tinycrypt**: kami menyarankan Anda menggunakan akselerator kripto dari platform MCU Anda, jika tersedia. [Jika Anda ingin terus menggunakan tinycrypt, kloningnya (submodule jika Anda menggunakan git) langsung dari repositori tinycrypt.](https://github.com/intel/tinycrypt)
+ **tracealyzer\$1recorder**[: kloningnya (submodul jika Anda menggunakan git) langsung dari repositori perekam jejak Percepio.](https://github.com/percepio/TraceRecorderSource)
+ **unity**: kloningnya (submodule jika Anda menggunakan git) langsung dari repositori [ThrowTheSwitch/Unity](https://github.com/ThrowTheSwitch/Unity).
+ **win\$1pcap**: win\$1pcap tidak lagi dipertahankan. Kami menyarankan Anda menggunakan libslirp, libpcap (posix), atau npcap sebagai gantinya.
**Tes porting dan tes integrasi**
Semua pengujian di bawah `/tests` folder yang diperlukan untuk memvalidasi integrasi pustaka FreeRTOS dimigrasikan ke repositori. [ FreeRTOS-Libraries-Integration-Tests](https://github.com/FreeRTOS/FreeRTOS-Libraries-Integration-Tests) Ini dapat digunakan untuk menguji implementasi PAL dan integrasi perpustakaan. Tes yang sama digunakan oleh AWS IoT Device Tester (IDT) untuk [Program Kualifikasi AWS Perangkat untuk FreeRTOS](https://docs.aws.amazon.com/freertos/latest/qualificationguide/afr-qualification.html).