Esta é a referência de engenharia do modelo: o que ele implementa, registrador por registrador, para quem escreve firmware para ele. Para usar a placa no editor, comece por O ESP32-C6-DevKitC-1 e página da placa.
A ESP32-C6-DevKitC-1 é a segunda placa RISC-V aqui. Um componente do kernel (esp32c6 em crates/parts) envolve um modelo do SoC ESP32-C6 (crates/esp32c6) no mesmo hart que o C3 (crates/rv32-core). O núcleo é compartilhado; o chip ao redor dele, não. Este documento é o contrato, e ele prevalece sobre qualquer comentário no código.
O tipo no catálogo é esp32c6. Quando uma seção diz "como docs/esp32c3.md", esse documento é o contrato daquela parte.
Leia a seção 7 primeiro se você estiver levando uma compilação daqui para o silÃcio real. Este modelo é menor que o C6, e mais dele que o normal está marcado como "acreditado, não verificado": a seção 7 diz quais endereços são esses e o que está totalmente ausente. Nada aqui é adivinhado em silêncio. A seção 3.6, os offsets de registrador do ADC SAR, é o único bloco cujo layout está nessa lista.
1. Pinos da placa (ordem do catálogo)
Vista de cima, os dois conectores USB-C embaixo, o módulo ESP32-C6-WROOM-1 e sua antena de PCB em cima. A placa tem 52,5 x 25,4 mm e seus dois conectores de 15 pinos ficam a 22,86 mm (exatamente 0,9 polegada) de distância, então ela atravessa o canal central de uma protoboard.
A ordem é a do guia do usuário da ESP32-C6-DevKitC-1 da Espressif, "Header Block", J1 e J3 (placa v1.2). Cada conector tem um décimo sexto furo, NC, que não é listado.
Conector esquerdo (J1), de cima a baixo (15 furos): 3V3, RST, 4, 5, 6, 7, 0, 1, 8, 10, 11, 2, 3, 5V, GND.
Conector direito (J3), de cima a baixo (15 furos): GNDb, TX, RX, 15, 23, 22, 21, 20, 19, 18, 9, GNDd, 13, 12, GNDc.
Depois 14, que não está em nenhum dos dois conectores da placa real (veja abaixo).
31 pinos. TX e RX são os GPIO 16 e 17: a serigrafia os nomeia pela função porque eles são a UART do console. Nomes duplicados ganham uma letra porque os nomes de pino do catálogo são únicos.
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.
O chip tem os GPIO 0 a 30. Do GPIO 24 para cima são a flash SPI neste encapsulamento e não estão em nenhum conector.
Dois pinos da placa não estão em nenhum conector:
- GPIO 8 tem um LED RGB endereçável soldado nele. Um
pokenão o alcança e o componente da placa não o decodifica: um WS2812 é um protocolo, não um nÃvel. Ligue o componentews2812ao GPIO 8 e ele acende com as cores que o sketch está enviando, que é o que o exemplorainbowfaz. - GPIO 9 é o botão BOOT, ativo em nÃvel baixo. Ele também está no conector direito, então pode receber ligações; o
pokeo aterra na placa.
Elétrica: como a seção 1 de docs/esp32c3.md. Cada GPIO alimenta em push-pull a 3,3 V através de R_STRONG, fica em alta impedância, ou puxa para cima ou para baixo através de 45 k. Uma entrada lê alto a 1,65 V; um nó contestado (Unknown) lê 0, e um flutuante lê ruÃdo, como no Uno (docs/uno.md seção 1). GPIO9 lê alto quando nada o segura, pelo pull-up da placa ao lado do botão BOOT. 3V3 fornece 3,3 V em R_SUPPLY, 5V fornece 5 V, os três terras fornecem 0 V. RST carrega um pull-up de 10 k para 3,3 V, e puxá-lo abaixo de 1,65 V mantém o núcleo em reset.
A ordem exata da serigrafia dos dois conectores é a leitura que este modelo faz do pinout da DevKitC-1. Os números de GPIO são do chip e são aquilo de que o firmware depende; a posição deles no conector é aquilo de que um diagrama depende. Se as fileiras da placa real estiverem ordenadas de forma diferente, um circuito desenhado aqui precisaria ser religado numa mesa, e nada mais mudaria.
2. Mapa de memória
| SRAM HP | 512 KB em 0x4080_0000 a 0x4087_FFFF |
| Flash (code and constants) | 0x4200_0000, read-only, up to 1,310,720 bytes |
| topo da pilha | 0x4088_0000 |
| UART0 | 0x6000_0000, seção 3.3 |
| LEDC | 0x6000_7000, seção 3.7 |
| SYSTIMER | 0x6000_A000, seção 3.4 |
| APB_SARADC | 0x6000_E000, seção 3.6 (offsets internos acreditados) |
| IO_MUX | 0x6009_0000, seção 3.2 |
| GPIO | 0x6009_1000, seção 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.
Uma janela. Esta é a primeira coisa que difere do C3, onde os mesmos 400 KB de RAM aparecem duas vezes (em 0x4037_C000 para o barramento de instruções e 0x3FC7_C000 para o barramento de dados), e todo acesso precisa tentar ambos. Aqui os dois barramentos alcançam a SRAM HP nos mesmos endereços, então um endereço de carga é um endereço de execução, .data não precisa de cópia no reset, e o barramento é uma verificação de intervalo em vez de duas.
Todo segmento PT_LOAD precisa cair dentro dessa faixa; qualquer outra coisa é recusada com o endereço problemático na mensagem, e o chip fica sem programa.
3. Registradores de periféricos
Apenas o subconjunto abaixo está implementado. Qualquer outra coisa dentro de um bloco mapeado de 4 KB lê 0 e conta como acesso perdido; qualquer coisa fora de todos os blocos é uma falta de acesso.
3.1 GPIO (0x6009_1000)
| offset | registrador |
|---|---|
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 |
Os bits 0 a 30 existem; o bit 31 é mascarado numa escrita. O bit 2 PAD_DRIVER do GPIO_PINn_REG torna o pad open drain, e os bits 7..9 INT_TYPE escolhem o que levanta a interrupção do pino: 0 desligado, 1 borda de subida, 2 borda de descida, 3 qualquer borda, 4 nÃvel baixo, 5 nÃvel alto. GPIO_FUNCn_OUT_SEL_CFG_REG em 128 faz o pad seguir GPIO_OUT; 45 a 50 o entregam aos canais de baixa velocidade 0 a 5 do LEDC (seção 3.7, e esses seis Ãndices não são verificados); qualquer outro valor seleciona um periférico que não é modelado, e o modelo o trata como 128 em vez de inventar um nÃvel. Um pad que um canal do LEDC está alimentando ainda precisa do driver de saÃda ligado em GPIO_ENABLE_REG.
3.2 IO_MUX (0x6009_0000)
IO_MUX_GPIOn_REG em 0x04 + 4n. Bit 7 FUN_WPD, bit 8 FUN_WPU, bit 9 FUN_IE, bits 12..14 MCU_SEL, dos quais 1 é GPIO simples. Um pad só alcança GPIO_IN_REG com seu buffer de entrada habilitado, que é o que o hardware faz. Todo pino liga com FUN_IE | (1 << 12), então um programa que só escreve em GPIO_ENABLE e GPIO_OUT se comporta igual em todo pino.
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.
Já os bits não são os do C3. Conferidos com o mesmo manual:
UART_CONF0_REG(oUART_CONF0_SYNC_REGdo manual, registrador 27.9): o bit 22RXFIFO_RSTe o bit 23TXFIFO_RSTesvaziam as FIFOs. Uma versão anterior deste modelo usava os bits 17 e 18 do C3, que no C6 são outros campos. No silÃcio, uma escrita em um registrador_SYNCsó tem efeito quandoUART_REG_UPDATE(0x98) é definido; o modelo aplica de imediato.UART_CONF1_REG(registrador 27.10): bits 0..7RXFIFO_FULL_THRHDe bits 8..15TXFIFO_EMPTY_THRHD, ambos reiniciando em 96. Uma versão anterior deste modelo tinha campos de nove bits em 0 e 9.UART_STATUS_REG(registrador 27.21): bits 0..7RXFIFO_CNTe bits 16..23TXFIFO_CNT. O runtime os lê com máscaras de oito bits, como o manual os apresenta. Ele já leu dez, o que retornava os mesmos números porque os dois bits acima de cada campo são reservados e leem 0; o cabeçalho agora corresponde ao manual.
O divisor (UART_CLKDIV_REG bits 0..11, com os dezesseis avos em CLKDIV_FRAG, bits 20..23) divide o clock do núcleo da UART, que no C6 é escolhido na PCR e não na UART: PCR_UART0_SCLK_CONF_REG (0x6009_6004, o único registrador da PCR modelado) bits 20..21 UART0_SCLK_SEL (1 o PLL_F80M_CLK de 80 MHz, 3 o cristal de 40 MHz; 2, RC_FAST, é tratado como o cristal) e bits 12..19 UART0_SCLK_DIV_NUM, um prescaler de DIV_NUM + 1. Logo após o reset isso é o cristal, sem divisão, e UART_CLKDIV reinicia em 347, o que dá 115 274 baud. O runtime programa uma taxa como o uart_ll_set_baudrate do ESP-IDF faz (PLL_F80M, o menor prescaler que deixa o divisor abaixo de 4096, depois UART_REG_UPDATE), então 1200 e 9600 baud são exatos em vez de limitados a um divisor de 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.
O contador é uma contagem de ticks de 52 bits a 16 MHz, derivada do tempo simulado em vez de contada, então nunca se desalinha do resto do circuito. Lê-lo é travar-e-ler: defina UPDATE, espere VALUE_VALID, leia HI e depois LO. Os modos disparo único e periódico funcionam.
3.5 Interrupções
Como a seção 3.5 de docs/esp32c3.md. A matriz de interrupções do C6 não é modelada: GPIO e UART0 compartilham a interrupção externa de máquina, mcause 11, e o handler lê os dois registradores de status para descobrir qual disparou; o comparador do SYSTIMER é a interrupção de timer de máquina, mcause 7. mstatus.MIE, mie.MTIE e mie.MEIE funcionam; mtvec roda em modo direto.
3.6 APB_SARADC (0x6000_E000)
ADC1 em modo de disparo único, registrador por registrador como a seção 3.5 de docs/esp32c3.md descreve: o caminho que o driver adc_oneshot do ESP-IDF e o analogRead do core do Arduino usam, e nada mais. O que muda aqui é a pinagem (sete canais, 0 a 6, que neste encapsulamento são GPIO 0 a GPIO 6) e o endereço base do bloco.
O endereço base é o do manual (tabela 5.3-2); uma versão anterior deste modelo tinha 0x6000_F000, que é o controlador USB Serial/JTAG. Cada offset de registrador nesta seção não foi verificado: são os do C3, que é o layout da famÃlia, não uma página do manual técnico do C6 citada de volta. Um programa que precise rodar em um DevKitC-1 real deve conferi-los primeiro.
| offset | nome | bits |
|---|---|---|
0x00 |
APB_SARADC_CTRL_REG |
bits 7..14 SAR_CLK_DIV. Armazenado e lido de volta; o tempo de conversão aqui é fixo |
0x04 |
APB_SARADC_CTRL2_REG |
armazenado, lido de volta. Os caminhos por trigger de timer e por DMA não são modelados |
0x0C |
APB_SARADC_FSM_WAIT_REG |
armazenado, lido de volta |
0x38 |
APB_SARADC_ONETIME_SAMPLE_REG |
bits 23..24 ONETIME_ATTEN, bits 25..28 ONETIME_CHANNEL, bit 29 ONETIME_START, bit 30 SAR2_ONETIME_SAMPLE (armazenado, não converte nada), bit 31 SAR1_ONETIME_SAMPLE |
0x44 |
APB_SARADC_1_DATA_STATUS_REG |
bits 0..16 ADC1_DATA: a última conversão do ADC1, com doze bits |
0x64 |
APB_SARADC_INT_ENA_REG |
armazenado; nenhuma linha chega ao core |
0x68 |
APB_SARADC_INT_RAW_REG |
bit 31 ADC1_DONE |
0x6C |
APB_SARADC_INT_ST_REG |
raw e habilitado |
0x70 |
APB_SARADC_INT_CLR_REG |
escreva 1 para limpar, mesmo bit |
0x78 |
APB_SARADC_APB_ADC_CLKM_CONF_REG |
armazenado, lido de volta |
Uma conversão: escreva ONETIME_SAMPLE com SAR1_ONETIME_SAMPLE, o canal e a atenuação, escreva de novo com ONETIME_START em alto, espere ADC1_DONE em INT_RAW, leia o registrador de dados, limpe a flag e baixe ONETIME_START. Uma conversão leva 5 us fixos de tempo simulado, tempo que o firmware realmente espera.
O resultado tem doze bits, round(4095 x Vin / Vfull), com limites, da tensão do nó no momento em que a conversão começou, e ONETIME_ATTEN escolhe a escala cheia nos valores nominais do datasheet: 0 dB é 1,1 V, 2,5 dB 1,5 V, 6 dB 2,2 V e 11 dB 3,3 V. Um divisor na metade do trilho de 3,3 V, portanto, lê cerca de 2048 a 11 dB. Essa reta está certa para este chip, ao contrário do ESP32 clássico, do S3 e do C3, que saturam antes do trilho na atenuação mais larga: o datasheet do C6 e as próprias medições da Espressif dão a ele uma faixa utilizável de 0 a 3300 mV a 12 dB. Um canal com nada em seu pino vagueia, como faz uma entrada flutuante (docs/uno.md seção 1).
O ADC2, a tabela de padrões DMA, o controlador digital, os filtros e monitores de limiar, as eFuses de calibração e o canal de temperatura interna estão todos ausentes, e ADC1_DONE nunca chega a mip.
3.7 LEDC (0x6000_7000)
O controlador de PWM para LED, grupo de baixa velocidade, que é o único grupo que este chip tem: quatro timers e seis canais. Este é o bloco por trás de analogWrite, ledcAttach e ledcWrite. Os blocos de canal e timer ficam onde os do C3 ficam, mas o LEDC do C6 não é o do C3 registrador por registrador: o campo de resolução do timer tem cinco bits e vai até vinte, HPOINT e DUTY são mais largos, e os registradores globais mudaram de lugar.
Um temporizador conta 2^DUTY_RES contagens a 80 MHz dividido por CLK_DIV, um número Q10.8 de ciclos de 80 MHz por contagem, então f = 80e6 / ((CLK_DIV / 256) * 2^DUTY_RES) e 5 kHz a oito bits é DUTY_RES 8 com CLK_DIV 16000, exatamente. Um canal escolhe um temporizador, uma contagem inicial HPOINT e um duty, e sua saÃda fica alta a partir de HPOINT por DUTY >> 4 contagens, dando a volta no topo do perÃodo. Um duty de 0 é um nÃvel baixo contÃnuo e um duty de 2^DUTY_RES é um nÃvel alto contÃnuo, sem nenhuma transição.
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 | nome | bits |
|---|---|---|
0x00 + 0x14n |
LEDC_CHn_CONF0_REG |
bits 0..1 TIMER_SEL, bit 2 SIG_OUT_EN, bit 3 IDLE_LV, bit 4 PARA_UP (armazenado; um duty escrito aqui faz efeito imediatamente) |
0x04 + 0x14n |
LEDC_CHn_HPOINT_REG |
bits 0..19 HPOINT: a contagem em que o pulso do canal começa |
0x08 + 0x14n |
LEDC_CHn_DUTY_REG |
bits 0..24 DUTY: a largura do pulso em dezesseis avos de contagem |
0x0C + 0x14n |
LEDC_CHn_CONF1_REG |
bit 31 DUTY_START, o gatilho do duty-fade: armazenado, lido de volta, e não faz nenhum fade |
0x10 + 0x14n |
LEDC_CHn_DUTY_R_REG |
o duty como está, somente leitura |
0xA0 + 8n |
LEDC_TIMERn_CONF_REG |
bits 0..4 DUTY_RES (1 a 20; 0 é um temporizador que ninguém configurou e ele não conta nada), bits 5..22 CLK_DIV, bit 23 PAUSE, bit 24 RST, bit 26 PARA_UP (armazenado); o bit 25 é reservado |
0xA4 + 8n |
LEDC_TIMERn_VALUE_REG |
o contador, somente leitura |
0xC0 |
LEDC_INT_RAW_REG |
bit n = o timer n transbordou |
0xC4 |
LEDC_INT_ST_REG |
raw e habilitado |
0xC8 |
LEDC_INT_ENA_REG |
armazenado; nenhuma linha chega ao core |
0xCC |
LEDC_INT_CLR_REG |
escreva 1 para limpar |
0x1F0 |
LEDC_CONF_REG |
bits 0..1 SCLK_SEL (0 = o PLL_F80M_CLK de 80 MHz, a única fonte modelada; 1 RC_FAST_CLK, 2 XTAL_CLK; armazenado), bits 2..7 os portões de clock da gamma-RAM (armazenado), bit 31 CLK_EN (armazenado) |
0x1FC |
LEDC_DATE_REG |
um carimbo de versão, somente leitura: 0x0211_1150 |
Um canal chega a um pad pela matriz de GPIO: defina o bit de GPIO_ENABLE do pad e aponte seu GPIO_FUNCn_OUT_SEL_CFG_REG em 45 + channel. Esses Ãndices de sinal, 45 a 50 para ledc_ls_sig_out0 a ledc_ls_sig_out5, também não são verificados. Section 3.1's OUT_SEL of 128 still means the pad follows GPIO_OUT, e qualquer valor que não seja nem 128 nem um canal LEDC é tratado como 128 em vez de inventado.
O contador não é incrementado passo a passo: ele é uma função em forma fechada do tempo simulado, e o mesmo vale para o instante da sua próxima transição, então um núcleo parado em wfi não custa nada enquanto um PWM roda, e a placa é acordada para as transições e para mais nada.
Não modelado: o grupo de alta velocidade (este chip não tem), o hardware de duty-fade e gamma, fontes de clock outras que o clock de 80 MHz do PLL, e a linha de interrupção do LEDC na matriz de interrupções: LEDC_INT_RAW_REG pode ser consultado e limpo, mas nunca chega ao mip.
3.8 Caixa de correio de rede do Mokxi (0x6FFF_E000)
Este bloco não é do ESP32-C6. Todos os outros endereços neste documento são do chip, acreditados ou citados como a seção 7 os classifica, e uma imagem compilada contra eles é uma imagem para um DevKitC-1. Este é do próprio Mokxi: a rede simulada de crates/net, mapeada em um endereço que o componente real deixa sem mapeamento (os periféricos do C6 ficam na parte de baixo da janela 0x6000_xxxx e em 0x6009_xxxx, e nada responde no topo dela), de modo que uma imagem que o use falha no silÃcio em vez de ler o registrador de outro periférico. Essa falha é a resposta honesta, porque a coisa por trás deste bloco não existe no chip. É o mesmo endereço que o ESP32-C3 usa, porque ambos os componentes deixam o mesmo lugar vazio.
Aqui não há rádio, nem 802.11, nem internet real. Nada no modelo transmite, escaneia, associa, criptografa ou abre um socket: uma senha é comparada como string, um nome que não está sob .mokxi não resolve, e as três origens que a rede serve são funções em crates/net/src/http.rs. A caixa de correio tem a forma da costura real em vez de uma ficção sobre um MAC: num ESP32 real o hardware de WiFi é um blob binário fechado com uma interface de comandos, e o WiFi.h do Arduino acaba do outro lado de um destes. docs/wifi.md é o contrato do que está por trás dele; esta seção é apenas os registradores.
Um registrador de comando, um registrador de status, um anel de 4096 bytes em cada sentido e um bit de interrupção. Escrever em NET_CMD_REG executa o comando; um comando que leva tempo simulado levanta BUSY e o limpa, com DONE em NET_INT_RAW_REG, quando termina.
| offset | nome | bits |
|---|---|---|
0x00 |
NET_ID_REG |
lê 0x494B4F4D, e nada mais o faz. Um sketch que quer saber se está no Mokxi lê isto; no silÃcio o acesso falha |
0x04 |
NET_CMD_REG |
escreva um código de comando (tabela abaixo); a escrita o executa |
0x08 |
NET_ARG_REG |
uma palavra de argumento, lida de volta: a porta para LISTEN, o status para REPLY |
0x0C |
NET_STATUS_REG |
bit 0 BUSY, bit 1 ERR, bit 2 RX_READY, bit 3 LINK, bit 4 SERVE, bits 8..11 STATE |
0x10 |
NET_RESULT_REG |
o que o último comando respondeu |
0x14 |
NET_INT_RAW_REG |
bit 0 DONE, bit 1 EVENT |
0x18 |
NET_INT_ENA_REG |
os mesmos dois bits |
0x1C |
NET_INT_CLR_REG |
escreva 1 para limpar, os mesmos dois bits |
0x20 |
NET_TX_LEN_REG |
bytes preparados no anel de saÃda |
0x24 |
NET_TX_DATA_REG |
escrita: empurra um byte (bits 0..7) para o anel de saÃda |
0x28 |
NET_RX_LEN_REG |
bytes aguardando no anel de entrada |
0x2C |
NET_RX_DATA_REG |
leitura: retira um byte do anel de entrada, 0 quando está vazio |
0x30 |
NET_RING_LEN_REG |
capacidade de cada anel em bytes, para o firmware não precisar fixar 4096 |
0x40 |
NET_BT_CMD_REG |
Bluetooth: escreva um código de comando Bluetooth (docs/bluetooth.md); a escrita o executa |
0x44 |
NET_BT_ARG_REG |
Bluetooth: uma palavra de argumento, lida de volta; um evento deixa seu número aqui |
0x48 |
NET_BT_RESULT_REG |
Bluetooth: o que o último comando Bluetooth respondeu |
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: bytes preparados no seu próprio anel de saÃda |
0x54 |
NET_BT_TX_DATA_REG |
Bluetooth: escrita: empurra um byte para esse anel |
0x58 |
NET_BT_RX_LEN_REG |
Bluetooth: bytes aguardando no seu próprio anel de entrada |
0x5C |
NET_BT_RX_DATA_REG |
Bluetooth: leitura: retira um byte, 0 quando está vazio |
Os oito registradores NET_BT_ são a metade Bluetooth do bloco, com anéis próprios: só Bluetooth LE, como no chip real, então os comandos do Classic setam BT_ERR. Também não há rádio por trás deles; docs/bluetooth.md é o contrato deles.
STATE é onde está a estação: 0 ociosa, 1 iniciando, 2 conectando, 3 conectada, 4 falhou, 5 rede inexistente. NET_CMD_STATUS transforma a mesma coisa no código wl_status_t do Arduino que um sketch lê de WiFi.status().
NET_CMD_REG |
nome | o que faz |
|---|---|---|
| 0 | NOP |
nada |
| 1 | RESET |
desconecta, zera ambos os anéis, descarta qualquer requisição |
| 2 | CONNECT |
o anel de saÃda contém ssid\0password; levanta BUSY por um a três segundos |
| 3 | DISCONNECT |
descarta a associação e o endereço |
| 4 | STATUS |
NET_RESULT_REG = o código wl_status_t |
| 5 | IP |
NET_RESULT_REG = o endereço obtido, primeiro octeto no byte menos significativo |
| 6 | RSSI |
NET_RESULT_REG = o sinal em dBm, com sinal estendido |
| 7 | SSID |
o anel de entrada recebe o nome do ponto de acesso |
| 8 | MAC |
o anel de entrada recebe os seis bytes de MAC da placa |
| 9 | REQUEST |
o anel de saÃda contém method\0url\0headers\0body; levanta BUSY |
| 10 | POLL |
NET_RESULT_REG = 0 em andamento, depois o status HTTP, ou um erro negativo com ERR ativo; o corpo chega no anel de entrada |
| 11 | LISTEN |
escuta na porta em NET_ARG_REG |
| 12 | ACCEPT |
NET_RESULT_REG = 1 e o anel de entrada contém method\0path\0query\0body, ou 0 quando nada está aguardando |
| 13 | REPLY |
responde à requisição aceita com o status em NET_ARG_REG; o anel de saÃda contém content-type\0body |
| 14 | STOP |
para de escutar |
| 15 | WL_GPIO_SET |
controla os próprios GPIOs do componente sem fio a partir de NET_ARG_REG. Não nesta placa: o rádio deste componente não tem esse pino, então ele define ERR e não controla nada. É o caminho que o LED embutido de um Pico W percorre (docs/picow.md seção 3.8) |
| 16 | WL_GPIO_GET |
lê de volta, e o mesmo ERR aqui |
| 17 | BLYNK |
uma operação no servidor Blynk simulado, a operação em NET_ARG_REG e seus campos no anel de saÃda; respondida de imediato em NET_RESULT_REG, com ERR ativo, sem passar pela rede (docs/wifi.md, "Blynk") |
| 19 | ETH |
Ethernet com fio (firmware/include/ETH.h), a operação em NET_ARG_REG: 1 levanta o enlace por um cabo simulado, sem SSID e sem senha, conectado 1,5 s depois com o mesmo lease; 2 coloca 1 em NET_RESULT_REG quando o enlace é (ou foi por último) o com fio. Há um único enlace: STATUS, IP e toda requisição o leem de que forma ele tenha subido |
| 20 | SOFTAP |
o soft AP (crates/net/src/softap.rs, docs/wifi.md), a operação em NET_ARG_REG: 1 o levanta (o anel de saÃda ssid\0password\0 e o byte de canal; NET_RESULT_REG 1, ou 0 com ERR para um nome vazio ou uma senha de um a sete caracteres), 2 o derruba, 3 o configura (endereço, gateway e máscara de rede, quatro bytes cada), 4 seu endereço (0 enquanto estiver derrubado), 5 as estações conectadas, 6 as entradas, saÃdas e o bit de ativo que o runtime transforma em eventos, 7 e 8 um servidor DNS de portal cativo iniciando (o nome, um byte zero, o endereço) e parando, 9 seu nome no anel de entrada, 10 o endereço do telefone, 11 o Host da requisição sendo servida no anel de entrada. A única estação é o telefone do painel Web |
Os códigos negativos de POLL: -1 o nome não resolve, -2 a estação não está associada, -3 https:// e o TLS não são simulados, -4 um corpo maior que o anel, -5 uma URL que esta rede não consegue interpretar, -6 já há uma requisição em andamento. firmware/include/HTTPClient.h os transforma nos códigos no formato Arduino que um sketch compara, e docs/wifi.md lista o mapeamento.
Temporização, toda ela própria deste modelo e toda declarada em docs/wifi.md: uma associação leva entre um e três segundos, decidida a partir do SSID para que uma aula leve o mesmo tempo nas duas vezes; uma senha errada vira WL_CONNECT_FAILED após cinco segundos; uma requisição a uma origem simulada volta 60 ms depois; uma requisição ao próprio servidor do sketch que o sketch nunca responde é fechada pela rede com um 504 após dez segundos.
3.9 Watchdogs dos grupos de temporizador, os resets e o monitor de pilha (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.
O runtime roda o task watchdog do ESP-IDF no watchdog do grupo de timer 0, como o ESP-IDF faz (firmware/src/main.cpp): ticks de 500 µs, estágio 0 uma interrupção no timeout e estágio 1 um reset do sistema no dobro disso, iniciado antes do setup() com 5 s e um panic, observando a tarefa idle do núcleo 0. A interrupção imprime as linhas do ESP-IDF ("E (…) task_wdt: Task watchdog got triggered. …", as tarefas, "Aborting.", a linha de abort e "Rebooting..."), deixa a pista ESP_RST_TASK_WDT do ESP-IDF no registrador de armazenamento do RTC e reinicia a CPU pelo reset por software, então esp_reset_reason() retorna 6 depois. esp_task_wdt_*, enableLoopWDT() e enable/disableCore0WDT() atuam sobre ele. O watchdog do grupo de timer 1 é modelado do mesmo jeito e nada no runtime o arma: o interrupt watchdog não é simulado.
4. Canal do host
host_write coloca bytes no FIFO de recepção da UART0; host_read pega os bytes que saÃram do seu FIFO de transmissão. Isso é o Serial em um sketch e o monitor serial na interface. Os bytes são UTF-8 do ponto de vista da interface e opacos para o modelo.
Um DevKitC-1 tem duas portas USB-C: uma para uma ponte USB-para-UART, que é este canal, e outra para o USB do próprio chip, que não é modelada de forma alguma.
5. Modelo de tempo
Como a seção 5 de docs/esp32c3.md. O núcleo HP roda a 160 MHz, uma instrução por ciclo, então uma instrução é exatamente 6250 ps e uma fatia de 10 us é exatamente 1600 instruções. Dentro de uma fatia a contagem de instruções é o relógio: uma leitura do SYSTIMER, um byte da UART e uma mudança de pino acontecem na instrução que os causou.
probe é 1 enquanto o firmware roda, 0.5 parado em wfi, 0 interrompido (sem programa, mantido em reset ou travado).
poke: 1 segura BOOT (GPIO 9 em nÃvel baixo), 0 solta; 2 segura RST, 3 solta.
6. Tempo de execução do firmware (firmware/c6/)
Um runtime no estilo Arduino derivado do C3: setup() e loop(), pinMode, digitalWrite, digitalRead, analogRead (com analogReadResolution, analogSetAttenuation e analogSetPinAttenuation), analogWrite e o par ledcAttach/ledcWrite, millis, micros, delay, delayMicroseconds, attachInterrupt, Serial. Sem core do Arduino, sem ESP-IDF, sem libc.
analogRead é o ADC1 one-shot nas GPIO 0 a GPIO 6 (seção 3.6), doze bits a 11 dB por padrão, então firmware/lib/mokxi_joystick.h compila e funciona aqui como funciona no C3. analogWrite(pin, 0..255) são oito bits a 1 kHz em qualquer GPIO e anexa um canal LEDC livre na primeira vez que é chamado; ledcAttach(pin, frequency, bits) é o que um sketch quer quando a frequência importa, e canais que pedem a mesma frequência e resolução compartilham um dos quatro temporizadores.
Compilado com clang --target=riscv32-unknown-elf -march=rv32imc -mabi=ilp32, linkado contra firmware/c6/link.ld. Três arquivos do runtime são os do C3, compilados de novo para esta placa em vez de copiados: a formatação de números, os auxiliares de matemática e o floor freestanding, além de Print e main. Próprios desta placa são o cabeçalho de registradores, a contagem de pinos, o código de inicialização, o script do linker e os drivers de GPIO, ADC, PWM, tempo, UART e interrupção.
A string de catálogo program é elf32 riscv32imc esp32c6. Ela difere da do C3 porque o ELF realmente difere: mesmo conjunto de instruções, mapa de memória diferente, e uma imagem linkada para um não roda no outro.
LED_BUILTIN é 8, que nesta placa é o LED RGB endereçável. Colocá-lo em nÃvel alto e baixo ainda faz a coisa útil numa protoboard; o exemplo rainbow é para o que o pino realmente serve.
Seis exemplos: blink, button (o botão BOOT no GPIO 9), serial, fade (um LED no GPIO 10 respirando com PWM por hardware), stick (um KY-023 nos canais 0 e 1 do ADC1, com o brilho de dois LEDs saindo de volta pelo LEDC) e rainbow (uma roda de matiz feita por bit-bang no LED RGB e em mais sete no GPIO 8). Cada exemplo tem um orçamento de 16 KB.
7. O que este modelo sabe com certeza, e o que não sabe
Três grupos. Esta seção existe porque um modelo de placa que adivinha um endereço em silêncio é pior do que um que diz que não sabia.
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.
Deliberadamente ausentes. Cada um destes foi deixado de fora em vez de inventado, porque o layout de seus registradores não é algo que este modelo possa reproduzir com honestidade:
- Os temporizadores dos grupos de temporizadores (TIMG0 e TIMG1). Seus watchdogs são os da seção 3.9. O tempo aqui vem do SYSTIMER, que é suficiente para
millis,microse umdelayestacionado. - O RMT, que é o que normalmente dirigiria o LED RGB. O exemplo
rainbowo faz por bit-bang, e isso não é um atalho: é a única forma aqui. - O núcleo LP e seus periféricos, incluindo LP_UART e LP_I2C. O domÃnio de baixa energia do C6 é metade do que torna o chip interessante, e nada disso está aqui.
- A matriz de interrupções, o roteamento em formato PLIC que decide qual periférico chega a qual
mcause. A seção 3.5 diz o que ocupa o lugar dela. - O ADC2, o DMA e o controlador digital do SAR ADC, seus filtros, monitores de limiar e eFuses de calibração. A seção 3.6 é o ADC1 em modo disparo único e nada mais.
- O hardware de duty-fade do LEDC e sua linha de interrupção: a seção 3.7 são os temporizadores, os canais e a saÃda, e
LEDC_INT_RAW_REGé consultado por polling em vez de entregue. - A PMU e a árvore de clock, o cache, a ROM, a flash, SPI, I2C, I2S, USB Serial/JTAG, WiFi 6, Bluetooth LE e 802.15.4.
É por isso que binários do ESP-IDF do fabricante e do core do Arduino não rodam aqui, e o firmware compilado para este documento roda.