Ini adalah referensi teknis untuk modelnya: apa yang diimplementasikan, register demi register, untuk orang yang menulis firmware menggunakannya. Untuk memakai board ini di editor, mulai dari ESP32-C3 dan halaman board.
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.
Tipe katalognya adalah esp32c3 (board ESP32-C3-DevKitM-1). Tiga agent membangun berdasarkan file ini: SoC dan part (Rust), runtime firmware dan contoh (C, clang), visual board dan serial monitor (TypeScript). Ubah hanya dengan mengedit file ini lebih dulu.
1. Pin board (urutan katalog)
Dalam urutan fisik dua header 15 pin di DevKitM-1 (tampak atas, konektor USB di bawah):
Header kiri (atas ke bawah): GND, 3V3, 3V3b, 2, 3, RST, GNDb, 0, 1, 10, 4, 5, 6, 7, 8 Header kanan (atas ke bawah): 5V, 5Vb, GNDc, GNDd, 9, 18, 19, 20, 21, NC1, NC2, NC3, NC4, NC5, NC6
Nama yang duplikat diberi akhiran huruf karena nama pin katalog harus unik. Pin NC* ada supaya header tergambar lengkap; pin tersebut high-Z dan tidak pernah dibaca.
Kelistrikan:
3V3*mengeluarkan 3,3 V padaR_SUPPLY;5V*mengeluarkan 5 V padaR_SUPPLY;GND*mengeluarkan 0 V padaR_SUPPLY. Board selalu mendapat daya (USB). Board ini menjadi catu daya bagi rangkaian lainnya.RSTadalah input dengan pull-up internal 10 k ke 3,3 V; jika ditarik di bawah 1,65 V CPU ditahan dalam reset; saat dilepas, program berjalan lagi dari entry point.- GPIO
0..10, 18, 19, 20, 21bersifat inout. Output aktif: push-pull pada 3,3 V atau 0 V melaluiR_STRONG. Output nonaktif: high-Z, plus pull-up 45 k ke 3,3 V saatFUN_WPUdisetel di IO_MUX, atau pull-down 45 k saatFUN_WPDdisetel. Input membaca tegangan net terhadap 1,65 V (setengah dari 3,3 V); Unknown terbaca 0, dan input mengambang membaca derau, seperti pada Uno (docs/uno.mdbagian 1);GPIO9terbaca tinggi saat tidak ada yang menahannya, karena pull-up dari board di samping tombol BOOT. - GPIO
0sampai4juga adalah kanal ADC1 0 sampai 4: tegangan net pada lima pin tersebut dibaca sebagai tegangan sekaligus terhadap ambang batas, jadi potensiometer, thumb stick, atau pembagi tegangan di salah satunya menjadi input analog sungguhan (bagian 3.5). Pin yang tidak ditahan oleh apa pun akan mengembara, seperti input yang mengambang (docs/uno.mdbagian 1). - Pin
18/19berfungsi ganda sebagai USB D-/D+ dan20/21sebagai UART0 RX/TX pada board asli; di sini semuanya GPIO biasa. Byte UART0 menuju kanal host (bagian 4), bukan ke pin.
2. Peta memori (alamat ESP32-C3 asli)
| region | alamat | ukuran | catatan |
|---|---|---|---|
| SRAM, bus instruksi | 0x4037_C000 |
400 KB | satu RAM, dua tampilan |
| SRAM, bus data | 0x3FC7_C000 |
400 KB | byte yang sama: 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 | bagian 3.1 |
| IO_MUX | 0x6000_9000 |
4 KB | bagian 3.2 |
| UART0 | 0x6000_0000 |
4 KB | bagian 3.3 |
| SYSTIMER | 0x6002_3000 |
4 KB | bagian 3.4 |
| APB_SARADC | 0x6004_0000 |
4 KB | bagian 3.5 |
| LEDC | 0x6001_9000 |
4 KB | bagian 3.7 |
| kotak surat jaringan Mokxi | 0x6FFF_E000 |
4 KB | bagian 3.8. Bukan milik chip: blok milik Mokxi sendiri, tempat C3 asli tidak punya apa pun |
Seluruh 400 KB adalah RAM (chip asli mencadangkan bagian atas untuk data ROM dan cache; tidak dimodelkan). Selain itu terjadi access fault (core melakukan trap; komponen menghitungnya, lihat bagian 5). Register peripheral yang tidak terpetakan di dalam blok yang terpetakan terbaca 0 dan mengabaikan penulisan, dengan penghitung untuk diagnostik.
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. Register peripheral (subset, offset asli, posisi bit asli)
Register berukuran 32 bit dan sejajar kata. Akses halfword dan byte ke register tidak didukung (diperlakukan sebagai akses kata dari kata yang sejajar, seperti yang dilakukan chip untuk pembacaan; penulisan dengan lebar lebih sempit menulis seluruh kata dari nilai sempit tersebut, bukan perilaku nyata, jadi firmware tidak boleh melakukannya).
3.1 GPIO (0x6000_4000)
| offset | nama | bit |
|---|---|---|
0x04 |
GPIO_OUT_REG |
bit n = level GPIO n saat output aktif |
0x08 |
GPIO_OUT_W1TS_REG |
tulis 1 untuk menyetel bit OUT |
0x0C |
GPIO_OUT_W1TC_REG |
tulis 1 untuk menghapus bit OUT |
0x20 |
GPIO_ENABLE_REG |
bit n = driver output GPIO n aktif |
0x24 |
GPIO_ENABLE_W1TS_REG |
setel |
0x28 |
GPIO_ENABLE_W1TC_REG |
hapus |
0x3C |
GPIO_IN_REG |
bit n = level input GPIO n (butuh FUN_IE) |
0x44 |
GPIO_STATUS_REG |
status interrupt, bit n |
0x4C |
GPIO_STATUS_W1TC_REG |
hapus |
0x74 + 4n |
GPIO_PINn_REG |
bit 2 PAD_DRIVER (1 = open drain), bit 7..9 INT_TYPE (0 mati, 1 rising, 2 falling, 3 any, 4 level rendah, 5 level tinggi) |
0x554 + 4n |
GPIO_FUNCn_OUT_SEL_CFG_REG |
bit 0..7 OUT_SEL: 128 = pad mengikuti bit n GPIO_OUT_REG (nilai power-on yang dipakai di sini); 45 sampai 50 = kanal kecepatan rendah LEDC 0 sampai 5 yang menggerakkannya (bagian 3.7); nilai lain tidak didukung dan diperlakukan sebagai 128 |
Indeks sinyal 45 sampai 50 belum diverifikasi: itulah yang diimplementasikan model ini untuk ledc_ls_sig_out0 sampai ledc_ls_sig_out5, dipilih supaya matriks GPIO punya tempat menaruhnya, dan bukan baris yang dikutip dari tabel sinyal peripheral di manual. Pad yang digerakkan kanal LEDC tetap butuh driver outputnya aktif di GPIO_ENABLE_REG, itulah yang disetel gpio_set_direction sebelum matriks dialihkan; kanal menentukan level dan GPIO_ENABLE menentukan apakah pad menggerakkan sama sekali.
Hanya bit 0..21 yang ada. Open drain: output tinggi berarti high-Z. Interrupt GPIO menyetel GPIO_STATUS_REG dan menaikkan garis interrupt eksternal (bagian 3.6).
3.2 IO_MUX (0x6000_9000)
| offset | nama | bit |
|---|---|---|
0x04 + 4n |
IO_MUX_GPIOn_REG |
bit 7 FUN_WPD pull-down, bit 8 FUN_WPU pull-up, bit 9 FUN_IE input enable, bit 12..14 MCU_SEL (1 = GPIO, satu-satunya nilai yang didukung; nilai power-on 1 di sini untuk setiap pin supaya firmware mentah langsung bekerja) |
3.3 UART0 (0x6000_0000)
| offset | nama | bit |
|---|---|---|
0x00 |
UART_FIFO_REG |
tulis: dorong satu byte ke TX; baca: ambil satu byte dari RX (0 saat kosong) |
0x04 |
UART_INT_RAW_REG |
bit 0 RXFIFO_FULL, bit 1 TXFIFO_EMPTY, bit 8 RXFIFO_TOUT |
0x08 |
UART_INT_ST_REG |
raw dan diaktifkan |
0x0C |
UART_INT_ENA_REG |
|
0x10 |
UART_INT_CLR_REG |
tulis 1 untuk menghapus |
0x14 |
UART_CLKDIV_REG |
bit 0..11 bagian bulat pembagi, bit 20..23 CLKDIV_FRAG bagian perenambelasnya, dari clock inti (baud hanya memengaruhi tempo TX di bagian 5; disimpan, terbaca kembali) |
0x1C |
UART_STATUS_REG |
bit 0..9 RXFIFO_CNT, bit 16..25 TXFIFO_CNT |
0x20 |
UART_CONF0_REG |
disimpan, terbaca kembali; bit 17 RXFIFO_RST, bit 18 TXFIFO_RST mengosongkan FIFO (TRM v1.4 register 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 clock APB 80 MHz, 3 kristal 40 MHz; 2, RC_FAST, dianggap kristal), bit 12..19 SCLK_DIV_NUM: clock inti adalah sumber dibagi SCLK_DIV_NUM + 1. Setelah reset memakai kristal, tanpa pembagian, jadi CLKDIV 347 adalah 115 274 baud. Nilai pecahan SCLK_DIV_A/SCLK_DIV_B disimpan, tidak dimodelkan |
Runtime memprogram baud rate seperti yang dilakukan uart_ll_set_baudrate milik ESP-IDF: clock APB, dipreskala oleh SCLK_DIV_NUM + 1 terkecil yang membuat pembagi di bawah 4096, dan pembagi hingga perenambelas, jadi 1200 dan 9600 baud tepat, bukan dijepit di 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)
Penghitung bebas 52 bit pada 16 MHz, satu komparator tersambung ke interrupt timer CPU.
| offset | nama | bit |
|---|---|---|
0x04 |
SYSTIMER_UNIT0_OP_REG |
bit 30 UPDATE: tulis 1 untuk mengunci hitungan ke VALUE_HI/LO; bit 29 VALUE_VALID terbaca 1 setelah dikunci |
0x40 |
SYSTIMER_UNIT0_VALUE_HI_REG |
bit 0..19, bit hitungan terkunci 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 |
bit hitungan terkunci 0..31 |
0x50 |
SYSTIMER_COMP0_LOAD_REG |
tulis 1 untuk memuat target |
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 |
Timer selalu berjalan. Hitungan diturunkan dari waktu kernel: count = now_ps / 62_500. Timer ini tidak pernah bergeser dari rangkaian.
Terverifikasi register demi register terhadap ESP32-C3 Technical Reference Manual v1.4, bagian 10.6 (ringkasan register) dan register 10.2, 10.14 sampai 10.17. Versi model sebelumnya menempatkan comparator 0 di 0x50 sampai 0x5C, yang pada C3 sebenarnya adalah load strobe COMP0_LOAD sampai COMP2_LOAD dan UNIT0_LOAD; tata letak itu bukan milik chip, dan runtime beserta gambarnya dibangun ulang saat kesalahan itu diperbaiki.
3.5 APB_SARADC (0x6004_0000)
ADC1 dalam mode one-shot: jalur yang diambil driver adc_oneshot dari ESP-IDF dan analogRead dari Arduino core, dan tidak ada yang lain. Channel 0 sampai 4 adalah GPIO 0 sampai GPIO 4; ADC2 tidak dimodelkan (di C3 asli ia dibagi dengan radio, dan tidak ada radio di sini).
Alamat dasar blok ini adalah alamat chip. Offset dalam tabel ini yang ditandai "belum terverifikasi" tidak diambil dari halaman manual referensi teknis: itu yang diimplementasikan model ini, dipilih agar cocok dengan bentuk jalur one-shot, dan firmware yang dibangun di sini cocok dengan model ini, entah cocok atau tidak dengan silikon. 0x00 dan 0x04 berasal dari manual; register one-shot lainnya adalah yang belum terverifikasi, dan program yang perlu berjalan di DevKitM-1 tanpa perubahan sebaiknya memeriksanya dulu terhadap manual.
| offset | nama | bit |
|---|---|---|
0x00 |
APB_SARADC_CTRL_REG |
bit 7..14 SAR_CLK_DIV: pembagi clock SAR. Disimpan dan dapat dibaca kembali; waktu konversi di sini tetap |
0x04 |
APB_SARADC_CTRL2_REG |
disimpan, dapat dibaca kembali. Jalur timer-triggered dan DMA tidak dimodelkan |
0x0C |
APB_SARADC_FSM_WAIT_REG |
disimpan, dapat dibaca kembali (offset belum terverifikasi) |
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 (disimpan, tidak mengonversi apa pun), bit 31 SAR1_ONETIME_SAMPLE (offset dan posisi field belum terverifikasi) |
0x44 |
APB_SARADC_1_DATA_STATUS_REG |
bit 0..16 ADC1_DATA: konversi ADC1 terakhir, lebarnya dua belas bit (offset belum terverifikasi) |
0x64 |
APB_SARADC_INT_ENA_REG |
disimpan; tidak ada jalur yang mencapai core (offset belum terverifikasi) |
0x68 |
APB_SARADC_INT_RAW_REG |
bit 31 ADC1_DONE (offset belum terverifikasi) |
0x6C |
APB_SARADC_INT_ST_REG |
raw dan enabled (offset belum terverifikasi) |
0x70 |
APB_SARADC_INT_CLR_REG |
tulis 1 untuk menghapus, bit yang sama (offset belum terverifikasi) |
0x78 |
APB_SARADC_APB_ADC_CLKM_CONF_REG |
disimpan, dapat dibaca kembali (offset belum terverifikasi) |
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.
Hasilnya dua belas bit, round(4095 x Vin / Vfull), dibatasi, dari tegangan net pada saat konversi dimulai. ONETIME_ATTEN memilih skala penuhnya, pada angka nominal yang dikutip lembar data:
ONETIME_ATTEN |
atenuasi | skala penuh |
|---|---|---|
| 0 | 0 dB | 1.1 V |
| 1 | 2.5 dB | 1.5 V |
| 2 | 6 dB | 2.2 V |
| 3 | 11 dB | kurva komponen asli, jenuh pada sekitar 2.9 V |
Tiga yang pertama adalah garis lurus nominal. 11 dB (12 dB di ESP-IDF saat ini), default Arduino core, mengikuti kurva raw tipikal sebuah komponen (CURVE_11DB di crates/esp32c3/src/adc.rs): mendekati linear melalui rentang efektif 0 sampai 2500 mV pada lembar data (3650 di 2.5 V), lalu berlanjut ke 4095 pada sekitar 2.9 V (orang-orang melaporkan 2.8 sampai 3.0 V di unit asli). Jadi potensiometer yang tersambung melintasi rel 3.3 V membaca 4095 untuk sepersepuluh putaran terakhirnya, dan pembagi tegangan di setengah rel membaca sekitar 2410, bukan 2048. Kalibrasi eFuse sebuah unit menggesernya beberapa persen, yang tidak dimodelkan; analogReadMilliVolts membalikkan kurva yang sama. Sebuah channel tanpa apa pun di pin-nya bergoyang, seperti perilaku input mengambang (docs/uno.md bagian 1).
ADC1_DONE bisa dipolling dan dihapus, itulah yang dilakukan jalur one-shot, tetapi tidak mencapai mip: ADC tidak ada di jalur interrupt eksternal (bagian 3.6). Demikian juga pengendali digital, tabel pola DMA, filter, monitor ambang, serta channel suhu internal dan VDD.
3.6 Interrupt
Mode mesin RISC-V, mtvec direct atau vectored sesuai dukungan core. Jalur:
- Interrupt timer mesin (
mip.MTIP, cause 7): target 0 SYSTIMER saatINT_ENAbit 0 danINT_RAWbit 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 memarkir core sampai ada jalur yang pending.
3.7 LEDC (0x6001_9000)
Pengendali LED PWM, group low-speed, satu-satunya group yang dimiliki chip ini: empat timer dan enam channel. Ini blok di balik analogWrite, ledcAttach dan 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)
dan 5 kHz pada delapan bit adalah DUTY_RES 8 dengan CLK_DIV 16000, tepat. Sebuah channel memilih timer, hitungan awal HPOINT dan duty, dan keluarannya tinggi mulai dari HPOINT selama DUTY >> 4 hitungan, berputar kembali dari puncak periode. Jadi duty 0 adalah rendah terus-menerus dan duty 2^DUTY_RES tinggi terus-menerus, tanpa tepi sama sekali, itulah sebabnya Arduino core mengubah ledcWrite(pin, 255) pada delapan bit menjadi duty 256 alih-alih menyisakan takik satu hitungan setiap periode.
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 | nama | bit |
|---|---|---|
0x00 + 0x14n |
LEDC_CHn_CONF0_REG |
bit 0..1 TIMER_SEL, bit 2 SIG_OUT_EN, bit 3 IDLE_LV (level yang ditahan saat generator keluaran mati), bit 4 PARA_UP (disimpan; duty yang ditulis di sini berlaku seketika) |
0x04 + 0x14n |
LEDC_CHn_HPOINT_REG |
bit 0..13 HPOINT: hitungan saat pulsa channel dimulai |
0x08 + 0x14n |
LEDC_CHn_DUTY_REG |
bit 0..18 DUTY: lebar pulsa dalam per enam belas hitungan |
0x0C + 0x14n |
LEDC_CHn_CONF1_REG |
perangkat keras duty-fade: tersimpan, bisa dibaca kembali, dan tidak mem-fade apa pun |
0x10 + 0x14n |
LEDC_CHn_DUTY_R_REG |
duty seperti adanya, hanya baca |
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 |
counter, hanya baca |
0xC0 |
LEDC_INT_RAW_REG |
bit n = timer n overflow |
0xC4 |
LEDC_INT_ST_REG |
raw dan diaktifkan |
0xC8 |
LEDC_INT_ENA_REG |
tersimpan; tidak ada jalur yang sampai ke core |
0xCC |
LEDC_INT_CLR_REG |
tulis 1 untuk menghapus |
0xD0 |
LEDC_CONF_REG |
bit 0..1 APB_CLK_SEL (1 = clock APB 80 MHz, satu-satunya sumber yang dimodelkan), bit 31 CLK_EN (disimpan) |
0xFC |
LEDC_DATE_REG |
stempel versi, hanya baca |
Menyiapkan channel adalah tugas ledc_timer_config dan ledc_channel_config: tulis LEDC_CONF_REG, tulis DUTY_RES dan CLK_DIV milik timer, tulis CONF0 milik channel beserta timernya dan SIG_OUT_EN, tulis HPOINT dan DUTY, set bit GPIO_ENABLE milik pad dan arahkan GPIO_FUNCn_OUT_SEL_CFG_REG-nya ke 45 + channel.
Pencacahnya tidak di-step: ia fungsi bentuk-tertutup dari waktu simulasi, dan begitu pula waktu tepi berikutnya. Core yang parkir di wfi karenanya tidak menimbulkan biaya apa pun selama PWM berjalan, dan komponen board dibangunkan hanya untuk tepinya dan tidak untuk yang lain.
Tidak dimodelkan: grup kecepatan tinggi (chip ini tidak punya), hardware duty-fade, pencacah overflow milik channel itu sendiri, sumber clock selain APB, dan jalur interupsi LEDC ke matriks interupsi. LEDC_INT_RAW_REG bisa di-poll dan dihapus tetapi tidak pernah sampai ke mip, persis seperti ADC1_DONE milik ADC yang juga tidak (bagian 3.6).
3.8 Kotak surat jaringan Mokxi (0x6FFF_E000)
Blok ini bukan milik ESP32-C3. Setiap alamat lain dalam dokumen ini adalah milik chip, dikutip dari manual referensi teknis, dan image yang dibuat mengacu padanya berjalan di DevKitM-1 sungguhan. Yang ini milik Mokxi sendiri: jaringan simulasi dari crates/net, dipetakan di alamat yang dibiarkan tak terpetakan oleh komponen asli, supaya image yang memakainya fault di silicon, bukan membaca register peripheral lain. Fault itu adalah jawaban yang jujur, karena benda di balik blok ini tidak ada di chip.
Di sini tidak ada radio, tidak ada 802.11 dan tidak ada internet sungguhan. Tidak ada apa pun dalam model ini yang mengirim, memindai, berasosiasi, mengenkripsi atau membuka socket: password dibandingkan sebagai string, nama yang tidak berada di bawah .mokxi tidak di-resolve, dan tiga origin yang dilayani jaringan adalah fungsi-fungsi di crates/net/src/http.rs. Kotak surat ini adalah bentuk sejatinya sambungan itu, bukan fiksi tentang MAC: pada ESP32 sungguhan perangkat keras WiFi adalah blob biner tertutup dengan antarmuka perintah, dan WiFi.h milik Arduino berakhir di sisi lain dari salah satunya. docs/wifi.md adalah kontrak untuk apa yang ada di baliknya; bagian ini hanya registernya.
Sebuah register perintah, register status, ring 4096-byte untuk tiap arah dan satu bit interrupt. Menulis ke NET_CMD_REG menjalankan perintah; perintah yang memakan waktu simulasi menaikkan BUSY dan menghapusnya, dengan DONE di NET_INT_RAW_REG, saat selesai.
| offset | nama | bit |
|---|---|---|
0x00 |
NET_ID_REG |
membaca 0x494B4F4D, dan tidak ada hal lain yang melakukannya. Sketch yang ingin tahu apakah ia berjalan di Mokxi membaca ini; di silicon akses ini gagal |
0x04 |
NET_CMD_REG |
tulis kode perintah (tabel di bawah); penulisan menjalankannya |
0x08 |
NET_ARG_REG |
satu word argumen, bisa dibaca kembali: port untuk LISTEN, status untuk REPLY |
0x0C |
NET_STATUS_REG |
bit 0 BUSY, bit 1 ERR, bit 2 RX_READY, bit 3 LINK, bit 4 SERVE, bit 8..11 STATE |
0x10 |
NET_RESULT_REG |
apa yang dijawab perintah terakhir |
0x14 |
NET_INT_RAW_REG |
bit 0 DONE, bit 1 EVENT |
0x18 |
NET_INT_ENA_REG |
dua bit yang sama |
0x1C |
NET_INT_CLR_REG |
tulis 1 untuk menghapus, dua bit yang sama |
0x20 |
NET_TX_LEN_REG |
byte yang siap di ring keluar |
0x24 |
NET_TX_DATA_REG |
tulis: dorong satu byte (bit 0..7) ke ring keluar |
0x28 |
NET_RX_LEN_REG |
byte yang menunggu di ring masuk |
0x2C |
NET_RX_DATA_REG |
baca: ambil satu byte dari ring masuk, 0 saat kosong |
0x30 |
NET_RING_LEN_REG |
kapasitas tiap ring dalam byte, agar firmware tidak perlu hard-code 4096 |
0x40 |
NET_BT_CMD_REG |
Bluetooth: tulis kode perintah Bluetooth (docs/bluetooth.md); penulisan menjalankannya |
0x44 |
NET_BT_ARG_REG |
Bluetooth: satu word argumen, bisa dibaca kembali; sebuah event meninggalkan nomornya di sini |
0x48 |
NET_BT_RESULT_REG |
Bluetooth: apa yang dijawab perintah Bluetooth terakhir |
0x4C |
NET_BT_STATUS_REG |
bit 0 CLASSIC_ON, bit 1 CLASSIC_LINK, bit 2 EVENT, bit 3 BLE_ADV, bit 4 BLE_LINK, bit 5 BT_ERR, bit 8 HAS_CLASSIC, bit 9 HAS_BLE |
0x50 |
NET_BT_TX_LEN_REG |
Bluetooth: byte yang siap di ring keluarnya sendiri |
0x54 |
NET_BT_TX_DATA_REG |
Bluetooth: tulis: dorong satu byte ke ring tersebut |
0x58 |
NET_BT_RX_LEN_REG |
Bluetooth: byte yang menunggu di ring masuknya sendiri |
0x5C |
NET_BT_RX_DATA_REG |
Bluetooth: baca: ambil satu byte, 0 saat kosong |
Delapan register NET_BT_ adalah separuh Bluetooth dari blok itu, dengan ring milik mereka sendiri: hanya Bluetooth LE, seperti di chip asli, jadi perintah Classic menyetel BT_ERR. Tidak ada radio di baliknya juga; docs/bluetooth.md adalah kontraknya.
STATE adalah posisi station: 0 idle, 1 mulai, 2 menghubungkan, 3 terhubung, 4 gagal, 5 jaringan tidak ada. NET_CMD_STATUS mengubah hal yang sama menjadi kode wl_status_t Arduino yang dibaca sketch dari WiFi.status().
NET_CMD_REG |
nama | fungsinya |
|---|---|---|
| 0 | NOP |
tidak melakukan apa pun |
| 1 | RESET |
putuskan koneksi, buang kedua ring, buang semua request |
| 2 | CONNECT |
ring keluar berisi ssid\0password; menaikkan BUSY selama satu sampai tiga detik |
| 3 | DISCONNECT |
hapus asosiasi dan alamatnya |
| 4 | STATUS |
NET_RESULT_REG = kode wl_status_t |
| 5 | IP |
NET_RESULT_REG = alamat yang didapat, oktet pertama di byte rendah |
| 6 | RSSI |
NET_RESULT_REG = sinyal dalam dBm, dengan tanda diperluas |
| 7 | SSID |
ring masuk menerima nama access point |
| 8 | MAC |
ring masuk menerima enam byte MAC board |
| 9 | REQUEST |
ring keluar berisi method\0url\0headers\0body; menaikkan BUSY |
| 10 | POLL |
NET_RESULT_REG = 0 saat berjalan, lalu status HTTP, atau error negatif dengan ERR naik; body mendarat di ring masuk |
| 11 | LISTEN |
mendengarkan di port yang ada di NET_ARG_REG |
| 12 | ACCEPT |
NET_RESULT_REG = 1 dan ring masuk berisi method\0path\0query\0body, atau 0 saat tidak ada yang menunggu |
| 13 | REPLY |
jawab request yang diterima dengan status di NET_ARG_REG; ring keluar berisi content-type\0body |
| 14 | STOP |
berhenti mendengarkan |
| 15 | WL_GPIO_SET |
drive GPIO milik komponen nirkabel sendiri dari NET_ARG_REG. Bukan board ini: radio komponen ini tidak punya pin seperti itu, jadi ia menyetel ERR dan tidak menggerakkan apa pun. Inilah jalur yang diambil LED bawaan Pico W (docs/picow.md bagian 3.8) |
| 16 | WL_GPIO_GET |
baca kembali nilainya, dan ERR yang sama di sini |
| 17 | BLYNK |
satu operasi pada server Blynk yang disimulasikan, operasinya di NET_ARG_REG dan field-nya di ring keluar; dijawab seketika di NET_RESULT_REG, dengan ERR dimatikan dari jaringan (docs/wifi.md, "Blynk") |
| 19 | ETH |
Ethernet kabel (firmware/include/ETH.h), operasinya di NET_ARG_REG: 1 mengaktifkan link lewat kabel tersimulasi, tanpa SSID dan tanpa kata sandi, bergabung 1,5 s kemudian dengan lease yang sama; 2 menaruh 1 di NET_RESULT_REG saat link sedang (atau terakhir) merupakan yang berkabel. Linknya hanya satu: STATUS, IP dan setiap permintaan membacanya dari cara aktifnya apa pun |
| 20 | SOFTAP |
soft AP (crates/net/src/softap.rs, docs/wifi.md), operasinya di NET_ARG_REG: 1 mengaktifkannya (ring keluar ssid\0password\0 dan byte channel; NET_RESULT_REG 1, atau 0 dengan ERR untuk nama kosong atau kata sandi satu sampai tujuh karakter), 2 mematikannya, 3 mengonfigurasinya (alamat, gateway dan netmask, masing-masing empat byte), 4 alamatnya (0 saat mati), 5 station yang bergabung, 6 join, leave dan bit aktif yang diubah runtime menjadi event, 7 dan 8 DNS server captive portal yang menyala (namanya, satu byte nol, alamatnya) dan berhenti, 9 namanya ke ring masuk, 10 alamat HP, 11 Host dari permintaan yang sedang dilayani ke ring masuk. Station satu-satunya adalah HP panel Web |
Kode POLL negatif: -1 nama tidak ter-resolve, -2 station tidak terasosiasi, -3 https:// dan TLS tidak disimulasikan, -4 body lebih panjang dari ring, -5 URL yang tidak bisa di-parse jaringan ini, -6 sudah ada permintaan yang berjalan. firmware/include/HTTPClient.h mengubahnya menjadi kode bergaya Arduino yang dibandingkan oleh sketch, dan docs/wifi.md memuat daftar pemetaannya.
Timing, semuanya milik model ini sendiri dan semuanya dinyatakan di docs/wifi.md: asosiasi memakan waktu satu sampai tiga detik, ditentukan dari SSID supaya sebuah pelajaran memakan waktu yang sama dua kali; kata sandi yang salah menjadi WL_CONNECT_FAILED setelah lima detik; permintaan ke origin tersimulasi kembali 60 ms kemudian; permintaan ke server milik sketch sendiri yang tidak pernah dijawab sketch ditutup oleh jaringan dengan 504 setelah sepuluh detik.
3.9 Watchdog grup timer, reset RTC_CNTL dan monitor stack (0x6001_F000, 0x6002_0000, 0x6000_8000, 0x600C_E000)
Watchdog utama tiap grup timer (crates/esp-common/src/mwdt.rs): WDTCONFIG0..5, WDTFEED dan kunci WDTWPROTECT, empat tahap, masing-masing dengan aksinya (interupsi, reset CPU, atau reset sistem), preskaler pada clock APB 80 MHz atau, dengan WDT_USE_XTAL, kristal 40 MHz, dan konfigurasi yang ditulis berlaku saat WDT_CONF_UPDATE_EN. Bit watchdog di TIMG_INT_ENA/RAW/ST/CLR (bit 1) menaikkan interupsi eksternal mesin, seperti halnya GPIO dan UART0 (bagian 3.6). Tahap reset me-reset chip dengan clock tetap berjalan dan RTC_CNTL_RESET_STATE_REG menyebutkan alasannya (7 atau 8 untuk reset sistem, 0xB atau 0x11 untuk reset CPU); RAM dimuat ulang dari image, RTC_CNTL_STORE0..7 mempertahankan nilainya, dan RTC_CNTL_SW_SYS_RST serta RTC_CNTL_SW_PROCPU_RST di RTC_CNTL_OPTIONS0_REG juga me-resetnya (penyebab 3 dan 0xC).
Runtime menjalankan task watchdog ESP-IDF di watchdog grup timer 0, seperti yang dilakukan ESP-IDF (firmware/src/main.cpp): tick 500 µs, tahap 0 interupsi saat timeout dan tahap 1 reset sistem pada dua kali itu, dimulai sebelum setup() pada 5 s dengan panic, mengawasi idle task core 0. Interupsinya mencetak baris-baris ESP-IDF ("E (…) task_wdt: Task watchdog got triggered. …", task-tasknya, "Aborting.", baris abort dan "Rebooting..."), meninggalkan petunjuk ESP_RST_TASK_WDT milik ESP-IDF di register penyimpanan RTC dan me-reset CPU lewat reset software, sehingga esp_reset_reason() mengatakan 6 setelahnya. esp_task_wdt_*, enableLoopWDT() dan enable/disableCore0WDT() beraksi padanya. Watchdog grup timer 1 dimodelkan dengan cara yang sama dan tidak ada di runtime yang mempersenjatainya: interrupt watchdog tidak disimulasikan.
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. Kanal host
host = "utf-8 bytes on UART0". readHost mengembalikan byte TX UART0 saat mereka keluar dari FIFO; writeHost mendorong byte ke FIFO RX UART0 (kelebihan dibuang, seperti di chip). Serial monitor menampilkan byte sebagai teks, mendekode UTF-8 dan memperlakukan \n sebagai akhir baris (\r diabaikan).
5. Model waktu
CPU berjalan di 160 MHz dengan satu instruksi per siklus. Komponen ini mengeksekusi dalam slice: pada tiap bangun ia menjalankan SLICE_NS * 160 instruksi (SLICE_NS = 10 us, jadi 1600 instruksi) lalu menjadwalkan bangun berikutnya, dengan aturan berikut:
- Tulisan ke peripheral yang mengubah pin (GPIO OUT atau ENABLE, pull IO_MUX) menggerakkan pin pada waktu slice dimulai ditambah jumlah instruksi sejauh itu dibagi 160 MHz. Gunakan
drive_afterdengan delay itu supaya dua toggle dalam satu slice mempertahankan jaraknya. Pembacaan GPIO_IN melihat level pin pada awal slice. - Perbandingan timer dan pengaturan laju UART dievaluasi terhadap waktu dalam-slice yang sama, jadi
micros()monotonik dan busy-waitdelayMicrosecondsakurat sampai satu instruksi. - 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: komponen berhenti menylice dan menjadwalkan bangun pada yang paling awal antara target timer dan event UART; perubahan pin GPIO membangunkannya seketika.- Fault akses: inti trap ke
mtvec; denganmtvec = 0itu ter-trap ulang selamanya. Komponen menghitung trap dan setelah 1000 trap berturut-turut tanpa kemajuan ia berhenti dan melaporkan "firmware crashed at pc=…, mcause=…" melaluiprobe(lihat di bawah) dan channel host (satu baris).
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. Runtime 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. Apa yang sudah pasti pada model ini, dan apa yang belum
Tiga kelompok, dengan pengurutan yang sama seperti docs/esp32c6.md bagian 7. Ini ada karena model board yang menebak alamat diam-diam lebih buruk daripada yang mengaku tidak tahu.
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.
Dipercaya, belum diverifikasi. Dinamai seperti itu register per register di bagian 3.1 dan 3.5, dan diulang di sini supaya daftarnya ada di satu tempat:
- Setiap offset register one-shot di dalam
APB_SARADCkecuali0x00dan0x04. YaituFSM_WAITdi 0x0C,ONETIME_SAMPLEdi 0x38 dan posisi field-nya,1_DATA_STATUSdi 0x44, empat register interrupt di 0x64 sampai 0x70, danAPB_ADC_CLKM_CONFdi 0x78. Itulah yang diimplementasikan model ini, dipilih agar cocok dengan bentuk jalur one-shot, bukan baris yang dikutip dari halaman manual. - Indeks sinyal matriks GPIO 45 sampai 50 untuk
ledc_ls_sig_out0sampailedc_ls_sig_out5, dipilih agar matriks punya tempat untuk meletakkannya.
Firmware yang dibuat untuk dokumen ini cocok dengan model ini, entah cocok atau tidak dengan silikon. Image yang akan dibawa ke DevKitM-1 sungguhan sebaiknya memeriksa #define di firmware/include/esp32c3.h terhadap manual terlebih dahulu.
Dimodelkan, tapi tidak diharuskan mengikuti angka manual. Perilaku, bukan alamat:
- ADC pada 11 dB adalah kurva komponen tipikal, bukan kurva unit ini. Saturasi di sekitar 2,9 V dan penguatan di atas rentang efektif 2,5 V ada (bagian 3.5); sebaran unit-ke-unit yang dikoreksi kalibrasi eFuse dan derau konversi tidak ada. Atenuasi lainnya adalah garis lurus nominal (1,1 V, 1,5 V, 2,2 V).
- Satu instruksi adalah satu siklus pada 160 MHz. Tidak ada pipeline stall, tidak ada cache (memang tidak ada cache), tidak ada flash wait state dan tidak ada perebutan bus, jadi jumlah instruksi adalah clock-nya. C3 sungguhan yang berjalan dari flash lebih lambat dan kurang merata daripada ini.
- Pad-nya adalah tiga state dan satu ambang. Push-pull pada 3,3 V, high-Z, atau pull internal 45 kΩ, dibaca kembali terhadap setengah suplai, tanpa histeresis, tanpa pengaturan drive-strength, tanpa rise time dan tanpa batas arus. Pin yang tidak didorong terbaca 0, bukan mengambang ke suatu nilai.
- Board-nya adalah suplai ideal: 3V3 dan 5V pada impedansi rail selamanya, jadi tidak ada yang brown out. Startup-nya satu mikrosekon, sedangkan C3 sungguhan menghabiskan puluhan milidetik di boot ROM-nya.
- Satu slice adalah 10 µs, dan SoC serta rangkaian bertemu di batas slice atau di titik apa pun yang sedang ditunggu chip.
Sengaja tidak ada. Dihilangkan alih-alih diciptakan, karena tata letak register bukan sesuatu yang bisa direproduksi model ini dengan jujur: Bluetooth LE (tanpa radio, dan tanpa pura-pura memilikinya), SPI, I2C, I2S, RMT, USB Serial/JTAG, timer dari timer groups (watchdog-nya ada di bagian 3.9), matriks interrupt lengkap (bagian 3.6 menjelaskan apa yang menggantikannya), ADC2 dan tabel pola DMA SAR ADC, digital controller, filter, threshold monitor dan eFuse kalibrasi, group high-speed LEDC beserta hardware duty-fade dan jalur interrupt-nya ke core, PMU dan clock tree, cache, ROM dan flash. Itulah sebabnya binary vendor ESP-IDF dan Arduino core tidak berjalan di sini, sedangkan firmware yang di-build untuk dokumen ini berjalan.
WiFi: disimulasi, lihat 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 adalah kontrak untuk apa yang dilakukan jaringan itu dan, lebih rinci lagi, untuk apa yang tidak dilakukannya.