Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memulai dengan Microchip Curiosity PIC32MZ EF
**penting**
Integrasi referensi ini di-host di Amazon-FreeRTOS repositori 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 ada berdasarkan repositori yang sekarang tidak digunakan lagi, Amazon-FreeRTOS lihat. [Amazon-FreeRTOS Panduan Migrasi Repositori Github](github-repo-migration.md)
**catatan**
Sesuai dengan Microchip, kami menghapus Curiosity PIC32MZEF (DM320104) dari cabang utama repositori FreeRTOS Reference Integration dan tidak akan lagi membawanya dalam rilis baru. Microchip telah mengeluarkan [pemberitahuan resmi](https://www.microchip.com/DevelopmentTools/ProductDetails/PartNO/DM320104) bahwa PIC32MZEF (DM320104) tidak lagi direkomendasikan untuk desain baru. Proyek PIC32MZEF dan kode sumber masih dapat diakses melalui tag rilis sebelumnya. Microchip merekomendasikan agar pelanggan menggunakan [papan Curiosity PIC32MZ-EF-2.0 Development (DM320209](https://devices.amazonaws.com/detail/a3G0h0000077I69EAE/Curiosity-PIC32MZ-EF-2-0-Development-Board)) untuk desain baru. [Platform Pic32Mzv1 masih dapat ditemukan di v202012.00 dari repositori Integrasi Referensi FreeRTOS.](https://github.com/aws/amazon-freertos/tree/202012.00) Namun, platform ini tidak lagi didukung oleh Referensi FreeRTOS [v202107.00](https://github.com/aws/amazon-freertos/tree/202107.00).
Tutorial ini memberikan instruksi untuk memulai dengan Microchip Curiosity PIC32MZ EF. [Jika Anda tidak memiliki paket Microchip Curiosity PIC32MZ EF, kunjungi Katalog Perangkat AWS Mitra untuk membelinya dari mitra kami.](https://devices.amazonaws.com/detail/a3G0L00000AANscUAH/Curiosity-PIC32MZ-EF-Amazon-FreeRTOS-Bundle)
Bundel ini mencakup item-item berikut:
+ [Curiosity PIC32MZ Papan Pengembangan EF](https://www.microchip.com/Developmenttools/ProductDetails/DM320104)
+ [MikroElectronika Papan Klik UART USB](https://www.mikroe.com/usb-uart-click)
+ [MikroElectronika WiFi 7 klik Papan](https://www.mikroe.com/wifi-7-click)
+ [PIC32 LAN8720 PHY papan putri](http://www.microchip.com/DevelopmentTools/ProductDetails.aspx?PartNO=ac320004-3)
Anda juga memerlukan item berikut untuk debugging:
+ [MPLAB Snap Debugger In-Circuit ](https://www.microchip.com/Developmenttools/ProductDetails/PG164100)
+ (Opsional) Kit [Kabel Pemrograman PickIt 3](https://www.microchip.com/TPROG001)
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.
**penting**
Dalam topik ini, jalur ke direktori unduhan FreeRTOS disebut sebagai. `{{freertos}}`
Karakter ruang di `{{freertos}}` jalur dapat menyebabkan kegagalan build. Saat Anda mengkloning atau menyalin repositori, pastikan jalur yang Anda buat tidak berisi karakter spasi.
Panjang maksimum jalur file di Microsoft Windows adalah 260 karakter. Jalur direktori unduhan FreeRTOS yang panjang dapat menyebabkan kegagalan build.
Karena kode sumber mungkin berisi tautan simbolis, jika Anda menggunakan Windows untuk mengekstrak arsip, Anda mungkin harus:
Aktifkan [Mode Pengembang](https://docs.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development) atau,
Gunakan konsol yang ditinggikan sebagai administrator.
Dengan cara ini, Windows dapat membuat tautan simbolis dengan benar saat mengekstrak arsip. Jika tidak, tautan simbolis akan ditulis sebagai file normal yang berisi jalur tautan simbolis sebagai teks atau kosong. Untuk informasi lebih lanjut, lihat entri blog [Symlinks di Windows 10\!](https://blogs.windows.com/windowsdeveloper/2016/12/02/symlinks-windows-10/) .
Jika Anda menggunakan Git di bawah Windows, Anda harus mengaktifkan Mode Pengembang atau Anda harus:
Setel `core.symlinks` ke true dengan perintah berikut:
```
git config --global core.symlinks true
```
Gunakan konsol yang ditinggikan sebagai administrator setiap kali Anda menggunakan perintah git yang menulis ke sistem (misalnya,**git pull**,**git clone**, dan**git submodule update --init --recursive**).
## Ikhtisar
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.
1. Berinteraksi dengan aplikasi yang berjalan di papan Anda di seluruh koneksi serial, untuk tujuan pemantauan dan debugging.
## Siapkan perangkat keras Microchip Curiosity PIC32MZ EF
1. Hubungkan MikroElectronika USB UART klik Board ke konektor MicroBus 1 pada Microchip Curiosity PIC32MZ EF.
1. Hubungkan papan putri PIC32 LAN8720 PHY ke header J18 pada Microchip Curiosity PIC32MZ EF.
1. Hubungkan Papan klik UART MikroElectronika USB ke komputer Anda menggunakan kabel USB A ke USB Mini-B.
1. Untuk menghubungkan papan Anda ke internet, gunakan salah satu opsi berikut:
+ Untuk menggunakan **Wi-Fi**, sambungkan Papan MikroElectronika Wi-Fi 7 klik ke konektor MicroBus 2 pada Microchip Curiosity PIC32MZ EF. Lihat [Mengkonfigurasi demo FreeRTOS](freertos-prereqs.md#freertos-configure).
+ Untuk menggunakan **Ethernet** untuk menghubungkan Microchip Curiosity PIC32MZ EF Board ke internet, sambungkan papan putri PIC32 LAN8720 PHY ke header J18 pada Microchip Curiosity PIC32MZ EF. Hubungkan salah satu ujung kabel Ethernet ke papan putri LAN8720 PHY. Hubungkan ujung lainnya ke router Anda atau port internet lainnya. Anda juga harus mendefinisikan makro `PIC32_USE_ETHERNET` preprocessor.
1. Jika belum dilakukan, solder konektor sudut ke header ICSP pada Microchip Curiosity PIC32MZ EF.
1. Hubungkan salah satu ujung kabel ICSP dari Kit Kabel Pemrograman PickIt 3 ke Microchip Curiosity PIC32MZ EF.
Jika Anda tidak memiliki Kit Kabel Pemrograman PickIt 3, Anda dapat menggunakan jumper kawat M-F Dupont untuk menghubungkan koneksi sebagai gantinya. Perhatikan bahwa lingkaran putih menandakan posisi Pin 1.
1. Hubungkan ujung lain dari kabel ICSP (atau jumper) ke MPLAB Snap Debugger. Pin 1 dari Konektor Pemrograman SIL 8-pin ditandai dengan segitiga hitam di kanan bawah papan.
Pastikan bahwa setiap kabel ke Pin 1 pada Microchip Curiosity PIC32MZ EF, ditandai dengan lingkaran putih, sejajar dengan Pin 1 pada MPLAB Snap Debugger.
[Untuk informasi selengkapnya tentang MPLAB Snap Debugger, lihat MPLAB Snap Debugger Information Sheet. In-Circuit ](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLAB%20Snap%20In-Circuit%20Debugger%20IS%20DS50002787A.pdf)
## Siapkan perangkat keras Microchip Curiosity PIC32MZ EF menggunakan PickIt On Board (PKOB)
Kami menyarankan Anda mengikuti prosedur pengaturan di bagian sebelumnya. Namun, Anda dapat mengevaluasi dan menjalankan demo FreeRTOS dengan debugging dasar menggunakan PickIt On Board (PKOB) terintegrasi dengan mengikuti langkah-langkah ini. programmer/debugger
1. Hubungkan MikroElectronika USB UART klik Board ke konektor MicroBus 1 pada Microchip Curiosity PIC32MZ EF.
1. Untuk menghubungkan papan Anda ke internet, lakukan salah satu hal berikut:
+ Untuk menggunakan **Wi-Fi**, sambungkan Papan MikroElectronika Wi-Fi 7 klik ke konektor MicroBus 2 pada Microchip Curiosity PIC32MZ EF. (Ikuti langkah-langkah “Untuk mengkonfigurasi Anda Wi-Fi” di[Mengkonfigurasi demo FreeRTOS](freertos-prereqs.md#freertos-configure).
+ Untuk menggunakan **Ethernet** untuk menghubungkan Microchip Curiosity PIC32MZ EF Board ke internet, sambungkan papan putri PIC32 LAN8720 PHY ke header J18 pada Microchip Curiosity PIC32MZ EF. Hubungkan salah satu ujung kabel Ethernet ke papan putri LAN8720 PHY. Hubungkan ujung lainnya ke router Anda atau port internet lainnya. Anda juga harus mendefinisikan makro `PIC32_USE_ETHERNET` preprocessor.
1. Hubungkan port USB micro-B bernama “USB DEBUG” pada Microchip Curiosity PIC32MZ EF Board ke komputer Anda menggunakan kabel USB tipe A ke USB Micro-B.
1. Hubungkan Papan klik UART MikroElectronika USB ke komputer Anda menggunakan kabel USB A ke USB Mini-B.
## Siapkan lingkungan pengembangan Anda
**catatan**
Proyek FreeRTOS untuk perangkat ini didasarkan pada MPLAB Harmony v2. Untuk membangun proyek, Anda perlu menggunakan versi alat MPLAB yang kompatibel dengan Harmony v2, seperti v2.10 MPLAB XC32 Compiler dan versi 2. X.X dari MPLAB Harmony Configurator (MHC).
1. Instal [Python versi 3.x](https://www.python.org/downloads/) atau yang lebih baru.
1. Instal MPLAB X IDE:
**catatan**
FreeRTOS AWS Reference Integrations v202007.00 saat ini didukung hanya pada. MPLabv5.35 Versi Integrasi AWS Referensi FreeRTOS sebelumnya didukung pada. MPLabv5.40
**MPLabv5.35 download**
+ [MPLAB X Lingkungan Pengembangan Terpadu untuk Windows](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLABX-v5.35-windows-installer.exe)
+ [MPLAB X Lingkungan Pengembangan Terpadu untuk macOS](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLABX-v5.35-osx-installer.dmg)
+ [MPLAB X Lingkungan Pengembangan Terpadu untuk Linux](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLABX-v5.35-linux-installer.tar)
**Unduhan MPLab terbaru () MPLabv5.40**
+ [MPLAB X Lingkungan Pengembangan Terpadu untuk Windows](http://www.microchip.com/mplabx-ide-windows-installer)
+ [MPLAB X Lingkungan Pengembangan Terpadu untuk macOS](http://www.microchip.com/mplabx-ide-osx-installer)
+ [MPLAB X Lingkungan Pengembangan Terpadu untuk Linux](http://www.microchip.com/mplabx-ide-linux-installer)
1. Instal MPLAB XC32 Compiler:
+ [MPLAB XC32/32 \+\+ Compiler untuk Windows](http://www.microchip.com/mplabxc32windows)
+ [MPLAB XC32/32 \+\+ Compiler untuk macOS](http://www.microchip.com/mplabxc32osx)
+ [MPLAB XC32/32 \+\+ Kompiler untuk Linux](http://www.microchip.com/mplabxc32linux)
1. Mulai emulator terminal UART dan buka koneksi dengan pengaturan berikut:
+ Tingkat baud: 115200
+ Data: 8 bit
+ Paritas: Tidak ada
+ Hentikan bit: 1
+ Kontrol aliran: Tidak ada
## 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 AWS IoT Klien MQTT**
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**.
Ketika proyek demo berhasil berjalan di perangkat Anda, Anda melihat “Hello World\!” dikirim beberapa kali ke topik yang Anda berlangganan.
## Bangun dan jalankan proyek demo FreeRTOS
### Buka demo FreeRTOS di MPLAB IDE
1. Buka MPLAB IDE. Jika Anda memiliki lebih dari satu versi kompiler yang diinstal, Anda harus memilih kompiler yang ingin Anda gunakan dari dalam IDE.
1. Dari menu **File**, pilih **Open Project**.
1. Jelajahi dan buka`projects/microchip/curiosity_pic32mzef/mplab/aws_demos`.
1. Pilih **Buka proyek**.
**catatan**
Ketika Anda membuka proyek untuk pertama kalinya, Anda mungkin mendapatkan pesan kesalahan tentang kompiler. Di IDE, navigasikan ke **Tools**, **Options**, **Embedded**, dan kemudian pilih compiler yang Anda gunakan untuk proyek Anda.
Untuk menggunakan Ethernet untuk terhubung, Anda harus menentukan makro preprocessor. `PIC32_USE_ETHERNET`
**Untuk menggunakan Ethernet untuk terhubung menggunakan MPLAB IDE**
1. **Di MPLAB IDE, klik kanan proyek dan pilih Properties.**
1. Dalam kotak dialog **Project Properties**, pilih **{{compiler-name}}(Global Options)** untuk memperluasnya, lalu pilih **{{compiler-name}}-gcc**.
1. Untuk **kategori Opsi**, pilih **Preprocessing dan pesan**, lalu tambahkan `PIC32_USE_ETHERNET` string ke makro **Preprocessor**.
### Jalankan proyek demo FreeRTOS
1. Membangun kembali proyek Anda.
1. **Pada tab **Projects**, klik kanan folder `aws_demos` tingkat atas, lalu pilih Debug.**
1. **Ketika debugger berhenti di breakpoint di`main()`, dari menu **Run**, pilih Lanjutkan.**
### Bangun demo FreeRTOS dengan CMake
Jika Anda memilih untuk tidak menggunakan IDE untuk pengembangan Freertos, Anda dapat menggunakan CMake untuk membangun dan menjalankan aplikasi demo atau aplikasi yang telah Anda kembangkan menggunakan editor kode pihak ketiga dan alat debugging.
**Untuk membangun demo FreeRTOS dengan CMake**
1. Buat direktori untuk berisi file build yang dihasilkan, seperti{{build-directory}}.
1. Gunakan perintah berikut untuk menghasilkan file build dari kode sumber.
```
cmake -DVENDOR=microchip -DBOARD=curiosity_pic32mzef -DCOMPILER=xc32 -DMCHP_HEXMATE_PATH={{path}}/microchip/mplabx/{{version}}/mplab_platform/bin -DAFR_TOOLCHAIN_PATH={{path}}/microchip/xc32/{{version}}/bin -S {{freertos}} -B {{build-folder}}
```
**catatan**
Anda harus menentukan jalur yang benar ke binari Hexmate dan toolchain, seperti dan path. `C:\Program Files (x86)\Microchip\MPLABX\v5.35\mplab_platform\bin` `C:\Program Files\Microchip\xc32\v2.40\bin`
1. Ubah direktori ke direktori build ({{build-directory}}), lalu jalankan `make` dari direktori itu.
Untuk informasi selengkapnya, lihat [Menggunakan CMake dengan FreerTos](getting-started-cmake.md).
Untuk menggunakan Ethernet untuk terhubung, Anda harus menentukan makro preprocessor. `PIC32_USE_ETHERNET`
## Pemecahan masalah
Untuk informasi pemecahan masalah, lihat [Pemecahan masalah memulai](gsg-troubleshooting.md).