Bu, modelin mühendislik referansıdır: neyi uyguladığını, yazmaç yazmaç, ona karşı firmware yazan kişiler için. Kartı düzenleyicide kullanmak için başlangıç noktan ESP32-C3 ve kart sayfası.
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.
Katalog türü esp32c3'tür (ESP32-C3-DevKitM-1 kartı). Üç aracı bu dosyaya göre derlenir: SoC ve parça (Rust), firmware çalışma zamanı ve örnekler (C, clang), kart görseli ve seri monitör (TypeScript). Bunu yalnızca önce bu dosyayı düzenleyerek değiştirin.
1. Kart pinleri (katalog sırası)
DevKitM-1'deki iki 15 pinli konektörün fiziksel sırasına göre (üstten görünüm, USB konektörü altta):
Sol başlık (yukarıdan aşağıya): GND, 3V3, 3V3b, 2, 3, RST, GNDb, 0, 1, 10, 4, 5, 6, 7, 8 Sağ başlık (yukarıdan aşağıya): 5V, 5Vb, GNDc, GNDd, 9, 18, 19, 20, 21, NC1, NC2, NC3, NC4, NC5, NC6
Yinelenen adlar bir harf eki taşıyor çünkü katalog pin adları benzersizdir. NC* pinleri başlığın eksiksiz çizilmesi için vardır; yüksek empedanslıdırlar ve asla okunmazlar.
Elektriksel:
3V3*pinleriR_SUPPLYüzerinden 3,3 V üretir;5V*pinleriR_SUPPLYüzerinden 5 V üretir;GND*pinleriR_SUPPLYüzerinden 0 V üretir. Kart her zaman güç alır (USB). Devrenin geri kalanı için bir güç kaynağıdır.RST, 10 k içeri çekme direnciyle 3,3 V'a bağlı bir giriştir; 1,65 V altına çekilirse CPU'yu reset halinde tutar; bırakıldığında program giriş noktasından yeniden başlar.- GPIO
0..10, 18, 19, 20, 21pinleri giriş/çıkışlıdır. Çıkış etkin:R_STRONGüzerinden 3,3 V veya 0 V it-çek. Çıkış devre dışı: yüksek empedans, ayrıca IO_MUX içindeFUN_WPUayarlıysa 45 k'lık 3,3 V'a çekme,FUN_WPDayarlıysa 45 k'lık aşağı çekme. Giriş, ağ voltajını 1,65 Volta (3,3 Volun yarısı) karşı okur; Unknown 0 okur ve boştaki giriş, Uno'daki gibi gürültü okur (docs/uno.mdbölüm 1);GPIO9, hiçbir şey tutmuyorsa, BOOT butonunun yanındaki kart çekmesi sayesinde yüksek okur. - GPIO
0ile4aynı zamanda ADC1 kanalları 0 ile 4'tür: bu beş pindeki ağ voltajı hem eşik değeriyle hem de voltaj olarak okunur, yani biri üzerindeki bir potansiyometre, bir kumanda kolu veya bir bölücü gerçek bir analog giriştir (bölüm 3.5). Hiçbir şeyin tutmadığı bir pin, boşta bir girişin yapacağı gibi gezinir (docs/uno.mdbölüm 1). 18/19pinleri gerçek kartta USB D-/D+ olarak,20/21pinleri UART0 RX/TX olarak da kullanılır; burada düz GPIO'durlar. UART0 baytları pinlere değil, ana makine kanalına gider (bölüm 4).
2. Bellek haritası (gerçek ESP32-C3 adresleri)
| bölge | adres | boyut | notlar |
|---|---|---|---|
| SRAM, komut veriyolu | 0x4037_C000 |
400 KB | tek RAM, iki görünüm |
| SRAM, veri veriyolu | 0x3FC7_C000 |
400 KB | aynı baytlar: 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 | bölüm 3.1 |
| IO_MUX | 0x6000_9000 |
4 KB | bölüm 3.2 |
| UART0 | 0x6000_0000 |
4 KB | bölüm 3.3 |
| SYSTIMER | 0x6002_3000 |
4 KB | bölüm 3.4 |
| APB_SARADC | 0x6004_0000 |
4 KB | bölüm 3.5 |
| LEDC | 0x6001_9000 |
4 KB | bölüm 3.7 |
| Mokxi ağ posta kutusu | 0x6FFF_E000 |
4 KB | bölüm 3.8. Çipin değil: gerçek bir C3'te hiçbir şeyin olmadığı yerde Mokxi'nin kendi bloğu |
Tamamı 400 KB RAM'dir (gerçek çipler en üst kısmı ROM verisi ve önbellek için ayırır; modellenmedi). Gerisi erişim hatasıdır (çekirdek yakalar; parça sayar, bkz. bölüm 5). Eşlenmiş bir bloğun içindeki eşlenmemiş çevre birimi yazmaçları 0 okur ve yazmaları yok sayar, teşhis için bir sayaç bulunur.
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. Çevre birimi kayıtları (alt küme, gerçek ofsetler, gerçek bit konumları)
Yazmaçlar 32 bittir ve kelime hizalıdır. Yazmaça yarım kelime ve bayt erişimi desteklenmez (hizalı kelimenin kelime erişimi olarak ele alınır; okumalarda çipin yaptığı budur; daha dar genişlikte yazmalar tüm kelimeyi dar değerden yazar, gerçek bir davranış değildir, dolayısıyla firmware bunu yapmamalıdır).
3.1 GPIO (0x6000_4000)
| ofset | ad | bitler |
|---|---|---|
0x04 |
GPIO_OUT_REG |
bit n = çıkış etkinken GPIO n seviyesi |
0x08 |
GPIO_OUT_W1TS_REG |
OUT bitlerini ayarlamak için 1 yaz |
0x0C |
GPIO_OUT_W1TC_REG |
OUT bitlerini temizlemek için 1 yaz |
0x20 |
GPIO_ENABLE_REG |
bit n = GPIO n çıkış sürücüsü açık |
0x24 |
GPIO_ENABLE_W1TS_REG |
ayarla |
0x28 |
GPIO_ENABLE_W1TC_REG |
temizle |
0x3C |
GPIO_IN_REG |
bit n = GPIO n giriş seviyesi (FUN_IE gerekir) |
0x44 |
GPIO_STATUS_REG |
kesme durumu, bit n |
0x4C |
GPIO_STATUS_W1TC_REG |
temizle |
0x74 + 4n |
GPIO_PINn_REG |
bit 2 PAD_DRIVER (1 = açık kolektör), bit 7..9 INT_TYPE (0 kapalı, 1 yükselen, 2 düşen, 3 her ikisi, 4 düşük seviye, 5 yüksek seviye) |
0x554 + 4n |
GPIO_FUNCn_OUT_SEL_CFG_REG |
bit 0..7 OUT_SEL: 128 = pad, GPIO_OUT_REG bit n'yi izler (burada kullanılan açılış değeri); 45 ile 50 = LEDC düşük hızlı kanallar 0 ile 5 onu sürer (bölüm 3.7); diğer her değer desteklenmez ve 128 gibi ele alınır |
45 ile 50 arasındaki sinyal dizinleri doğrulanmamıştır: bunlar bu modelin ledc_ls_sig_out0 ile ledc_ls_sig_out5 için uyguladığı değerlerdir; GPIO matrisinin bunları yerleştirecek bir yerinin olması için seçilmiş olup kılavuzdaki çevre birimi sinyal tablosundan alınmış bir satır değildir. Bir LEDC kanalının sürdüğü pad için yine de GPIO_ENABLE_REG içindeki çıkış sürücüsünün açık olması gerekir; bunu matris değiştirilmeden önce gpio_set_direction ayarlar. Seviyeyi kanal belirler, pad'in hiç sürüp sürmediğini ise GPIO_ENABLE belirler.
Yalnızca bit 0..21 mevcuttur. Açık kolektör: çıkışın yüksek olması yüksek empedans demektir. GPIO kesmeleri GPIO_STATUS_REG ayarlar ve dış kesme hattını yükseltir (bölüm 3.6).
3.2 IO_MUX (0x6000_9000)
| ofset | ad | bitler |
|---|---|---|
0x04 + 4n |
IO_MUX_GPIOn_REG |
bit 7 FUN_WPD aşağı çekme, bit 8 FUN_WPU yukarı çekme, bit 9 FUN_IE giriş etkin, bit 12..14 MCU_SEL (1 = GPIO, desteklenen tek değer; her pin için burada açılış değeri 1, böylece çıplak firmware doğrudan çalışır) |
3.3 UART0 (0x6000_0000)
| ofset | ad | bitler |
|---|---|---|
0x00 |
UART_FIFO_REG |
yazma: TX'e bir bayt it; okuma: RX'den bir bayt çek (boşken 0) |
0x04 |
UART_INT_RAW_REG |
bit 0 RXFIFO_FULL, bit 1 TXFIFO_EMPTY, bit 8 RXFIFO_TOUT |
0x08 |
UART_INT_ST_REG |
ham ve etkin |
0x0C |
UART_INT_ENA_REG |
|
0x10 |
UART_INT_CLR_REG |
temizlemek için 1 yaz |
0x14 |
UART_CLKDIV_REG |
bit 0..11 bölünenin tam kısmı, bit 20..23 CLKDIV_FRAG on altıda birleri, çekirdek saatinden (baud yalnızca bölüm 5'teki TX hızlandırmayı etkiler; saklanır, geri okunur) |
0x1C |
UART_STATUS_REG |
bit 0..9 RXFIFO_CNT, bit 16..25 TXFIFO_CNT |
0x20 |
UART_CONF0_REG |
saklanır, geri okunur; bit 17 RXFIFO_RST, bit 18 TXFIFO_RST FIFO'ları temizler (TRM v1.4 yazmaç 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, 80 MHz APB saati; 3, 40 MHz kristal; 2, yani RC_FAST, kristal olarak ele alınır), bit 12..19 SCLK_DIV_NUM: çekirdek saati, kaynak SCLK_DIV_NUM + 1 ile bölünmüş halidir. Resetten çıkışta kristal, bölünmemiş, dolayısıyla CLKDIV 347, 115 274 baud'a karşılık gelir. Kesirli SCLK_DIV_A/SCLK_DIV_B saklanır, modellenmez |
Çalışma zamanı baud hızını ESP-IDF'in uart_ll_set_baudrate işlevi gibi programlar: APB saati, bölüneni 4096 altına indiren en küçük SCLK_DIV_NUM + 1 ile ön ölçeklenir ve bölünen on altıda bir hassasiyetle ayarlanır, böylece 1200 ve 9600 baud, 4095'te kırpılmak yerine tam çıkar.
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)
16 MHz serbest çalışan 52 bit sayaç, CPU zamanlayıcı kesmesine bağlı bir karşılaştırıcı.
| ofset | ad | bitler |
|---|---|---|
0x04 |
SYSTIMER_UNIT0_OP_REG |
bit 30 UPDATE: sayımı VALUE_HI/LO'ya geçirmek için 1 yaz; bit 29 VALUE_VALID, geçirme yapıldıktan sonra 1 okur |
0x40 |
SYSTIMER_UNIT0_VALUE_HI_REG |
bit 0..19, geçilen sayım bit 32..51 |
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 |
sabitlenmiş sayı bitleri 0..31 |
0x50 |
SYSTIMER_COMP0_LOAD_REG |
hedefi yüklemek için 1 yazın |
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 |
Zamanlayıcı her zaman çalışır. Sayı, çekirdek zamanından türetilir: count = now_ps / 62_500. Devreden asla sapmaz.
Doğrulandı: kayıt kayıt, ESP32-C3 Technical Reference Manual v1.4, bölüm 10.6 (kayıt özeti) ve 10.2, 10.14 ile 10.17 numaralı kayıtlarla karşılaştırıldı. Bu modelin önceki bir sürümü karşılaştırıcı 0'ı 0x50 ile 0x5C arasına koymuştu; bu adresler C3'te COMP0_LOAD ile COMP2_LOAD ve UNIT0_LOAD yükleme stroblarıdır; bu düzen hiçbir zaman çipin düzeni değildi ve düzeltildiğinde çalışma zamanı ve görselleri yeniden oluşturuldu.
3.5 APB_SARADC (0x6004_0000)
Tek atım modunda ADC1: ESP-IDF'nin adc_oneshot sürücüsünün ve Arduino çekirdeğinin analogRead fonksiyonunun izlediği yol, başka hiçbir şey değil. 0 ile 4 arası kanallar GPIO 0 ile GPIO 4'tür; ADC2 modellenmedi (gerçek bir C3'te radyoyla paylaşılır, burada radyo yoktur).
Blokun temel adresi çipin adresidir. Bu tabloda "doğrulanmadı" işaretli kaymalar teknik referans kılavuzunun bir sayfasından alınmadı: bunlar bu modelin uyguladığı, tek atım yolunun biçimine uyacak şekilde seçilmiş değerlerdir ve burada derlenen firmware modelle uyumlu olur; silikonla uyumlu olup olmadığıysa ayrı bir konudur. 0x00 ve 0x04 kılavuzundaki değerlerdir; tek atım kayıtlarının geri kalanı doğrulanmamış olanlardır ve bir DevKitM-1'de değiştirilmeden çalışması gereken bir program bunları önce kılavuzla karşılaştırmalıdır.
| ofset | ad | bitler |
|---|---|---|
0x00 |
APB_SARADC_CTRL_REG |
bit 7..14 SAR_CLK_DIV: SAR saat bölücü. Saklanır ve geri okunur; buradaki dönüşüm zamanlaması sabittir |
0x04 |
APB_SARADC_CTRL2_REG |
saklanır, geri okunur. Zamanlayıcı tarafından tetiklenen yol ve DMA yolu modellenmedi |
0x0C |
APB_SARADC_FSM_WAIT_REG |
saklanır, geri okunur (doğrulanmamış kayma) |
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 (saklanır, hiçbir şey dönüştürmez), bit 31 SAR1_ONETIME_SAMPLE (doğrulanmamış kayma ve alan konumları) |
0x44 |
APB_SARADC_1_DATA_STATUS_REG |
bit 0..16 ADC1_DATA: son ADC1 dönüşümü, on iki bit genişliğinde (doğrulanmamış kayma) |
0x64 |
APB_SARADC_INT_ENA_REG |
saklanır; çekirdeğe ulaşan bir hat yok (doğrulanmamış kayma) |
0x68 |
APB_SARADC_INT_RAW_REG |
bit 31 ADC1_DONE (doğrulanmamış kayma) |
0x6C |
APB_SARADC_INT_ST_REG |
ham ve etkin (doğrulanmamış kayma) |
0x70 |
APB_SARADC_INT_CLR_REG |
temizlemek için 1 yaz, aynı bit (doğrulanmamış kayma) |
0x78 |
APB_SARADC_APB_ADC_CLKM_CONF_REG |
saklanır, geri okunur (doğrulanmamış kayma) |
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.
Sonuç on iki bittir: round(4095 x Vin / Vfull), dönüşüm başladığı andaki ağ geriliminden, kırpılmış olarak. ONETIME_ATTEN tam ölçeği seçer, veri sayfasının verdiği nominal değerlerde:
ONETIME_ATTEN |
zayıflatma | tam ölçek |
|---|---|---|
| 0 | 0 dB | 1.1 V |
| 1 | 2.5 dB | 1.5 V |
| 2 | 6 dB | 2.2 V |
| 3 | 11 dB | gerçek parçanın eğrisi, yaklaşık 2.9 V'ta doyuyor |
İlk üçü nominal düz doğrulardır. 11 dB (güncel ESP-IDF'de 12 dB), Arduino çekirdeğinin varsayılanı, tipik bir parçanın ham eğrisini izler (crates/esp32c3/src/adc.rs içindeki CURVE_11DB): veri sayfasındaki 0 ile 2500 mV etkin aralığında (2.5 V'ta 3650) doğrusala yakın, sonra yaklaşık 2.9 V'ta 4095'e kadar uzanır (gerçek cihazlarda insanlar 2.8 ile 3.0 V bildirir). Yani 3.3 V hattına bağlı bir pot, dönüşünün son onda birinde 4095 okur ve hattın yarısındaki bir bölücü yaklaşık 2410 okur, 2048 değil. Bir cihazın eFuse kalibrasyonu bunu birkaç yüzde kaydırır; bu modellenmedi. analogReadMilliVolts aynı eğriyi tersine çevirir. Pininde hiçbir şey olmayan bir kanal, yüzen bir girişin yaptığı gibi gezinir (docs/uno.md bölüm 1).
ADC1_DONE sorgulanabilir ve temizlenebilir, tek atım yolunun yaptığı budur, ama mip kaydına ulaşmaz: ADC harici kesme hattında değildir (bölüm 3.6). Dijital denetleyici, DMA örüntü tablosu, filtreler, eşik izleyicileri ve dahili sıcaklık ile VDD kanalları da değildir.
3.6 Kesmeler
RISC-V makine modu, mtvec doğrudan ya da çekirdeğin desteklediği şekilde vektörlü. Hatlar:
- Makine zamanlayıcı kesmesi (
mip.MTIP, neden 7):INT_ENA0. bit veINT_RAW0. bit olduğunda SYSTIMER hedef 0. - 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, herhangi bir hat beklemede olana kadar çekirdeği duraklatır.
3.7 LEDC (0x6001_9000)
LED PWM denetleyicisi, yavaş grup; bu çipte olan tek grup odur: dört zamanlayıcı ve altı kanal. analogWrite, ledcAttach ve ledcWrite arkasındaki blok budur.
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)
sekiz bitta 5 kHz, tam olarak DUTY_RES 8 ve CLK_DIV 16000'dir. Bir kanal bir zamanlayıcı, bir başlangıç sayısı olan HPOINT ve bir görev saykılı seçer; çıktısı, HPOINT değerinden itibaren DUTY >> 4 sayı boyunca yüksektir ve dönemin tepesinde sarar. Yani görev saykılı 0 düz bir düşük, 2^DUTY_RES ise düz bir yüksektir, hiç kenar yoktur; Arduino çekirdeğinin sekiz bitta ledcWrite(pin, 255) çağrısını 256 görev saykılına çevirmesinin nedeni de budur, yoksa her dönemde tek sayılık bir çentik kalırdı.
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.
| ofset | ad | bitler |
|---|---|---|
0x00 + 0x14n |
LEDC_CHn_CONF0_REG |
bit 0..1 TIMER_SEL, bit 2 SIG_OUT_EN, bit 3 IDLE_LV (çıktı üreteci kapalıyken tutulan seviye), bit 4 PARA_UP (saklanır; buraya yazılan görev saykılı hemen etkin olur) |
0x04 + 0x14n |
LEDC_CHn_HPOINT_REG |
bit 0..13 HPOINT: kanalın darbesinin başladığı sayı |
0x08 + 0x14n |
LEDC_CHn_DUTY_REG |
bit 0..18 DUTY: sayının on altıda biri cinsinden darbe genişliği |
0x0C + 0x14n |
LEDC_CHn_CONF1_REG |
görev döngüsü soldurma donanımı: saklanır, geri okunur ve hiçbir şeyi soldurmaz |
0x10 + 0x14n |
LEDC_CHn_DUTY_R_REG |
halihazırdaki görev döngüsü, salt okunur |
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 |
sayaç, salt okunur |
0xC0 |
LEDC_INT_RAW_REG |
bit n = zamanlayıcı n taştı |
0xC4 |
LEDC_INT_ST_REG |
ham ve etkin |
0xC8 |
LEDC_INT_ENA_REG |
saklanır; çekirdeğe ulaşan bir hat yoktur |
0xCC |
LEDC_INT_CLR_REG |
temizlemek için 1 yaz |
0xD0 |
LEDC_CONF_REG |
bit 0..1 APB_CLK_SEL (1 = 80 MHz APB saati, modellenen tek kaynak), bit 31 CLK_EN (saklanır) |
0xFC |
LEDC_DATE_REG |
bir sürüm damgası, salt okunur |
Bir kanalı kurmak, ledc_timer_config ve ledc_channel_config işlevlerinin yaptığı şeydir: LEDC_CONF_REG yazılır, zamanlayıcının DUTY_RES ve CLK_DIV değerleri yazılır, kanalın CONF0 kaydına zamanlayıcısı ve SIG_OUT_EN yazılır, HPOINT ve DUTY yazılır, pinin GPIO_ENABLE biti ayarlanır ve GPIO_FUNCn_OUT_SEL_CFG_REG kaydı 45 + channel değerine yönlendirilir.
Sayaç adım adım ilerletilmez: simüle edilmiş zamanın kapalı bir fonksiyonudur ve bir sonraki kenarının zamanı da öyledir. Bu yüzden wfi ile beklemeye geçmiş bir çekirdek, bir PWM çalışırken hiçbir şeye mal olmaz; kart parçası yalnızca kenarlar için uyandırılır, başka hiçbir şey için değil.
Modellenmeyenler: yüksek hız grubu (bu çipte yok), görev soldurma donanımı, bir kanalın kendi taşma sayacı, APB dışındaki saat kaynakları ve LEDC'nin kesme matrisine giden kesme hattı. LEDC_INT_RAW_REG okunup temizlenebilir ama mip'e asla ulaşmaz, tıpkı ADC'nin ADC1_DONE'ının ulaşmadığı gibi (bölüm 3.6).
3.8 Mokxi ağ posta kutusu (0x6FFF_E000)
Bu blok ESP32-C3'ün değil. Bu belgedeki diğer bütün adresler, teknik referans kılavuzundan alıntılanmış şekilde çipe aittir ve buna göre derlenen bir imaj gerçek bir DevKitM-1 üzerinde çalışır. Bu blok ise Mokxi'ye aittir: crates/net simüle ağının kendisi, gerçek parçanın eşlemesiz bıraktığı bir adrese yerleştirilmiştir; böylece onu kullanan bir imaj silisyumda hata verir ve başka bir çevre biriminin kaydını okumaz. O hata dürüst cevaptır, çünkü bu bloğun arkasındaki şey çipte yoktur.
Burada radyo, 802.11 ve gerçek internet yoktur. Modelde hiçbir şey iletilmez, taranmaz, ilişkilendirilmez, şifrelenmez veya soket açılmaz: bir parola dizgi olarak karşılaştırılır, .mokxi altında olmayan bir ad çözümlenmez ve ağın hizmet verdiği üç kaynak, crates/net/src/http.rs içindeki fonksiyonlardır. Posta kutusu, bir MAC hakkındaki bir kurgu değil, gerçek ara yüzün biçimidir: gerçek bir ESP32'de WiFi donanımı, komut arabirimli kapalı bir ikili bloktur ve Arduino'nun WiFi.h kitaplığı bunlardan birinin öbür tarafında biter. Arkasında ne olduğunu belirleyen sözleşme docs/wifi.md dosyasıdır; bu bölüm yalnızca yazmaçlardır.
Bir komut yazmacı, bir durum yazmacı, her yönde 4096 baytlık bir halka ve bir kesme biti. NET_CMD_REG'e yazmak komutu çalıştırır; simüle edilmiş zaman alan bir komut BUSY'yi yükseltir ve bittiğinde onu temizler; NET_INT_RAW_REG içinde DONE belirir.
| ofset | ad | bitler |
|---|---|---|
0x00 |
NET_ID_REG |
0x494B4F4D okur, başka hiçbir şey okumaz. Mokxi'de olup olmadığını öğrenmek isteyen bir kod bunu okur; silisyumda bu erişim hata üretir |
0x04 |
NET_CMD_REG |
bir komut kodu yaz (aşağıdaki tablo); yazma işlemi onu çalıştırır |
0x08 |
NET_ARG_REG |
tek bir argüman kelimesi, geri okunur: LISTEN için port, REPLY için durum |
0x0C |
NET_STATUS_REG |
bit 0 BUSY, bit 1 ERR, bit 2 RX_READY, bit 3 LINK, bit 4 SERVE, 8..11 bitleri STATE |
0x10 |
NET_RESULT_REG |
son komutun verdiği yanıt |
0x14 |
NET_INT_RAW_REG |
bit 0 DONE, bit 1 EVENT |
0x18 |
NET_INT_ENA_REG |
aynı iki bit |
0x1C |
NET_INT_CLR_REG |
temizlemek için 1 yaz, aynı iki bit |
0x20 |
NET_TX_LEN_REG |
giden halkada hazırlanan baytlar |
0x24 |
NET_TX_DATA_REG |
yaz: giden halkaya tek bir bayt (bit 0..7) ekle |
0x28 |
NET_RX_LEN_REG |
gelen halka tamponda bekleyen baytlar |
0x2C |
NET_RX_DATA_REG |
oku: gelen halka tampondan tek bir bayt al, boşken 0 |
0x30 |
NET_RING_LEN_REG |
halkaların her birinin bayt cinsinden kapasitesi, böylece firmware 4096'ı sabit kodlamak zorunda kalmaz |
0x40 |
NET_BT_CMD_REG |
Bluetooth: bir Bluetooth komut kodu yaz (docs/bluetooth.md); yazma işlemi onu çalıştırır |
0x44 |
NET_BT_ARG_REG |
Bluetooth: tek bir argüman kelimesi, geri okunur; bir olay numarasını buraya bırakır |
0x48 |
NET_BT_RESULT_REG |
Bluetooth: son Bluetooth komutunun verdiği yanıt |
0x4C |
NET_BT_STATUS_REG |
bit 0 CLASSIC_ON, bit 1 CLASSIC_LINK, bit 2 EVENT, bit 3 BLE_ADV, bit 4 BLE_LINK, bit 5 BT_ERR, bit 8 HAS_CLASSIC, bit 9 HAS_BLE |
0x50 |
NET_BT_TX_LEN_REG |
Bluetooth: baytlar kendi giden halka tamponunda hazırlanıyor |
0x54 |
NET_BT_TX_DATA_REG |
Bluetooth: yaz: o halka tampona tek bir bayt gönder |
0x58 |
NET_BT_RX_LEN_REG |
Bluetooth: kendi gelen halka tamponunda bekleyen baytlar |
0x5C |
NET_BT_RX_DATA_REG |
Bluetooth: okuma: bir bayt çek, boş olduğunda 0 |
Sekiz NET_BT_ kaydı bloğun Bluetooth yarısıdır ve kendi halkalarına sahiptir: gerçek çipte olduğu gibi yalnızca Bluetooth LE, dolayısıyla Classic komutları BT_ERR bayrağını ayarlar. Arkalarında da radyo yoktur; docs/bluetooth.md onların sözleşmesidir.
STATE, istasyonun nerede olduğunu belirtir: 0 boşta, 1 başlıyor, 2 bağlanıyor, 3 bağlı, 4 başarısız, 5 böyle bir ağ yok. NET_CMD_STATUS, aynı şeyi bir kodun WiFi.status() çağrısından okuduğu Arduino wl_status_t koduna dönüştürür.
NET_CMD_REG |
ad | ne yaptığı |
|---|---|---|
| 0 | NOP |
hiçbir şey |
| 1 | RESET |
bağlantıyı kes, iki halkayı da bırak, herhangi bir isteği bırak |
| 2 | CONNECT |
giden halka ssid\0password bilgisini tutar; bir ila üç saniye boyunca BUSY yükseltir |
| 3 | DISCONNECT |
ilişkilendirmeyi ve adresi bırak |
| 4 | STATUS |
NET_RESULT_REG = wl_status_t kodu |
| 5 | IP |
NET_RESULT_REG = kiralanan adres, ilk sekizli düşük baytta |
| 6 | RSSI |
NET_RESULT_REG = dBm cinsinden sinyal, işaret genişletilmiş |
| 7 | SSID |
gelen halka erişim noktasının adını alır |
| 8 | MAC |
gelen halka kartın altı MAC baytını alır |
| 9 | REQUEST |
giden halka method\0url\0headers\0body tutar; BUSY hatası verir |
| 10 | POLL |
NET_RESULT_REG = 0 istek sürerken, ardından HTTP durumu ya da ERR yukarıdayken negatif bir hata; gövde gelen halkaya düşer |
| 11 | LISTEN |
NET_ARG_REG içindeki portta dinle |
| 12 | ACCEPT |
NET_RESULT_REG = 1 ve gelen halka tamponu method\0path\0query\0body içerir, bekleyen bir şey yokken 0 |
| 13 | REPLY |
kabul edilen isteğe NET_ARG_REG içindeki durumla yanıt ver; giden halka content-type\0body tutar |
| 14 | STOP |
dinlemeyi durdur |
| 15 | WL_GPIO_SET |
kablosuz parçanın kendi GPIO'larını NET_ARG_REG kaydından sür. Bu kart değil: bu parçanın radyosunda böyle bir pin yok, bu yüzden ERR'yi ayarlar ve hiçbir şeyi sürmez. Bir Pico W'nin kart üzerindeki LED'inin izlediği yol budur (docs/picow.md bölüm 3.8) |
| 16 | WL_GPIO_GET |
onları geri oku, ve burada da aynı ERR |
| 17 | BLYNK |
simüle edilmiş Blynk sunucusunda tek bir işlem, NET_ARG_REG'deki işlem ve giden halkadaki alanları; hemen NET_RESULT_REG'de yanıtlanır, ağdan kopukken ERR yükselir (docs/wifi.md, "Blynk") |
| 19 | ETH |
kablolu Ethernet (firmware/include/ETH.h), NET_ARG_REG'deki işlem: 1 bağlantıyı simüle edilmiş bir kablo üzerinden açar, SSID ve parola olmadan, 1,5 s sonra aynı kiralama ile katılır; 2, bağlantı (ya da son hali) kabluloyu olduğunda NET_RESULT_REG'ye 1 koyar. Tek bir bağlantı vardır: STATUS, IP ve her istek, hangi yoldan açılmışsa açılsın onu okur |
| 20 | SOFTAP |
soft AP (crates/net/src/softap.rs, docs/wifi.md), NET_ARG_REG'deki işlem: 1 onu açar (giden halkaya ssid\0password\0 ve kanal baytı; NET_RESULT_REG 1, ya da boş bir isim veya bir ile yedi karakterlik bir parola için ERR ile 0), 2 onu kapatır, 3 onu yapılandırır (adres, ağ geçidi ve ağ maskesi, her biri dört bayt), 4 adresi (kapalıyken 0), 5 katılan istasyonlar, 6 çalışma zamanının olaylara dönüştürdüğü katılmalar, ayrılmalar ve açık biti, 7 ve 8 bir captive portal'ın DNS sunucusunu başlatma (isim, bir sıfır baytı, adres) ve durdurma, 9 ismini gelen halkaya, 10 telefonun adresini, 11 hizmet verilen isteğin Host'unu gelen halkaya yazar. Tek istasyon Web panelinin telefonudur |
Negatif POLL kodları: -1 isim çözümlenemez, -2 istasyon ilişkilendirilmemiş, -3 https:// ve TLS simüle edilmez, -4 halkadan uzun bir gövde, -5 bu ağın ayrıştıramadığı bir URL, -6 zaten devam eden bir istek var. firmware/include/HTTPClient.h bunları bir kodun karşılaştırdığı Arduino biçimli kodlara dönüştürür ve docs/wifi.md eşlemeyi listeler.
Zamanlama, tamamı bu modelin kendine ait ve tamamı docs/wifi.md'de belirtilmiş: bir ilişkilendirme bir ile üç saniye arasında sürer, SSID'den kararlaştırılır ki bir ders iki kez aynı süreyi alsın; yanlış bir parola beş saniye sonra WL_CONNECT_FAILED olur; simüle edilmiş bir kaynağa giden bir istek 60 ms sonra geri döner; kodun kendi sunucusuna gelen ve kodun hiç yanıtlamadığı bir istek, on saniye sonra ağ tarafından 504 ile kapatılır.
3.9 Zamanlayıcı gruplarının bekçileri, RTC_CNTL sıfırlamaları ve yığın izleyicisi (0x6001_F000, 0x6002_0000, 0x6000_8000, 0x600C_E000)
Her zamanlayıcı grubunun ana bekçi zamanlayıcısı (crates/esp-common/src/mwdt.rs): WDTCONFIG0..5, WDTFEED ve WDTWPROTECT anahtarı, dört aşama, her birinin kendi eylemiyle (bir kesme, bir CPU sıfırlaması veya bir sistem sıfırlaması), 80 MHz APB saati üzerindeki ön bölücü ya da WDT_USE_XTAL ile 40 MHz kristal, ve WDT_CONF_UPDATE_EN ile etkili olan yazılan yapılandırma. Bekçi zamanlayıcısının TIMG_INT_ENA/RAW/ST/CLR kaydındaki biti (bit 1), GPIO ve UART0 yaptığı gibi makine harici kesmesini tetikler (bölüm 3.6). Bir sıfırlama aşaması çipi, saat çalışırken ve RTC_CNTL_RESET_STATE_REG nedenini söylerken sıfırlar (sistem sıfırlaması için 7 veya 8, CPU sıfırlaması için 0xB veya 0x11); RAM imajdan yeniden yüklenir, RTC_CNTL_STORE0..7 değerlerini korur ve RTC_CNTL_OPTIONS0_REG içindeki RTC_CNTL_SW_SYS_RST ile RTC_CNTL_SW_PROCPU_RST de onu sıfırlar (nedenler 3 ve 0xC).
Çalışma zamanı, ESP-IDF'nin yaptığı gibi ESP-IDF'nin görev bekçi zamanlayıcısını zamanlayıcı grubu 0'nın bekçisi üzerinde çalıştırır (firmware/src/main.cpp): 500 µs tikler, aşama 0 zaman aşımında bir kesme, aşama 1 iki katında bir sistem sıfırlaması; setup() öncesinde 5 s'de bir panikle başlatılır ve çekirdek 0'nın boşta görevini izler. Kesme, ESP-IDF'nin satırlarını yazdırır ("E (…) task_wdt: Task watchdog got triggered. …", görevler, "Aborting.", iptal satırı ve "Rebooting..."), ESP-IDF'nin ESP_RST_TASK_WDT ipucunu RTC saklama kaydında bırakır ve CPU'yu yazılım sıfırlamasıyla sıfırlar; böylece esp_reset_reason() sonrasında 6 der. esp_task_wdt_*, enableLoopWDT() ve enable/disableCore0WDT() ona etki eder. Zamanlayıcı grubu 1'in bekçisi de aynı şekilde modellenmiştir ve çalışma zamanında onu kuran bir şey yoktur: kesme bekçisi simüle edilmez.
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. Ana makine kanalı
host = "utf-8 bytes on UART0". readHost, UART0 TX baytlarını FIFO'dan çıkar çıkmaz döndürür; writeHost, baytları UART0 RX FIFO'suna iter (taşma, çipte olduğu gibi atar). Seri monitör baytları metin olarak gösterir, UTF-8'i çözer ve \n satır sonu sayar (\r yok sayılır).
5. Zaman modeli
CPU, döngü başına bir komutla 160 MHz'de çalışır. Parça dilimler halinde yürütür: her uyanışta SLICE_NS * 160 komut çalıştırır (SLICE_NS = 10 us, yani 1600 komut) sonra sonraki uyanışı planlar, şu kurallarla:
- Bir pini değiştiren çevre birimi yazımları (GPIO OUT veya ENABLE, IO_MUX çekmeleri) pini, dilimin başlangıç zamanı artı o ana kadarki komut sayısının 160 MHz'e bölünmüşü olan anda sürer. Aynı dilim içindeki iki geçişin aralığını korumak için bu gecikmeyle
drive_afterkullan. GPIO_IN okumaları pin seviyesini dilim başlangıcındaki haliyle görür. - Zamanlayıcı karşılaştırması ve UART hızlandırması aynı dilim içi zamana göre değerlendirilir; böylece
micros()tektir (monotoniktir) ve meşgul beklemeli birdelayMicrosecondsbir komut hassasiyetiyle doğrudur. - 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: parça dilimlemeyi durdurur ve zamanlayıcı hedefi ile bir UART olayının en erkenine bir uyanış planlar; bir GPIO pin değişimi onu hemen uyandırır.- Erişim hataları: çekirdek
mtvec'e yakalanır;mtvec = 0ile bu sonsuza dek yeniden yakalanır. Parça yakalanmaları sayar ve ileri gidiş olmaksızın 1000 arka arkaya yakalanmadan sonra durur veprobe(aşağıya bak) ile host kanalı üzerinden (tek satır) "firmware crashed at pc=…, mcause=…" bildirir.
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. Firmware çalışma zamanı (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. Bu modelin emin oldukları ve emin olmadıkları
Üç grup, docs/esp32c6.md bölüm 7'nin kullandığıyla aynı sıralama. Bunun nedeni, sessizce bir adresi tahmin eden bir kart modelinin, bilmediğini söyleyen modelden daha kötü olmasıdır.
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.
İnanılan, doğrulanmayan. 3.1 ve 3.5 bölümlerinde yazmaç yazmaç bu adla anıldı ve liste tek yerde olsun diye burada tekrarlandı:
APB_SARADCiçindeki0x00ve0x04dışındaki her tek atımlık yazmaç ofseti. YaniFSM_WAIT0x0C'de,ONETIME_SAMPLE0x38'de ve alan konumlarında,1_DATA_STATUS0x44'te, 0x64 ile 0x70 arasındaki dört kesme yazmacında veAPB_ADC_CLKM_CONF0x78'de. Modelin uyguladıkları bunlardır; bunlar kılavuzun bir sayfasından alıntılanmış satırlar değil, tek atımlık yolun biçimine uymak için seçilmiştir.- GPIO matrisi sinyal indeksleri 45 ile 50 arası,
ledc_ls_sig_out0ileledc_ls_sig_out5için, matrisin onları yerleştirecek bir yeri olsun diye seçildi.
Bu belge için derlenen firmware, silikonla aynı fikirde olup olmadığına bakılmaksızın modelle aynı fikirdedir. Gerçek bir DevKitM-1'e yüklenecek bir imaj, önce firmware/include/esp32c3.h içindeki #define'leri kılavuza karşı kontrol etmelidir.
Modellendi ama kılavuzdaki sayılara sadık tutulmadı. Adreslerden çok davranışlar:
- 11 dB'deki ADC tipik bir parçanın eğrisidir, bu ünitenin değil. Yaklaşık 2.9 V'ta doyma ve 2.5 V etkin aralığın üzerindeki kazanç var (bölüm 3.5); eFuse kalibrasyonunun düzelttiği üniteden üniteye yayılım ve dönüşüm gürültüsü yok. Diğer zayıflatmalar nominal düz çizgilerdir (1.1 V, 1.5 V, 2.2 V).
- Bir komut, 160 MHz'de bir çevrimdir. Boru hattı duraksamaları yok, önbellek yok (önbellek zaten yok), flash bekleme durumları yok ve veri yolu çekişmesi yok, dolayısıyla komut sayısı saattir. Flash'tan çalışan gerçek bir C3 bundan daha yavaş ve daha düzensizdir.
- Pad'ler üç durum ve bir eşiktir. 3.3 V'ta push-pull, high-Z veya 45 kΩ dahili pull, beslemenin yarısına karşı okunur; histeresiz, sürücü gücü ayarı, yükselme süresi veya akım limiti yoktur. Sürülmeyen bir pin, rastgele bir değere süzülmek yerine 0 okunur.
- Kart ideal bir güç kaynağıdır: 3V3 ve 5V sonsuza dek ray empedansında, dolayısıyla hiçbir şey düşmez. Başlangıç bir mikrosaniyedir; gerçek bir C3, önyükleme ROM'unda onlarca milisaniye harcar.
- Bir dilim 10 µs'dir ve SoC ile devre, dilim sınırlarında ya da çipin beklediği şeyde buluşur.
Bilerek yok. Yazmaç yerleşimi bu modelin dürüstçe yeniden üretebileceği bir şey olmadığı için uydurmak yerine dışarıda bırakıldı: Bluetooth LE (radyo yok ve varmış gibi davranılmıyor), SPI, I2C, I2S, RMT, USB Serial/JTAG, zamanlayıcı gruplarının zamanlayıcıları (bekçi köpekleri 3.9 bölümünündür), tam kesme matrisi (onun yerine ne geçtiğini 3.6 bölümü söyler), ADC2 ve SAR ADC'nin DMA desen tablosu, dijital denetleyici, filtreler, eşik izleyicileri ve kalibrasyon eFuse'ları, LEDC'nin hızlı grubu ve görev-solma donanımı ile çekirdeğe giden kesme hattı, PMU ve saat ağacı, önbellek, ROM ve flash. Üreticinin ESP-IDF ve Arduino çekirdek ikili dosyaları bu yüzden burada çalışmaz ve bu belge için derlenen firmware çalışır.
WiFi: simüle edildi, bkz. 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 o ağın ne yaptığının ve daha uzun uzanarak ne yapmadığının sözleşmesidir.