Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memulai dengan Xilinx Avnet MicroZed Industrial IoT Kit
**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 instruksi untuk memulai dengan Xilinx Avnet MicroZed Industrial IoT Kit. [Jika Anda tidak memiliki Kit IoT MicroZed Industri Xilinx Avnet, kunjungi Katalog Perangkat Mitra untuk AWS membelinya dari mitra kami.](https://devices.amazonaws.com/detail/a3G0L00000AANtqUAH/MicroZed-IIoT-Bundle-with-Amazon-FreeRTOS)
Sebelum memulai, Anda harus mengonfigurasi AWS IoT dan mengunduh FreeRTOS Anda untuk menghubungkan perangkat Anda ke Cloud. AWS Lihat [Langkah pertama](freertos-prereqs.md) untuk instruksi. Dalam tutorial ini, jalur ke direktori unduhan FreeRTOS disebut sebagai. `freertos`
## Gambaran Umum
Tutorial ini berisi petunjuk untuk langkah-langkah memulai berikut:
1. Menghubungkan papan Anda ke mesin host.
1. Menginstal perangkat lunak pada mesin host untuk mengembangkan dan men-debug aplikasi tertanam untuk papan mikrokontroler Anda.
1. Menyusun silang aplikasi demo FreeRTOS ke gambar biner.
1. Memuat gambar biner aplikasi ke papan Anda, dan kemudian menjalankan aplikasi.
## Siapkan perangkat MicroZed keras
Diagram berikut mungkin berguna ketika Anda mengatur perangkat MicroZed keras:
![\[AVNet papan mikrokontroler dengan Power Good LED, LED Pengguna dan tombol tekan, akses JTAG, 10/100/1000 Ethernet dan host USB, slot microSD, USB-UART, Done LED, tombol Reset, dan jumper MODE Boot disorot.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/microzed.png)
**Untuk mengatur MicroZed papan**
1. Hubungkan komputer Anda ke port USB-UART di papan Anda. MicroZed
1. Hubungkan komputer Anda ke port JTAG Access di MicroZed papan Anda.
1. Hubungkan router atau port Ethernet yang terhubung ke internet ke port Ethernet dan USB-host di papan Anda. MicroZed
## Siapkan lingkungan pengembangan Anda
Untuk mengatur konfigurasi FreeRTOS untuk MicroZed kit, Anda harus menggunakan Xilinx Software Development Kit (XSDK). XSDK didukung pada Windows dan Linux.
### Unduh dan instal XSDK
Untuk menginstal perangkat lunak Xilinx, Anda memerlukan akun Xilinx gratis.
**Untuk mengunduh XSDK**
1. Buka halaman unduhan [ WebInstall Klien Standalone Kit Pengembangan Perangkat Lunak](https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools/2019-1.html).
1. Pilih opsi yang sesuai untuk sistem operasi Anda.
1. Anda diarahkan ke halaman masuk Xilinx.
**Jika Anda memiliki akun dengan Xilinx, masukkan kredensyal masuk Anda, lalu pilih Masuk.**
Jika Anda tidak memiliki akun, pilih **Buat akun Anda**. Setelah mendaftar, Anda akan menerima email dengan tautan untuk mengaktifkan akun Xilinx Anda.
1. Pada halaman **Verifikasi Nama dan Alamat**, masukkan informasi Anda, lalu pilih **Berikutnya**. Unduhan harus siap untuk dimulai.
1. Simpan file `Xilinx_SDK_version_os`.
**Untuk menginstal XSDK**
1. Buka file `Xilinx_SDK_version_os`.
1. **Di **Select Edition to Install**, pilih **Xilinx Software Development Kit (XSDK)** dan kemudian pilih Berikutnya.**
1. Pada halaman berikut dari panduan instalasi, di bawah **Opsi Instalasi**, pilih **Instal Driver Kabel** dan kemudian pilih **Berikutnya**.
Jika komputer Anda tidak mendeteksi koneksi USB-UART, instal driver CP21 0x USB-to-UART Bridge VCP secara manual. MicroZed Untuk petunjuk, lihat [Panduan USB-to-UART Instalasi Silicon Labs CP21 0x](https://www.xilinx.com/support/documentation/boards_and_kits/install/ug1033-cp210x-usb-uart-install.pdf).
Untuk informasi selengkapnya tentang XSDK, lihat [Memulai dengan Xilinx SDK di situs web Xilink](https://www.xilinx.com/html_docs/xilinx2018_2/SDK_Doc/index.html).
## Memantau pesan MQTT di cloud
Sebelum menjalankan proyek demo FreeRTOS, Anda dapat mengatur klien MQTT di konsol untuk memantau pesan AWS IoT yang dikirim perangkat Anda ke Cloud. AWS
**Untuk berlangganan topik MQTT dengan klien MQTT AWS IoT**
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. Dalam **Subscription topic**, masukkan***your-thing-name*/example/topic**, lalu pilih **Subscribe to topic**.
## Bangun dan jalankan proyek demo FreeRTOS
### Buka demo FreeRTOS di IDE XSDK
1. Luncurkan IDE XSDK dengan direktori ruang kerja yang disetel ke. `freertos/projects/xilinx/microzed/xsdk`
1. Tutup halaman selamat datang. Dari menu, pilih **Project**, lalu hapus **Build Automatically**.
1. Dari menu, pilih **File**, lalu pilih **Impor**.
1. Pada halaman **Pilih**, perluas **Umum**, pilih **Proyek yang Ada ke Ruang Kerja**, lalu pilih **Berikutnya**.
1. Pada halaman **Impor Proyek**, **pilih Pilih direktori root**, lalu masukkan direktori root proyek demo Anda:`freertos/projects/xilinx/microzed/xsdk/aws_demos`. Untuk menelusuri direktori, pilih **Browse**.
Setelah Anda menentukan direktori root, proyek di direktori tersebut akan muncul di halaman **Impor Proyek**. Semua proyek yang tersedia dipilih secara default.
**catatan**
Jika Anda melihat peringatan di bagian atas halaman **Impor Proyek** (“Beberapa proyek tidak dapat diimpor karena sudah ada di ruang kerja.”) Anda dapat mengabaikannya.
1. Dengan semua proyek yang dipilih, pilih **Selesai**.
1. Jika Anda tidak melihat`aws_bsp`,`fsbl`, dan `MicroZed_hw_platform_0` proyek di panel proyek, ulangi langkah sebelumnya mulai dari \$13 tetapi dengan direktori root disetel ke`freertos/vendors/xilinx`, dan import`aws_bsp`,`fsbl`, dan`MicroZed_hw_platform_0`.
1. Dari menu, pilih **Jendela**, lalu pilih **Preferensi**.
1. **Di panel navigasi, perluas **Run/Debug**, pilih **String Substitution**, dan kemudian pilih New.**
1. Dalam **Variabel Substitusi String Baru**, untuk **Nama**, masukkan**AFR\$1ROOT**. Untuk **Nilai**, masukkan jalur root dari file`freertos/projects/xilinx/microzed/xsdk/aws_demos`. Pilih **OK**, lalu pilih **OK** untuk menyimpan variabel dan menutup **Preferensi**.
### Bangun proyek demo FreeRTOS
1. **Di XSDK IDE, dari menu, pilih **Project**, lalu pilih Clean.**
1. Di **Bersih**, biarkan opsi pada nilai defaultnya, lalu pilih **OK**. XSDK membersihkan dan membangun semua proyek, dan kemudian menghasilkan file. `.elf`
**catatan**
Untuk membangun semua proyek tanpa membersihkannya, pilih **Project**, lalu pilih **Build All**.
Untuk membangun proyek individual, pilih proyek yang ingin Anda bangun, pilih **Project**, lalu pilih **Build Project**.
### Hasilkan image boot untuk proyek demo FreeRTOS
1. **Di XSDK IDE, klik kanan **aws\$1demos**, lalu pilih Create Boot Image.**
1. Di **Buat Gambar Boot**, pilih **Buat file BIF baru**.
1. Di sebelah **jalur file Output BIF**, pilih **Browse**, lalu pilih `aws_demos.bif` located at`/vendors/xilinx/microzed/aws_demos/aws_demos.bif`.
1. Pilih **Tambahkan**.
1. Pada **Tambahkan partisi gambar boot baru**, di sebelah **jalur File**, pilih **Browse**, lalu pilih`fsbl.elf`, terletak di`vendors/xilinx/fsbl/Debug/fsbl.elf`.
1. Untuk **jenis partisi**, pilih **bootloader**, dan kemudian pilih **OK**.
1. Pada **Create Boot Image**, pilih **Create Image**. Pada **Override Files**, pilih **OK** untuk menimpa yang ada `aws_demos.bif` dan menghasilkan `BOOT.bin` file di. `projects/xilinx/microzed/xsdk/aws_demos/BOOT.bin`
### Debugging JTAG
1. Atur jumper mode boot MicroZed papan Anda ke mode boot JTAG.
![\[Konektor header papan sirkuit dan pengaturan jumper.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/xilinx-jtag.png)
1. Masukkan kartu microSD Anda ke dalam slot kartu microSD yang terletak tepat di bawah port USB-UART.
**catatan**
Sebelum Anda men-debug, pastikan untuk mencadangkan konten apa pun yang Anda miliki di kartu microSD.
Papan Anda akan terlihat mirip dengan yang berikut ini:
![\[Papan evaluasi FreeRTOS dengan opsi konektivitas.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/xilinx-jtag-full-board.png)
1. Di XSDK IDE, klik kanan **aws\$1demos, pilih Debug As****, lalu pilih **1 Launch** on System Hardware (System Debugger**).
1. **Ketika debugger berhenti di breakpoint`main()`, dari menu, pilih **Jalankan, lalu pilih Lanjutkan**.**
**catatan**
Pertama kali Anda menjalankan aplikasi, pasangan kunci sertifikat baru diimpor ke memori non-volatile. Untuk proses selanjutnya, Anda dapat berkomentar `vDevModeKeyProvisioning()` di `main.c` file sebelum Anda membangun kembali gambar dan `BOOT.bin` file. Ini mencegah penyalinan sertifikat dan kunci penyimpanan di setiap proses.
Anda dapat memilih untuk mem-boot MicroZed papan Anda dari kartu microSD atau dari flash QSPI untuk menjalankan proyek demo FreeRTOS. Lihat petunjuknya di [Hasilkan image boot untuk proyek demo FreeRTOS](#xilinx-build-boot-image) dan [Jalankan proyek demo FreeRTOS](#xilinx-run).
### Jalankan proyek demo FreeRTOS
Untuk menjalankan proyek demo FreeRTOS, Anda dapat mem-boot MicroZed papan Anda dari kartu microSD atau dari flash QSPI.
Saat Anda mengatur MicroZed papan Anda untuk menjalankan proyek demo FreeRTOS, lihat diagram di. [Siapkan perangkat MicroZed keras](#xilinx-setup-hardware) Pastikan Anda telah menghubungkan MicroZed papan Anda ke komputer Anda.
#### Boot proyek FreeRTOS dari kartu microSD
Format kartu microSD yang disediakan dengan Xilinx MicroZed Industrial IoT Kit.
1. Salin `BOOT.bin` file ke kartu microSD.
1. Masukkan kartu ke slot kartu microSD langsung di bawah port USB-UART.
1. Atur jumper mode MicroZed boot ke mode boot SD.
![\[Kartu SD dengan tiga slot berlabel JP1, JP2, JP3 dan tempat baterai sel koin.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/xilinx-sd.png)
1. Tekan tombol RST untuk mengatur ulang perangkat dan mulai mem-boot aplikasi. Anda juga dapat mencabut kabel USB-UART dari port USB-UART, lalu memasukkan kembali kabel.
#### Boot proyek demo FreeRTOS dari flash QSPI
1. Atur jumper mode boot MicroZed papan Anda ke mode boot JTAG.
![\[Konektor header papan sirkuit dan pengaturan jumper.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/xilinx-jtag.png)
1. Verifikasi bahwa komputer Anda terhubung ke port Akses USB-UART dan JTAG. Lampu LED Power Good hijau harus diterangi.
1. **Di XSDK IDE, dari menu, pilih **Xilinx**, dan kemudian pilih Program Flash.**
1. Dalam **Program Flash Memory**, platform perangkat keras harus diisi secara otomatis. Untuk **Koneksi**, pilih server MicroZed perangkat keras Anda untuk menghubungkan papan Anda dengan komputer host Anda.
**catatan**
Jika Anda menggunakan kabel Xilinx Smart Lync JTAG, Anda harus membuat server perangkat keras di XSDK IDE. Pilih **Baru**, lalu tentukan server Anda.
1. Di **File Gambar**, masukkan jalur direktori ke file `BOOT.bin` gambar Anda. Pilih **Browse** untuk menelusuri file sebagai gantinya.
1. Di **Offset**, masukkan**0x0**.
1. Di **File FSBL**, masukkan jalur direktori ke file Anda`fsbl.elf`. Pilih **Browse** untuk menelusuri file sebagai gantinya.
1. Pilih **Program** untuk memprogram papan Anda.
1. Setelah pemrograman QSPI selesai, lepaskan kabel USB-UART untuk mematikan papan.
1. Atur jumper mode boot MicroZed papan Anda ke mode boot QSPI.
1. Masukkan kartu Anda ke slot kartu microSD yang terletak tepat di bawah port USB-UART.
**catatan**
Pastikan untuk mencadangkan konten apa pun yang Anda miliki di kartu microSD.
1. Tekan tombol RST untuk mengatur ulang perangkat dan mulai mem-boot aplikasi. Anda juga dapat mencabut kabel USB-UART dari port USB-UART, lalu memasukkan kembali kabel.
## Pemecahan Masalah
Jika Anda menemukan kesalahan build yang terkait dengan jalur yang salah, cobalah untuk membersihkan dan membangun kembali proyek, seperti yang dijelaskan dalam[Bangun proyek demo FreeRTOS](#xilinx-freertos-build-project).
Jika Anda menggunakan Windows, pastikan Anda menggunakan garis miring maju saat Anda mengatur variabel substitusi string di Windows XSDK IDE.
Untuk informasi pemecahan masalah umum tentang Memulai FreeRTOS, lihat. [Pemecahan masalah memulai](gsg-troubleshooting.md)