Un arcoíris con NeoPixel WS2812B en un ESP32
Intermedio
- 526componentes en el banco de trabajo
- 46placas funcionando ahora
- 1.00xtiempo real, en todas las placas
Los LED WS2812B, vendidos por Adafruit como NeoPixels, integran un LED rojo, verde y azul y un pequeño controlador en cada píxel, y los encadenan todos en un solo cable de datos. El circuito de arriba tiene dieciséis en GPIO 5 de un ESP32-C3, con una rueda de tonos que recorre la tira. Está funcionando ahora mismo, en un ESP32-C3 simulado que ejecuta el firmware compilado, y la tira está decodificando los pulsos reales de su pin de datos.
Ábrelo en el editor para cambiar el número de LED, la velocidad o el brillo, y ejecútalo de nuevo.
Lo que necesitas
- Una placa ESP32-C3 (aquí la DevKitM-1)
- Una tira, anillo o matriz WS2812B
- Una protoboard y cables jumper
Cableado
| Componente y pin | Va a | Nota |
|---|---|---|
| DIN de la tira | GPIO 5 | La línea de datos hacia el primer LED |
| VDD de la tira | 5 V | En una tira real larga, una fuente de 5 V separada |
| VSS de la tira | GND | Compartida con la placa |
Un solo cable, y sin reloj
There is no clock line. Each bit is a high pulse whose length is the bit: about 0.4 microseconds for a nought and 0.8 for a one. Each LED takes the first 24 bits it receives, green first, then red, then blue, and passes the rest along to the next. When the line has been quiet for 50 microseconds, every LED takes up its new color at once.
La tira simulada decodifica esos pulsos a partir de los propios flancos del pin, con las ventanas de tiempo de la hoja de datos. Un pulso demasiado corto o demasiado largo se rechaza, igual que una tira real deja de seguir un flujo que no puede leer. Por eso un controlador que funciona aquí tiene bien ajustados sus tiempos.
El código de Adafruit_NeoPixel
El sketch del tutorial de Adafruit NeoPixel compila tal cual en las placas Arduino, la familia ESP32, la Pico y la Uno R4. El header es propio de Mokxi, sobre su controlador WS2812, con setPixelColor(), Color(), ColorHSV(), fill(), clear(), setBrightness(), gamma32() y rainbow(). El ejemplo integrado de arcoíris usa el controlador de bajo nivel directamente, con su propia rueda de color entera de 1536 pasos por los bordes del cubo RGB.
#include <Adafruit_NeoPixel.h>
Adafruit_NeoPixel pixels(8, 4, NEO_GRB + NEO_KHZ800);
void setup() {
pixels.begin();
}
void loop() {
pixels.clear();
pixels.setPixelColor(0, pixels.Color(0, 150, 0));
pixels.show();
delay(500);
}Abrir este sketch en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.
Por qué este tutorial usa un ESP32
On a real Arduino Uno, the Adafruit library drives WS2812s with hand-tuned assembly that counts every one of the 16 MHz clock’s cycles. In Mokxi, the WS2812 driver is a counted loop (assembly on the AVR boards, the core’s cycle counter on the ESP32, Pico and Uno R4), so the NeoPixel header builds on all of them and stops with a message on the boards with no driver. An ESP32 has more memory for large panels, which is why this circuit uses one.
Pruébalo en el editor
Open the circuit in the editor and change LEVEL from 40 to 255. The strip gets much brighter. On a real bench each pixel can draw up to sixty milliamps at full white, and the supply has to be sized for that, which is why the example runs at a sixth of full scale.
Then select the strip and change its layout property to ring. The same sixteen LEDs are drawn as a circle, with LED 0 at the top and the rest clockwise, which is how the rings you can buy are numbered. The sketch does not change at all, because electrically a ring is a strip.
Finalmente, cambia SPEED a 1 para un deslizamiento lento del color, o cambia SPREAD para que toda la tira muestre un solo color a la vez.
Errores comunes
Brillo completo en cada LED. Cada pixel puede consumir unos 60 miliamperios en blanco completo, así que una tira de 60 LEDs requiere más de 3 amperios. El ejemplo corre a un sexto de la escala completa. El simulador no modela la corriente de la fuente, así que planea tú mismo la alimentación de un proyecto real.
El orden de colores incorrecto. Las tiras WS2812B esperan primero el verde. Un sketch que envía primero el rojo, con NEO_RGB, intercambia el rojo y el verde, aquí y en el banco de trabajo.
Sin tierra común entre la placa y una tira con alimentación separada. La línea de datos se mide respecto a la tierra de la tira.
Una línea de datos de 3.3 voltios hacia una tira de 5 voltios. Muchas tiras reales la aceptan, pero no todas. Un desplazador de nivel, o un primer pixel alimentado un poco más bajo, lo corrige. La tira simulada lee datos de 3.3 voltios sin quejarse.
Olvidar show(). Asignar un pixel cambia el búfer en memoria; nada llega a la tira hasta que show() lo envía.
Abre este circuito en el editor. ESP32-C3: arcoíris WS2812B, cableado como corre al principio de esta página. Cambia un componente o un valor y ejecútalo de nuevo.
Abrir el circuitoPreguntas
¿Puedo usar un anillo o una matriz de NeoPixels en lugar de una tira?
Sí. Eléctricamente todos son una tira. El componente simulado tiene una propiedad de disposición para tira, anillo y matriz, incluidas las matrices serpenteantes, y la numeración sigue los productos reales.
¿Cuántos NeoPixels puede controlar un pin?
Tantos como te alcancen la memoria y el tiempo: tres bytes cada uno y unos 30 microsegundos por LED para enviarlos. La tira simulada admite hasta 1024 LEDs por componente.
¿Funciona FastLED?
Sí. FastLED.h compila aquí, y también Adafruit_NeoPixel.h, en las placas AVR, la familia ESP32, la Pico y la Uno R4.
Sigue así
Á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.