View a markdown version of this page

Memulai dengan Microchip Curiosity PIC32MZ EF - FreeRTOS
IkhtisarSiapkan perangkat keras Microchip Curiosity PIC32MZ EFSiapkan 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 Amazon-FreeRTOS repositori yang tidak digunakan lagi. Kami menyarankan Anda mulai di sini 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

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

Bundel ini mencakup item-item berikut:

Anda juga memerlukan item berikut untuk debugging:

Sebelum memulai, Anda harus mengonfigurasi AWS IoT dan mengunduh FreeRTOS Anda untuk menghubungkan perangkat Anda ke Cloud. AWS Lihat Langkah pertama 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 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! .

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

Ikhtisar

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. Menyusun silang 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 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.

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

  3. Hubungkan Papan klik UART MikroElectronika USB ke komputer Anda menggunakan kabel USB A ke USB Mini-B.

  4. 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.

    • 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.

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

  6. 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.

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

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.

  2. 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” diMengkonfigurasi demo FreeRTOS.

    • 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.

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

  4. 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 atau yang lebih baru.

  2. 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
    Unduhan MPLab terbaru () MPLabv5.40

  3. Instal MPLAB XC32 Compiler:

  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 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 tersebut.

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

  3. Dalam Subscription topic, masukkanyour-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.

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

  2. Dalam kotak dialog Project Properties, pilih compiler-name(Global Options) untuk memperluasnya, lalu pilih compiler-name-gcc.

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

  2. Pada tab Projects, klik kanan folder aws_demos tingkat atas, lalu pilih Debug.

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

  3. Ubah direktori ke direktori build (build-directory), lalu jalankan make dari direktori itu.

Untuk informasi selengkapnya, lihat Menggunakan CMake dengan FreerTos.

Untuk menggunakan Ethernet untuk terhubung, Anda harus menentukan makro preprocessor. PIC32_USE_ETHERNET

Pemecahan masalah

Untuk informasi pemecahan masalah, lihat Pemecahan masalah memulai.