Referensi

Kontrak board ESP32-C3 (Phase 2)

Periferal, peta memori dan timing DevKitM-1.

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 pada R_SUPPLY; 5V* mengeluarkan 5 V pada R_SUPPLY; GND* mengeluarkan 0 V pada R_SUPPLY. Board selalu mendapat daya (USB). Board ini menjadi catu daya bagi rangkaian lainnya.
  • RST adalah 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, 21 bersifat inout. Output aktif: push-pull pada 3,3 V atau 0 V melalui R_STRONG. Output nonaktif: high-Z, plus pull-up 45 k ke 3,3 V saat FUN_WPU disetel di IO_MUX, atau pull-down 45 k saat FUN_WPD disetel. 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.md bagian 1); GPIO9 terbaca tinggi saat tidak ada yang menahannya, karena pull-up dari board di samping tombol BOOT.
  • GPIO 0 sampai 4 juga 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.md bagian 1).
  • Pin 18/19 berfungsi ganda sebagai USB D-/D+ dan 20/21 sebagai 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 saat INT_ENA bit 0 dan INT_RAW bit 0.
  • Machine external interrupt (mip.MEIP, cause 11): GPIO (GPIO_STATUS_REG non-zero) or UART0 (UART_INT_ST_REG non-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_after dengan 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-wait delayMicroseconds akurat sampai satu instruksi.
  • Cycle counters: rdcycle/cycle (0xC00, 0xC80), mcycle/mcycleh (0xB00, 0xB80) and the ESP32-C3's own performance counter, mpcer/mpcmr/mpccr (0x7E0 to 0x7E2, user views 0x800 to 0x802, the one ESP-IDF's esp_cpu_get_cycle_count reads), all read without trapping and count one per 160 MHz cycle, which is one per instruction. mpccr counts from reset (mpcer and mpcmr read 1); a write sets it, and mpcmr bit 0 clear holds it. None of them advance while the core is parked in wfi.
  • 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; dengan mtvec = 0 itu ter-trap ulang selamanya. Komponen menghitung trap dan setelah 1000 trap berturut-turut tanpa kemajuan ia berhenti dan melaporkan "firmware crashed at pc=…, mcause=…" melalui probe (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_SARADC kecuali 0x00 dan 0x04. Yaitu FSM_WAIT di 0x0C, ONETIME_SAMPLE di 0x38 dan posisi field-nya, 1_DATA_STATUS di 0x44, empat register interrupt di 0x64 sampai 0x70, dan APB_ADC_CLKM_CONF di 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_out0 sampai ledc_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.

Pertanyaan

Does it do WiFi?

WiFi tersimulasi, iya. Sketch-mu memakai panggilan Arduino yang asli (WiFi.begin, HTTPClient, WebServer) dan board bergabung, mengambil dan melayani data, tapi tidak ada radio dan tidak ada 802.11 di baliknya. Jika kamu masuk, kamu bisa menyalakan Internet sungguhan di panel Cloud. Bagian 3.8 dan halaman WiFi Tersimulasi memuat kontraknya.

Apakah firmware-ku berjalan di DevKitM-1 sungguhan?

Ya. Model ini berada di memory map dan offset register yang asli untuk semua yang diimplementasikannya, jadi build dari sini bukan build khusus Mokxi.