Örneklerin çalıştığı genel bakış şurada: kart sayfası ve ESP32-S3 modeli (her kayıt).
Nedir
ESP32-S3-DevKitC-1, Espressif'in ESP32-S3 için geliştirdiği kart, bizim kendi Xtensa çekirdeğimizde çalışıyor. Firmware, gerçek ESP32-S3 adresleriyle konuşan bir Xtensa ELF ve o adreslerin neredeyse tamamı Espressif'in teknik referans kılavuzuyla karşılaştırılarak doğrulandı.
Kart 62,7 x 25,4 mm ve iki sıra 22 pini 0,9 inç arayla dizili, yani klasik ESP32 DevKit gibi bir breadboard'un orta kanalına oturuyor ve her iki tarafta birer sıra delik boş kalıyor.
Pinler
Uzun kenarların her birinde yirmi iki pin, altta iki micro-USB soketi, üstte modül ve anteni. İpek baskıda her GPIO numarasıyla yazılı.
J1, sol sütun, yukarıdan aşağıya: 3V3, 3V3, RST, 4, 5, 6, 7, 15, 16, 17, 18, 8, 3, 46, 9, 10, 11, 12, 13, 14, 5V, G.
J3, sağ sütun, yukarıdan aşağıya: G, TX, RX, 1, 2, 42, 41, 40, 39, 38, 37, 36, 35, 0, 45, 48, 47, 21, 20, 19, G, G.
TX ve RX, GPIO 43 ve 44, yani UART0. RST chip enable pinidir. 5V, USB hattıdır. Bu bir 3.3 volt karttır ve pinleri 5 V'a dayanıklı değildir.
Pin diziliminin sana yapabileceği şeyler
- GPIO 35, 36 ve 37, oktal PSRAM'lı kartlarda (çoğu insanın aldığı N8R8) PSRAM'a aittir. Başlıkta yer alırlar ve o kartlarda onları kullanmamalısın. Mokxi'de PSRAM yoktur, dolayısıyla burada çalışırlar, gerçekte çalışmayabilirler.
- GPIO 19 ve 20, USB portunun D- ve D+ pinleridir. Gerçek bir kartta onları sürersen "USB" soketi çalışmaz. Burada USB seri portu çalışmaya devam eder, ki bu silikondan daha naziktir.
- GPIO 0, 3, 45 ve 46 strapping pinleridir, yani açılışta neyin kablolandığı önemlidir. GPIO 0 ayrıca BOOT butonudur.
- Bazı pinler girişleri kapalı olarak açılır. GPIO 4 ile 8, 15, 16 ve 19 ile 21,
pinModegiriş tamponunu açana kadar 0 okur, ki bu çipin sıfırlama durumudur.pinModebunu her zaman yapar, yani bir kod bunu hiç fark etmez.
The RGB LED
Kartın düz bir LED'i yok. Kartta adreslenebilir bir RGB LED var, WS2812 türü bir parça, ilk kartlarda GPIO 48 üzerinde, v1.1'de ise GPIO 38 üzerinde; Espressif bunu iki revizyon arasındaki tek fark olarak listeliyor. Kartın revision özelliği, breadboard'unda hangisinin olduğunu seçer.
Bu kartta LED_BUILTIN bir GPIO numarası değildir: Arduino çekirdeğindeki gibi, GPIO sayısı artı LED'in pinidir ve digitalWrite(LED_BUILTIN, HIGH) LED'e onu dörtte bir parlaklıkta beyaz yakan bir kare gönderir. Renk için: rgbLedWrite(RGB_BUILTIN, red, green, blue). İkisi de çipin RMT çevre biriminden çıkar, önce yeşil olmak üzere 24 bit, her bit WS2812B veri sayfasındaki zamanlamanın içinde ve karttaki LED, karenin taşıdığı renkte yanar.
Örnekler, Arduino çekirdeğinin kart tanımında olduğu gibi GPIO 48 için hazırlanmıştır. v1.1 kartında LED GPIO 38 üzerinde olduğundan aynı kod onu yakmaz, ki masa başında da olacak olan budur. Pin başlıkta da vardır, yani 48 numaralı pine kablolanmış bir ws2812 şerit aynı kareleri görür.
analogRead: on kanal ve en üst değer 2.9 V
ADC1'in on kanalı GPIO 1 ile 10 arasıdır: n numaralı kanal, GPIO n + 1'dir. On iki bit. Varsayılan 12 dB zayıflatmada veri sayfasındaki ölçüm aralığı 2.9 V'ta biter ve Mokxi oradan yukarısı için 4095 okur, dolayısıyla 3.3 V hattına bağlanmış bir potansiyometre, dönmesinin en üst sekizde birinde 4095 okur. knob örneği ham sayıyı yazdırır, yani bu bir gizem olarak kalmaz.
2.9 V'a kadar o düz çizgi bir yaklaşımdır: gerçek bir S3, aralığın üzerinde biraz pay bırakır ve iki uçta bükülür, çipe yazılmış kalibrasyonla düzeltilir. ADC2 modellenmemiştir.
analogWrite LEDC'dir ve çekirdeğe hiçbir maliyeti yoktur
analogWrite(pin, 0..255), LEDC'nin sekiz kanalından birini pine bağlar: herhangi bir GPIO'da, GPIO matrisi üzerinden, 1 kHz'de sekiz bit. Frekans önemli olduğunda ledcAttach(pin, frequency, bits) ve ledcWrite(pin, duty) oradadır. S3'te LEDC ayarları yalnızca bir güncelleme biti yazıldığında etkili olur ve çalışma zamanı onu yazar; solan bir LED çekirdeğe hiçbir maliyet getirmez.
Serial ve iki USB soketi
Gerçek bir DevKitC-1'de iki micro-USB soketi vardır. "UART", bir USB-UART köprüsünden UART0'a gider: USB CDC On Boot kapalıyken bu Serial'dır, ki bu kartın varsayılanıdır. "USB" ise çipin kendi USB Serial/JTAG denetleyicisidir: bu da USBSerial'dır ve her satırın sonunda bir kez 64 baytlık paket gönderir.
Buradaki seri monitör ikisini birden dinler, yani hangisinden yazdırırsan aynı yerde görünür ve yazdığın şey ikisine de gider.
Tek çekirdek, iki değil
Gerçek bir S3'te iki Xtensa LX7 çekirdek vardır ve buradaki bir Arduino kodu bir tanesinde çalışır. setup() ve loop() çevresinde yazılmış bir kod bunu hiç fark etmez. Çekirdek 1 üzerinde görev başlatan her şey çalışmaz.
Kendin derlediğin bir firmware farklıdır: MicroPython ve bir ESP-IDF derlemesi, her iki çekirdeğin de gerçekten çalıştığı tüm çipin modeli üzerinde çalışır (aşağıda).
What is modeled
Xtensa LX7, bir derleyicinin C'den ürettiği her şey için klasik ESP32'nin LX6 komut setidir: aynı pencereli ABI ve S3 derleyicisinin çıktısı, ESP32 derleyicisininkiyle bayt bayt karşılaştırıldı. Etrafında: iki veri yolu üzerinden görünen 416 KB SRAM, her pini kılavuzdaki sıfırlama çekmeleriyle GPIO matrisi ve IO MUX, UART0, USB Serial/JTAG seri portu, millis() ve micros() arkasındaki SYSTIMER, ADC1, LEDC, RMT'nin dört aktarım kanalı, saat kapıları ve dört kaynağın ihtiyaç duyduğu kadar kesme matrisi.
WiFi, simulated
Radyo yoktur. Var olan şey Mokxi'nin simüle edilmiş ağıdır, klasik ESP32 ve ESP32-C3'ün sahip olduğu aynı ağ, çipin bloğu değil Mokxi'nin kendi bloğunun arkasında, S3'ün eşleştirmemiş bıraktığı bir adreste. WiFi.h,
HTTPClient.h ve WebServer.h bir eğitim kılavuzunun beklediği gibi çalışır: kart, adı ve parolası kartın özellikleri olan bir erişim noktasına katılır, uydurma bir adresten bir sayfa getirir: .mokxi, ya da Web paneline bir sayfa sunar. 802.11 yoktur, TCP yoktur, TLS yoktur ve gerçek internet yoktur. Tek istisna, Cloud panelindeki Gerçek internet anahtarıdır; bu, başka adlar için istekleri Mokxi'nin ağ geçidinden dışarı gönderir. Bluetooth LE de aynı şekilde simüle edilir, düzenleyicinin Bluetooth bölmesinde bir telefonla (Bluetooth, simüle edilmiş).
WiFi, simulated nasıl kullanılacağını; Simulated WiFi ise sözleşmeyi anlatır.
Neler dahil değil
Herhangi bir radyo: WiFi ve Bluetooth LE simüle edilir, altlarında gerçek bir radyo yoktur. İkinci çekirdek. FPU ve S3'ün vektör komutları: ikisi de yanlış bir sayı döndürmek yerine hata verir ve çalışma zamanı yazılımsal kayan noktadır. SRAM0, önbellek, flash ve PSRAM. RTC, ULP yardımcı işlemcileri ve derin uyku. ADC2, dokunma sensörü ve sıcaklık sensörü. Zamanlayıcı gruplarının zamanlayıcıları (görev watchdog'u için watchdog'ları modellenmiştir). UART1 ve UART2, I2C ve SPI denetleyicileri, I2S, kamera arayüzü, TWAI ve USB OTG. Çalışma zamanındaki Wire ve SPI, buradaki her kartta olduğu gibi sıradan pinler üzerinde yazılımdır: SDA 8'de, SCL 9'da, SPI ise 10 ile 13 arasındadır.
Üretici ESP-IDF ve Arduino-core ikili dosyaları burada çalışmaz: çalışma zamanı bizimdir.
Kodun derleniyor
Kodu düzenle ve Çalıştır'a bas: kod, sekmede Espressif'in Xtensa için clang'ı ile derlenir; klasik ESP32 ve ESP8266'nınkiyle aynı araç zinciridir (clang-v3, yaklaşık 80 MB, bir kez indirilir). Hiçbir şey yüklenmez. Dokunulmamış bir örnek, S3 için Espressif'in GCC'si ile derlenmiş hazır programını çalıştırır; GCC'den hiçbir şey ona bağlanmaz.
Kayan noktalı aritmetik çalışıyor: bu modelde FPU yok, bu yüzden derleme float ve double toplamalarını, hiç FPU'su olmayan kartlardaki gibi yazılımla yapıyor. Tam bilgi için Tarayıcıda derleme bölümüne bak.
Örnekler
Blink, Rainbow, Button, Serial, USB serial, Fade, Knob ve dört WiFi örneği: WiFi: ağa katıl, WiFi: hava durumunu çek, API laboratuvarı: JSON çek ve WiFi: web sayfasında bir lamba.
Kendin derlediğin bir firmware
Burada bir Arduino kodu derlenir ve tek çekirdekte çalışır. Başka bir yerde derlenen bir program, ESP-IDF ile veya Rust'ta (esp-hal, esp-idf-hal), yine çalışır, tüm çipin modelinde her iki çekirdekte: firmware'ini Firmware panelinde .bin ya da .elf yükle, kart onu tıpkı idf.py flash. Wi-Fi ve Bluetooth eksik kalan kısımdır, çünkü sürücüleri Espressif'in kapalı kütüphaneleridir: ikisinden birini başlatan bir firmware, bunu belirten bir satırla durur. Adımlar ve tam liste şurada:
Hazır bir firmware çalıştırmak.
MicroPython ve CircuitPython
Bunun yerine kartın Firmware panelinde şunu seç: MicroPython (main.py) kartın Firmware panelinde ve Çalıştır, resmi MicroPython v1.29.0 firmware'ini ESP32-S3 için senin 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.
Pick CircuitPython (code.py) instead and Run boots the official CircuitPython 10.3.1 firmware for this board, with its CIRCUITPY drive and its REPL on the S3's own USB port. WiFi is not simulated under CircuitPython here. See Pico'da CircuitPython, bu kartı da kapsar.
Başka yerlerde
- Kart sayfası: /boards/esp32-s3
- The contract document: ESP32-S3 modeli, whose section 6 lists the few numbers that are believed rather than checked
- Diğer Xtensa kartları: ESP32 DevKit ve ESP8266 NodeMCU
- Aynı çip diğer kartlarda: XIAO ESP32-S3 ve Arduino Nano ESP32