Memulai dengan Espressif ESP32-S2

1. Siapkan perangkat keras Espressif.

   Untuk informasi tentang menyiapkan perangkat keras papan ESP32-S2 pengembangan, lihat Panduan Mem ESP32-S2-Saola-1 ulai.

   penting

   Saat Anda mencapai bagian Memulai dari panduan Espressif, berhenti, lalu kembali ke instruksi di halaman ini.

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

1. Jika Anda menjalankan macOS atau Linux, buka prompt terminal. Jika Anda menjalankan Windows, buka aplikasi "ESP-IDF 4.x CMD” (jika Anda menyertakan opsi ini ketika Anda menginstal ESP-IDF toolchain), atau aplikasi “Command Prompt” sebaliknya.

2. Untuk memverifikasi bahwa Anda telah menginstal Python3, jalankan yang berikut ini:

   python --version

   Versi yang diinstal ditampilkan. Jika Anda tidak menginstal Python 3.0.1 atau yang lebih baru, Anda dapat menginstalnya dari situs web Python.

3. Anda memerlukan AWS Command Line Interface (CLI) untuk menjalankan AWS IoT perintah. Jika Anda menjalankan Windows, gunakan easy_install awscli perintah untuk menginstal AWS CLI di aplikasi “Command” atau "ESP-IDF 4.x CMD”.

   Jika Anda menjalankan macOS atau Linux, lihat Meng instal AWS CLI.

4. Jalankan .

   aws configure

   dan konfigurasikan AWS CLI dengan ID kunci AWS akses Anda, kunci akses rahasia, dan Wil AWS ayah default. Untuk informasi selengkapnya, lihat Meng onfigurasi AWS CLI.

5. Gunakan perintah berikut untuk menginstal AWS SDK untuk Python (boto3):

   • Di Windows, di aplikasi “Command” atau "ESP-IDF 4.x CMD”, jalankan

     easy_install boto3

   • Di macOS atau Linux, jalankan

     pip install tornado nose --user

     dan kemudian lari

     pip install boto3 --user

Untuk menjalankan skrip konfigurasi

1. Untuk mengkonfigurasi skrip, buka freertos/tools/aws_config_quick_start/configure.json dan atur atribut berikut:

   afr_source_dir

   Jalur lengkap ke freertos direktori di komputer Anda. Pastikan Anda menggunakan garis miring ke depan untuk menentukan jalur ini.

   thing_name

   Nama yang ingin Anda tetapkan untuk AWS IoT hal yang mewakili papan Anda.

   wifi_ssid

   SSID Wi-Fi jaringan Anda.

   wifi_password

   Kata sandi untuk Wi-Fi jaringan Anda.

   wifi_security

   Jenis keamanan untuk Wi-Fi jaringan Anda. Berikut ini adalah jenis keamanan yang valid:

   • eWiFiSecurityOpen(Terbuka, tidak ada keamanan)

   • eWiFiSecurityWEP(Keamanan WEP)

   • eWiFiSecurityWPA(Keamanan WPA)

   • eWiFiSecurityWPA2(Keamanan WPA2)

2. Jika Anda menjalankan macOS atau Linux, buka prompt terminal. Jika Anda menjalankan Windows, buka aplikasi "ESP-IDF 4.x CMD” atau “Command”.

3. Arahkan ke freertos/tools/aws_config_quick_start direktori dan jalankan

   python SetupAWS.py setup

   Skrip melakukan hal berikut:

   • Membuat AWS IoT sesuatu, sertifikat, dan kebijakan.

   • Melamp AWS IoT irkan kebijakan ke sertifikat dan sertifikat ke AWS IoT benda itu.

   • Mengisi aws_clientcredential.h file dengan AWS IoT titik akhir, Wi-Fi SSID, dan kredenSIAL Anda.

   • Memformat sertifikat dan kunci pribadi Anda dan menulisnya ke file aws_clientcredential_keys.h header.

   catatan

   Sertifikat ini di-hardcode untuk tujuan demonstrasi saja. Production-level aplikasi harus menyimpan file-file ini di lokasi yang aman.

   Untuk informasi lebih lanjut tentangSetupAWS.py, lihat README.md di freertos/tools/aws_config_quick_start direktori.

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 your-thing-name/example/topic, masukkan, lalu pilih Berlangganan topik.

Untuk membangun dan mem-flash proyek

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=esp32s2_saola_1 -DCOMPILER=xtensa-esp32s2 build

   Anda akan melihat output seperti contoh berikut ini.

   Executing action: all (aliases: build)
      Running cmake in directory /path/to/hello_world/build
      Executing "cmake -G Ninja -DPYTHON_DEPS_CHECKED=1 -DESP_PLATFORM=1 -DVENDOR=espressif -DBOARD=esp32s2_saola_1 -DCOMPILER=xtensa-esp32s2 -DCCACHE_ENABLE=0 /path/to/hello_world"...
      -- The C compiler identification is GNU 8.4.0
      -- The CXX compiler identification is GNU 8.4.0
      -- The ASM compiler identification is GNU
   
      ... (more lines of build system output)
   
      [1628/1628] Generating binary image from built executable
      esptool.py v3.0
      Generated /path/to/hello_world/build/aws_demos.bin
   
      Project build complete. To flash, run this command:
      esptool.py -p (PORT) -b 460800 --before default_reset --after hard_reset --chip esp32s2  write_flash --flash_mode dio --flash_size detect --flash_freq 80m 0x1000 build/bootloader/bootloader.bin 0x8000 build/partition_table/partition-table.bin 0x16000 build/ota_data_initial.bin 0x20000 build/aws_demos.bin
      or run 'idf.py -p (PORT) flash' 

   Jika tidak ada kesalahan, build 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

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=esp32s2_saola_1 -DCOMPILER=xtensa-esp32s2 -S . -B ./YOUR_BUILD_DIRECTORY -DAFR_ENABLE_ALL_MODULES=1 -DAFR_ENABLE_TESTS=0

   • Dengan Ninja

     cmake -DVENDOR=espressif -DBOARD=esp32s2_saola_1 -DCOMPILER=xtensa-esp32s2 -S . -B ./YOUR_BUILD_DIRECTORY -DAFR_ENABLE_ALL_MODULES=1 -DAFR_ENABLE_TESTS=0 -GNinja

4. Bangun proyek.

   • Dengan Unix Makefiles

     make -C ./YOUR_BUILD_DIRECTORY -j8

   • Dengan Ninja

     ninja -C ./YOUR_BUILD_DIRECTORY -j8

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