Arduino NeoPixels: un arcoíris WS2812B en un Uno
Principiante
- 526componentes en el banco de trabajo
- 46placas funcionando ahora
- 1.00xtiempo real, en todas las placas
Una tira de NeoPixels es una fila de LEDs RGB diminutos que cada uno tiene su propio chip. Envías los colores por un solo cable de datos y cada LED conserva su color hasta que envías otros nuevos. Adafruit los vende como NeoPixels; el chip que traen dentro es el WS2812B, y las tiras, anillos y matrices baratas usan el mismo.
El circuito de arriba es un Arduino Uno manejando dos tiras: un arco de veinte LEDs en el pin 6 y una maceta de cuatro LEDs dorados en el pin 5. Un arcoíris fluye por el arco, y la perilla en A0 controla la velocidad. Funciona en tu navegador con el sketch de abajo, y cada tira decodifica los pulsos reales de su pin de datos, así que un error de cableado se queda oscuro aquí igual que en tu mesa.
Lo que necesitas
- Un Arduino Uno
- Una tira WS2812B (aquí de veinte LEDs) y una corta de cuatro
- Dos resistencias de 330 ohms, una para cada línea de datos
- Un potenciómetro de 10k para la velocidad
- Una protoboard mediana y cables dupont
Cableado
| Componente y pin | Va a | Nota |
|---|---|---|
| DIN de la tira del arco | Pin 6 | A través de una resistencia de 330 ohms |
| DIN de la tira dorada | Pin 5 | A través de su propia resistencia de 330 ohms |
| VDD (5V) de ambas tiras | Riel de 5 V | Usa una fuente de 5 V aparte para una tira larga |
| VSS (GND) de ambas tiras | Riel de GND | La tierra debe ser compartida con el Uno |
| Pin central del potenciómetro | A0 | La perilla de velocidad |
| Pines exteriores del potenciómetro | 5 V y GND | En cualquier orientación |
Un solo cable, y el tiempo de los pulsos es el dato
There is no clock wire. Each bit is one high pulse, and the length of the pulse is the bit: about 0.4 microseconds for a 0 and 0.8 for a 1. Every LED takes 24 bits, eight each for green, red and blue, keeps the first 24 for itself and passes the rest down the strip. When the line goes quiet for 50 microseconds, every LED shows its new color at once.
Esos pulsos son demasiado cortos para generarlos con digitalWrite(). La biblioteca Adafruit_NeoPixel calcula los tiempos por ti, así que tu sketch solo trabaja con colores. En el Uno los bits se cuentan en ensamblador, un ciclo de reloj a la vez.
El sketch, paso a paso
Cada tira es un objeto: cuántos LEDs, qué pin y el orden de los colores. NEO_GRB + NEO_KHZ800 sirve para casi todos los WS2812B. begin() configura el pin, y setBrightness() reduce la intensidad de todos los colores, lo que ahorra energía y cuida tus ojos.
En loop(), el sketch lee la perilla y la convierte en una velocidad de 32 a 1024. La suma a un tono inicial, y luego le da a cada LED un tono un poco más adelante en la rueda de color. ColorHSV() recibe un tono de 0 a 65535 y devuelve un color, y gamma32() lo corrige para que los degradados se vean uniformes a tu vista. Nada cambia en la tira hasta que show() envía todo el cuadro.
El bucle espera 20 milisegundos, así que el arcoíris se mueve unas cincuenta veces por segundo. Cada 200 cuadros imprime la velocidad. Con la perilla a la mitad, la primera línea dice "Rainbow speed 528". Bájala al mínimo y dice 32.
void loop() {
int speed = map(analogRead(A0), 0, 1023, 32, 1024);
start += speed;
for (int i = 0; i < ARCH; i++) {
uint16_t hue = start + (uint32_t)i * 65536 / ARCH;
arch.setPixelColor(i, arch.gamma32(arch.ColorHSV(hue)));
}
for (int i = 0; i < POT; i++) {
int glint = random(0, 10) == 0 ? 255 : random(140, 200);
gold.setPixelColor(i, glint, glint * 3 / 5, 0);
}
arch.show();
gold.show();
frames++;
if (frames % 200 == 1) {
Serial.print("Rainbow speed ");
Serial.println(speed);
}
delay(20);
}Alimentación: lo que el simulador no puede advertirte
Cada WS2812B puede consumir unos 60 miliamperes en blanco completo. Veinte de ellos superan un amper, más de lo que el pin de 5 V del Uno debería entregar. Para más de un puñado de LEDs, alimenta la tira con su propia fuente de 5 V, une su tierra con la del Uno y mantén baja la intensidad. Un capacitor de 1000 microfaradios entre los cables de alimentación de la tira, como recomienda Adafruit, protege al primer LED cuando conectas.
Mokxi no modela la corriente que consume cada LED, así que una tira larga aquí nunca baja el voltaje de la placa. Esa es una limitación real de la simulación, y por eso existe esta sección.
Pruébalo en el editor
Haz que el arcoíris corra en el otro sentido cambiando start += speed por start -= speed. Cambia ARCH a 60 y la propiedad count de la tira a 60 para un arco más largo. Dale a la maceta un brillo verde intercambiando los números en su llamada a setPixelColor().
Luego borra el cable de tierra del arco y presiona Ejecutar. El arco se queda oscuro, porque los pulsos de datos no tienen por dónde regresar. Vuelve a ponerlo y el arcoíris regresa.
Errores comunes
Sin tierra compartida. Una tira con su propia fuente sigue necesitando que su GND esté unido al GND del Uno, o la línea de datos no significa nada para ella.
Olvidar show(). setPixelColor() solo cambia una lista en memoria. La tira no cambia hasta que show() la envía.
El orden de colores equivocado. Un WS2812B necesita NEO_GRB. Si usas NEO_RGB, el rojo y el verde salen intercambiados, aquí igual que en una tira real.
Cablear el extremo equivocado. Los datos entran por DIN. La flecha impresa en la tira apunta alejándose de la entrada, hacia DOUT.
Alimentar una tira larga desde el pin de 5 V del Uno con la intensidad al máximo. Consulta la sección de alimentación de arriba.
Abre este circuito en el editor. Arduino Uno: un arcoíris de NeoPixels, cableado tal como funciona en la parte superior de esta página. Cambia un componente o un valor y vuelve a ejecutarlo.
Abrir el circuitoPreguntas
¿Qué pin debo usar para NeoPixels en un Arduino Uno?
Cualquier pin digital sirve. La biblioteca calcula los tiempos de los pulsos, así que el pin no necesita PWM. Este ejemplo usa los pines 6 y 5, cada uno a través de una resistencia de 330 ohms.
¿Puedo usar FastLED en lugar de Adafruit_NeoPixel?
Sí. Ambas bibliotecas compilan en Mokxi, en las placas AVR, la familia ESP32, la Pico y la Uno R4. En una placa sin controlador WS2812 aquí, como las placas STM32, el header te lo avisa cuando compilas.
¿Cuántos NeoPixels puede manejar un Uno?
La biblioteca reserva tres bytes de memoria por cada LED, y el Uno tiene 2 KB de RAM, así que en la práctica el máximo son unos cientos antes de que a tu sketch le falte espacio. La alimentación suele ser el límite real primero. En Mokxi todas las tiras de un sketch comparten un fondo fijo de 1024 LEDs.
¿Esto también funciona en un ESP32?
Sí, con el mismo código. El tutorial de NeoPixel para ESP32 corre un arcoíris en un ESP32-C3 y explica cómo esa placa calcula los tiempos de los bits.
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.