Fita de LED WS2812B NeoPixel com Arduino: guia de LEDs RGB endereçáveis

O WS2812B é um LED RGB com o próprio chip driver embutido. Enquanto um LED RGB comum precisa de um pino separado para cada cor, com o WS2812B você controla centenas de LEDs por um único fio de dados e dá a cada um a própria cor e o próprio brilho. NeoPixel é o nome que a Adafruit dá a essa família de LEDs endereçáveis. Vendidos como fitas, anéis, barras e matrizes, eles aparecem em incontáveis projetos, de iluminação ambiente e relógios de LED a jogos e lâmpadas de notificação.

Como funciona o WS2812B?

Dentro do encapsulamento de 5x5 mm de cada WS2812B há três LEDs minúsculos, vermelho, verde e azul, mais um chip em miniatura que os aciona. O Arduino envia pela linha de dados pacotes de cor de 24 bits, um atrás do outro: 8 bits de verde, 8 de vermelho e 8 de azul (ordem GRB). O primeiro LED fica com os primeiros 24 bits e repassa o resto ao próximo LED pelo pino DO; todos os LEDs fazem o mesmo. Quando a linha de dados fica em LOW por pelo menos 50 microssegundos (280 nas versões mais novas), todos os LEDs mostram a sua cor no mesmo instante. Com 256 níveis por cor, um único LED consegue mostrar 16,7 milhões de cores diferentes.

Fitas, anéis e matrizes

Ligando o WS2812B

O WS2812B tem três conexões: 5V, GND e DIN (entrada de dados). As setas na fita mostram a direção em que os dados fluem; ligue sempre o Arduino na ponta onde as setas começam, o lado DIN. Colocar um resistor de 330–470 Ω em série na linha de dados e um capacitor de 1000 µF entre 5V e GND na entrada de alimentação da fita protege o primeiro LED de picos repentinos de tensão.

Cálculo de alimentação: de quantos amperes você precisa?

A fórmula do pior caso é simples: número de LEDs × 60 mA. Em animações, raramente todos os LEDs ficam em branco total ao mesmo tempo; na prática, você vai ver uma média de uns 20 mA por LED. Mesmo assim, escolha a fonte pelo pior caso ou limite o brilho no software. Use a ferramenta da lei de Ohm para calcular a potência em watts e a ferramenta de duração da bateria para estimar a autonomia em projetos com bateria.

Seu primeiro código com a biblioteca Adafruit NeoPixel

No Gerenciador de Bibliotecas, busque Adafruit NeoPixel e instale. O código abaixo “pinta” a fita com uma cor, acendendo os LEDs um por um em vermelho, verde e azul:

1#include <Adafruit_NeoPixel.h>
2
3#define PIN 6          // DIN pini / data pin
4#define NUM_LEDS 8     // LED sayısı / number of LEDs
5
6Adafruit_NeoPixel strip(NUM_LEDS, PIN, NEO_GRB + NEO_KHZ800);
7
8void setup() {
9  strip.begin();
10  strip.setBrightness(50);   // 0–255, yalnız bir kez / only once
11  strip.show();              // hepsini söndür / all off
12}
13
14void colorWipe(uint32_t color, int wait) {
15  for (int i = 0; i < NUM_LEDS; i++) {
16    strip.setPixelColor(i, color);
17    strip.show();            // değişikliği gönder / send the change
18    delay(wait);
19  }
20}
21
22void loop() {
23  colorWipe(strip.Color(255, 0, 0), 80);   // kırmızı / red
24  colorWipe(strip.Color(0, 255, 0), 80);   // yeşil / green
25  colorWipe(strip.Color(0, 0, 255), 80);   // mavi / blue
26}

O setPixelColor() só muda a cor na memória; para acender os LEDs de verdade, você precisa chamar o show(). Assim você define a cor de cada LED e mostra todos de uma vez. Como o setBrightness() altera os dados de cor de forma permanente, o melhor é chamá-lo uma vez no setup() em vez de mudá-lo o tempo todo no loop(). Cada LED ocupa 3 bytes da RAM do Arduino; os 2 KB do Uno se enchem rapidinho com centenas de LEDs.

Efeito arco-íris: cores HSV

Usar HSV (matiz, saturação, valor) em vez de definir as cores com valores de vermelho, verde e azul facilita muito os efeitos: você percorre todo o círculo de cores só mudando a matiz. Na biblioteca da Adafruit, a matiz vai de 0 a 65535. O gamma32() corrige as cores de acordo com a forma como o olho as percebe, então as transições ficam mais naturais:

1#include <Adafruit_NeoPixel.h>
2
3#define PIN 6
4#define NUM_LEDS 24
5
6Adafruit_NeoPixel strip(NUM_LEDS, PIN, NEO_GRB + NEO_KHZ800);
7
8void setup() {
9  strip.begin();
10  strip.setBrightness(40);
11}
12
13void loop() {
14  for (long first = 0; first < 65536; first += 256) {
15    for (int i = 0; i < NUM_LEDS; i++) {
16      uint16_t hue = first + i * 65536L / NUM_LEDS;   // her LED'e farklı ton / a different hue per LED
17      strip.setPixelColor(i, strip.gamma32(strip.ColorHSV(hue)));
18    }
19    strip.show();
20    delay(10);
21  }
22}

A biblioteca FastLED

Para efeitos mais avançados, a biblioteca FastLED também é muito popular. Ela guarda os LEDs em um array CRGB, oferece comandos legíveis como leds[3] = CRGB::Red; e usa uma faixa de matiz de 0–255. Funções prontas como fill_rainbow() e fadeToBlackBy() permitem escrever efeitos de fogo, estrela cadente ou respiração em poucas linhas. Um dos recursos mais práticos é o FastLED.setMaxPowerInVoltsAndMilliamps(5, 2000);: a biblioteca baixa o brilho automaticamente para manter a corrente abaixo de 2 A.

Usando uma matriz NeoPixel 8x8

Uma matriz é, na verdade, só uma fita longa: 64 LEDs encadeados um depois do outro em uma única linha de dados. Na maioria das matrizes as linhas seguem em zigue-zague (serpentina): as linhas pares vão da esquerda para a direita e as ímpares, da direita para a esquerda. Então, para transformar uma coordenada x, y em um número de LED, você usa y × 8 + x nas linhas pares e y × 8 + (7 − x) nas ímpares. Como 64 LEDs podem puxar 3,8 A no branco total, manter o brilho baixo é especialmente importante nas matrizes.

WS2812B com ESP32 e Raspberry Pi Pico

As bibliotecas Adafruit NeoPixel e FastLED também funcionam no ESP32; graças ao Wi-Fi, fica fácil controlar os LEDs pelo celular ou montar uma luminária que muda de cor conforme o tempo lá fora. O ponto de atenção é o nível de tensão: um WS2812B alimentado com 5 V espera pelo menos 3,5 V na entrada de dados, enquanto o ESP32 e o Pico entregam 3,3 V. A maioria das fitas funciona mesmo assim, mas, se o primeiro LED piscar ou aparecerem cores aleatórias, coloque um conversor de nível como o 74AHCT125 na linha de dados. No Raspberry Pi Pico, o MicroPython tem um módulo neopixel embutido:

1from machine import Pin
2import neopixel
3import time
4
5NUM = 8
6np = neopixel.NeoPixel(Pin(0), NUM)      # GP0 → DIN
7
8def wheel(pos):                          # 0–255 → renk çemberi / colour wheel
9    if pos < 85:
10        return (255 - pos * 3, pos * 3, 0)
11    if pos < 170:
12        pos -= 85
13        return (0, 255 - pos * 3, pos * 3)
14    pos -= 170
15    return (pos * 3, 0, 255 - pos * 3)
16
17j = 0
18while True:
19    for i in range(NUM):
20        r, g, b = wheel((i * 256 // NUM + j) & 255)
21        np[i] = (r // 5, g // 5, b // 5)  # parlaklığı düşür / dim it
22    np.write()
23    j = (j + 2) & 255
24    time.sleep_ms(20)

Ideias de projetos com WS2812B

• Luz ambiente para a TV: cole uma fita atrás da TV para dar ao cômodo um brilho suave.
• Relógio NeoPixel: mostre horas, minutos e segundos em cores diferentes em um anel de 60 LEDs.
• Medidor de nível sonoro: monte uma barra de LEDs que sobe com o volume da música usando um módulo de microfone.
• Lâmpada de notificação: mude de cor com o ESP32 de acordo com a previsão do tempo ou com um e-mail novo vindo da internet.
• Luzes de polícia e Knight Rider: escreva efeitos de luz vermelho-azul piscando ou de varredura de um lado para o outro.
• Jogo da cobrinha em pixels: recrie o clássico jogo da cobrinha com uma matriz 8x8 e um joystick.

Erros comuns e como corrigir

• Nenhum LED acende: o Arduino está ligado na ponta errada da fita, o lado DOUT; confira as setas e use a ponta DIN.
• As cores estão trocadas (verde em vez de vermelho): a ordem das cores está errada; use NEO_GRB no código, embora algumas fitas precisem de NEO_RGB.
• O primeiro LED pisca ou mostra cores aleatórias: falta o resistor em série, o GND não está compartilhado ou o sinal de dados de 3,3 V não é suficiente.
• O fim da fita fica amarelado: há queda de tensão; leve a alimentação até a fita em vários pontos ou baixe o brilho.
• O Arduino reinicia quando os LEDs acendem: está sendo puxada corrente demais da USB; use uma fonte externa e um capacitor de 1000 µF.
• Só os primeiros LEDs acendem: o NUM_LEDS no código é menor que o número real de LEDs, ou há uma conexão partida em algum ponto da fita.

O WS2812B é um ótimo ponto de partida para entender como as cores se misturam; a lógica das cores está em Como usar um LED RGB, e o controle de brilho, em O que é PWM? No app BlueGrays você encontra o básico do WS2812B, luzes de polícia, LEDs sequenciais, um scanner Knight Rider, efeitos de animação e controle de fita NeoPixel com ESP32, com esquemas do circuito e código.