View a markdown version of this page

Memulai dengan Espressif ESP32-WROOM-32SE - FreeRTOS

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memulai dengan Espressif ESP32-WROOM-32SE

penting

Integrasi referensi ini di-host di Amazon-FreeRTOS repositori yang tidak digunakan lagi. Kami menyarankan Anda memulai di sini ketika Anda membuat proyek baru. Jika Anda sudah memiliki proyek FreeRTOS yang ada berdasarkan Amazon-FreeRTOS repositori yang sekarang tidak digunakan lagi, lihat. Amazon-FreeRTOS Panduan Migrasi Repositori Github

catatan
  • Untuk mengeksplorasi cara mengintegrasikan pustaka modular FreeRTOS dan demo dalam proyek Espressif IDF Anda sendiri, lihat integrasi referensi unggulan kami untuk platform. ESP32-C3

  • Saat ini, port FreeRTOS untuk ESP32-WROOM-32SE tidak mendukung fitur multiprocessing simetris (SMP).

Tutorial ini menunjukkan cara memulai dengan Espressif ESP32-WROOM-32SE. Untuk membelinya dari mitra kami di katalog AWS Perangkat Mitra, lihat ESP32-WROOM-32SE.

Gambaran umum

Tutorial ini memandu Anda melalui langkah-langkah berikut:

  1. Hubungkan papan Anda ke mesin host.

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

  3. Kompilasi silang aplikasi demo FreeRTOS ke gambar biner.

  4. Muat gambar biner aplikasi ke papan Anda, lalu jalankan aplikasi.

  5. Pantau dan debug aplikasi yang sedang berjalan dengan menggunakan koneksi serial.

Prasyarat

Sebelum Anda memulai dengan FreeRTOS di papan Espressif Anda, Anda harus mengatur AWS akun dan izin Anda.

Mendaftar untuk Akun AWS

Untuk memulainya AWS, Anda membutuhkan Akun AWS. Untuk informasi tentang membuat Akun AWS, lihat Mem ulai dengan an Akun AWS di Panduan AWS Account Management Referensi.

Untuk memberikan akses dan menambahkan izin bagi pengguna, grup, atau peran Anda:

Memulai

catatan

Perintah Linux dalam tutorial ini mengharuskan Anda menggunakan shell Bash.

  1. Siapkan perangkat keras Espressif.

    Untuk informasi tentang menyiapkan perangkat keras papan ESP32-WROOM-32SE pengembangan, lihat Panduan ESP32-DevKitC Memulai V4.

    penting

    Ketika Anda mencapai bagian Instalasi Langkah demi Langkah dari panduan, ikuti sampai Anda menyelesaikan Langkah 4 (Siapkan variabel lingkungan). Berhenti setelah Anda menyelesaikan Langkah 4 dan ikuti langkah-langkah yang tersisa di sini.

  2. Unduh Amazon FreeRTOS dari GitHub. (Untuk instruksi, lihat README.md file.)

  3. Siapkan lingkungan pengembangan Anda.

    Untuk berkomunikasi dengan papan Anda, Anda harus menginstal rantai alat. Espressif menyediakan ESP-IDF untuk mengembangkan perangkat lunak untuk papan mereka. Karena ESP-IDF memiliki versi sendiri dari FreeRTOS Kernel yang terintegrasi sebagai komponen, Amazon FreeRTOS menyertakan versi khusus dari ESP-IDF v4.2 yang telah menghapus Kernel FreeRTOS. Ini memperbaiki masalah dengan file duplikat saat Anda mengkompilasi. Untuk menggunakan versi kustom ESP-IDF v4.2 yang disertakan dengan Amazon FreeRTOS, ikuti petunjuk di bawah ini untuk sistem operasi mesin host Anda.

    Windows

    1. Unduh ESP-IDF Peng instal Online Universal untuk Windows.

    2. Jalan kan Universal Online Installer.

    3. Ketika Anda sampai ke langkah Unduh atau gunakan ESP-IDF, pilih Gunakan ESP-IDF direktori yang ada dan setel Pilih ESP-IDF direktori yang ada kefreertos/vendors/espressif/esp-idf.

    4. Selesaikan instalasi.

    MacOS

    1. Ikuti petunjuk dalam prasyarat Pengaturan Standar Toolchain (ESP-IDF v4.2) untuk macOS.

      penting

      Saat Anda mencapai instruksi “Dapatkan ESP-IDF” di bawah Langkah Berikutnya, berhenti, lalu kembali ke instruksi di halaman ini.

    2. Buka jendela baris perintah.

    3. Arahkan ke direktori unduhan FreeRTOS, lalu jalankan skrip berikut untuk mengunduh dan menginstal espressif toolchain untuk platform Anda.

      vendors/espressif/esp-idf/install.sh
    4. Tambahkan alat ESP-IDF toolchain ke jalur terminal Anda dengan perintah berikut.

      source vendors/espressif/esp-idf/export.sh

    Linux

    1. Ikuti petunjuk di Standar Setup Prasyarat Toolchain (ESP-IDF v4.2) untuk Linux.

      penting

      Saat Anda mencapai instruksi “Dapatkan ESP-IDF” di bawah Langkah Berikutnya, berhenti, lalu kembali ke instruksi di halaman ini.

    2. Buka jendela baris perintah.

    3. Arahkan ke direktori unduhan FreeRTOS, lalu jalankan skrip berikut untuk mengunduh dan menginstal rantai alat Espressif untuk platform Anda.

      vendors/espressif/esp-idf/install.sh
    4. Tambahkan alat ESP-IDF toolchain ke jalur terminal Anda dengan perintah berikut.

      source vendors/espressif/esp-idf/export.sh
  4. Buat koneksi serial.

    1. Untuk membuat koneksi serial antara mesin host Anda dan ESP32-WROOM-32SE, instal driver VCP CP210x USB ke UART Bridge. Anda dapat mengunduh driver ini dari Silicon Labs.

    2. Ikuti langkah-langkah untuk Membuat Kon eksi Serial dengan ESP32.

    3. Setelah Anda membuat koneksi serial, catat port serial untuk koneksi papan Anda. Anda membutuhkannya untuk mem-flash demo.

Konfigurasikan aplikasi demo FreeRTOS

Untuk tutorial ini, file konfigurasi FreeRTOS terletak difreertos/vendors/espressif/boards/board-name/aws_demos/config_files/FreeRTOSConfig.h. (Misalnya, jika AFR_BOARD espressif.esp32_devkitc dipilih, file konfigurasi terletak difreertos/vendors/espressif/boards/esp32/aws_demos/config_files/FreeRTOSConfig.h.)

penting

Perangkat ATECC608A memiliki inisialisasi satu kali yang dikunci ke perangkat saat pertama kali proyek dijalankan (selama panggilan ke). C_InitToken Namun, proyek demo FreeRTOS dan proyek uji memiliki konfigurasi yang berbeda. Jika perangkat terkunci selama konfigurasi proyek demo, tidak semua pengujian dalam proyek pengujian akan berhasil.

  1. Konfigurasikan Proyek Demo FreeRTOS dengan mengikuti langkah-langkah diMengkonfigurasi demo FreeRTOS. Ketika Anda sampai ke langkah terakhir Untuk memformat AWS IoT kredensibilitas Anda, hentikan, dan lakukan langkah-langkah berikut.

  2. Microchip telah menyediakan beberapa alat skrip untuk membantu pengaturan bagian ATECC608A. Arahkan ke freertos/vendors/microchip/example_trust_chain_tool direktori, dan buka README.md file.

  3. Untuk menyediakan perangkat Anda, ikuti petunjuk dalam README.md file. Langkah-langkahnya meliputi:

    1. Buat dan daftarkan otoritas sertifikat dengan AWS.

    2. Hasilkan kunci Anda di ATECC608A dan ekspor kunci publik dan nomor seri perangkat.

    3. Buat sertifikat untuk perangkat dan daftarkan sertifikat itu dengan AWS.

  4. Muat sertifikat CA dan sertifikat perangkat ke perangkat dengan mengikuti instruksi untukDeveloper-mode penyediaan kunci.

Memantau pesan MQTT di AWS Cloud

Sebelum menjalankan proyek demo FreeRTOS, Anda dapat mengatur klien MQTT di AWS IoT konsol untuk memantau pesan yang dikirim perangkat Anda ke AWS Cloud.

Untuk berlangganan topik MQTT dengan AWS IoT Klien MQTT
  1. Masuk ke konsol AWS IoT tersebut.

  2. Di panel navigasi, pilih Test, lalu pilih MQTT Test Client.

  3. Di Topik berlangganan, masukkan your-thing-name/example/topic dan kemudian pilih Berlangganan topik.

Bangun, flash, dan jalankan proyek demo FreeRTOS menggunakan skrip idf.py

Anda dapat menggunakan utilitas IDF Espressif (idf.py) untuk menghasilkan file build, membangun biner aplikasi, dan mem-flash binari ke perangkat Anda.

catatan

Beberapa pengaturan mungkin mengharuskan Anda menggunakan opsi port "-p port-name" dengan idf.py untuk menentukan port yang benar, seperti pada contoh berikut.

idf.py -p /dev/cu.usbserial-00101301B flash
Membangun dan mem-flash FreeRTOS di Windows, Linux, dan macOS (ESP-IDF v4.2)
  1. Arahkan ke root direktori unduhan FreeRTOS Anda.

  2. Di jendela baris perintah, masukkan perintah berikut untuk menambahkan ESP-IDF alat ke PATH terminal Anda:

    Windows (aplikasi “Perintah”)
    vendors\espressif\esp-idf\export.bat
    Windows (aplikasi “ESP-IDF 4.x CMD”)

    (Ini sudah dilakukan saat Anda membuka aplikasi.)

    Linux /MacOS
    source vendors/espressif/esp-idf/export.sh
  3. Konfigurasikan cmake di build direktori dan buat image firmware dengan perintah berikut.

    idf.py -DVENDOR=espressif -DBOARD=esp32_ecc608a_devkitc -DCOMPILER=xtensa-esp32 build

    Anda akan melihat output seperti contoh berikut ini.

    Running cmake in directory /path/to/hello_world/build Executing "cmake -G Ninja --warn-uninitialized /path/to/hello_world"... Warn about uninitialized values. -- Found Git: /usr/bin/git (found version "2.17.0") -- Building empty aws_iot component due to configuration -- Component names: ... -- Component paths: ... ... (more lines of build system output) [527/527] Generating hello-world.bin esptool.py v2.3.1 Project build complete. To flash, run this command: ../../../components/esptool_py/esptool/esptool.py -p (PORT) -b 921600 write_flash --flash_mode dio --flash_size detect --flash_freq 40m 0x10000 build/hello-world.bin build 0x1000 build/bootloader/bootloader.bin 0x8000 build/partition_table/partition-table.bin or run 'idf.py -p PORT flash'

    Jika tidak ada kesalahan, build akan menghasilkan file.bin biner firmware.

  4. Hapus memori flash papan pengembangan Anda dengan perintah berikut.

    idf.py erase_flash
  5. Gunakan idf.py skrip untuk mem-flash biner aplikasi ke papan Anda.

    idf.py flash
  6. Pantau output dari port serial papan Anda dengan perintah berikut.

    idf.py monitor
    catatan
    • Anda dapat menggabungkan perintah ini seperti pada contoh berikut.

      idf.py erase_flash flash monitor
    • Untuk pengaturan mesin host tertentu, Anda harus menentukan port saat Anda mem-flash papan seperti pada contoh berikut.

      idf.py erase_flash flash monitor -p /dev/ttyUSB1

Buat dan Flash FreeRTOS dengan CMake

Selain menggunakan idf.py skrip yang disediakan oleh IDF SDK untuk membangun dan menjalankan kode Anda, Anda juga dapat membangun proyek dengan CMake. Saat ini mendukung Unix Makefile dan sistem build Ninja.

Untuk membangun dan mem-flash proyek
  1. Di jendela baris perintah, navigasikan ke root direktori unduhan FreeRTOS Anda.

  2. Jalankan skrip berikut untuk menambahkan ESP-IDF alat ke PATH shell Anda.

    Windows
    vendors\espressif\esp-idf\export.bat
    Linux /MacOS
    source vendors/espressif/esp-idf/export.sh
  3. Masukkan perintah berikut untuk menghasilkan file build.

    Dengan Unix Makefiles
    cmake -DVENDOR=espressif -DBOARD=esp32_plus_ecc608a_devkitc -DCOMPILER=xtensa-esp32 -S . -B ./YOUR_BUILD_DIRECTORY -DAFR_ENABLE_ALL_MODULES=1 -DAFR_ENABLE_TESTS=0
    Dengan Ninja
    cmake -DVENDOR=espressif -DBOARD=esp32_plus_ecc608a_devkitc -DCOMPILER=xtensa-esp32 -S . -B ./YOUR_BUILD_DIRECTORY -DAFR_ENABLE_ALL_MODULES=1 -DAFR_ENABLE_TESTS=0 -GNinja
  4. Hapus flash dan kemudian nyalakan papan.

    Dengan Unix Makefiles
    make -C ./YOUR_BUILD_DIRECTORY erase_flash
    make -C ./YOUR_BUILD_DIRECTORY flash
    Dengan Ninja
    ninja -C ./YOUR_BUILD_DIRECTORY erase_flash
    ninja -C ./YOUR_BUILD_DIRECTORY flash

Informasi tambahan

Untuk informasi selengkapnya tentang penggunaan dan pemecahan masalah papan Espressif ESP32, lihat topik berikut: