Componentes

Fita de LEDs APA102 (DotStar)

LEDs RGB endereçáveis com um fio de clock e um fio de dados, então qualquer velocidade funciona. Apelidos: DotStar, SK9822, APA102C, fita Adafruit DotStar.

Cada LED lê sua linha de dados na borda de subida do clock, então a placa dita o ritmo: um laço digitalWrite() lento, hardware SPI ou uma interrupção no meio de um quadro funcionam. Já um WS2812 precisa de cada bit cronometrado a uma fração de microssegundo. count define quantos LEDs a fita tem, de 1 a 1024.

Pins

Pin O que faz
VCC Alimentação, 5 V (o típico do datasheet; 5,5 V no máximo). Impresso 5V em uma fita DotStar.
CI Entrada de clock, vinda da placa.
DI Entrada de dados, vinda da placa.
GND Alimentação.
CO Saída de clock, para o CI da próxima fita.
DO Saída de dados, para o DI da próxima fita.

Os quadros

Do datasheet do APA102, 32 bits por vez, bit mais significativo primeiro:

Quadro Bits
Começar 32 zeros
Um por LED 111, um brilho global de 5 bits, depois azul, verde e vermelho, 8 bits cada
Fim Ones, at least one clock for every two LEDs

O brilho global define a corrente do LED em 31 níveis (11111 é o máximo, 00000 é desligado) por cima da razão cíclica de 0 a 255 de cada cor. A fita mostra cada canal como color x brightness / 31. O primeiro LED guarda o primeiro quadro depois do quadro de início e passa o resto adiante, então o segundo LED recebe o segundo quadro, e assim por diante.

Por que o quadro de fim: cada LED passa os dados adiante meio clock atrasado, mas o clock em si não é atrasado. O último de 30 LEDs só tem seu quadro completo 15 clocks depois de a placa tê-lo enviado. O Mokxi leva isso em conta, então um sketch que não envia o quadro de fim vê a ponta distante da fita atualizar um show() atrasado, como numa fita real.

Em um sketch

Adafruit_DotStar.h (pinos de dados e clock, ou os pinos SPI da placa quando você os omite) e o addLeds<APA102, DATA_PIN, CLOCK_PIN, BGR> do FastLED acendem a fita. O componente recebe as cores na ordem azul, verde e vermelho do datasheet, então use DOTSTAR_BGR. Os exemplos da Adafruit dizem DOTSTAR_BRG porque algumas fitas são ligadas assim; neste componente essa ordem troca o vermelho e o 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);
}

O exemplo de arco-íris do DotStar roda isto num Uno e imprime quanto tempo cada show() leva.

Níveis

As entradas leem nível alto acima de 0,7 da alimentação e nível baixo abaixo de 0,3 dela. Numa fita de 5 V isso é 3,5 V, então uma placa de 3,3 V (um ESP32 ou uma Pico) não consegue gerar o clock: coloque um deslocador de nível 74AHCT125 no CI e no DI, ou alimente a fita com 3,3 V. Abaixo de 3 V a fita fica desligada.

O que não é modelado

Os LEDs mostram sua cor média, não a cintilação do PWM por baixo. Um quadro cujos três primeiros bits não são 111 é ignorado (o modo de autodetecção do datasheet). Nenhuma velocidade máxima de clock é imposta, porque o datasheet não dá nenhuma; fitas reais funcionam de 1 a 10 MHz e as longas preferem mais devagar. A fita não puxa corrente da alimentação, enquanto uma real puxa até cerca de 60 mA por LED no branco total.