Başvuru

ESP32-C6 kart sözleşmesi (Faz 9)

DevKitC-1: otuz bir GPIO, bir SRAM penceresi ve modellenmeyenlerin düz bir hesabı.

Bu, modelin mühendislik referansıdır: neyi uyguladığını, yazmaç yazmaç, ona karşı firmware yazan kişiler için. Kartı düzenleyicide kullanmak için başlangıç noktan ESP32-C6-DevKitC-1 ve kart sayfası.

ESP32-C6-DevKitC-1, buradaki ikinci RISC-V kart. Bir çekirdek bileşeni (esp32c6, crates/parts içinde) bir ESP32-C6 SoC modelini (crates/esp32c6) C3 ile aynı hart üzerinde (crates/rv32-core) sarar. Çekirdek paylaşımlıdır; çevresindeki çip ise değildir. Bu belge sözleşmedir ve koddaki herhangi bir yorumdan üstün tutulur.

Katalog türü esp32c6. Bir bölüm "docs/esp32c3.md gibi" diyorsa, o belge o kısım için sözleşmedir.

Buradaki bir derlemeyi gerçek silikona götürüyorsan önce 7. bölümü oku. Bu model C6'dan küçüktür ve her zamankinden daha büyük bir kısmı "inanılan, doğrulanmayan" olarak işaretlidir: 7. bölüm bu adreslerin hangileri olduğunu ve tamamen nelerin yok olduğunu söyler. Burada hiçbir şey sessizce tahmin edilmiş değildir. SAR ADC'nin kayıt ofsetleri olan 3.6 numaralı bölüm, düzeni o listede olan tek bloktur.

1. Kart pinleri (katalog sırası)

Üstten görünüm, altta iki USB-C soketi, üstte ESP32-C6-WROOM-1 modülü ve PCB anteni. Kart 52,5 x 25,4 mm ve iki 15 pinlik header'ı 22,86 mm (tam 0,9 inç) arayla yerleşmiştir, böylece bir breadboard'un orta kanalına oturur.

Sıralama Espressif'in ESP32-C6-DevKitC-1 kullanıcı kılavuzundaki "Header Block", J1 ve J3 bölümleridir (kart v1.2). Her header'da listelenmeyen on altıncı bir delik vardır: NC.

Sol header (J1), yukarıdan aşağıya (15 delik): 3V3, RST, 4, 5, 6, 7, 0, 1, 8, 10, 11, 2, 3, 5V, GND.

Sağ header (J3), yukarıdan aşağıya (15 delik): GNDb, TX, RX, 15, 23, 22, 21, 20, 19, 18, 9, GNDd, 13, 12, GNDc.

Sonra 14, gerçek kartın iki header'ında da bulunmayan pin (aşağıya bak).

31 pin. TX ve RX, GPIO 16 ve 17'dir: serigrafi bunları işlevlerine göre adlandırır çünkü konsol UART'ı bunlardır. Yinelenen adlar bir harf taşır çünkü katalogdaki pin adları benzersizdir.

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.

Çipte GPIO 0'dan 30'a kadar pinler var. GPIO 24 ve yukarısı bu pakette SPI flash'a aittir ve iki header'da da yoktur.

Kartta hiçbir header'da bulunmayan iki pin var:

  • GPIO 8 üzerine lehimlenmiş adreslenebilir bir RGB LED vardır. Bir poke ona ulaşmaz ve kart parçası onu çözemez: WS2812 bir protokoldür, bir seviye değil. ws2812 parçasını GPIO 8'e bağla, kodun gönderdiği renklerle yanar; rainbow örneğinin yaptığı da budur.
  • GPIO 9, BOOT butonudur, aktif düşük. Sağ header'da da vardır, yani kablolanabilir; poke kart üzerinde onu toprağa çeker.

Elektriksel: docs/esp32c3.md bölüm 1'deki gibi. Her GPIO, R_STRONG üzerinden 3,3 V ile push-pull sürer, high-Z olur ya da 45 k üzerinden yukarı ya da aşağı çeker. Bir giriş 1,65 V'ta yüksek okur; çekişmeli (Unknown) bir ağ 0 okur, boşta olan gürültü okur, Uno'daki gibi (docs/uno.md bölüm 1). GPIO9, hiçbir şey tutmazken kart üzerinde BOOT butonunun yanındaki pull-up sayesinde yüksek okur. 3V3, R_SUPPLY üzerinden 3,3 V sürer; 5V, 5 V sürer; üç toprak 0 V sürer. RST, 3,3 V'a 10 k pull-up taşır ve 1,65 Voltun altına çekmek çekirdeği reset halinde tutar.

İki header'ın kesin serigrafi sırası, bu modelin DevKitC-1 pin çıkışına okumasıdır. GPIO numaraları çipe aittir ve firmware buna bağlıdır; header üzerindeki konumları ise bir diyagramın bağlı olduğu şeydir. Gerçek kartın sıraları farklıysa, burada çizilen bir devre masada yeniden kablolama gerektirirdi ve başka hiçbir şey değişmezdi.

2. Bellek haritası

HP SRAM 0x4080_0000 ile 0x4087_FFFF arasında 512 KB
Flash (code and constants) 0x4200_0000, read-only, up to 1,310,720 bytes
yığın tepe 0x4088_0000
UART0 0x6000_0000, bölüm 3.3
LEDC 0x6000_7000, bölüm 3.7
SYSTIMER 0x6000_A000, bölüm 3.4
APB_SARADC 0x6000_E000, bölüm 3.6 (içteki ofsetler tahmini)
IO_MUX 0x6009_0000, bölüm 3.2
GPIO 0x6009_1000, bölüm 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.

Tek pencere. C3'ten fark yaratan ilk şey budur; orada aynı 400 KB RAM iki kez görünür (talimat veriyolu için 0x4037_C000, veri veriyolu için 0x3FC7_C000) ve her erişim ikisini de denemek zorundadır. Burada her iki veriyolu da HP SRAM'e aynı adreslerden ulaşır, yani bir yükleme adresi bir çalışma adresidir, .data reset'te kopya gerektirmez ve veriyolu iki değil tek aralık kontrolüdür.

Her PT_LOAD segmenti o aralığın içinde olmalıdır; başka her şey, mesajda sorunlu adres belirtilerek reddedilir ve çip programsız kalır.

3. Çevre birimi yazmaçları

Yalnızca aşağıdaki alt küme uygulanmıştır. Eşlenmiş bir 4 KB'lık bloğun içindeki başka her şey 0 okur ve başıboş erişim olarak sayılır; hiçbir bloğun dışında kalan her şey erişim hatasıdır.

3.1 GPIO (0x6009_1000)

ofset yazmaç
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

0'dan 30'a bitler vardır; 31. bit yazmada maskelenir. GPIO_PINn_REG 2. bit PAD_DRIVER padi open drain yapar, 7..9 bitleri INT_TYPE pinin kesintisini neyin yükselteceğini seçer: 0 kapalı, 1 yükselen, 2 düşen, 3 herhangi bir kenar, 4 düşük seviye, 5 yüksek seviye. 128'deki GPIO_FUNCn_OUT_SEL_CFG_REG padi GPIO_OUT'u izler yapar; 45 ile 50 arası onu LEDC düşük hızlı 0'dan 5'e kanallara verir (bölüm 3.7, ve bu altı indeks doğrulanmamıştır); başka herhangi bir değer modellenmemiş bir çevre birimini seçer ve model seviye uydurmak yerine onu 128 gibi ele alır. LEDC kanalının sürdüğü bir padin yine de GPIO_ENABLE_REG içindeki çıkış sürücüsünün açık olması gerekir.

3.2 IO_MUX (0x6009_0000)

IO_MUX_GPIOn_REG şu adreste: 0x04 + 4n. Bit 7 FUN_WPD, bit 8 FUN_WPU, bit 9 FUN_IE, 12..14 bitleri MCU_SEL; bunlardan 1 düz GPIO anlamına gelir. Bir pad, giriş tamponu etkinleştirilmişse GPIO_IN_REG'e ulaşabilir, donanımın yaptığı da tam olarak budur. Her pin FUN_IE | (1 << 12) değeriyle açılır, dolayısıyla yalnızca GPIO_ENABLE ve GPIO_OUT yazan bir program her pinde aynı şekilde davranır.

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.

Yine de C3'ün bitleri değil. Aynı kılavuzla karşılaştırılarak kontrol edildi:

  • UART_CONF0_REG (kılavuzdaki adıyla UART_CONF0_SYNC_REG, kayıt 27.9): 22. bit RXFIFO_RST ve 23. bit TXFIFO_RST FIFO'ları boşaltır. Bu modelin önceki bir sürümü C3'ün 17 ve 18. bitlerini kullanıyordu; bunlar C6'da başka alanlardır. Gerçek silisyumda bir _SYNC kaydına yazılan değer, UART_REG_UPDATE (0x98) kurulunca etkili olur; model bunu hemen uygular.
  • UART_CONF1_REG (kayıt 27.10): 0..7. bitler RXFIFO_FULL_THRHD ve 8..15. bitler TXFIFO_EMPTY_THRHD, ikisi de 96 değerine sıfırlanır. Bu modelin önceki bir sürümünde 0 ve 9. konumlarda dokuz bitlik alanlar vardı.
  • UART_STATUS_REG (kayıt 27.21): 0..7. bitler RXFIFO_CNT ve 16..23. bitler TXFIFO_CNT. Çalışma zamanı bunları kılavuzun verdiği gibi sekiz bitlik maskelerle okur. Bir zamanlar on bit okuyordu ama aynı sayıları döndürüyordu, çünkü her alanın üzerindeki iki bit rezerve edilmiştir ve 0 okur; başlık dosyası artık kılavuzla uyumlu.

Bölen (UART_CLKDIV_REG 0..11. bitler, on altıda birleri CLKDIV_FRAG 20..23. bitlerde tutar) UART'ın çekirdek saatini böler; C6'da bu saat UART içinde değil PCR'de seçilir: PCR_UART0_SCLK_CONF_REG (0x6009_6004, modellenen tek PCR registerı) 20..21. bitler UART0_SCLK_SEL (1: 80 MHz PLL_F80M_CLK, 3: 40 MHz kristal; 2, yani RC_FAST, kristal kabul edilir) ve 12..19. bitler UART0_SCLK_DIV_NUM, bir DIV_NUM + 1 ön bölücü. Sıfırlamadan çıkınca bu, bölünmemiş kristaldir ve UART_CLKDIV 347 değerine sıfırlanır, ki bu 115 274 baud yapar. Çalışma zamanı bir hızı ESP-IDF'nin uart_ll_set_baudrate işlevi gibi programlar (PLL_F80M, böleni 4096'nın altına indiren en küçük ön bölücü, sonra UART_REG_UPDATE), bu yüzden 1200 ve 9600 baud tam tutar, 4095 bölenine kırpılmaz.

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.

Sayaç, simüle edilmiş zamandan türetilen, sayılmayan bir 52 bitlik 16 MHz tik sayacıdır, bu yüzden devrenin geri kalanından asla sapmaz. Okuma işlemi önce latch sonra okumadır: UPDATE bitini kur, VALUE_VALID için bekle, önce HI sonra LO oku. Tek atımlık ve periyot modunun ikisi de çalışır.

3.5 Kesmeler

docs/esp32c3.md bölüm 3.5'teki gibi. C6'nın kesme matrisi modellenmemiştir: GPIO ve UART0, makine harici kesmesini paylaşır, mcause 11, ve kesme işleyicisi hangisinin tetiklendiğini anlamak için iki durum kaydını okur; SYSTIMER karşılaştırıcısı makine zamanlayıcı kesmesidir, mcause 7. mstatus.MIE, mie.MTIE ve mie.MEIE düzgün çalışır; mtvec doğrudan modda çalışır.

3.6 APB_SARADC (0x6000_E000)

Tek atımlık modda ADC1, kayıt kayta docs/esp32c3.md bölüm 3.5'in anlattığı gibi: ESP-IDF'nin adc_oneshot sürücüsünün ve Arduino çekirdeğinin analogRead işlevinin izlediği yol, başka hiçbir şey değil. Burada farklı olan pin dizilimi (yedi kanal, 0 ile 6 arası; bu pakette GPIO 0 ile GPIO 6) ve bloğun temel adresi.

Temel adres kılavuzdakidir (tablo 5.3-2); bu modelin önceki bir sürümünde 0x6000_F000 vardı, ki o USB Serial/JTAG denetleyicisinin adresidir. Bu bölümdeki her kayıt ofseti doğrulanmamıştır: bunlar C3'ün ofsetleridir ve ailenin yerleşimidir, C6 teknik referans kılavuzundan alınmış bir sayfa değildir. Gerçek bir DevKitC-1 üzerinde çalışması gereken bir program önce bunları kontrol etmelidir.

ofset ad bitler
0x00 APB_SARADC_CTRL_REG 7..14. bitler SAR_CLK_DIV. Saklanır ve geri okunur; buradaki dönüşüm zamanı sabittir
0x04 APB_SARADC_CTRL2_REG saklanır, geri okunur. Zamanlayıcı tarafından tetiklenen yol ve DMA yolu modellenmedi
0x0C APB_SARADC_FSM_WAIT_REG saklanır, geri okunur
0x38 APB_SARADC_ONETIME_SAMPLE_REG 23..24. bitler ONETIME_ATTEN, 25..28. bitler ONETIME_CHANNEL, 29. bit ONETIME_START, 30. bit SAR2_ONETIME_SAMPLE (saklanır, hiçbir şey dönüştürmez), 31. bit SAR1_ONETIME_SAMPLE
0x44 APB_SARADC_1_DATA_STATUS_REG 0..16. bitler ADC1_DATA: son ADC1 dönüşümü, on iki bit genişliğinde
0x64 APB_SARADC_INT_ENA_REG saklanır; çekirdeğe ulaşan bir hat yoktur
0x68 APB_SARADC_INT_RAW_REG 31. bit ADC1_DONE
0x6C APB_SARADC_INT_ST_REG ham ve etkin
0x70 APB_SARADC_INT_CLR_REG temizlemek için 1 yaz, aynı bit
0x78 APB_SARADC_APB_ADC_CLKM_CONF_REG saklanır, geri okunur

Tek dönüşüm: ONETIME_SAMPLE yazmacına SAR1_ONETIME_SAMPLE, kanal ve zayıflatma ile birlikte yaz, ONETIME_START kurulmuş şekilde tekrar yaz, INT_RAW içinde ADC1_DONE için bekle, veri yazmacını oku, bayrağı temizle ve ONETIME_START bitini indir. Bir dönüşüm sabit 5 us simüle edilmiş zaman alır ve firmware gerçekten bunu bekler.

Sonuç on iki bittir, round(4095 x Vin / Vfull), kırpılmış, dönüşüm başladığı andaki ağ geriliminden, ve ONETIME_ATTEN tam ölçeği veri sayfasındaki nominal değerlerden seçer: 0 dB 1,1 V, 2,5 dB 1,5 V, 6 dB 2,2 V ve 11 dB 3,3 V. Bu yüzden 3,3 V hattının yarısındaki bir bölücü, 11 dB'de yaklaşık 2048 okur. Bu düz doğru bu çip için geçerlidir; klasik ESP32, S3 ve C3 gibi değildir, onlar en geniş zayıflatmada rayın altında doyarlardı: C6'nın veri sayfası ve Espressif'in kendi ölçümleri, 12 dB'de 0 ile 3300 mV arasında kullanılabilir bir aralık verir. Pininde hiçbir şey bağlı olmayan bir kanal, yüzen bir girişin yaptığı gibi gezer (docs/uno.md bölüm 1).

ADC2, DMA örüntü tablosu, dijital denetleyici, filtreler ve eşik izleyicileri, kalibrasyon eFuse'ları ve dahili sıcaklık kanalı yoktur ve ADC1_DONE hiçbir zaman mip'e ulaşmaz.

3.7 LEDC (0x6000_7000)

LED PWM denetleyicisi, yavaş grup; bu çipte olan tek grup odur: dört zamanlayıcı ve altı kanal. analogWrite, ledcAttach ve ledcWrite arkasındaki blok budur. Kanal ve zamanlayıcı blokları C3'ünki olduğu yerdedir ama C6'nın LEDC'i C3'ünki yazmaç yazmacına değildir: zamanlayıcının çözünürlük alanı beş bittir ve yirmiye kadar çıkar, HPOINT ve DUTY daha geniştir ve genel yazmaçlar taşınmıştır.

Bir zamanlayıcı, CLK_DIV bölmesiyle (80 MHz'in kaç saat darbesi sayıldığını veren Q10.8 bir sayı) 80 MHz'da 2^DUTY_RES sayısı sayar, yani f = 80e6 / ((CLK_DIV / 256) * 2^DUTY_RES) olur ve 5 kHz'in sekiz bitte karşılığı tam olarak DUTY_RES 8 ve CLK_DIV 16000'dir. Bir kanal bir zamanlayıcı, bir başlangıç sayısı HPOINT ve bir görev çevrimi (duty) seçer, çıkışı HPOINT'ten itibaren DUTY >> 4 sayı boyunca yüksek kalır ve periodun tepesinde başa sarar. 0 görev çevrimi sürekli düşük, 2^DUTY_RES görev çevrimi ise sürekli yüksek anlamına gelir, hiç kenar üretilmez.

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.

ofset ad bitler
0x00 + 0x14n LEDC_CHn_CONF0_REG bit 0..1 TIMER_SEL, bit 2 SIG_OUT_EN, bit 3 IDLE_LV, bit 4 PARA_UP (saklanır; buraya yazılan bir görev döngüsü hemen etkili olur)
0x04 + 0x14n LEDC_CHn_HPOINT_REG bit 0..19 HPOINT: kanalın darbesinin başladığı sayı
0x08 + 0x14n LEDC_CHn_DUTY_REG bits 0..24 DUTY: darbe genişliği, sayımın on altıda biri cinsinden
0x0C + 0x14n LEDC_CHn_CONF1_REG bit 31 DUTY_START, görev çevrimi geçiş tetikleyicisi: saklanır, geri okunur ve hiçbir geçiş yapmaz
0x10 + 0x14n LEDC_CHn_DUTY_R_REG halihazırdaki görev döngüsü, salt okunur
0xA0 + 8n LEDC_TIMERn_CONF_REG bit 0..4 DUTY_RES (1 ile 20 arası; 0, kimsenin yapılandırmadığı ve hiçbir şey saymayan bir zamanlayıcıdır), bit 5..22 CLK_DIV, bit 23 PAUSE, bit 24 RST, bit 26 PARA_UP (saklanır); bit 25 rezerve
0xA4 + 8n LEDC_TIMERn_VALUE_REG sayaç, salt okunur
0xC0 LEDC_INT_RAW_REG bit n = zamanlayıcı n taştı
0xC4 LEDC_INT_ST_REG ham ve etkin
0xC8 LEDC_INT_ENA_REG saklanır; çekirdeğe ulaşan bir hat yoktur
0xCC LEDC_INT_CLR_REG temizlemek için 1 yaz
0x1F0 LEDC_CONF_REG bit 0..1 SCLK_SEL (0 = 80 MHz PLL_F80M_CLK, modellenen tek kaynak; 1 RC_FAST_CLK, 2 XTAL_CLK; saklanır), bit 2..7 gamma-RAM saat kapıları (saklanır), bit 31 CLK_EN (saklanır)
0x1FC LEDC_DATE_REG salt okunur bir sürüm damgası: 0x0211_1150

Bir kanal pad'e GPIO matrisi üzerinden ulaşır: pad'in GPIO_ENABLE bitini ayarla ve onun GPIO_FUNCn_OUT_SEL_CFG_REG adresinde 45 + channel. Bu sinyal indeksleri, ledc_ls_sig_out0 ile ledc_ls_sig_out5 için 45'ten 50'ye kadar, henüz doğrulanmamıştır. Section 3.1's OUT_SEL of 128 still means the pad follows GPIO_OUTizler ve 128 de LEDC kanalı da olmayan her değer, uydurulmak yerine 128 gibi değerlendirilir.

Sayaç adım adım ilerletilmez: simüle edilmiş zamanın kapalı biçimli bir fonksiyonudur ve bir sonraki kenarın zamanı da öyledir; bu yüzden wfi'de bekleyen bir çekirdek bir PWM çalışırken hiçbir şeye mal olmaz ve kart yalnızca kenarlar için, başka hiçbir şey için değil uyandırılır.

Modellenmeyenler: yüksek hızlı grup (bu çipte yok), görev çevrimi geçiş (duty-fade) ve gamma donanımı, 80 MHz PLL saati dışındaki saat kaynakları ve LEDC'nin kesme matrisine giden kesme hattı: LEDC_INT_RAW_REG okunup temizlenebilir ama hiçbir zaman mip'e ulaşmaz.

3.8 Mokxi ağ posta kutusu (0x6FFF_E000)

Bu blok ESP32-C6'ya ait değildir. Bu belgedeki diğer her adres çipe aittir, 7 numaralı bölümün ayırdığı gibi inanılır veya aktarılır, ve buna göre derlenen bir görüntü, DevKitC-1 için bir görüntüdür. Bu blok ise Mokxi'nin kendisidir: crates/net'in simüle edilmiş ağı, gerçek parçanın eşleştirmediği bir adrese yerleştirilmiştir (C6'nın çevre birimleri 0x6000_xxxx penceresinin alt kısmında ve 0x6009_xxxx içinde bulunur, üst kısmında hiçbir şey cevap vermez), böylece onu kullanan bir görüntü silisyumda hata verir, başka bir çevre biriminin yazmacını okumaz. Bu hata dürüst bir cevaptır, çünkü bu bloğun arkasındaki şey çipte yoktur. Adres, ESP32-C3'ün kullandığıyla aynıdır, çünkü her iki parça da aynı yeri boş bırakır.

Burada radyo, 802.11 ve gerçek internet yoktur. Modelde hiçbir şey iletilmez, taranmaz, ilişkilendirilmez, şifrelenmez veya soket açılmaz: bir parola dizgi olarak karşılaştırılır, .mokxi altında olmayan bir ad çözümlenmez ve ağın hizmet verdiği üç kaynak, crates/net/src/http.rs içindeki fonksiyonlardır. Posta kutusu, bir MAC hakkındaki bir kurgu değil, gerçek ara yüzün biçimidir: gerçek bir ESP32'de WiFi donanımı, komut arabirimli kapalı bir ikili bloktur ve Arduino'nun WiFi.h kitaplığı bunlardan birinin öbür tarafında biter. Arkasında ne olduğunu belirleyen sözleşme docs/wifi.md dosyasıdır; bu bölüm yalnızca yazmaçlardır.

Bir komut yazmacı, bir durum yazmacı, her yönde 4096 baytlık bir halka ve bir kesme biti. NET_CMD_REG'e yazmak komutu çalıştırır; simüle edilmiş zaman alan bir komut BUSY'yi yükseltir ve bittiğinde onu temizler; NET_INT_RAW_REG içinde DONE belirir.

ofset ad bitler
0x00 NET_ID_REG 0x494B4F4D okur, başka hiçbir şey okumaz. Mokxi'de olup olmadığını öğrenmek isteyen bir kod bunu okur; silisyumda bu erişim hata üretir
0x04 NET_CMD_REG bir komut kodu yaz (aşağıdaki tablo); yazma işlemi onu çalıştırır
0x08 NET_ARG_REG tek bir argüman kelimesi, geri okunur: LISTEN için port, REPLY için durum
0x0C NET_STATUS_REG bit 0 BUSY, bit 1 ERR, bit 2 RX_READY, bit 3 LINK, bit 4 SERVE, 8..11 bitleri STATE
0x10 NET_RESULT_REG son komutun verdiği yanıt
0x14 NET_INT_RAW_REG bit 0 DONE, bit 1 EVENT
0x18 NET_INT_ENA_REG aynı iki bit
0x1C NET_INT_CLR_REG temizlemek için 1 yaz, aynı iki bit
0x20 NET_TX_LEN_REG giden halkada hazırlanan baytlar
0x24 NET_TX_DATA_REG yaz: giden halkaya tek bir bayt (bit 0..7) ekle
0x28 NET_RX_LEN_REG gelen halka tamponda bekleyen baytlar
0x2C NET_RX_DATA_REG oku: gelen halka tampondan tek bir bayt al, boşken 0
0x30 NET_RING_LEN_REG halkaların her birinin bayt cinsinden kapasitesi, böylece firmware 4096'ı sabit kodlamak zorunda kalmaz
0x40 NET_BT_CMD_REG Bluetooth: bir Bluetooth komut kodu yaz (docs/bluetooth.md); yazma işlemi onu çalıştırır
0x44 NET_BT_ARG_REG Bluetooth: tek bir argüman kelimesi, geri okunur; bir olay numarasını buraya bırakır
0x48 NET_BT_RESULT_REG Bluetooth: son Bluetooth komutunun verdiği yanıt
0x4C NET_BT_STATUS_REG bit 0 CLASSIC_ON, bit 1 CLASSIC_LINK, bit 2 EVENT, bit 3 BLE_ADV, bit 4 BLE_LINK, bit 5 BT_ERR, bit 8 HAS_CLASSIC, bit 9 HAS_BLE
0x50 NET_BT_TX_LEN_REG Bluetooth: baytlar kendi giden halka tamponunda hazırlanıyor
0x54 NET_BT_TX_DATA_REG Bluetooth: yaz: o halka tampona tek bir bayt gönder
0x58 NET_BT_RX_LEN_REG Bluetooth: kendi gelen halka tamponunda bekleyen baytlar
0x5C NET_BT_RX_DATA_REG Bluetooth: okuma: bir bayt çek, boş olduğunda 0

Sekiz NET_BT_ kaydı bloğun Bluetooth yarısıdır ve kendi halkalarına sahiptir: gerçek çipte olduğu gibi yalnızca Bluetooth LE, dolayısıyla Classic komutları BT_ERR bayrağını ayarlar. Arkalarında da radyo yoktur; docs/bluetooth.md onların sözleşmesidir.

STATE, istasyonun nerede olduğunu belirtir: 0 boşta, 1 başlıyor, 2 bağlanıyor, 3 bağlı, 4 başarısız, 5 böyle bir ağ yok. NET_CMD_STATUS, aynı şeyi bir kodun WiFi.status() çağrısından okuduğu Arduino wl_status_t koduna dönüştürür.

NET_CMD_REG ad ne yaptığı
0 NOP hiçbir şey
1 RESET bağlantıyı kes, iki halkayı da bırak, herhangi bir isteği bırak
2 CONNECT giden halka ssid\0password bilgisini tutar; bir ila üç saniye boyunca BUSY yükseltir
3 DISCONNECT ilişkilendirmeyi ve adresi bırak
4 STATUS NET_RESULT_REG = wl_status_t kodu
5 IP NET_RESULT_REG = kiralanan adres, ilk sekizli düşük baytta
6 RSSI NET_RESULT_REG = dBm cinsinden sinyal, işaret genişletilmiş
7 SSID gelen halka erişim noktasının adını alır
8 MAC gelen halka kartın altı MAC baytını alır
9 REQUEST giden halka method\0url\0headers\0body tutar; BUSY hatası verir
10 POLL NET_RESULT_REG = 0 istek sürerken, ardından HTTP durumu ya da ERR yukarıdayken negatif bir hata; gövde gelen halkaya düşer
11 LISTEN NET_ARG_REG içindeki portta dinle
12 ACCEPT NET_RESULT_REG = 1 ve gelen halka tamponu method\0path\0query\0body içerir, bekleyen bir şey yokken 0
13 REPLY kabul edilen isteğe NET_ARG_REG içindeki durumla yanıt ver; giden halka content-type\0body tutar
14 STOP dinlemeyi durdur
15 WL_GPIO_SET kablosuz parçanın kendi GPIO'larını NET_ARG_REG kaydından sür. Bu kart değil: bu parçanın radyosunda böyle bir pin yok, bu yüzden ERR'yi ayarlar ve hiçbir şeyi sürmez. Bir Pico W'nin kart üzerindeki LED'inin izlediği yol budur (docs/picow.md bölüm 3.8)
16 WL_GPIO_GET onları geri oku, ve burada da aynı ERR
17 BLYNK simüle edilmiş Blynk sunucusunda tek bir işlem, NET_ARG_REG'deki işlem ve giden halkadaki alanları; hemen NET_RESULT_REG'de yanıtlanır, ağdan kopukken ERR yükselir (docs/wifi.md, "Blynk")
19 ETH kablolu Ethernet (firmware/include/ETH.h), NET_ARG_REG'deki işlem: 1 bağlantıyı simüle edilmiş bir kablo üzerinden açar, SSID ve parola olmadan, 1,5 s sonra aynı kiralama ile katılır; 2, bağlantı (ya da son hali) kabluloyu olduğunda NET_RESULT_REG'ye 1 koyar. Tek bir bağlantı vardır: STATUS, IP ve her istek, hangi yoldan açılmışsa açılsın onu okur
20 SOFTAP soft AP (crates/net/src/softap.rs, docs/wifi.md), NET_ARG_REG'deki işlem: 1 onu açar (giden halkaya ssid\0password\0 ve kanal baytı; NET_RESULT_REG 1, ya da boş bir isim veya bir ile yedi karakterlik bir parola için ERR ile 0), 2 onu kapatır, 3 onu yapılandırır (adres, ağ geçidi ve ağ maskesi, her biri dört bayt), 4 adresi (kapalıyken 0), 5 katılan istasyonlar, 6 çalışma zamanının olaylara dönüştürdüğü katılmalar, ayrılmalar ve açık biti, 7 ve 8 bir captive portal'ın DNS sunucusunu başlatma (isim, bir sıfır baytı, adres) ve durdurma, 9 ismini gelen halkaya, 10 telefonun adresini, 11 hizmet verilen isteğin Host'unu gelen halkaya yazar. Tek istasyon Web panelinin telefonudur

Negatif POLL kodları: -1 isim çözümlenemez, -2 istasyon ilişkilendirilmemiş, -3 https:// ve TLS simüle edilmez, -4 halkadan uzun bir gövde, -5 bu ağın ayrıştıramadığı bir URL, -6 zaten devam eden bir istek var. firmware/include/HTTPClient.h bunları bir kodun karşılaştırdığı Arduino biçimli kodlara dönüştürür ve docs/wifi.md eşlemeyi listeler.

Zamanlama, tamamı bu modelin kendine ait ve tamamı docs/wifi.md'de belirtilmiş: bir ilişkilendirme bir ile üç saniye arasında sürer, SSID'den kararlaştırılır ki bir ders iki kez aynı süreyi alsın; yanlış bir parola beş saniye sonra WL_CONNECT_FAILED olur; simüle edilmiş bir kaynağa giden bir istek 60 ms sonra geri döner; kodun kendi sunucusuna gelen ve kodun hiç yanıtlamadığı bir istek, on saniye sonra ağ tarafından 504 ile kapatılır.

3.9 Zamanlayıcı gruplarının bekçileri, sıfırlamalar ve yığın izleyicisi (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.

Çalışma zamanı, ESP-IDF'nin yaptığı gibi ESP-IDF'nin görev bekçi zamanlayıcısını zamanlayıcı grubu 0'nın bekçisi üzerinde çalıştırır (firmware/src/main.cpp): 500 µs tikler, aşama 0 zaman aşımında bir kesme, aşama 1 iki katında bir sistem sıfırlaması; setup() öncesinde 5 s'de bir panikle başlatılır ve çekirdek 0'nın boşta görevini izler. Kesme, ESP-IDF'nin satırlarını yazdırır ("E (…) task_wdt: Task watchdog got triggered. …", görevler, "Aborting.", iptal satırı ve "Rebooting..."), ESP-IDF'nin ESP_RST_TASK_WDT ipucunu RTC saklama kaydında bırakır ve CPU'yu yazılım sıfırlamasıyla sıfırlar; böylece esp_reset_reason() sonrasında 6 der. esp_task_wdt_*, enableLoopWDT() ve enable/disableCore0WDT() ona etki eder. Zamanlayıcı grubu 1'in bekçisi de aynı şekilde modellenmiştir ve çalışma zamanında onu kuran bir şey yoktur: kesme bekçisi simüle edilmez.

4. Ana makine kanalı

host_write baytları UART0'ın alma FIFO'suna koyar; host_read gönderme FIFO'sundan çıkmış baytları alır. Bu, kodda Serial, arayüzde ise seri monitördür. Arayüz için baytlar UTF-8'dir ve model bakımından şeffaftır.

Bir DevKitC-1'de iki USB-C soketi vardır: biri USB-UART köprüsüne, yani bu kanala aittir; diğeri çipin kendi USB'sine aittir ve hiç modellenmemiştir.

5. Zaman modeli

docs/esp32c3.md bölüm 5'teki gibidir. HP çekirdek 160 MHz'de çalışır, döngü başına bir komut, dolayısıyla bir komut tam 6250 ps'dir ve 10 us'lik bir dilim tam 1600 komuttur. Bir dilimin içinde komut sayacı saat olur: bir SYSTIMER okuması, bir UART baytı ve bir pin değişimi, hepsi kendilerine neden olan komuta düşer.

Firmware çalışırken prob 1'dir, wfi'de beklemedeyken 0.5, durdurulmuşken (program yok, sıfırlamada tutuluyor veya çökmüş) 0'dır.

poke: 1, BOOT'u tutar (GPIO 9 düşük), 0 bırakır; 2, RST'yi tutar, 3 bırakır.

6. Firmware çalışma zamanı (firmware/c6/)

C3'ünkinden türetilmiş Arduino biçimli bir çalışma zamanı: setup() ve loop(), pinMode, digitalWrite, digitalRead, analogRead (analogReadResolution, analogSetAttenuation ve analogSetPinAttenuation ile), analogWrite ve ledcAttach/ledcWrite çifti, millis, micros, delay, delayMicroseconds, attachInterrupt, Serial. Arduino core yok, ESP-IDF yok, libc yok.

analogRead, GPIO 0'dan GPIO 6'ya ADC1 tek atımdır (bölüm 3.6), varsayılan olarak 11 dB'de on iki bit; dolayısıyla firmware/lib/mokxi_joystick.h burada da C3'te olduğu gibi derlenir ve çalışır. analogWrite(pin, 0..255) herhangi bir GPIO'da 1 kHz'de sekiz bittir ve ilk çağrıldığında boş bir LEDC kanalına bağlanır; frekans önemli olduğunda bir kodun istediği ledcAttach(pin, frequency, bits) biçimidir ve aynı frekans ile çözünürlüğü isteyen kanallar dört zamanlayıcıdan birini paylaşır.

clang --target=riscv32-unknown-elf -march=rv32imc -mabi=ilp32 ile derlendi, firmware/c6/link.ld'ye bağlandı. Çalışma zamanının üç dosyası C3'ünkilerdir; bu kart için kopyalanmak yerine yeniden derlenmişlerdir: sayı biçimlendirme, matematik yardımcıları ve bağımsız floor, ayrıca Print ve main. Bu kartın kendi dosyaları ise yazmaç başlık dosyası, pin sayısı, başlangıç kodu, bağlayıcı betiği ve GPIO, ADC, PWM, zaman, UART ve kesme sürücüleridir.

Katalogdaki program dizgesi elf32 riscv32imc esp32c6'dır. C3'ünkinden farklıdır çünkü ELF gerçekten de farklıdır: aynı komut seti, farklı bellek haritası, ve biri için bağlanmış bir görüntü diğerinde çalışmaz.

LED_BUILTIN 8'dir ve bu kartta adreslenebilir RGB LED'dir. Onu yüksek ve düşük sürmek breadboard üzerinde yine de işe yarar; rainbow örneği bu pinin gerçek amacını gösterir.

Altı örnek: blink, button (GPIO 9'daki BOOT butonu), serial, fade (GPIO 10'daki bir LED'in donanım PWM ile nefes alması), stick (ADC1 kanal 0 ve 1'e bağlı bir KY-023, iki LED'in parlaklığı LEDC üzerinden geri çıkıyor) ve rainbow (bir renk tonu çemberi RGB LED'e ve GPIO 8'deki yedi LED'e daha bit-bang ile gönderiliyor). Bir örnek için 16 KB bütçe ayrılmıştır.

7. Bu modelin emin oldukları ve emin olmadıkları

Üç grup. Bu bölümün varlık sebebi şudur: bir adresi sessizce tahmin eden kart modeli, bilmediğini söyleyen modelden daha kötüdür.

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.

Bilinçli olarak yok. Bunların her biri, uydurulmak yerine dışarıda bırakıldı; çünkü yazmaç düzeni bu modelin dürüstçe yeniden üretebileceği bir şey değil:

  • Zamanlayıcı gruplarının zamanlayıcıları (TIMG0 ve TIMG1). Bekçi devreleri (watchdog) bölüm 3.9'dakilerdir. Buradaki zaman SYSTIMER'dan gelir ve bu, millis, micros ve bekleyen bir delay için yeterlidir.
  • RMT, normalde RGB LED'i sürmesi gereken şey. rainbow örneği bunun yerine bit-bang kullanır ve bu bir kısayol değildir: buradaki tek yol budur.
  • LP çekirdeği ve çevre birimleri, LP_UART ve LP_I2C dahil. C6'nın düşük güç alanı, bu parçayı ilginç yapan şeyin yarısıdır ve hiçbiri burada yok.
  • Kesme matrisi, hangi çevre biriminin hangi mcause'a ulaştığına karar veren, PLIC biçimindeki yönlendirme. Bölüm 3.5, onun yerine neyin geçtiğini anlatır.
  • ADC2, SAR ADC'nin DMA'sı ve dijital denetleyicisi, filtreleri, eşik izleyicileri ve kalibrasyon eFuse'ları. Bölüm 3.6 yalnızca ADC1 tek atış modudur, başka bir şey değil.
  • LEDC'nin görev-solma (duty-fade) donanımı ve kesme hattı: bölüm 3.7 zamanlayıcılar, kanallar ve çıkıştır; LEDC_INT_RAW_REG teslim edilmek yerine yoklanır.
  • PMU ve saat ağacı, önbellek, ROM, flash, SPI, I2C, I2S, USB Serial/JTAG, WiFi 6, Bluetooth LE ve 802.15.4.

Bu yüzden satıcı ESP-IDF ve Arduino çekirdeği ikili dosyaları burada çalışmaz ama bu belge için derlenen firmware çalışır.