Placas

El ESP32-C3

Un núcleo RISC-V a 160 MHz en el mapa de memoria real, sin radio y con una red simulada en su lugar.

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

Qué es

La ESP32-C3-DevKitM-1: un chip RISC-V de 32 bits que corre sobre nuestro propio núcleo RV32IMC, el cual pasa la suite de riscv-tests en el navegador. El modelo usa el mapa de memoria real de la ESP32-C3 y los desplazamientos reales de registros para todo lo que implementa, así que el firmware compilado aquí funciona en una DevKitM-1 real.

La CPU corre en porciones de 10 microsegundos a 160 MHz, una instrucción por ciclo, y un cambio de pin dentro de una porción se coloca en la instrucción exacta que lo causó.

Los pines

Dos headers de 15 pines, en el orden que tiene la placa real.

Header izquierdo, de arriba abajo: GND, 3V3, 3V3b, 2, 3, RST, GNDb, 0, 1, 10, 4, 5, 6, 7, 8.

Header derecho: 5V, 5Vb, GNDc, GNDd, 9, 18, 19, 20, 21, luego seis pines marcados NC, que se dibujan para que el header esté completo y nunca se leen.

Los GPIO 0 a 10, 18, 19, 20 y 21 son utilizables. Esta es una placa de 3.3 voltios: una salida entrega 3.3 V o 0 V, el umbral de entrada es 1.65 V, y la pull-up y la pull-down internas son ambas de unos 45 k.

RST tiene una pull-up de 10 k; llevarlo por debajo de 1.65 V mantiene el chip en reset.

El GPIO 8 lleva el LED de la placa, por eso LED_BUILTIN es 8. Aquí se dibuja como un LED común. En una ESP32-C3-DevKitM-1 real es un LED RGB direccionable (un componente tipo WS2812 con su propio controlador), que ignora un pin que solo esté en alto o en bajo: el Blink cargado desde Mokxi no enciende nada en la placa real. El núcleo de Arduino de Espressif lo resuelve dándole a LED_BUILTIN un número propio y convirtiendo digitalWrite() sobre él en un color enviado al LED, así el Blink del Arduino IDE sí lo enciende, blanco tenue. Para ver un parpadeo de la compilación de Mokxi en la placa real, conecta un LED y una resistencia a otro pin.

Los pines analógicos

Los GPIO 0 a GPIO 4 son los canales 0 a 4 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. La opción predeterminada es 11 dB, aproximadamente todo el riel de 3.3 V, así que un potenciómetro o un joystick cruzando la alimentación cubre 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.

One read costs about five microseconds of simulated time, which is what the converter takes. A pin with nothing on it reads 0 rather than noise. Any other pin reads 0 too: there are five analog inputs and no more.

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 desvaneciéndose juntos cuestan uno de los cuatro; pide una quinta pareja distinta y ledcAttach devuelve false en lugar de reajustar un temporizador que otro pin esté usando. pinMode() y digitalWrite() le quitan el pin a LEDC.

Un ciclo útil de 0 es un bajo fijo y uno de 255 un alto fijo, salidos del hardware, sin ningún flanco, lo que también significa que el simulador no tiene nada que despertar a la placa, y una placa desvaneciendo un LED mientras está detenida en wfi le cuesta dos despertares por milisegundo y nada más.

Serie

En la placa real, los pines 20 y 21 son UART0 y los pines 18 y 19 son USB. Aquí son GPIO comunes, y los bytes de UART0 van al monitor serie. Consulta ejecutar y el monitor serie.

What is modeled

GPIO, IO_MUX, UART0, el SYSTIMER, la ruta de disparo único del ADC1 y el grupo de baja velocidad de LEDC, en sus direcciones reales con sus bits reales, más la interrupción externa de máquina para GPIO y UART.

delay() deja el núcleo detenido en una alarma del SYSTIMER en lugar de girar en un bucle, así que un sketch inactivo le cuesta al simulador unos cientos de instrucciones por segundo simulado en lugar de ciento sesenta millones.

Algunas direcciones de registros no están verificadas

Dos de los bloques de arriba llevan direcciones que este modelo no puede respaldar. Las direcciones base y los desplazamientos de GPIO, IO_MUX, UART0 y SYSTIMER son los del manual de referencia técnica. Dentro del SAR ADC, cada desplazamiento de registro de una sola toma excepto los dos primeros es lo que este modelo eligió y no una fila citada de una página del manual; lo mismo aplica a los cuatro registros de interrupción de LEDC, sus registros globales de configuración y de fecha, y los seis números de señal de la matriz GPIO por los que los canales de LEDC llegan a un pad. El firmware compilado aquí concuerda con el modelo tanto si concuerda con el silicio como si no, y una imagen que se vaya a llevar a una DevKitM-1 real debería revisar primero esa lista corta de #defines en firmware/include/esp32c3.h. La sección 7 de el modelo de la ESP32-C3 clasifica cada dirección en tomada del manual, creída pero no verificada, y ausente.

WiFi, simulated

No hay radio. Nunca lo habrá: una MAC 802.11 no es algo que este modelo pudiera reproducir con honestidad. El Bluetooth LE se simula igual que la red, con un celular en el panel de Bluetooth del editor (Bluetooth, simulado).

Lo que hay en su lugar es una red simulada. Un bloque propio de Mokxi y no del chip (un buzón en 0x6FFF_E000, donde una C3 real no tiene nada mapeado) soporta WiFi.h, HTTPClient.h y WebServer.h, así que el código de Arduino que da un tutorial corre 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 lapso de uno a tres segundos, 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.

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

Watchdog y pila

As on the board, ESP-IDF's task watchdog runs from before setup() with a 5 s timeout: a sketch that neither calls delay() nor returns from loop() for that long prints the "Task watchdog got triggered" lines and reboots, and esp_reset_reason() says ESP_RST_TASK_WDT (6) afterwards. disableCore0WDT() turns that off, and esp_task_wdt_add(NULL) watches the sketch's own resets. A stack that runs out (recursion that never ends) stops with a "stack overflow" crash line at the top of the heap, before it writes over the program.

Lo que no está

Faltan: SPI e I2C como periféricos, los temporizadores de los grupos de temporizadores (sus watchdogs sí están, para el watchdog de tareas), RMT, USB Serial/JTAG, la matriz de interrupciones completa y todo lo que viene de ESP-IDF. Del ADC SAR solo se modela la ruta de una sola toma de ADC1, no ADC2 (que la radio comparte en el silicio real), la tabla de patrones DMA, el controlador digital, los filtros y monitores de umbral, ni la curva de calibración de las eFuses, así que una lectura aquí es la línea recta nominal y no la ligera curva de una pieza real, sin ruido y sin ninguna no linealidad. La bandera de terminación del ADC se puede consultar por sondeo pero no llega al controlador de interrupciones. Los binarios del fabricante quedan fuera del alcance; lo que corre es firmware compilado contra nuestro propio entorno de ejecución, que es lo que el editor compila para ti.

Una instrucción es un ciclo a 160 MHz, sin caché, sin esperas de flash ni bloqueos del pipeline, así que un programa aquí corre de manera más pareja que en silicio. Los pines 3V3 y 5V son fuentes ideales que no pueden caer, así que nada en Mokxi sufre nunca un apagón por baja tensión.

Registro por registro, el modelo del ESP32-C3 lo tiene todo.

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 GPIO 8 (SDA) y GPIO 9 (SCL), la elección del núcleo de Arduino para esta placa; Wire.begin(sda, scl) lo mueve.
  • 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.

Los ejemplos

Blink, Button, Serial, Fade, PWM fade, Servo sweep, Counter, Interrupt, WiFi: join the network, WiFi: fetch the weather, WiFi: a lamp on a web page, Thumb stick, Rainbow strip, Plasma panel, OLED text and shapes, OLED dice, OLED pong, Pong console, Binary clock, Electronic dice, Knight Rider, Morse sender, Simon, Stacker y Talker.

PWM fade y Servo sweep son los dos que usan LEDC. El primero es el mismo LED que respira de Fade, hecho por el hardware y no a mano, que es la diferencia entre un núcleo despierto durante cada microsegundo de la forma de onda y uno que duerme entre pasos; el segundo mueve un SG90 con un canal de 50 Hz, donde lo que el servo lee es el ancho del pulso y no el ciclo útil.

Thumb stick y OLED pong son los dos que leen el ADC. La demo del stick imprime ambos ejes y enciende el LED del lado hacia el que empujas, con más o menos brillo según qué tan lejos; OLED pong es el juego del stick del Uno en esta placa, con la paleta siguiendo el potenciómetro Y del stick en GPIO 0 y el marcador en la fuente de 5x7 para la que el Uno no tiene espacio.

Las demos de la tira y del panel se escribieron para esta placa. El mismo controlador WS2812 también corre en las placas AVR, el resto de la familia ESP32, la Pico y la Uno R4.

Stacker es el que está en la página de inicio. Dos matrices 8x8 MAX7219 puestas una sobre otra forman un campo de juego de ocho píxeles de ancho por dieciséis de alto, y un botón de arcade de 30 mm en GPIO 3 suelta el bloque que se desliza. Están conectadas en cadena como el chip está pensado: los datos en GPIO 7 llegan solo al módulo de arriba, su DOUT alimenta el DIN del módulo de abajo, y el reloj en GPIO 5 y el único chip select en GPIO 6 van a ambos. El sketch envía dos paquetes entre un par de flancos de CS, el del módulo de abajo primero, porque el paquete que se envía primero se empuja más lejos por la cadena. Las matrices se alimentan del pin 5V de la placa y no del 3V3, porque un MAX7219 quiere cuatro voltios o más. Si nadie presiona el botón durante cuatro segundos, el sketch juega solo, y una presión te devuelve al juego.

MicroPython

Elige MicroPython (main.py) en el panel Firmware de la placa y Ejecutar arranca el firmware oficial de MicroPython v1.29.0 para el ESP32-C3 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.

En otras partes