Board

ESP32 DevKit V1

ESP32 klasik: Xtensa LX6 240 MHz pada board DOIT tiga puluh pin, dengan pengendali PWM LEDC, ADC dua belas bit, dan enam pin yang hanya bisa jadi input.

Tinjauannya, dengan contoh yang berjalan, ada di halaman board dan Model ESP32 DevKit (semua register).

Apa ini

DOIT ESP32 DevKit V1, modul ESP32-WROOM-32 pada dudukan tiga puluh pin, berjalan di core Xtensa kami sendiri, board pertama di sini yang set instruksinya bukan RISC-V, AVR, maupun Arm. Firmwarenya adalah ELF Xtensa yang berbicara ke alamat ESP32 yang sebenarnya.

Board ini berukuran 51,5 kali 28,3 mm dan dua baris lima belas pinnya berjarak 0,9 inci, jadi board ini menempel di kedua sisi celah tengah breadboard dengan satu baris lubang tetap bebas di setiap sisi.

This is the thirty-pin DOIT board, not the 38-pin Espressif DevKitC. The DevKitC is a full inch between rows, leaves no row free at all, and brings out more pins. If your board has 38 pins, use ESP32-DevKitC V4, yang merupakan board tersendiri di kotak komponen.

Pin-pin-nya

Lima belas pin di setiap sisi panjang, soket micro-USB di bawah, modul dan antena PCB-nya di atas.

Kolom kiri, dari atas ke bawah: EN, VP, VN, D34, D35, D32, D33, D25, D26, D27, D14, D12, GND, D13, VIN.

Kolom kanan, dari atas ke bawah: D23, D22, TX0, RX0, D21, D19, D18, D5, TX2, RX2, D4, D0, D2, D15, 3V3.

Dn adalah GPIO n. VP adalah GPIO 36 dan VN adalah GPIO 39, dinamai pada silkscreen berdasarkan fungsinya, bukan nomornya. EN adalah chip enable, yang berfungsi sebagai reset board ini. VIN adalah jalur 5 V dari USB.

Ini adalah board 3,3 volt dan pin-pinnya tidak tahan 5 V.

Tiga hal yang pinout ini lakukan padamu

Ini adalah sifat hardware, bukan model, dan masing-masing mengenai seseorang:

  • GPIO 34 sampai 39 tidak bisa jadi output. Selamanya. Enam pin itu hanya punya buffer input dan tidak ada lainnya: tanpa driver output dan tanpa pull-up atau pull-down internal. pinMode(34, OUTPUT) tetap menulis ke register, bitnya tidak menempel, dan pin tetap high-impedance. Empat di antaranya ada di header ini: D34, D35, VP, dan VN. Mokxi menolak penulisan itu seperti halnya chip aslinya, menghitungnya, dan menaruh tanda kuning kecil di board, alih-alih membiarkanmu percaya bahwa sebuah pin sedang menggerakkan sesuatu. Jika kamu butuh pull-up di salah satu pin ini, harus dengan resistor.
  • GPIO 6 sampai 11 tidak ada di header sama sekali, karena pin-pin itu adalah SPI flash tempat program berjalan. Pada board yang memang mengeluarkannya, menggerakkan salah satunya akan menghentikan chip.
  • GPIO 0, 2, 5, 12, dan 15 adalah strapping pin. Pin-pin ini menentukan bagaimana chip boot, jadi apa yang tersambung ke sana saat dinyalakan itu penting. GPIO 2 juga adalah LED biru, jadi keadaannya sebelum pinMode berjalan berbeda-beda antar board.

LED dan tombolnya

LED_BUILTIN adalah GPIO 2, LED biru biasa yang dirangkai dengan cara biasa: HIGH menyalakannya. BOOT adalah GPIO 0, aktif rendah, dan juga ada di header sebagai D0, jadi kamu bisa menyambung kabel ke sana; mengekliknya di board akan membumikan pin itu.

analogRead: delapan channel, dan 4095 bukan tempat jatuhnya jalur 3,3 V

Delapan channel ADC1 bukan GPIO 0 sampai 7. Urutannya adalah GPIO 36, 37, 38, 39, 32, 33, 34, dan 35, dan GPIO 37 serta 38 tidak dikeluarkan pada WROOM-32, jadi yang benar-benar bisa kamu pakai adalah VP, VN, D32, D33, D34, dan D35.

Dua belas bit, dan pada atenuasi bawaan 11 dB hasil pembacaannya mengikuti kurva ESP32 sungguhan, bukan garis lurus: 0 untuk sekitar 80 mV pertama, hampir linear di bagian tengah, dan 4095 mulai sekitar 3,1 V. Potensiometer yang dipasang melintasi jalur 3,3 V milik board ini karena itu mencapai 4095 sedikit sebelum ujung langkahnya dan membaca sekitar 1890, bukan 2048, di tengah. Itulah komponen aslinya, dan contoh knob mencetak angka mentahnya supaya tidak jadi misteri. analogReadMilliVolts() membatalkan kurva itu dan membaca dalam volt.

ADC2 tidak dimodelkan. Pada ESP32 sungguhan ADC2 dipakai bersama radio WiFi dan berhenti bekerja saat WiFi menyala, itulah kenapa tidak ada yang menggunakannya; di sini memang tidak ada, jadi delapan channel di atas adalah semuanya.

Konversi garis lurus di sini adalah perkiraan dari konverter sungguhan yang melengkung di kedua ujungnya dan dikoreksi dari kurva kalibrasi yang terbakar di dalam chip. Harapkan modelnya sedikit lebih ramah daripada silikonnya di dekat 0 V dan di dekat batas atas rentang.

analogWrite adalah LEDC, dan tidak menghabiskan core sama sekali

analogWrite(pin, 0..255) memasang salah satu dari delapan channel kecepatan tinggi LEDC ke pin saat pertama kali dipanggil: delapan bit pada 1 kHz, di pin apa pun yang punya driver output, karena channel mencapai pad melalui matriks GPIO, bukan melalui pin tetap. Saat frekuensinya penting, ledcAttach(pin, frequency, bits) dan ledcWrite(pin, duty) tersedia, dan channel yang meminta frekuensi dan resolusi yang sama berbagi satu dari empat timer.

Karena LEDC adalah hardware sungguhan, LED yang memudar di sini tidak menghabiskan core sama sekali: sketch bisa duduk di delay() dan tepinya tetap datang tepat waktu. ESP8266 NodeMCU adalah kontras yang menarik: tidak punya hardware PWM, jadi corenya yang mengerjakannya. Kedua board sama jujurnya soal ini.

Serial

Serial adalah UART0, yaitu port tempat jembatan USB sebuah DevKit berada, dan tersambung ke serial monitor. Byte keluar pada baud rate yang kamu atur, jadi sketch yang mencetak lebih cepat dari 115200 baud bisa mengalami penundaan di sini persis seperti di atas meja sungguhan.

Serial1 dan Serial2 adalah UART1 dan UART2, port sungguhan di pin mana pun yang kamu pilih, mengirim dan menerima frame bit demi bit lewat kabel, jadi modul GPS, HC-05, PZEM-004T, transceiver RS-485, atau board kedua di pin tersebut bisa mendengarnya:

Serial2.begin(9600, SERIAL_8N1, 16, 17); // RX, TX: the pins marked RX2 and TX2

Yang mereka lakukan adalah apa yang dilakukan core arduino-esp32 3.x:

  • Tanpa pin, Serial1.begin(9600) memakai GPIO 26 (RX) dan 27 (TX), dan Serial2.begin(9600) memakai GPIO 4 dan 25. Core 2.x memakai 16 dan 17 untuk Serial2, itulah kenapa tutorial lama tidak menyebut pinnya; Mokxi mengatakannya sekali di monitor saat sebuah sketch melakukannya. setPins(rx, tx) memindahkannya, sebelum atau sesudah begin().
  • Framenya bisa berupa apa pun dari SERIAL_5N1 sampai SERIAL_8O2, dan invert pada begin() membalik kedua jalur.
  • Byte yang diterima sampai ke sketch dalam potongan-potongan, seperti pada driver ESP-IDF: UART memindahkan FIFO-nya ke ring buffer 256 byte (setRxBufferSize() sebelum begin()) setelah 120 byte masuk (setRxFIFOFull()) atau setelah jalur diam selama satu waktu karakter (setRxTimeout()). available() menghitung ring buffer, jadi byte yang masih di FIFO belum tersedia. Sketch yang membaca terlalu lambat akan kehilangan byte seperti di meja sungguhan.
  • onReceive() dipanggil setelah setiap potongan, di antara loop()dan sementara sketch menunggu di delay(), bukan dari task FreeRTOS.
  • write() menunggu selama FIFO 128 byte penuh, dan flush() sampai stop bit terakhir keluar. setTxBufferSize() diambil, tetapi tidak ada ring TX, jadi write() tetap menunggu di FIFO.

Hardware flow control, mode RS-485, IrDA dan autobaud tidak dimodelkan. Pin TX butuh driver output, jadi GPIO 34 sampai 39 hanya bisa jadi RX. SoftwareSerial.h tetap bekerja di dua pin mana pun juga.

Satu core, bukan dua

ESP32 sungguhan punya dua core Xtensa LX6, dan sketch Arduino di sini berjalan di satu: tanpa APP CPU, tanpa interrupt antar-core dan tanpa FreeRTOS untuk menjadwalkan di antara keduanya. Sketch yang ditulis di sekitar setup() dan loop() tidak akan menyadarinya. Apa pun yang memulai task di core 1 tidak akan berjalan.

Firmware yang kamu build sendiri itu beda: MicroPython dan build ESP-IDF berjalan di model seluruh chip, tempat kedua core benar-benar berjalan (di bawah).

What is modeled

Xtensa LX6 dalam ABI windowed-nya (satu-satunya ABI yang dikeluarkan compiler-nya), dengan register window, handler window overflow dan underflow, serta interrupt level-1. Di sekitarnya: matriks GPIO dan IO_MUX, UART0, timer 0 dari timer group 0 di balik millis() dan micros(), ADC1 one-shot melalui blok SENS, group kecepatan tinggi LEDC, dan sebanyak mungkin matriks interrupt DPORT yang dibutuhkan dua sumber.

Itu adalah set yang dibutuhkan pinMode, digitalWrite, digitalRead, analogRead, analogWrite, ledcAttach, ledcWrite, millis, micros, delay, attachInterrupt dan Serial, di alamat aslinya.

WiFi, simulated

Tidak ada radio. Dan tidak akan pernah ada: MAC 802.11 bukan sesuatu yang bisa model ini tiru dengan jujur.

Yang ada sebagai gantinya adalah jaringan tersimulasi. Sebuah blok milik Mokxi sendiri, bukan milik chip (mailbox di 0x3FEF_E000, tempat yang di ESP32 sungguhan tidak ada pemetaan sama sekali) membawa WiFi.h, HTTPClient.h dan WebServer.h, jadi kode Arduino yang diberikan tutorial kepadamu berjalan di sini: board bergabung ke access point yang nama dan kata sandinya adalah properti board, WiFi.status() melalui status yang sama dalam satu sampai tiga detik yang sama, DHCP memberinya lease 192.168.4.2, dan sebuah sketch bisa mengambil halaman atau menyajikannya.

Yang ada di baliknya adalah perangkat lunak, dan tidak ada yang disembunyikan soal itu. Tidak ada 802.11, tidak ada channel, tidak ada scan, tidak ada WPA2, tidak ada TCP, tidak ada TLS dan tidak ada internet sungguhan: hanya empat nama buatan di bawah .mokxi yang bisa di-resolve dan tidak ada lainnya, dan tidak ada yang dilakukan sebuah sketch bisa menjangkau jaringan tempat browsermu berada. WiFiClientSecure dikompilasi lalu gagal, mengatakan TLS tidak disimulasi. Panel Web dan Cloud di sepanjang bagian bawah editor terbuka dengan kalimat itu dan tidak menggulirnya menjauh.

Satu-satunya pengecualian adalah Internet sungguhan, sebuah saklar di panel Cloud untuk siapa pun yang masuk (lebih banyak dengan Pro) yang mati setiap kali halaman dimuat. Dengan itu menyala, permintaan untuk nama di luar .mokxi, https:// termasuk, keluar melalui gateway Mokxi dan jawabannya kembali ke sketch. Lihat Internet sungguhan.

Alamatnya berada di celah yang ditinggalkan bus data chip di antara jendela memori eksternal dan jendela peripheral, jadi image yang memakainya akan fault di silikon sungguhan, bukan membaca register peripheral lain. Bluetooth disimulasi melalui blok yang sama, Classic dan LE, dengan HP di panel Bluetooth editor dan tanpa radio (Bluetooth, disimulasikan).

Tiga contoh disertakan untuk board ini: WiFi: join the network, WiFi: fetch the weather dan WiFi: a lamp on a web page.

WiFi, simulated adalah cara memakainya; Simulated WiFi adalah kontraknya, batas demi batas.

Yang tidak

Radio jenis apa pun. Tidak ada radio 802.11 dan Bluetooth dalam model ini dan tidak ada yang berpura-pura memilikinya; WiFi dan Bluetooth di atas disimulasi dan mengatakannya. Core kedua. FPU: setiap instruksi floating-point fault di sini alih-alih mengembalikan angka yang salah, dan runtime-nya soft float, jadi float bekerja dan binari vendor hard-float tidak. Cache, flash dan PSRAM: kode berjalan dari RAM internal. RTC, koprosesor ULP dan deep sleep. ADC2, sensor sentuh dan sensor hall. Controller I2C dan SPI, I2S dan RMT. Wire dan SPI di runtime adalah perangkat lunak di pin biasa, seperti di setiap board di sini: Wire.begin() menaruh SDA di 21 dan SCL di 22, dan SPI memakai 18 (SCK), 19 (MISO), 23 (MOSI) dan 5 (SS). Adafruit_NeoPixel.h menggerakkan strip WS2812 dengan mengatur waktu tiap bit pada cycle counter core, karena RMT yang akan dipakai ESP32 sungguhan tidak ada di sini. Timer group di luar timer pertama dari timer group 0 dan watchdog-nya (yang menjalankan task watchdog, seperti ESP-IDF).

Binari vendor ESP-IDF dan Arduino-core tidak akan berjalan di sini: runtime-nya milik kami.

Mengompilasi sketch-mu

Edit sketch dan tekan Jalankan: sketch dikompilasi di tab, seperti di board lain di sini, dengan clang sungguhan yang dikompilasi ke WebAssembly. Untuk chip ini itu adalah clang milik Espressif sendiri, yang punya back end Xtensa, jadi build pertama di ESP32 mengunduh toolchain terpisah (clang-v3, sekitar 80 MB, sekali saja) dan build berikutnya memakainya lagi. Tidak ada yang di-upload. Contoh yang belum disentuh tetap menjalankan program prebuilt-nya; ubah satu baris dan Jalankan akan build milikmu.

Aritmetika floating-point bekerja: model ini tidak punya FPU, jadi build melakukan penjumlahan float dan double di perangkat lunak, seperti di board yang sama sekali tidak punya FPU. Compiling in the browser punya penjelasan lengkapnya.

The full list of what the model implements, and a plain account of which register addresses came out of the technical reference manual and which are this model's belief, is in model ESP32 DevKit. Bagian 6 adalah yang perlu dibaca sebelum membawa build dari sini ke silikon sungguhan.

Library bawaan Arduino yang dipakai board lain untuk mengompilasi (Servo.h, Wire.h, EEPROM.h, Adafruit_SSD1306.h dan sisanya) juga ada di include path di sini. Wire.h, Adafruit_NeoPixel.h dan Keypad.h sudah dicoba di board ini, dengan scan I2C di 21 dan 22, strip yang menyala dan keypad 4x4; sisanya belum dicoba di sini.

MicroPython

Board bisa menjalankan Python alih-alih sketch. Pilih MicroPython (main.py) di panel Firmware dan Jalankan akan boot firmware MicroPython v1.29.0 resmi untuk ESP32 dan menjalankan main.py-mu. Itu berjalan di model seluruh chip, di-boot dari mask ROM Espressif, jadi batasan di atas adalah milik runtime Arduino, bukan MicroPython: machine.I2C, machine.SPI, RMT di balik neopixel dan network.WLAN ada untuknya. Lihat MicroPython di ESP32.

Contoh-contoh

Blink, Button, Serial, Fade, Knob, dan tiga sketch WiFi: WiFi: gabung ke jaringan, WiFi: ambil cuaca dan WiFi: lampu di halaman web. Masing-masing menjalankan program bawaannya sampai kamu mengubahnya, lalu Jalankan akan mem-build versimu.

Firmware yang kamu build sendiri

Sketch Arduino dibangun di sini dan berjalan di satu core. Program yang dibangun di tempat lain, dengan ESP-IDF atau dalam Rust (esp-hal, esp-idf-hal), juga berjalan, pada model chip lengkap dengan kedua core: upload .bin atau .elf di panel Firmware, dan board akan boot darinya seperti setelah idf.py flash. Wi-Fi dan Bluetooth adalah celahnya, karena driver keduanya adalah library tertutup milik Espressif: firmware yang menyalakan salah satunya akan berhenti dengan pesan yang menyatakannya. Langkah-langkahnya dan daftar lengkapnya ada di Menjalankan firmware yang sudah jadi.

Di tempat lain