Parpadear un LED en el ESP32-C3
- 526componentes en el banco de trabajo
- 46placas funcionando ahora
- 1.00xtiempo real, en todas las placas
La placa que esto reproduce es una ESP32-C3-DevKitM-1 real, no un sustituto genérico: un chip RISC-V de un solo núcleo a 160 MHz, con su propia numeración de GPIO que no coincide para nada con la serigrafía de pines de un Arduino. Aquí no hay ningún pin marcado como "13"; el LED integrado está en el GPIO 8, así que LED_BUILTIN en esta placa significa 8, y ese es también el pin al que el circuito de arriba conecta un LED y una resistencia externos.
Presiona Ejecutar y tanto el LED de la propia placa como el LED de la protoboard parpadearán juntos, una vez por segundo, con un firmware que de verdad se compila para este chip y de verdad corre en su núcleo RISC-V simulado en lugar de una animación de relleno.
Qué placa reproduce esto
Di la placa exacta, porque existe más de una placa ESP32-C3 y no son intercambiables: esta es la DevKitM-1, la placa de desarrollo oficial de Espressif, no las placas "SuperMini" de terceros más pequeñas que comparten el mismo chip pero con un pinout y una distribución distintos. Si tienes una SuperMini, el GPIO 8 sigue siendo el pin correcto que debes buscar en el código, pero no esperes que las posiciones físicas de los pines en este diagrama coincidan con la serigrafía de una placa diferente.
El chip debajo de ambas placas es el mismo ESP32-C3: un núcleo RISC-V único, GPIO, un UART y un SYSTIMER sobre un mapa de memoria real y documentado. El firmware para los periféricos que este simulador reproduce puede pasarse a una DevKitM-1 física, donde aún necesita pruebas. Lo que difiere entre placas que comparten el mismo chip es qué pines se llevan a un header y en qué orden.
Conectar el LED a 3.3 volts, no a 5
Este es el único número que de verdad cambia entre un Arduino Uno y un ESP32-C3: los pines GPIO del C3 entregan 3.3 volts, no 5. Haz la misma operación con la resistencia usando esa alimentación, (3.3 V menos aproximadamente 2 V) dividido entre 220 ohms, y la corriente sale más cercana a los 6 miliamperes, frente a los aproximadamente 13.6 mA del Uno con el mismo valor de resistencia. El mismo LED se verá visiblemente más tenue aquí, y vale la pena bajar un poco la resistencia, a algo como 150 ohms, para recuperar un brillo similar en lugar de asumir que los valores del Uno se trasladan sin cambios.
Qué es diferente bajo las mismas tres llamadas
digitalWrite(), pinMode() y delay() se leen igual en cada placa que Mokxi reproduce, y eso es deliberado: el núcleo de Arduino esconde el chip que está debajo. Lo que cambia aquí es todo lo que está por debajo de esa línea. El C3 es un solo núcleo RISC-V de 32 bits a 160 MHz frente al núcleo AVR de 8 bits del Uno a 16 MHz, y delay() aquí se cronometra desde el SYSTIMER, un periférico que el ATmega328P no tiene, en lugar de un temporizador de propósito general adaptado para ello. Nada de eso cambia lo que hace el sketch de arriba; cambia cuánto margen queda para todo lo demás que un proyecto basado en C3 suele querer hacer al mismo tiempo, como leer un sensor por I2C o manejar una pantalla pequeña, lo cual es gran parte de la razón por la que este chip es una elección común cuando a un proyecto le queda pequeño un solo LED parpadeante.
El código
El sketch tiene la misma forma que el del Uno, porque digitalWrite(), pinMode() y delay() son las mismas llamadas al estilo Arduino en cada placa que Mokxi reproduce; solo cambian el número de pin y el comentario que lo describe.
void setup() {
pinMode(LED_BUILTIN, OUTPUT);
}
void loop() {
digitalWrite(LED_BUILTIN, HIGH);
delay(500);
digitalWrite(LED_BUILTIN, LOW);
delay(500);
}Abrir este sketch en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.
Errores comunes
Los dos errores específicos de esta placa, además de los errores del LED al revés y de la resistencia faltante que aplican en todas partes: leer el número de la serigrafía como si fuera el número de GPIO, cosa que normalmente no es en una placa de desarrollo con sus pines sacados a un header impreso con los nombres propios del chip; y asumir que cualquier GPIO está libre para cualquier cosa. Unos cuantos pines del C3 son pines de strapping, muestreados una vez al arrancar para elegir cosas como el modo de arranque, y ponerlos en bajo con un componente externo al encender puede impedir que la placa arranque como esperas. El GPIO 8 no tiene ese papel, lo cual es una razón más para que sea el pin que usan tanto el LED integrado como este ejemplo.
Un tercer error que vale la pena nombrar porque es fácil cometerlo una vez y nunca más: asumir que analogWrite() se comporta aquí exactamente igual que en un Uno. Hace el mismo trabajo en ambos, pero no de la misma manera: la llamada en un Uno llega a uno de seis pines a los que está conectada la salida de comparación de un temporizador, y la del C3 llega a cualquier pin, porque los canales del LEDC se enrutan a través de la matriz de GPIO en lugar de estar soldados a una patilla. La página sobre el fundido por PWM cubre lo que en realidad cambia entre las dos placas, y vale la pena leerla antes de asumir que un sketch de fundido se portará sin cambios.
Y un cuarto, fácil de pasar por alto porque aquí equivocarse no cuesta nada: olvidar que el GPIO 8 también es el pin al que ya está conectado el LED de la placa. Conectar un LED externo al mismo pin está bien, y es exactamente lo que hace el circuito de arriba, pero significa que el LED de la placa y el LED de la protoboard mostrarán siempre el mismo estado; conectar un segundo LED independiente necesita un segundo GPIO sin usar.
Alimentar la placa y el LED juntos
La DevKitM-1 se alimenta por su propio conector USB en este simulador, igual que la placa real, así que nada del circuito del LED necesita alimentar al chip. Lo que consumen el LED y la resistencia proviene del pin GPIO, a 3.3 V, no de una línea separada, y el cálculo de corriente de arriba ya lo tiene en cuenta. En la placa real esto importa un poco más que aquí: un pin GPIO tiene una corriente máxima real de salida, y una resistencia demasiado pequeña es la diferencia entre un LED con corriente limitada de forma segura y un pin al que se le pide más de lo que soporta.
Abre este circuito en el editor. ESP32-C3: parpadeo, cableado tal como se ejecuta en la parte superior de esta página. Cambia un componente o un valor y ejecútalo de nuevo.
Preguntas
¿Es este el mismo programa que el ejemplo de parpadeo del Arduino Uno?
La misma forma y las mismas tres llamadas, pero una compilación aparte: el ELF de aquí apunta a un núcleo RISC-V sobre el mapa de memoria real del ESP32-C3, no al ATmega328P al que apuntan los ejemplos del Uno, y el GPIO 8 reemplaza al pin 13.
¿Funciona el WiFi en este simulador?
El WiFi funciona sobre una red simulada con las llamadas WiFi de Arduino. No hay radio ni 802.11, y con la sesión iniciada puedes activar internet real. El Bluetooth se simula igual, con un celular en el panel de Bluetooth del editor.
¿En qué pines puedo parpadear un LED con seguridad?
La mayoría de los pines GPIO disponibles funcionan bien para un LED con un digitalWrite simple; la página de la placa indica cuáles son pines de strapping que conviene evitar para cualquier cosa que se active al encender.
¿El simulador del ESP32-C3 es gratis?
Sí, sin necesidad de cuenta para abrirlo y probarlo, igual que todas las placas que Mokxi reproduce.
¿Un firmware compilado aquí puede correr en una ESP32-C3-DevKitM-1 real?
Para los periféricos que este simulador reproduce, un ELF compilado aquí apunta a los offsets de registro reales para código de GPIO, UART y temporizadores como este ejemplo. Pruébalo en la placa física antes de depender de él.
¿Necesito saber ensamblador RISC-V para usar esta placa?
No. Todos los ejemplos de aquí están escritos en el mismo C++ estilo Arduino que los ejemplos del Uno; el núcleo RISC-V que está debajo es lo que realmente ejecuta el programa compilado, pero nada de escribir un sketch para esta placa requiere saber eso.
Ármalo en la vida real
Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.