Board

ESP32-C3

Inti RISC-V pada 160 MHz dengan peta memori sungguhan, tanpa radio dan dengan jaringan tersimulasi sebagai penggantinya.

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

Apa ini

ESP32-C3-DevKitM-1: chip RISC-V 32 bit yang berjalan di core RV32IMC buatan kami sendiri, yang lolos rangkaian uji riscv-tests di browser. Modelnya memakai peta memori ESP32-C3 yang asli dan offset register yang asli untuk semua yang diimplementasikannya, jadi firmware yang dibuat di sini bisa jalan di DevKitM-1 sungguhan.

CPU berjalan dalam potongan 10 mikrodetik pada 160 MHz, satu instruksi per siklus, dan perubahan pin di dalam satu potongan diletakkan tepat pada instruksi yang menyebabkannya.

Pin-pin-nya

Dua header 15-pin, dengan urutan yang sama seperti board aslinya.

Header kiri, dari atas ke bawah: GND, 3V3, 3V3b, 2, 3, RST, GNDb, 0, 1, 10, 4, 5, 6, 7, 8.

Header kanan: 5V, 5Vb, GNDc, GNDd, 9, 18, 19, 20, 21, lalu enam pin bertanda NC, yang digambar agar headernya lengkap dan tidak pernah dibaca.

GPIO 0 sampai 10, 18, 19, 20 dan 21 bisa dipakai. Ini adalah board 3.3 volt: sebuah output mengeluarkan 3.3 V atau 0 V, ambang inputnya 1.65 V, dan pull-up serta pull-down internal keduanya sekitar 45 k.

RST punya pull-up 10 k; menariknya di bawah 1,65 V menahan chip dalam keadaan reset.

GPIO 8 membawa LED pada board, itulah kenapa LED_BUILTIN bernilai 8. Di sini LED itu digambar sebagai LED biasa. Pada ESP32-C3-DevKitM-1 asli, LED itu adalah RGB yang bisa dialamati (komponen jenis WS2812 dengan pengendalinya sendiri), yang mengabaikan pin yang hanya di-set tinggi atau rendah: Blink yang diupload dari Mokxi tidak menyalakan apa pun di board aslinya. Core Arduino dari Espressif mengatasinya dengan memberi LED_BUILTIN nomornya sendiri dan mengubah digitalWrite() padanya menjadi warna yang dikirim ke LED, jadi Blink dari Arduino IDE menyalakannya, putih redup. Untuk melihat kedipan dari build Mokxi di board asli, sambungkan sebuah LED dan resistor ke pin lain.

Pin analog

GPIO 0 sampai GPIO 4 adalah kanal ADC1 0 sampai 4, dan analogRead() pada salah satunya adalah konversi sungguhan dari tegangan di pin tersebut: dua belas bit, 0 sampai 4095, terhadap skala penuh yang dipilih atenuasi. Bawaannya 11 dB, kurang lebih seluruh rel 3,3 V, jadi potensiometer atau thumb stick yang dipasang melintasi catu daya mencakup seluruh rentangnya; analogSetPinAttenuation() menerima ADC_0db (1,1 V), ADC_2_5db (1,5 V), ADC_6db (2,2 V) atau ADC_11db, dan analogReadResolution() menggeser hasilnya kalau kamu ingin sepuluh bit seperti Uno.

One read costs about five microseconds of simulated time, which is what the converter takes. A pin with nothing on it reads 0 rather than noise. Any other pin reads 0 too: there are five analog inputs and no more.

PWM

analogWrite(pin, 0..255) berfungsi di GPIO mana pun. Keluarannya berasal dari LEDC, pengendali PWM LED milik chip, dan sampai ke pin melalui matriks GPIO, jadi tidak ada kumpulan pin ~ tetap seperti pada Uno.

Bawaannya adalah delapan bit pada 1 kHz. Saat frekuensinya penting (servo butuh lima puluh bingkai per detik dan lebar pulsa, bukan duty), pakai ejaan ESP32:

ledcAttach(4, 50, 14);        // fifty frames a second, 16384 counts each
ledcWrite(4, 1229);           // 1.5 ms of a 20 ms frame: the middle

Ada enam kanal dan empat timer. Kanal yang meminta frekuensi dan resolusi yang sama berbagi satu timer, jadi enam pin yang memudar bersama hanya memakan satu dari empat; minta pasangan kelima yang berbeda dan ledcAttach mengembalikan false, bukan menyetel ulang timer yang sedang dipakai pin lain. pinMode() dan digitalWrite() mengambil kembali pin dari LEDC.

Duty 0 berarti rendah terus dan duty 255 berarti tinggi terus, langsung dari perangkat keras, tanpa tepi sama sekali, yang juga berarti simulator tidak punya apa pun untuk membangunkan board, dan board yang memudarkan LED sambil parkir di wfi hanya memakan dua wakeup per milidetik, tidak lebih.

Serial

Di board asli, pin 20 dan 21 adalah UART0 dan pin 18 serta 19 adalah USB. Di sini keduanya GPIO biasa, dan byte dari UART0 pergi ke Serial Monitor. Lihat Jalankan dan serial monitor.

What is modeled

GPIO, IO_MUX, UART0, SYSTIMER, jalur one-shot ADC1, dan kelompok kecepatan rendah LEDC, di alamat aslinya dengan bit-bit aslinya, plus interupsi eksternal mesin untuk GPIO dan UART.

delay() memarkir core pada alarm SYSTIMER alih-alih berputar, jadi sketch yang menganggur hanya memakan beberapa ratus instruksi per detik simulasi dari simulator, bukan seratus enam puluh juta.

Beberapa alamat register belum terverifikasi

Dua dari blok di atas membawa alamat yang tidak bisa dipertanggungjawabkan oleh model ini. Alamat dasar serta offset GPIO, IO_MUX, UART0 dan SYSTIMER berasal dari manual referensi teknis. Di dalam SAR ADC, setiap offset register one-shot kecuali dua yang pertama adalah pilihan model ini, bukan baris yang dikutip dari halaman manual; hal yang sama berlaku untuk empat register interupsi LEDC, register konfigurasi global dan tanggalnya, serta enam nomor sinyal matriks GPIO yang dilewati kanal LEDC untuk sampai ke pad. Firmware yang dibuat di sini cocok dengan model ini, cocok atau tidaknya dengan silikon, dan image yang akan dibawa ke DevKitM-1 asli sebaiknya memeriksa dulu daftar pendek #define di firmware/include/esp32c3.h. Bagian 7 dari model ESP32-C3 mengelompokkan setiap alamat menjadi diambil dari manual, diyakini tapi belum diverifikasi, dan tidak ada.

WiFi, simulated

Tidak ada radio. Dan tidak akan pernah ada: MAC 802.11 bukanlah sesuatu yang bisa direproduksi model ini dengan jujur. Bluetooth LE disimulasikan seperti halnya jaringan, dengan sebuah HP di panel Bluetooth editor editor (Bluetooth, disimulasikan).

Yang ada sebagai gantinya adalah jaringan simulasi. Sebuah blok milik Mokxi sendiri, bukan milik chip (sebuah mailbox di 0x6FFF_E000, tempat C3 asli sama sekali tidak punya pemetaan) membawa WiFi.h, HTTPClient.h dan WebServer.h, jadi kode Arduino yang diberikan tutorial bisa berjalan di sini: board bergabung ke access point yang nama dan sandinya adalah properti board, WiFi.status() melewati status yang sama dalam satu sampai tiga detik yang sama, DHCP memberinya lease 192.168.4.2, dan sketch bisa mengambil sebuah 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.

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

Watchdog dan stack

As on the board, ESP-IDF's task watchdog runs from before setup() with a 5 s timeout: a sketch that neither calls delay() nor returns from loop() for that long prints the "Task watchdog got triggered" lines and reboots, and esp_reset_reason() says ESP_RST_TASK_WDT (6) afterwards. disableCore0WDT() turns that off, and esp_task_wdt_add(NULL) watches the sketch's own resets. A stack that runs out (recursion that never ends) stops with a "stack overflow" crash line at the top of the heap, before it writes over the program.

Yang tidak

Tidak ada: SPI dan I2C sebagai periferal, timer dari grup timer (watchdog-nya ada, untuk task watchdog), RMT, USB Serial/JTAG, matriks interrupt lengkap, dan apa pun dari ESP-IDF. Dari SAR ADC hanya jalur one-shot ADC1 yang dimodelkan, bukan ADC2 (yang di silikon asli dipakai bersama radio), tabel pola DMA, controller digital, filter dan monitor ambang, atau kurva kalibrasi di eFuse, jadi hasil pembacaan di sini adalah garis lurus nominal, bukan sedikit melengkung seperti komponen asli, tanpa derau dan tanpa nonlinearitas sama sekali. Flag done milik ADC bisa di-polling tetapi tidak sampai ke interrupt controller. Biner vendor di luar cakupan; yang berjalan adalah firmware yang dibuat dengan runtime milik kami sendiri, yang dibuatkan editor untukmu.

Satu instruksi adalah satu siklus pada 160 MHz, tanpa cache, tanpa wait state flash dan tanpa pipeline stall, jadi program di sini berjalan lebih rata daripada di silikon. Pin 3V3 dan 5V adalah sumber ideal yang tidak bisa turun tegangannya, jadi tidak ada yang pernah brown out di Mokxi.

Register demi register, model ESP32-C3 memilikinya semua.

Library Arduino bawaan

Tutorial yang memakai Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h dengan Adafruit_SSD1306.h, Adafruit_NeoPixel.h, ESP32Servo.h dan DHT.h dikompilasi di sini apa adanya. Masing-masing adalah header buatan Mokxi sendiri dengan nama upstream, ditulis di atas driver untuk komponen di kotak komponen, dan tidak ada satu pun yang merupakan kode library upstream.

  • Wire.begin() menempatkan bus I2C di GPIO 8 (SDA) dan GPIO 9 (SCL), pilihan Arduino core untuk board ini; Wire.begin(sda, scl) memindahkannya.
  • EEPROM.h bekerja, tapi model board ini tidak punya EEPROM atau flash yang bisa ditulis, jadi byte-nya tinggal di RAM sebesar 4 KB: byte itu terbaca kembali selama satu Run dan hilang saat reset.

Editor kode dan kompilasi mencantumkan apa yang dicakup masing-masing dan bagaimana bedanya dengan library upstream.

Contoh-contoh

Blink, Button, Serial, Fade, PWM fade, Servo sweep, Counter, Interrupt, WiFi: join the network, WiFi: fetch the weather, WiFi: a lamp on a web page, Thumb stick, Rainbow strip, Plasma panel, OLED text and shapes, OLED dice, OLED pong, Pong console, Binary clock, Electronic dice, Knight Rider, Morse sender, Simon, Stacker dan Talker.

PWM fade dan Servo sweep adalah dua demo yang memakai LEDC. Yang pertama adalah LED berkedip halus yang sama seperti Fade, dibuat oleh perangkat keras alih-alih secara manual, yang merupakan perbedaan antara core yang terjaga setiap mikrodetik dari gelombang dan yang tidur di antara langkah; yang kedua menggerakkan SG90 dengan kanal 50 Hz, di mana yang dibaca servo adalah lebar pulsa, bukan duty.

Thumb stick dan OLED pong adalah dua demo yang membaca ADC. Demo stick mencetak kedua sumbu dan menyalakan LED di sisi tempat kamu mendorong, terang atau redup tergantung seberapa jauh; OLED pong adalah game stick milik Uno di board ini, dengan paddle mengikuti pot sumbu Y stick di GPIO 0 dan skor dalam font 5x7 yang tidak muat di Uno.

Demo strip dan panel ditulis untuk board ini. Driver WS2812 yang sama juga berjalan di board AVR, anggota keluarga ESP32 lainnya, Pico dan Uno R4.

Stacker adalah yang ada di halaman depan. Dua matriks MAX7219 8x8 berdiri satu di atas yang lain, membentuk area main selebar delapan piksel dan setinggi enam belas, dan satu tombol arcade 30 mm di GPIO 3 menjatuhkan blok yang meluncur. Keduanya dirangkai berantai sebagaimana chip ini dirancang: data di GPIO 7 hanya sampai modul atas, DOUT-nya mengisi DIN modul bawah, dan clock di GPIO 5 serta satu chip select di GPIO 6 pergi ke keduanya. Sketch mengirim dua paket di antara satu pasangan tepi CS, paket modul bawah lebih dulu, karena paket yang dikirim lebih dulu terdorong paling jauh di sepanjang rantai. Matriks ditenagai dari pin 5V board, bukan 3V3, karena MAX7219 butuh empat volt atau lebih. Jika tak ada yang menekan tombol selama empat detik, sketch bermain sendiri, dan satu tekanan mengembalikan permainan.

MicroPython

Pilih MicroPython (main.py) di panel Firmware board dan Jalankan mem-boot firmware MicroPython v1.29.0 resmi untuk ESP32-C3 dengan main.py, pada model seluruh chip yang di-boot dari ROM Espressif sendiri. machine.Pin, PWM, ADC, I2C, SPI, UART(1) dan neopixel kamu buat, dan network.WLAN bergabung ke jaringan simulasi. Lihat MicroPython di ESP32.

Di tempat lain