Tham khảo

Hợp đồng bo mạch ESP32-S3-DevKitC-1 (Boards Wave C)

S3 trên nhân Xtensa LX7: một SRAM nhìn qua hai bus, ma trận GPIO, cổng serial USB, LEDC, RMT phía sau LED RGB, và một nhân trong khi chip có hai nhân.

Đây là tài liệu tham khảo kỹ thuật cho mô hình: nó mô tả những gì được triển khai, thanh ghi này đến thanh ghi khác, dành cho những người viết firmware chạy trên đó. Để dùng bo mạch trong trình soạn thảo, hãy bắt đầu với ESP32-S3-DevKitC-1 và trang bo mạch.

ESP32-S3-DevKitC-1 là bo mạch chính thức của Espressif cho ESP32-S3: một module ESP32-S3-WROOM-1, hai nhân Xtensa LX7 tốc độ 240 MHz, hai cổng micro-USB và một LED RGB addressable. Một linh kiện hạt nhân (esp32s3 trong crates/parts) bao bọc mô hình SoC ESP32-S3 (crates/esp32s3) chạy trên cùng trình thông dịch Xtensa mà ESP32 cổ điển và ESP8266 dùng (crates/xtensa-core). Tài liệu này là bản hợp đồng, và nó được ưu tiên hơn mọi chú thích trong mã nguồn.

Kiểu trong danh mục là esp32s3. Chuỗi program trong danh mục là elf32 xtensa lx7 esp32s3.

Hãy đọc mục 6 trước nếu bạn muốn đưa bản build từ đây lên chip thật. Khác với hợp đồng của ESP32 cổ điển, hầu hết mọi con số ở đây đều được đối chiếu với một trang trong ESP32-S3 Technical Reference Manual (phiên bản 1.8), ESP32-S3 Series Datasheet và hướng dẫn sử dụng cũng như bản vẽ kích thước DevKitC-1 của Espressif. Mục 6 liệt kê một số ít con số chưa được đối chiếu, cùng mọi thứ chưa được mô phỏng: trong đó có nhân thứ hai, phần mở rộng vector, bộ nhớ đệm, flash, PSRAM và cả hai bộ vô tuyến.

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. Chân bo mạch (thứ tự trong danh mục)

Nhìn từ trên, hai cổng micro-USB ở dưới, module WROOM-1 cùng ăng-ten của nó ở trên. Bản vẽ kích thước của Espressif cho biết bo mạch có kích thước 62,74 x 25,40 mm, mỗi dãy header cách mép bo 1,27 mm, nên hai header 22 chân cách nhau 22,86 mm (0,9 inch) và bo mạch gác lên breadboard mà còn trống một hàng lỗ ở mỗi bên. Hình vẽ hiển thị đúng theo kích thước đó.

J1, header bên trái, chân 1 ở trên cùng (22 lỗ): 3V3, 3V3b, RST, 4, 5, 6, 7, 15, 16, 17, 18, 8, 3, 46, 9, 10, 11, 12, 13, 14, 5V, G.

J3, header bên phải, chân 1 ở trên cùng (22 lỗ): Gb, TX, RX, 1, 2, 42, 41, 40, 39, 38, 37, 36, 35, 0, 45, 48, 47, 21, 20, 19, Gc, Gd.

44 chân. Một con số là GPIO n. TX và RX là GPIO43 và GPIO44, UART0. RST là chân chip enable. 5V là đường nguồn 5 V của USB. G là đất. Tên bị trùng sẽ kèm một chữ cái, vì tên chân trong danh mục là duy nhất; lớp in trên bo không in chữ cái này.

Đã kiểm chứng: thứ tự của cả hai header, từng chân một, đối chiếu với bảng J1 và J3 trong hướng dẫn sử dụng (bản hướng dẫn v1.0 và v1.1 cho cùng thứ tự), và vị trí của các hàng chân đối chiếu với bản vẽ kích thước.

GPIO 26 đến 32 không có trên cả hai header. Chúng là SPI flash. GPIO 22 đến 25 không tồn tại trên linh kiện này (bảng chức năng IO MUX không có dòng nào cho chúng). GPIO 33 và 34 cũng không có trên header. crates/parts/src/parts/esp32s3.rs có một test giữ nguyên tất cả các điều này.

GPIO 35, 36 và 37 có trên header, và trên các biến thể có PSRAM bát (DevKitC-1-N8R8 mà đa số người mua) thì chúng là của PSRAM và không được dùng. Mô hình này không có PSRAM, nên ở đây chúng là chân bình thường, và ghi chú trong hướng dẫn sử dụng được nhắc lại trên trang trợ giúp.

GPIO 19 và 20 là D- và D+ của USB trên chip, nối với ổ cắm "USB" của bo mạch. Ở đây chúng vẫn là pad bình thường và cổng USB serial vẫn hoạt động ngay cả khi sketch điều khiển chúng, điều mà bo mạch thật sẽ không làm (mục 3.4).

Các thứ trên bo mạch:

  • 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 là GPIO0, mức thấp kích hoạt; nhấp nó trên bo mạch sẽ nối chân xuống đất. Nó cũng có trên J3 với ký hiệu 0.
  • RST reset chip.
  • Một LED nguồn đỏ 3.3 V, vẽ sáng, vì bo mạch ở đây luôn được cấp qua USB.

Điện: mọi GPIO đẩy kéo ở 3.3 V qua R_STRONG, ở chế độ high-Z, hoặc kéo lên hoặc kéo xuống qua 45 k. Một ngõ vào đọc cao ở 1.65 V (một nửa nguồn I/O); một đường nối xung đột (Unknown) đọc 0, còn đường nối lơ lửng đọc nhiễu, như trên Uno (docs/uno.md mục 1). GPIO0 đọc cao khi không có gì giữ nó, nhờ điện trở kéo lên của bo mạch cạnh nút BOOT. 3V3 xuất 3.3 V qua R_SUPPLY, 5V xuất 5 V, G xuất 0 V. RST có điện trở kéo lên 10 k lên 3.3 V và kéo nó xuống dưới 1.65 V sẽ giữ core trong trạng thái reset. Tụ điện cạnh điện trở đó, mạch power-on reset của bo mạch, không được mô hình hóa.

2. Bản đồ bộ nhớ

SRAM1, bus lệnh 416 KB tại 0x4037_8000 đến 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 và SRAM2, bus dữ liệu 480 KB tại 0x3FC8_8000 đến 0x3FCF_FFFF
đỉnh stack 0x3FD0_0000
UART0 0x6000_0000, mục 3.3
GPIO matrix 0x6000_4000, mục 3.1
SENS 0x6000_8800, mục 3.6
IO MUX 0x6000_9000, mục 3.2
RMT 0x6001_6000, mục 3.8
LEDC 0x6001_9000, mục 3.7
SYSTIMER 0x6002_3000, mục 3.5
USB Serial/JTAG 0x6003_8000, mục 3.4
SYSTEM 0x600C_0000, mục 3.9
Ma trận ngắt 0x600C_2000, mục 3.9

Mỗi khối ngoại vi ở đây chiếm 4 KB, trừ SENS là 2 KB phía trên của khối quản lý điện năng thấp.

Đã kiểm chứng: mọi địa chỉ trong bảng, đối chiếu với bảng 4.3-1 (bộ nhớ trong) và bảng 4.3-3 (ngoại vi) của tài liệu. SENS là "địa chỉ cơ sở Low Power Management + 0x800" theo bảng thanh ghi 39.6.2 của tài liệu.

Một SRAM, hai cửa sổ, và mô hình có cả hai. Tài liệu nói SRAM1 được "CPU đánh địa chỉ qua bus dữ liệu hoặc bus lệnh theo cùng một thứ tự": byte tại 0x4037_8000 + n chính là byte tại 0x3FC8_8000 + n. Mô hình giữ một buffer cho cửa sổ dữ liệu và ánh xạ cửa sổ lệnh vào 416 KB đầu của nó, nên một chương trình có thể đọc chính mã của nó qua bus dữ liệu và nhận đúng các byte, điều mà mô hình ESP32 cổ điển không làm được. SRAM2 chỉ nằm trên bus dữ liệu, ngay sau SRAM1. firmware/esp32s3/link.ld đặt code tại địa chỉ lệnh và bắt đầu các phân đoạn dữ liệu tại địa chỉ bus dữ liệu của byte đầu tiên ngay sau code, nên hai bên không bao giờ dùng chung RAM, và elfcheck.py từ chối ảnh mà trong đó chúng lại dùng chung.

SRAM0, 32 KB tại 0x4037_0000 mà bộ nhớ đệm lệnh có thể lấy, không được mô hình hóa; truy cập vào đó là một 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.

Nhân reset với pc tại điểm vào của ELF và mọi thanh ghi địa chỉ bằng không. Không có boot ROM ở đây: bộ nạp giai đoạn một, các lần đọc flash, cây clock và việc thiết lập cache đều vắng mặt, và runtime tự tạo ra trạng thái nó cần một cách tường minh.

3. Thanh ghi ngoại vi

Chỉ tập con dưới đây được cài đặt. Bất cứ gì khác bên trong một khối đã ánh xạ đều đọc được 0 và tính là truy cập lạc; bất cứ gì ngoài mọi khối là lỗi truy cập.

3.1 Ma trận GPIO (0x6000_4000)

Số GPIO chạy từ 0 đến 48, nên mọi thanh ghi có một bit cho mỗi chân đều gồm hai nửa: thanh ghi thường bao phủ GPIO 0 đến 31 và thanh ghi có 1 bao phủ GPIO 32 đến 48 trong mười bảy bit thấp của nó.

offset thanh ghi
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, được lưu
0x554 + 4n GPIO_FUNCn_OUT_SEL_CFG_REG

Các dạng W1TS của thanh ghi trạng thái, GPIO_CPU_INT_REG/GPIO_CPU_INT1_REG (đọc ra như trạng thái), GPIO_BT_SELECT_REG, GPIO_SDIO_SELECT_REG và GPIO_CLOCK_GATE_REG cũng được đáp ứng.

Đã kiểm chứng: địa chỉ cơ sở và mọi offset, đối chiếu với bảng thanh ghi 6.14.

GPIO_PINn_REG (thanh ghi 6.18): bit 2 PAD_DRIVER đưa pad về mở máng; các bit 7..9 INT_TYPE chọn điều gì kích hoạt ngắt của chân (0 tắt, 1 sườn lên, 2 sườn xuống, 3 mọi sườn, 4 mức thấp, 5 mức cao); bit 13 là bit cho phép ngắt CPU. Đã kiểm chứng.

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 đọc được 0x08: bit 3 (GPIO0) cao, các bit 2, 4 và 5 (GPIO46, GPIO45, GPIO3) thấp, tức là một lần khởi động bình thường từ flash 3.3 V. Phân bổ bit là của thanh ghi 6.15; giá trị ở đây là hằng số, không phải chốt lại trạng thái các chân lúc reset.

3.2 IO MUX (0x6000_9000)

IO_MUX_PIN_CTRL_REG tại 0x00, sau đó mỗi GPIO có một thanh ghi tại 0x04 + 4n. Khác với ESP32 cổ điển, IO MUX của S3 được sắp theo thứ tự GPIO. Bit 7 FUN_WPD, bit 8 FUN_WPU, bit 9 FUN_IE, bit 10..11 FUN_DRV (lưu trữ), bit 12..14 MCU_SEL. Một pad chỉ đến được GPIO_IN_REG khi bộ đệm đầu vào của nó được bật.

Đã kiểm chứng: địa chỉ cơ sở, các offset và các bit, đối chiếu với thanh ghi 6.36; bảng chức năng và giá trị reset đối chiếu với bảng 6.12-1.

MCU_SEL chọn một trong tối đa năm chức năng. Chức năng 1 là ma trận GPIO trên mọi chân. Trên hầu hết chân, chức năng 0 cũng là ma trận GPIO, nhưng trên chân 26 đến 32 đó là flash, trên 39 đến 42 là các chân JTAG, trên 43 và 44 là UART0 và trên 47 và 48 là cặp clock flash, nên một chương trình muốn dùng một trong các chân đó làm GPIO phải đặt MCU_SEL bằng 1. Hàm pinMode của runtime luôn làm vậy. LED RGB trên GPIO48 là một trong số đó: cho đến khi có gì đó đặt MCU_SEL của nó, chẳng có gì chương trình ghi vào ma trận đến được pad đó.

Mọi pad khởi động với giá trị reset của tài liệu. Cột "RST" của bảng 6.12-1: GPIO0 và các chân flash với pull-up, GPIO45 và GPIO46 với pull-down, hầu hết chân chỉ bật buffer vào, còn GPIO 4 đến 8, 15, 16 và 19 đến 21 thậm chí không có cả nó, nên digitalRead trên một chân đó đọc được 0 cho đến khi buffer được bật. MTCK, GPIO39, khởi động với pull-up, đúng như bảng ghi cho một phần mà các pad JTAG của nó chưa bị vô hiệu qua eFuse. GPIO43, U0TXD, khởi động với ngõ ra bật trên UART; dạng sóng của UART không được mô hình hóa (mục 3.3), nên pad đó giữ đường ở mức cao nhàn rỗi cho đến khi chương trình chiếm nó.

3.3 UART0 (0x6000_0000)

offset thanh ghi
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

Đã kiểm chứng: địa chỉ cơ sở và mọi offset (bảng thanh ghi 26.6), cùng các bit dưới đây.

Hai FIFO 128 byte. Các bit 0..9 của UART_STATUS_REG là RXFIFO_CNT và các bit 16..25 là TXFIFO_CNT. Bit 17 RXFIFO_RST và bit 18 TXFIFO_RST của UART_CONF0_REG xóa chúng (thanh ghi 26.9; mô hình ESP32 cổ điển để hai bit này ngược nhau, mục 6). UART_CONF1_REG giữ hai ngưỡng FIFO, mười bit mỗi cái, bằng 96 lúc reset. Các bit 0..11 của UART_CLKDIV_REG là phần nguyên của số chia và các bit 20..23 là phần mười sáu, bằng 694 lúc reset.

Số chia chia cho clock nhân UART, mà các bit 20..21 SCLK_SEL của UART_CLK_CONF_REG chọn: 1 là clock APB 80 MHz, 3 là thạch anh 40 MHz, và thạch anh là giá trị reset (thanh ghi 26.18). Giá trị 2, bộ dao động RC_FAST, không được mô hình hóa và được coi như thạch anh. SCLK_DIV_NUM (các bit 12..19) chia clock nhân cho SCLK_DIV_NUM + 1, điều này được tin là đúng: tài liệu gọi trường này là "phần nguyên của số chia tần số" và in số chia không cộng một, mà lúc reset trường này bằng 1. Runtime đặt SCLK_SEL bằng 1 và SCLK_DIV_NUM bằng 0, khi đó 694 cho 115 274 baud. Phần phân số SCLK_DIV_A/SCLK_DIV_B không được mô hình hóa.

Byte rời khỏi FIFO phát theo tốc độ baud, không tức thời, nên một cổng 115 200 baud truyền được 11 520 byte mỗi giây ở đây như trên bàn thật; crates/esp32s3/tests/runtime.rs kiểm tra rằng không có hai byte nào của ví dụ serial gần nhau hơn một thời gian byte.

UART1 và UART2 không được mô phỏng. Dạng sóng trên chân U0TXD cũng không được mô phỏng: các byte là kênh của máy chủ, không phải các bit trên GPIO43.

3.4 USB Serial/JTAG (0x6003_8000)

Nửa serial của bộ điều khiển: cổng CDC-ACM mà ổ cắm "USB" của bo mạch mang theo, mà sketch có thể truy cập qua USBSerial.

offset thanh ghi
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, được lưu

Đã kiểm chứng: địa chỉ gốc, các offset (bảng thanh ghi 33.5) và các bit: EP1_CONF bit 0 WR_DONE, bit 1 SERIAL_IN_EP_DATA_FREE, bit 2 SERIAL_OUT_EP_DATA_AVAIL (thanh ghi 33.2); INT_* bit 2 SERIAL_OUT_RECV_PKT_INT và bit 3 SERIAL_IN_EMPTY_INT, bit này được set khi reset (thanh ghi 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.

Thời gian trong mô hình này là của riêng mô hình. Tài liệu chỉ nói máy chủ "sẽ kiểm tra định kỳ". Ở đây máy chủ luôn mở một terminal và nhận gói đã flush ngay khi nó có thể vượt qua bus 12 Mbit/s: gói tin cộng thêm mười ba byte token, handshake và đóng khung, tức 51.3 us cho 64 byte. Một máy chủ thật có thể thêm tới một frame (1 ms) do lập lịch; điều đó không được mô phỏng.

Không mô phỏng: nửa JTAG, việc liệt kê thiết bị (enumeration), các ngắt lỗi bus, các yêu cầu reset RTS/DTR và chế độ nạp (download-mode), và suspend. Máy chủ luôn được kết nối.

3.5 SYSTIMER (0x6002_3000)

Đơn vị 0: bộ đếm 52 bit phía sau micros() và millis().

offset thanh ghi
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

Đã kiểm chứng: địa chỉ gốc, các offset (bảng thanh ghi 11.5), các bit (CONF bit 30 TIMER_UNIT0_WORK_EN, được set khi reset; OP bit 30 UPDATE, bit 29 VALUE_VALID) và xung đếm 16 MHz ("XTAL_CLK/2.5, tức 16 MHz", mục 11.4).

Đọc theo kiểu chốt rồi đọc: ghi UPDATE, chờ VALUE_VALID, đọc VALUE_HI và VALUE_LO. Bộ đếm không được đếm: nó chính là thời gian mô phỏng chia cho 62.5 ns, cộng với giá trị nào đó một lệnh nạp đã đặt vào, nên không có gì để nó trôi lệch. Đơn vị 1, ba bộ so sánh và các alarm của chúng không được mô phỏng; nhịp của runtime là CCOMPARE0 của chính nhân (mục 4).

3.6 SENS: ADC1, một lần (0x6000_8800)

Quy đổi do phần mềm khởi động của bộ điều khiển RTC ADC1.

offset thanh ghi bit
0x00 SENS_SAR_READER1_CTRL_REG được lưu
0x0C SENS_SAR_MEAS1_CTRL2_REG bit 0..15 MEAS1_DATA_SAR (chỉ đọc), bit 16 MEAS1_DONE_SAR, bit 17 MEAS1_START_SAR, bit 18 MEAS1_START_FORCE, bit 19..30 SAR1_EN_PAD (một bit cho mỗi kênh), 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

Đã kiểm chứng: địa chỉ cơ sở, ba offset và mọi bit, đối chiếu với thanh ghi 39.10 đến 39.13.

Một lần chuyển đổi: đặt mức suy giảm vào ATTEN1, đặt START_FORCE và EN_PAD_FORCE, đặt bit của kênh vào SAR1_EN_PAD, bật MEAS1_START_SAR, chờ MEAS1_DONE_SAR, đọc dữ liệu. Một lần chuyển đổi mất cố định 5 us thời gian mô phỏng, đây là con số do chính mô hình quy định.

Mười kênh, và kênh n là GPIO n + 1: ADC1_CH0 là GPIO1 và ADC1_CH9 GPIO10 (bảng chân header trong hướng dẫn sử dụng, từng chân một).

Kết quả là mười hai bit của điện áp đường nối tại thời điểm bắt đầu chuyển đổi. Tại ATTEN0 thành ATTEN2 thì nó là round(4095 x Vin / Vtop), bị kẹp, trong đó Vtop là đỉnh của "dải đo hiệu quả" trong datasheet: 850 mV, 1100 mV và 1600 mV. ATTEN3 (12 dB), là suy giảm mặc định khi reset và mặc định của Arduino core, đi theo đường cong thô của một linh kiện điển hình (CURVE_ATTEN3 trong crates/esp32s3/src/adc.rs): gần tuyến tính từ 0 V, cong lại từ khoảng 2750 mV (nơi các phép đo của Espressif cho thấy S3 mất tính tuyến tính) qua dải hiệu quả 2900 mV, và bão hòa tại 4095 từ khoảng 3.1 V. Vì vậy một biến trở nối qua nguồn 3.3 V sẽ đạt 4095 trước một chút khi hết hành trình, và một nửa nguồn (1.65 V) đọc khoảng 2220. Việc hiệu chuẩn eFuse của từng con chip sẽ dịch chuyển giá trị này vài phần trăm, điều này không được mô phỏng. analogReadMilliVolts đảo ngược cùng đường cong đó. Một kênh không nối gì trên chân sẽ dao động, như một ngõ vào nổi (docs/uno.md mục 1).

ADC2, bộ điều khiển digital, DMA, các eFuse hiệu chuẩn và cảm biến nhiệt độ không có.

3.7 LEDC (0x6001_9000)

Tám kênh và bốn timer, tất cả cùng một lớp tốc độ: toàn bộ LEDC của S3.

offset thanh ghi 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 (chỉ ghi)
0x04 + 0x14n LEDC_CHn_HPOINT_REG bit 0..13 HPOINT
0x08 + 0x14n LEDC_CHn_DUTY_REG bit 0..18 chu kỳ duty theo đơn vị một phần mười sáu của một count
0x0C + 0x14n LEDC_CHn_CONF1_REG phần cứng fade: được lưu, không fade gì
0x10 + 0x14n LEDC_CHn_DUTY_R_REG chu kỳ duty đang áp dụng, chỉ đọc
0xA0 + 8n LEDC_TIMERn_CONF_REG bit 0..3 DUTY_RES, bit 4..21 CLK_DIV (Q10.8), bit 22 PAUSE, bit 23 RST (được set khi reset), bit 25 PARA_UP (chỉ ghi)
0xA4 + 8n LEDC_TIMERn_VALUE_REG bộ đếm
0xC0 LEDC_INT_RAW_REG bit n = bộ đếm thời gian n bị tràn
0xC4 LEDC_INT_ST_REG
0xC8 LEDC_INT_ENA_REG đã lưu; không có đường nối nào tới được lõi
0xCC LEDC_INT_CLR_REG
0xD0 LEDC_CONF_REG bit 0..1 APB_CLK_SEL (1, clock APB, là nguồn duy nhất được mô phỏng), bit 31 CLK_EN
0xFC LEDC_DATE_REG đọc được 0x1907_2601

Đã kiểm chứng: địa chỉ cơ sở, mọi offset và mọi bit trong bảng (tóm tắt thanh ghi 35.4 và các thanh ghi 35.1 đến 35.13). Đây là một thay đổi thực sự so với mô hình ESP32 cổ điển, mà bố cục LEDC của nó chỉ mang tính suy đoán.

Một timer đếm 2^DUTY_RES bước đếm ở 80 MHz chia cho CLK_DIV: f = 80e6 / ((CLK_DIV / 256) * 2^DUTY_RES). Ngõ ra của một kênh ở mức cao từ HPOINT trong DUTY >> 4 bước đếm.

Không gì có hiệu lực nếu thiếu bit cập nhật của nó. CLK_DIV và DUTY_RES của timer chờ TIMERn_PARA_UP, còn HPOINT, SIG_OUT_EN, TIMER_SEL và duty của kênh chờ PARA_UP_CHn (các danh sách dưới thanh ghi 35.1 và 35.7). Mô hình tách biệt giá trị đã ghi khỏi giá trị đang có hiệu lực, nên firmware quên bit cập nhật sẽ không có PWM, giống như trên breadboard thật. PAUSE, RST và IDLE_LV có tác dụng ngay lập tức. Duty được liệt kê dưới DUTY_START; mô hình nạp nó khi có PARA_UP_CHn bất kể DUTY_START có được đặt hay không, điều này được cho là đúng với cách một thay đổi duty thông thường hoạt động khi phần cứng fade đang rảnh.

Một kênh đi tới pad qua ma trận GPIO tại OUT_SEL 73 + n (mục 3.1). Bộ đếm là một hàm dạng đóng của thời gian mô phỏng, nên một lõi đang dừng ở waiti không tốn tài nguyên trong khi PWM vẫn chạy; runtime.rs đo chu kỳ của ví dụ fade so với 1 ms của 1 kHz trong ngưỡng 5 us.

Clock của LEDC tắt khi reset (mục 3.9): cho đến khi SYSTEM_LEDC_CLK_EN được đặt, khối này không phản hồi.

Không được mô phỏng: phần cứng duty-fade, bộ đếm tràn, các nguồn clock khác ngoài APB, và đường tín hiệu của LEDC vào ma trận ngắt.

3.8 RMT (0x6001_6000)

Bốn kênh phát của ngoại vi điều khiển từ xa: thứ điều khiển RGB LED.

offset thanh ghi bit
0x00 + 4n RMT_CHnDATA_REG write: đẩy một word vào RAM của kênh n qua FIFO của 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 địa chỉ đọc, bit 11..20 địa chỉ ghi APB, bit 22..24 trạng thái, 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 mức thấp, bit 16..31 mức cao, mỗi bên 0x40 khi 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 đọc được 0x0210_1181
0x800 đến 0xDFF RAM 384 word

Các thanh ghi của kênh nhận (0x30 đến 0x4C, 0x60 đến 0x6C, 0x90 đến 0x9C, 0xB0 đến 0xBC) được lưu và đọc lại chứ không nhận gì cả.

Đã kiểm chứng: địa chỉ cơ sở, mọi offset và bit trong bảng (tóm tắt thanh ghi 37.5, thanh ghi 37.1 đến 37.19), kích thước RAM và điểm bắt đầu NONFIFO của nó tại "địa chỉ cơ sở RMT + 0x800", định dạng mã xung (chu kỳ ở bit 0..14 và 16..30, mức ở bit 15 và 31, "giá trị nhỏ nhất của chu kỳ là số không và được hiểu là dấu hiệu kết thúc truyền"), clock của kênh (rmt_sclk chia cho DIV_CNT, "giá trị 0 tượng trưng cho bộ chia 256", và rmt_sclk là nguồn chia cho SCLK_DIV_NUM + 1 + A/B), giá trị reset (carrier bật, MEM_SIZE 1, DIV_CNT 2), và danh sách các trường phải chờ CONF_UPDATE (bảng 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.

Một lần truyền làm gì, theo mục 37.3.4: TX_START phát từ đầu khối của kênh, mỗi code giữ mức của nó trong period xung clock kênh; gặp dấu kết thúc thì kênh dừng, bật TX_END và giữ mức của dấu kết thúc, hoặc IDLE_OUT_LV nếu IDLE_OUT_EN được bật; chạy hết MEM_SIZE khối mà không có dấu kết thúc thì dừng với MEM_EMPTY và ERR, trừ khi chế độ wrap đưa nó quay lại từ đầu, khi đó TX_THR_EVENT bật lên mỗi khi thêm TX_LIM word nữa đã đi qua; chế độ liên tục bắt đầu lại ở mọi dấu kết thúc, đếm số vòng lặp khi được yêu cầu. TX_STOP dừng ngay lập tức.

Cập nhật cấu hình. DIV_CNT, IDLE_OUT_EN, IDLE_OUT_LV, TX_CONTI_MODE, TX_STOP, các trường carrier và ba trường của TX_LIM chỉ có hiệu lực khi có CONF_UPDATE (bảng 37.3-1); mô hình giữ chúng tách biệt cho đến lúc đó. MEM_SIZE, chế độ wrap và TX_START có tác dụng ngay lập tức.

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.

Đầu ra là một hàm tường minh của thời gian giữa các ranh giới code, nên mỗi sườn xung rơi đúng đến từng picogiây và một lõi đang nghỉ không tốn gì trong khi một khung được phát ra. runtime.rs giải mã các khung của ví dụ blink và rainbow trên GPIO48 và kiểm tra mọi thời gian cao và thấp theo các cửa sổ trong tài liệu WS2812B.

Clock của RMT tắt ở trạng thái reset (mục 3.9).

Không được mô phỏng: các kênh nhận, DMA trên kênh 3, khởi động đồng thời, quyền sở hữu và nguồn của RAM, và các quy tắc chu kỳ tối thiểu (công thức 37.1 và 37.3).

3.9 SYSTEM (0x600C_0000) và ma trận ngắt (0x600C_2000)

offset thanh ghi
0x10 SYSTEM_CPU_PER_CONF_REG, được lưu
0x18 SYSTEM_PERIP_CLK_EN0_REG
0x1C SYSTEM_PERIP_CLK_EN1_REG, được lưu
0x20 SYSTEM_PERIP_RST_EN0_REG
0x24 SYSTEM_PERIP_RST_EN1_REG, được lưu

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.

Ma trận ngắt: thanh ghi ánh xạ của nguồn n cho nhân 0 nằm ở 0x600C_2000 + 4n, và năm bit thấp đặt tên ngắt CPU mà nguồn đó phát ra. Đã kiểm chứng theo bảng 9.3-1 và bảng thanh ghi 9.4, như cả bốn số nguồn mà mô hình này định tuyến:

nguồn số
GPIO_INTERRUPT_CPU 16
UART_INTR 27
RMT_INTR 40
USB_DEVICE_INT 96

Một nguồn được ánh xạ vào một trong các ngắt nội của nhân (6, 7, 11, 15, 16 hoặc 29) sẽ không tới đâu, đây chính là cách tài liệu chỉ định để tắt một nguồn (mục 9.3.3.3). Mọi thanh ghi ánh xạ khác đều được lưu và đọc lại, và không định tuyến gì.

3.10 Hộp thư mạng Mokxi (0x6FFF_E000)

Khối này không phải của ESP32-S3. Mọi địa chỉ khác trong tài liệu này là của con chip. Còn địa chỉ này là của riêng Mokxi: mạng mô phỏng của crates/net, tại một địa chỉ S3 bỏ trống. Tài liệu đặt các ngoại vi tại "0x6000_0000~0x600D_0FFF" và bộ nhớ RTC FAST kết thúc ở 0x600F_FFFF, nên một image dùng khối này sẽ gây lỗi trên chip thật thay vì đọc thanh ghi của ngoại vi khác. Lỗi đó là câu trả lời trung thực, vì thứ phía sau khối này không tồn tại trên chip. Đây cũng là địa chỉ mà các mô hình ESP32-C3 và C6 dùng, vì ba con chip để hở cùng một khoảng trống.

Khối này không phát ngắt nào cả. Mọi nguồn khác ở đây đến nhân qua ma trận ngắt của mục 3.9, và số nguồn ma trận là của con chip; không có con số trung thực nào để cấp cho một ngoại vi mà chip không có, nên hộp thư không được cấp số nào. NET_INT_RAW_REG vẫn đọc được, firmware vẫn poll, và một nhân đang nằm trong waiti vẫn được đánh thức khi mạng có điều cần nói, giống như nó được đánh thức cho một sườn xung PWM.

Ở đây không có radio, không có 802.11 và không có internet thật. Không có gì trong mô hình phát sóng, quét, kết nối, mã hóa hay mở socket: mật khẩu được so sánh như một chuỗi, một tên không nằm dưới .mokxi sẽ không phân giải được, và các origin mà mạng phục vụ là các hàm trong crates/net/src/http.rs. Hộp thư có hình dạng của đường nối thật chứ không phải một câu chuyện hư cấu về MAC: trên một ESP32-S3 thật, phần cứng WiFi nằm sau một blob nhị phân đóng với giao diện lệnh, và WiFi.h của Arduino cuối cùng nằm ở bên kia của một trong các blob đó. docs/wifi.md là hợp đồng cho những gì nằm phía sau nó; phần này chỉ là các thanh ghi.

Một thanh ghi lệnh, một thanh ghi trạng thái, một vòng đệm 4096 byte cho mỗi chiều và một bit ngắt. Ghi vào NET_CMD_REG sẽ chạy lệnh; một lệnh mất thời gian mô phỏng sẽ bật BUSY và xóa nó, kèm DONE trong NET_INT_RAW_REG, khi hoàn tất.

offset tên bit
0x00 NET_ID_REG đọc ra 0x494B4F4D, và không thanh ghi nào khác đọc ra giá trị đó. Một sketch muốn biết mình có đang chạy trên Mokxi hay không sẽ đọc giá trị này; trên silicon thì lần truy cập này sẽ gây fault
0x04 NET_CMD_REG ghi một mã lệnh (bảng dưới đây); khi ghi, mã lệnh sẽ được chạy
0x08 NET_ARG_REG một từ đối số, đọc lại được: cổng cho LISTEN, trạng thái cho REPLY
0x0C NET_STATUS_REG bit 0 BUSY, bit 1 ERR, bit 2 RX_READY, bit 3 LINK, bit 4 SERVE, bits 8..11 STATE
0x10 NET_RESULT_REG câu trả lời của lệnh cuối cùng
0x14 NET_INT_RAW_REG bit 0 DONE, bit 1 EVENT
0x18 NET_INT_ENA_REG cùng hai bit đó
0x1C NET_INT_CLR_REG ghi 1 để xóa, cùng hai bit đó
0x20 NET_TX_LEN_REG số byte đã xếp vào vòng đệm gửi đi
0x24 NET_TX_DATA_REG ghi: đẩy một byte (bit 0..7) vào bộ đệm vòng đi ra
0x28 NET_RX_LEN_REG số byte đang chờ trong bộ đệm vòng vào
0x2C NET_RX_DATA_REG đọc: lấy một byte từ vòng đệm vào, giá trị 0 khi rỗng
0x30 NET_RING_LEN_REG dung lượng mỗi ring tính bằng byte, để firmware khỏi phải ghi cứng 4096
0x40 NET_BT_CMD_REG Bluetooth: ghi một mã lệnh Bluetooth (docs/bluetooth.md); lệnh ghi sẽ chạy nó
0x44 NET_BT_ARG_REG Bluetooth: một từ đối số, đọc lại được; một sự kiện để lại số của nó ở đây
0x48 NET_BT_RESULT_REG Bluetooth: câu trả lời của lệnh Bluetooth cuối
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: các byte đã được xếp vào hàng đợi vòng gửi ra riêng của nó
0x54 NET_BT_TX_DATA_REG Bluetooth: ghi: đẩy một byte vào bộ đệm vòng đó
0x58 NET_BT_RX_LEN_REG Bluetooth: số byte đang chờ trong bộ đệm vòng vào riêng của nó
0x5C NET_BT_RX_DATA_REG Bluetooth: đọc: lấy một byte ra, giá trị 0 khi rỗng

Tám thanh ghi NET_BT_ là nửa Bluetooth của khối, với các vòng đệm riêng: chỉ Bluetooth LE, như trên chip thật, nên các lệnh Classic đặt BT_ERR. Cũng không có sóng radio nào phía sau chúng; docs/bluetooth.md là hợp đồng của chúng.

STATE là nơi trạm đang ở: 0 rảnh, 1 đang khởi động, 2 đang kết nối, 3 đã kết nối, 4 thất bại, 5 không có mạng đó. NET_CMD_STATUS chuyển cùng thông tin đó thành mã wl_status_t của Arduino mà một sketch đọc từ WiFi.status().

NET_CMD_REG tên tác dụng
0 NOP không có gì
1 RESET ngắt kết nối, bỏ cả hai ring, bỏ mọi request
2 CONNECT vòng đệm gửi đi giữ ssid\0password; báo BUSY trong một đến ba giây
3 DISCONNECT bỏ liên kết và địa chỉ
4 STATUS NET_RESULT_REG = mã wl_status_t
5 IP NET_RESULT_REG = địa chỉ được cấp, octet đầu ở byte thấp
6 RSSI NET_RESULT_REG = cường độ tín hiệu theo dBm, giãn dấu
7 SSID vòng vào nhận tên của điểm truy cập
8 MAC ring vào nhận sáu byte MAC của bo mạch
9 REQUEST ring đi ra giữ method\0url\0headers\0body; kích hoạt BUSY
10 POLL NET_RESULT_REG = 0 khi đang thực hiện, sau đó là trạng thái HTTP, hoặc một mã lỗi âm khi ERR lên mức cao; phần thân được ghi vào vòng đệm nhận
11 LISTEN lắng nghe trên cổng ghi trong NET_ARG_REG
12 ACCEPT NET_RESULT_REG = 1 và vòng đệm vào chứa method\0path\0query\0body, hoặc 0 khi không có gì đang chờ
13 REPLY trả lời request đã được chấp nhận với trạng thái ghi trong NET_ARG_REG; ring đi ra giữ content-type\0body
14 STOP ngừng lắng nghe
15 WL_GPIO_SET điều khiển các chân GPIO riêng của linh kiện không dây từ NET_ARG_REG. Không phải bo mạch này: bộ phát vô tuyến của linh kiện này không có chân như vậy, nên nó bật ERR và không điều khiển gì cả. Đây là đường đi của đèn LED trên bo mạch Pico W (docs/picow.md mục 3.8)
16 WL_GPIO_GET đọc lại chúng, và cũng có ERR ở đây
17 BLYNK một thao tác trên máy chủ Blynk được mô phỏng, thao tác nằm trong NET_ARG_REG cùng các trường của nó trong ring đi ra; được trả lời ngay trong NET_RESULT_REG, với ERR bật mà không qua mạng (docs/wifi.md, "Blynk")
19 ETH Ethernet có dây (firmware/include/ETH.h), thao tác trong NET_ARG_REG: 1 kích hoạt kết nối qua một dây cáp mô phỏng, không có SSID và không có mật khẩu, kết nối lại sau 1,5 s với cùng một lease; 2 đặt 1 vào NET_RESULT_REG khi kết nối (hoặc lần gần nhất) là kiểu có dây. Chỉ có một kết nối duy nhất: STATUS, IP và mọi yêu cầu đều đọc nó bất kể nó được thiết lập theo cách nào
20 SOFTAP soft AP (crates/net/src/softap.rs, docs/wifi.md), thao tác trong NET_ARG_REG: 1 kích hoạt nó (ring đi ra chứa ssid\0password\0 và byte kênh; NET_RESULT_REG bằng 1, hoặc 0 với ERR nếu tên rỗng hoặc mật khẩu dài một đến bảy ký tự), 2 tắt nó, 3 cấu hình nó (địa chỉ, gateway và netmask, mỗi thứ bốn byte), 4 địa chỉ của nó (bằng 0 khi tắt), 5 các trạm đã tham gia, 6 các lượt tham gia, lượt rời đi và bit báo bật mà runtime biến thành sự kiện, 7 và 8 khởi động (tên, một byte rỗng, địa chỉ) và dừng máy chủ DNS của captive portal, 9 tên của nó vào ring vào, 10 địa chỉ của điện thoại, 11 phần Host của yêu cầu đang được phục vụ vào ring vào. Trạm duy nhất chính là điện thoại của bảng Web

Các mã POLL âm: -1 tên không phân giải được, -2 trạm chưa được kết hợp, -3 https:// và TLS không được mô phỏng, -4 phần thân dài hơn ring, -5 một URL mà mạng này không phân tích được, -6 đã có một yêu cầu đang thực thi. firmware/include/HTTPClient.h biến chúng thành các mã theo kiểu Arduino để sketch so sánh, và docs/wifi.md liệt kê ánh xạ đó.

Thời gian, tất cả thuộc về chính mô hình này và đều được nêu trong docs/wifi.md: một lượt kết hợp mất từ một đến ba giây, được quyết định từ SSID để một bài học mất đúng thời gian đó ở lần thứ hai; mật khẩu sai trở thành WL_CONNECT_FAILED sau năm giây; một yêu cầu đến một nguồn mô phỏng quay lại sau 60 ms; một yêu cầu vào chính máy chủ của sketch mà sketch không bao giờ trả lời sẽ bị mạng đóng với mã 504 sau mười giây.

3.11 Watchdog của các nhóm timer, reset của RTC_CNTL và bộ theo dõi ngăn xếp

Giống như của C3 (docs/esp32c3.md mục 3.9), với bố cục của S3: không có WDT_CONF_UPDATE_EN (một lệnh ghi có hiệu lực ngay lập tức), bit ngắt của watchdog là bit 2, nó đến core qua ma trận ngắt (các nguồn 52 và 55; runtime ánh xạ 52 sang ngắt CPU 17), các thanh ghi lưu ở 0x50..0x5C và 0xC0..0xCC, và SP_MIN của ASSIST_DEBUG nằm xa hơn một thanh ghi (0x3C). Bộ theo dõi ngăn xếp kiểm tra ENTRY, nơi mà code kiểu windowed di chuyển ngăn xếp mỗi lần gọi; một lỗi so với giới hạn đã bị mở rộng sau đó sẽ được thử lại thay vì được báo cáo.

Runtime chạy task watchdog của ESP-IDF trên watchdog của nhóm timer 0, đúng như ESP-IDF làm (firmware/src/main.cpp): tick 500 micro-giây, giai đoạn 0 là một ngắt khi hết thời gian chờ và giai đoạn 1 là một lượt reset hệ thống ở gấp đôi thời gian đó, được khởi động trước setup() với 5 giây kèm panic, theo dõi tác vụ nhàn rỗi của nhân 0. Sketch chạy trên nhân 1, tác vụ nhàn rỗi của nó không bị theo dõi trừ khi nó tự yêu cầu (enableCore1WDT()), nên một vòng lặp không bao giờ nhường quyền vẫn chạy tiếp, đúng như trên bo mạch thật. Ngắt in ra các dòng của ESP-IDF ("E (…) task_wdt: Task watchdog got triggered. …", các tác vụ, "Aborting.", dòng abort và "Rebooting..."), để lại gợi ý ESP_RST_TASK_WDT của ESP-IDF trong thanh ghi lưu trữ RTC và reset CPU qua lượt reset bằng phần mềm, nên esp_reset_reason() trả về 6 sau đó. esp_task_wdt_*, enableLoopWDT() và enable/disableCore0WDT() tác động lên nó. Watchdog của nhóm timer 1 được mô phỏng theo cách tương tự và không có gì trong runtime kích hoạt nó: interrupt watchdog không được mô phỏng.

4. Phần lõi: LX7, ABI nào, và một ngắt đến như thế nào

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.

Với mọi thứ trình biên dịch phát ra, LX7 ở đây chính là LX6. Các header cấu hình của hai toolchain (core-isa.h trong xtensa-esp32-elf và xtensa-esp32s3-elf) thống nhất trên mọi tùy chọn nguyên quyết định trình biên dịch phát ra code gì: sáu mươi tư thanh ghi địa chỉ và cửa sổ thanh ghi, vòng lặp zero-overhead, phép nhân 32-bit và nửa cao của nó, bộ chia, MIN/MAX, SEXT, CLAMPS, S32C1I, MAC16, các boolean và FPU đơn chính xác. Và bằng chứng còn mạnh hơn cả các header: crates/xtensa-core/tests/programs.rs chứa bản build của trình biên dịch S3 cho chương trình thử nghiệm mà trình biên dịch của ESP32 cổ điển cũng đã build, và hai bản giống nhau từng byte một. Vì vậy S3 chạy ABI windowed, hệt như ESP32 cổ điển, với ENTRY, RETW, ROTW, MOVSP, L32E/S32E và các ngoại lệ cửa sổ qua các vector riêng của chúng (docs/esp32.md mục 4 có bảng vector, và đó là của ISA, không phải của chip).

Những gì LX7 thêm trên chip này là phần mở rộng vector của S3, các lệnh EE.* cho công việc AI và DSP, mà assembler mã hóa trong không gian op0 = 4 mà LX6 dành cho MAC16. Cả hai đều không được mô hình hóa, và cả hai đều gây lỗi như lệnh bất hợp pháp (crates/xtensa-core/tests/encoding.rs chứa hai cách mã hóa của assembler S3). GCC không phát ra chúng từ C thông thường.

Ngắt. INTENABLE che; PS.INTLEVEL chặn. Chỉ level 1 được mô hình hóa. Trên S3, các ngắt level 1 là 0 đến 10, 12, 13, 17 và 18, mặt nạ 0x0006_37FF, và 19 đến 21 là level 2: đã kiểm chứng với bảng 9.3-2 của tài liệu hướng dẫn. Ba bộ so sánh CCOMPARE phát ra các ngắt CPU 6, 15 và 16, từ chính bảng đó. Runtime định tuyến GPIO đến ngắt CPU 13, một ngắt ngoại vi level 1, và lấy nhịp độ trễ từ CCOMPARE0 trên ngắt CPU 6.

PRID đọc được 0xCDCD, như trên mô hình cổ điển: được tin là đúng. Điều quan trọng là bit 13 được xóa, đó là cách phần mềm phân biệt core 0 với core 1.

Phần còn lại là mục 4 của ESP32 cổ điển không đổi: CCOUNT là số chu kỳ; một WSR vào CCOMPARE sẽ kích hoạt nó và xóa ngắt của nó; "đạt đến hoặc vượt qua" thay vì "bằng"; một mốc đã qua thì không được kích hoạt; MOVSP không bao giờ phát sinh Alloca; và FPU đơn chính xác chạy được, như trên ESP32 cổ điển (docs/esp32.md mục 4), nên một float được build bằng firmware/esp32s3/build.sh cho ra kết quả đúng. Một sketch được build trong trình duyệt vẫn là soft float (-Xclang -target-feature -Xclang -fp, gọi vào mokxi_float.c).

5. Mô hình thời gian, que đo, poke và kênh máy chủ

CPU chạy ở 240 MHz, mỗi chu kỳ một lệnh. Thời gian được tính lại từ số chu kỳ, nên một lát 2400 lệnh đúng bằng 10 us. Bên trong một lát, số lệnh chính là đồng hồ: một lệnh đọc timer, một byte serial, một thay đổi trên chân và một sườn RMT đều rơi đúng vào lệnh gây ra chúng. Một core đang nằm ở WAITI không tốn gì: bo mạch yêu cầu được đánh thức ở thời điểm sớm nhất trong các mốc tiếp theo là hạn CCOMPARE, sườn LEDC hoặc RMT kế tiếp, một byte serial và mạng, còn một thay đổi trên chân hay một byte từ host cũng đánh thức nó. Một lệnh đọc GPIO_IN_REG sau khi một lệnh ghi đã di chuyển một pad trong cùng lát sẽ kết thúc lát trước khi đọc, nên nó thấy được kết quả lệnh ghi trên mạch, đúng như trên ESP32 đời đầu (mục 5 trong docs/esp32.md). delayMicroseconds() dưới 50 us đếm CCOUNT và không bao giờ ngắn hơn yêu cầu.

probe là một bitmask chứa màu của LED:

bit ý nghĩa
0 đang chạy
1 nằm ở waiti, hoặc bị trình gỡ lỗi dừng
2..19 màu của LED RGB khi nó chốt khung hình lần cuối, mỗi kênh sáu bit: đỏ ở 14..19, xanh lá ở 8..13, xanh dương ở 2..7

LED được giải mã bởi linh kiện bo mạch từ các sườn mà SoC báo cáo trên pad của LED (GPIO48, hoặc GPIO38 trên bản v1.1), với các cửa sổ của linh kiện ws2812: xung cao dưới 125 ns là nhiễu, đến 600 ns là bit 0, đến 950 ns là bit 1, dài hơn thì mất khung, mức thấp ngắn hơn mức bit cho phép cũng làm mất khung, và 50 us mức thấp sẽ chốt 24 bit đầu tiên, xanh lá trước. LED giữ nguyên màu qua một lần reset chip, như một WS2812 thật, vì nó được cấp nguồn từ bo mạch. Hai bit thấp của mỗi kênh màu không vừa với một que đo nên bị bỏ đi.

poke: 1 giữ BOOT (GPIO0 thấp), 0 nhả nó ra; 2 giữ RST, 3 nhả nó.

Kênh host mang cả hai cổng serial của bo mạch. Một DevKitC-1 thật có hai ổ cắm: "UART", qua cầu nối USB-to-UART tới UART0, và "USB", là chính bộ điều khiển USB Serial/JTAG của chip. Ở đây serial monitor được nối vào cả hai cùng lúc: host_read trả về các byte đã rời UART0 và các byte cổng USB đã nhận, theo thứ tự đến, còn host_write đưa những gì được gõ vào cả FIFO nhận của UART0 và hàng đợi host của cổng USB. Bản thân cầu nối USB-to-UART không được mô phỏng, và auto-reset qua DTR và RTS cũng không.

Sập. 1000 bẫy liên tiếp mà không tiến lên nào thì core bị coi là đã sập và dừng lại, vị trí nó chết được ghi lại và báo lên kênh host.

6. Những gì mô hình này chắc chắn, và những gì thì không

Được đối chiếu với tài liệu hướng dẫn, datasheet hoặc sổ tay người dùng

Các cửa sổ bộ nhớ (bảng 4.3-1) và mọi địa chỉ cơ sở của ngoại vi (bảng 4.3-3). Mọi offset thanh ghi và mọi bit được nêu tên ở mục 3, từng khối một: GPIO (6.14 đến 6.20), IO MUX (6.36 và bảng 6.12-1, gồm cả giá trị reset của mọi pad và hàm 1 là GPIO trên mọi chân), UART0 (26.6 đến 26.19), USB Serial/JTAG (33.2 đến 33.9 và hành vi ở 33.3.3), SYSTIMER (11.1 đến 11.5 và đồng hồ 16 MHz), SENS (39.10 đến 39.13), LEDC (35.1 đến 35.13 và các danh sách PARA_UP), RMT (37.1 đến 37.19, kích thước RAM, định dạng mã xung, công thức đồng hồ và bảng 37.3-1), SYSTEM (17.3 đến 17.7, gồm cả việc LEDC và RMT bị chặn khi reset) và ma trận ngắt (bảng 9.3-1 và tóm tắt 9.4). Số hiệu tín hiệu của ma trận GPIO từ 73 đến 80 cho LEDC và từ 81 đến 84 cho RMT (bảng 6.11-1), và việc cho phép xuất của cả hai ngoại vi đều bị buộc cao. Các mức ngắt của CPU và số ngắt của các bộ so sánh (bảng 9.3-2). Bản đồ kênh ADC1 và dải hiệu dụng của bốn mức suy giảm (datasheet). Thứ tự header, GPIO của LED RGB trên từng phiên bản, và kích thước bo mạch (sổ tay người dùng và bản vẽ kích thước). Các tùy chọn ISA số nguyên (file core-isa.h của các toolchain, và kết quả biên dịch của trình biên dịch S3 khớp từng byte một).

Tin là đúng, chưa kiểm chứng

  • SCLK_DIV_NUM + 1 là bộ chia clock của UART0 (mục 3.3). Runtime ghi 0 vào đó, tức là 1 theo cách đọc này; công thức in trong tài liệu không có cộng một.
  • Bố cục RAM RMT cho mỗi kênh, 0x800 + 192n (mục 3.8).
  • Pha của sóng mang: cao trước, tính từ đầu mỗi mã (mục 3.8).
  • Nạp chu kỳ nhiệm vụ trên PARA_UP_CHn không kèm DUTY_START (mục 3.7).
  • Thời gian gói USB: 12 Mbit/s cộng mười ba byte, và không độ trễ lập lịch của host (mục 3.4).
  • PRID = 0xCDCD (mục 4).

Mọi con số mà runtime dựa vào đều được đặt tên ở một nơi (firmware/esp32s3/include/esp32s3.h), và crates/esp32s3/tests/contract.rs giữ cho header đó và crates/esp32s3/src/map.rs khớp cùng những con số.

Được mô hình hóa, nhưng không theo đúng số liệu của chip

  • ADC ở mức ATTEN3 là đường cong của một linh kiện điển hình, không phải của riêng đơn vị này (mục 3.6): bão hòa ở khoảng 3.1 V và điểm gãy trên 2.75 V có mặt, còn mức chênh lệch giữa các đơn vị mà hiệu chuẩn eFuse bù lại thì không. Các mức suy giảm khác là đường thẳng đến đỉnh của dải hiệu dụng.
  • Một lần chuyển đổi mất đúng 5 us, và một cạnh LEDC hoặc RMT rơi đúng xuống từng picosecond.
  • GPIO_STRAP_REG là một hằng số, không phải chốt trạng thái chân lúc reset.
  • RST chỉ có một điện trở kéo lên 10 k; tụ lúc cấp nguồn không được mô hình hóa.
  • Không có boot ROM và không có cây clock. Core chạy ở 240 MHz và clock APB ở 80 MHz ngay từ lệnh đầu tiên, và SYSTEM_CPU_PER_CONF_REG được lưu nhưng không thay đổi gì.
  • Các pad USB không bị chiếm dụng. GPIO19 và GPIO20 vẫn là các chân thông thường và cổng USB vẫn hoạt động ngay cả khi sketch điều khiển chúng.
  • U0TXD giữ mức cao ổn định khi UART còn kiểm soát nó; các bit của UART là kênh host, không phải dạng sóng trên GPIO43.
  • CCOMPARE so sánh "đã đến hoặc đã qua", và MOVSP không bao giờ kích hoạt Alloca (mục 4).

Cố ý bỏ khỏi mô hình

  • Core thứ hai. Chỉ core 0 chạy; không có ngắt chéo core và không có FreeRTOS, nên bất cứ gì khởi chạy task trên core 1 sẽ không chạy.
  • Phần mở rộng vector. Mọi mã hóa EE.* đều gây fault (mục 4). FPU được mô hình hóa.
  • SRAM0, cache, MMU, flash và PSRAM. Code chạy từ SRAM1.
  • Radio WiFi và Bluetooth, dưới mọi hình thức. WiFi mà sketch tiếp cận là mạng mô phỏng của mục 3.10.
  • RTC, các bộ nhớ của nó, các đồng xử lý ULP, chế độ ngủ sâu và đơn vị quản lý nguồn.
  • ADC2, bộ điều khiển ADC kỹ thuật số, DMA, các eFuse hiệu chuẩn, cảm biến nhiệt độ và cảm biến chạm.
  • Các bộ đếm thời gian của nhóm timer, watchdog của RTC và watchdog ngắt (các watchdog của nhóm timer là của mục 3.11).
  • UART1 và UART2, các bộ điều khiển I2C và SPI, I2S, bộ điều khiển camera và LCD, TWAI, host SD, bộ đếm xung, PWM động cơ, bộ điều khiển USB OTG, GDMA và các bộ tăng tốc mã hóa. Wire và SPI của runtime là phần mềm trên các chân thông thường (SDA 8 và SCL 9, SCK 12, MISO 13, MOSI 11 và SS 10, mặc định của Arduino core cho bo mạch này), giống hệt như trên mọi bo mạch khác ở đây, vì không mô hình bo mạch nào ở đây có các bộ điều khiển đó.
  • Các kênh nhận của RMT và phần còn lại trong danh sách của mục 3.8, cùng với phần cứng fade của LEDC.
  • Ma trận ngắt vượt quá bốn nguồn, và mọi mức ngắt của CPU trên mức một.

Đó là lý do các file nhị phân ESP-IDF và Arduino-core của hãng không chạy được ở đây, còn firmware biên dịch cho tài liệu này thì chạy được.

Ảnh (image) của ba bo mạch Xtensa không dùng thay thế cho nhau được. Chuỗi program trong catalog khác nhau (elf32 xtensa lx7 esp32s3 ở đây, elf32 xtensa lx6 esp32 trên DevKit cổ điển, elf32 xtensa lx106 esp8266 trên NodeMCU), và sự khác biệt này là có thật: một image cho ESP32 cổ điển chạy cùng tập lệnh nhưng được nạp vào các địa chỉ mà chip này không có, nên bộ nạp sẽ từ chối.

7. Phần chạy firmware (firmware/esp32s3/)

Một runtime dạng Arduino: setup() và loop(), pinMode, digitalWrite, digitalRead, shiftOut, analogRead (kèm analogReadResolution, analogSetAttenuation và analogSetPinAttenuation), analogWrite và họ hàm ledcAttach/ledcWrite/ledcRead, rgbLedWrite và neopixelWrite, millis, micros, micros64, delay, delayMicroseconds, attachInterrupt, Serial, USBSerial, map, random. Không có Arduino core, không có ESP-IDF, không có libc. WiFi.h, HTTPClient.h và WebServer.h là runtime mô phỏng mạng dùng chung của 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, chạy trước các hàm dựng tĩnh, bật cổng clock của LEDC và RMT, chuyển UART0 sang clock APB ở 115200, và dẫn nguồn ngắt GPIO. Mọi thao tác ghi làm thay đổi đầu ra LEDC đều kết thúc bằng bit cập nhật của nó.

Serial là UART0. USBSerial là cổng USB Serial/JTAG: các byte đi vào bộ đệm 64 byte của nó và driver ghi WR_DONE tại mỗi ký tự xuống dòng và trong flush(), chờ bộ đệm rảnh thay vì mất một byte.

crt0.S và support64.c là của ESP32 cổ điển, được biên dịch lại cho bo mạch này thay vì sao chép: các trình xử lý window, bảng vector và điểm vào exception là của ISA chứ không phải của chip. Sáu file nữa là của ESP32-C3, giống như trên ESP32 cổ điển.

Được build bằng GCC của Espressif cho S3. deploy/fetch-xtensa.sh esp32s3 đặt xtensa-esp32s3-elf-gcc 8.4.0 (esp-2021r2-patch5) vào tools/xtensa/, đã được gitignore. GCC là phần mềm GPL, và không thứ gì nó build ở đây liên kết với libgcc hay bất kỳ phần nào khác của toolchain (phần chạy là -nostdlib với mã hỗ trợ riêng của nó), nên không có mã GPL nào lọt vào một ELF đã xuất bản. docs/compile.md có bản tường thuật đầy đủ.

Liên kết với firmware/esp32s3/link.ld: .text tại địa chỉ bus lệnh của SRAM1, các phần dữ liệu tại địa chỉ bus dữ liệu của byte đầu tiên ngay sau nó, stack ở đỉnh SRAM2. Bản build từ chối image có hơn 64 KB cần nạp, và elfcheck.py từ chối image mà code và dữ liệu dùng chung RAM.

Mười một ví dụ, mỗi ví dụ kèm một sketch mà giao diện hiển thị: blink (LED RGB màu trắng và một LED được nối dây vào GPIO2), rainbow (LED RGB quay quanh vòng màu), button (một công tắc nối đất vào GPIO21 với điện trở pull-up riêng của pad, thắp sáng LED ở GPIO2), serial (một xung mỗi giây trên UART0, và một lệnh echo), usbserial (tương tự trên cổng USB), fade (một LED ở GPIO2 chạy trên LEDC, tám bit ở 1 kHz), knob (một chiết áp ở GPIO4, kênh 3 của ADC1, điều chỉnh độ sáng LED ở GPIO2 kèm in ra giá trị đọc thô), và bốn ví dụ WiFi: wificonnect, wifiweather, wifiapi và wifilamp.

crates/esp32s3/tests/runtime.rs khởi động các ELF đó và đo lường: nửa chu kỳ của blink nằm trong 5 ms so với 500, các khung WS2812 trên GPIO48 được giải mã và thời gian cao, thấp của mọi bit nằm trong cửa sổ của datasheet, các màu mà rainbow gửi theo thứ tự xanh lá trước, chu kỳ LEDC trong 5 us so với 1 ms, millis() trong 60 ms so với đồng hồ của kernel trong năm giây, không hai byte UART0 nào gần nhau hơn thời gian một byte ở 115200, và một dòng USB đến thành một gói duy nhất. crates/esp32s3/tests/wifi.rs chạy các ví dụ WiFi trên mạng mô phỏng. Mỗi test tự bỏ qua khi các image chưa được build.