Referência

Contrato da placa ESP32-C6 (Fase 9)

A DevKitC-1: trinta e um GPIOs, uma janela de SRAM e um relato direto do que não é modelado.

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 poke não o alcança e o componente da placa não o decodifica: um WS2812 é um protocolo, não um nível. Ligue o componente ws2812 ao GPIO 8 e ele acende com as cores que o sketch está enviando, que é o que o exemplo rainbow faz.
  • 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 poke o 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 (o UART_CONF0_SYNC_REG do manual, registrador 27.9): o bit 22 RXFIFO_RST e o bit 23 TXFIFO_RST esvaziam 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 _SYNC só tem efeito quando UART_REG_UPDATE (0x98) é definido; o modelo aplica de imediato.
  • UART_CONF1_REG (registrador 27.10): bits 0..7 RXFIFO_FULL_THRHD e bits 8..15 TXFIFO_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..7 RXFIFO_CNT e bits 16..23 TXFIFO_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, micros e um delay estacionado.
  • O RMT, que é o que normalmente dirigiria o LED RGB. O exemplo rainbow o 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.