Tham khảo

Hợp đồng bo mạch ESP32 DevKit (Boards Wave C)

ESP32 cổ điển trên nhân Xtensa LX6: ma trận GPIO, LEDC, ADC1, và một lõi trong khi chip có hai.

Đâ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 DevKit V1 và trang bo mạch.

ESP32 DevKit V1 là bo mạch DOIT ba mươi chân quanh module ESP32-WROOM-32: một nhân Xtensa LX6 ở 240 MHz, linh kiện đầu tiên ở đây không dùng RISC-V, không dùng AVR, cũng không dùng Arm. Một thành phần kernel (esp32 trong crates/parts) bọc một mô hình SoC ESP32 (crates/esp32) trên một trình thông dịch Xtensa (crates/xtensa-core). Tài liệu này là bản hợp đồng, và nó có hiệu lực hơn mọi chú thích trong code.

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

Hãy đọc mục 6 trước nếu bạn định mang bản build từ đây lên chip thật. Mục đó nói rõ, từng địa chỉ một, con số nào lấy từ ESP32 Technical Reference Manual và con số nào là giả định của mô hình này, đồng thời liệt kê những thứ hoàn toàn không có ở đây: trong đó có lõi thứ hai, cache, flash, PSRAM và cả hai radio. Không có gì bị đoán mò một cách kín đáo.

Một sketch cho bo mạch này được biên dịch ngay trong trình duyệt bằng clang-v3, bản wasm của bản fork LLVM của Espressif (-mcpu=esp32), phát hành 2026-09-28 và đã kiểm tra trên trình mô phỏng này (docs/compile.md). Một ví dụ chưa chỉnh sửa vẫn chạy ELF dựng sẵn từ web/public/firmware/esp32/, do GCC của Espressif dựng. Mục 7 có chi tiết.

1. Chân bo mạch (thứ tự trong danh mục)

Nhìn từ trên, ổ cắm micro-USB ở dưới, module WROOM-32 cùng ăng-ten PCB của nó ở trên. Bo mạch có kích thước 51.5 x 28.3 mm và hai dãy chân 15 pin cách nhau 22.86 mm (0.9 inch), chính điều này cho phép một DOIT DevKit V1 cắm vắt qua breadboard mà mỗi bên vẫn còn nguyên một hàng lỗ trống. Hình hiển thị vẽ nó đúng với kích thước đó.

Espressif DevKitC 38 chân là bo mạch kia mà người ta vẫn gọi là "một ESP32 DevKit", và hai dãy chân của nó cách nhau trọn một inch: trên breadboard nó không chừa lại hàng lỗ nào cả. Đây là bo mạch DOIT ba mươi chân.

Dãy chân trái, từ trên xuống dưới (15 lỗ): EN, VP, VN, D34, D35, D32, D33, D25, D26, D27, D14, D12, GND, D13, VIN.

Dãy chân phải, từ trên xuống dưới (15 lỗ): D23, D22, TX0, RX0, D21, D19, D18, D5, TX2, RX2, D4, D0, D2, D15, 3V3.

30 chân. Dn là GPIO n. VP là GPIO 36 và VN là GPIO 39: hai chân SENSOR_VP và SENSOR_VN của bộ chuyển đổi, tên trên silkscreen đặt theo chức năng của chúng. TX0/RX0 là GPIO 1 và 3, UART console; TX2/RX2 là GPIO 17 và 16. EN là chân cho phép chip, cũng là nút reset của bo mạch này. VIN là nguồn 5 V từ USB. Các tên trùng nhau sẽ kèm một chữ cái, vì tên chân trong danh mục là duy nhất; bo mạch này không có tên nào trùng.

GPIO 6 đến 11 không nằm trên dãy chân nào. Chúng là flash SPI (SD_CLK, SD_DATA0..3 và SD_CMD), và chương trình đang chạy từ chúng. Một bo mạch cho phép sketch điều khiển các chân này sẽ là bo mạch tự phá chính nó, nên ở đây chúng không phải là chân. crates/parts/src/parts/esp32.rs có một bài kiểm tra từ chối cho chúng xuất hiện trên dãy chân.

GPIO 34 đến 39 không có mạch xuất. Trên linh kiện này chúng chỉ là ngõ vào và không hơn: không push-pull, không open drain, cũng không có điện trở kéo lên hay kéo xuống bên trong. pinMode(34, OUTPUT) ghi vào GPIO_ENABLE1_REG, bit đó không giữ được, và chân vẫn ở trạng thái trở kháng cao. Bốn trong số sáu chân nằm trên dãy chân (D34, D35, VP, VN). Mô hình đếm mọi lần thử và linh kiện bo mạch báo số lần đó qua probe (mục 5), vì đây đúng là lỗi khiến chủ nhân một ESP32 mất trọn một buổi chiều, và một trình mô phỏng bỏ qua nó sẽ dạy sai điều cho người học.

Hai chân mang thứ gì đó trên bo mạch:

  • GPIO 2 có một LED xanh dương, và đó là một LED thường trên một pad thường: mức của pad chính là đèn, không có gì được giải mã. Nó cũng là chân strapping, nên trạng thái LED trên một DevKit thật trước khi pinMode chạy sẽ khác nhau giữa các bo mạch.
  • GPIO 0 là nút BOOT, kích hoạt ở mức thấp. Nó nằm trên dãy chân phải với tên D0, nên cũng có thể nối dây đến; poke nối chân đó xuống GND trên bo mạch.

Về điện: mọi GPIO có mạch xuất đều điều khiển push-pull ở 3.3 V qua R_STRONG, hoặc ở trạng thái trở kháng cao, hoặc kéo lên hay kéo xuống qua 45 k. Ngõ vào đọc mức cao ở 1.65 V (một nửa nguồn I/O); một đường nối xung đột (Unknown) đọc là 0, còn một đường nối lơ lửng thì đọc ra nhiễu, giống như trên Uno (docs/uno.md mục 1). GPIO0 đọc mức cao khi không có gì giữ nó, nhờ chính điện trở kéo lên của DevKit cạnh nút BOOT. 3V3 xuất 3.3 V ở R_SUPPLY, VIN xuất 5 V, GND xuất 0 V. EN có điện trở kéo lên 10 k nối lên 3.3 V và kéo nó xuống dưới 1.65 V sẽ giữ lõi ở trạng thái reset. Tụ 100 nF cạnh điện trở đó trên một DevKit thật là mạch reset khi bật nguồn của bo mạch và không được mô phỏng, nên EN ở đây chỉ là điện trở thôi.

Thứ tự chính xác của các chữ in trên bo mạch của hai hàng chân là cách mô hình này đọc sơ đồ chân của DOIT DevKit V1. Số GPIO là số của chip và là thứ mà firmware dựa vào; còn vị trí của chúng trên hàng chân là thứ mà sơ đồ dựa vào. Nếu một bản DevKit nào đó có các hàng chân sắp xếp khác thứ tự (và chúng thực sự khác nhau giữa bản 30 chân và bản 36 chân), thì mạch vẽ ở đây sẽ cần nối dây lại trên bàn thực hành, và không có gì khác thay đổi.

2. Bản đồ bộ nhớ

IRAM (lệnh) 128 KB tại 0x4008_0000 đến 0x4009_FFFF
IROM (flash code) 0x400D_0000, read-only, up to 1,310,720 bytes, section 2.1
DROM (flash constants) 0x3F40_0000, read-only, up to 1,310,720 bytes, section 2.1
DRAM (dữ liệu) 192 KB tại 0x3FFB_0000 đến 0x3FFD_FFFF
đỉnh stack 0x3FFE_0000
DPORT 0x3FF0_0000, mục 3.7
UART0 0x3FF4_0000, mục 3.3
GPIO matrix 0x3FF4_4000, mục 3.1
SENS 0x3FF4_8800, mục 3.5
IO_MUX 0x3FF4_9000, mục 3.2
LEDC 0x3FF5_9000, mục 3.6
Timer group 0 0x3FF5_F000, mục 3.4

Mỗi khối ngoại vi ở đây chiếm 4 KB.

Two windows, not one, and that is the shape of this chip. The ESP32 has three internal SRAMs, two of which are visible through both the instruction bus and the data bus at different addresses, and SRAM1's 32 KB blocks appear in the opposite order through the two. That alias is not modeled. What is modeled is the pair ESP-IDF itself uses and keeps apart: IRAM for code, DRAM for data. The vectors, the exception entry and the startup code go in the 128 KB at 0x4008_0000; the rest of the code and the constants run from flash (section 2.1); .data, .bss and the stack go in the 192 KB at 0x3FFB_0000. A program that tries to read its own .text through the data bus is refused rather than served, because on the real part that read would have come back through the other window with the blocks in a different order.

Every PT_LOAD segment must land inside one of those two ranges 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.

2.1 Flash: code and constants

A real ESP32 runs almost all of a sketch from flash through the cache: code is read at IROM (0x400D_0000) and const data at DROM (0x3F40_0000), and the Arduino IDE's default partition table ("Default 4MB with spiffs") gives the sketch 1,310,720 bytes (0x14_0000) of it. That is the room a sketch has here, and the number the editor prints after a build ("Sketch uses N bytes ... Maximum is 1,310,720 bytes"). It counts what the IDE counts: code, literals, constants, the startup code and the initial values of the variables.

What is modeled: two read-only windows over the loaded image. A fetch or a read from either costs what a fetch from IRAM costs, which is the speed of a warm cache; there is no cache to miss and no MMU, and docs/esp32.md section 6 still says so. A store to a flash window faults, as it does on the chip. The code window shares one buffer with the instruction RAM (so a fetch is one range check whichever it is in), which means the unmapped 192 KB between them reads as zeros here, where the chip would fault; a jump into it still stops the core, since an all-zero word is an illegal instruction.

The link script (firmware/esp32/link.ld) puts .text.vectors, .text.exception, .text.start and anything marked .iram in the instruction RAM and every other function in the code window. Its literal pools sit in front of their own functions, because L32R only reaches 256 KB backwards, and every call out of the startup code goes through a register, because CALL4 and CALL8 reach 128 KB. Global variables are still limited by the data RAM (192 KB here); a program over it is refused with "no room for the stack".

Lõi reset với pc tại điểm vào của ELF và mọi thanh ghi địa chỉ bằng 0. Không có boot ROM ở đây: vài chục mili-giây mà ESP32 thật dành cho bộ nạp tầng 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à firmware/esp32/crt0.S tự tạo rõ ràng trạng thái nó cần thay vì giả định những gì một ROM để lại.

3. Thanh ghi ngoại vi

Chỉ phần con dưới đây được triển khai. Bất cứ thứ gì khác nằm trong một khối 4 KB đã ánh xạ sẽ đọc được giá trị 0 và được tính là truy nhập lạc; bất cứ thứ gì nằm ngoài mọi khối sẽ gây lỗi truy nhập.

3.1 GPIO matrix (0x3FF4_4000)

Bốn mươi chân, nên mọi thanh ghi có một bit cho mỗi chân đều chia làm hai nửa: nửa thường dành cho GPIO 0 đến 31 và nửa có 1 dành cho GPIO 32 đến 39 trong tám bit thấp của nó.

offset thanh ghi
0x00 GPIO_BT_SELECT_REG
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
0x48 GPIO_STATUS_W1TS_REG
0x4C GPIO_STATUS_W1TC_REG
0x50 GPIO_STATUS1_REG
0x54 GPIO_STATUS1_W1TS_REG
0x58 GPIO_STATUS1_W1TC_REG
0x88 + 4n GPIO_PINn_REG
0x530 + 4n GPIO_FUNCn_OUT_SEL_CFG_REG

Đã đối chiếu với tài liệu kỹ thuật tham khảo: địa chỉ gốc của khối và mọi offset trong bảng này.

GPIO_PINn_REG bit 2 PAD_DRIVER biến pad thành open drain; 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 cả hai sườn, 4 mức thấp, 5 mức cao); bit 13 PIN_INT_ENA dành cho lõi PRO cho phép chân kết nối tới được matrix.

GPIO_FUNCn_OUT_SEL_CFG_REG tại 256 làm pad bám theo GPIO_OUT. Giá trị 71 đến 78 giao nó cho các kênh tốc độ cao LEDC 0 đến 7. Giá trị khác chọn một ngoại vi không được mô phỏng, và mô hình coi nó như 256 thay vì bịa ra một mức. Một pad do kênh LEDC điều khiển vẫn cần bật mạch xuất trong GPIO_ENABLE.

Chưa đối chiếu: các chỉ số tín hiệu GPIO matrix 71 đến 78 cho ledc_hs_sig_out0 đến ledc_hs_sig_out7. Bảng tín hiệu của matrix không phải thứ mô hình này trích lại được, và con số này chỉ nằm ở đúng hai chỗ (OUT_SEL_LEDC_HS_SIG trong crates/esp32/src/map.rs và GPIO_FUNC_OUT_SEL_LEDC_HS trong firmware/esp32/include/esp32.h), nên mô hình và runtime thống nhất vì cả hai đọc cùng một hằng số, chứ không phải vì bên nào đã kiểm chứng. GPIO_FUNC_OUT_SEL_GPIO = 256 là theo tài liệu hướng dẫn.

GPIO_STRAP_REG đọc về 0b1101: GPIO 0, 2 và 5 cao, mọi chân khác thấp, đúng như một WROOM-32 rời nhà máy. Ở đây nó là hằng số, không phải trạng thái ghi lại của các chân lúc reset.

Sáu chân không có bộ lái đầu ra (GPIO 34 đến 39) chấp nhận ghi vào bit ENABLE1 của chúng và giữ nó bằng 0, và mô hình đếm lần ghi đó (mục 1, mục 5).

3.2 IO_MUX (0x3FF4_9000)

IO_MUX_PIN_CTRL_REG tại 0x00, rồi mỗi pad một thanh ghi. Bit 7 FUN_WPD, bit 8 FUN_WPU, bit 9 FUN_IE, các bit 12..14 MCU_SEL trong đó 2 là GPIO thường trên con chip này. Một pad chỉ đến được GPIO_IN_REG khi bộ đệm vào của nó được bật, đúng như phần cứng vẫn làm.

IO_MUX của ESP32 không đánh chỉ số theo số GPIO. Các thanh ghi xếp theo thứ tự pad của vỏ chip, và phép chiếu từ GPIO sang pad là một bảng trong tài liệu. Bảng của mô hình này là:

GPIO offset GPIO offset GPIO offset GPIO offset
0 0x44 10 0x58 20 0x78 32 0x1C
1 0x88 11 0x5C 21 0x7C 33 0x20
2 0x40 12 0x38 22 0x80 34 0x14
3 0x84 13 0x3C 23 0x8C 35 0x18
4 0x48 14 0x30 24 0x90 36 0x04
5 0x6C 15 0x34 25 0x24 37 0x08
6 0x60 16 0x4C 26 0x28 38 0x0C
7 0x64 17 0x50 27 0x2C 39 0x10
8 0x68 18 0x70 28..31 không có
9 0x54 19 0x74

Tin là đúng chứ chưa kiểm chứng. Bảng này là cách mô hình đọc thứ tự pad, không phải một trang trích nguyên văn. Nó nằm ở hai chỗ, IOMUX_INDEX trong crates/esp32/src/map.rs và mokxi_iomux_index[] trong firmware/esp32/src/gpio.c, nên mô hình và runtime thống nhất với nhau, dù có khớp với silicon hay không. GPIO 28 đến 31 không tồn tại trên con chip này và không có thanh ghi.

Mỗi pad khởi động với giá trị FUN_IE | (2 << 12) ở đây: GPIO thường với bộ đệm đầu vào bật. Giá trị reset theo từng pad trong tài liệu kỹ thuật khác đi (các chân strapping và chân flash khởi động với điện trở kéo), và mô hình này cho mọi chân cùng một trạng thái trung tính để chương trình chỉ ghi GPIO_ENABLE và GPIO_OUT sẽ hoạt động giống nhau trên mọi chân. Mục 6 lặp lại điều này như một xấp xỉ chứ không phải một địa chỉ.

3.3 UART0 (0x3FF4_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

Đã kiểm chứng: địa chỉ cơ sở và mọi offset, hai bit reset FIFO và độ rộng của hai bộ đếm FIFO bên dưới. Đây là cùng một IP UART như của ESP32-C3 và ESP8266, khớp nhau từng thanh ghi, đó là lý do crates/esp32/src/uart.rs và crates/esp8266/src/uart.rs là cùng một tệp lặp hai lần.

Hai FIFO 128 byte. UART_CONF0_REG bit 17 RXFIFO_RST và bit 18 TXFIFO_RST làm rỗng chúng: ESP32 Technical Reference Manual (v5.8), thanh ghi 19.9 UART_CONF0_REG, đặt TXFIFO_RST tại bit 18 và RXFIFO_RST tại bit 17. Một phiên bản trước của mô hình này và của firmware/esp32/include/esp32.h từng bị hoán đổi vị trí hai bit. Serial.begin của runtime đặt rồi xóa cả hai bit cùng lúc, nên giá trị nó ghi ra vẫn như nhau dù theo cách nào, và các image của nó không bị ảnh hưởng.

UART_CONF1_REG bit 0..6 là RXFIFO_FULL_THRHD và bit 8..14 là TXFIFO_EMPTY_THRHD, cả hai đều là 96 khi reset (thanh ghi 19.10); một phiên bản cũ của mô hình này có trường chín bit tại vị trí 0 và 9, và runtime không bao giờ ghi vào thanh ghi này. UART_CLKDIV_REG bit 0..19 là phần nguyên của số chia (thanh ghi 19.6; phần thập phân tại bit 20..23 không được mô phỏng). Số chia chia xung clock 80 MHz của APB và reset về 694, tương ứng 115 274 baud: đủ gần 115200 để một monitor không quan tâm, và chính xác là kết quả mà con số này cho ra. Trước đây việc định tốc phát chỉ đọc mười hai bit của nó, nên Serial.begin(9600), có số chia là 8333, gửi byte nhanh hơn khoảng 59 lần; giờ nó đã đọc đủ hai mươi bit.

UART_STATUS_REG bit 0..7 là RXFIFO_CNT và bit 16..23 là TXFIFO_CNT (thanh ghi 19.8). Bit 8..11 và 24..27 phía trên chúng là máy trạng thái của bộ nhận và bộ phát (ST_URX_OUT, ST_UTX_OUT). Mô hình trả về hai giá trị đếm tại các vị trí đó và 0 ở các bit máy trạng thái, vì nó không chạy máy trạng thái nào cả. Runtime đọc tám bit, đúng như tài liệu mô tả các trường. Một runtime cũ đọc mười bit, mà ở đây vẫn cho cùng số vì các bit phía trên đọc được 0, nhưng trên chip thật sẽ nhặt thêm hai bit của ST_UTX_OUT: giá trị đếm phát sẽ đọc được 256 trở lên trong khi một byte đang trên đường truyền, và Serial.write, vốn chờ chỗ trống trong FIFO, sẽ chờ mãi mãi. Các ảnh đã được dựng lại khi lỗi này được sửa, và crates/esp32/tests/contract.rs giữ các mặt nạ của header khớp với mô hình.

Byte rời FIFO phát theo tốc độ baud, không tức thì. Nếu không có điều này, một chương trình in liên tục sẽ xả FIFO nhanh bằng tốc độ nó được đổ đầy, TXFIFO_CNT không bao giờ tăng, và firmware kiểm tra nó trước khi ghi sẽ không bao giờ phải chờ. Có nó, một cổng 115 200 baud truyền 11 520 byte mỗi giây ở đây đúng như trên máy thật, và crates/esp32/tests/runtime.rs đo khoảng cách giữa hai byte của ví dụ serial so với 86.8 us mà một byte cần.

3.3a UART1 (0x3FF5_0000) và UART2 (0x3FF6_E000)

Khối thanh ghi của UART0 lặp lại hai lần nữa, tại REG_UART_BASE(1) và REG_UART_BASE(2) của ESP-IDF, với cùng các offset. Đã kiểm chứng với soc/esp32/register/soc/uart_reg.h của ESP-IDF: các địa chỉ gốc, các offset, và các trường dưới đây. Khác với UART0, chúng không nối với kênh host nào: chúng đến với mạch chỉ qua ma trận GPIO (mục 3.1), từng bit một.

  • Định tuyến ma trận. Tín hiệu 17 của GPIO_FUNCn_OUT_SEL_CFG_REG là U1TXD, 198 là U2TXD; GPIO_FUNCm_IN_SEL_CFG_REG (tại 0x130 + 4m, có 256 cái) cho tín hiệu 17 là U1RXD và cho 198 là U2RXD, với SIG_IN_SEL (bit 7) lấy GPIO vào trong IN_SEL (bit 0..5) và IN_INV_SEL (bit 6) đảo nó. Các con số lấy từ gpio_sig_map.h của ESP-IDF. INV_SEL (bit 9) của OUT_SEL đảo đầu ra. Một tín hiệu với SIG_IN_SEL cleared thì đến từ chân IO_MUX trên chip; đường đó không được mô phỏng (đường đọc ở trạng thái rảnh), và runtime định tuyến mọi chân qua ma trận, điều này trên chip thật cũng hoạt động với mọi chân.
  • Khung truyền. UART_CONF0_REG PARITY/PARITY_EN (bit 0 và 1), BIT_NUM (2..3, năm đến tám bit) và STOP_BIT_NUM (4..5: một, một rưỡi, hai). Trên chip, hai stop bit cần cách xử lý RS485_CONF.DL1_EN của ESP-IDF; ở đây STOP_BIT_NUM 3 đơn giản là hai. RXD_INV (19) và TXD_INV (22) đảo các đường tín hiệu, ERR_WR_MASK (26) không cho các byte có lỗi khung hoặc lỗi parity vào FIFO.
  • Đồng hồ. TICK_REF_ALWAYS_ON (bit 27, set khi reset) chia đồng hồ 80 MHz APB; khi bị xóa, dùng REF_TICK 1 MHz, vốn được ESP-IDF chọn với tốc độ tới 250 000 baud. UART_CLKDIV_REG có phần nguyên tại bit 0..19 và phần lẻ mười sáu tại CLKDIV_FRAG, bit 20..23, cả hai đều được mô phỏng: 9600 baud từ REF_TICK là 104 và 2/16, tức một bit 104.125 us, 9603.8 baud, đúng như trên chip.
  • FIFO và ngưỡng. 128 byte mỗi chiều. Một byte bắt đầu ngay khi thanh ghi dịch rảnh và byte kế tiếp nối sau stop bit cuối cùng của nó không khe hở (tx_idle_num 0, như ESP-IDF đặt). TXFIFO_CNT đếm các byte còn đang chờ, không tính byte đang phát, và ST_UTX_OUT (24..27) cùng ST_URX_OUT (8..11) báo slot mà mỗi máy trạng thái đang ở, 0 khi rảnh. Bit 15 của STATUS là đường nhận và bit 31 là đường phát.
  • Nhận. Sườn xuống trên đường rảnh bắt đầu một khung; start bit được kiểm tra tại chính giữa của nó (một glitch bị bỏ qua), mỗi bit khác được lấy mẫu tại giữa slot của nó và byte cập nhật tại giữa stop bit. Lõi chạy trước mạch tối đa một slice, nên bộ nhận chỉ lấy mẫu thời gian mà mạch đã báo cáo.
  • Ngắt. RXFIFO_FULL (bit 0) và TXFIFO_EMPTY (1) so với ngưỡng của CONF1, PARITY_ERR (2), FRM_ERR (3), RXFIFO_OVF (4), RXFIFO_TOUT (8) và TX_DONE (14), trên các nguồn 35 và 36 của ma trận ngắt. RX_TOUT_EN và RX_TOUT_THRHD (bit 31 và 24..30 của CONF1) đặt thời gian chờ theo đơn vị mà hàm uart_ll_set_rx_tout của ESP-IDF ghi: mỗi đơn vị bằng tám chu kỳ bit tính từ APB, hoặc một phần tám chu kỳ bit tính từ REF_TICK.
  • Không mô phỏng: điều khiển luồng bằng phần cứng và phần mềm, RS-485, IrDA, autobaud, break, bit loopback, bộ dò lệnh AT và các bit bật đồng hồ, reset của DPORT (cả hai UART luôn được cấp đồng hồ). Các thanh ghi của chúng bị bỏ rơi, không dùng đến.

Một UART mà chương trình không bao giờ ghi không tốn của trình mô phỏng gì cả: UART này không được đụng đến trên bất kỳ đường dẫn nào cho đến khi một thanh ghi của nó được ghi, và crates/esp32/src/bus.rs có một test khẳng định điều đó.

Serial1 và Serial2 của runtime (firmware/esp32/src/uartn.c) điều khiển các cổng này theo cách core arduino-esp32 3.x và driver của ESP-IDF làm; docs/help/boards/esp32-devkit.md nói rõ sketch nhìn thấy gì.

3.4 Nhóm Timer 0, timer 0 (0x3FF5_F000)

Bộ đếm 64 bit đứng sau micros() và millis().

offset thanh ghi
0x00 TIMG_T0CONFIG_REG
0x04 TIMG_T0LO_REG
0x08 TIMG_T0HI_REG
0x0C TIMG_T0UPDATE_REG
0x10 TIMG_T0ALARMLO_REG
0x14 TIMG_T0ALARMHI_REG
0x18 TIMG_T0LOADLO_REG
0x1C TIMG_T0LOADHI_REG
0x20 TIMG_T0LOAD_REG
0x98 TIMG_INT_ENA_TIMERS_REG
0x9C TIMG_INT_RAW_TIMERS_REG
0xA0 TIMG_INT_ST_TIMERS_REG
0xA4 TIMG_INT_CLR_TIMERS_REG

Đã kiểm chứng: địa chỉ gốc của khối. Tin là đúng hơn là đã kiểm chứng: mọi offset trong bảng này. Địa chỉ gốc là của tài liệu; bố cục bên trong là của mô hình này, và nó giống nhau trong crates/esp32/src/map.rs và firmware/esp32/include/esp32.h.

Bit 31 của T0CONFIG là EN, bit 30 là INCREASE, bit 29 là AUTORELOAD, các bit 13..28 là DIVIDER, bit 10 là ALARM_EN. Runtime đặt DIVIDER thành 80, tức một tick mỗi microgiây lấy từ đồng hồ APB 80 MHz.

Cách đọc là ghi chốt rồi mới đọc, như phần cứng yêu cầu: ghi T0UPDATE, rồi đọc T0HI và T0LO. Bộ đếm không được đếm. Nó chính là thời gian mô phỏng chia cho bộ chia, giống cách SYSTIMER của C3 hoạt động, nên không có gì để nó bị trôi lệch và firmware nào chờ liên tục bằng cách đọc micros() cũng đo được chính xác thời gian mà phần còn lại của mạch thấy trôi qua.

Báo thức đã được triển khai và TIMG_INT_RAW lên mức cao khi bộ đếm vượt qua nó, nhưng không có đường ngắt nào rời khỏi khối này. Không có gì dẫn nó vào ma trận ngắt. Xung mili giây của mô hình đến từ thanh ghi CCOMPARE0 của nhân (mục 4), vốn là thanh ghi của nhân nối với một ngắt CPU cố định, nên không nằm sau địa chỉ nào mà mô hình này phải đoán. TIMG_INT_ST vẫn có thể được thăm dò và xóa.

Timer 1 của nhóm timer 0 và toàn bộ nhóm timer 1 không có; watchdog của nhóm timer 0 là của mục 3.9.

3.5 SENS: ADC1, chế độ một lần (0x3FF4_8800)

ADC1 ở chế độ một lần: đường dẫn adc1_get_raw và analogRead của Arduino core sẽ nhận vai trò trên linh kiện này, và không có gì khác.

offset thanh ghi bit
0x00 SENS_SAR_READ_CTRL_REG được lưu, đọc lại được; thời gian chuyển đổi ở đây là cố định
0x34 SENS_SAR_ATTEN1_REG hai bit suy giảm cho mỗi kênh, kênh n ở các bit 2n..2n+1
0x54 SENS_SAR_MEAS_START1_REG các bit 0..15 MEAS1_DATA_SAR (kết quả, chỉ đọc), bit 16 MEAS1_DONE_SAR, bit 17 MEAS1_START_SAR, bit 18 MEAS1_START_FORCE, các bit 19..26 SAR1_EN_PAD (một bit cho mỗi kênh), bit 31 SAR1_EN_PAD_FORCE

Đã kiểm chứng: địa chỉ cơ sở. Tin rằng đúng chứ chưa kiểm chứng: ba địa chỉ lệch và mọi vị trí bit bên trong chúng. Chúng là cách mô hình này diễn giải khối SENS, giống với cách mục 3.5 của docs/esp32c3.md đánh dấu các địa chỉ lệch SAR của chính con C3. Firmware biên dịch tại đây khớp với mô hình, bất kể nó có khớp với silicon thật hay không.

Một lần chuyển đổi: đặt suy giảm vào ATTEN1, đặt START_FORCE và EN_PAD_FORCE, đặt bit của kênh vào SAR1_EN_PAD, nâng MEAS1_START_SAR, chờ MEAS1_DONE_SAR, rồi đọc dữ liệu. Một lần chuyển đổi mất đúng 5 us thời gian mô phỏng, và firmware thực sự chờ đợi khoảng thời gian này.

Tám kênh, và trên ESP32 chúng không phải là GPIO n:

kênh 0 1 2 3 4 5 6 7
GPIO 36 37 38 39 32 33 34 35

Kênh 0 là SENSOR_VP và kênh 3 là SENSOR_VN; chân 37 và 38 không được nối ra trên WROOM-32, nên bốn kênh mà DevKit đưa ra dưới dạng số thông thường là các kênh 4 đến 7. Bảng đó lấy từ tài liệu hướng dẫn.

Kết quả là mười hai bit của điện áp trên đường nối tại thời điểm bắt đầu chuyển đổi. Ở 0, 2.5 và 6 dB nó là đường thẳng danh nghĩa theo datasheet, round(4095 x Vin / Vfull) bị kẹp, với thang đo đầy đủ là 1.1 V, 1.5 V và 2.2 V. Ở 11 dB, mặc định của Arduino core, nó là đường cong thô của linh kiện thật (CURVE_11DB trong crates/esp32/src/adc.rs): 0 cho đến khoảng 80 mV, gần như tuyến tính ở đoạn giữa, cong lên gần đỉnh và bão hòa ở 4095 từ khoảng 3.15 V. Thang đầy đủ danh nghĩa 3.9 V không phải là điều mà một phép đọc thô cho ra; datasheet chỉ cam kết độ chính xác từ 150 đến 2450 mV ở 11 dB, và giá trị thô của một linh kiện điển hình chạm trần từ trước 3.9 V khá xa. Vì vậy một biến trở nối ngang nguồn 3.3 V đọc được 0 đến 4095, chạm 4095 hơi trước hết hành trình, nửa nguồn (1.65 V) đọc khoảng 1890, và map(analogRead(pin), 0, 4095, 0, 180) quay được servo hết một vòng. Các điểm này là phép khớp bậc bốn được dùng rộng rãi cho các ESP32 đo thực tế, đảo ngược lại; hiệu chuẩn eFuse của từng con sẽ dịch chuyển chúng vài phần trăm, và điều đó không được mô phỏng. analogReadMilliVolts đảo ngược đúng đường cong đó, giống cách hiệu chuẩn của Arduino core, nên nó đọc khoảng 1650 tại 1.65 V. Một kênh với chân không nối gì sẽ dao động, như một đầu vào lơ lửng vẫn thế (docs/uno.md mục 1).

Hàm truyền của bộ chuyển đổi thật bị cong ở cả hai đầu và được hiệu chỉnh bằng đường cong hiệu chuẩn eFuse. Tất cả những điều đó đều không được mô phỏng: bộ này là một đường thẳng. Mục 6 ghi nhận nó chỉ là một xấp xỉ.

ADC2 (mà ESP32 thật dùng chung với WiFi), đường DMA và bảng mẫu, bộ điều khiển kỹ thuật số, các eFuse hiệu chuẩn, điện áp tham chiếu nội bộ, cảm biến cảm ứng và cảm biến hall đều không có mặt.

3.6 LEDC, nhóm tốc độ cao (0x3FF5_9000)

Bộ điều khiển PWM cho LED. Nhóm tốc độ cao là nhóm mà ledcSetup, ledcAttachPin và ledcWrite truy cập tới với các kênh 0 đến 7, và cũng là nhóm mà analogWrite dùng ở đây: bốn bộ đếm thời gian và tám kênh.

offset thanh ghi bit
0x00 + 0x14n LEDC_HSCHn_CONF0_REG các bit 0..1 TIMER_SEL, bit 2 SIG_OUT_EN, bit 3 IDLE_LV, bit 4 PARA_UP (được lưu; giá trị duty cycle ghi vào đây có hiệu lực ngay)
0x04 + 0x14n LEDC_HSCHn_HPOINT_REG các bit 0..19 HPOINT: giá trị đếm mà xung bắt đầu từ đó
0x08 + 0x14n LEDC_HSCHn_DUTY_REG các bit 0..24 DUTY: độ rộng xung tính theo một phần mười sáu của một bước đếm
0x0C + 0x14n LEDC_HSCHn_CONF1_REG phần cứng duty-fade: đã lưu, đọc lại được, và không làm mờ gì cả
0x10 + 0x14n LEDC_HSCHn_DUTY_R_REG hệ số chu kỳ hiện hành, chỉ đọc
0x140 + 8n LEDC_HSTIMERn_CONF_REG các bit 0..4 DUTY_RES, 1 đến 20 bit (0 là một bộ đếm thời gian không ai cấu hình và nó không đếm gì), các bit 5..22 CLK_DIV, bit 23 PAUSE, bit 24 RST
0x144 + 8n LEDC_HSTIMERn_VALUE_REG bộ đếm, chỉ đọc
0x180 LEDC_INT_RAW_REG bit n = bộ đếm thời gian n bị tràn
0x184 LEDC_INT_ST_REG thô và được bật
0x188 LEDC_INT_ENA_REG đã lưu; không có đường nối nào tới được lõi
0x18C LEDC_INT_CLR_REG ghi 1 để xóa
0x190 LEDC_CONF_REG các bit 0..1 APB_CLK_SEL, 1 = xung APB 80 MHz, nguồn duy nhất được mô phỏng
0x1FC LEDC_DATE_REG đọc được 0x1605_3100

Đã kiểm chứng: địa chỉ cơ sở của khối. Tin rằng đúng chứ chưa kiểm chứng: toàn bộ bố cục bên trong nó: độ bước giữa các kênh, khối bộ đếm thời gian tại 0x140, và các thanh ghi ngắt và cấu hình từ 0x180 trở lên.

Một bộ đếm thời gian đếm 2^DUTY_RES bước đếm ở 80 MHz chia cho CLK_DIV, một số Q10.8 tính theo số xung APB mỗi bước đếm:

f = 80e6 / ((CLK_DIV / 256) * 2^DUTY_RES)

nên 5 kHz ở tám bit là DUTY_RES 8 với CLK_DIV 16000, chính xác. Một kênh chọn một bộ định thời, một số đếm bắt đầu HPOINT và một hệ số chu kỳ, và đầu ra của nó ở mức cao từ HPOINT trong DUTY >> 4 bước đếm, cuộn vòng qua đỉnh của chu kỳ. Hệ số chu kỳ 0 là mức thấp liên tục và hệ số chu kỳ 2^DUTY_RES << 4 là mức cao liên tục không có cạnh nào, đó là lý do Arduino core đổi ledcWrite(pin, 255) ở tám bit thành hệ số chu kỳ 256 thay vì 255, vốn sẽ để lại một khấc một bước đếm mỗi chu kỳ.

Một kênh đi tới một pad qua ma trận GPIO: đặt bit GPIO_ENABLE của pad và trỏ GPIO_FUNCn_OUT_SEL_CFG_REG của nó tới 71 + channel (mục 3.1, và chỉ số đó là phần chưa được kiểm chứng).

Bộ đếm không được tính từng nhịp: nó là một hàm dạng đóng của thời gian mô phỏng, và thời điểm cạnh tiếp theo của nó cũng vậy. Một nhân dừng ở waiti vì thế không tốn chi phí gì trong khi PWM chạy, và bo mạch chỉ được đánh thức cho các cạnh mà thôi. crates/esp32/tests/runtime.rs đo chu kỳ của ví dụ fade so với 1 ms của 1 kHz với sai số trong 5 us.

Không được mô phỏng: nhóm tốc độ thấp (ESP32 có một nhóm như vậy, với bốn bộ đếm thời gian, tám kênh và một xung chậm riêng; không có gì trong runtime dùng nó), phần cứng giảm dần hệ số chu kỳ, bộ đếm tràn riêng của từng kênh, các nguồn xung khác ngoài APB, và đường ngắt của LEDC vào ma trận ngắt: LEDC_INT_RAW_REG có thể được thăm dò và xóa nhưng không bao giờ tới được nhân.

3.7 DPORT và ma trận ngắt (0x3FF0_0000)

Trên ESP32, một ngoại vi không có ngắt CPU cố định. Nó có một số hiệu nguồn, và thanh ghi ánh xạ của ma trận cho nguồn đó cho biết nó kích hoạt ngắt nào trong 32 ngắt của nhân. Đó là lý do attachInterrupt ở đây là ba lần ghi thay vì một: cấu hình chân, định tuyến nguồn, bỏ mặt nạ ngắt CPU.

offset thanh ghi
0x104 + 4n DPORT_PRO_..._INTR_MAP_REG cho nguồn n

96 nguồn. Một thanh ghi map giữ số ngắt của CPU trong năm bit thấp của nó; một nguồn được ánh xạ tới 0 sẽ phát ra ngắt 0, ngắt mà không có gì bật, nên không có gì xảy ra, đúng như phần cứng thật vẫn làm, và đó là cách một nguồn bị tắt.

Đã kiểm chứng: DPORT_BASE = 0x3FF0_0000. Mang tính suy đoán hơn là kiểm chứng: offset của mảng map 0x104, cùng hai số nguồn mà mô hình này định tuyến:

nguồn số
GPIO 22
UART0 34
UART1 35
UART2 36

Thứ tự của UART1 và UART2 đã được kiểm chứng theo thứ tự trong soc/esp32/include/soc/interrupts.h của ESP-IDF, vốn cũng đặt GPIO ở 22 và UART0 ở 34. Chỉ những nguồn này, cùng watchdog của nhóm timer 0 (mục 3.9), là có tác dụng thật. Mọi thanh ghi map khác đều được ghi lại và đọc ra nhưng không định tuyến tới đâu, vì không có gì khác trong mô hình này phát ra ngắt. Phần còn lại của DPORT (điều khiển cache và MMU, các thanh ghi điều khiển APP-CPU, các cổng clock và reset của ngoại vi, cơ chế phân xử DMA) không có mặt.

3.8 Hộp thư mạng của Mokxi (0x3FEF_E000)

Khu này không phải của ESP32. Mọi địa chỉ khác trong tài liệu này là của con chip, trích từ tài liệu tham khảo kỹ thuật, và một image được build dựa trên nó là image cho một WROOM-32 thật. Còn khu này là của riêng Mokxi: mạng được mô phỏng của crates/net, nằm trong khoảng trống mà bus dữ liệu để lại giữa các cửa sổ bộ nhớ ngoài (kết thúc tại 0x3FBF_FFFF) và cửa sổ ngoại vi (bắt đầu tại DPORT, 0x3FF0_0000), một dải mà con chip dành riêng và không trả lời gì trong đó, nên một image dùng đến nó sẽ fault trên silicon thay vì đọc nhầm thanh ghi của một ngoại vi khác. Fault đó là câu trả lời trung thực, vì thứ đằng sau khu này không tồn tại trên con chip.

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

Ở đây không có sóng vô tuyến, không có 802.11 và không có internet thật. Không có gì trong mô hình truyền tín hiệu, quét, kết nối với mạng, 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à ba origin mà mạng phục vụ là các hàm trong crates/net/src/http.rs. Hộp thư mang hình dạng của đường nối thật chứ không hư cấu về một MAC: trên ESP32 thật, phần cứng WiFi là một blob nhị phân đóng với một giao diện lệnh, và WiFi.h của Arduino nằm ở phía bên kia của một giao diện như vậy. docs/wifi.md là hợp đồng cho thứ nằm đằng sau; mục này chỉ nói về 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à phần Bluetooth của khối này, có vòng đệm riêng để một callback Bluetooth không bao giờ đụng vào phần thân HTTP: Bluetooth Classic và LE, cả hai thứ mà ESP32 chuẩn có. Phía sau chúng cũng không có sóng vô tuyến nào; 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.9 Watchdog của nhóm timer 0 và các reset của RTC_CNTL (0x3FF5_F048, 0x3FF4_8000)

Watchdog chính của nhóm timer 0, như của C3 (docs/esp32c3.md mục 3.9) nhưng với bố cục của ESP32: một lượt ghi có hiệu lực ngay lập tức, bit ngắt là bit 2 của TIMG_INT_* (0x98..0xA4), và nó đến nhân qua ma trận ngắt với nguồn 16 (runtime ánh xạ nó sang ngắt CPU 17). RTC_CNTL (0x3FF4_8000, hai kilobyte bên dưới SENS): RTC_CNTL_RESET_STATE_REG tại 0x34, các thanh ghi lưu trữ tại 0x4C..0x58 và 0xB0..0xBC, và hai lượt reset bằng phần mềm. Nhóm timer 1 không được mô phỏng.

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. Nhân: ABI nào, và một ngắt đến như thế nào

crates/xtensa-core là một trình diễn giải Xtensa LX được viết dựa trên tài liệu tham khảo Xtensa Instruction Set Architecture và các mã hóa mà bộ công cụ Espressif tạo ra. Không có gì trong nó được lấy từ QEMU, từ ESP-IDF, từ các core Arduino hay từ bất kỳ trình mô phỏng nào khác. xtensa-esp32-elf-as được dùng như cách dùng một dụng cụ trên bàn thí nghiệm (dịch một lệnh, đọc lại mã hóa, viết bộ giải mã dựa trên kết quả thu được), và crates/xtensa-core/tests/encoding.rs giữ lại các phép đo đó, để bộ giải mã có thể được kiểm tra dựa trên bằng chứng thay vì dựa trên một bảng do ai đó tự tay gõ.

ABI dùng cửa sổ, và không có lựa chọn nào khác. xtensa-esp32-elf-gcc phát sinh entry, call8 và retw.n, và hoàn toàn không có tùy chọn -mabi=call0. Nên cấu hình LX6 ở đây có sáu mươi tư thanh ghi địa chỉ vật lý và cửa sổ thanh ghi, với ENTRY, RETW, ROTW, MOVSP, L32E/S32E và các ngoại lệ tràn và thiếu cửa sổ qua các vector riêng của chúng. (LX106 của ESP8266 có mười sáu thanh ghi và không có cửa sổ, nên trình biên dịch của nó phát sinh call0; docs/esp8266.md mục 4 là nửa còn lại của câu chuyện này.)

What the LX6 configuration has that the LX106 does not: hardware divide (QUOS, QUOU, REMS, REMU), the 32-bit high multiply, MIN/MAX, SEXT, CLAMPS, the zero-overhead loop (LOOP, LOOPNEZ, LOOPGTZ) and the two atomic loads. Each of those differences was put to the assembler of the toolchain that builds for that chip; the encodings that came back are in tests/encoding.rs.

Được mô phỏng: nạp và lưu với mọi độ rộng kèm ngoại lệ căn chỉnh, toàn bộ tập lệnh nhánh và nhánh có điều kiện, CALL0/CALL4/CALL8/CALL12 và các dạng gián tiếp của chúng, L32R, MOVI, các lệnh dạng ngắn (.n), ALU số nguyên, MUL16/MULL/MULUH/MULSH, các thanh ghi đặc biệt, và WAITI.

Các vector. VECBASE là một thanh ghi đặc biệt và bảng là bảng của ISA:

độ lệch so với VECBASE vector
0x000 WindowOverflow4
0x040 WindowUnderflow4
0x080 WindowOverflow8
0x0C0 WindowUnderflow8
0x100 WindowOverflow12
0x140 WindowUnderflow12
0x300 KernelException (xóa PS.UM)
0x340 UserException (PS.UM được set), và mọi ngắt mức 1, với EXCCAUSE là 4
0x3C0 DoubleException (PS.EXCM đã được đặt)

Handler tràn nào trong ba handler được chọn phụ thuộc vào độ rộng của khung đang được đẩy xuống, chứ không phụ thuộc vào việc cửa sổ đã quay xa bao nhiêu để tới nó: WindowOverflow4 tràn qua a5, 8 qua a9 và 12 qua a13, và đó là các con trỏ stack cách một, hai và ba cửa sổ. Một CALL8 ghi vào a8 trước khi ENTRY của hàm được gọi kịp chạy, nên quy tắc tràn áp dụng trên lần truy cập thanh ghi chứ không chỉ trên ENTRY. Cả hai đều là lỗi mà chính firmware của bo mạch này phát hiện, và cả hai đã được sửa trong core.

Ngắt. INTENABLE làm mặt nạ; PS.INTLEVEL chặn. Chỉ level 1 được mô phỏng: các mức ngắt trên một, NMI và ngắt debug thì không. Các ngắt level 1 là 0 đến 10, 12, 13, 17 và 18, mặt nạ 0x0006_37FF. Đã xác minh với ESP32 Technical Reference Manual (v5.8), bảng 8.3-2 "CPU Interrupts": 19, 20 và 21 kích theo mức ở level 2, nên chúng không có trong mặt nạ. Một phiên bản trước của mô hình này có chúng trong đó (0x003E_37FF), điều này sẽ phân phối một đường level 2 ở level 1; giờ đây crates/xtensa-core/tests/interrupts.rs giữ mặt nạ đúng theo bảng. Runtime chỉ bật 6 và 13 (mục 7), cả hai đều level 1 trên cùng bảng đó, nên không firmware nào phụ thuộc vào mặt nạ cũ.

CCOUNT và CCOMPARE. LX6 có ba bộ so sánh. Mỗi bộ sẽ kích ngắt CPU nào được coi là:

bộ so sánh ngắt CPU
CCOMPARE0 6
CCOMPARE1 15
CCOMPARE2 16

Đã xác minh với cùng bảng 8.3-2, trong đó các ngắt nội bộ 6, 15 và 16 là "Timer.0", "Timer.1" và "Timer.2". Bảng cũng đặt 15 ở mức ưu tiên 3 và 16 ở mức ưu tiên 5, nên ở đây chỉ CCOMPARE0 là từng được xử lý. Runtime dùng CCOMPARE0 và ngắt CPU 6 cho nhịp tick của mình, cũng chính là cái mà mọi port Xtensa dùng.

Một WSR vào CCOMPARE chính là thứ lên chế độ chờ cho bộ so sánh, và ghi vào nó cũng xóa ngắt đang chờ. Đó là quy tắc của phần cứng và cũng là quy tắc ở đây. Hai chi tiết của mô hình, cả hai đều cố ý và đều vì thời gian mô phỏng không phải một clock chạy theo bước:

  • Phần cứng thật phát ngắt đúng chu kỳ mà CCOUNT bằng bộ so sánh và giữ nó cho đến khi bộ so sánh được ghi lại. Ở đây phép so sánh là "đã đạt hoặc đã vượt qua", vì một core dừng trong WAITI ngừng thực thi lệnh trong khi thời gian vẫn trôi, nếu không sẽ bước thẳng qua đúng chu kỳ duy nhất quan trọng. Với một handler đặt hạn tiếp theo (là mọi cách dùng thanh ghi này), hai cách hành xử giống nhau.
  • Một hạn đã qua thì không được kích hoạt. Một handler mất vài trăm chu kỳ, nên bộ so sánh đặt ở "bây giờ" đã ở quá khứ trước khi handler trả về, sẽ kích ngay lập tức, và chương trình bị ngắt chỉ được chạy một lệnh mỗi lần. Ba giây blink tốn 200 triệu lệnh trước quy tắc đó và chưa đến nửa triệu sau nó.

MOVSP không gây ra ngoại lệ Alloca ở đây; nó làm luôn việc mà ngoại lệ và trình xử lý của nó cùng làm. Trên phần cứng MOVSP bẫy khi cửa sổ thanh ghi của hàm gọi đã bị tràn xuống (WINDOWSTART bật cho WINDOWBASE - 1 thành - 3), và handler sao chép của caller a0..a3, vùng lưu cơ sở nằm trong 16 byte ngay dưới con trỏ stack cũ, xuống dưới con trỏ mới trước khi di chuyển. Mô hình này thực hiện bản sao đó tại chỗ rồi di chuyển (crates/xtensa-core/src/cpu.rs, movsp). Code lại phụ thuộc vào nó: clang-v3 đặt mọi lời gọi truyền đối số trên stack trong dấu ngoặc bằng movsp a1, a8(tám tham số với WiFi.scanNetworks() ) đã sập trong underflow cửa sổ trên đường quay lại. Cũng vậy với bất kỳ lời gọi thisdài nào mà gọi setup() với nhiều hơn sáu tham số sau đủ số lần in để đẩy cửa sổ của caller xuống: mọi thứ in xong, rồi sprintf với hơn sáu tham số sau đủ nhiều lệnh print để làm tràn bộ nhớ của nơi gọi: mọi thứ được in ra, sau đó exccause=9 tại WindowUnderflow8 với vai trò setup() được trả về (trên ESP32 và S3; C3 và Pico không có cửa sổ). crates/xtensa-core/tests/alloca.rs khung mà mỗi khung di chuyển con trỏ stack xuống rồi lên bằng CALL8 và CALL12 các khung mà mỗi khung di chuyển con trỏ ngăn xếp của nó xuống rồi lên MOVSP quanh một lệnh gọi, ở mọi độ sâu từ 0 đến 40, và web/src/compile/xtensa-movsp.test.ts chạy sketch trên cả hai bo mạch.

The FPU is modeled. The ESP32's single-precision coprocessor runs on this model (crates/xtensa-core/tests/fpu.rs): the loads and stores (LSI, SSI, LSX, SSX and their post-incrementing forms), ADD.S, SUB.S, MUL.S, the fused MADD.S, MSUB.S and MADDN.S, the conversions (FLOAT.S, UFLOAT.S, TRUNC.S, UTRUNC.S, ROUND.S, FLOOR.S, CEIL.S), the compares into the boolean registers with BT, BF, MOVT and MOVF, the conditional moves, WFR, RFR, FCR and FSR, and the division and square-root steps libgcc's __divsf3 and newlib's sqrtf are built from, which return the correctly rounded IEEE answer. Arithmetic rounds to nearest whatever FCR says and sets no FSR flags. On this bare-metal model the coprocessor is on from reset, as there is no OS to turn it on at first use; the system model (docs/micropython-esp32.md) still waits for CPENABLE. So a float in an example built by Espressif's GCC through firmware/esp32/build.sh runs and prints the right number, and the browser's soft-float builds (-Xclang -target-feature -Xclang -fp, calls into mokxi_float.c) are unchanged.

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

CPU chạy ở 240 MHz, một lệnh mỗi chu kỳ, còn bus ngoại vi ở 80 MHz. 240 MHz không tương ứng một số nguyên picôgiây mỗi chu kỳ, nên thời điểm của lệnh k được tính lại là ps_for(k) = k * 12500 / 3 thay vì cộng dồn (như cách của Blue Pill và XIAO), và một lát 2400 lệnh dài đúng 10 us.

Bên trong một lát, số lệnh chính là đồng hồ: một lần đọc timer, một byte UART và một thay đổi chân đều rơi vào đúng lệnh gây ra chúng, không phải cuối lát. Bo mạch chuyển những cái đó thành các lời gọi drive_after ở cùng độ dời, nên hai lần ghi cách nhau bốn lệnh thực sự cách nhau 16.7 ns trên đường nối. RSR.CCOUNT đọc cùng đồng hồ đó.

Một core dừng trong WAITI không tốn gì: bo mạch yêu cầu được đánh thức vào thời điểm sớm nhất giữa hạn CCOMPARE tiếp theo và sườn LEDC tiếp theo, và một thay đổi chân hay một byte từ máy chủ cũng đánh thức nó.

Một lần đọc đầu vào sau một lần ghi đầu ra sẽ đợi mạch. Core chạy trước mạch một lát, và GPIO_IN_REG giữ các mức được lấy mẫu khi lát bắt đầu. Nên khi một lần ghi GPIO hay IO_MUX đã di chuyển một pad trong một lát, một lần load GPIO_IN_REG hay GPIO_IN1_REG không được trả lời: bus trả về BusError::Retry, xtensa-core dừng core trước lệnh đó mà chưa làm gì với nó, lát kết thúc tại đó, bo mạch đặt sự di chuyển lên đường nối, và lát kế tiếp lấy mẫu đầu vào và chạy lần đọc. Một lần quét keypad (kích một cột, đọc các hàng) và một dây nối từ chân này sang chân khác đều đọc được mạch đã xử lý lần ghi như thế nào. Các bo mạch AVR cũng dừng trước một lần đọc như vậy theo cùng cách.

probe là một bitmask, không phải một mức, vì bo mạch này có bốn điều đáng nói:

bit ý nghĩa
1 đang chạy
2 đỗ ở trạng thái waiti
4 LED xanh dương trên GPIO 2 sáng
8 firmware đã cố đặt một trong các chân GPIO 34 đến 39 thành đầu ra và bị từ chối

0 nghĩa là không có chương trình, bị giữ ở reset, hoặc đã sập. Bit 8 không phụ thuộc vào việc đang chạy: một chương trình đã bị từ chối đầu ra thì vẫn bị từ chối, và bo mạch tiếp tục báo như vậy.

poke: 1 giữ BOOT (kéo GPIO 0 xuống mức thấp), 0 nhả ra; 2 giữ EN, 3 nhả nó.

Kênh phía máy chủ. host_write đưa các byte vào FIFO nhận của UART0 (phần không vừa trong 128 byte của nó được giữ lại và đến cách nhau một thời gian một byte khi sketch đọc, giống như byte trên bo mạch thật nhỏ giọt theo tốc độ baud vào bộ đệm vòng của Arduino core, thay vì bị bỏ); host_read lấy các byte đã rời FIFO truyền của nó. Đó là Serial trong sketch và Serial Monitor trong giao diện. Đối với giao diện, các byte là UTF-8, còn đối với mô hình chúng chỉ là dữ liệu thô. Ổ cắm micro-USB của DevKit nối với một chip cầu CP2102 hoặc CH340 trên cổng này; bản thân chip cầu không được mô hình hóa, auto-reset qua DTR/RTS cũng không.

Sập. 1000 bẫy liên tiếp không tiến triển gì thì core bị tuyên bố là đã sập và dừng lại, kèm ghi lại chỗ nó chết.

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

Ba nhóm, rồi nhóm thứ tư dành cho các phép xấp xỉ không liên quan gì đến địa chỉ. Mục này tồn tại vì một mô hình bo mạch âm thầm đoán một địa chỉ còn tệ hơn một mô hình nói rằng nó không biết.

Lấy từ tài liệu tham khảo kỹ thuật

DPORT_BASE 0x3FF0_0000, UART0_BASE 0x3FF4_0000, GPIO_BASE 0x3FF4_4000, SENS_BASE 0x3FF4_8800, IOMUX_BASE 0x3FF4_9000, LEDC_BASE 0x3FF5_9000 và TIMG0_BASE 0x3FF5_F000. Mọi offset thanh ghi bên trong GPIO matrix và bên trong UART0, cùng RXFIFO_RST của UART_CONF0_REG (bit 17) và TXFIFO_RST (bit 18) từ thanh ghi 19.9, các trường tám bit RXFIFO_CNT và TXFIFO_CNT của UART_STATUS_REG (thanh ghi 19.8), các ngưỡng của UART_CONF1_REG (thanh ghi 19.10) và bộ chia hai mươi bit của UART_CLKDIV_REG (thanh ghi 19.6). Mặt nạ ngắt CPU mức 1 0x0006_37FF (0 đến 10, 12, 13, 17 và 18) và các ngắt CCOMPARE 6, 15 và 16, cả hai từ bảng 8.3-2 (mục 4). Cửa sổ IRAM tại 0x4008_0000 và cửa sổ DRAM tại 0x3FFB_0000. GPIO_FUNC_OUT_SEL = 256 cho "theo GPIO_OUT". Giá trị MCU_SEL là 2 cho GPIO thường. Bản đồ kênh của ADC1: các kênh 0 đến 7 là GPIO 36, 37, 38, 39, 32, 33, 34, 35. Bốn mươi chân GPIO, trong đó chân 6 đến 11 dùng cho flash và chân 34 đến 39 không có mạch lái đầu ra. LED xanh trên GPIO 2 và nút BOOT trên GPIO 0. Các offset vector của Xtensa và các số EXCCAUSE, vốn là của ISA chứ không phải của con chip.

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

  • Bảng thứ tự pad của IO_MUX (mục 3.2). Các thanh ghi được xếp theo thứ tự pad và đây là cách mô hình này hiểu mỗi GPIO tương ứng với pad nào.
  • Các offset thanh ghi của nhóm timer 0 (mục 3.4). Địa chỉ gốc là của tài liệu; bố cục bên trong thì không.
  • Bố cục của khối LEDC (mục 3.6): bước nhảy địa chỉ giữa các kênh, khối timer tại 0x140, và các thanh ghi ngắt cùng cấu hình. Địa chỉ gốc được lấy theo tài liệu.
  • Các offset và vị trí bit của SENS (mục 3.5).
  • DPORT_INTR_MAP = 0x104, và hai số nguồn, GPIO là 22 và UART0 là 34 (mục 3.7).
  • Các chỉ số tín hiệu GPIO matrix 71 đến 78 cho các kênh tốc độ cao LEDC 0 đến 7 (mục 3.1). Đây là khẳng định yếu nhất trong tài liệu.

Mỗi cái trong số đó được nêu tên ở một nơi firmware đọc (firmware/esp32/include/esp32.h), nên một image được đem sang silicon thật có một danh sách ngắn các #define để kiểm tra. crates/esp32/tests/contract.rs buộc header đó và crates/esp32/src/map.rs phải cùng số, để hai nửa không thể lệch nhau; nhưng điều đó không có nghĩa là số nào cũng đúng.

Được mô hình hóa, nhưng không theo số liệu trong tài liệu hướng dẫn

Đây là các phép xấp xỉ chứ không phải địa chỉ, và một sketch có thể thấy từng cái:

  • Các trường máy trạng thái của UART_STATUS_REG có giá trị 0 (mục 3.3). Trên silicon ST_URX_OUT và ST_UTX_OUT thay đổi khi một byte đang trên đường truyền; runtime chỉ đọc các bộ đếm tám bit, nên nó không thấy sự khác biệt.
  • ADC ở 11 dB là đường cong của một linh kiện điển hình, không phải của chính linh kiện này. Giá trị đo thô đi theo một đường khớp với các ESP32s đo thực tế (mục 3.5): vùng chết ở đáy, khúc gấp ở đỉnh và bão hòa ở khoảng 3.15 V đều có mặt, còn độ lệch giữa từng con mà bước hiệu chuẩn eFuse bù được thì không. Các mức suy giảm khác là các đường thẳng danh nghĩa.
  • Mọi pad khởi động như nhau (mục 3.2): GPIO thường, bộ đệm vào bật, không có điện trở kéo. Tài liệu cho các chân strapping và flash có các giá trị reset khác nhau.
  • GPIO_STRAP_REG là một hằng số, 0b1101, không phải mạch chốt trạng thái các chân lúc reset.
  • Một lần chuyển đổi mất đúng 5 us và một cạnh LEDC rơi đúng picôgiây. Con chip thật có jitter và không con số nào là số liệu datasheet.
  • EN chỉ có điện trở kéo lên 10 k. Tụ reset khi bật nguồn 100 nF bên cạnh nó không được mô hình hóa, nên một EN chỉ mới được nhả sẽ quay lại tức thì ở đây.
  • Không có boot ROM, và không có cây clock. Một ESP32 thật dành hàng chục mili giây trong bootloader giai đoạn một trước khi có lệnh đầu tiên của sketch; ở đây POWER_ON là 1 us, core chạy 240 MHz và clock APB 80 MHz ngay từ lệnh đầu tiên, và chẳng có gì để cấu hình cả.
  • CCOMPARE so sánh "đã đến hoặc đã qua", và một thời hạn đã nằm trong quá khứ thì không được kích hoạt (mục 4).
  • MOVSP không bao giờ kích hoạt Alloca; nó tự tạo bản sao vùng lưu base cho handler (mục 4).
  • Hai cửa sổ RAM không phải là alias của nhau. Trên con chip thật, cùng một SRAM hiện ra qua cả hai bus ở các địa chỉ khác nhau, với các khối của SRAM1 xếp theo thứ tự ngược lại (mục 2).

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

Mỗi cái trong số này là thứ bị bỏ qua chứ không phải bị bịa ra:

  • Core thứ hai. ESP32 có hai core Xtensa LX6, PRO và APP, và chỉ core PRO chạy ở đây. Không có DPORT_APPCPU_CTRL, không có ngắt liên core và không có FreeRTOS để lập lịch giữa chúng. Một sketch viết cho loop() đơn của Arduino core sẽ không nhận ra; bất cứ thứ gì khởi chạy task trên core 1 sẽ không chạy.
  • The cache, the MMU and flash. Code and constants are read from two fixed, read-only windows (section 2.1); there is no flash device, no MMU and no cache to miss, so a fetch from flash is as fast as one from IRAM. PSRAM likewise.
  • WiFi và Bluetooth, dưới mọi hình thức: không radio, không stack, không WiFi.h, thậm chí không có stub nào báo lỗi một cách lịch sự.
  • RTC, bộ nhớ chậm của nó, bộ đồng xử lý ULP, deep sleep và đơn vị quản lý nguồn.
  • ADC2, DMA và bộ điều khiển số của SAR, các eFuse hiệu chuẩn, điện áp tham chiếu nội, cảm biến chạm và cảm biến hall.
  • Nhóm tốc độ thấp của LEDC và phần cứng chuyển dần chu kỳ nhiệm vụ (duty-fade) của nó.
  • Nhóm timer 1, timer 1 của nhóm timer 0, watchdog của RTC và watchdog ngắt.
  • I2C, SPI, I2S, RMT, bộ đếm xung, PWM động cơ, SDIO, Ethernet, bộ điều khiển CAN và các bộ tăng tốc AES, SHA, RSA và RNG.
  • Ma trận ngắt ngoài các nguồn ở mục 3.7, và mọi mức ngắt CPU cao hơ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 của hai bo mạch Xtensa cũng không thể hoán đổi cho nhau. Chuỗi program trong danh mục là elf32 xtensa lx6 esp32 ở đây và elf32 xtensa lx106 esp8266 trên NodeMCU, và sự khác biệt này là thật chứ không chỉ trên giấy: core này chạy ABI dạng cửa sổ còn core kia không có cửa sổ để chạy nó, nên ảnh biên dịch cho bo mạch này sẽ lỗi trên bo mạch kia thay vì chỉ hoạt động sai âm thầm.

7. Môi trường chạy firmware (firmware/esp32/)

An Arduino-shaped runtime: setup() and loop(), pinMode, digitalWrite, digitalRead, shiftOut, analogRead (with analogReadResolution, analogSetAttenuation and analogSetPinAttenuation), analogWrite and the ledcAttach/ledcWrite/ledcRead family, millis, micros, micros64, delay, delayMicroseconds, attachInterrupt, Serial, Serial1 and Serial2, map, random. No Arduino core, no ESP-IDF, no libc.

Hàm dựng tĩnh nằm trong .ctors ở đây, chứ không phải .init_array. GCC 8.4 của Espressif được cấu hình không có --enable-initfini-array và không có -fuse-init-array, nên hàm dựng của một đối tượng toàn cục rơi vào .ctors trong khi mọi toolchain khác trong kho này phát ra .init_array. link.ld gom cả hai vào một khoảng crt0.S duyệt. Nếu không có điều đó, một sketch có đối tượng toàn cục (WebServer server(80) trong wifilamp) vẫn sẽ liên kết, chạy, và thấy các thành viên của nó bằng không. Cả hai được duyệt trong một lượt và .ctors không bị đảo thứ tự, vì thứ tự chạy của các hàm dựng giữa các translation unit không được quy định trong C++ và sketch không được phụ thuộc vào nó.

LED_BUILTIN is 2. The core has no BOOT_BUTTON: the BOOT button is GPIO 0, so sketches use 0. A0 is 36, and A3 to A7 are 39, 32, 33, 34 and 35, which is what the DevKit's own analog pins are called.

analogRead là chế độ một lần (one-shot) của ADC1 (mục 3.5), mười hai bit ở 11 dB theo mặc định. analogWrite(pin, 0..255) là tám bit ở 1 kHz trên bất kỳ GPIO nào có driver đầu ra, và gắn một kênh tốc độ cao LEDC còn tự do vào lần gọi đầu tiên; ledcAttach(pin, frequency, bits) là điều sketch cần khi tần số quan trọng, và các kênh yêu cầu cùng tần số và độ phân giải sẽ dùng chung một trong bốn timer. mokxi_pin_is_input_only(pin) được đưa vào để sketch có thể hỏi trước khi bị từ chối.

millis() và micros() lấy từ timer 0 của nhóm timer 0, một tick mỗi microgiây (mục 3.4). delayMicroseconds() dưới 50 us đếm CCOUNT, 240 chu kỳ mỗi microgiây, nên không bao giờ ngắn hơn yêu cầu (đếm timer microgiây có thể khiến delayMicroseconds(10) chỉ 9.01 us, mà HC-SR04 sẽ bỏ qua như một xung kích hoạt); từ 50 us trở lên thì chờ như delay(). delay() cho core nghỉ trên CCOMPARE0 thay vì quay vòng, nên một giây blink tốn của core chưa đến nửa triệu lệnh trong 240 triệu chu kỳ đồng hồ đếm được. attachInterrupt là ba lần ghi thay vì một, vì ngoại vi đến core phải đi qua ma trận ngắt (mục 3.7).

Serial1 và Serial2 là src/uartn.c trên UART1 và UART2 (mục 3.3a), định tuyến qua ma trận GPIO đến các chân mà begin(baud, config, rx, tx) hoặc setPins() nêu ra, với giá trị mặc định của arduino-esp32 3.x khi không nêu gì (GPIO 26 và 27 cho Serial1, 4 và 25 cho Serial2). Hành vi giống driver của ESP-IDF trên core: REF_TICK đến 250 000 baud và APB ở trên nữa, ngắt khi RXFIFO_FULL (120 byte) hoặc hết thời gian chờ nhận một ký hiệu, chuyển FIFO vào vòng (ring) kích thước setRxBufferSize() byte (256), cả khối hoặc không khối nào, khối được để riêng và ngắt nhận tắt khi vòng đầy còn ngắt tràn tiếp tục rút FIFO trong lúc đó; available() chỉ đếm vòng. write() chờ trên FIFO 128 byte và flush() chờ đến khi bộ phát rảnh. Cả hai UART dùng chung ngắt CPU 18. onReceive() chạy từ mokxi_uartn_events(), được delay(), yield() và vòng lặp trong main.cpp gọi (giữa các loop()), vì không có tác vụ FreeRTOS. Không có ở đây: điều khiển dòng (flow control), RS-485, IrDA, autobaud và bộ đệm vòng TX.

Các ví dụ mẫu được biên dịch bằng GCC của Espressif; sketch của người dùng được biên dịch bằng clang. ld.lld của LLVM thượng nguồn không liên kết được Xtensa, nên trình duyệt dùng clang-v3, bản wasm của bản phân nhánh LLVM của Espressif, vốn biên dịch được mọi ví dụ ở đây bằng danh sách lệnh của trình duyệt (docs/compile.md). Các ELF dựng sẵn vẫn là của GCC: chúng nhỏ hơn (docs/compile.md, "Code size") và không có gì cần thay đổi chúng. deploy/fetch-xtensa.sh đặt xtensa-esp32-elf-gcc 8.4.0 vào tools/xtensa/, thư mục bị gitignore: GCC thuộc giấy phép GPL, và không thứ gì nó biên dịch ở đây liên kết với libgcc hay bất kỳ phần nào khác của toolchain, nên không có dòng GPL nào lọt vào một ELF xuất đi. docs/compile.md có bản mô tả đầy đủ và các bước còn lại.

crt0.S mang sáu trình xử lý tràn và cạn cửa sổ tại VECBASE, được viết ra từ tài liệu tham khảo ISA thay vì lấy từ mã nguồn của hãng, và nó cho khung gốc một vùng lưu trữ cơ sở riêng: một cơn tràn cửa sổ của khung gốc chạy l32e a0, a1, -12 để tìm con trỏ ngăn xếp của bên gọi nó rồi ghi qua con trỏ đó, mà khung gốc không có bên gọi, nên một vùng như vậy được dựng cách đỉnh ngăn xếp sáu mươi tư byte. Nếu thiếu nó, chuỗi gọi sâu đầu tiên sẽ ghi tràn qua con trỏ null.

Lối vào ngoại lệ không chạm vào a1, và đó là điều kiện về tính đúng đắn chứ không phải sự gọn gàng: trình xử lý chạy ngay trong cửa sổ của hàm bị ngắt, và tình trạng tràn cửa sổ của một khung cũ hơn sẽ tìm chỗ để ghi tràn bằng cách đọc con trỏ ngăn xếp từ cửa sổ đó. Di chuyển a1 thì mọi khung cũ hơn sẽ ghi tràn sai chỗ và quay lại sai. Các thanh ghi bị ngắt được đưa vào một khối cố định trong .bss instead, which is safe without a lock because the handler runs at INTLEVEL 1.

Linked against firmware/esp32/link.ld: the vectors and startup code in the 128 KB of IRAM, code in the flash code window, constants in the flash constants window, .data, .bss and the stack in the 192 KB of DRAM. A WROOM-32 has 4 MB of flash and an example should be a small part of it, so the build refuses an image with more than 64 KB loadable; the real ceiling the linker script enforces is the 1,310,720 bytes of the default app partition.

Năm ví dụ, mỗi ví dụ có một sketch mà giao diện hiển thị: blink (LED trên bo mạch ở GPIO 2 và một LED được nối ở GPIO 4), button (một công tắc nối mass ở GPIO 15 với điện trở kéo lên sẵn của pad), serial (một xung mỗi giây, và in lại những gì bạn gõ), fade (một LED ở GPIO 4 trên LEDC, tám bit ở 1 kHz) và knob (một biến trở ở GPIO 32, là kênh 4 của ADC1, điều chỉnh độ sáng LED ở GPIO 4 kèm in ra giá trị đo thô). pzemmonitor, một công tơ điện PZEM-004T trên Serial2 (GPIO 16 và 17) qua thư viện PZEM004Tv30, được biên dịch bởi trình biên dịch trong trình duyệt thay vì GCC (mục 4) và là dự án ESP32 PZEM-004T energy monitor.

crates/esp32/tests/runtime.rs khởi động năm file ELF đó và đo lường thay vì chỉ quan sát: nửa chu kỳ của blink trong khoảng 5 ms quanh 500, chu kỳ của LEDC trong khoảng 5 us quanh 1 ms của 1 kHz, millis() trong khoảng 60 ms so với đồng hồ của nhân sau năm giây, và không có hai byte UART0 nào gần nhau hơn 86.8 us của 115200 baud. Mỗi bài kiểm tra tự bỏ qua khi các ảnh chưa được build, nên các bài kiểm tra của crate không bao giờ phụ thuộc vào việc có trình biên dịch chéo hay không.