Ini adalah referensi teknis untuk modelnya: apa yang diimplementasikan, register demi register, untuk orang yang menulis firmware menggunakannya. Untuk memakai board ini di editor, mulai dari ESP32-S3-DevKitC-1 dan halaman board.
ESP32-S3-DevKitC-1 adalah board milik Espressif sendiri untuk ESP32-S3: modul ESP32-S3-WROOM-1, dua core Xtensa LX7 di 240 MHz, dua soket micro-USB dan satu LED RGB yang bisa dialamati. Satu komponen kernel (esp32s3 di crates/parts) membungkus model SoC ESP32-S3 (crates/esp32s3) pada interpreter Xtensa yang sama dengan yang dipakai ESP32 klasik dan ESP8266 (crates/xtensa-core). Dokumen ini adalah kontraknya, dan ini menang atas komentar apa pun di kode.
Tipe katalognya esp32s3. String program katalog adalah elf32 xtensa lx7 esp32s3.
Baca bagian 6 dulu kalau kamu membawa build dari sini ke silicon asli. Berbeda dengan kontrak ESP32 klasik, hampir semua angka di sini diperiksa terhadap halaman ESP32-S3 Technical Reference Manual (versi 1.8), ESP32-S3 Series Datasheet serta panduan pengguna dan gambar dimensi DevKitC-1 milik Espressif. Bagian 6 mencantumkan sedikit yang tidak diperiksa, dan semua yang tidak dimodelkan sama sekali: core kedua, ekstensi vektor, cache, flash, PSRAM dan kedua radio termasuk di dalamnya.
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. Pin board (urutan katalog)
Tampak atas, dua soket micro-USB di bawah, modul WROOM-1 dan antenanya di atas. Gambar dimensi Espressif menyebut ukuran board 62,74 x 25,40 mm dengan setiap baris header 1,27 mm dari tepinya, jadi kedua header 22-pin berjarak 22,86 mm (0,9 inci) dan board ini mengangkangi breadboard dengan satu baris lubang tetap kosong di setiap sisi. Visual menggambarnya dalam ukuran itu.
J1, header kiri, pin 1 di atas (22 lubang): 3V3, 3V3b, RST, 4, 5, 6, 7, 15, 16, 17, 18, 8, 3, 46, 9, 10, 11, 12, 13, 14, 5V, G.
J3, header kanan, pin 1 di atas (22 lubang): Gb, TX, RX, 1, 2, 42, 41, 40, 39, 38, 37, 36, 35, 0, 45, 48, 47, 21, 20, 19, Gc, Gd.
44 pin. Sebuah angka adalah GPIO n. TX dan RX adalah GPIO43 dan GPIO44, UART0. RST adalah chip enable. 5V adalah jalur 5 V USB. G adalah ground. Nama yang sama diberi huruf tambahan, karena nama pin katalog harus unik; sablon di board tidak mencetaknya.
Diverifikasi: urutan kedua header, pin demi pin, terhadap tabel J1 dan J3 di panduan pengguna (panduan v1.0 dan v1.1 memberi urutan yang sama), dan posisi kedua baris terhadap gambar dimensi.
GPIO 26 sampai 32 tidak ada di salah satu header. Itu adalah flash SPI. GPIO 22 sampai 25 tidak ada sama sekali pada komponen ini (tabel fungsi IO MUX tidak punya baris untuk pin-pin itu). GPIO 33 dan 34 juga tidak ada di header. crates/parts/src/parts/esp32s3.rs punya test yang memeriksa semua ini.
GPIO 35, 36 dan 37 ada di header, dan pada varian dengan PSRAM oktal (DevKitC-1-N8R8 yang paling banyak dibeli orang) pin-pin itu milik PSRAM dan tidak boleh dipakai. Model ini tidak punya PSRAM, jadi di sini pin-pin itu adalah pin biasa, dan catatan dari panduan pengguna diulang di halaman bantuan.
GPIO 19 dan 20 adalah USB D- dan D+ chip, yang tersambung ke soket "USB" pada board. Di sini pin-pin itu tetap pad biasa dan port USB serial tetap berfungsi bahkan saat sketch mengendalikannya, yang tidak akan terjadi pada board sungguhan (bagian 3.4).
Hal-hal di board:
- 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
revisionproperty picks which,1.0or1.1, and defaults to1.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 adalah GPIO0, aktif rendah; mengekliknya di board akan men-ground pin itu. Pin itu juga ada di J3 sebagai
0. - RST mereset chip.
- LED daya merah 3,3 V, digambar menyala, karena board di sini selalu terhubung ke USB.
Kelistrikan: setiap GPIO menggerakkan push-pull pada 3,3 V melalui R_STRONG, berada pada high-Z, atau menarik ke atas atau ke bawah melalui 45 k. Input terbaca tinggi pada 1,65 V (setengah suplai I/O); net yang bergolak (Unknown) terbaca 0, dan yang mengambang terbaca noise, seperti pada Uno (docs/uno.md bagian 1). GPIO0 terbaca tinggi saat tidak ada yang menahannya, karena pull-up board di samping tombol BOOT. 3V3 menggerakkan 3,3 V pada R_SUPPLY, 5V menggerakkan 5 V, G menggerakkan 0 V. RST membawa pull-up 10 k ke 3,3 V dan menariknya di bawah 1,65 V membuat core tetap dalam reset. Kapasitor di samping resistor itu, power-on reset board, tidak dimodelkan.
2. Peta memori
| SRAM1, bus instruksi | 416 KB di 0x4037_8000 sampai 0x403D_FFFF |
| 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 dan SRAM2, bus data | 480 KB di 0x3FC8_8000 sampai 0x3FCF_FFFF |
| puncak stack | 0x3FD0_0000 |
| UART0 | 0x6000_0000, bagian 3.3 |
| GPIO matrix | 0x6000_4000, bagian 3.1 |
| SENS | 0x6000_8800, bagian 3.6 |
| IO MUX | 0x6000_9000, bagian 3.2 |
| RMT | 0x6001_6000, bagian 3.8 |
| LEDC | 0x6001_9000, bagian 3.7 |
| SYSTIMER | 0x6002_3000, bagian 3.5 |
| USB Serial/JTAG | 0x6003_8000, bagian 3.4 |
| SYSTEM | 0x600C_0000, bagian 3.9 |
| Matriks interupsi | 0x600C_2000, bagian 3.9 |
Setiap blok peripheral berukuran 4 KB di sini, kecuali SENS, yang merupakan 2 KB bagian atas dari blok manajemen daya rendah.
Terverifikasi: setiap alamat dalam tabel, terhadap tabel 4.3-1 (memori internal) dan 4.3-3 (peripheral) pada manual. SENS adalah "alamat dasar Low Power Management + 0x800" dalam ringkasan register manual, 39.6.2.
Satu SRAM, dua jendela, dan modelnya punya keduanya. Manual mengatakan SRAM1 "dialamati oleh CPU melalui bus data atau bus instruksi dalam urutan yang sama": byte di 0x4037_8000 + n adalah byte di 0x3FC8_8000 + n. Model menyimpan satu buffer untuk jendela data dan memetakan jendela instruksi ke 416 KB pertamanya, jadi program bisa membaca kodenya sendiri melalui bus data dan mendapatkan byte yang benar, sesuatu yang tidak bisa ditawarkan model ESP32 klasik. SRAM2 hanya ada di bus data, tepat setelah SRAM1. firmware/esp32s3/link.ld menaruh kode di alamat instruksi dan memulai section data di alamat bus data dari byte pertama setelah kode, jadi keduanya tidak pernah berbagi RAM, dan elfcheck.py menolak image yang akan membuat hal itu terjadi.
SRAM0, 32 KB di 0x4037_0000 yang bisa diambil instruction cache, tidak dimodelkan; akses ke sana dihitung sebagai fault.
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.
Core melakukan reset dengan pc di titik masuk ELF dan setiap register alamat bernilai nol. Tidak ada boot ROM di sini: loader tahap pertama, pembacaan flash, clock tree dan pengaturan cache semuanya tidak ada, dan runtime membuat keadaan yang diinginkannya menjadi eksplisit.
3. Register peripheral
Hanya subset di bawah ini yang diimplementasikan. Apa pun selain itu di dalam blok yang dipetakan terbaca 0 dan dihitung sebagai akses liar; apa pun di luar semua blok adalah access fault.
3.1 Matriks GPIO (0x6000_4000)
Nomor GPIO berjalan dari 0 sampai 48, jadi setiap register dengan satu bit per pin terbagi dalam dua bagian: yang biasa mencakup GPIO 0 sampai 31 dan yang berakhiran 1 mencakup GPIO 32 sampai 48 pada tujuh belas bit rendahnya.
| offset | register |
|---|---|
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, disimpan |
0x554 + 4n |
GPIO_FUNCn_OUT_SEL_CFG_REG |
Bentuk W1TS dari register status, GPIO_CPU_INT_REG/GPIO_CPU_INT1_REG (dibaca sebagai status), GPIO_BT_SELECT_REG, GPIO_SDIO_SELECT_REG dan GPIO_CLOCK_GATE_REG juga dijawab.
Terverifikasi: alamat dasar dan setiap offset, terhadap ringkasan register 6.14.
GPIO_PINn_REG (register 6.18): bit 2 PAD_DRIVER membuat pad menjadi open drain; bit 7..9 INT_TYPE memilih apa yang menaikkan interupsi pin (0 mati, 1 rising, 2 falling, 3 semua edge, 4 level rendah, 5 level tinggi); bit 13 adalah enable interupsi CPU. Terverifikasi.
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 terbaca 0x08: bit 3 (GPIO0) tinggi, bit 2, 4 dan 5 (GPIO46, GPIO45, GPIO3) rendah, yang berarti boot biasa dari flash 3,3 V. Penugasan bitnya berasal dari register 6.15; nilainya konstan di sini, bukan latch dari keadaan pin saat reset.
3.2 IO MUX (0x6000_9000)
IO_MUX_PIN_CTRL_REG di 0x00, lalu satu register per GPIO di 0x04 + 4n. Berbeda dengan ESP32 klasik, IO MUX S3 tersusun dalam urutan GPIO. Bit 7 FUN_WPD, bit 8 FUN_WPU, bit 9 FUN_IE, bit 10..11 FUN_DRV (disimpan), bit 12..14 MCU_SEL. Pad hanya sampai ke GPIO_IN_REG jika input buffer-nya aktif.
Terverifikasi: alamat dasar, offset dan bit-bitnya, terhadap register 6.36; tabel fungsi dan nilai reset terhadap tabel 6.12-1.
MCU_SEL memilih salah satu dari maksimal lima fungsi. Fungsi 1 adalah matriks GPIO di setiap pin. Di sebagian besar pin, fungsi 0 juga matriks GPIO, tapi di pin 26 sampai 32 itu adalah flash, di 39 sampai 42 pin JTAG, di 43 dan 44 UART0, dan di 47 dan 48 pasangan clock flash. Jadi program yang ingin memakai salah satunya sebagai GPIO harus menyetel MCU_SEL ke 1. pinMode dari runtime selalu melakukannya. LED RGB di GPIO48 adalah salah satunya: sampai sesuatu menyetel MCU_SEL-nya, apa pun yang program tulis ke matriks tidak akan sampai ke pad itu.
Setiap pad muncul dengan nilai reset sesuai manual. Kolom "RST" tabel 6.12-1: GPIO0 dan pin flash dengan pull-up-nya, GPIO45 dan GPIO46 dengan pull-down-nya, sebagian besar pin hanya dengan buffer input aktif, dan GPIO 4 sampai 8, 15, 16 serta 19 sampai 21 bahkan tanpa itu, jadi digitalRead di salah satu pin itu membaca 0 sampai buffer dinyalakan. MTCK, GPIO39, muncul ter-pull-up, sesuai tabel untuk komponen yang pad JTAG-nya tidak dinonaktifkan oleh eFuse. GPIO43, U0TXD, muncul dengan outputnya aktif di UART; gelombang UART itu sendiri tidak dimodelkan (bagian 3.3), jadi pad itu menahan garis di kondisi idle tinggi sampai sebuah program mengambil alihnya.
3.3 UART0 (0x6000_0000)
| offset | register |
|---|---|
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 |
Terverifikasi: alamat dasar dan setiap offset (ringkasan register 26.6), serta bit di bawah.
Dua FIFO 128 byte. Bit 0..9 UART_STATUS_REG adalah RXFIFO_CNT dan bit 16..25 TXFIFO_CNT. Bit 17 UART_CONF0_REG RXFIFO_RST dan bit 18 TXFIFO_RST mengosongkannya (register 26.9; model ESP32 klasik memiliki kedua bit ini terbalik, bagian 6). UART_CONF1_REG menyimpan dua ambang FIFO, masing-masing sepuluh bit, 96 saat reset. Bit 0..11 UART_CLKDIV_REG adalah bagian integer pembagi dan bit 20..23 bagian per-enam belasnya, 694 saat reset.
Pembagi membagi clock inti UART, yang dipilih oleh bit 20..21 UART_CLK_CONF_REG SCLK_SEL: 1 clock APB 80 MHz, 3 kristal 40 MHz, dan kristal adalah nilai reset (register 26.18). Nilai 2, osilator RC_FAST, tidak dimodelkan dan dianggap sebagai kristal. SCLK_DIV_NUM (bit 12..19) membagi clock inti dengan SCLK_DIV_NUM + 1, yang diduga benar: manual menyebut field ini "bagian integral dari pembagi frekuensi" dan mencetak pembagi tanpa tambahan satu, dan saat reset field ini bernilai 1. Runtime menyetel SCLK_SEL ke 1 dan SCLK_DIV_NUM ke 0, sehingga 694 menghasilkan 115 274 baud. Bagian fraksional SCLK_DIV_A/SCLK_DIV_B tidak dimodelkan.
Byte keluar dari FIFO transmit dengan laju baud, tidak seketika, jadi port 115 200 baud mengirim 11 520 byte per detik di sini seperti di meja kerja; crates/esp32s3/tests/runtime.rs memeriksa bahwa tidak ada dua byte dari contoh serial yang lebih dekat dari satu waktu byte.
UART1 dan UART2 tidak dimodelkan. Gelombang pin U0TXD juga tidak dimodelkan: byte-byte itu adalah kanal host, bukan bit di GPIO43.
3.4 USB Serial/JTAG (0x6003_8000)
Setengah serial dari kontroler: port CDC-ACM yang dibawa soket "USB" board, yang bisa diakses sketch sebagai USBSerial.
| offset | register |
|---|---|
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, tersimpan |
Terverifikasi: base, offset (ringkasan register 33.5) dan bit-bitnya: EP1_CONF bit 0 WR_DONE, bit 1 SERIAL_IN_EP_DATA_FREE, bit 2 SERIAL_OUT_EP_DATA_AVAIL (register 33.2); INT_* bit 2 SERIAL_OUT_RECV_PKT_INT dan bit 3 SERIAL_IN_EMPTY_INT, yang ter-set saat reset (register 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.
Pewaktuan di sini adalah milik model ini sendiri. Manual hanya bilang host "akan memeriksa secara berkala". Di sini host selalu punya terminal terbuka dan mengambil paket yang di-flush segera setelah bisa melewati bus 12 Mbit/s: paket ditambah tiga belas byte token, handshake dan framing, jadi 51.3 us untuk 64 byte. Host sungguhan bisa menambahkan hingga satu frame (1 ms) penjadwalan; itu tidak dimodelkan.
Tidak dimodelkan: setengah JTAG, enumerasi, interrupt bus-error, permintaan reset RTS/DTR dan mode download, serta suspend. Host selalu terhubung.
3.5 SYSTIMER (0x6002_3000)
Unit 0: penghitung 52 bit di balik micros() dan millis().
| offset | register |
|---|---|
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 |
Terverifikasi: base, offset (ringkasan register 11.5), bit (CONF bit 30 TIMER_UNIT0_WORK_EN, ter-set saat reset; OP bit 30 UPDATE, bit 29 VALUE_VALID) dan clock hitung 16 MHz ("XTAL_CLK/2.5, yaitu 16 MHz", bagian 11.4).
Pembacaannya adalah latch-lalu-baca: tulis UPDATE, tunggu VALUE_VALID, baca VALUE_HI dan VALUE_LO. Penghitungnya tidak dihitung: nilainya adalah waktu simulasi dibagi 62.5 ns, ditambah apa pun yang diletakkan sebuah load, jadi tidak ada yang bisa membuatnya bergeser. Unit 1, tiga komparator dan alarmnya tidak dimodelkan; tick runtime adalah CCOMPARE0 milik inti sendiri (bagian 4).
3.6 SENS: ADC1, satu kali (0x6000_8800)
Konversi yang dimulai lewat software oleh kontroler RTC ADC1.
| offset | register | bit |
|---|---|---|
0x00 |
SENS_SAR_READER1_CTRL_REG |
disimpan |
0x0C |
SENS_SAR_MEAS1_CTRL2_REG |
bit 0..15 MEAS1_DATA_SAR (hanya baca), bit 16 MEAS1_DONE_SAR, bit 17 MEAS1_START_SAR, bit 18 MEAS1_START_FORCE, bit 19..30 SAR1_EN_PAD (satu bit per kanal), 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 |
Sudah diverifikasi: basis, tiga offset dan setiap bit, terhadap register 39.10 sampai 39.13.
Satu konversi: taruh atenuasi di ATTEN1, set START_FORCE dan EN_PAD_FORCE, taruh bit kanal di SAR1_EN_PAD, naikkan MEAS1_START_SAR, tunggu MEAS1_DONE_SAR, lalu baca datanya. Satu konversi memakan waktu tetap 5 us waktu simulasi, angka dari model itu sendiri.
Sepuluh kanal, dan kanal n adalah GPIO n + 1: ADC1_CH0 adalah GPIO1 dan ADC1_CH9 GPIO10 (tabel header panduan pengguna, pin demi pin).
Hasilnya adalah dua belas bit dari tegangan net pada saat konversi dimulai. Saat ATTEN0 ke ATTEN2 nilainya round(4095 x Vin / Vtop), di-clamp, dengan Vtop adalah batas atas dari "rentang pengukuran efektif" di datasheet: 850 mV, 1100 mV dan 1600 mV. ATTEN3 (12 dB), atenuasi saat reset dan bawaan Arduino core, mengikuti kurva mentah komponen tipikal (CURVE_ATTEN3 di dalam crates/esp32s3/src/adc.rs): hampir linear dari 0 V, mulai melengkung dari sekitar 2750 mV (di mana pengukuran Espressif sendiri menunjukkan S3 kehilangan linearitas) melewati rentang efektif 2900 mV, dan jenuh di 4095 mulai sekitar 3.1 V. Jadi potensiometer di rel 3.3 V mencapai 4095 sedikit sebelum ujung jalurnya, dan setengah rel (1.65 V) terbaca sekitar 2220. Kalibrasi eFuse tiap unit menggeser itu beberapa persen, yang tidak dimodelkan. analogReadMilliVolts membalikkan kurva yang sama. Channel tanpa apa pun di pin-nya akan mengambang, seperti perilaku input mengambang (docs/uno.md bagian 1).
ADC2, pengendali digital, DMA, eFuse kalibrasi, dan sensor suhu tidak ada.
3.7 LEDC (0x6001_9000)
Delapan channel dan empat timer, semuanya dalam satu kelas kecepatan: seluruh LEDC S3.
| offset | register | bit |
|---|---|---|
0x00 + 0x14n |
LEDC_CHn_CONF0_REG |
bit 0..1 TIMER_SEL, bit 2 SIG_OUT_EN, bit 3 IDLE_LV, bit 4 PARA_UP (hanya tulis) |
0x04 + 0x14n |
LEDC_CHn_HPOINT_REG |
bit 0..13 HPOINT |
0x08 + 0x14n |
LEDC_CHn_DUTY_REG |
bit 0..18 duty dalam enam belas bagian dari satu hitungan |
0x0C + 0x14n |
LEDC_CHn_CONF1_REG |
hardware fade: tersimpan, tidak mem-fade apa pun |
0x10 + 0x14n |
LEDC_CHn_DUTY_R_REG |
duty yang berlaku, hanya baca |
0xA0 + 8n |
LEDC_TIMERn_CONF_REG |
bit 0..3 DUTY_RES, bit 4..21 CLK_DIV (Q10.8), bit 22 PAUSE, bit 23 RST (disetel saat reset), bit 25 PARA_UP (hanya tulis) |
0xA4 + 8n |
LEDC_TIMERn_VALUE_REG |
penghitungnya |
0xC0 |
LEDC_INT_RAW_REG |
bit n = timer n meluap |
0xC4 |
LEDC_INT_ST_REG |
|
0xC8 |
LEDC_INT_ENA_REG |
tersimpan; tidak ada jalur yang sampai ke core |
0xCC |
LEDC_INT_CLR_REG |
|
0xD0 |
LEDC_CONF_REG |
bit 0..1 APB_CLK_SEL (1, clock APB, adalah satu-satunya sumber yang dimodelkan), bit 31 CLK_EN |
0xFC |
LEDC_DATE_REG |
terbaca 0x1907_2601 |
Terverifikasi: basisnya, setiap offset dan setiap bit dalam tabel (ringkasan register 35.4 dan register 35.1 sampai 35.13). Ini perbedaan nyata dari model ESP32 klasik, yang tata letak LEDC-nya masih diduga.
Sebuah timer menghitung 2^DUTY_RES hitungan pada 80 MHz dibagi CLK_DIV: f = 80e6 / ((CLK_DIV / 256) * 2^DUTY_RES). Output sebuah channel tinggi mulai dari HPOINT selama DUTY >> 4 hitungan.
Tidak ada yang berlaku tanpa bit update-nya. CLK_DIV dan DUTY_RES sebuah timer menunggu TIMERn_PARA_UP, dan HPOINT, SIG_OUT_EN, TIMER_SEL, serta duty sebuah channel menunggu PARA_UP_CHn (daftar pada register 35.1 dan 35.7). Model ini memisahkan apa yang ditulis dari apa yang sedang berlaku, jadi firmware yang lupa bit update tidak mendapatkan PWM, sama seperti di meja sungguhan. PAUSE, RST, dan IDLE_LV bekerja seketika. Duty tercantum di bawah DUTY_START; model memuatnya saat PARA_UP_CHn entah DUTY_START disetel atau tidak, yang diduga sama dengan apa yang dilakukan perubahan duty biasa saat hardware fade menganggur.
Sebuah channel mencapai pad melalui matriks GPIO pada OUT_SEL 73 + n (bagian 3.1). Penghitungnya adalah fungsi bentuk-tertutup dari waktu simulasi, jadi core yang parkir di waiti tidak memakan biaya apa pun selama PWM berjalan; runtime.rs mengukur periode contoh fade terhadap 1 ms dari 1 kHz dalam toleransi 5 us.
Clock LEDC mati saat reset (bagian 3.9): sampai SYSTEM_LEDC_CLK_EN disetel, blok ini tidak menjawab.
Tidak dimodelkan: hardware duty-fade, penghitung overflow, sumber clock selain APB, dan jalur LEDC ke matriks interupsi.
3.8 RMT (0x6001_6000)
Empat channel transmit dari periferal remote control: yang menggerakkan LED RGB.
| offset | register | bit |
|---|---|---|
0x00 + 4n |
RMT_CHnDATA_REG |
tulis: dorong sebuah word ke RAM channel n melalui FIFO APB |
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 alamat baca, bit 11..20 alamat tulis APB, bit 22..24 status, 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 rendah, bit 16..31 tinggi, masing-masing 0x40 saat reset |
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 |
terbaca 0x0210_1181 |
0x800 sampai 0xDFF |
RAM-nya | 384 word |
Register channel receive (0x30 sampai 0x4C, 0x60 sampai 0x6C, 0x90 sampai 0x9C, 0xB0 sampai 0xBC) disimpan dan terbaca kembali tetapi tidak menerima apa pun.
Terverifikasi: basisnya, setiap offset dan bit dalam tabel (ringkasan register 37.5, register 37.1 sampai 37.19), ukuran RAM dan awal NONFIFO-nya di "RMT base address + 0x800", format kode pulsa (periode di bit 0..14 dan 16..30, level di bit 15 dan 31, "nilai minimum untuk periode adalah nol dan ditafsirkan sebagai penanda akhir transmisi"), clock channel (rmt_sclk dibagi DIV_CNT, "nilai 0 mewakili pembagi 256", dan rmt_sclk sumbernya dibagi SCLK_DIV_NUM + 1 + A/B), nilai reset (carrier menyala, MEM_SIZE 1, DIV_CNT 2), serta daftar field yang menunggu CONF_UPDATE (tabel 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.
Apa yang dilakukan sebuah transmisi, dari bagian 37.3.4: TX_START mengirim mulai dari awal blok channel, setiap kode menahan levelnya selama period tick clock-channel; pada penanda akhir channel berhenti, menaikkan TX_END, dan menahan level penanda akhir, atau IDLE_OUT_LV jika IDLE_OUT_EN disetel; berjalan melewati akhir blok MEM_SIZE-nya tanpa penanda akhir menghentikannya dengan MEM_EMPTY dan ERR, kecuali mode wrap mengirimnya mengulang lagi, dalam hal ini TX_THR_EVENT naik setiap kali TX_LIM word lagi telah lewat; mode kontinu memulai lagi pada setiap penanda akhir, menghitung loop bila diminta. TX_STOP menghentikan seketika.
Pembaruan konfigurasi. DIV_CNT, IDLE_OUT_EN, IDLE_OUT_LV, TX_CONTI_MODE, TX_STOP, field carrier, dan tiga field TX_LIM hanya berlaku saat CONF_UPDATE (tabel 37.3-1); model memisahkannya sampai saat itu. MEM_SIZE, mode wrap, dan TX_START bekerja seketika.
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.
Output adalah fungsi bentuk-tertutup dari waktu di antara batas kode, jadi setiap tepi jatuh tepat pada pikodetiknya dan core yang parkir tidak memakan biaya apa pun selama sebuah frame dikirim. runtime.rs mendekode frame contoh blink dan rainbow di GPIO48 dan memeriksa setiap waktu tinggi dan rendah terhadap jendela datasheet WS2812B.
Clock RMT mati saat reset (bagian 3.9).
Tidak dimodelkan: channel receive, DMA pada channel 3, mulai serentak, kepemilikan dan daya RAM, serta aturan periode minimum (rumus 37.1 dan 37.3).
3.9 SYSTEM (0x600C_0000) dan matriks interupsi (0x600C_2000)
| offset | register |
|---|---|
0x10 |
SYSTEM_CPU_PER_CONF_REG, tersimpan |
0x18 |
SYSTEM_PERIP_CLK_EN0_REG |
0x1C |
SYSTEM_PERIP_CLK_EN1_REG, tersimpan |
0x20 |
SYSTEM_PERIP_RST_EN0_REG |
0x24 |
SYSTEM_PERIP_RST_EN1_REG, tersimpan |
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.
Matriks interupsi: register peta sumber n untuk core 0 berada di 0x600C_2000 + 4n, dan lima bit rendahnya menamai interupsi CPU yang dimunculkan sumber itu. Terverifikasi terhadap tabel 9.3-1 dan ringkasan register 9.4, begitu juga empat nomor sumber yang dirutekan model ini:
| sumber | nomor |
|---|---|
GPIO_INTERRUPT_CPU |
16 |
UART_INTR |
27 |
RMT_INTR |
40 |
USB_DEVICE_INT |
96 |
Sumber yang dipetakan ke salah satu interupsi internal core (6, 7, 11, 15, 16 atau 29) tidak sampai ke mana pun, dan beginilah cara manual menonaktifkan sebuah sumber (bagian 9.3.3.3). Setiap register peta lainnya disimpan dan dapat dibaca kembali tapi tidak merutekan apa pun.
3.10 Kotak surat jaringan Mokxi (0x6FFF_E000)
Blok ini bukan milik ESP32-S3. Setiap alamat lain dalam dokumen ini milik chip. Yang ini milik Mokxi sendiri: jaringan simulasi dari crates/net, pada alamat yang dibiarkan tak terpetakan oleh S3. Manual menempatkan peripheral di "0x6000_0000~0x600D_0FFF" dan memori RTC FAST berakhir di 0x600F_FFFF, jadi image yang memakai blok ini fault di silikon alih-alih membaca register peripheral lain. Fault itu adalah jawaban yang jujur, karena hal di balik blok ini tidak ada pada chip. Ini alamat yang sama dengan yang dipakai model ESP32-C3 dan C6, karena ketiga chip meninggalkan celah yang sama.
Blok ini tidak memunculkan interupsi sama sekali. Setiap sumber lain di sini sampai ke core melalui matriks interupsi bagian 3.9, dan nomor sumber matriks adalah milik chip; tidak ada nomor jujur untuk diberikan kepada peripheral yang tidak dimiliki chip, jadi kotak surat ini tidak diberi nomor. NET_INT_RAW_REG tetap terbaca, firmware melakukan polling, dan core yang parkir di waiti tetap dibangunkan saat jaringan punya sesuatu untuk disampaikan, sama seperti dibangunkan oleh tepi PWM.
Di sini tidak ada radio, tidak ada 802.11 dan tidak ada internet sungguhan. Tidak ada dalam model ini yang memancar, memindai, berasosiasi, mengenkripsi atau membuka soket: kata sandi dibandingkan sebagai string, nama yang tidak berada di bawah .mokxi tidak di-resolve, dan origin yang dilayani jaringan adalah fungsi-fungsi di crates/net/src/http.rs. Kotak surat ini adalah bentuk jahitan sungguhan, bukan fiksi tentang MAC: pada ESP32-S3 sungguhan perangkat keras WiFi berada di balik blob biner tertutup dengan antarmuka perintah, dan WiFi.h milik Arduino berakhir di sisi lain salah satunya. docs/wifi.md adalah kontrak untuk apa yang ada di baliknya; bagian ini hanya registernya.
Sebuah register perintah, register status, ring 4096-byte untuk tiap arah dan satu bit interrupt. Menulis ke NET_CMD_REG menjalankan perintah; perintah yang memakan waktu simulasi menaikkan BUSY dan menghapusnya, dengan DONE di NET_INT_RAW_REG, saat selesai.
| offset | nama | bit |
|---|---|---|
0x00 |
NET_ID_REG |
membaca 0x494B4F4D, dan tidak ada hal lain yang melakukannya. Sketch yang ingin tahu apakah ia berjalan di Mokxi membaca ini; di silicon akses ini gagal |
0x04 |
NET_CMD_REG |
tulis kode perintah (tabel di bawah); penulisan menjalankannya |
0x08 |
NET_ARG_REG |
satu word argumen, bisa dibaca kembali: port untuk LISTEN, status untuk REPLY |
0x0C |
NET_STATUS_REG |
bit 0 BUSY, bit 1 ERR, bit 2 RX_READY, bit 3 LINK, bit 4 SERVE, bit 8..11 STATE |
0x10 |
NET_RESULT_REG |
apa yang dijawab perintah terakhir |
0x14 |
NET_INT_RAW_REG |
bit 0 DONE, bit 1 EVENT |
0x18 |
NET_INT_ENA_REG |
dua bit yang sama |
0x1C |
NET_INT_CLR_REG |
tulis 1 untuk menghapus, dua bit yang sama |
0x20 |
NET_TX_LEN_REG |
byte yang siap di ring keluar |
0x24 |
NET_TX_DATA_REG |
tulis: dorong satu byte (bit 0..7) ke ring keluar |
0x28 |
NET_RX_LEN_REG |
byte yang menunggu di ring masuk |
0x2C |
NET_RX_DATA_REG |
baca: ambil satu byte dari ring masuk, 0 saat kosong |
0x30 |
NET_RING_LEN_REG |
kapasitas tiap ring dalam byte, agar firmware tidak perlu hard-code 4096 |
0x40 |
NET_BT_CMD_REG |
Bluetooth: tulis kode perintah Bluetooth (docs/bluetooth.md); penulisan menjalankannya |
0x44 |
NET_BT_ARG_REG |
Bluetooth: satu word argumen, bisa dibaca kembali; sebuah event meninggalkan nomornya di sini |
0x48 |
NET_BT_RESULT_REG |
Bluetooth: apa yang dijawab perintah Bluetooth terakhir |
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: byte yang siap di ring keluarnya sendiri |
0x54 |
NET_BT_TX_DATA_REG |
Bluetooth: tulis: dorong satu byte ke ring tersebut |
0x58 |
NET_BT_RX_LEN_REG |
Bluetooth: byte yang menunggu di ring masuknya sendiri |
0x5C |
NET_BT_RX_DATA_REG |
Bluetooth: baca: ambil satu byte, 0 saat kosong |
Delapan register NET_BT_ adalah separuh Bluetooth dari blok itu, dengan ring milik mereka sendiri: hanya Bluetooth LE, seperti di chip asli, jadi perintah Classic menyetel BT_ERR. Tidak ada radio di baliknya juga; docs/bluetooth.md adalah kontraknya.
STATE adalah posisi station: 0 idle, 1 mulai, 2 menghubungkan, 3 terhubung, 4 gagal, 5 jaringan tidak ada. NET_CMD_STATUS mengubah hal yang sama menjadi kode wl_status_t Arduino yang dibaca sketch dari WiFi.status().
NET_CMD_REG |
nama | fungsinya |
|---|---|---|
| 0 | NOP |
tidak melakukan apa pun |
| 1 | RESET |
putuskan koneksi, buang kedua ring, buang semua request |
| 2 | CONNECT |
ring keluar berisi ssid\0password; menaikkan BUSY selama satu sampai tiga detik |
| 3 | DISCONNECT |
hapus asosiasi dan alamatnya |
| 4 | STATUS |
NET_RESULT_REG = kode wl_status_t |
| 5 | IP |
NET_RESULT_REG = alamat yang didapat, oktet pertama di byte rendah |
| 6 | RSSI |
NET_RESULT_REG = sinyal dalam dBm, dengan tanda diperluas |
| 7 | SSID |
ring masuk menerima nama access point |
| 8 | MAC |
ring masuk menerima enam byte MAC board |
| 9 | REQUEST |
ring keluar berisi method\0url\0headers\0body; menaikkan BUSY |
| 10 | POLL |
NET_RESULT_REG = 0 saat berjalan, lalu status HTTP, atau error negatif dengan ERR naik; body mendarat di ring masuk |
| 11 | LISTEN |
mendengarkan di port yang ada di NET_ARG_REG |
| 12 | ACCEPT |
NET_RESULT_REG = 1 dan ring masuk berisi method\0path\0query\0body, atau 0 saat tidak ada yang menunggu |
| 13 | REPLY |
jawab request yang diterima dengan status di NET_ARG_REG; ring keluar berisi content-type\0body |
| 14 | STOP |
berhenti mendengarkan |
| 15 | WL_GPIO_SET |
drive GPIO milik komponen nirkabel sendiri dari NET_ARG_REG. Bukan board ini: radio komponen ini tidak punya pin seperti itu, jadi ia menyetel ERR dan tidak menggerakkan apa pun. Inilah jalur yang diambil LED bawaan Pico W (docs/picow.md bagian 3.8) |
| 16 | WL_GPIO_GET |
baca kembali nilainya, dan ERR yang sama di sini |
| 17 | BLYNK |
satu operasi pada server Blynk yang disimulasikan, operasinya di NET_ARG_REG dan field-nya di ring keluar; dijawab seketika di NET_RESULT_REG, dengan ERR dimatikan dari jaringan (docs/wifi.md, "Blynk") |
| 19 | ETH |
Ethernet kabel (firmware/include/ETH.h), operasinya di NET_ARG_REG: 1 mengaktifkan link lewat kabel tersimulasi, tanpa SSID dan tanpa kata sandi, bergabung 1,5 s kemudian dengan lease yang sama; 2 menaruh 1 di NET_RESULT_REG saat link sedang (atau terakhir) merupakan yang berkabel. Linknya hanya satu: STATUS, IP dan setiap permintaan membacanya dari cara aktifnya apa pun |
| 20 | SOFTAP |
soft AP (crates/net/src/softap.rs, docs/wifi.md), operasinya di NET_ARG_REG: 1 mengaktifkannya (ring keluar ssid\0password\0 dan byte channel; NET_RESULT_REG 1, atau 0 dengan ERR untuk nama kosong atau kata sandi satu sampai tujuh karakter), 2 mematikannya, 3 mengonfigurasinya (alamat, gateway dan netmask, masing-masing empat byte), 4 alamatnya (0 saat mati), 5 station yang bergabung, 6 join, leave dan bit aktif yang diubah runtime menjadi event, 7 dan 8 DNS server captive portal yang menyala (namanya, satu byte nol, alamatnya) dan berhenti, 9 namanya ke ring masuk, 10 alamat HP, 11 Host dari permintaan yang sedang dilayani ke ring masuk. Station satu-satunya adalah HP panel Web |
Kode POLL negatif: -1 nama tidak ter-resolve, -2 station tidak terasosiasi, -3 https:// dan TLS tidak disimulasikan, -4 body lebih panjang dari ring, -5 URL yang tidak bisa di-parse jaringan ini, -6 sudah ada permintaan yang berjalan. firmware/include/HTTPClient.h mengubahnya menjadi kode bergaya Arduino yang dibandingkan oleh sketch, dan docs/wifi.md memuat daftar pemetaannya.
Timing, semuanya milik model ini sendiri dan semuanya dinyatakan di docs/wifi.md: asosiasi memakan waktu satu sampai tiga detik, ditentukan dari SSID supaya sebuah pelajaran memakan waktu yang sama dua kali; kata sandi yang salah menjadi WL_CONNECT_FAILED setelah lima detik; permintaan ke origin tersimulasi kembali 60 ms kemudian; permintaan ke server milik sketch sendiri yang tidak pernah dijawab sketch ditutup oleh jaringan dengan 504 setelah sepuluh detik.
3.11 Watchdog grup timer, reset RTC_CNTL dan monitor stack
Seperti C3 (docs/esp32c3.md bagian 3.9), dengan layout S3: tidak ada WDT_CONF_UPDATE_EN (tulis langsung berlaku), bit interupsi watchdog adalah bit 2, interupsi mencapai core melalui matriks interupsi (sumber 52 dan 55; runtime memetakan 52 ke interupsi CPU 17), register penyimpanan ada di 0x50..0x5C dan 0xC0..0xCC, dan SP_MIN milik ASSIST_DEBUG berada satu register lebih jauh (0x3C). Pemantau stack memeriksa ENTRY, di mana kode windowed memindahkan stack sekali per panggilan; pelanggaran terhadap batas yang sejak itu melebar dicoba ulang, bukan dilaporkan.
Runtime menjalankan task watchdog milik ESP-IDF di atas watchdog grup timer 0, seperti yang dilakukan ESP-IDF (firmware/src/main.cpp): tick 500 µs, stage 0 berupa interrupt saat timeout dan stage 1 berupa reset sistem saat dua kali timeoutnya, dimulai sebelum setup() pada 5 s dengan panic, mengawasi idle task core 0. Sketch berjalan di core 1, yang idle task-nya tidak diawasi kecuali ia memintanya sendiri (enableCore1WDT()), jadi loop yang tidak pernah yield tetap berjalan, seperti di board. Interrupt itu mencetak baris-baris ESP-IDF ("E (…) task_wdt: Task watchdog got triggered. …", daftar task, "Aborting.", baris abort dan "Rebooting..."), meninggalkan petunjuk ESP_RST_TASK_WDT milik ESP-IDF di register penyimpan RTC dan mereset CPU lewat reset perangkat lunak, sehingga esp_reset_reason() mengatakan 6 setelahnya. esp_task_wdt_*, enableLoopWDT() dan enable/disableCore0WDT() bekerja padanya. Watchdog grup timer 1 dimodelkan dengan cara yang sama dan tidak ada apa pun di runtime yang mempersenjatainya: interrupt watchdog tidak disimulasikan.
4. Core-nya: LX7, ABI yang mana, dan bagaimana interupsi tiba
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.
Untuk semua yang dihasilkan compiler, LX7 di sini adalah LX6. Header konfigurasi kedua toolchain (core-isa.h di xtensa-esp32-elf dan xtensa-esp32s3-elf) sepakat pada setiap opsi integer yang menentukan kode apa yang dihasilkan compiler: enam puluh empat register alamat dan register window, loop tanpa overhead, perkalian 32-bit dan setengah atasnya, pembagi, MIN/MAX, SEXT, CLAMPS, S32C1I, MAC16, boolean dan FPU presisi tunggal. Bukti lebih kuat dari sekadar header: crates/xtensa-core/tests/programs.rs memuat build compiler S3 dari program uji yang juga dibangun compiler ESP32 klasik, dan keduanya keluar sama byte demi byte. Jadi S3 menjalankan ABI windowed, persis seperti ESP32 klasik, dengan ENTRY, RETW, ROTW, MOVSP, L32E/S32E dan eksepsi window melalui vektornya masing-masing (docs/esp32.md bagian 4 punya tabel vektor, dan itu milik ISA, bukan chip).
Yang LX7 tambahkan di chip ini adalah ekstensi vektor S3, instruksi EE.* untuk kerja AI dan DSP, yang dienkode assembler di ruang op0 = 4 yang LX6 berikan ke MAC16. Keduanya tidak dimodelkan, dan keduanya menyebabkan fault sebagai instruksi ilegal (crates/xtensa-core/tests/encoding.rs memuat dua enkode dari assembler S3). GCC tidak menghasilkannya dari C biasa.
Interupsi. INTENABLE memasang mask; PS.INTLEVEL menggerbangi. Hanya level 1 yang dimodelkan. Di S3 interupsi level 1 adalah 0 sampai 10, 12, 13, 17 dan 18, mask 0x0006_37FF, dan 19 sampai 21 adalah level 2: diverifikasi terhadap tabel 9.3-2 manual. Tiga pembanding CCOMPARE menaikkan interupsi CPU 6, 15 dan 16, dari tabel yang sama. Runtime merutekan GPIO ke interupsi CPU 13, interupsi periferal level 1, dan mengambil tick delaynya dari CCOMPARE0 pada interupsi CPU 6.
PRID terbaca 0xCDCD, seperti pada model klasik: diyakini. Yang penting adalah bit 13 kosong, itu cara perangkat lunak membedakan core 0 dari core 1.
Sisanya adalah bagian 4 ESP32 klasik tanpa perubahan: CCOUNT adalah hitungan siklus; WSR ke CCOMPARE mempersenjatainya dan menghapus interupsinya; "sudah dicapai atau dilewati" alih-alih "sama"; tenggat yang sudah lewat tidak dipersenjatai; MOVSP tidak pernah menaikkan Alloca; dan FPU presisi tunggal berjalan, seperti di ESP32 klasik (docs/esp32.md bagian 4), jadi float yang dibangun oleh firmware/esp32s3/build.sh mendapat jawaban yang benar. Sketch yang dikompilasi di browser masih soft float (-Xclang -target-feature -Xclang -fp, memanggil mokxi_float.c).
5. Model waktu, probe, poke dan channel host
CPU berjalan di 240 MHz, satu instruksi per siklus. Waktu dihitung ulang dari jumlah siklus, jadi slice 2400 instruksi tepat 10 us. Di dalam sebuah slice, jumlah instruksi adalah jamnya: pembacaan timer, satu byte serial, perubahan pin, dan tepi RMT semuanya jatuh pada instruksi yang menyebabkannya. Inti yang parkir di WAITI tidak bernilai apa pun: board meminta untuk dibangunkan pada yang paling awal dari tenggat CCOMPARE berikutnya, tepi LEDC atau RMT berikutnya, satu byte serial dan jaringan, dan perubahan pin atau byte dari host juga membangunkannya. Pembacaan GPIO_IN_REG setelah sebuah penulisan memindahkan pad dalam slice yang sama mengakhiri slice sebelum pembacaan itu, jadi ia melihat apa yang rangkaian buat dari penulisan tersebut, persis seperti di ESP32 klasik (docs/esp32.md bagian 5). delayMicroseconds() di bawah 50 us menghitung CCOUNT dan tidak pernah lebih pendek dari yang diminta.
probe adalah bitmask dengan warna LED di dalamnya:
| bit | arti |
|---|---|
| 0 | berjalan |
| 1 | parkir di waiti, atau dihentikan oleh debugger |
| 2..19 | warna LED RGB saat terakhir kali menyimpan sebuah frame, enam bit per kanal: merah di 14..19, hijau di 8..13, biru di 2..7 |
LED didekode oleh komponen board dari tepi yang dilaporkan SoC pada pad LED (GPIO48, atau GPIO38 pada v1.1), dengan jendela komponen ws2812: pulsa tinggi di bawah 125 ns adalah glitch, sampai 600 ns adalah 0, sampai 950 ns adalah 1, yang lebih panjang memutus frame, rendah yang lebih pendek dari yang diizinkan bit itu juga memutusnya, dan 50 us rendah menyimpan 24 bit pertama, hijau lebih dulu. LED mempertahankan warnanya melalui reset chip, seperti WS2812, karena ia diberi daya dari board. Dua bit terendah warna per kanal tidak muat dalam probe dan dibuang.
poke: 1 menahan BOOT (GPIO0 rendah), 0 melepaskannya; 2 menahan RST, 3 melepaskannya.
Kanal host membawa kedua port serial board. DevKitC-1 asli punya dua soket: "UART", melalui bridge USB-ke-UART ke UART0, dan "USB", kontroler USB Serial/JTAG milik chip itu sendiri. Di sini serial monitor terpasang ke keduanya sekaligus: host_read memberikan byte yang telah keluar dari UART0 dan byte yang diserahkan port USB, sesuai urutan kedatangannya, dan host_write memasukkan yang diketik ke FIFO penerima UART0 dan ke antrean host port USB sekaligus. Bridge itu sendiri tidak dimodelkan, begitu juga auto-reset lewat DTR dan RTS.
Crash. 1000 trap berturut-turut tanpa kemajuan dan core dinyatakan crash lalu dihentikan, dengan lokasi kematiannya dicatat dan dilaporkan di kanal host.
6. Apa yang diyakini dan tidak diyakini oleh model ini
Diperiksa terhadap manual, datasheet, atau panduan pengguna
Jendela memori (tabel 4.3-1) dan setiap base peripheral (tabel 4.3-3). Setiap offset register dan setiap bit yang disebutkan di bagian 3, blok demi blok: GPIO (6.14 sampai 6.20), IO MUX (6.36 dan tabel 6.12-1, termasuk nilai reset setiap pad dan function 1 yang menjadi GPIO di setiap pin), UART0 (26.6 sampai 26.19), USB Serial/JTAG (33.2 sampai 33.9 dan perilaku di 33.3.3), SYSTIMER (11.1 sampai 11.5 dan clock 16 MHz), SENS (39.10 sampai 39.13), LEDC (35.1 sampai 35.13 dan daftar PARA_UP), RMT (37.1 sampai 37.19, ukuran RAM, format kode pulsa, rumus clock dan tabel 37.3-1), SYSTEM (17.3 sampai 17.7, termasuk LEDC dan RMT yang dimatikan atau gated off saat reset) dan matriks interrupt (tabel 9.3-1 dan ringkasan 9.4). Nomor sinyal GPIO matrix 73 sampai 80 untuk LEDC dan 81 sampai 84 untuk RMT (tabel 6.11-1), dan bahwa output enable kedua peripheral terikat tinggi. Level interrupt CPU dan nomor interrupt komparator (tabel 9.3-2). Peta kanal ADC1 dan rentang efektif dari empat atenuasi (datasheet). Urutan header, GPIO LED RGB di setiap revisi, dan dimensi board (panduan pengguna dan gambar dimensi). Opsi ISA integer (core-isa.h milik toolchain, dan output compiler S3 byte demi byte).
Diyakini, tidak diverifikasi
SCLK_DIV_NUM + 1sebagai pembagi clock inti UART0 (bagian 3.3). Runtime menulis 0 di sana, yang berarti 1 dengan pembacaan ini; rumus yang tercetak di manual tidak punya tambahan satu.- Tata letak RAM RMT per kanal,
0x800 + 192n(bagian 3.8). - Fase carrier: tinggi lebih dulu, dari awal setiap kode (bagian 3.8).
- Pemuatan duty pada
PARA_UP_CHntanpaDUTY_START(bagian 3.7). - Timing paket USB: 12 Mbit/s ditambah tiga belas byte, dan tanpa jeda penjadwalan host (bagian 3.4).
PRID=0xCDCD(bagian 4).
Setiap angka yang bergantung pada runtime disebutkan di satu tempat (firmware/esp32s3/include/esp32s3.h), dan crates/esp32s3/tests/contract.rs menahan header itu dan crates/esp32s3/src/map.rs pada angka yang sama.
Dimodelkan, tetapi tidak dengan angka chipnya
- ADC di
ATTEN3adalah kurva komponen tipikal, bukan unit ini (bagian 3.6): saturasi di sekitar 3,1 V dan lengkungan di atas 2,75 V ada, sebaran antar unit yang dikoreksi kalibrasi eFuse tidak. Atenuasi lainnya adalah garis lurus ke puncak rentang efektifnya. - Satu konversi memakan tepat 5 us, dan tepi LEDC atau RMT jatuh pada pikodetik yang tepat.
GPIO_STRAP_REGadalah konstanta, bukan latch pin saat reset.RSThanya pull-up 10 k; kapasitor power-on tidak dimodelkan.- Tidak ada boot ROM dan tidak ada clock tree. Intinya di 240 MHz dan clock APB di 80 MHz sejak instruksi pertama, dan
SYSTEM_CPU_PER_CONF_REGhanya disimpan dan tidak mengubah apa pun. - Pad USB tidak diambil alih. GPIO19 dan GPIO20 tetap pin biasa dan port USB tetap bekerja meskipun sketch menggerakkannya.
- U0TXD menahan tinggi yang stabil selama UART memilikinya; bit UART adalah kanal host, bukan gelombang di GPIO43.
CCOMPAREmembandingkan "tercapai atau terlampaui", danMOVSPtidak pernah memunculkan Alloca (bagian 4).
Sengaja tidak disertakan
- Inti kedua. Hanya inti 0 yang berjalan; tidak ada interupsi antar inti dan tidak ada FreeRTOS, jadi apa pun yang memulai tugas di inti 1 tidak akan berjalan.
- Ekstensi vektor. Setiap encoding
EE.*fault (bagian 4). FPU dimodelkan. - SRAM0, cache, MMU, flash dan PSRAM. Kode berjalan dari SRAM1.
- Radio WiFi dan Bluetooth, dalam segala bentuk. WiFi yang bisa dijangkau sketch adalah jaringan simulasi dari bagian 3.10.
- RTC, memorinya, koprosesor ULP, deep sleep dan unit manajemen daya.
- ADC2, kontroler ADC digital, DMA, eFuse kalibrasi, sensor suhu dan sensor sentuh.
- Timer grup timer, watchdog RTC dan watchdog interupsi (watchdog grup timer milik bagian 3.11).
- UART1 dan UART2, kontroler I2C dan SPI, I2S, kontroler kamera dan LCD, TWAI, host SD, penghitung pulsa, PWM motor, kontroler USB OTG, GDMA dan akselerator kripto.
WiredanSPImilik runtime adalah software di pin biasa (SDA 8 dan SCL 9, SCK 12, MISO 13, MOSI 11 dan SS 10, bawaan Arduino core untuk board ini), persis seperti di setiap board lain di sini, karena tidak ada model board di sini yang punya kontroler itu. - Kanal terima RMT dan sisanya dari daftar bagian 3.8, dan hardware fade LEDC.
- Matriks interupsi di luar empat sumber, dan setiap level interupsi CPU di atas satu.
Itulah sebabnya binary vendor ESP-IDF dan Arduino-core tidak bisa berjalan di sini, sedangkan firmware yang dibuat untuk dokumen ini bisa.
Gambar firmware untuk tiga board Xtensa tidak bisa dipertukarkan. String program pada katalog berbeda (elf32 xtensa lx7 esp32s3 di sini, elf32 xtensa lx6 esp32 pada DevKit klasik, elf32 xtensa lx106 esp8266 pada NodeMCU), dan perbedaannya nyata: image untuk ESP32 klasik menjalankan instruksi yang sama tetapi dimuat di alamat yang tidak dimiliki chip ini, jadi loader menolaknya.
7. Runtime firmware (firmware/esp32s3/)
Runtime bergaya Arduino: setup() dan loop(), pinMode, digitalWrite, digitalRead, shiftOut, analogRead (dengan analogReadResolution, analogSetAttenuation dan analogSetPinAttenuation), analogWrite dan keluarga ledcAttach/ledcWrite/ledcRead, rgbLedWrite dan neopixelWrite, millis, micros, micros64, delay, delayMicroseconds, attachInterrupt, Serial, USBSerial, map, random. Tanpa Arduino core, tanpa ESP-IDF, tanpa libc. WiFi.h, HTTPClient.h dan WebServer.h adalah runtime jaringan simulasi bersama dari docs/wifi.md.
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.
mokxi_init, sebelum konstruktor statis, mengaktifkan gerbang jam LEDC dan RMT, mengalihkan UART0 ke jam APB pada 115200, dan mengarahkan sumber interupsi GPIO. Setiap penulisan yang mengubah keluaran LEDC diakhiri dengan bit update-nya.
Serial adalah UART0. USBSerial adalah port USB Serial/JTAG: byte masuk ke buffer 64 byte-nya dan driver menulis WR_DONE di setiap baris baru dan di flush(), menunggu buffer kosong daripada kehilangan satu byte.
crt0.S dan support64.c milik ESP32 klasik, dikompilasi ulang untuk board ini daripada disalin: handler jendela, tabel vektor dan entry exception milik ISA, bukan chip. Enam file lainnya milik ESP32-C3, sama seperti pada ESP32 klasik.
Dibangun oleh GCC Espressif untuk S3. deploy/fetch-xtensa.sh esp32s3 meletakkan xtensa-esp32s3-elf-gcc 8.4.0 (esp-2021r2-patch5) di tools/xtensa/, yang di-gitignore. GCC berlisensi GPL, dan tidak ada yang dibangun di sini terhubung dengan libgcc atau bagian toolchain lainnya (runtime-nya -nostdlib dengan kode pendukungnya sendiri), jadi tidak ada kode GPL yang masuk ke ELF yang dikirim. docs/compile.md memuat penjelasan lengkapnya.
Dilink terhadap firmware/esp32s3/link.ld: .text di alamat bus instruksi SRAM1, section data di alamat bus data byte pertama setelahnya, stack di puncak SRAM2. Build menolak image dengan lebih dari 64 KB yang bisa dimuat, dan elfcheck.py menolak image yang kode dan datanya akan berbagi RAM.
Sebelas contoh, masing-masing dengan sketch yang ditampilkan UI-nya: blink (LED RGB warna putih dan LED berkabel di GPIO2), rainbow (LED RGB berputar di roda warna), button (saklar ke ground di GPIO21 dengan pull-up bawaan pad, menyalakan LED di GPIO2), serial (hitungan tiap detik di UART0, dan echo), usbserial (hal yang sama di port USB), fade (LED di GPIO2 memakai LEDC, delapan bit pada 1 kHz), knob (potensiometer di GPIO4, ADC1 channel 3, meredupkan LED di GPIO2 dengan hasil baca mentah yang dicetak), dan empat contoh WiFi: wificonnect, wifiweather, wifiapi dan wifilamp.
crates/esp32s3/tests/runtime.rs menyalakan ELF tersebut dan mengukur: setengah periode blink dalam 5 ms dari 500, frame WS2812 di GPIO48 didekode dan setiap bit punya waktu tinggi dan rendah di dalam jendela datasheet, warna yang dikirim rainbow dalam urutan hijau dulu, periode LEDC dalam 5 us dari 1 ms, millis() dalam 60 ms dari jam kernel selama lima detik, tidak ada dua byte UART0 yang berjarak lebih dekat dari satu waktu byte pada 115200, dan satu baris USB tiba sebagai satu paket. crates/esp32s3/tests/wifi.rs menjalankan contoh WiFi terhadap jaringan simulasi. Setiap test melewati dirinya sendiri saat imagenya belum dibangun.