Aprender

Un arcoíris con NeoPixel WS2812B en un ESP32

Intermedio

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
ESP32-C3: arcoíris WS2812Ben vivo0.000 s 0.00x
Haz clic para abrirlo en el editor
The rainbow example: sixteen WS2812Bs on GPIO 5, bit-banged to the datasheet’s pulse widths.

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 pinVa aNota
DIN de la tiraGPIO 5La línea de datos hacia el primer LED
VDD de la tira5 VEn una tira real larga, una fuente de 5 V separada
VSS de la tiraGNDCompartida 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.

Un primer sketch de NeoPixel
#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 circuito

Preguntas

¿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.

Á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.