Başvuru

ESP32-S3-DevKitC-1 kart sözleşmesi (Boards Wave C)

Xtensa LX7 üzerindeki S3: iki veriyolu üzerinden görülen tek bir SRAM, GPIO matrisi, USB seri portu, LEDC, RGB LED'in arkasındaki RMT ve çipin iki çekirdeği varken sadece biri.

Bu, modelin mühendislik referansıdır: neyi uyguladığını, yazmaç yazmaç, ona karşı firmware yazan kişiler için. Kartı düzenleyicide kullanmak için başlangıç noktan ESP32-S3-DevKitC-1 ve kart sayfası.

ESP32-S3-DevKitC-1, Espressif'in ESP32-S3 için kendi kartıdır: bir ESP32-S3-WROOM-1 modülü, 240 MHz'de iki Xtensa LX7 çekirdeği, iki micro-USB yuvası ve adreslenebilir bir RGB LED. Bir çekirdek bileşeni (crates/parts içindeki esp32s3), klasik ESP32 ve ESP8266'nın kullandığı aynı Xtensa yorumlayıcı (crates/xtensa-core) üzerinde bir ESP32-S3 SoC modelini (crates/esp32s3) sarar. Bu belge sözleşmedir ve koddaki herhangi bir yorumdan üstün tutulur.

Katalog türü esp32s3'tür. Katalogdaki program dizisi elf32 xtensa lx7 esp32s3'tir.

Buradaki bir derlemeyi gerçek silikona götürecekseniz önce bölüm 6'yı oku. Klasik ESP32'nin sözleşmesinin aksine, buradaki neredeyse her sayı ESP32-S3 Technical Reference Manual (sürüm 1.8), ESP32-S3 Series Datasheet ve Espressif'in DevKitC-1 kullanıcı kılavuzu ile ölçü çizimiyle karşılaştırılarak denetlendi. Bölüm 6, denetlenmeyen az sayıdaki değeri ve hiç modellenmeyen her şeyi listeler: ikinci çekirdek, vektör uzantısı, önbellek, flash, PSRAM ve her iki radyo bunların arasındadır.

A sketch for this board compiles in the browser with clang-v3, the wasm build of Espressif's LLVM fork (-mcpu=esp32s3), published 2026-09-28 and checked on this simulator (docs/compile.md). An untouched example still runs its prebuilt ELF from web/public/firmware/esp32s3/, built by Espressif's GCC for the S3. Section 7 has the details.

1. Kart pinleri (katalog sırası)

Üstten görünüm, iki micro-USB yuvası altta, WROOM-1 modülü ve anteni üstte. Espressif'in ölçü çizimi kartı 62,74 x 25,40 mm verir ve her başlık sırası kenarından 1,27 mm içeridedir; böylece iki 22 pimli başlık 22,86 mm (0,9 inç) arayla dizilir ve kart, her iki tarafta bir sıra deliği boş kalacak şekilde bir breadboard'un üzerine oturur. Görsel onu bu boyutta çizer.

J1, soldaki başlık, pim 1 üstte (22 delik): 3V3, 3V3b, RST, 4, 5, 6, 7, 15, 16, 17, 18, 8, 3, 46, 9, 10, 11, 12, 13, 14, 5V, G.

J3, sağdaki başlık, pim 1 üstte (22 delik): Gb, TX, RX, 1, 2, 42, 41, 40, 39, 38, 37, 36, 35, 0, 45, 48, 47, 21, 20, 19, Gc, Gd.

44 pin. Bir sayı, GPIO n demektir. TX ve RX, GPIO43 ve GPIO44'tür, UART0. RST çip etkinleştirmedir. 5V, USB 5 V hattıdır. G topraktır. Yinelenen adlar bir harf taşır, çünkü katalogdaki pin adları tektir; ipek baskı bu harfi basmaz.

Doğrulandı: kullanıcı kılavuzundaki J1 ve J3 tablolarına göre her iki başlığın sırası, pim pim (v1.0 ve v1.1 kılavuzları aynı sırayı verir) ve ölçü çizimine göre sıraların konumu.

GPIO 26 ile 32 hiçbir başlıkta yok. Bunlar SPI flash'tır. GPIO 22 ile 25 parçada hiç yoktur (IO MUX işlev tablosunda onlar için satır yoktur). GPIO 33 ve 34 de başlıkta değildir. crates/parts/src/parts/esp32s3.rs bunların tümünü kapsayan bir test içerir.

GPIO 35, 36 ve 37 başlıktadır ve oktal PSRAM'li varyantlarda (çoğu insanın aldığı DevKitC-1-N8R8) PSRAM'e aittirler, kullanılmamalıdır. Bu modelde PSRAM yoktur, dolayısıyla burada sıradan pinlerdir ve kullanıcı kılavuzundaki not yardım sayfasında yinelenir.

GPIO 19 ve 20 çipin USB D- ve D+ pinleridir ve kartın "USB" soketi bunlara bağlıdır. Burada sıradan ped olarak kalırlar ve bir kod onları sürse bile USB seri portu çalışmaya devam eder; gerçek bir kart bunu yapmazdı (bölüm 3.4).

Kart üzerindeki şeyler:

  • The RGB LED. An addressable LED, on GPIO48 on the first revision and on GPIO38 on v1.1. The user guide's "Hardware Revision Details" says this is the one difference between the two. The revision property picks which, 1.0 or 1.1, and defaults to 1.0, which is where the Arduino core's board definition puts it. The LED's data line is the pad; the board part decodes the pad the way the LED's own receiver does (section 5).
  • BOOT GPIO0'dır, aktif düşük; kartta tıklamak pini toprağa çeker. J3 üzerinde de 0 olarak bulunur.
  • RST çipi sıfırlar.
  • Kırmızı bir 3.3 V güç LED'i, yanmış olarak çizilidir, çünkü kart burada her zaman USB'ye bağlıdır.

Elektriksel: her GPIO, R_STRONG üzerinden 3,3 Volttan itiş-çekiş (push-pull) sürer, yüksek empedansta (high-Z) kalır ya da 45 k üzerinden yukarı veya aşağı çeker. Bir giriş 1,65 Volttan (G/Ç beslemesinin yarısı) yüksek okunur; çekişmeli (Bilinmeyen) bir ağ 0 okunur, boşta (floating) olan ise Uno'daki gibi gürültü okunur (docs/uno.md bölüm 1). GPIO0, BOOT butonunun yanındaki kartın pull-up'ı sayesinde hiçbir şey onu aşağı çekmediğinde yüksek okunur. 3V3, R_SUPPLY üzerinden 3,3 Volt sürer, 5V 5 Volt sürer, G 0 Volt sürer. RST, 3,3 Volta bağlı bir 10 k pull-up taşır ve 1,65 Voltun altına çekildiğinde çekirdeği reset halinde tutar. Bu direncin yanındaki kondansatör, yani kartın açılışta sıfırlama (power-on reset) devresi, modellenmemiştir.

2. Bellek haritası

SRAM1, komut veriyolu 0x4037_8000 ile 0x403D_FFFF arasında 416 KB
IROM (flash code) 0x4200_0000, read-only, up to 1,310,720 bytes
DROM (flash constants) 0x3C00_0000, read-only, up to 1,310,720 bytes
SRAM1 ve SRAM2, veri veriyolu 0x3FC8_8000 ile 0x3FCF_FFFF arasında 480 KB
yığın tepe 0x3FD0_0000
UART0 0x6000_0000, bölüm 3.3
GPIO matrisi 0x6000_4000, bölüm 3.1
SENS 0x6000_8800, bölüm 3.6
IO MUX 0x6000_9000, bölüm 3.2
RMT 0x6001_6000, bölüm 3.8
LEDC 0x6001_9000, bölüm 3.7
SYSTIMER 0x6002_3000, bölüm 3.5
USB Seri/JTAG 0x6003_8000, bölüm 3.4
SYSTEM 0x600C_0000, bölüm 3.9
Kesme matrisi 0x600C_2000, bölüm 3.9

Buradaki her çevre birimi bloğu 4 KB'dir, yalnızca SENS hariç; SENS, düşük güç yönetimi bloğunun üst 2 KB'sidir.

Doğrulandı: tablodaki her adres, kılavuzdaki 4.3-1 (dahili bellek) ve 4.3-3 (çevre birimleri) tablolarıyla karşılaştırıldı. SENS, kılavuzun 39.6.2 kayıt özetinde "Düşük Güç Yönetimi taban adresi + 0x800" olarak geçiyor.

Tek SRAM, iki pencere ve modelde ikisi de var. Kılavuz, SRAM1'in "CPU tarafından veri yolu veya komut yolu üzerinden aynı sırayla adreslendiğini" söylüyor: 0x4037_8000 + n adresindeki bayt, 0x3FC8_8000 + n adresindeki bayttır. Model, veri penceresi için tek bir tampon tutar ve komut penceresini bunun ilk 416 KB'sına eşler; böylece bir program kendi kodunu veri yolu üzerinden okuyup doğru baytları alabilir, ki klasik ESP32 modeli bunu sunamaz. SRAM2 yalnızca veri yolundadır, SRAM1'in hemen ardından. firmware/esp32s3/link.ld kodu komut adresine koyar ve veri bölümlerini, kodun sonrasındaki ilk baytın veri yolu adresinden başlatır; böylece ikisi asla aynı RAM'i paylaşmaz ve elfcheck.py paylaşacakları bir imgeyi reddeder.

SRAM0, yani komut önbelleğinin kullanabileceği 0x4037_0000 adresindeki 32 KB, modellenmemiştir; ona erişim bir hatadır.

Flash. A real ESP32-S3 runs almost all of a sketch from flash through the cache: code is read at IROM and const data at DROM, and the Arduino IDE's default partition gives the sketch 1,310,720 bytes of it. That is the room a sketch has here, counted as the IDE counts it (code, literals, constants, startup code and the initial values of the variables), and the number the editor prints after a build. firmware/esp32s3/link.ld keeps the vectors, the exception entry and the startup code in SRAM1 on the instruction bus and puts every other function in the code window and every constant in the constants window. The windows are read-only views of the loaded image, not a cache: no misses, no timing (a fetch from flash costs what one from SRAM1 costs), and a store to one faults. Literal pools sit in front of their own functions (L32R reaches 256 KB backwards) and the startup code calls through registers (CALL4 reaches 128 KB). The upload build (link-hw.ld) is loaded into RAM by the ROM and keeps SRAM1 as its room.

Every PT_LOAD segment must land in one of the two SRAM windows or one of the two flash windows; anything else is refused with the offending address in the message, and the chip is left with no program. An image built for the classic ESP32 is refused this way, since its RAM is at other addresses.

Çekirdek, pc ELF giriş noktasında ve tüm adres yazmaçları sıfırlanmış durumda sıfırlanır. Burada önyükleme ROM'u yoktur: birinci aşama yükleyici, flash okumaları, saat ağacı ve önbellek kurulumunun hepsi yoktur ve çalışma zamanı, istediği durumu açıkça oluşturur.

3. Çevre birimi yazmaçları

Yalnızca aşağıdaki alt küme uygulanmıştır. Eşlenmiş bir bloğun içindeki diğer her şey 0 okur ve başıboş erişim sayılır; tüm blokların dışındaki her yer erişim hatasıdır.

3.1 GPIO matrisi (0x6000_4000)

GPIO numaraları 0 ile 48 arasındadır, bu yüzden pin başına bir biti olan her yazmaç iki yarım halinde gelir: düz olan GPIO 0'dan 31'e kadar olanları, 1 olan ise GPIO 32'den 48'e kadar olanları alt on yedi bitinde kapsar.

ofset yazmaç
0x04 GPIO_OUT_REG
0x08 GPIO_OUT_W1TS_REG
0x0C GPIO_OUT_W1TC_REG
0x10 GPIO_OUT1_REG
0x14 GPIO_OUT1_W1TS_REG
0x18 GPIO_OUT1_W1TC_REG
0x20 GPIO_ENABLE_REG
0x24 GPIO_ENABLE_W1TS_REG
0x28 GPIO_ENABLE_W1TC_REG
0x2C GPIO_ENABLE1_REG
0x30 GPIO_ENABLE1_W1TS_REG
0x34 GPIO_ENABLE1_W1TC_REG
0x38 GPIO_STRAP_REG
0x3C GPIO_IN_REG
0x40 GPIO_IN1_REG
0x44 GPIO_STATUS_REG
0x4C GPIO_STATUS_W1TC_REG
0x50 GPIO_STATUS1_REG
0x58 GPIO_STATUS1_W1TC_REG
0x74 + 4n GPIO_PINn_REG
0x154 + 4y GPIO_FUNCy_IN_SEL_CFG_REG, kayıtlı
0x554 + 4n GPIO_FUNCn_OUT_SEL_CFG_REG

Durum kayıtlarının W1TS biçimleri de yanıtlanır: GPIO_CPU_INT_REG/GPIO_CPU_INT1_REG (durum olarak okunur), GPIO_BT_SELECT_REG, GPIO_SDIO_SELECT_REG ve GPIO_CLOCK_GATE_REG.

Doğrulandı: taban ve tüm ofsetler, kayıt özeti 6.14 ile karşılaştırıldı.

GPIO_PINn_REG (kayıt 6.18): bit 2 PAD_DRIVER padi açık kolektöre çevirir; 7..9 bitleri INT_TYPE pinin kesmesini neyin yükselteceğini seçer (0 kapalı, 1 yükselen kenar, 2 düşen kenar, 3 her iki kenar, 4 düşük seviye, 5 yüksek seviye); bit 13 CPU kesme etkinleştirmesidir. Doğrulandı.

GPIO_FUNCn_OUT_SEL_CFG_REG (register 6.20): bits 0..8 OUT_SEL, bit 9 OUT_INV_SEL, bit 10 OEN_SEL, bit 11 OEN_INV_SEL. OUT_SEL 256 makes the pad follow GPIO_OUT with GPIO_ENABLE as its output enable. 73 to 80 hand the pad to LEDC channels 0 to 7 (ledc_ls_sig_out0 to 7) and 81 to 84 to RMT channels 0 to 3 (rmt_sig_out0 to 3); those numbers are table 6.11-1's, verified. Both peripherals' output enables are tied high in that table ("1'd1"), so with OEN_SEL clear an LEDC or RMT channel drives its pad whatever GPIO_ENABLE says, and with OEN_SEL set GPIO_ENABLE decides. Any other OUT_SEL selects a peripheral that is not modeled, and the model treats it as 256 rather than invent a level.

GPIO_STRAP_REG şu değeri okur: 0x08: bit 3 (GPIO0) yüksek, 2, 4 ve 5 bitleri (GPIO46, GPIO45, GPIO3) düşük; bu, 3,3 V flash'tan normal bir önyüklemedir. Bit ataması kayıt 6.15'inkidir; değer burada bir sabittir, pinlerin sıfırlamada yaptığı şeyin hatırlanan değeri değildir.

3.2 IO MUX (0x6000_9000)

IO_MUX_PIN_CTRL_REG şu adreste: 0x00, ardından her GPIO için bir kayıt: 0x04 + 4n. Klasik ESP32'nin aksine, S3'ün IO MUX'u GPIO sırasındadır. Bit 7 FUN_WPD, bit 8 FUN_WPU, bit 9 FUN_IE, 10..11 bitleri FUN_DRV (saklanır), 12..14 bitleri MCU_SEL. Bir pad, giriş tamponu etkinleştirilmedikçe GPIO_IN_REG'e ulaşmaz.

Doğrulandı: taban, ofsetler ve bitler, kayıt 6.36 ile; işlev tablosu ve sıfırlama değerleri tablo 6.12-1 ile karşılaştırıldı.

MCU_SEL en fazla beş işlevten birini seçer. Her pinde 1 numaralı işlev GPIO matrisidir. Çoğu pinda 0 numaralı işlev de GPIO matrisidir, ama 26 ile 32 arasındakilerde flash, 39 ile 42 arasındakilerde JTAG pinleri, 43 ve 44'te UART0, 47 ve 48'de flash saat çiftidir; bu yüzden bunlardan birini GPIO olarak kullanmak isteyen bir program MCU_SEL değerini 1 yapmalıdır. Çalışma zamanının pinMode fonksiyonu her zaman bunu yapar. GPIO48'deki RGB LED bunlardan biridir: bir şey MCU_SEL değerini ayarlayana kadar, programın matrise yazdığı hiçbir şey o pade ulaşmaz.

Her pad, kılavuzun sıfırlama değeriyle açılır. Tablo 6.12-1'in "RST" sütunu: GPIO0 ve flash pinleri pull-up'larıyla, GPIO45 ve GPIO46 pull-down'larıyla, çoğu pin yalnızca giriş tamponu açıkken, GPIO 4 ile 8, 15, 16 ve 19 ile 21 arası ise onu bile olmadan gelir; dolayısıyla digitalRead, tampon açılana kadar bunlardan birinde 0 okur. MTCK, yani GPIO39, pull-up'lı gelir; bu da JTAG padleri eFuse ile devre dışı bırakılmamış bir parça için tablonun söylediğidir. GPIO43, yani U0TXD, çıkışı UART üzerinde etkin olarak açılır; UART'ın kendi dalga formu modellenmediğinden (bölüm 3.3) o pad, bir program onu devralana kadar hattın boştaki yüksek seviyesini tutar.

3.3 UART0 (0x6000_0000)

ofset yazmaç
0x00 UART_FIFO_REG
0x04 UART_INT_RAW_REG
0x08 UART_INT_ST_REG
0x0C UART_INT_ENA_REG
0x10 UART_INT_CLR_REG
0x14 UART_CLKDIV_REG
0x1C UART_STATUS_REG
0x20 UART_CONF0_REG
0x24 UART_CONF1_REG
0x78 UART_CLK_CONF_REG

Doğrulandı: taban ve tüm ofsetler (kayıt özeti 26.6) ile aşağıdaki bitler.

İki adet 128 baytlık FIFO. UART_STATUS_REG 0..9 bitleri RXFIFO_CNT, 16..25 bitleri TXFIFO_CNT değeridir. UART_CONF0_REG bit 17 RXFIFO_RST ve bit 18 TXFIFO_RST onları boşaltır (kayıt 26.9; klasik ESP32 modelinde bu ikisi terstir, bölüm 6). UART_CONF1_REG iki FIFO eşiğini tutar, her biri on bit, sıfırlamada 96. UART_CLKDIV_REG 0..11 bitleri bölenin tam kısmı, 20..23 bitleri ise on altılık basamağıdır, sıfırlamada 694.

Bölen, UART çekirdek saatini böler; bu saati UART_CLK_CONF_REG 20..21 bitleri SCLK_SEL seçer: 1, 80 MHz APB saati; 3, 40 MHz kristal; kristal sıfırlama değeridir (kayıt 26.18). 2, yani RC_FAST osilatörü modellenmemiştir ve kristal gibi ele alınır. SCLK_DIV_NUM (12..19 bitleri) çekirdek saatini SCLK_DIV_NUM + 1 ile böler; bu sanılmaktadır: kılavuz alanı "frekans böleninin tam kısmı" diye adlandırır ve böleni bir olmadan basar, ayrıca sıfırlamada alan 1'dir. Çalışma zamanı SCLK_SEL değerini 1, SCLK_DIV_NUM değerini 0 yapar ve böylece 694, 115 274 baud olur. Kesirli SCLK_DIV_A/SCLK_DIV_B modellenmemiştir.

Baytlar aktarım FIFO'sundan baud hızında ayrılır, anında değil; bu yüzden 115 200 baud'luk bir port burada da masada olduğu gibi saniyede 11 520 bayt taşır; crates/esp32s3/tests/runtime.rs, serial örneğinde iki baytın bir bayt süresinden daha yakın olmadığını denetler.

UART1 ve UART2 modellenmemiştir. U0TXD'nin pin dalga formu da modellenmemiştir: baytlar GPIO43'teki bitler değil, ana bilgisayar kanalıdır.

3.4 USB Seri/JTAG (0x6003_8000)

Denetleyicinin seri yarısı: kartın "USB" soketinin taşıdığı CDC-ACM portu; bir kod bunu USBSerial olarak görür.

ofset yazmaç
0x00 USB_SERIAL_JTAG_EP1_REG
0x04 USB_SERIAL_JTAG_EP1_CONF_REG
0x08 USB_SERIAL_JTAG_INT_RAW_REG
0x0C USB_SERIAL_JTAG_INT_ST_REG
0x10 USB_SERIAL_JTAG_INT_ENA_REG
0x14 USB_SERIAL_JTAG_INT_CLR_REG
0x18 USB_SERIAL_JTAG_CONF0_REG, saklanır

Doğrulandı: taban, ofsetler (kayıt özeti 33.5) ve bitler: EP1_CONF bit 0 WR_DONE, bit 1 SERIAL_IN_EP_DATA_FREE, bit 2 SERIAL_OUT_EP_DATA_AVAIL (kayıt 33.2); INT_* bit 2 SERIAL_OUT_RECV_PKT_INT ve bit 3 SERIAL_IN_EMPTY_INT, sıfırlamada kuruludur (kayıt 33.6).

The behavior is section 33.3.3's: bytes written to EP1 wait in a 64-byte buffer and leave only when it is flushed, by WR_DONE or by the hardware when the 64th byte goes in; from the flush until the host has the packet, SERIAL_IN_EP_DATA_FREE is clear and a byte written is lost; when the host has it, SERIAL_IN_EMPTY_INT rises. Host bytes arrive a packet (up to 64) at a time, SERIAL_OUT_EP_DATA_AVAIL stays set while any are unread, and the next packet is accepted once the last byte of this one has been read.

Zamanlama bu modele özgüdür. Kılavuz, ana bilgisayarın "düzenli olarak kontrol edeceğini" söyler. Burada ana bilgisayarın her zaman açık bir terminali vardır ve boşaltılan bir paketi 12 Mbit/s bir yoldan geçebileceği anda alır: paket artı on üç baytlık token, el sıkışma ve çerçeveleme, yani 64 bayt için 51,3 us. Gerçek bir ana bilgisayar bir çerçeveye (1 ms) kadar zamanlama gecikmesi ekler; bu modellenmemiştir.

Modellenmeyenler: JTAG yarısı, numaralandırma, veri yolu hata kesmeleri, RTS/DTR sıfırlama ve indirme modu istekleri ile askıya alma. Ana bilgisayar her zaman bağlıdır.

3.5 SYSTIMER (0x6002_3000)

Birim 0: micros() ve millis() arkasındaki 52 bitlik sayaç.

ofset yazmaç
0x00 SYSTIMER_CONF_REG
0x04 SYSTIMER_UNIT0_OP_REG
0x0C SYSTIMER_UNIT0_LOAD_HI_REG
0x10 SYSTIMER_UNIT0_LOAD_LO_REG
0x40 SYSTIMER_UNIT0_VALUE_HI_REG
0x44 SYSTIMER_UNIT0_VALUE_LO_REG
0x5C SYSTIMER_UNIT0_LOAD_REG

Doğrulandı: taban, ofsetler (kayıt özeti 11.5), bitler (CONF bit 30 TIMER_UNIT0_WORK_EN, sıfırlamada kurulu; OP bit 30 UPDATE, bit 29 VALUE_VALID) ve 16 MHz sayma saati ("XTAL_CLK/2.5, yani 16 MHz", bölüm 11.4).

Okuma kilitle-sonra-oku şeklindedir: UPDATE yaz, VALUE_VALID beklenir, VALUE_HI ve VALUE_LO okunur. Sayaç sayılmaz: simüle edilmiş zamanın 62.5 ns'e bölünmüş hali artı bir yükün oraya koyduğu değerdir, yani sapacağı bir şey yoktur. Birim 1, üç karşılaştırıcı ve alarmları modellenmez; çalışma zamanının tiki çekirdeğin kendi CCOMPARE0'ıdır (bölüm 4).

3.6 SENS: ADC1, tek atış (0x6000_8800)

RTC ADC1 denetleyicisinin yazılımla başlatılan dönüşümü.

ofset yazmaç bitler
0x00 SENS_SAR_READER1_CTRL_REG saklanır
0x0C SENS_SAR_MEAS1_CTRL2_REG bit 0..15 MEAS1_DATA_SAR (salt okunur), bit 16 MEAS1_DONE_SAR, bit 17 MEAS1_START_SAR, bit 18 MEAS1_START_FORCE, bit 19..30 SAR1_EN_PAD (kanal başına bir bit), bit 31 SAR1_EN_PAD_FORCE
0x10 SENS_SAR_MEAS1_MUX_REG bit 31 SAR1_DIG_FORCE: set, ADC1 belongs to the digital controller and a software start converts nothing
0x14 SENS_SAR_ATTEN1_REG two bits of attenuation per channel, channel n at bits 2n..2n+1; all ones at reset

Doğrulandı: temel adres, üç ofset ve 39.10 ile 39.13 arası kayıtlara göre her bit.

Tek dönüşüm: zayıflatmayı ATTEN1'e yaz, START_FORCE ve EN_PAD_FORCE set et, kanalın bitini SAR1_EN_PAD'e koy, MEAS1_START_SAR'ı yükselt, MEAS1_DONE_SAR'ı bekle, veriyi oku. Bir dönüşüm simüle edilmiş zamanda sabit 5 us sürer, bu modelin kendi değeridir.

On kanal vardır ve n numaralı kanal GPIO n + 1'dir: ADC1_CH0 GPIO1'dir ve ADC1_CH9 GPIO10'a kadar (kullanıcı kılavuzunun başlık tabloları, pin pin).

Sonuç, dönüşümün başladığı andaki ağ geriliminin on iki bitidir. Şurada: ATTEN0 hedefine ATTEN2 şudur: round(4095 x Vin / Vtop), kırpılmış, burada Vtop, veri sayfasındaki "etkili ölçüm aralığı"nın üstüdür: 850 mV, 1100 mV ve 1600 mV. ATTEN3 (12 dB), sıfırlamadaki zayıflatma ve Arduino çekirdeğinin varsayılanı, tipik bir parçanın ham eğrisini izler (CURVE_ATTEN3 şurada: crates/esp32s3/src/adc.rs): 0 V'dan yakın doğrusal, yaklaşık 2750 mV'dan (Espressif'in kendi ölçümlerinin S3'ün doğrusallığı yitirdiğini gösterdiği yer) 2900 mV etkili aralığının ötesinde kıvrımlanan ve şu değerde doyuma giren bir eğri: yaklaşık 3.1 V'tan itibaren 4095. Dolayısıyla 3.3 V hattına bağlanmış bir potansiyometre, hareketinin sonuna biraz kala 4095'e ulaşır ve hattın yarısı (1.65 V) yaklaşık 2220 okur. Bir birimin eFuse kalibrasyonu bunu birkaç yüzde oynatır, bu modellenmez. analogReadMilliVolts aynı eğriyi tersine çevirir. Pininde hiçbir şey olmayan bir kanal, yüzen bir girişin yaptığı gibi gezinir (docs/uno.md bölüm 1).

ADC2, dijital denetleyici, DMA, kalibrasyon eFuse'ları ve sıcaklık sensörü yoktur.

3.7 LEDC (0x6001_9000)

Sekiz kanal ve dört zamanlayıcı, tek bir hız sınıfında: S3'ün tüm LEDC'si.

ofset yazmaç bitler
0x00 + 0x14n LEDC_CHn_CONF0_REG bit 0..1 TIMER_SEL, bit 2 SIG_OUT_EN, bit 3 IDLE_LV, bit 4 PARA_UP (salt yazma)
0x04 + 0x14n LEDC_CHn_HPOINT_REG bit 0..13 HPOINT
0x08 + 0x14n LEDC_CHn_DUTY_REG bit 0..18, bir sayımın on altıda biri cinsinden görev çevrimi
0x0C + 0x14n LEDC_CHn_CONF1_REG solma donanımı: saklanır, hiçbir şey soldurmaz
0x10 + 0x14n LEDC_CHn_DUTY_R_REG yürürlükteki görev çevrimi, salt okunur
0xA0 + 8n LEDC_TIMERn_CONF_REG bit 0..3 DUTY_RES, bit 4..21 CLK_DIV (Q10.8), bit 22 PAUSE, bit 23 RST (sıfırlamada set), bit 25 PARA_UP (salt yazma)
0xA4 + 8n LEDC_TIMERn_VALUE_REG sayaç
0xC0 LEDC_INT_RAW_REG bit n = zamanlayıcı n taştı
0xC4 LEDC_INT_ST_REG
0xC8 LEDC_INT_ENA_REG saklanır; çekirdeğe ulaşan bir hat yoktur
0xCC LEDC_INT_CLR_REG
0xD0 LEDC_CONF_REG bit 0..1 APB_CLK_SEL (1, yani APB saati, modellenen tek kaynaktır), bit 31 CLK_EN
0xFC LEDC_DATE_REG 0x1907_2601 okur

Doğrulandı: temel adres, her ofset ve tablodaki her bit (kayıt özeti 35.4 ve 35.1 ile 35.13 arası kayıtlar). Bu, LEDC yerleşiminin varsayıldığı klasik ESP32 modeline göre gerçek bir değişikliktir.

Bir zamanlayıcı, 80 MHz'in CLK_DIV'e bölünmüş haliyle 2^DUTY_RES sayım sayar: f = 80e6 / ((CLK_DIV / 256) * 2^DUTY_RES). Bir kanalın çıkışı, HPOINT'tan itibaren DUTY >> 4 sayım boyunca yüksektir.

Hiçbir şey güncelleme biti olmadan yürürlüğe girmez. Bir zamanlayıcının CLK_DIV ve DUTY_RES değerleri TIMERn_PARA_UP bekler; bir kanalın HPOINT, SIG_OUT_EN, TIMER_SEL ve görev çevrimi PARA_UP_CHn bekler (35.1 ve 35.7 kayıtlarının altındaki listeler). Model, yazılanı yürürlüktekinden ayrı tutar; böylece bir güncelleme bitini unutan firmware, masada olduğu gibi PWM alamaz. PAUSE, RST ve IDLE_LV anında etkili olur. Görev çevrimi DUTY_START altında listelenir; model onu DUTY_START set edilmiş olsun ya da olmasın PARA_UP_CHn'de yükler; solma donanımı boştayken sıradan bir görev çevrimi değişikliğinin yaptığı şeyin bu olduğu varsayılır.

Bir kanal pada GPIO matrisi üzerinden OUT_SEL 73 + n ile ulaşır (bölüm 3.1). Sayaç, simüle edilmiş zamanın kapalı biçimli bir fonksiyonudur; dolayısıyla PWM çalışırken waiti'de bekleyen bir çekirdek hiçbir şeye mal olmaz; runtime.rs, fade örneğinin periyodunu 1 kHz'in 1 ms'sine karşı 5 us içinde ölçer.

LEDC'nin saati sıfırlamada kapalıdır (bölüm 3.9): SYSTEM_LEDC_CLK_EN set edilene kadar blok yanıt vermez.

Modellenmeyenler: görev çevrimi solma donanımı, taşma sayacı, APB dışındaki saat kaynakları ve LEDC'nin kesme matrisine giren hattı.

3.8 RMT (0x6001_6000)

Uzaktan kumanda çevre biriminin dört aktarım kanalı: RGB LED'i süren şey.

ofset yazmaç bitler
0x00 + 4n RMT_CHnDATA_REG yazma: bir sözcüğü APB FIFO üzerinden n numaralı kanalın RAM'ine it
0x20 + 4n RMT_CHnCONF0_REG bit 0 TX_START, bit 1 MEM_RD_RST, bit 2 APB_MEM_RST, bit 3 TX_CONTI_MODE, bit 4 MEM_TX_WRAP_EN, bit 5 IDLE_OUT_LV, bit 6 IDLE_OUT_EN, bit 7 TX_STOP, bit 8..15 DIV_CNT, bit 16..19 MEM_SIZE, bit 20 CARRIER_EFF_EN, bit 21 CARRIER_EN, bit 22 CARRIER_OUT_LV, bit 24 CONF_UPDATE
0x50 + 4n RMT_CHnSTATUS_REG bit 0..9 okuma adresi, bit 11..20 APB yazma adresi, bit 22..24 durum, bit 25 MEM_EMPTY, bit 26 APB_MEM_WR_ERR
0x70 RMT_INT_RAW_REG bit n TX_END, bit 4+n ERR, bit 8+n TX_THR_EVENT, bit 12+n TX_LOOP
0x74 RMT_INT_ST_REG
0x78 RMT_INT_ENA_REG
0x7C RMT_INT_CLR_REG
0x80 + 4n RMT_CHnCARRIER_DUTY_REG bit 0..15 düşük, bit 16..31 yüksek, sıfırlamada her biri 0x40
0xA0 + 4n RMT_CHn_TX_LIM_REG bit 0..8 TX_LIM, bit 9..18 TX_LOOP_NUM, bit 19 TX_LOOP_CNT_EN, bit 20 LOOP_COUNT_RESET, bit 21 LOOP_STOP_EN
0xC0 RMT_SYS_CONF_REG bit 0 APB_FIFO_MASK, bit 4..11 SCLK_DIV_NUM, bit 24..25 SCLK_SEL, bit 26 SCLK_ACTIVE, bit 31 CLK_EN
0xCC RMT_DATE_REG 0x0210_1181 okur
0x800 ile 0xDFF arası RAM 384 kelime

Alım kanallarının yazmaçları (0x30 ile 0x4C, 0x60 ile 0x6C, 0x90 ile 0x9C, 0xB0 ile 0xBC) saklanır ve geri okunur, hiçbir şey almaz.

Doğrulandı: tablodaki taban, her ofset ve bit (yazmaç özeti 37.5, yazmaçlar 37.1 ile 37.19), RAM'in boyutu ve NONFIFO başlangıcının "RMT taban adresi + 0x800" olması, sinyal kodu biçimi (bits 0..14 ve 16..30 arasındaki periyot, bits 15 ve 31'deki seviye, "periyot için en küçük değer sıfırdır ve bir iletim bitişi işaretleyicisi olarak yorumlanır"), kanal saati (rmt_sclk'in DIV_CNT'ye bölünmüşü, "0 değeri 256 bölenini temsil eder" ve rmt_sclk kaynağının SCLK_DIV_NUM + 1 + A/B'ye bölünmüşü), sıfırlama değerleri (taşıyıcı açık, MEM_SIZE 1, DIV_CNT 2) ve CONF_UPDATE'i bekleyen alanların listesi (tablo 37.3-1).

Believed: the manual gives transmit channel n's NONFIFO start as "RMT base address + 0x800 + n x 48", and the model reads the 48 as words, so channel n's block starts at 0x800 + 192n: the only reading under which the eight 48-word blocks of section 37.3.2 fit the 384 words. The manual's receive-channel start, "0x8c0 + m x 48", does not settle it either way, and the receive channels are not modeled.

Bir iletimin ne yaptığı, bölüm 37.3.4'ten: TX_START, kanalın bloğunun başından gönderir, her kod seviyesini period kanal saati vuruşu boyunca tutar; bir bitiş işaretleyicisinde kanal durur, TX_END'i yükseltir ve bitiş işaretleyicisinin seviyesini ya da IDLE_OUT_EN açık ise IDLE_OUT_LV değerini tutar; kendi MEM_SIZE bloklarının sonuna bir bitiş işaretleyicisi olmadan taşarsa MEM_EMPTY ve ERR ile durur, sarmalama modu onu yeniden baştan göndermediği sürece; sarmalama modunda her seferinde TX_LIM kelime daha gittiğinde TX_THR_EVENT yükselir; sürekli mod her bitiş işaretleyicisinde yeniden başlar ve istendiğinde döngüleri sayar. TX_STOP hemen durdurur.

Yapılandırma güncellemesi. DIV_CNT, IDLE_OUT_EN, IDLE_OUT_LV, TX_CONTI_MODE, TX_STOP, taşıyıcı alanları ve TX_LIM'in üç alanı yalnızca CONF_UPDATE üzerinde etkili olur (tablo 37.3-1); model onları o ana dek ayrı tutar. MEM_SIZE, sarmalama modu ve TX_START hemen etki eder.

The carrier is on at reset. A code whose level matches CARRIER_OUT_LV becomes a square wave high for CARRIER_HIGH + 1 and low for CARRIER_LOW + 1 cycles of rmt_sclk. The model starts that wave high at the start of each code, which is believed, and does not modulate the idle level when CARRIER_EFF_EN is clear. A WS2812 needs the carrier off, and the runtime clears CARRIER_EN; the model counts transmissions made with it on, and the runtime tests check the count is zero.

Çıktı, kod sınırları arasında zamanın kapalı biçimli bir fonksiyonudur, dolayısıyla her kenar tam pikosaniyesine denk gelir ve bir çerçeve çıkarken park edilmiş bir çekirdek hiçbir şeye mal olmaz. runtime.rs, GPIO48 üzerindeki blink ve rainbow örneklerinin çerçevelerini çözer ve her yüksek ve düşük süreyi WS2812B veri sayfasındaki pencerelere göre denetler.

RMT'nin saati sıfırlamada kapalıdır (bölüm 3.9).

Modellenmedi: alım kanalları, kanal 3'teki DMA, eşzamanlı başlatma, RAM sahipliği ve gücü ile en küçük periyot kuralları (formüller 37.1 ve 37.3).

3.9 SYSTEM (0x600C_0000) ve kesme matrisi (0x600C_2000)

ofset yazmaç
0x10 SYSTEM_CPU_PER_CONF_REG, kayıtlı
0x18 SYSTEM_PERIP_CLK_EN0_REG
0x1C SYSTEM_PERIP_CLK_EN1_REG, kayıtlı
0x20 SYSTEM_PERIP_RST_EN0_REG
0x24 SYSTEM_PERIP_RST_EN1_REG, kayıtlı

Verified: the offsets and reset values (registers 17.3 to 17.7). LEDC (bit 11) and RMT (bit 9) are gated off at reset in SYSTEM_PERIP_CLK_EN0_REG. Here, a write to either block while its clock bit is clear, or while its bit in SYSTEM_PERIP_RST_EN0_REG holds it in reset, is dropped and counted, and a read returns 0; holding one in reset puts it back to power-on. The runtime sets both clock bits before anything else. The other blocks here are clocked at reset and are not gated in the model.

Kesme matrisi: çekirdek 0 için n kaynağının eşleme kaydı 0x600C_2000 + 4n adresindedir ve düşük beş biti, kaynağın tetiklediği CPU kesmesinin numarasını verir. Bu modelin yönlendirdiği dört kaynak numarası gibi, bu da tablo 9.3-1 ve kayıt özeti 9.4'e göre doğrulanmıştır:

kaynak numara
GPIO_INTERRUPT_CPU 16
UART_INTR 27
RMT_INTR 40
USB_DEVICE_INT 96

Çekirdeğin iç kesmelerinden birine (6, 7, 11, 15, 16 veya 29) eşlenen bir kaynak hiçbir yere ulaşmaz; kılavuzda bir kaynağı devre dışı bırakmanın yolu da budur (bölüm 9.3.3.3). Diğer tüm eşleme kayıtları kaydedilir, geri okunur ve hiçbir yere yönlendirilmez.

3.10 Mokxi ağ posta kutusu (0x6FFF_E000)

Bu blok ESP32-S3'ün değil. Bu belgedeki diğer tüm adresler çipe aittir. Bu ise Mokxi'nin kendi bloğudur: simüle edilmiş crates/net ağı, S3'ün eşleştirmediği bir adreste. Kılavuz çevre birimlerini "0x6000_0000~0x600D_0FFF" aralığına koyar ve RTC FAST belleği 0x600F_FFFF'te biter; yani bu bloğu kullanan bir görüntü, silisyumda hata verir ve başka bir çevre biriminin yazmacını okumaz. Bu hata dürüst cevaptır, çünkü bu bloğun ardındaki şey çipte yoktur. ESP32-C3 ve C6 modellerinin de aynı adresi kullanmasının nedeni, üç çipin de aynı boşluğu bırakmasıdır.

Bu blok hiçbir kesinti üretmez. Buradaki diğer tüm kaynaklar 3.9 bölümündeki kesme matrisi üzerinden çekirdeğe ulaşır ve matris kaynak numaraları çipe aittir; çipte bulunmayan bir çevre birimine dürüst bir numara verilemez, bu yüzden posta kutusuna hiçbir numara verilmez. NET_INT_RAW_REG yine de okunur, firmware yoklar ve waiti ile bekleyen bir çekirdek, ağın söyleyecek bir şeyi olduğunda, bir PWM kenarında uyandırıldığı gibi yine uyandırılır.

Burada radyo, 802.11 ve gerçek internet yoktur. Modeldeki hiçbir şey iletmez, taramaz, ilişkilendirmez, şifrelemez veya soket açmaz: parola bir dizgi olarak karşılaştırılır, .mokxi altında olmayan bir ad çözümlenmez ve ağın hizmet verdiği kaynaklar crates/net/src/http.rs içindeki fonksiyonlardır. Posta kutusu, bir MAC hakkında uydurma değil, gerçek dikişin biçimidir: gerçek bir ESP32-S3'te WiFi donanımı kapalı bir ikili blobun ardında, komut arayüzüyle durur ve Arduino'nun WiFi.h kütüphanesi bunlardan birinin öbür ucunda yer alır. docs/wifi.md arkasında ne olduğuna dair sözleşmedir; bu bölüm yalnızca yazmaçlardır.

Bir komut yazmacı, bir durum yazmacı, her yönde 4096 baytlık bir halka ve bir kesme biti. NET_CMD_REG'e yazmak komutu çalıştırır; simüle edilmiş zaman alan bir komut BUSY'yi yükseltir ve bittiğinde onu temizler; NET_INT_RAW_REG içinde DONE belirir.

ofset ad bitler
0x00 NET_ID_REG 0x494B4F4D okur, başka hiçbir şey okumaz. Mokxi'de olup olmadığını öğrenmek isteyen bir kod bunu okur; silisyumda bu erişim hata üretir
0x04 NET_CMD_REG bir komut kodu yaz (aşağıdaki tablo); yazma işlemi onu çalıştırır
0x08 NET_ARG_REG tek bir argüman kelimesi, geri okunur: LISTEN için port, REPLY için durum
0x0C NET_STATUS_REG bit 0 BUSY, bit 1 ERR, bit 2 RX_READY, bit 3 LINK, bit 4 SERVE, 8..11 bitleri STATE
0x10 NET_RESULT_REG son komutun verdiği yanıt
0x14 NET_INT_RAW_REG bit 0 DONE, bit 1 EVENT
0x18 NET_INT_ENA_REG aynı iki bit
0x1C NET_INT_CLR_REG temizlemek için 1 yaz, aynı iki bit
0x20 NET_TX_LEN_REG giden halkada hazırlanan baytlar
0x24 NET_TX_DATA_REG yaz: giden halkaya tek bir bayt (bit 0..7) ekle
0x28 NET_RX_LEN_REG gelen halka tamponda bekleyen baytlar
0x2C NET_RX_DATA_REG oku: gelen halka tampondan tek bir bayt al, boşken 0
0x30 NET_RING_LEN_REG halkaların her birinin bayt cinsinden kapasitesi, böylece firmware 4096'ı sabit kodlamak zorunda kalmaz
0x40 NET_BT_CMD_REG Bluetooth: bir Bluetooth komut kodu yaz (docs/bluetooth.md); yazma işlemi onu çalıştırır
0x44 NET_BT_ARG_REG Bluetooth: tek bir argüman kelimesi, geri okunur; bir olay numarasını buraya bırakır
0x48 NET_BT_RESULT_REG Bluetooth: son Bluetooth komutunun verdiği yanıt
0x4C NET_BT_STATUS_REG bit 0 CLASSIC_ON, bit 1 CLASSIC_LINK, bit 2 EVENT, bit 3 BLE_ADV, bit 4 BLE_LINK, bit 5 BT_ERR, bit 8 HAS_CLASSIC, bit 9 HAS_BLE
0x50 NET_BT_TX_LEN_REG Bluetooth: baytlar kendi giden halka tamponunda hazırlanıyor
0x54 NET_BT_TX_DATA_REG Bluetooth: yaz: o halka tampona tek bir bayt gönder
0x58 NET_BT_RX_LEN_REG Bluetooth: kendi gelen halka tamponunda bekleyen baytlar
0x5C NET_BT_RX_DATA_REG Bluetooth: okuma: bir bayt çek, boş olduğunda 0

Sekiz NET_BT_ kaydı bloğun Bluetooth yarısıdır ve kendi halkalarına sahiptir: gerçek çipte olduğu gibi yalnızca Bluetooth LE, dolayısıyla Classic komutları BT_ERR bayrağını ayarlar. Arkalarında da radyo yoktur; docs/bluetooth.md onların sözleşmesidir.

STATE, istasyonun nerede olduğunu belirtir: 0 boşta, 1 başlıyor, 2 bağlanıyor, 3 bağlı, 4 başarısız, 5 böyle bir ağ yok. NET_CMD_STATUS, aynı şeyi bir kodun WiFi.status() çağrısından okuduğu Arduino wl_status_t koduna dönüştürür.

NET_CMD_REG ad ne yaptığı
0 NOP hiçbir şey
1 RESET bağlantıyı kes, iki halkayı da bırak, herhangi bir isteği bırak
2 CONNECT giden halka ssid\0password bilgisini tutar; bir ila üç saniye boyunca BUSY yükseltir
3 DISCONNECT ilişkilendirmeyi ve adresi bırak
4 STATUS NET_RESULT_REG = wl_status_t kodu
5 IP NET_RESULT_REG = kiralanan adres, ilk sekizli düşük baytta
6 RSSI NET_RESULT_REG = dBm cinsinden sinyal, işaret genişletilmiş
7 SSID gelen halka erişim noktasının adını alır
8 MAC gelen halka kartın altı MAC baytını alır
9 REQUEST giden halka method\0url\0headers\0body tutar; BUSY hatası verir
10 POLL NET_RESULT_REG = 0 istek sürerken, ardından HTTP durumu ya da ERR yukarıdayken negatif bir hata; gövde gelen halkaya düşer
11 LISTEN NET_ARG_REG içindeki portta dinle
12 ACCEPT NET_RESULT_REG = 1 ve gelen halka tamponu method\0path\0query\0body içerir, bekleyen bir şey yokken 0
13 REPLY kabul edilen isteğe NET_ARG_REG içindeki durumla yanıt ver; giden halka content-type\0body tutar
14 STOP dinlemeyi durdur
15 WL_GPIO_SET kablosuz parçanın kendi GPIO'larını NET_ARG_REG kaydından sür. Bu kart değil: bu parçanın radyosunda böyle bir pin yok, bu yüzden ERR'yi ayarlar ve hiçbir şeyi sürmez. Bir Pico W'nin kart üzerindeki LED'inin izlediği yol budur (docs/picow.md bölüm 3.8)
16 WL_GPIO_GET onları geri oku, ve burada da aynı ERR
17 BLYNK simüle edilmiş Blynk sunucusunda tek bir işlem, NET_ARG_REG'deki işlem ve giden halkadaki alanları; hemen NET_RESULT_REG'de yanıtlanır, ağdan kopukken ERR yükselir (docs/wifi.md, "Blynk")
19 ETH kablolu Ethernet (firmware/include/ETH.h), NET_ARG_REG'deki işlem: 1 bağlantıyı simüle edilmiş bir kablo üzerinden açar, SSID ve parola olmadan, 1,5 s sonra aynı kiralama ile katılır; 2, bağlantı (ya da son hali) kabluloyu olduğunda NET_RESULT_REG'ye 1 koyar. Tek bir bağlantı vardır: STATUS, IP ve her istek, hangi yoldan açılmışsa açılsın onu okur
20 SOFTAP soft AP (crates/net/src/softap.rs, docs/wifi.md), NET_ARG_REG'deki işlem: 1 onu açar (giden halkaya ssid\0password\0 ve kanal baytı; NET_RESULT_REG 1, ya da boş bir isim veya bir ile yedi karakterlik bir parola için ERR ile 0), 2 onu kapatır, 3 onu yapılandırır (adres, ağ geçidi ve ağ maskesi, her biri dört bayt), 4 adresi (kapalıyken 0), 5 katılan istasyonlar, 6 çalışma zamanının olaylara dönüştürdüğü katılmalar, ayrılmalar ve açık biti, 7 ve 8 bir captive portal'ın DNS sunucusunu başlatma (isim, bir sıfır baytı, adres) ve durdurma, 9 ismini gelen halkaya, 10 telefonun adresini, 11 hizmet verilen isteğin Host'unu gelen halkaya yazar. Tek istasyon Web panelinin telefonudur

Negatif POLL kodları: -1 isim çözümlenemez, -2 istasyon ilişkilendirilmemiş, -3 https:// ve TLS simüle edilmez, -4 halkadan uzun bir gövde, -5 bu ağın ayrıştıramadığı bir URL, -6 zaten devam eden bir istek var. firmware/include/HTTPClient.h bunları bir kodun karşılaştırdığı Arduino biçimli kodlara dönüştürür ve docs/wifi.md eşlemeyi listeler.

Zamanlama, tamamı bu modelin kendine ait ve tamamı docs/wifi.md'de belirtilmiş: bir ilişkilendirme bir ile üç saniye arasında sürer, SSID'den kararlaştırılır ki bir ders iki kez aynı süreyi alsın; yanlış bir parola beş saniye sonra WL_CONNECT_FAILED olur; simüle edilmiş bir kaynağa giden bir istek 60 ms sonra geri döner; kodun kendi sunucusuna gelen ve kodun hiç yanıtlamadığı bir istek, on saniye sonra ağ tarafından 504 ile kapatılır.

3.11 Zamanlayıcı gruplarının bekçi köpekleri, RTC_CNTL sıfırlamaları ve yığın izleyicisi

C3'teki gibidir (docs/esp32c3.md bölüm 3.9), S3'ün düzeniyle: WDT_CONF_UPDATE_EN yoktur (bir yazma hemen etkili olur), bekçi köpeğinin kesme biti 2. bittir, çekirdeğe kesme matrisi üzerinden ulaşır (kaynaklar 52 ve 55; çalışma zamanı 52'yi CPU kesmesi 17'ye eşler), saklama yazmaçları 0x50..0x5C ve 0xC0..0xCC adreslerindedir ve ASSIST_DEBUG'in SP_MIN yazmacı bir sonraki yazmaçtır (0x3C). Yığın izleyicisi ENTRY değerini denetler; pencereli kod her çağrıda yığını bir kez taşır, o zamandan beri genişleyen sınırlara karşı oluşan bir hata bildirilmek yerine yeniden denenir.

Çalışma zamanı, ESP-IDF'in görev watchdog'unu ESP-IDF'in yaptığı gibi zamanlayıcı grubu 0'ın watchdog'u üzerinde çalıştırır (firmware/src/main.cpp): 500 µs tikler, aşamada 0 zaman aşımında bir kesme ve aşamada 1 iki katında sistem sıfırlaması; setup()'dan önce 5 s zaman aşımıyla ve bir panic ile başlatılır, çekirdek 0'ın boşta görevini izler. Kod çekirdek 1'de çalışır, onun boşta görevi istemedikçe izlenmez (enableCore1WDT()), bu yüzden hiç yield etmeyen bir döngü kartta olduğu gibi çalışmaya devam eder. Kesme, ESP-IDF'in satırlarını yazdırır ("E (…) task_wdt: Task watchdog got triggered. …", görevler, "Aborting.", iptal satırı ve "Rebooting..."), ESP-IDF'in ESP_RST_TASK_WDT ipucunu RTC saklama yazmacında bırakır ve CPU'yu yazılım sıfırlamasıyla sıfırlar, böylece esp_reset_reason() sonrasında 6 der. esp_task_wdt_*, enableLoopWDT() ve enable/disableCore0WDT() ona etki eder. Zamanlayıcı grubu 1'in watchdog'u aynı şekilde modellenmiştir ve çalışma zamanında onu kuran bir şey yoktur: kesme watchdog'u simüle edilmez.

4. Çekirdek: LX7, hangi ABI ve bir kesme nasıl ulaşır

The S3's two cores are Xtensa LX7s, and this model runs one of them on crates/xtensa-core, the interpreter the classic ESP32 and the ESP8266 already use, in a third configuration, Model::LX7.

Derleyicinin ürettiği her şey için buradaki LX7, LX6'dır. İki araç zincirinin yapılandırma başlıkları (xtensa-esp32-elf içindeki core-isa.h ve xtensa-esp32s3-elf) bir derleyicinin hangi kodu üreteceğini belirleyen tüm tamsayı seçeneklerinde aynı fikirde: altmış dört adres yazmacı ve yazmaç penceresi, sıfır ek maliyetli döngü, 32 bit çarpma ve onun yüksek yarısı, bölücü, MIN/MAX, SEXT, CLAMPS, S32C1I, MAC16, boole işlemleri ve tek duyarlıklı FPU. Kanıtlar başlıklardan daha güçlü: crates/xtensa-core/tests/programs.rs içinde klasik ESP32'nin derleyicisinin derlediği test programının S3 derleyicisiyle derleniş var ve ikisi bayt bayt aynı çıktı. Yani S3, tıpkı klasik ESP32 gibi windowed ABI'sini çalıştırır: ENTRY, RETW, ROTW, MOVSP, L32E/S32E ve pencere istisnaları kendi vektörleri üzerinden (docs/esp32.md bölüm 4'te vektör tablosu var; o da çipin değil ISA'nın tablosudur).

LX7'nin bu çipe eklediği şey, S3'ün vektör uzantısıdır: yapay zeka ve DSP işleri için EE.* komutları; bunları çevirici, LX6'nın MAC16'ya verdiği op0 = 4 alanında kodlar. İkisi de modellenmez ve ikisi de geçersiz komut olarak hata verir (crates/xtensa-core/tests/encoding.rs içinde S3 çeviricisinin iki kodlaması var). GCC bunları sıradan C kodundan üretmez.

Kesmeler. INTENABLE maskeler; PS.INTLEVEL kapıyı kontrol eder. Yalnızca seviye 1 modellenir. S3'te seviye 1 kesmeler 0'dan 10'a, 12, 13, 17 ve 18'dir; maske 0x0006_37FF; 19'dan 21'e kadar olanlar ise seviye 2'dir: kılavuzun tablo 9.3-2'sine göre doğrulandı. Üç CCOMPARE karşılaştırıcısı aynı tablodan CPU kesmesi 6, 15 ve 16'yı yükseltir. Çalışma zamanı GPIO'yu, seviye 1 bir çevre birimi kesmesi olan CPU kesmesi 13'e yönlendirir ve gecikme tikini CPU kesmesi 6'daki CCOMPARE0'dan alır.

PRID, klasik modelde olduğu gibi 0xCDCD okur: inanılıyor. Asıl önemli olan 13. bitin sıfır olmasıdır; yazılım çekirdek 0'ı çekirdek 1'den böyle ayırır.

Geri kalan, klasik ESP32'nin 4. bölümünün değişmeden aynısıdır: CCOUNT çevrim sayısıdır; bir CCOMPARE'a WSR onu kurar ve kesmesini temizler; "eşit" değil "ulaştı veya geçti"; süresi geçmiş bir son tarih kurulmaz; MOVSP asla Alloca yükseltmez; ve tek duyarlıklı FPU, klasik ESP32'deki gibi çalışır (docs/esp32.md bölüm 4), bu yüzden firmware/esp32s3/build.sh ile derlenen bir float doğru yanıtı alır. Tarayıcıda derlenen bir kod hâlâ yazılım kayan noktalıdır (-Xclang -target-feature -Xclang -fp, mokxi_float.c içine çağrılar).

5. Zaman modeli, prob, poke ve ana bilgisayar kanalı

CPU 240 MHz'de, çevrim başına bir komut çalışır. Zaman çevrim sayısından yeniden hesaplanır, yani 2400 komutluk bir dilim tam 10 us'dir. Bir dilimin içinde komut sayısı saatin kendisidir: bir zamanlayıcı okuması, bir seri bayt, bir pin değişimi ve bir RMT kenarı, hepsi kendilerine neden olan komutun anına düşer. WAITI ile park edilmiş bir çekirdeğin maliyeti yoktur: kart, bir sonraki CCOMPARE son tarihinin, bir sonraki LEDC veya RMT kenarının, bir seri baytın ve ağın en erken olanında uyanmayı ister; bir pin değişimi ya da bir ana makine baytı da uyandırır. Aynı dilimde bir yazma bir padi taşımışsa, ondan sonra yapılan bir GPIO_IN_REG okuması dilimi okumadan önce bitirir, böylece okuma devrenin yazmadan ürettiğini görür; tıpkı klasik ESP32'de olduğu gibi (docs/esp32.md bölüm 5). 50 us altındaki delayMicroseconds() CCOUNT'u sayar ve istenenden asla kısa sürmez.

probe içinde LED'in rengini taşıyan bir bit maskesidir:

bitler anlam
0 çalışıyor
1 waiti içinde park edilmiş ya da hata ayıklayıcı tarafından durdurulmuş
2..19 RGB LED'in son bir kareyi yakalayışındaki rengi, kanal başına altı bit: kırmızı 14..19'da, yeşil 8..13'te, mavi 2..7'de

LED'i kart parçası çözer; SoC'nin LED'in pad'inde (GPIO48, v1.1'de GPIO38) bildirdiği kenarlardan, ws2812 parçasının pencereleriyle: 125 ns altı yüksek darbe bir hatadır, 600 ns'ye kadar 0'dır, 950 ns'ye kadar 1'dir, daha uzunu kareyi bozar, bitten izin verilenden kısa düşük seviye de bozar ve 50 us'lik düşük seviye ilk 24 biti yakalar, önce yeşil. LED, çipin sıfırlanmasından sonra rengini korur, bir WS2812 gibi, çünkü karttan beslenir. Rengin kanal başına düşük iki biti bir proba sığmaz ve atılır.

poke: 1, BOOT'u tutar (GPIO0 düşük), 0 bırakır; 2 tutar RST, 3 bırakır.

Ana makine kanalı kartın iki seri portunu birden taşır. Gerçek bir DevKitC-1'de iki soket vardır: USB-UART köprüsü üzerinden UART0'a giden "UART" ve çipin kendi USB Serial/JTAG denetleyicisi olan "USB". Burada seri monitör ikisine birden bağlıdır: host_read, UART0'dan çıkmış baytları ve USB portunun teslim ettiği baytları, geldikleri sırayla verir; host_write da yazılanları hem UART0'ın alım FIFO'suna hem de USB portunun ana makine kuyruğuna koyar. Köprünün kendisi modellenmez, DTR ve RTS üzerinden otomatik sıfırlama da edilmez.

Çökme. İlerleme olmadan art arda 1000 tuzak ve çekirdek çöktü ilan edilip durdurulur; öldüğü yer kaydedilir ve ana makine kanalından bildirilir.

6. Bu modelin emin olduğu ve olmadığı şeyler

Kılavuzla, veri sayfasıyla veya kullanıcı rehberiyle karşılaştırılarak denetlendi

Bellek pencereleri (tablo 4.3-1) ve her çevre birimi tabanı (tablo 4.3-3). Bölüm 3'te adı geçen her yazmaç ofseti ve her bit, blok blok: GPIO (6.14'ten 6.20'ye), IO MUX (6.36 ve tablo 6.12-1, her pad'in sıfırlama değeri ve her pinde 1. işlevin GPIO olması dahil), UART0 (26.6'dan 26.19'a), USB Serial/JTAG (33.2'den 33.9'a ve 33.3.3'teki davranış), SYSTIMER (11.1'den 11.5'e ve 16 MHz saat), SENS (39.10'dan 39.13'e), LEDC (35.1'den 35.13'e ve PARA_UP listeleri), RMT (37.1'den 37.19'a, RAM boyutu, darbe kodu biçimi, saat formülü ve tablo 37.3-1), SYSTEM (17.3'ten 17.7'ye, LEDC ve RMT'nin sıfırlamada kapalı olması dahil) ve kesme matrisi (tablo 9.3-1 ve özet 9.4). GPIO matrisi sinyal numaraları: LEDC için 73'ten 80'e, RMT için 81'den 84'e (tablo 6.11-1) ve iki çevre biriminin de çıkış etkinleştirmelerinin yukarıya bağlı olması. CPU kesme seviyeleri ve karşılaştırıcıların kesme numaraları (tablo 9.3-2). ADC1 kanal haritası ve dört zayıflatmanın etkin aralıkları (veri sayfası). Başlık sırası, her revizyondaki RGB LED'in GPIO'su ve kartın boyutları (kullanıcı rehberi ve boyut çizimi). Tamsayı ISA seçenekleri (araç zincirlerinin core-isa.h'sı ve S3 derleyicisinin bayt bayt çıktısı).

İnanılan, doğrulanmayan

  • SCLK_DIV_NUM + 1 UART0'ın çekirdek saat bölücüsü olarak (bölüm 3.3). Çalışma zamanı oraya 0 yazar; bu okunuşla bu 1'dir; kılavuzun basılı formülünde artı bir yoktur.
  • Kanal başına RMT RAM düzeni: 0x800 + 192n (bölüm 3.8).
  • Taşıyıcının fazı: önce yüksek, her kodun başından itibaren (bölüm 3.8).
  • PARA_UP_CHn üzerinde görev döngüsü yüklemesi olmadan DUTY_START (bölüm 3.7).
  • USB paket zamanlaması: 12 Mbit/s artı on üç bayt ve ana makine zamanlama gecikmesi yok (bölüm 3.4).
  • PRID = 0xCDCD (bölüm 4).

Çalışma zamanının bağlı olduğu her sayı tek bir yerde adlandırılmıştır (firmware/esp32s3/include/esp32s3.h) ve crates/esp32s3/tests/contract.rs o başlık dosyasını ve crates/esp32s3/src/map.rs dosyasını aynı sayılara bağlı tutar.

Modellendi, ama çipin gerçek sayılarına göre değil

  • ATTEN3'teki ADC, tipik bir parçanın eğrisidir, bu birimin değil (bölüm 3.6): yaklaşık 3.1 V'taki doyma ve 2.75 V'un üstündeki bükülme mevcuttur, ama eFuse kalibrasyonunun düzelttiği birimler arası sapma yoktur. Diğer zayıflatma seviyeleri, etkin aralıklarının üst sınırına kadar düz çizgilerdir.
  • Bir dönüşüm tam olarak 5 us sürer ve bir LEDC veya RMT kenarı tam pikosaniyede gerçekleşir.
  • GPIO_STRAP_REG sabittir, sıfırlamada pinlerin tutulması değildir.
  • RST tek başına 10 k'luk bir pull-up'dır; açılıştaki güç kondansatörü modellenmemiştir.
  • Boot ROM yok ve saat ağacı yok. Çekirdek ilk komuttan itibaren 240 MHz'de ve APB saati 80 MHz'dedir, SYSTEM_CPU_PER_CONF_REG saklanır ama hiçbir şeyi değiştirmez.
  • USB pad'leri devralınmaz. GPIO19 ve GPIO20 sıradan pinler olarak kalır ve bir kod onları sürse bile USB portu çalışmaya devam eder.
  • UART sahibiyken U0TXD sabit yüksek seviyede tutulur; UART'ın bitleri ana kanaldır, GPIO43'te bir dalga formu değildir.
  • CCOMPARE "ulaşıldı ya da aşıldı" durumunu karşılaştırır, ve MOVSP hiçbir zaman Alloca yükseltmez (bölüm 4).

Bilerek hariç tutulanlar

  • İkinci çekirdek. Yalnızca çekirdek 0 çalışır; çekirdekler arası kesme yoktur ve FreeRTOS yoktur, bu yüzden çekirdek 1'de görev başlatan hiçbir şey çalışmaz.
  • Vektör uzantısı. Her EE.* kodlaması hata üretir (bölüm 4). FPU modellenmiştir.
  • SRAM0, önbellek, MMU, flash ve PSRAM. Kod SRAM1'den çalışır.
  • WiFi ve Bluetooth radyoları, her biçimiyle. Bir kodun eriştiği WiFi, bölüm 3.10'daki simüle edilmiş ağdır.
  • RTC, bellekleri, ULP yardımcı işlemcileri, derin uyku ve güç yönetimi birimi.
  • ADC2, dijital ADC denetleyicisi, DMA, kalibrasyon eFuse'ları, sıcaklık sensörü ve dokunma sensörü.
  • Zamanlayıcı gruplarının zamanlayıcıları, RTC watchdog'u ve kesme watchdog'u (zamanlayıcı gruplarının watchdog'ları bölüm 3.11'dekilerdir).
  • UART1 ve UART2, I2C ve SPI denetleyicileri, I2S, kamera ve LCD denetleyicisi, TWAI, SD ana bilgisayarı, darbe sayacı, motor PWM'i, USB OTG denetleyicisi, GDMA ve şifreleme hızlandırıcıları. Çalışma zamanının Wire ve SPI'si sıradan pinlerde yazılımdır (SDA 8 ve SCL 9, SCK 12, MISO 13, MOSI 11 ve SS 10, bu kart için Arduino çekirdeğinin varsayılanları), buradaki her kartta tam olarak olduğu gibi, çünkü buradaki hiçbir kart modelinde bu denetleyiciler yoktur.
  • RMT'nin alma kanalları ve bölüm 3.8'in listesinin geri kalanı, ayrıca LEDC fade donanımı.
  • Dört kaynağın ötesinde kesme matrisi ve bir'in üzerindeki her CPU kesme seviyesi.

Bu yüzden satıcı ESP-IDF ve Arduino-core ikili dosyaları burada çalışmaz, ancak bu belge için derlenen firmware çalışır.

Üç Xtensa kartının imajları birbirinin yerine kullanılamaz. Katalogdaki program dizgileri farklıdır (burada elf32 xtensa lx7 esp32s3, klasik DevKit'te elf32 xtensa lx6 esp32, NodeMCU'da elf32 xtensa lx106 esp8266) ve bu fark gerçektir: klasik ESP32 için bir imaj aynı komutları çalıştırır ama bu çipte bulunmayan adreslere yüklenir, bu yüzden yükleyici onu reddeder.

7. Firmware çalışma zamanı (firmware/esp32s3/)

Arduino biçiminde bir çalışma zamanı: setup() ve loop(), pinMode, digitalWrite, digitalRead, shiftOut, analogRead (analogReadResolution, analogSetAttenuation ve analogSetPinAttenuation ile birlikte), analogWrite ve ledcAttach/ledcWrite/ledcRead ailesi, rgbLedWrite ve neopixelWrite, millis, micros, micros64, delay, delayMicroseconds, attachInterrupt, Serial, USBSerial, map, random. Arduino çekirdeği yok, ESP-IDF yok, libc yok. WiFi.h, HTTPClient.h ve WebServer.h, docs/wifi.md dosyasındaki paylaşılan simüle ağ çalışma zamanıdır.

LED_BUILTIN and RGB_BUILTIN are the Arduino core's number for the RGB LED: the GPIO count plus the LED's pin, 49 + 48. digitalWrite(LED_BUILTIN, HIGH) sends the LED one WS2812 frame, white at RGB_BRIGHTNESS (64 of 255), and LOW sends black, which is what the Arduino core does. rgbLedWrite(pin, r, g, b) takes the GPIO number or RGB_BUILTIN. Both use RMT channel 0 at 100 ns a tick: a 0 is 400 ns high and 800 ns low, a 1 is 800 ns high and 400 ns low, both inside the WS2812B datasheet's windows, with the carrier switched off. The core has no BOOT_BUTTON: the BOOT button is GPIO 0, so sketches use 0. A0 to A9 are GPIO 1 to 10.

Statik kuruculardan önce mokxi_init, LEDC ve RMT saat kapılarını ayarlar, UART0'ı 115200'de APB saatine geçirir ve GPIO kesme kaynağını yönlendirir. Bir LEDC çıkışını değiştiren her yazma işlemi, güncelleme bitiyle biter.

Serial, UART0'dır. USBSerial, USB Serial/JTAG portudur: baytlar 64 baytlık tamponuna girer ve sürücü her yeni satırda ve flush() içinde WR_DONE yazar, bayt kaybetmek yerine tamponun boşalmasını bekler.

crt0.S ve support64.c klasik ESP32'ninkilerdir; bu kart için kopyalanmak yerine yeniden derlenmişlerdir: pencere işleyicileri, vektör tablosu ve istisna girişi çipin değil ISA'nındır. Altı dosya daha, klasik ESP32'de olduğu gibi ESP32-C3'ün dosyalarıdır.

Espressif'in S3 için GCC'siyle derlenir. deploy/fetch-xtensa.sh esp32s3, xtensa-esp32s3-elf-gcc 8.4.0 sürümünü (esp-2021r2-patch5) gitignore'lanan tools/xtensa/ dizinine koyar. GCC GPL lisanslıdır ve burada derlediği hiçbir şey libgcc'ye veya araç zincirinin başka bir parçasına bağlanmaz (çalışma zamanı kendi destek koduyla -nostdlib'dir), dolayısıyla dağıtılan bir ELF'e GPL kodu ulaşmaz. Tam açıklama docs/compile.md dosyasındadır.

firmware/esp32s3/link.ld ile bağlanır: .text, SRAM1'in komut veri yolu adresinde, veri bölümleri ondan sonraki ilk baytın veri veri yolu adresinde, yığın SRAM2'nin en üstünde. Derleme, 64 KB'tan fazla yüklenebilir içeren bir imajı reddeder ve elfcheck.py, kodu ve verisi aynı RAM'i paylaşacak bir imajı reddeder.

On bir örnek, her biri arayüzde bir kod gösterir: blink (RGB LED beyaz ve GPIO2'ye kablolanmış bir LED), rainbow (RGB LED renk çemberinde döner), button (GPIO21'de pull-up özelliğini kullanan, pini toprağa bağlayan bir anahtar ile GPIO2'deki LED'i yakar), serial (UART0'da saniyede bir işaret ve bir yankı), usbserial (aynısı USB portu üzerinde), fade (GPIO2'deki bir LED, LEDC üzerinde, 1 kHz'de sekiz bit), knob (GPIO4'te bir potansiyometre, ADC1 kanal 3, GPIO2'deki LED'i kısar ve ham değeri yazdırır) ve dört WiFi örneği: wificonnect, wifiweather, wifiapi ve wifilamp.

crates/esp32s3/tests/runtime.rs bu ELF'leri başlatır ve şunları ölçer: blink'in yarım periyodu 500'ün 5 ms içinde olması, GPIO48'deki WS2812 çerçevelerinin çözülmesi ve her bitin yüksek ve düşük süresinin veri sayfasındaki pencerelerin içinde olması, rainbow'un gönderdiği renklerin yeşil-önce sırasıyla olması, LEDC'nin periyodunun 1 ms'nin 5 us içinde olması, millis() değerinin beş saniye boyunca çekirdeğin saatinden en çok 60 ms sapması, 115200 hızında UART0 baytlarının bir bayt süresinden daha yakın olmaması ve bir USB satırının tek paket olarak gelmesi. crates/esp32s3/tests/wifi.rs WiFi örneklerini simüle edilmiş ağda çalıştırır. Her test, imajlar derlenmediğinde kendini atlar.