Aprender

Arduino NeoPixels: um arco-íris WS2812B em um Uno

Iniciante

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: um arco-íris NeoPixelao vivo0.000 s 0.00x
Clique para abrir no editor
Twenty WS2812Bs on pin 6 and four on pin 5, on a simulated ATmega328P. The knob on A0 sets the speed.

Uma fita de NeoPixels é uma fileira de LEDs RGB minúsculos, cada um com seu próprio chipzinho. Você envia as cores por um único fio de dados, e cada LED guarda sua cor até você enviar novas. A Adafruit vende essas fitas como NeoPixels; o chip dentro delas é o WS2812B, e fitas, anéis e matrizes baratas usam todos o mesmo.

O circuito acima é um Arduino Uno controlando duas fitas: um arco de vinte LEDs no pino 6 e um potinho de quatro LEDs dourados no pino 5. Um arco-íris percorre o arco, e o botão giratório no A0 controla a velocidade. Ele roda no seu navegador com o sketch abaixo, e cada fita decodifica os pulsos reais no seu pino de dados, então um erro de ligação fica escuro aqui do mesmo jeito que ficaria na sua mesa.

O que você precisa

  • Um Arduino Uno
  • Uma fita de WS2812B (vinte LEDs aqui) e uma curta de quatro
  • Dois resistores de 330 ohms, um para cada linha de dados
  • Um potenciômetro de 10k para a velocidade
  • Uma protoboard de meio tamanho e fios jumpers

Ligação

Componente e pinoVai paraNota
DIN da fita do arcoPino 6Por um resistor de 330 ohms
DIN da fita douradaPino 5Pelo seu próprio resistor de 330 ohms
VDD (5V) das duas fitasTrilho de 5 VUse uma fonte de 5 V separada para uma fita longa
VSS (GND) das duas fitasTrilho GNDO terra precisa ser compartilhado com o Uno
Pino central do potenciômetroA0O botão de velocidade
Pinos externos do potenciômetro5 V e GNDDe qualquer lado

Um fio só, e o timing é o dado

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.

Esses pulsos são curtos demais para fazer com digitalWrite(). A biblioteca Adafruit_NeoPixel faz o timing por você, então o seu sketch só trabalha com cores. No Uno, os bits são contados em assembly, um ciclo de clock por vez.

O sketch, passo a passo

Cada fita é um objeto: quantos LEDs, qual pino e a ordem das cores. NEO_GRB + NEO_KHZ800 serve para quase todos os WS2812B. begin() configura o pino, e setBrightness() reduz todas as cores, o que economiza energia e os seus olhos.

Em loop(), o sketch lê o botão e transforma isso em uma velocidade de 32 a 1024. Ele soma isso a um tom de partida e dá a cada LED um tom um pouco mais adiante no círculo de cores. ColorHSV() recebe um tom de 0 a 65535 e devolve uma cor, e gamma32() a corrige para que os degradês fiquem suaves aos seus olhos. Nada muda na fita até show() enviar o quadro inteiro.

O loop espera 20 milissegundos, então o arco-íris se move cerca de cinquenta vezes por segundo. A cada 200 quadros ele imprime a velocidade. Com o botão no meio, a primeira linha diz "Rainbow speed 528". Gire tudo para baixo e ela diz 32.

O loop, do exemplo do arco-íris
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);
}

Energia: a parte que o simulador não consegue avisar

Cada WS2812B pode consumir cerca de 60 miliampères no branco total. Vinte deles passam de um ampère, mais do que o pino de 5 V do Uno deveria fornecer. Para mais do que alguns LEDs, alimente a fita com uma fonte de 5 V própria, una o terra dela ao terra do Uno e mantenha o brilho baixo. Um capacitor de 1000 microfarads nos fios de alimentação da fita, como a Adafruit recomenda, protege o primeiro LED quando você liga.

O Mokxi não modela a corrente que cada LED consome, então uma fita longa aqui nunca faz a placa perder tensão. Esse é um limite real da simulação, e é por isso que esta seção existe.

Experimente no editor

Faça o arco-íris andar no outro sentido trocando start += speed por start -= speed. Mude ARCH para 60 e a propriedade count da fita para 60 para um arco mais comprido. Dê um brilho esverdeado ao potinho trocando os números na chamada de setPixelColor() dele.

Depois apague o fio de terra do arco e aperte Rodar. O arco fica escuro, porque os pulsos de dados não têm por onde voltar. Recoloque o fio e o arco-íris volta.

Erros comuns

Sem terra compartilhado. Uma fita com fonte própria ainda precisa do GND ligado ao GND do Uno, senão a linha de dados não significa nada para ela.

Esquecer o show(). setPixelColor() só muda uma lista na memória. A fita não muda até show() enviá-la.

A ordem errada das cores. O WS2812B quer NEO_GRB. Se usar NEO_RGB, o vermelho e o verde saem trocados, aqui e numa fita de verdade.

Ligar no lado errado. Os dados entram no DIN. A seta impressa na fita aponta para longe da entrada, na direção do DOUT.

Rodar uma fita longa no pino de 5 V do Uno com brilho máximo. Veja a seção de energia acima.

Abra este circuito no editor. Arduino Uno: um arco-íris de NeoPixels, ligado como roda no topo desta página. Mude um componente ou um valor e rode de novo.

Abrir o circuito

Perguntas

Qual pino devo usar para NeoPixels num Arduino Uno?

Qualquer pino digital serve. A biblioteca faz o timing dos pulsos, então o pino não precisa de PWM. Este exemplo usa os pinos 6 e 5, cada um por um resistor de 330 ohms.

Posso usar FastLED em vez de Adafruit_NeoPixel?

Sim. As duas bibliotecas compilam no Mokxi, nas placas AVR, na família ESP32, no Pico e no Uno R4. Numa placa sem driver de WS2812 aqui, como as placas STM32, o cabeçalho avisa quando você compila.

Quantos NeoPixels um Uno consegue controlar?

A biblioteca guarda três bytes de memória para cada LED, e o Uno tem 2 KB de RAM, então algumas centenas é o máximo na prática antes de o sketch ficar sem espaço. A energia geralmente é o limite real primeiro. No Mokxi, todas as fitas de um sketch compartilham um conjunto fixo de 1024 LEDs.

Isso também funciona num ESP32?

Sim, com o mesmo código. O tutorial de NeoPixel no ESP32 roda um arco-íris num ESP32-C3 e explica como essa placa faz o timing dos bits.

Monte isto de verdade

Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.