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.