Kartlar

ESP32-C3

Gerçek bellek haritasında 160 MHz'de çalışan bir RISC-V çekirdek, radyo yok ve yerine simüle edilmiş bir ağ.

Örneklerin çalıştığı genel bakış şurada: kart sayfası ve ESP32-C3 modeli (her kayıt).

Nedir

ESP32-C3-DevKitM-1: tarayıcıda riscv-tests paketini geçen kendi RV32IMC çekirdeğimiz üzerinde çalışan 32 bitlik bir RISC-V çip. Model, gerçek ESP32-C3 bellek haritasını ve uyguladığı her şey için gerçek register ofsetlerini kullanır, bu yüzden burada derlenen firmware gerçek bir DevKitM-1'de çalışır.

CPU, 160 MHz'de 10 mikrosaniyelik dilimlerde çalışır, döngü başına bir komut işlenir ve bir dilim içindeki pin değişikliği, ona neden olan komutun tam konumuna yerleştirilir.

Pinler

Gerçek karttaki sırayla iki 15 pinli header.

Sol header, üstten alta: GND, 3V3, 3V3b, 2, 3, RST, GNDb, 0, 1, 10, 4, 5, 6, 7, 8.

Sağ header: 5V, 5Vb, GNDc, GNDd, 9, 18, 19, 20, 21, ardından header tamam görünsün diye çizilen ve asla okunmayan NC işaretli altı pin.

GPIO 0 ile 10, 18, 19, 20 ve 21 kullanılabilir. Bu bir 3.3 volt kart: bir çıkış 3.3 V ya da 0 V üretir, giriş eşiği 1.65 V'tur ve dahili pull-up ile pull-down dirençleri yaklaşık 45 k'dır.

RST pininde 10 k pull-up vardır; 1.65 V altına çekmek çipi reset halinde tutar.

GPIO 8 üzerindeki LED'i taşır, LED_BUILTIN'in 8 olmasının nedeni budur. Burada düz bir LED olarak çizilmiştir. Gerçek bir ESP32-C3-DevKitM-1 üzerinde adreslenebilir bir RGB LED'dir (kendi denetleyicisi olan WS2812 tipi bir parça) ve yalnızca yüksek veya alçak yapılmış bir pini yok sayar: Mokxi'den yüklenen Blink gerçekte hiçbir şey yakmaz. Espressif'in Arduino çekirdeği buna, LED_BUILTIN'e kendi özel bir numara vererek ve üzerindeki digitalWrite() çağrısını LED'e gönderilen bir renge çevirerek çözüm bulur, böylece Arduino IDE'nin Blink'i sönük beyaz da olsa onu yakar. Mokxi derlemesinin Blink'ini gerçek kartta görmek için başka bir pine bir LED ve bir direnç bağla.

Analog pinler

GPIO 0 ile GPIO 4, ADC1'in 0 ile 4 arası kanallarıdır ve bunlardan birinde analogRead(), pimdaki gerilimin gerçek bir dönüşümüdür: on iki bit, 0 ile 4095 arasında, zirveye göre; ölçek aralığını zayıflatma ayarı belirler. Varsayılan 11 dB'dir, yani yaklaşık 3.3 V'un tamamı; böylece besleme üzerine bağlanmış bir potansiyometre veya bir kumanda kolu tüm aralığı kaplar. analogSetPinAttenuation() şunları alır: ADC_0db (1.1 V), ADC_2_5db (1.5 V), ADC_6db (2.2 V) veya ADC_11db; analogReadResolution() ise bir Uno'nun on bitini geri istersen sonucu kaydırır.

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) herhangi bir GPIO'da çalışır. Çıkış, çipin LED PWM denetleyicisi olan LEDC'den gelir ve GPIO matrisi üzerinden pine ulaşır; yani bir Uno'daki gibi sabit bir ~ pini kümesi yoktur.

Varsayılan 1 kHz'de sekiz bittir. Frekans önemli olduğunda (bir servo saniyede elli kare ve bir darbe genişliği ister, görev döngüsü değil) ESP32 yazımını kullan:

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

Altı kanal ve dört zamanlayıcı vardır. Aynı frekans ve çözünürlüğü isteyen kanallar bir zamanlayıcıyı paylaşır; böylece birlikte solan altı pin dördünden birine mal olur. Beşinci ayrı çifti iste ve ledcAttach, başka bir pinin kullandığı bir zamanlayıcıyı yeniden ayarlamak yerine false döndürür. pinMode() ve digitalWrite() pini LEDC'den geri alır.

0 görev döngüsü, donanımdan gelen tam bir alçak seviyedir ve 255 tam bir yüksek seviye, hiç kenar yoktur; bu, simülatörün kartı uyandıracağı bir şey olmadığı ve wfi'de bekleyen bir kartın LED'i soldurması, milisaniyede iki uyanışa ve başka hiçbir şeye mal olmadığı anlamına gelir.

Seri

Gerçek kartta 20 ve 21 pinleri UART0, 18 ve 19 pinleri USB'dir. Burada bunlar düz GPIO'dur ve UART0'ın baytları seri monitöre gider. Şuna bak: Çalıştır ve seri monitör.

What is modeled

GPIO, IO_MUX, UART0, SYSTIMER, ADC1'in tek atımlık yolu ve LEDC'nin yavaş hız grubu, gerçek adreslerinde ve gerçek bitleriyle, ayrıca GPIO ve UART için makine harici kesmesi.

delay() çekirdeği dönme yapmak yerine bir SYSTIMER alarımında bekletir; böylece boşta bir kod, simülatöre simüle edilen saniye başına yüz altmış milyon yerine yalnızca birkaç yüz komuta mal olur.

Bazı yazmaç adresleri doğrulanmamıştır

Yukarıdaki bloklardan ikisi, bu modelin arkasında duramayacağı adresler taşır. Temel adresler ile GPIO, IO_MUX, UART0 ve SYSTIMER ofsetleri teknik referans kılavuzundakilerdir. SAR ADC'nin içinde, ilk ikisi dışındaki tek atımlık yazmaç ofsetlerinin her biri, kılavuzun bir sayfasından alınan bir satır değil, bu modelin kendi seçtiği değerlerdir; aynısı LEDC'nin dört kesme yazmacı, genel yapılandırma ve tarih yazmaçları ile LEDC kanallarının bir pede ulaştığı altı GPIO matrisi sinyal numarası için de geçerlidir. Burada derlenen firmware modelle uyumludur, ister silikonla uyuşsun ister uyuşmasın; gerçek bir DevKitM-1'e götürülecek bir görüntü önce firmware/include/esp32c3.h içindeki #define kısa listesini kontrol etmelidir. ESP32-C3 modelinin 7. bölümü her adresi kılavuzdan alınmış, inanılan ama doğrulanmamış ve yok olarak sınıflandırır.

WiFi, simulated

Radyo yoktur. Hiç olmayacak: bir 802.11 MAC'i bu modelin dürüstçe yeniden üretebileceği bir şey değildir. Bluetooth LE, ağla aynı şekilde simüle edilir, düzenleyicinin Bluetooth bölmesinde bir telefonla (Bluetooth, simüle edilmiş).

Onun yerine simüle edilmiş bir ağ vardır. Çipe değil Mokxi'nin kendisine ait bir blok (gerçek bir C3'te hiçbir şey eşlenmemiş olan 0x6FFF_E000 adresindeki bir posta kutusu) WiFi.h, HTTPClient.h ve WebServer.h taşır; böylece bir eğitim metninin verdiği Arduino kodu burada çalışır: kart, adı ve parolası kartın özellikleri olan bir erişim noktasına katılır, WiFi.status() aynı durumları aynı bir ile üç saniyede dolaşır, DHCP ona 192.168.4.2 kiralar ve bir kod bir sayfa çekebilir ya da sunabilir.

Arkasındaki şey yazılımdır ve bu hiç gizlenmez. 802.11 yok, kanal yok, tarama yok, WPA2 yok, TCP yok, TLS yok ve gerçek internet yok: .mokxi altındaki dört uydurma ad çözümlenir, başka hiçbiri çözümlenmez ve bir kodun yaptığı hiçbir şey tarayıcının bulunduğu ağa ulaşamaz. WiFiClientSecure derlenir ama sonra başarısız olur, TLS simüle edilmiyor der. Düzenleyicinin altındaki Web ve Bulut panelleri o cümleyle açılır ve kaydırınca da o cümle kaybolmaz.

Tek istisna Gerçek internet, Bulut panelinde giriş yapmış herkes için bir anahtar (Pro ile daha fazlası), sayfa her yüklendiğinde kapalıdır. Açık olduğunda, dışındaki bir ad için istek .mokxi, https:// dahil, Mokxi'nin ağ geçidinden çıkar ve yanıt koda geri döner. Bkz. Gerçek internet.

WiFi, simüle edilmiş nasıl kullanılacağıdır; Simüle edilmiş WiFi ise sözleşmenin kendisidir, sınır sınır.

Bekçi ve yığın

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.

Neler dahil değil

Yok olanlar: çevre birim olarak SPI ve I2C, zamanlayıcı gruplarının zamanlayıcıları (görev bekçisi için watchdog'ları oradadır), RMT, USB Serial/JTAG, tam kesme matrisi ve ESP-IDF'den her şey. SAR ADC'nin yalnızca ADC1'in tek atımlık yolu modellenmiştir, ADC2 değil (gerçek silikonda radyo ile paylaşılır), DMA desen tablosu, dijital denetleyici, filtreler ve eşik izleyiciler veya eFuse'lardaki kalibrasyon eğrisi değil. Bu yüzden buradaki bir okuma nominal düz çizgidir, gerçek bir parçanın hafif eğriliği değil; içinde hiç gürültü ve hiç doğrusalsızlık yoktur. ADC'nin tamamlandı bayrağı yoklanabilir ama kesme denetleyicisine ulaşmaz. Üreticinin ikili dosyaları kapsam dışıdır; çalışan şey, kendi çalışma zamanımıza göre derlenen firmware'dir ve düzenleyicinin sizin için derlediği de budur.

Bir komut, 160 MHz'de bir çevrimdir; önbellek, flash bekleme durumları ve pipeline duraklamaları yoktur, bu yüzden buradaki bir program silikondakinden daha düzgün çalışır. 3V3 ve 5V pinleri düşemeyen ideal kaynaklardır, yani Mokxi'de hiçbir şey hiçbir zaman gücünü kaybetmez.

Kayıttan kayda, ESP32-C3 modeli bunların hepsine sahiptir.

Hazır Arduino kütüphaneleri

Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_SSD1306.h ile birlikte Adafruit_GFX.h, Adafruit_NeoPixel.h, ESP32Servo.h ve DHT.h içeren bir eğitim burada olduğu gibi derlenir. Her biri, parça kutusundaki parçaların sürücüleri üzerine yazılmış, yukarı akış adını taşıyan Mokxi'nin kendi başlık dosyasıdır ve hiçbiri yukarı akış kütüphanesinin kodu değildir.

  • Wire.begin() I2C veriyolunu GPIO 8 (SDA) ve GPIO 9 (SCL) üzerine koyar; Arduino çekirdeğinin bu kart için seçimi budur. Wire.begin(sda, scl) onu taşır.
  • EEPROM.h çalışır, ama bu kartın modelinde EEPROM veya yazılabilir flash yoktur, bu yüzden baytlar 4 KB RAM'de yaşar: bir Çalıştır boyunca geri okunurlar ve sıfırlamada kaybolurlar.

Kod düzenleyici ve derleme, her birinin neleri kapsadığını ve orijinal kütüphaneden nasıl farklılaştığını listeler.

Örnekler

Blink, Button, Serial, Fade, PWM fade, Servo sweep, Counter, Interrupt, WiFi: ağa katıl, WiFi: hava durumunu çek, WiFi: web sayfasında bir lamba, 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 ve Talker.

PWM fade ve Servo sweep LEDC kullanan ikisidir. İlki Fade ile aynı nefes alan LED'dir, elle değil donanımla yapılmış; aralarındaki fark, çekirdeğin dalga formunun her mikrosaniyesi boyunca uyanık olması ile adımlar arasında uyumasıdır. İkincisi 50 Hz'lik bir kanalla SG90'ı süpürür; servonun okuduğu şey görev döngüsü değil darbe genişliğidir.

Thumb stick ve OLED pong ADC'yi okuyan ikisidir. Stik demosu her iki ekseni de yazdırır ve bastığınız tarafa doğru LED'i yakar; ne kadar bastığınıza göre parlak ya da sönük yanar. OLED pong ise Uno'nun stik oyununun bu karttaki halidir; raket GPIO 0'daki stikin Y potunu takip eder ve skor, Uno'nun yer açamadığı 5x7 yazı tipiyle gösterilir.

Şerit ve panel demoları bu kart için yazıldı. Aynı WS2812 sürücüsü AVR kartlarında, ESP32 ailesinin geri kalanında, Pico'da ve Uno R4'te de çalışır.

Stacker ana sayfadaki olandır. İki MAX7219 8x8 matris üst üste durur, bu da sekiz piksel genişliğinde on altı piksel yüksekliğinde bir oyun alanı yapar ve GPIO 3'teki 30 mm'lik arcade butonu kayan bloğu düşürür. Çiplerin zincirlenmesi gerektiği gibi zincirlenmişlerdir: GPIO 7'deki veri yalnızca üst modüle ulaşır, onun DOUT'u alt modülün DIN'ini besler ve GPIO 5'teki saat ile GPIO 6'daki tek çip seçimi ikisine de gider. Kod, bir CS kenar çifti arasında iki paket gönderir, önce alt modülün paketini, çünkü önce gönderilen paket zincir boyunca en uzağa itilir. Matrisler kartın 3V3 pininden değil 5V pininden beslenir, çünkü MAX7219 dört volt veya daha fazlasını ister. Dört saniye boyunca butona basan olmazsa kod kendiliğinden oynar ve bir basış oyunu geri alır.

MicroPython

Bunun yerine kartın Firmware panelinde şunu seç: MicroPython (main.py) kartın Firmware panelinde ve Çalıştır, ESP32-C3 için resmi MicroPython v1.29.0 firmware'i sizin main.pyile başlatır, Espressif'in kendi ROM'undan önyüklenen çipin tamamının modeli üzerinde. machine.Pin, PWM, ADC, I2C, SPI, UART(1) ve neopixel çalışır ve network.WLAN simüle edilmiş ağa katılır. Bkz. ESP32 üzerinde MicroPython.

Başka yerlerde