Componentes

Tira de LEDs APA102 (DotStar)

LEDs RGB direccionables con un cable de reloj y un cable de datos, así que funciona a cualquier velocidad. Alias: DotStar, SK9822, APA102C, tira DotStar de Adafruit.

Cada LED lee su línea de datos en el flanco de subida del reloj, así que la placa marca el ritmo: un bucle digitalWrite() lento, SPI por hardware o una interrupción en medio de un cuadro, todos funcionan. Un WS2812, en cambio, necesita que cada bit esté temporizado a una fracción de microsegundo. count define cuántos LEDs tiene la tira, de 1 a 1024.

Pins

Pin Qué hace
VCC Alimentación, 5 V (el típico según la hoja de datos; 5.5 V máximo). Impreso 5V en una tira DotStar.
CI Entrada de reloj, desde la placa.
DI Entrada de datos, desde la placa.
GND Tierra.
CO Salida de reloj, hacia el CI de la siguiente tira.
DO Salida de datos, hacia el DI de la siguiente tira.

Los cuadros

De la hoja de datos del APA102, 32 bits a la vez, el bit más significativo primero:

Marco Bits
Empezar 32 zeros
Uno por LED 111, un brillo global de 5 bits, luego azul, verde y rojo, 8 bits cada uno
Fin Ones, at least one clock for every two LEDs

El brillo global ajusta la corriente del LED en 31 pasos (11111 es el máximo, 00000 es apagado) además del ciclo útil de 0 a 255 de cada color. La tira muestra cada canal como color x brillo / 31. El primer LED conserva el primer cuadro después del cuadro de inicio y pasa el resto, así que el segundo LED recibe el segundo cuadro, y así sucesivamente.

Por qué el frame final: cada LED pasa los datos con medio clock de retraso, pero el clock en sí no se retrasa. El último de 30 LEDs solo tiene su frame completo 15 clocks después de que la placa lo envió. Mokxi toma esto en cuenta, así que un sketch que no envía el frame final ve el extremo lejano de la tira actualizarse un show() tarde, como una tira real.

En un sketch

Adafruit_DotStar.h (pines de datos y clock, o los pines SPI de la placa si los omites) y addLeds<APA102, DATA_PIN, CLOCK_PIN, BGR> de FastLED ambos lo encienden. El componente toma los colores en el orden azul, verde y rojo del datasheet, así que usa DOTSTAR_BGR. Los ejemplos de Adafruit dicen DOTSTAR_BRG porque algunas tiras están cableadas así; en este componente ese orden intercambia el rojo y el verde.

#include <Adafruit_DotStar.h>
#include <SPI.h>

Adafruit_DotStar strip(30, 4, 5, DOTSTAR_BGR);   // data pin 4, clock pin 5

void setup() {
  strip.begin();
  strip.setBrightness(96);
}

void loop() {
  strip.rainbow(millis() * 64);
  strip.show();
  delay(20);
}

El ejemplo del arcoíris de DotStar ejecuta esto en un Uno e imprime cuánto tarda cada show().

Niveles

Las entradas leen alto por encima de 0.7 de la alimentación y bajo por debajo de 0.3 de esta. En una tira de 5 V eso es 3.5 V, así que una placa de 3.3 V (un ESP32 o una Pico) no puede dar el clock: pon un cambio de nivel 74AHCT125 en CI y DI, o alimenta la tira con 3.3 V. Por debajo de 3 V la tira está apagada.

Lo que no modela

Los LEDs muestran su color promedio, no el parpadeo PWM que hay debajo. Un frame cuyos primeros tres bits no son 111 se ignora (el modo de autodetección del datasheet). No se aplica una frecuencia de clock máxima, porque el datasheet no da ninguna; las tiras reales funcionan entre 1 y 10 MHz y las largas van mejor más despacio. La tira no consume corriente de la alimentación, mientras que una real llega a unos 60 mA por LED en blanco completo.