Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memulai dengan kit Cypress CY8 CKIT-064S0S2-4343W
**penting**
Integrasi referensi ini di-host di repositori Amazon-Freertos yang tidak digunakan lagi. Kami menyarankan Anda [mulai di sini](freertos-getting-started-modular.md) ketika Anda membuat proyek baru. Jika Anda sudah memiliki proyek FreeRTOS yang sudah ada berdasarkan repositori Amazon-Freertos yang sekarang tidak digunakan lagi, lihat. [Panduan Migrasi Repositori Github Amazon-freertos](github-repo-migration.md)
Tutorial ini memberikan petunjuk untuk memulai dengan [CY8kit CKIT-064S0S2-4343W](https://www.cypress.com/CY8CKIT-064S0S2-4343W). Jika Anda belum memilikinya, Anda dapat menggunakan tautan itu untuk membeli kit. Anda juga dapat menggunakan tautan itu untuk mengakses panduan pengguna kit.
## Memulai
Sebelum Anda mulai, Anda harus mengkonfigurasi AWS IoT dan FreeRTOS untuk menghubungkan perangkat Anda ke Cloud. AWS Untuk petunjuk, lihat [Langkah pertama](freertos-prereqs.md). Setelah Anda menyelesaikan prasyarat, Anda akan memiliki paket FreeRTOS dengan kredensyal. AWS IoT Core
**catatan**
Dalam tutorial ini, jalur ke direktori unduhan FreeRTOS yang dibuat di bagian “Langkah pertama” disebut sebagai. `freertos`
## Menyiapkan lingkungan pengembangan
FreeRTOS bekerja dengan alur build atau CMake Make. Anda dapat menggunakan ModusToolbox alur Make build Anda. Anda dapat menggunakan Eclipse IDE yang dikirimkan dengan ModusToolbox atau IDE mitra seperti IAR EW-ARM, Arm MDK, atau Microsoft Visual Studio Code. Eclipse IDE kompatibel dengan sistem operasi Windows, macOS, dan Linux.
Sebelum Anda mulai, unduh dan instal perangkat [ModusToolbox lunak](https://www.cypress.com/products/modustoolbox-software-environment) terbaru. Untuk informasi selengkapnya, lihat [Panduan ModusToolbox Instalasi](https://www.cypress.com/ModusToolboxInstallGuide).
### Memperbarui alat untuk ModusToolbox 2.1 atau yang lebih lama
Jika Anda menggunakan ModusToolbox 2.1 Eclipse IDE untuk memprogram kit ini, Anda harus memperbarui alat OpenOCD dan Firmware-loader.
Dalam langkah-langkah berikut, secara default `ModusToolbox` jalur untuk:
+ Windows adalah`C:\Users\user_name\ModusToolbox`.
+ Linux adalah `user_home/ModusToolbox` atau di mana Anda memilih untuk mengekstrak file arsip.
+ macOS berada di bawah folder Aplikasi dalam volume yang Anda pilih di wizard.
#### Memperbarui OpenOCD
Kit ini membutuhkan Cypress OpenOCD 4.0.0 atau yang lebih baru untuk berhasil menghapus dan memprogram chip.
**Untuk memperbarui Cypress OpenOCD**
1. Buka halaman rilis [Cypress OpenOCD](https://github.com/Infineon/openocd/releases).
1. Unduh file arsip untuk OS Anda (Windows/Mac/Linux).
1. Hapus file yang ada di`ModusToolbox/tools_2.x/openocd`.
1. Ganti file `ModusToolbox/tools_2.x/openocd` dengan konten yang diekstrak dari arsip yang Anda unduh pada langkah sebelumnya.
#### Memperbarui Firmware-loader
Kit ini membutuhkan Cypress Firmware-loader 3.0.0 atau yang lebih baru.
**Untuk memperbarui Cypress Firmware-loader**
1. Buka halaman rilis [Cypress Firmware-loader](https://github.com/cypresssemiconductorco/Firmware-loader/releases).
1. Unduh file arsip untuk OS Anda (Windows/Mac/Linux).
1. Hapus file yang ada di`ModusToolbox/tools_2.x/fw-loader`.
1. Ganti file `ModusToolbox/tools_2.x/fw-loader` dengan konten yang diekstrak dari arsip yang Anda unduh pada langkah sebelumnya.
Atau, Anda dapat menggunakan CMake untuk menghasilkan file build proyek dari kode sumber aplikasi FreeRTOS, membangun proyek menggunakan alat build pilihan Anda, dan kemudian memprogram kit menggunakan OpenOCD. Jika Anda lebih suka menggunakan alat GUI untuk pemrograman dengan CMake alur, unduh dan instal Cypress Programmer dari halaman web Cypress Programming [Solutions](https://www.cypress.com/products/psoc-programming-solutions). Untuk informasi selengkapnya, lihat [Menggunakan CMake dengan FreeRTOS](getting-started-cmake.md).
## Menyiapkan perangkat keras Anda
Ikuti langkah-langkah ini untuk mengatur perangkat keras kit.
1.
**Menyediakan kit Anda**
Ikuti [Panduan Penyediaan untuk instruksi Kit CY8 CKIT-064S0S2-4343W untuk menyediakan kit](https://community.cypress.com/docs/DOC-20043) Anda dengan aman. AWS IoT
Kit ini membutuhkan CySecureTools 3.1.0 atau yang lebih baru.
1. **Siapkan koneksi serial**
1. Hubungkan kit ke komputer host Anda.
1. Port Serial USB untuk kit secara otomatis disebutkan di komputer host. Identifikasi nomor port. Di Windows, Anda dapat mengidentifikasinya menggunakan **Device Manager** di bawah **Ports** (COM & LPT).
1. Mulai terminal serial dan buka koneksi dengan pengaturan berikut:
+ Tingkat baud: 115200
+ Data: 8 bit
+ Paritas: Tidak ada
+ Hentikan bit: 1
+ Kontrol aliran: Tidak ada
## Bangun dan jalankan proyek Demo FreeRTOS
Di bagian ini Anda membangun dan menjalankan demo.
1. Pastikan untuk mengikuti langkah-langkah dalam [Panduan Penyediaan Kit CY8 CKIT-064S0S2-4343W](https://community.cypress.com/docs/DOC-20043).
1. **Bangun Demo FreeRTOS.**
1. Buka Eclipse IDE untuk ModusToolbox dan pilih, atau buat, ruang kerja.
1. Dari menu **File**, pilih **Impor**.
Expand **General**, pilih **Existing Project Into Workspace**, lalu pilih **Next**.
1. Di **Root Directory**, masukkan `freertos/projects/cypress/CY8CKIT-064S0S2-4343W/mtb/aws_demos` dan kemudian pilih nama proyek`aws_demos`. Itu harus dipilih secara default.
1. Pilih **Selesai** untuk mengimpor proyek ke ruang kerja Anda.
1. Bangun aplikasi dengan melakukan salah satu hal berikut:
+ Dari **Quick Panel**, pilih **Build aws\$1demos** Application.
+ Pilih **Project** dan pilih **Build All**.
Pastikan proyek dikompilasi tanpa kesalahan.
1.
**Memantau Pesan MQTT di Cloud**
Sebelum menjalankan demo, Anda dapat mengatur klien MQTT di AWS IoT konsol untuk memantau pesan yang dikirim perangkat Anda ke Cloud. AWS Untuk berlangganan topik MQTT dengan klien AWS IoT MQTT, ikuti langkah-langkah ini.
1. Masuk ke [konsol AWS IoT](https://console.aws.amazon.com//iotv2/) tersebut.
1. Di panel navigasi, pilih **Uji**, lalu pilih klien **pengujian MQTT untuk membuka klien** MQTT.
1. Untuk **topik Langganan**, masukkan***your-thing-name*/example/topic**, lalu pilih **Berlangganan topik**.
1. **Jalankan proyek demo FreeRTOS**
1. Pilih proyek `aws_demos` di ruang kerja.
1. Dari **Quick Panel**, pilih **aws\$1demos Program** (3). KitProg Ini memprogram papan dan aplikasi demo mulai berjalan setelah pemrograman selesai.
1. Anda dapat melihat status aplikasi yang sedang berjalan di terminal serial. Gambar berikut menunjukkan bagian dari output terminal.
![\[Screenshot dari output terminal setelah Anda membangun aws_demo proyek.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/gsg-psoc64-terminal-output.png)
Demo MQTT menerbitkan pesan tentang empat topik berbeda (`iotdemo/topic/n`, di mana n = 1 hingga 4) dan berlangganan semua topik tersebut untuk menerima pesan yang sama kembali. Ketika pesan diterima, demo menerbitkan pesan pengakuan tentang topik tersebut. `iotdemo/acknowledgements` Daftar berikut menjelaskan pesan debug yang muncul di output terminal, dengan referensi ke nomor seri pesan. Pada output, detail driver WICED Host Driver (WHD) dicetak terlebih dahulu tanpa penomoran seri.
1. 1 hingga 4 — Perangkat terhubung ke Access Point (AP) yang dikonfigurasi dan disediakan dengan menghubungkan ke AWS server menggunakan titik akhir dan sertifikat yang dikonfigurasi.
1. 5 hingga 13 - pustaka CoreMQTT diinisialisasi dan perangkat membuat koneksi MQTT.
1. 14 hingga 17 — Perangkat berlangganan semua topik untuk menerima pesan yang dipublikasikan kembali.
1. 18 hingga 30 - Perangkat menerbitkan dua pesan dan menunggu untuk menerimanya kembali. Ketika setiap pesan diterima, perangkat mengirimkan pesan pengakuan.
Siklus publikasi, penerimaan, dan pengakuan yang sama berlanjut sampai semua pesan dipublikasikan. Dua pesan diterbitkan per siklus hingga jumlah siklus yang dikonfigurasi selesai.
1.
**Menggunakan CMake dengan FreeRTOS**
Anda juga dapat menggunakan CMake untuk membangun dan menjalankan aplikasi demo. Untuk menyiapkan CMake dan sistem build asli, lihat[Prasyarat](getting-started-cmake.md#building-cmake-prereqs).
1. Gunakan perintah berikut untuk menghasilkan file build. Tentukan papan target dengan `-DBOARD` opsi.
```
cmake -DVENDOR=cypress -DBOARD=CY8CKIT_064S0S2_4343W -DCOMPILER=arm-gcc -S freertos -B build_dir
```
Jika Anda menggunakan Windows, Anda harus menentukan sistem build asli menggunakan `-G` opsi karena CMake menggunakan Visual Studio secara default.
**Example**
```
cmake -DVENDOR=cypress -DBOARD=CY8CKIT_064S0S2_4343W -DCOMPILER=arm-gcc -S freertos -B build_dir -G Ninja
```
Jika tidak `arm-none-eabi-gcc` ada di jalur shell Anda, Anda juga perlu mengatur `AFR_TOOLCHAIN_PATH` CMake variabel.
**Example**
```
-DAFR_TOOLCHAIN_PATH=/home/user/opt/gcc-arm-none-eabi/bin
```
1. Gunakan perintah berikut untuk membangun proyek menggunakan CMake.
```
cmake --build build_dir
```
1. Akhirnya, program `cm0.hex` dan `cm4.hex` file yang dihasilkan di bawah `build_dir` dengan menggunakan Cypress Programmer.
### Menjalankan demo lainnya
Aplikasi demo berikut telah diuji dan diverifikasi untuk bekerja dengan rilis saat ini. Anda dapat menemukan demo ini di bawah `freertos/demos` direktori. Untuk informasi tentang cara menjalankan demo ini, lihat[Demo FreeRTOS](freertos-next-steps.md).
+ Demo Bluetooth Energi Rendah
+ Over-the-Air Pembaruan demo
+ Demo Klien Echo Soket Aman
+ AWS IoT Demo Device Shadow
## Debugging
KitProg3 pada kit mendukung debugging melalui protokol SWD.
+ **Untuk men-debug aplikasi FreeRTOS, pilih proyek aws\$1demos **di ruang kerja dan kemudian **pilih** aws\$1demos Debug** (3) dari Quick Panel. KitProg**
## Pembaruan OTA
PSoC 64 MCUs telah lulus semua tes kualifikasi FreeRTOS yang diperlukan. Namun, fitur opsional over-the-air (OTA) yang diterapkan di pustaka AWS firmware PSo C 64 Standard Secure masih menunggu evaluasi. Fitur OTA sebagaimana diterapkan saat ini lulus semua tes kualifikasi OTA kecuali [aws\$1ota\$1test\$1case\$1rollback\$1if\$1unable\$1to\$1connect\$1after\$1update.py](https://github.com/aws/amazon-freertos/blob/202012.00/tools/ota_e2e_tests/aws_ota_test/aws_ota_test_case_rollback_if_unable_to_connect_after_update.py).
Ketika gambar OTA yang berhasil divalidasi diterapkan ke perangkat menggunakan PSo C64 Standard Secure — AWS MCU dan perangkat tidak dapat berkomunikasi dengannya AWS IoT Core, perangkat tidak dapat secara otomatis mengembalikan ke gambar bagus asli yang diketahui. Ini mungkin mengakibatkan perangkat tidak dapat dijangkau AWS IoT Core untuk pembaruan lebih lanjut. Fungsi ini masih dalam pengembangan oleh tim Cypress.
Untuk informasi lebih lanjut, lihat [Pembaruan OTA dengan AWS dan CY8 Kit CKIT-064S0S2-4343W](https://community.cypress.com/docs/DOC-20063). Jika Anda memiliki pertanyaan lebih lanjut atau memerlukan dukungan teknis, hubungi [Komunitas Pengembang Cypress](https://community.cypress.com).