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-C6-DevKitC-1 dan halaman board.
ESP32-C6-DevKitC-1 adalah board RISC-V kedua di sini. Satu komponen kernel (esp32c6 di crates/parts) membungkus model SoC ESP32-C6 (crates/esp32c6) pada hart yang sama dengan C3 (crates/rv32-core). Core-nya dibagi; chip di sekitarnya tidak. Dokumen ini adalah kontraknya, dan dokumen ini menang atas komentar apa pun di dalam kode.
Tipe katalognya adalah esp32c6. Jika sebuah bagian mengatakan "seperti docs/esp32c3.md", dokumen itu adalah kontrak untuk bagian tersebut.
Baca bagian 7 dulu jika kamu membawa build dari sini ke silikon sungguhan. Model ini lebih kecil dari C6, dan lebih banyak bagian dari biasanya yang ditandai "diyakini, tidak diverifikasi": bagian 7 menyebutkan alamat mana saja itu dan apa saja yang tidak ada sama sekali. Tidak ada di sini yang dikira-kira secara diam-diam. Bagian 3.6, offset register SAR ADC, adalah satu blok yang tata letaknya ada di daftar itu.
1. Pin board (urutan katalog)
Dilihat dari atas, dua soket USB-C ada di bawah, modul ESP32-C6-WROOM-1 beserta antena PCB-nya di atas. Board-nya berukuran 52,5 x 25,4 mm dan dua header 15 pin-nya berjarak 22,86 mm (tepat 0,9 inci), jadi board ini mengangkangi jalur tengah breadboard.
Urutannya mengikuti panduan pengguna ESP32-C6-DevKitC-1 dari Espressif, "Header Block", J1 dan J3 (board v1.2). Setiap header punya lubang keenam belas, NC, yang tidak didaftar.
Header kiri (J1), atas ke bawah (15 lubang): 3V3, RST, 4, 5, 6, 7, 0, 1, 8, 10, 11, 2, 3, 5V, GND.
Header kanan (J3), atas ke bawah (15 lubang): GNDb, TX, RX, 15, 23, 22, 21, 20, 19, 18, 9, GNDd, 13, 12, GNDc.
Lalu 14, yang tidak ada di kedua header board sungguhan (lihat di bawah).
31 pin. TX dan RX adalah GPIO 16 dan 17: silkscreen menamai mereka sesuai fungsinya karena keduanya adalah UART konsol. Nama duplikat diberi huruf karena nama pin katalog harus unik.
Until late October 2026 the drawing had J3 as GNDb, TX, RX, 9, 12, 13, 14, 21, 20, 19, 18, 15, 23, 22, GNDc and the bottom of J1 as GND, 5V. A diagram saved then is read with the part's header setting at early and keeps that drawing (web/src/parts/header-layout.ts); the catalog keeps GPIO 14's pin for it. On the real order (header: board, the default) the editor draws no 14, and a wire to it is left out of the circuit. The model does not read the setting.
Chip ini punya GPIO 0 sampai 30. GPIO 24 ke atas adalah flash SPI pada paket ini dan tidak ada di kedua header.
Dua pin pada board tidak ada di header sama sekali:
- GPIO 8 memiliki LED RGB addressable yang terpasang padanya. Sebuah
poketidak sampai ke sana dan komponen board tidak mendekodekannya: WS2812 adalah protokol, bukan level. Sambungkan komponenws2812ke GPIO 8 dan LED akan menyala dengan warna yang dikirim sketch, persis seperti yang dilakukan contohrainbow. - GPIO 9 adalah tombol BOOT, aktif rendah. Tombol ini juga ada di header kanan, jadi bisa disambungkan dengan kabel;
pokemen-ground-nya di board.
Kelistrikan: seperti bagian 1 di docs/esp32c3.md. Setiap GPIO mendorong push-pull pada 3,3 V melalui R_STRONG, berada dalam kondisi high-Z, atau menarik naik atau turun melalui 45 k. Input terbaca tinggi pada 1,65 V; net yang bergesekan (Unknown) terbaca 0, dan yang mengambang terbaca 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. 3V3 menggerakkan 3,3 V pada R_SUPPLY, 5V menggerakkan 5 V, dan tiga ground menggerakkan 0 V. RST memiliki pull-up 10 k ke 3,3 V, dan menariknya di bawah 1,65 V menahan core dalam kondisi reset.
Urutan silkscreen yang persis dari dua header adalah pembacaan model ini terhadap pinout DevKitC-1. Nomor GPIO milik chip dan menjadi andalan firmware; posisinya di header menjadi andalan diagram. Jika baris pada board asli urutannya berbeda, rangkaian yang digambar di sini perlu dirangkai ulang di meja kerja, dan tidak ada hal lain yang berubah.
2. Peta memori
| HP SRAM | 512 KB pada 0x4080_0000 sampai 0x4087_FFFF |
| Flash (code and constants) | 0x4200_0000, read-only, up to 1,310,720 bytes |
| puncak stack | 0x4088_0000 |
| UART0 | 0x6000_0000, bagian 3.3 |
| LEDC | 0x6000_7000, bagian 3.7 |
| SYSTIMER | 0x6000_A000, bagian 3.4 |
| APB_SARADC | 0x6000_E000, bagian 3.6 (offset di dalamnya diperkirakan) |
| IO_MUX | 0x6009_0000, bagian 3.2 |
| GPIO | 0x6009_1000, bagian 3.1 |
Every base address in this table is the ESP32-C6 Technical Reference Manual v1.2, table 5.3-2. An earlier version of this model put APB_SARADC at 0x6000_F000, which that table gives to the USB Serial/JTAG controller.
Flash. A real ESP32-C6 runs almost all of a sketch from flash through the cache, code and const data alike at 0x4200_0000, 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/c6/link.ld keeps the startup code and the trap entry in the HP SRAM and puts every other function and every constant in the flash window, with the variables and the stack in the SRAM from the end of the startup code up. The window is a read-only view 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 it faults.
Satu jendela. Ini adalah hal pertama yang berbeda dari C3, di mana RAM 400 KB yang sama muncul dua kali (di 0x4037_C000 untuk bus instruksi dan 0x3FC7_C000 untuk bus data), dan setiap akses harus mencoba keduanya. Di sini kedua bus mencapai HP SRAM di alamat yang sama, jadi alamat load adalah alamat run, .data tidak perlu disalin saat reset, dan busnya cukup satu pemeriksaan rentang, bukan dua.
Setiap segmen PT_LOAD harus berada di dalam rentang itu; selain itu akan ditolak dengan alamat bermasalah dicantumkan di pesan, dan chip dibiarkan tanpa program.
3. Register peripheral
Hanya subset di bawah ini yang diimplementasikan. Apa pun di dalam blok 4 KB yang dipetakan selain itu terbaca 0 dan dihitung sebagai akses liar; apa pun di luar setiap blok adalah access fault.
3.1 GPIO (0x6009_1000)
| offset | register |
|---|---|
0x04 |
GPIO_OUT_REG |
0x08 |
GPIO_OUT_W1TS_REG |
0x0C |
GPIO_OUT_W1TC_REG |
0x20 |
GPIO_ENABLE_REG |
0x24 |
GPIO_ENABLE_W1TS_REG |
0x28 |
GPIO_ENABLE_W1TC_REG |
0x3C |
GPIO_IN_REG |
0x44 |
GPIO_STATUS_REG |
0x4C |
GPIO_STATUS_W1TC_REG |
0x74 + 4n |
GPIO_PINn_REG |
0x554 + 4n |
GPIO_FUNCn_OUT_SEL_CFG_REG |
Bit 0 sampai 30 ada; bit 31 disamarkan saat penulisan. Bit 2 GPIO_PINn_REG PAD_DRIVER membuat pad open drain, dan bit 7..9 INT_TYPE memilih apa yang menaikkan interupsi pin: 0 mati, 1 rising, 2 falling, 3 semua edge, 4 level rendah, 5 level tinggi. GPIO_FUNCn_OUT_SEL_CFG_REG di 128 membuat pad mengikuti GPIO_OUT; 45 sampai 50 menyerahkannya ke kanal kecepatan rendah LEDC 0 sampai 5 (bagian 3.7, dan keenam indeks ini belum diverifikasi); nilai lain memilih periferal yang tidak dimodelkan, dan model memperlakukannya sebagai 128 alih-alih mengarang suatu level. Pad yang sedang digerakkan kanal LEDC tetap perlu driver outputnya dinyalakan di GPIO_ENABLE_REG.
3.2 IO_MUX (0x6009_0000)
IO_MUX_GPIOn_REG di 0x04 + 4n. Bit 7 FUN_WPD, bit 8 FUN_WPU, bit 9 FUN_IE, bit 12..14 MCU_SEL yang nilai 1-nya adalah GPIO biasa. Sebuah pad hanya mencapai GPIO_IN_REG jika buffer inputnya aktif, dan itulah yang dilakukan perangkat kerasnya. Setiap pin menyala saat awal dengan FUN_IE | (1 << 12), jadi program yang hanya menulis GPIO_ENABLE dan GPIO_OUT akan berperilaku sama di setiap pin.
3.3 UART0 (0x6000_0000)
The C3's offsets, as docs/esp32c3.md section 3.3 gives them: UART_FIFO_REG 0x00, UART_INT_RAW_REG 0x04, UART_INT_ST_REG 0x08, UART_INT_ENA_REG 0x0C, UART_INT_CLR_REG 0x10, UART_CLKDIV_REG 0x14, UART_STATUS_REG 0x1C, UART_CONF0_REG 0x20, UART_CONF1_REG 0x24 (the ESP32-C6 Technical Reference Manual v1.2, section 27 register summary). Two 128-byte FIFOs, and bytes leave the transmit FIFO at the baud rate rather than instantly.
Namun bukan bit milik C3. Diperiksa terhadap manual yang sama:
UART_CONF0_REG(UART_CONF0_SYNC_REGdi manual, register 27.9): bit 22RXFIFO_RSTdan bit 23TXFIFO_RSTmengosongkan FIFO. Versi model ini yang lebih awal memakai bit 17 dan 18 milik C3, yang pada C6 adalah field lain. Pada silikon, penulisan ke register_SYNCbaru berlaku setelahUART_REG_UPDATE(0x98) diset; model menerapkannya seketika.UART_CONF1_REG(register 27.10): bit 0..7RXFIFO_FULL_THRHDdan bit 8..15TXFIFO_EMPTY_THRHD, keduanya reset ke 96. Versi model ini yang lebih awal punya field sembilan bit di 0 dan 9.UART_STATUS_REG(register 27.21): bit 0..7RXFIFO_CNTdan bit 16..23TXFIFO_CNT. Runtime membacanya dengan mask delapan bit, sesuai manual. Dahulu dibaca sepuluh, yang menghasilkan angka yang sama karena dua bit di atas masing-masing field tercadang dan terbaca 0; header kini sesuai manual.
Pembagi (UART_CLKDIV_REG bit 0..11, dengan per enam belasannya di CLKDIV_FRAG, bit 20..23) membagi clock inti UART, yang pada C6 dipilih di PCR, bukan di UART: PCR_UART0_SCLK_CONF_REG (0x6009_6004, satu-satunya register PCR yang dimodelkan) bit 20..21 UART0_SCLK_SEL (1 untuk PLL_F80M_CLK 80 MHz, 3 untuk kristal 40 MHz; 2, RC_FAST, dianggap kristal) dan bit 12..19 UART0_SCLK_DIV_NUM, preskaler DIV_NUM + 1. Setelah reset itu berarti kristal, tanpa pembagian, dan UART_CLKDIV reset ke 347, yaitu 115 274 baud. Runtime memprogram laju seperti yang dilakukan uart_ll_set_baudrate milik ESP-IDF (PLL_F80M, preskaler terkecil yang membuat pembagi di bawah 4096, lalu UART_REG_UPDATE), jadi 1200 dan 9600 baud tepat, bukan dipatok di pembagi 4095.
3.4 SYSTIMER (0x6000_A000)
Unit 0 and comparator 0. SYSTIMER_UNIT0_OP_REG 0x04, SYSTIMER_UNIT0_VALUE_HI_REG 0x40, ..._LO_REG 0x44, SYSTIMER_TARGET0_HI_REG 0x1C, ..._LO_REG 0x20, SYSTIMER_TARGET0_CONF_REG 0x34, SYSTIMER_COMP0_LOAD_REG 0x50, SYSTIMER_INT_ENA_REG 0x64, ..._RAW_REG 0x68, ..._CLR_REG 0x6C, ..._ST_REG 0x70. Verified against the ESP32-C6 Technical Reference Manual v1.2, section 13 register summary and registers 13.14 to 13.17. An earlier version of this model put comparator 0 at 0x50 to 0x5C, which on the C6 are the load strobes; the runtime's images were rebuilt when that was corrected.
Penghitungnya adalah hitungan tick 52-bit 16 MHz yang diturunkan dari waktu simulasi, bukan dihitung, jadi tidak pernah bergeser dari rangkaian lainnya. Membacanya: latch lalu baca, set UPDATE, tunggu VALUE_VALID, baca HI lalu LO. Mode sekali jalan dan periodik keduanya bekerja.
3.5 Interupsi
Seperti docs/esp32c3.md bagian 3.5. Matriks interupsi C6 tidak dimodelkan: GPIO dan UART0 berbagi interupsi eksternal machine, mcause 11, dan handler membaca dua register status untuk mencari tahu mana yang terpicu; komparator SYSTIMER adalah interupsi timer machine, mcause 7. mstatus.MIE, mie.MTIE dan mie.MEIE berperilaku benar; mtvec berjalan dalam mode direct.
3.6 APB_SARADC (0x6000_E000)
ADC1 dalam mode one-shot, register demi register seperti dijelaskan di docs/esp32c3.md bagian 3.5: jalur yang ditempuh driver adc_oneshot milik ESP-IDF dan analogRead milik Arduino core, dan tidak ada yang lain. Yang berbeda di sini adalah pinout (tujuh kanal, 0 sampai 6, yang pada paket ini adalah GPIO 0 sampai GPIO 6) dan alamat dasar blok.
Alamat dasarnya milik manual (tabel 5.3-2); versi model ini yang lebih awal memakai 0x6000_F000, yang merupakan pengontrol USB Serial/JTAG. Setiap offset register di bagian ini belum terverifikasi: itu milik C3, yang merupakan layout keluarga ini, bukan halaman manual teknis C6 yang dikutip. Program yang harus berjalan di DevKitC-1 sungguhan sebaiknya memeriksanya dulu.
| offset | nama | bit |
|---|---|---|
0x00 |
APB_SARADC_CTRL_REG |
bit 7..14 SAR_CLK_DIV. Disimpan dan terbaca 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 |
tersimpan, terbaca kembali |
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 |
0x44 |
APB_SARADC_1_DATA_STATUS_REG |
bit 0..16 ADC1_DATA: konversi ADC1 terakhir, lebar dua belas bit |
0x64 |
APB_SARADC_INT_ENA_REG |
tersimpan; tidak ada jalur yang sampai ke core |
0x68 |
APB_SARADC_INT_RAW_REG |
bit 31 ADC1_DONE |
0x6C |
APB_SARADC_INT_ST_REG |
raw dan diaktifkan |
0x70 |
APB_SARADC_INT_CLR_REG |
tulis 1 untuk menghapus, bit yang sama |
0x78 |
APB_SARADC_APB_ADC_CLKM_CONF_REG |
tersimpan, terbaca kembali |
Satu konversi: tulis ONETIME_SAMPLE dengan SAR1_ONETIME_SAMPLE, kanal dan atenuasinya, tulis lagi dengan ONETIME_START naik, tunggu ADC1_DONE di INT_RAW, baca register data, hapus flag dan turunkan ONETIME_START. Satu konversi memakan 5 us waktu simulasi yang tetap, yang benar-benar ditunggu firmware.
Hasilnya dua belas bit, round(4095 x Vin / Vfull), dipatok, dari tegangan net pada saat konversi dimulai, dan ONETIME_ATTEN memilih skala penuh sesuai angka nominal lembar data: 0 dB adalah 1,1 V, 2,5 dB 1,5 V, 6 dB 2,2 V dan 11 dB 3,3 V. Pembagi tegangan di setengah rel 3,3 V karenanya terbaca sekitar 2048 pada 11 dB. Garis lurus itu benar untuk chip ini, tidak seperti ESP32 klasik, S3 dan C3, yang jenuh sebelum mencapai rel pada atenuasi terlebarnya: datasheet C6 dan pengukuran Espressif sendiri memberinya rentang terpakai 0 sampai 3300 mV pada 12 dB. Kanal dengan pin yang tidak tersambung apa pun akan mengembara, seperti input mengambang (docs/uno.md bagian 1).
ADC2, tabel pola DMA, pengontrol digital, filter dan monitor ambang, eFuse kalibrasi dan kanal suhu internal semuanya tidak ada, dan ADC1_DONE tidak pernah sampai ke mip.
3.7 LEDC (0x6000_7000)
Pengontrol LED PWM, grup low-speed, yang merupakan satu-satunya grup yang dimiliki chip ini: empat timer dan enam kanal. Ini blok di balik analogWrite, ledcAttach dan ledcWrite. Blok kanal dan timer berada di tempat yang sama seperti milik C3, tetapi LEDC C6 tidak sama register demi register dengan C3: field resolusi timernya lima bit dan sampai dua puluh, HPOINT dan DUTY lebih lebar, dan register globalnya berpindah.
Timer menghitung 2^DUTY_RES hitungan pada 80 MHz dibagi CLK_DIV, angka Q10.8 dari clock 80 MHz per hitungan, jadi 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 output-nya tinggi mulai dari HPOINT selama DUTY >> 4 hitungan, membungkus di puncak periode. Duty 0 adalah low terus-menerus dan duty 2^DUTY_RES high terus-menerus, tanpa edge sama sekali.
Verified: the base address (table 5.3-2) and every offset and bit in the table below, against the ESP32-C6 Technical Reference Manual v1.2, section 35.4 (register summary) and registers 35.1, 35.2, 35.8 to 35.14 and 35.23. An earlier version of this model used the C3's LEDC_CONF_REG at 0xD0 and LEDC_DATE_REG at 0xFC, the C3's fourteen-bit HPOINT, nineteen-bit DUTY and fourteen-bit resolution limit, and wrote LEDC_SCLK_SEL = 1, which on the C6 selects RC_FAST_CLK rather than the 80 MHz PLL clock. The C6's event-task, compare, capture and gamma-RAM registers (0x100 to 0x1CC) are not modeled.
| offset | nama | bit |
|---|---|---|
0x00 + 0x14n |
LEDC_CHn_CONF0_REG |
bit 0..1 TIMER_SEL, bit 2 SIG_OUT_EN, bit 3 IDLE_LV, bit 4 PARA_UP (tersimpan; duty yang ditulis di sini langsung berlaku) |
0x04 + 0x14n |
LEDC_CHn_HPOINT_REG |
bit 0..19 HPOINT: hitungan saat pulse channel dimulai |
0x08 + 0x14n |
LEDC_CHn_DUTY_REG |
bit 0..24 DUTY: lebar pulsa dalam seperenam belas hitungan |
0x0C + 0x14n |
LEDC_CHn_CONF1_REG |
bit 31 DUTY_START, pemicu duty-fade: disimpan, terbaca 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 |
bit 0..4 DUTY_RES (1 sampai 20; 0 berarti timer yang belum dikonfigurasi siapa pun dan tidak menghitung apa pun), bit 5..22 CLK_DIV, bit 23 PAUSE, bit 24 RST, bit 26 PARA_UP (disimpan); bit 25 cadangan |
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 |
0x1F0 |
LEDC_CONF_REG |
bit 0..1 SCLK_SEL (0 = PLL_F80M_CLK 80 MHz, satu-satunya sumber yang dimodelkan; 1 RC_FAST_CLK, 2 XTAL_CLK; disimpan), bit 2..7 gerbang clock gamma-RAM (disimpan), bit 31 CLK_EN (disimpan) |
0x1FC |
LEDC_DATE_REG |
stempel versi, hanya baca: 0x0211_1150 |
Sebuah channel sampai ke pad melalui matriks GPIO: atur GPIO_ENABLE dan arahkan GPIO_FUNCn_OUT_SEL_CFG_REG di 45 + channel. Indeks sinyal tersebut, 45 sampai 50 untuk ledc_ls_sig_out0 sampai ledc_ls_sig_out5, juga belum terverifikasi. Section 3.1's OUT_SEL of 128 still means the pad follows GPIO_OUT, dan nilai apa pun yang bukan 128 atau channel LEDC diperlakukan sebagai 128 alih-alih dikarang.
Penghitungnya tidak dinaikkan langkah demi langkah: ia fungsi bentuk-tertutup dari waktu simulasi, begitu juga waktu transisi berikutnya, jadi core yang parkir di wfi tidak menimbulkan biaya apa pun selama PWM berjalan, dan board hanya dibangunkan untuk transisi itu dan tidak untuk yang lain.
Tidak dimodelkan: grup high-speed (chip ini tidak punya), perangkat keras duty-fade dan gamma, sumber clock selain clock PLL 80 MHz, dan jalur interrupt LEDC ke matriks interrupt: LEDC_INT_RAW_REG bisa di-poll dan dihapus tapi tidak pernah sampai ke mip.
3.8 Kotak surat jaringan Mokxi (0x6FFF_E000)
Blok ini bukan milik ESP32-C6. Setiap alamat lain dalam dokumen ini milik chip, diyakini atau dikutip sebagaimana bagian 7 mengaturnya, dan image yang dibangun dengannya adalah image untuk DevKitC-1. Yang ini milik Mokxi sendiri: jaringan tersimulasi crates/net, dipetakan di alamat yang dibiarkan tak terpetakan oleh komponen aslinya (periferal C6 berada di bagian bawah jendela 0x6000_xxxx dan di 0x6009_xxxx, dan tidak ada yang menjawab di bagian atasnya), sehingga image yang memakainya fault di silikon alih-alih membaca register periferal lain. Fault itu adalah jawaban yang jujur, karena hal di balik blok ini memang tidak ada di chip. Ini alamat yang sama dengan yang dipakai ESP32-C3, karena kedua komponen sama-sama membiarkan tempat itu kosong.
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 dan monitor stack (0x6000_8000, 0x6000_9000, 0x600B_0400, 0x600B_1000, 0x600C_2000)
As the C3's (docs/esp32c3.md section 3.9), with the C6's addresses: the timer groups at 0x6000_8000 and 0x6000_9000, always on the 40 MHz crystal (their clock select is in PCR, of which only UART0's clock register is modeled), the reset cause in LP_CLKRST_RESET_CAUSE_REG, the store registers LP_AON_STORE0..9, LP_AON_HPSYS_SW_RESET and LP_AON_CPU_CORE0_SW_RESET for the software resets, and ASSIST_DEBUG at 0x600C_2000.
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.
4. Kanal host
host_write memasukkan byte ke FIFO terima UART0; host_read mengambil byte yang sudah keluar dari FIFO kirimnya. Itulah Serial dalam sebuah sketch dan serial monitor di UI. Byte dianggap UTF-8 oleh UI dan dianggap data mentah oleh model.
DevKitC-1 punya dua soket USB-C: satu ke jembatan USB-ke-UART, inilah channel itu, dan satu ke USB milik chip sendiri, yang tidak dimodelkan sama sekali.
5. Model waktu
Seperti docs/esp32c3.md bagian 5. Core HP berjalan di 160 MHz, satu instruksi per siklus, jadi satu instruksi tepat 6250 ps dan slice 10 us tepat 1600 instruksi. Di dalam slice, jumlah instruksi adalah clock-nya: pembacaan SYSTIMER, sebuah byte UART dan perubahan pin semua mendarat pada instruksi yang menyebabkannya.
probe bernilai 1 selama firmware berjalan, 0,5 saat parkir di wfi, 0 saat berhenti (tanpa program, ditahan reset, atau crash).
poke: 1 menahan BOOT (GPIO 9 rendah), 0 melepaskannya; 2 menahan RST, 3 melepaskannya.
6. Runtime firmware (firmware/c6/)
Runtime berbentuk Arduino yang diturunkan dari milik C3: setup() dan loop(), pinMode, digitalWrite, digitalRead, analogRead (dengan analogReadResolution, analogSetAttenuation dan analogSetPinAttenuation), analogWrite dan pasangan ledcAttach/ledcWrite, millis, micros, delay, delayMicroseconds, attachInterrupt, Serial. Tanpa Arduino core, tanpa ESP-IDF, tanpa libc.
analogRead adalah ADC1 one-shot pada GPIO 0 sampai GPIO 6 (bagian 3.6), dua belas bit pada 11 dB secara bawaan, jadi firmware/lib/mokxi_joystick.h bisa dikompilasi dan berjalan di sini seperti di C3. analogWrite(pin, 0..255) adalah delapan bit pada 1 kHz di GPIO mana pun dan mengambil channel LEDC yang kosong saat pertama kali dipanggil; ledcAttach(pin, frequency, bits) adalah yang dibutuhkan sketch saat frekuensi penting, dan channel yang meminta frekuensi dan resolusi yang sama berbagi satu dari empat timer.
Dibangun dengan clang --target=riscv32-unknown-elf -march=rv32imc -mabi=ilp32, di-link terhadap firmware/c6/link.ld. Tiga file runtime milik C3 dikompilasi ulang untuk board ini, bukan disalin: format angka, pembantu matematika dan floor freestanding, plus Print dan main. Milik board ini sendiri adalah header register, jumlah pin, kode startup, linker script, serta driver GPIO, ADC, PWM, waktu, UART dan interrupt.
String katalog program adalah elf32 riscv32imc esp32c6. Ini berbeda dari milik C3 karena ELF-nya memang berbeda: set instruksi yang sama, peta memori yang berbeda, dan image yang di-link untuk salah satunya tidak akan berjalan di yang lain.
LED_BUILTIN adalah 8, yang pada board ini adalah LED RGB yang bisa dialamatkan. Menyetelnya tinggi dan rendah tetap berguna di breadboard; contoh rainbow adalah kegunaan sebenarnya dari pin ini.
Enam contoh: blink, button (tombol BOOT di GPIO 9), serial, fade (sebuah LED di GPIO 10 bernapas di PWM hardware), stick (sebuah KY-023 di kanal ADC1 0 dan 1, dengan kecerahan dua LED dikirim kembali lewat LEDC) dan rainbow (roda warna yang di-bit-bang ke LED RGB dan tujuh LED lagi di GPIO 8). Setiap contoh dianggarkan 16 KB.
7. Apa yang sudah pasti pada model ini, dan apa yang belum
Tiga kelompok. Bagian ini ada karena model board yang diam-diam menebak sebuah alamat lebih buruk daripada yang mengaku tidak tahu.
Taken from the technical reference manual. Every base address in section 2 (the ESP32-C6 Technical Reference Manual v1.2, table 5.3-2): UART0_BASE = 0x6000_0000, LEDC_BASE = 0x6000_7000, SYSTIMER_BASE = 0x6000_A000, APB_SARADC_BASE = 0x6000_E000, IOMUX_BASE = 0x6009_0000 and GPIO_BASE = 0x6009_1000. Every register offset inside the UART, GPIO and IO_MUX blocks. The UART's FIFO-reset bits and CONF1 thresholds (registers 27.9 and 27.10), the SYSTIMER comparator (chapter 13) and every LEDC register in section 3.7 (chapter 35), all checked against that manual while the ESP32-S3 was being added; the C6 differs from the C3 in each of them, and each was wrong here before that check and has been corrected, with the runtime's images rebuilt. The GPIO range, 0 to 30. The HP SRAM's 512 KB at 0x4080_0000, and the fact that it is one window rather than two. The RGB LED on GPIO 8 and the BOOT button on GPIO 9. ADC1's channel map: channel n is GPIO n for n in 0 to 6.
Believed, not verified. The register offsets inside APB_SARADC, which are the C3's (section 3.6), and the GPIO matrix signal indices 45 to 50 for ledc_ls_sig_out0 to ledc_ls_sig_out5. Both are named in one place, firmware/c6/include/esp32c6.h, so an image being taken to real silicon has a short list of #defines to check. Firmware built here agrees with the model whether or not it agrees with silicon.
Sengaja tidak ada. Masing-masing ini sengaja ditinggalkan daripada dikarang, karena layout registernya bukan sesuatu yang bisa model ini tiru dengan jujur:
- Timer milik grup timer (TIMG0 dan TIMG1). Watchdog mereka adalah milik bagian 3.9. Waktu di sini berasal dari SYSTIMER, yang cukup untuk
millis,microsdandelayyang diparkir. - RMT, yang biasanya akan menggerakkan LED RGB. Contoh
rainbowjustru meng-bit-bag-nya, dan itu bukan jalan pintas: itu satu-satunya cara di sini. - LP core dan periferalnya, termasuk LP_UART dan LP_I2C. Domain daya rendah C6 adalah separuh dari yang membuat chip ini menarik dan tidak ada satu pun di sini.
- Matriks interupsi, routing berbentuk PLIC yang menentukan periferal mana mencapai
mcausemana. Bagian 3.5 menjelaskan apa yang menggantikannya. - ADC2, DMA dan pengendali digital SAR ADC, filter dan monitor ambangnya serta eFuse kalibrasinya. Bagian 3.6 hanya ADC1 one-shot dan tidak lebih.
- Perangkat keras duty-fade LEDC dan jalur interupsinya: bagian 3.7 mencakup timer, kanal dan output, dan
LEDC_INT_RAW_REGdi-poll, bukan dikirim. - PMU dan pohon clock, cache, ROM, flash, SPI, I2C, I2S, USB Serial/JTAG, WiFi 6, Bluetooth LE dan 802.15.4.
Itulah sebabnya binary ESP-IDF dan Arduino core dari vendor tidak berjalan di sini, sedangkan firmware yang dibangun untuk dokumen ini berjalan.