Memulai dengan Microchip Curiosity PIC32MZ EF - Gratis RTOS
Gambaran UmumMengatur perangkat keras Microchip Curiosity PIC32MZ EFMengatur perangkat keras Microchip Curiosity PIC32MZ EF menggunakan PicKit On Board (PKOB)Siapkan lingkungan pengembangan AndaMemantau pesan MQTT di cloudBangun dan jalankan proyek demo FreeRTOSPemecahan Masalah

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 repositori Amazon-freertos yang tidak digunakan lagi. Kami menyarankan Anda mulai di sini ketika Anda membuat proyek baru. Jika Anda sudah memiliki proyek FreeRTOS yang sudah ada berdasarkan repositori Amazon-freertos yang sekarang tidak digunakan lagi, lihatPanduan Migrasi Repositori RTOS Github Bebas Amazon.

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 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 Curiosity PIC32MZ-EF-2.0 Development board (DM320209) untuk desain baru. Platform Pic32Mzv1 masih dapat ditemukan di v202012.00 dari repositori Integrasi Referensi FreeRTOS. Namun, platform ini tidak lagi didukung oleh v202107.00 dari Referensi FreeRTOS.

Tutorial ini memberikan instruksi untuk memulai dengan Microchip Curiosity PIC32MZ EF. Jika Anda tidak memiliki bundel Microchip Curiosity PIC32MZ EF, kunjungi Katalog PerangkatAWS Mitra untuk membelinya dari mitra kami.

Bundel tersebut mencakup item berikut:

Anda juga memerlukan item berikut untuk debugging:

Sebelum memulai, Anda harus mengonfigurasiAWS IoT dan mengunduh FreeRTOS Anda untuk menghubungkan perangkat Anda keAWS Cloud. Lihat Langkah pertama untuk instruksi.

penting

  • Dalam topik ini, jalur ke direktori unduhan FreeRTOS disebut sebagaifreertos.

  • Karakter spasi difreertos jalur dapat menyebabkan kegagalan build. Saat Anda mengkloning atau menyalin repositori, pastikan jalur yang Anda buat tidak mengandung karakter spasi.

  • Panjang maksimal jalur file pada Microsoft Windows adalah 260 karakter. Jalur direktori unduhan FreeRTOS yang panjang dapat menyebabkan kegagalan build.

  • Karena kode sumber mungkin berisi tautan simbolik, jika Anda menggunakan Windows untuk mengekstrak arsip, Anda mungkin harus:

    • Aktifkan Mode Pengembang 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 selengkapnya, lihat entri blog Symlink di Windows 10! .

    Jika Anda menggunakan Git di bawah Windows, Anda harus mengaktifkan Mode Pengembang atau Anda harus:

    • Aturcore.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, dangit submodule update --init --recursive).

Gambaran Umum

Tutorial ini berisi petunjuk untuk langkah-langkah memulai berikut:

  1. Menghubungkan papan Anda ke mesin host.

  2. Menginstal perangkat lunak pada mesin host untuk mengembangkan dan men-debug aplikasi tertanam untuk papan mikrokontroler Anda.

  3. Cross kompilasi aplikasi demo FreeRTOS ke gambar biner.

  4. Memuat gambar biner aplikasi ke papan Anda, dan kemudian menjalankan aplikasi.

  5. Berinteraksi dengan aplikasi yang berjalan di papan Anda melalui koneksi serial, untuk tujuan pemantauan dan debugging.

Mengatur perangkat keras Microchip Curiosity PIC32MZ EF

  1. Connect MikroElectronika USB UART klik Board ke konektor MicroBus 1 pada Microchip Curiosity PIC32MZ EF.

  2. Connect papan putri PIC32 LAN8720 PHY ke header J18 pada Microchip Curiosity PIC32MZ EF.

  3. Connect Papan klik UART MikroElectronika USB ke komputer Anda menggunakan kabel USB A ke USB mini-B.

  4. Untuk terhubung ke internet, gunakan salah satu opsi berikut:

    • Untuk menggunakan Wi-Fi, sambungkan Papan klik MikroElectronika Wi-Fi 7 ke konektor MicroBus 2 pada Microchip Curiosity PIC32MZ EF. Lihat Mengkonfigurasi demo Gratis RTOS.

    • Untuk menggunakan Ethernet untuk menghubungkan Microchip Curiosity PIC32MZ EF Board ke internet, hubungkan papan putri PIC32 LAN8720 PHY ke header J18 pada Microchip Curiosity PIC32MZ EF. Connect salah satu ujung kabel Ethernet ke papan putri LAN8720 PHY. Connect ujung lainnya ke router atau port internet lainnya. Anda juga harus menentukan makro preprocessorPIC32_USE_ETHERNET.

  5. Jika belum selesai, solder konektor sudut ke header ICSP pada Microchip Curiosity PIC32MZ EF.

  6. Connect 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 MF Dupont untuk menghubungkan koneksi sebagai gantinya. Perhatikan bahwa lingkaran putih menandakan posisi Pin 1.

  7. Connect ujung lain dari kabel ICSP (atau jumper) ke MPLAB Snap Debugger. Pin 1 dari 8-pin SIL Programming Connector ditandai dengan segitiga hitam di kanan bawah papan.

    Pastikan kabel apa pun 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 Lembar Informasi Debugger Snap In-Circuit MPLAB.

Mengatur perangkat keras Microchip Curiosity PIC32MZ EF menggunakan PicKit On Board (PKOB)

Kami menyarankan agar Anda mengikuti prosedur pengaturan di bagian sebelumnya. Namun, Anda dapat mengevaluasi dan menjalankan demo FreeRTOS dengan debugging dasar menggunakan programmer/debugger PicKit On Board (PKOB) terintegrasi dengan mengikuti langkah-langkah ini.

  1. Connect MikroElectronika USB UART klik Board ke konektor MicroBus 1 pada Microchip Curiosity PIC32MZ EF.

  2. Untuk terhubung ke internet, lakukan salah satu hal berikut:

    • Untuk menggunakan Wi-Fi, sambungkan Papan klik MikroElectronika Wi-Fi 7 ke konektor MicroBus 2 pada Microchip Curiosity PIC32MZ EF. (Ikuti langkah-langkah “Untuk mengkonfigurasi Wi-Fi Anda” diMengkonfigurasi demo Gratis RTOS.

    • Untuk menggunakan Ethernet untuk menghubungkan Microchip Curiosity PIC32MZ EF Board ke internet, hubungkan papan putri PIC32 LAN8720 PHY ke header J18 pada Microchip Curiosity PIC32MZ EF. Connect salah satu ujung kabel Ethernet ke papan putri LAN8720 PHY. Connect ujung lainnya ke router atau port internet lainnya. Anda juga harus menentukan makro preprocessorPIC32_USE_ETHERNET.

  3. Connect 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.

  4. Connect 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 dari Kompiler MPLAB XC32 dan versi 2.X.X dari MPLAB Harmony Configurator (MHC).

  1. Instal Python versi 3.x atau yang lebih baru.

  2. Instal IDE MPLAB X:

    catatan

    IntegrasiAWS Referensi FreeRTOS v202007.00 saat ini didukung hanya di MPlabv5.35. Versi IntegrasiAWS Referensi FreeRTOS sebelumnya didukung di MPlaBv5.40.

    MPlaBv5.35 unduhan
    Unduhan MPLab terbaru (MPlaBv5.40)

  3. Instal Kompiler MPLAB XC32:

  4. 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 Anda menjalankan proyek demo FreeRTOS, Anda dapat mengatur klien MQTT diAWS IoT konsol untuk memantau pesan yang dikirim perangkat Anda keAWS Cloud.

Untuk berlangganan topik MQTT dengan klienAWS IoT MQTT

  1. Masuk ke konsol AWS IoT tersebut.

  2. Di panel navigasi, pilih Uji, lalu pilih klien uji MQTT untuk membuka klien MQTT.

  3. Di Topik berlanggananyour-thing-name/example/topic, masukkan, lalu pilih Berlangganan topik.

Ketika proyek demo berhasil berjalan pada perangkat Anda, Anda melihat “Hello World!” dikirim beberapa kali ke topik yang Anda berlangganan.

Bangun dan jalankan proyek demo FreeRTOS

Buka demo FreeRTOS di IDE MPLAB

  1. Buka MPLAB IDE. Jika Anda memiliki lebih dari satu versi compiler diinstal, Anda perlu memilih compiler yang ingin Anda gunakan dari dalam IDE.

  2. Dari menu File, pilih Open Project.

  3. Jelajahi dan bukaprojects/microchip/curiosity_pic32mzef/mplab/aws_demos.

  4. Pilih Buka proyek.

catatan

Ketika Anda membuka proyek untuk pertama kalinya, Anda mungkin mendapatkan pesan kesalahan tentang compiler. 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 preprocessorPIC32_USE_ETHERNET.

Menggunakan Ethernet untuk menyambung menggunakan IDE MPLAB

  1. Di IDE MPLAB, klik kanan proyek dan pilih Properties.

  2. Di kotak dialog Project Properties, pilih compiler-name (Global Options) untuk mengembangkannya, dan kemudian pilih compiler-name -gcc.

  3. Untuk kategori Opsi, pilih Preprocessing dan pesan, lalu tambahkanPIC32_USE_ETHERNET string ke makro Preprocessor.

Jalankan proyek demo FreeRTOS

  1. Bangun kembali proyek Anda.

  2. Pada tab Proyek, klik kanan folderaws_demos tingkat atas, dan kemudian pilih Debug.

  3. Ketika debugger berhenti di breakpointmain(), 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.

  2. 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 biner Hexmate dan toolchain, sepertiC:\Program Files\Microchip\xc32\v2.40\bin jalurC:\Program Files (x86)\Microchip\MPLABX\v5.35\mplab_platform\bin dan.

  3. Ubah direktori ke direktori build (build-directory), lalu jalankanmake dari direktori tersebut.

Untuk informasi selengkapnya, lihat Menggunakan CMake dengan FreerTos.

Untuk menggunakan Ethernet untuk terhubung, Anda harus menentukan makro preprocessorPIC32_USE_ETHERNET.

Pemecahan Masalah

Untuk informasi pemecahan masalah, lihat Memulai masalah saat memulai.