Placas

El ESP32-C6-DevKitC-1

Una segunda placa RISC-V: el mismo núcleo que la ESP32-C3 a 160 MHz, con treinta y un GPIO, medio megabyte de SRAM y un LED RGB direccionable en el GPIO 8.

La descripción general, con ejemplos en ejecución, está en la página de la placa y El modelo de la ESP32-C6 (todos los registros).

Qué es

Un módulo ESP32-C6-WROOM-1 en una placa de 52.5 por 25.4 mm, con dos headers de quince pines separados 0.9 pulgadas, de modo que abarca el canal central de una protoboard dejando una fila libre a cada lado. La página de referencia es El modelo de ESP32-C6.

Los headers siguen el orden de la guía de usuario de Espressif para la placa, con la antena arriba. J1 hacia abajo por la izquierda: 3V3, RST, 4, 5, 6, 7, 0, 1, 8, 10, 11, 2, 3, 5V, G. J3 hacia abajo por la derecha: G, TX, RX, 15, 23, 22, 21, 20, 19, 18, 9, G, 13, 12, G. TX y RX son los GPIO 16 y 17. Cada header tiene un decimosexto agujero, no conectado, que Mokxi no dibuja. No hay ningún GPIO 14 en ninguno de los dos headers. En un diagrama las tierras son GND, GNDb, GNDd y GNDc, de arriba abajo, porque cada nombre de pin es único.

Un proyecto guardado antes de que Mokxi dibujara el orden real (finales de octubre de 2026) tiene la J3 en otro orden (GPIO 9, 12, 13 y un GPIO 14 cerca de arriba) e intercambiados 5V y GND al final de la J1. Se abre así, con su opción header en early, de modo que una placa en una protoboard conserva cada pin en el agujero en el que estaba. Cambia header a board para el orden real: los cables hacia los pines los siguen, se deja fuera un cable hacia 14 porque la placa real no tiene ese pin, y una placa colocada en una protoboard entonces alcanza agujeros distintos.

El núcleo de alto rendimiento es el que ejecuta Mokxi: RV32IMC a 160 MHz, una instrucción por ciclo, el mismo hart que la C3.

En qué se diferencia de la C3

En cuatro cosas, y ninguna de ellas es el conjunto de instrucciones.

  • Treinta y un GPIO en lugar de veintidós, numerados del 0 al 30. Los GPIO 24 y superiores son para la flash SPI y no están en ningún header.
  • 512 KB de SRAM en una sola ventana. En una C3 la misma RAM aparece dos veces, una por cada bus; aquí ambos buses la alcanzan en las mismas direcciones, por eso el script del enlazador es más simple y .data no necesita copia al reiniciar.
  • Un LED RGB direccionable en el GPIO 8, donde una C3-DevKitM-1 también tiene uno, pero la mayoría de los sketches manejan un LED común.
  • Dos puertos USB-C. Uno va a un puente USB a UART, con el que se comunica el monitor serie; el otro va al USB propio del chip, que Mokxi no modela.

Un ELF compilado para una C3 no funcionará aquí y el editor no te ofrecerá uno: mismo conjunto de instrucciones, distinto mapa de memoria.

The RGB LED

El GPIO 8 es el WS2812 propio de la placa. Quiere veinticuatro bits, no un nivel, así que el componente de la placa no lo decodifica: un WS2812 es un protocolo. Conecta el componente WS2812 al GPIO 8 y los colores son reales.

El programa integrado Rainbow hace exactamente eso, generando los anchos de pulso con bit-banging desde un bucle contado. Aquí eso no es un atajo: el periférico RMT que normalmente lo manejaría no está modelado.

Los pines analógicos

Los GPIO 0 al GPIO 6 son los canales 0 a 6 del ADC1, y analogRead() en uno de ellos es una conversión real del voltaje en el pin: doce bits, de 0 a 4095, contra una escala completa que elige la atenuación. El valor predeterminado es 11 dB, prácticamente todo el riel de 3.3 V, así que un potenciómetro o un joystick alimentado de la fuente recorre todo el rango; analogSetPinAttenuation() acepta ADC_0db (1.1 V), ADC_2_5db (1.5 V), ADC_6db (2.2 V) o ADC_11db, y analogReadResolution() desplaza el resultado si quieres recuperar los diez bits de un Uno.

Una lectura cuesta unos cinco microsegundos de tiempo simulado, que es lo que tarda el convertidor. Un pin sin nada conectado lee 0 en lugar de ruido. Siete entradas analógicas y no más: cualquier otro pin también lee 0.

PWM

analogWrite(pin, 0..255) funciona en cualquier GPIO. La salida viene de LEDC, el controlador PWM de LED del chip, y llega al pin a través de la matriz GPIO, así que no hay un conjunto fijo de pines ~ como sí hay en un Uno.

El valor predeterminado es de ocho bits a 1 kHz. Cuando la frecuencia importa (un servo quiere cincuenta cuadros por segundo y un ancho de pulso, no un ciclo útil), usa la sintaxis de ESP32:

ledcAttach(4, 50, 14);        // fifty frames a second, 16384 counts each
ledcWrite(4, 1229);           // 1.5 ms of a 20 ms frame: the middle

Hay seis canales y cuatro temporizadores. Los canales que piden la misma frecuencia y resolución comparten un temporizador, así que seis pines con desvanecimiento juntos consumen uno de los cuatro; si pides un quinto par distinto, ledcAttach devuelve false en lugar de reajustar un temporizador que otro pin ya esté usando. pinMode() y digitalWrite() le quitan un pin a LEDC, así que un pin que estaba con desvanecimiento y luego recibe una escritura realmente recibe esa escritura.

Un ciclo útil de 0 es un nivel bajo sólido y un ciclo útil de 255 un nivel alto sólido, saliendo del hardware, sin ningún flanco, lo que también significa que el simulador no tiene nada por lo que despertar a la placa.

WiFi, simulated

No hay radio. Nunca lo habrá: una MAC 802.11 no es algo que este modelo pudiera reproducir con honestidad.

Lo que hay en su lugar es una red simulada. Un bloque que es propio de Mokxi y no del chip (un buzón en 0x6FFF_E000, donde un C6 real no tiene nada mapeado) da soporte a WiFi.h, HTTPClient.h y WebServer.h, así que el código Arduino de un tutorial funciona aquí: la placa se une a un punto de acceso cuyo nombre y contraseña son propiedades de la placa, WiFi.status() recorre los mismos estados en el mismo rango de uno a tres segundos, el DHCP le asigna 192.168.4.2, y un sketch puede descargar una página o servir una.

Lo que hay detrás es software, y no se oculta nada de eso. No hay 802.11, ni canal, ni escaneo, ni WPA2, ni TCP, ni TLS y no hay internet real: cuatro nombres inventados bajo .mokxi se resuelven y ningún otro, y nada de lo que haga un sketch puede llegar a la red donde está tu navegador. WiFiClientSecure compila y luego falla, diciendo que TLS no está simulado. Los paneles Web y Cloud en la parte de abajo del editor se abren con esa frase y no la hacen desaparecer al hacer scroll.

La única excepción es Internet real, un interruptor en el panel Cloud para cualquiera con sesión iniciada (más con Pro) que está apagado cada vez que se carga una página. Con él encendido, una petición por un nombre fuera de .mokxi, https:// incluido, sale por la pasarela de Mokxi y la respuesta vuelve al sketch. Ver Internet real.

Tres ejemplos vienen con esta placa: WiFi: conectarse a la red, WiFi: consultar el clima y WiFi: una lámpara en una página web.

WiFi, simulado explica cómo usarlo; WiFi simulado es el contrato, límite por límite.

Lo que este modelo no tiene

Más de lo habitual, y el contrato lo dice en lugar de inventar desplazamientos de registros que no pueda respaldar.

  • Sin radio. Sin 802.11, sin radio Bluetooth LE, sin Thread ni Zigbee. El WiFi que está encima está simulado y lo dice, y el Bluetooth LE también, con un celular en el panel de Bluetooth del editor (Bluetooth, simulado).
  • Sin núcleo de bajo consumo. El dominio LP del C6 es la mitad de lo que hace interesante al chip y nada de eso está aquí.
  • Sin RMT, que es lo que normalmente manejaría el LED RGB, y nada del SAR ADC más allá de la ruta de una sola conversión de ADC1, ni de LEDC más allá de sus temporizadores y canales.
  • Cinco de las direcciones base del modelo (GPIO, IO_MUX, SYSTIMER, LEDC y el SAR ADC) son su mejor aproximación y no algo que pueda respaldar, y también lo son los números de señal de la matriz GPIO que usan los canales de LEDC. Están nombrados en un header, así que una imagen que se lleve a silicio real tiene una lista corta de #defines que revisar. La sección 7 de la página de referencia es la lista, y las secciones 3.6 y 3.7 marcan los dos bloques más nuevos registro por registro.

The firmware

Nueve programas integrados: Blink, Button (el botón BOOT en el GPIO 9), Serial, Fade, WiFi: conectar a la red, WiFi: obtener el clima, WiFi: una lámpara en una página web, Thumb stick y Rainbow.

Fade hace respirar un LED en el GPIO 10 con analogWrite, así que la forma de onda sale del hardware y el núcleo duerme entre pasos. Thumb stick lee un KY-023 en los canales 0 y 1 del ADC1, imprime ambos ejes y enciende el LED del lado hacia el que empujas, con el brillo con el que empujas: un sketch que usa los dos periféricos que crecieron con esta placa.

Serial es el UART0 y va al monitor serie. delay() deja el núcleo en una alarma de SYSTIMER en lugar de girar en un bucle, así que un sketch inactivo casi no le cuesta nada al simulador.

Bibliotecas estándar de Arduino

Un tutorial que incluya Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h con Adafruit_SSD1306.h, Adafruit_NeoPixel.h, ESP32Servo.h y DHT.h compila aquí tal cual. Cada uno es un header propio de Mokxi con el nombre original, escrito sobre los controladores de los componentes de la caja, y nada de eso es el código de la biblioteca original.

  • Wire.begin() pone el bus I2C en el GPIO 23 (SDA) y el GPIO 22 (SCL); Wire.begin(sda, scl) lo cambia de lugar.
  • EEPROM.h funciona, pero el modelo de esta placa no tiene EEPROM ni flash escribible, así que los bytes viven en 4 KB de RAM: se leen dentro de una ejecución y desaparecen al reiniciar.

El editor de código y la compilación enumera lo que cubre cada una y en qué difiere de la biblioteca original.

MicroPython

Elige MicroPython (main.py) en el panel de Firmware de la placa y Ejecutar arranca el firmware oficial de MicroPython v1.29.0 para el ESP32-C6 con tu main.py, sobre un modelo del chip completo arrancado desde la propia ROM de Espressif. machine.Pin, PWM, ADC, I2C, SPI, UART(1) y neopixel funciona, y network.WLAN se une a la red simulada. Consulta MicroPython en el ESP32.

¿Qué placa es esta?

La ESP32-C6-DevKitC-1. No la C6-DevKitM-1, no un módulo suelto en una placa propia, y no las variantes C6 Mini. Los números de GPIO son los del chip y serían los mismos, pero el orden del header no.