Đâ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-C3 và trang bo mạch.
The first microcontroller in Mokxi. One kernel component (esp32c3 in crates/parts) wraps a SoC model (crates/esp32c3) built on the RV32IMC core (crates/rv32-core). Firmware is a plain RV32 ELF that talks to the peripherals below at their real ESP32-C3 addresses, so a program built for Mokxi also runs on a real board. Running vendor ESP-IDF or Arduino-core binaries is out of scope for Phase 2: they need the ROM, the clock tree, the cache and the interrupt matrix, none of which are modeled.
Kiểu trong danh mục là esp32c3 (bo mạch ESP32-C3-DevKitM-1). Ba nhóm phát triển cùng xây dựng dựa trên tệp này: SoC và linh kiện (Rust), runtime firmware và các ví dụ (C, clang), hình bo mạch và Serial Monitor (TypeScript). Chỉ thay đổi nó bằng cách sửa tệp này trước.
1. Chân bo mạch (thứ tự trong danh mục)
Theo thứ tự vật lý của hai dãy chân 15 chân trên DevKitM-1 (nhìn từ trên, cổng USB ở phía dưới):
Header bên trái (từ trên xuống dưới): GND, 3V3, 3V3b, 2, 3, RST, GNDb, 0, 1, 10, 4, 5, 6, 7, 8 Header bên phải (từ trên xuống dưới): 5V, 5Vb, GNDc, GNDd, 9, 18, 19, 20, 21, NC1, NC2, NC3, NC4, NC5, NC6
Các tên trùng nhau có thêm chữ cái phía sau vì tên chân trong danh mục là duy nhất. Các chân NC* có mặt để header được vẽ đầy đủ; chúng ở trạng thái trở kháng cao và không bao giờ được đọc.
Điện:
3V3*cấp 3.3 V quaR_SUPPLY;5V*cấp 5 V quaR_SUPPLY;GND*cấp 0 V quaR_SUPPLY. Bo mạch luôn được cấp nguồn (USB). Nó là nguồn cung cho phần còn lại của mạch.RSTlà ngõ vào có điện trở kéo lên 10 k bên trong tới 3.3 V; khi bị kéo xuống dưới 1.65 V nó giữ CPU ở trạng thái reset; khi nhả ra, chương trình chạy lại từ điểm vào.- GPIO
0..10, 18, 19, 20, 21là hai chiều. Khi bật đầu ra: push-pull ở 3.3 V hoặc 0 V quaR_STRONG. Khi tắt đầu ra: trở kháng cao, cộng thêm điện trở kéo lên 45 k tới 3.3 V khiFUN_WPUđược đặt trong IO_MUX, hoặc kéo xuống 45 k khiFUN_WPDđược đặt. Ngõ vào đọc điện áp trên đường nối so với 1.65 V (một nửa của 3.3 V); trạng thái Unknown đọc là 0, và ngõ vào bị lơ lửng đọc được nhiễu, giống như trên Uno (docs/uno.mdmục 1);GPIO9đọc là mức cao khi không có gì giữ nó, do điện trở kéo lên của bo mạch bên cạnh nút BOOT. - GPIO
0đến4đồng thời là các kênh ADC1 0 đến 4: điện áp trên đường nối tại năm chân đó được đọc vừa như một điện áp, vừa so với ngưỡng, nên biến trở, cần analog hoặc mạch chia áp trên một trong các chân đó là ngõ vào analog thực (mục 3.5). Một chân không có gì giữ sẽ dao động, như một ngõ vào bị lơ lửng (docs/uno.mdmục 1). - Các chân
18/19kiêm luôn là USB D-/D+ và20/21là UART0 RX/TX trên bo mạch thật; ở đây chúng là GPIO thường. Các byte UART0 đi vào kênh của máy chủ (mục 4), không ra các chân.
2. Bản đồ bộ nhớ (địa chỉ ESP32-C3 thật)
| vùng | địa chỉ | kích thước | ghi chú |
|---|---|---|---|
| SRAM, bus lệnh | 0x4037_C000 |
400 KB | một RAM, hai góc nhìn |
| SRAM, bus dữ liệu | 0x3FC7_C000 |
400 KB | cùng các byte: DRAM = IRAM - 0x0070_0000 |
| IROM (flash code) | 0x4200_0000 |
up to 1,310,720 bytes | read-only, section 2.1 |
| DROM (flash constants) | 0x3C00_0000 |
up to 1,310,720 bytes | read-only, section 2.1 |
| GPIO | 0x6000_4000 |
4 KB | mục 3.1 |
| IO_MUX | 0x6000_9000 |
4 KB | mục 3.2 |
| UART0 | 0x6000_0000 |
4 KB | mục 3.3 |
| SYSTIMER | 0x6002_3000 |
4 KB | mục 3.4 |
| APB_SARADC | 0x6004_0000 |
4 KB | mục 3.5 |
| LEDC | 0x6001_9000 |
4 KB | mục 3.7 |
| hộp thư mạng của Mokxi | 0x6FFF_E000 |
4 KB | mục 3.8. Không phải của chip: khối riêng của Mokxi, nơi chip C3 thật không có gì |
Toàn bộ 400 KB là RAM (chip thật dành phần đỉnh cho dữ liệu ROM và cache; không được mô phỏng). Bất kỳ vùng nào khác đều là lỗi truy cập (lõi xử lý bẫy; linh kiện đếm nó, xem mục 5). Các thanh ghi ngoại vi chưa ánh xạ bên trong một khối đã ánh xạ đọc là 0 và bỏ qua ghi, kèm bộ đếm để chẩn đoán.
2.1 Flash. A real ESP32-C3 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 ("Default 4MB with spiffs") gives the sketch 1,310,720 bytes of it. That is the room a sketch has here, counted as the IDE counts it (code, constants, startup code and the initial values of the variables), and the number the editor prints after a build. firmware/link.ld keeps the startup code and the trap entry in SRAM through the instruction view and puts every other function in the code window and every constant in the constants window; the variables and the stack take the SRAM from the end of the startup code up. 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 SRAM costs), and a store to one faults. RISC-V calls through AUIPC and JALR, which reach 2 GB, so no literal pools or long-call tricks are needed. The upload build (link-hw.ld) is loaded into RAM by the ROM and keeps the 400 KB SRAM as its room.
Firmware ELF: loadProgram takes an ELF32 little-endian RISC-V executable. Every PT_LOAD segment must fall inside SRAM through either view or inside one of the two flash windows. Entry is the ELF entry point; the CPU resets with pc = entry, sp = top of SRAM data view (0x3FCE_0000), all other registers zero, mtvec = 0. A load at run time resets the board.
3. Thanh ghi ngoại vi (tập con, offset thật, vị trí bit thật)
Các thanh ghi dài 32 bit và sắp theo word. Truy cập nửa word và byte vào thanh ghi không được hỗ trợ (được coi như truy cập word của word đã sắp, đó là điều chip làm khi đọc; ghi với độ hẹp hơn sẽ ghi cả word từ giá trị hẹp, không phải hành vi thật, nên firmware không được làm vậy).
3.1 GPIO (0x6000_4000)
| offset | tên | bit |
|---|---|---|
0x04 |
GPIO_OUT_REG |
bit n = mức của GPIO n khi đầu ra được bật |
0x08 |
GPIO_OUT_W1TS_REG |
ghi 1 để đặt các bit của OUT |
0x0C |
GPIO_OUT_W1TC_REG |
ghi 1 để xóa các bit của OUT |
0x20 |
GPIO_ENABLE_REG |
bit n = bộ đẩy đầu ra của GPIO n bật |
0x24 |
GPIO_ENABLE_W1TS_REG |
đặt |
0x28 |
GPIO_ENABLE_W1TC_REG |
xóa |
0x3C |
GPIO_IN_REG |
bit n = mức ngõ vào của GPIO n (cần FUN_IE) |
0x44 |
GPIO_STATUS_REG |
trạng thái ngắt, bit n |
0x4C |
GPIO_STATUS_W1TC_REG |
xóa |
0x74 + 4n |
GPIO_PINn_REG |
bit 2 PAD_DRIVER (1 = hở máng), bit 7..9 INT_TYPE (0 tắt, 1 sườn lên, 2 sườn xuống, 3 cả hai, 4 mức thấp, 5 mức cao) |
0x554 + 4n |
GPIO_FUNCn_OUT_SEL_CFG_REG |
bit 0..7 OUT_SEL: 128 = pad theo bit n của GPIO_OUT_REG (giá trị khi bật nguồn được dùng ở đây); 45 đến 50 = các kênh tốc độ thấp LEDC 0 đến 5 điều khiển nó (mục 3.7); giá trị khác không được hỗ trợ và được coi như 128 |
Các chỉ số tín hiệu 45 đến 50 chưa được kiểm chứng: đó là điều mô hình này cài đặt cho ledc_ls_sig_out0 đến ledc_ls_sig_out5, được chọn để ma trận GPIO có chỗ đặt chúng, chứ không phải một dòng trích từ bảng tín hiệu ngoại vi của tài liệu. Một pad đang được kênh LEDC điều khiển vẫn cần bật bộ đẩy đầu ra trong GPIO_ENABLE_REG, điều mà gpio_set_direction đặt trước khi ma trận được chuyển; kênh quyết định mức còn GPIO_ENABLE quyết định pad có đẩy hay không.
Chỉ có các bit 0..21 tồn tại. Hở máng: đầu ra mức cao nghĩa là trở kháng cao. Ngắt GPIO đặt GPIO_STATUS_REG và kéo đường ngắt ngoài lên (mục 3.6).
3.2 IO_MUX (0x6000_9000)
| offset | tên | bit |
|---|---|---|
0x04 + 4n |
IO_MUX_GPIOn_REG |
bit 7 FUN_WPD kéo xuống, bit 8 FUN_WPU kéo lên, bit 9 FUN_IE bật ngõ vào, bit 12..14 MCU_SEL (1 = GPIO, giá trị duy nhất được hỗ trợ; giá trị khi bật nguồn là 1 ở đây cho mọi chân nên firmware thô chạy ngay) |
3.3 UART0 (0x6000_0000)
| offset | tên | bit |
|---|---|---|
0x00 |
UART_FIFO_REG |
ghi: đẩy một byte ra TX; đọc: lấy một byte từ RX (0 khi rỗng) |
0x04 |
UART_INT_RAW_REG |
bit 0 RXFIFO_FULL, bit 1 TXFIFO_EMPTY, bit 8 RXFIFO_TOUT |
0x08 |
UART_INT_ST_REG |
thô và được bật |
0x0C |
UART_INT_ENA_REG |
|
0x10 |
UART_INT_CLR_REG |
ghi 1 để xóa |
0x14 |
UART_CLKDIV_REG |
bit 0..11 phần nguyên của số chia, bit 20..23 CLKDIV_FRAG phần mười sáu của nó, trên clock lõi (baud chỉ ảnh hưởng nhịp TX trong mục 5; được lưu, đọc lại được) |
0x1C |
UART_STATUS_REG |
bit 0..9 RXFIFO_CNT, bit 16..25 TXFIFO_CNT |
0x20 |
UART_CONF0_REG |
được lưu, đọc lại được; bit 17 RXFIFO_RST, bit 18 TXFIFO_RST xóa các FIFO (TRM v1.4 thanh ghi 26.9) |
0x24 |
UART_CONF1_REG |
bit 0..8 RXFIFO_FULL_THRHD, bit 9..17 TXFIFO_EMPTY_THRHD |
0x78 |
UART_CLK_CONF_REG |
bit 20..21 SCLK_SEL (1 là clock APB 80 MHz, 3 là thạch anh 40 MHz; 2, RC_FAST, được coi như thạch anh), bit 12..19 SCLK_DIV_NUM: clock lõi là nguồn chia cho SCLK_DIV_NUM + 1. Ra khỏi reset là thạch anh, không chia, nên CLKDIV 347 là 115 274 baud. Các phần SCLK_DIV_A/SCLK_DIV_B phân số được lưu, không được mô phỏng |
Runtime lập một tốc độ baud như cách uart_ll_set_baudrate của ESP-IDF làm: clock APB, tiền chia bởi SCLK_DIV_NUM + 1 nhỏ nhất đưa số chia xuống dưới 4096, và số chia tới một phần mười sáu, nên 1200 và 9600 baud chính xác thay vì bị kẹp ở 4095.
FIFOs are 128 bytes. TX bytes leave the FIFO at the configured baud (default 115200: one byte per 86.8 us) into the host channel; a full TX FIFO drops bytes (real behavior). RX bytes arrive from the host channel instantly. RXFIFO_TOUT raises when RX has data and no byte arrived for 10 byte times.
3.4 SYSTIMER (0x6002_3000)
Bộ đếm 52 bit tự chạy 16 MHz, một bộ so sánh nối vào ngắt timer của CPU.
| offset | tên | bit |
|---|---|---|
0x04 |
SYSTIMER_UNIT0_OP_REG |
bit 30 UPDATE: ghi 1 để chốt giá trị đếm vào VALUE_HI/LO; bit 29 VALUE_VALID đọc là 1 sau khi chốt |
0x40 |
SYSTIMER_UNIT0_VALUE_HI_REG |
bit 0..19, bit 32..51 của giá trị đếm đã chốt |
0x1C |
SYSTIMER_TARGET0_HI_REG |
bit 0..19 |
0x20 |
SYSTIMER_TARGET0_LO_REG |
|
0x34 |
SYSTIMER_TARGET0_CONF_REG |
bit 30 PERIOD_MODE, bit 0..25 PERIOD |
0x44 |
SYSTIMER_UNIT0_VALUE_LO_REG |
các bit đếm đã chốt 0..31 |
0x50 |
SYSTIMER_COMP0_LOAD_REG |
ghi 1 để nạp giá trị mục tiêu |
0x64 |
SYSTIMER_INT_ENA_REG |
bit 0 |
0x68 |
SYSTIMER_INT_RAW_REG |
bit 0 |
0x6C |
SYSTIMER_INT_CLR_REG |
bit 0 |
0x70 |
SYSTIMER_INT_ST_REG |
bit 0 |
Bộ đếm thời gian luôn chạy. Giá trị đếm được suy ra từ thời gian của kernel: count = now_ps / 62_500. Nó không bao giờ lệch so với mạch.
Đã kiểm chứng từng thanh ghi với ESP32-C3 Technical Reference Manual v1.4, mục 10.6 (bảng tóm tắt thanh ghi) và các thanh ghi 10.2, 10.14 đến 10.17. Một phiên bản trước của mô hình này đặt comparator 0 tại 0x50 đến 0x5C, vốn trên C3 là các xung nạp COMP0_LOAD đến COMP2_LOAD và UNIT0_LOAD; bố cục đó chưa từng là của con chip thật, và runtime cùng các hình ảnh của nó đã được dựng lại khi lỗi được sửa.
3.5 APB_SARADC (0x6004_0000)
ADC1 ở chế độ one-shot: đúng đường đi mà trình điều khiển adc_oneshot của ESP-IDF và analogRead của Arduino core dùng, và không gì khác. Kênh 0 đến 4 là GPIO 0 đến GPIO 4; ADC2 không được mô phỏng (trên C3 thật nó dùng chung với radio, và ở đây không có radio).
Địa chỉ cơ sở của khối là của con chip. Các offset trong bảng này đánh dấu "chưa kiểm chứng" không được lấy từ trang nào của tài liệu kỹ thuật: chúng là những gì mô hình này triển khai, được chọn để khớp với hình dạng của đường one-shot, và firmware dựng ở đây khớp với mô hình bất kể nó có khớp với silicon hay không. 0x00 và 0x04 là của tài liệu; phần còn lại của các thanh ghi one-shot là chưa kiểm chứng, và một chương trình cần chạy nguyên vẹn trên DevKitM-1 nên kiểm tra chúng với tài liệu trước.
| offset | tên | bit |
|---|---|---|
0x00 |
APB_SARADC_CTRL_REG |
bit 7..14 SAR_CLK_DIV: bộ chia clock SAR. Được lưu và đọc lại; thời gian chuyển đổi ở đây là cố định |
0x04 |
APB_SARADC_CTRL2_REG |
được lưu, đọc lại. Các đường kích hoạt bằng timer và DMA không được mô phỏng |
0x0C |
APB_SARADC_FSM_WAIT_REG |
được lưu, đọc lại (offset chưa kiểm chứng) |
0x38 |
APB_SARADC_ONETIME_SAMPLE_REG |
bit 23..24 ONETIME_ATTEN, bit 25..28 ONETIME_CHANNEL, bit 29 ONETIME_START, bit 30 SAR2_ONETIME_SAMPLE (được lưu, không chuyển đổi gì), bit 31 SAR1_ONETIME_SAMPLE (offset và vị trí trường chưa kiểm chứng) |
0x44 |
APB_SARADC_1_DATA_STATUS_REG |
bit 0..16 ADC1_DATA: kết quả chuyển đổi ADC1 gần nhất, rộng mười hai bit (offset chưa kiểm chứng) |
0x64 |
APB_SARADC_INT_ENA_REG |
được lưu; không có đường nào tới lõi (offset chưa kiểm chứng) |
0x68 |
APB_SARADC_INT_RAW_REG |
bit 31 ADC1_DONE (offset chưa kiểm chứng) |
0x6C |
APB_SARADC_INT_ST_REG |
thô và được bật (offset chưa kiểm chứng) |
0x70 |
APB_SARADC_INT_CLR_REG |
ghi 1 để xóa, cùng bit (offset chưa kiểm chứng) |
0x78 |
APB_SARADC_APB_ADC_CLKM_CONF_REG |
được lưu, đọc lại (offset chưa kiểm chứng) |
One conversion: write ONETIME_SAMPLE with SAR1_ONETIME_SAMPLE, the channel and the attenuation, write it again with ONETIME_START up, wait for ADC1_DONE in INT_RAW, read APB_SARADC_1_DATA_STATUS_REG, clear the flag and drop ONETIME_START. A conversion starts on the write that raises ONETIME_START with ADC1 taking part, and takes a fixed 5 us. The real figure depends on the SAR clock and the FSM's counts and is a few microseconds; firmware waits for it either way, since the result does not appear early.
Kết quả gồm mười hai bit, round(4095 x Vin / Vfull), được chặn lại, từ điện áp trên đường nối tại thời điểm bắt đầu chuyển đổi. ONETIME_ATTEN chọn thang đo đầy đủ, theo các con số danh nghĩa mà datasheet nêu:
ONETIME_ATTEN |
độ suy giảm | thang đo đầy đủ |
|---|---|---|
| 0 | 0 dB | 1.1 V |
| 1 | 2.5 dB | 1.5 V |
| 2 | 6 dB | 2.2 V |
| 3 | 11 dB | đường cong của linh kiện thật, bão hòa ở khoảng 2.9 V |
Ba cái đầu là các đường thẳng danh nghĩa. 11 dB (12 dB trong ESP-IDF hiện tại), mặc định của Arduino core, đi theo đường cong thô của một linh kiện điển hình (CURVE_11DB trong crates/esp32c3/src/adc.rs): gần tuyến tính qua vùng hiệu dụng 0 đến 2500 mV của datasheet (3650 tại 2.5 V), rồi tiếp tục lên 4095 tại khoảng 2.9 V (người dùng báo cáo 2.8 đến 3.0 V trên bo mạch thật). Vì vậy một biến trở nối qua nguồn 3.3 V đọc được 4095 cho phần mười cuối của hành trình, và một mạch chia ở nửa nguồn đọc khoảng 2410, không phải 2048. Hiệu chuẩn eFuse của từng con chip dịch chuyển điều này vài phần trăm, điều không được mô phỏng; analogReadMilliVolts nghịch đảo đúng đường cong đó. Một kênh không nối gì ở chân sẽ dao động, như một ngõ vào bị thả nổi (docs/uno.md mục 1).
ADC1_DONE có thể được thăm dò và xóa, đó là điều đường one-shot làm, nhưng nó không tới được mip: ADC không nằm trên đường ngắt ngoài (mục 3.6). Cả bộ điều khiển số, bảng mẫu DMA, các bộ lọc, các bộ theo dõi ngưỡng lẫn các kênh nhiệt độ trong và VDD cũng không.
3.6 Ngắt
Chế độ machine của RISC-V, mtvec direct hoặc vectored tùy theo lõi hỗ trợ. Các đường:
- Ngắt timer của bộ định thời (
mip.MTIP, cause 7): SYSTIMER target 0 khi bit 0 củaINT_ENAvà bit 0 củaINT_RAW. - Machine external interrupt (
mip.MEIP, cause 11): GPIO (GPIO_STATUS_REGnon-zero) or UART0 (UART_INT_ST_REGnon-zero). Firmware reads the two status registers to find out which. The real interrupt matrix is not modeled.
wfi đưa lõi vào chế độ chờ cho tới khi có đường nào đó chờ xử lý.
3.7 LEDC (0x6001_9000)
Bộ điều khiển LED PWM, nhóm low-speed, là nhóm duy nhất con chip này có: bốn timer và sáu kênh. Đây là khối đứng sau analogWrite, ledcAttach và ledcWrite.
A timer is a free-running counter of 2^DUTY_RES counts clocked at 80 MHz divided by CLK_DIV, which is a Q10.8 fixed-point number of APB clocks per count, so
f = 80e6 / ((CLK_DIV / 256) * 2^DUTY_RES)
và 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 timer, một số đếm bắt đầu HPOINT và một duty, và ngõ ra của nó ở mức cao từ HPOINT trong DUTY >> 4 lần đếm, cuộn quanh đỉnh của chu kỳ. Vì vậy duty bằng 0 là mức thấp liên tục và duty bằng 2^DUTY_RES là mức cao liên tục, không một cạnh nào cả, đó là lý do Arduino core biến ledcWrite(pin, 255) ở tám bit thành duty 256 thay vì để lại một khấc một đơn vị mỗi chu kỳ.
Verified: the base address, every offset in the table below and every bit it names, against the ESP32-C3 Technical Reference Manual v1.4, section 32.5 (register summary) and registers 32.1 to 32.13.
| offset | tên | bit |
|---|---|---|
0x00 + 0x14n |
LEDC_CHn_CONF0_REG |
bit 0..1 TIMER_SEL, bit 2 SIG_OUT_EN, bit 3 IDLE_LV (mức được giữ khi bộ tạo ngõ ra tắt), bit 4 PARA_UP (được lưu; duty ghi vào đây có hiệu lực ngay) |
0x04 + 0x14n |
LEDC_CHn_HPOINT_REG |
bit 0..13 HPOINT: số đếm mà xung của kênh bắt đầu |
0x08 + 0x14n |
LEDC_CHn_DUTY_REG |
bit 0..18 DUTY: độ rộng xung tính bằng một phần mười sáu của lần đếm |
0x0C + 0x14n |
LEDC_CHn_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_CHn_DUTY_R_REG |
hệ số chu kỳ hiện hành, chỉ đọc |
0xA0 + 8n |
LEDC_TIMERn_CONF_REG |
bits 0..3 DUTY_RES (1 to 14; 0 is a timer nobody has configured and it counts nothing), bits 4..21 CLK_DIV (Q10.8 APB clocks per count), bit 22 PAUSE, bit 23 RST, bit 25 PARA_UP (stored); bit 24 is reserved. TRM v1.4 register 32.7. The C3 has no per-timer TICK_SEL: the clock is chosen for all four timers in LEDC_CONF_REG. An earlier version of this model used the classic ESP32's layout here (five resolution bits and the divider from bit 5). The manual's reset value has RST set; here the register powers up as 0 |
0xA4 + 8n |
LEDC_TIMERn_VALUE_REG |
bộ đếm, chỉ đọc |
0xC0 |
LEDC_INT_RAW_REG |
bit n = timer n bị tràn |
0xC4 |
LEDC_INT_ST_REG |
thô và được bật |
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 |
ghi 1 để xóa |
0xD0 |
LEDC_CONF_REG |
bit 0..1 APB_CLK_SEL (1 = clock APB 80 MHz, nguồn duy nhất được mô phỏng), bit 31 CLK_EN (được lưu) |
0xFC |
LEDC_DATE_REG |
một con dấu phiên bản, chỉ đọc |
Việc thiết lập một kênh là công việc của ledc_timer_config và ledc_channel_config: ghi LEDC_CONF_REG, ghi DUTY_RES và CLK_DIV của timer, ghi CONF0 của kênh kèm timer và SIG_OUT_EN của nó, ghi HPOINT và DUTY, bật bit GPIO_ENABLE của chân và trỏ GPIO_FUNCn_OUT_SEL_CFG_REG của nó tới 45 + channel.
Bộ đếm không được bước rời rạc: nó là một hàm dạng đóng của thời gian mô phỏng, và thời điểm cạnh kế tiếp của nó cũng vậy. Vì vậy một nhân đang nằm ở wfi không tốn chi phí nào khi một PWM đang chạy, và phần bo mạch chỉ được đánh thức cho các cạnh và không cho gì khác.
Không được mô phỏng: nhóm tốc độ cao (chip này không có), phần cứng duty-fade, bộ đếm tràn riêng của từng kênh, các nguồn clock khác APB, và đường ngắt 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 mip, giống hệt như ADC1_DONE của ADC không tới được (mục 3.6).
3.8 Hộp thư mạng của Mokxi (0x6FFF_E000)
Khối này không phải của ESP32-C3. Mọi địa chỉ khác trong tài liệu này là của chip, trích từ tài liệu tham khảo kỹ thuật, và một image dựng dựa trên đó chạy được trên DevKitM-1 thật. Riêng khối này là của Mokxi: mạng mô phỏng của crates/net, được ánh xạ tại một địa chỉ mà linh kiện thật để trống, để một image dùng nó lỗi trên silicon thay vì đọc thanh ghi của một ngoại vi khác. Lỗi đó là câu trả lời trung thực, vì thứ đứng sau khối này không tồn tại trên chip.
Ở đâ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à 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.9 Watchdog của các nhóm timer, các reset RTC_CNTL và bộ giám sát stack (0x6001_F000, 0x6002_0000, 0x6000_8000, 0x600C_E000)
Watchdog chính của từng nhóm timer (crates/esp-common/src/mwdt.rs): WDTCONFIG0..5, WDTFEED và khóa WDTWPROTECT, bốn giai đoạn, mỗi giai đoạn có hành động riêng (một ngắt, một reset CPU hoặc một reset hệ thống), bộ chia tần trên clock APB 80 MHz hoặc, với WDT_USE_XTAL, thạch anh 40 MHz, và cấu hình được ghi sẽ có hiệu lực tại WDT_CONF_UPDATE_EN. Bit của watchdog trong TIMG_INT_ENA/RAW/ST/CLR (bit 1) phát ngắt ngoài của máy, giống như GPIO và UART0 (mục 3.6). Một giai đoạn reset sẽ reset chip với RTC_CNTL_RESET_STATE_REG cho biết lý do (7 hoặc 8 cho reset hệ thống, 0xB hoặc 0x11 cho reset CPU); RAM được nạp lại từ image, RTC_CNTL_STORE0..7 giữ nguyên giá trị, và RTC_CNTL_SW_SYS_RST cùng RTC_CNTL_SW_PROCPU_RST trong RTC_CNTL_OPTIONS0_REG cũng reset nó (nguyên nhân 3 và 0xC).
Runtime chạy task watchdog của ESP-IDF trên watchdog của nhóm timer 0, như ESP-IDF làm (firmware/src/main.cpp): tick 500 µs, giai đoạn 0 là một ngắt khi hết thời gian chờ và giai đoạn 1 là một reset hệ thống ở gấp đôi thời gian đó, khởi động trước setup() tại 5 giây kèm một panic, theo dõi idle task của nhân 0. Ngắt in các dòng của ESP-IDF ("E (…) task_wdt: Task watchdog got triggered. …", các task, "Aborting.", dòng abort và "Rebooting..."), để lại gợi ý ESP_RST_TASK_WDT của ESP-IDF trong thanh ghi RTC store và reset CPU qua phần mềm reset, 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 gì trong runtime kích hoạt nó: interrupt watchdog không được mô phỏng.
ASSIST_DEBUG's stack monitor (SP_MIN, SP_MAX, INTR_ENA, INTR_RAW, SP_PC; the region monitors are not modeled): while it is on, an instruction that would move sp outside the bounds does not retire and the board reports "firmware crashed at pc=…, stack overflow: the stack ran out of RAM (SP=…)". The runtime points SP_MIN at the top of the heap, which malloc moves, and SP_MAX at the top of RAM, so runaway recursion stops at the heap instead of running down through the program in the RAM it shares. Narrower bounds reach the core at its next pass and wider ones at once, so neither costs a sketch anything it would notice: a tight loop ran at 154 to 159 MIPS before the check and 164 to 175 after, the same within the noise of the machine.
4. Kênh host
host = "utf-8 bytes on UART0". readHost trả về các byte TX của UART0 ngay khi chúng rời FIFO; writeHost đẩy byte vào FIFO RX của UART0 (tràn thì bỏ, như trên chip thật). Serial Monitor hiển thị byte dạng văn bản, giải mã UTF-8 và coi \n là kết thúc dòng (\r bị bỏ qua).
5. Mô hình thời gian
CPU chạy ở 160 MHz với một lệnh mỗi chu kỳ. Linh kiện chạy theo lát cắt: mỗi lần được đánh thức, nó chạy SLICE_NS * 160 lệnh (SLICE_NS = 10 us, tức 1600 lệnh) rồi đặt lịch đánh thức tiếp theo, với các quy tắc sau:
- Các ghi vào ngoại vi làm thay đổi chân (GPIO OUT hoặc ENABLE, điện trở kéo của IO_MUX) sẽ điều khiển chân tại thời điểm bắt đầu lát cắt cộng với số lệnh đã chạy chia cho 160 MHz. Dùng
drive_aftervới độ trễ đó để hai lần bật/tắt trong cùng một lát cắt giữ nguyên khoảng cách của chúng. Việc đọc GPIO_IN thấy mức chân tính từ lúc bắt đầu lát cắt. - So sánh của bộ đếm giờ và nhịp UART được tính theo cùng thời gian trong lát cắt, nên
micros()là đơn điệu tăng vàdelayMicrosecondsbằng vòng lặp chờ chính xác đến một lệnh. - Cycle counters:
rdcycle/cycle(0xC00,0xC80),mcycle/mcycleh(0xB00,0xB80) and the ESP32-C3's own performance counter,mpcer/mpcmr/mpccr(0x7E0to0x7E2, user views0x800to0x802, the one ESP-IDF'sesp_cpu_get_cycle_countreads), all read without trapping and count one per 160 MHz cycle, which is one per instruction.mpccrcounts from reset (mpcerandmpcmrread 1); a write sets it, andmpcmrbit 0 clear holds it. None of them advance while the core is parked inwfi. wfi: linh kiện ngừng cắt lát và đặt lịch đánh thức vào thời điểm sớm nhất giữa mục tiêu của bộ đếm giờ và một sự kiện UART; chân GPIO thay đổi sẽ đánh thức ngay lập tức.- Lỗi truy cập: lõi xử lý trap đến
mtvec; vớimtvec = 0thì sẽ trap lại mãi mãi. Linh kiện đếm số trap và sau 1000 trap liên tiếp không tiến triển gì thì dừng lại và báo "firmware crashed at pc=…, mcause=…" quaprobe(xem bên dưới) và kênh host (một dòng).
Probe: 1 when running, 0 when halted (no program, in reset, or crashed), 0.5 while parked in wfi. Poke: 1 = press the BOOT button (GPIO 9 low while held), 0 = release; 2 = press RST, 3 = release RST. The UI gives the board interaction: 'hold' on its RST button region only if the visual supports region-specific interaction; for Phase 2 the whole board is not interactive, and BOOT/RST are wired to pushbuttons by users if they want them.
6. Môi trường chạy firmware (firmware/)
A freestanding C and C++ runtime built with clang (--target=riscv32-unknown-elf -march=rv32imc -mabi=ilp32) and lld, no libc, no GPL: crt0.S (stack, .data copy, .bss clear, trap vector, main), esp32c3.h (the registers above as macros), arduino.h with pinMode, digitalWrite, digitalRead, analogRead (one-shot ADC1 on GPIO 0..4, twelve bits, with analogReadResolution, analogSetAttenuation and analogSetPinAttenuation), analogWrite and the ledcAttach/ledcWrite pair (LEDC, section 3.7: eight bits at 1 kHz on any GPIO by default, with analogWriteResolution and analogWriteFrequency, and a channel allocated to a pin the first time it is written to), delay, delayMicroseconds, millis, micros, Serial.begin/print/println/write/available/read (a small C++ Print class with integer, float, string and char overloads), attachInterrupt for GPIO. The sketch is setup() and loop(). build.sh compiles every example under firmware/examples/ to web/public/firmware/<name>.elf, which the UI ships. Examples: blink (GPIO 8, the DevKitM-1 LED pin, 500 ms), button (GPIO 9 with pull-up lights GPIO 8), serial (prints millis() once a second and echoes what it receives), fade (bit-banged PWM on GPIO 8 for a breathing LED), counter (74HC595 driven on GPIO 4 = DS, 5 = SHCP, 6 = STCP, counting on eight LEDs), interrupt (attachInterrupt on GPIO 9 counts presses and prints the count), pwmfade (the same breathing LED as fade, on analogWrite rather than by hand, so the core sleeps through it), servo (an SG90 swept end to end by a 50 Hz LEDC channel on GPIO 4).
The board's code in the editor is not compiled in Phase 2 (see docs/compile-options.md); the UI offers the built-in examples and an ELF upload.
7. Những gì mô hình này chắc chắn, và những gì không chắc chắn
Ba nhóm, cùng cách phân loại mà mục 7 của docs/esp32c6.md dùng. Nó 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.
Taken from the technical reference manual, and run through by real firmware.
UART0_BASE = 0x6000_0000, GPIO_BASE = 0x6000_4000, IOMUX_BASE = 0x6000_9000,
SYSTIMER_BASE = 0x6002_3000, APB_SARADC_BASE = 0x6004_0000 and
LEDC_BASE = 0x6001_9000, with every register offset inside the GPIO, IO_MUX, UART0,
SYSTIMER and LEDC blocks. Checked against the ESP32-C3 Technical Reference Manual
v1.4 while the ESP32-S3 was being added: the SYSTIMER comparator 0 offsets (section
10.6: TARGET0_HI 0x1C, TARGET0_LO 0x20, TARGET0_CONF 0x34, COMP0_LOAD 0x50),
LEDC_TIMERn_CONF_REG's fields (register 32.7), LEDC's interrupt and global registers
(registers 32.3 and 32.9 to 32.13) and UART_CONF0_REG's FIFO resets (register 26.9).
The first two and the last were wrong here before that check and were corrected, with
the runtime's images rebuilt. The GPIO range 0 to
21, ADC1's channel map (channel n is GPIO n for n in 0 to 4), the 400 KB of
SRAM at two views 0x0070_0000 apart, and the 16 MHz SYSTIMER tick. Each of those blocks
is driven by a test that loads a real ELF and runs it:
crates/esp32c3/tests/firmware.rs for GPIO, UART0 and SYSTIMER, and
tests/examples.rs's pwmfade and servo for LEDC.
Được tin là đúng, chưa kiểm chứng. Được nêu đích danh từng thanh ghi trong các mục 3.1 và 3.5, và nhắc lại ở đây để danh sách nằm tại một nơi:
- Mọi offset thanh ghi one-shot bên trong
APB_SARADCtrừ0x00và0x04. Đó làFSM_WAITở 0x0C,ONETIME_SAMPLEở 0x38 và vị trí các trường của nó,1_DATA_STATUSở 0x44, bốn thanh ghi ngắt từ 0x64 đến 0x70, vàAPB_ADC_CLKM_CONFở 0x78. Chúng là những gì mô hình này triển khai, được chọn để khớp với hình dạng của đường one-shot, chứ không phải các dòng trích từ một trang của tài liệu. - Các chỉ số tín hiệu 45 đến 50 của ma trận GPIO cho
ledc_ls_sig_out0đếnledc_ls_sig_out5, được chọn để ma trận có chỗ đặt chúng.
Firmware dựng cho tài liệu này khớp với mô hình, bất kể nó có khớp với chip thật hay không. Một ảnh được đem sang DevKitM-1 thật nên kiểm tra các #define đó trong firmware/include/esp32c3.h với tài liệu trước.
Được mô hình hóa, nhưng không bị ràng buộc theo các con số trong tài liệu. Là các hành vi chứ không phải địa chỉ:
- 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 đơn vị này. Bão hòa ở khoảng 2,9 V và độ lợi trên dải hiệu dụng 2,5 V có mặt ở đây (mục 3.5); độ lệch giữa các đơn vị mà hiệu chỉnh eFuse bù cho, và nhiễu chuyển đổi, thì không. Các mức suy giảm còn lại là các đường thẳng danh nghĩa (1,1 V; 1,5 V; 2,2 V).
- Một lệnh là một chu kỳ ở 160 MHz. Không có cản đường ống (pipeline stall), không có cache (vốn không có cache), không có chu kỳ chờ flash và không có tranh chấp bus, nên số lệnh chính là xung nhịp. Một C3 thật chạy từ flash chậm hơn và kém đều đặn hơn thế.
- Các pad là ba trạng thái và một ngưỡng. Push-pull ở 3,3 V, high-Z, hoặc điện trở kéo trong 45 kΩ, đọc lại so với một nửa nguồn cấp, không có trễ (hysteresis), không có cài đặt độ mạnh dẫn, không có thời gian lên và không có giới hạn dòng. Một chân không được dẫn đọc là 0 thay vì trôi tới một giá trị nào đó.
- Bo mạch là một nguồn cấp lý tưởng: 3V3 và 5V ở trở kháng bằng nguồn mãi mãi, nên không có gì sụt áp. Khởi động mất một microgiây, trong khi một C3 thật tiêu tốn hàng chục mili giây trong boot ROM của nó.
- Một lát cắt là 10 µs, và SoC gặp mạch tại các biên lát cắt hoặc tại thứ mà chip đang chờ.
Cố ý không có. Được bỏ ngoài chứ không phải bịa ra, vì bố cục thanh ghi không phải thứ mô hình này có thể tái tạo một cách trung thực: Bluetooth LE (không radio, và không giả vờ có), SPI, I2C, I2S, RMT, USB Serial/JTAG, các bộ định thời của nhóm timer (watchdog của chúng là của mục 3.9), ma trận ngắt đầy đủ (mục 3.6 nói rõ thứ thay thế nó), ADC2 và bảng mẫu DMA của SAR ADC, bộ điều khiển số, các bộ lọc, bộ theo dõi ngưỡng và eFuse hiệu chỉnh, nhóm tốc độ cao của LEDC cùng phần cứng duty-fade và đường ngắt của nó vào lõi, PMU và cây clock, cache, ROM và flash. Đó 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 dựng cho tài liệu này thì chạy.
WiFi: được mô phỏng, xem docs/wifi.md. It was in the list above until September
2026, as "absent: WiFi in every form". It is not absent any more and it is not
modeled either: there is no radio and no 802.11, and what there is instead is
section 3.8's mailbox (a block this chip does not have, at an address it leaves
unmapped) with a network written in software behind it. docs/wifi.md là bản hợp đồng cho việc mạng đó làm gì và, nói kỹ hơn, cho việc nó không làm gì.