Um arco-íris de NeoPixels WS2812B em uma ESP32
Intermediário
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
Os LEDs WS2812B, vendidos pela Adafruit como NeoPixels, colocam um LED vermelho, verde e azul e um pequeno controlador em cada pixel, e os encadeiam todos em um único fio de dados. O circuito acima tem dezesseis deles no GPIO 5 de um ESP32-C3, com uma roda de matizes deslizando pela fita. Ele está rodando agora, em um ESP32-C3 simulada executando o firmware compilado, e a fita está decodificando os pulsos reais no seu pino de dados.
Abra no editor para mudar o número de LEDs, a velocidade ou o brilho, e rode de novo.
O que você precisa
- Uma placa ESP32-C3 (a DevKitM-1 aqui)
- Uma fita, anel ou matriz de WS2812B
- Uma protoboard e jumpers
Ligação
| Componente e pino | Vai para | Nota |
|---|---|---|
| DIN da fita | GPIO 5 | A linha de dados para o primeiro LED |
| VDD da fita | 5 V | Em uma fita real longa, uma fonte de 5 V separada |
| VSS da fita | GND | Compartilhado com a placa |
Um fio, e nenhum clock
There is no clock line. Each bit is a high pulse whose length is the bit: about 0.4 microseconds for a nought and 0.8 for a one. Each LED takes the first 24 bits it receives, green first, then red, then blue, and passes the rest along to the next. When the line has been quiet for 50 microseconds, every LED takes up its new color at once.
A fita simulada decodifica esses pulsos a partir das próprias bordas do pino, com as janelas de tempo do datasheet. Um pulso curto ou longo demais é rejeitado, do mesmo jeito que uma fita real para de seguir um fluxo que não consegue ler. É por isso que um driver que funciona aqui tem o timing certo.
O código Adafruit_NeoPixel
O sketch do tutorial Adafruit NeoPixel compila como está nas placas Arduino, na família ESP32, no Pico e no Uno R4. O cabeçalho é do próprio Mokxi, sobre seu driver WS2812, com setPixelColor(), Color(), ColorHSV(), fill(), clear(), setBrightness(), gamma32() e rainbow(). O exemplo pronto de arco-íris usa o driver de nível mais baixo diretamente, com sua própria roda de cores de números inteiros de 1536 passos ao redor das bordas do cubo RGB.
#include <Adafruit_NeoPixel.h>
Adafruit_NeoPixel pixels(8, 4, NEO_GRB + NEO_KHZ800);
void setup() {
pixels.begin();
}
void loop() {
pixels.clear();
pixels.setPixelColor(0, pixels.Color(0, 150, 0));
pixels.show();
delay(500);
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
Por que este tutorial usa um ESP32
On a real Arduino Uno, the Adafruit library drives WS2812s with hand-tuned assembly that counts every one of the 16 MHz clock’s cycles. In Mokxi, the WS2812 driver is a counted loop (assembly on the AVR boards, the core’s cycle counter on the ESP32, Pico and Uno R4), so the NeoPixel header builds on all of them and stops with a message on the boards with no driver. An ESP32 has more memory for large panels, which is why this circuit uses one.
Experimente no editor
Open the circuit in the editor and change LEVEL from 40 to 255. The strip gets much brighter. On a real bench each pixel can draw up to sixty milliamps at full white, and the supply has to be sized for that, which is why the example runs at a sixth of full scale.
Then select the strip and change its layout property to ring. The same sixteen LEDs are drawn as a circle, with LED 0 at the top and the rest clockwise, which is how the rings you can buy are numbered. The sketch does not change at all, because electrically a ring is a strip.
Por fim, mude SPEED para 1 para um deslizamento lento de cor, ou mude SPREAD para que a fita inteira mostre uma única cor de cada vez.
Erros comuns
Brilho total em cada LED. Cada pixel pode consumir cerca de 60 miliampères no branco total, então uma fita de 60 LEDs quer mais de 3 ampères. O exemplo roda com cerca de um sexto da escala total. O simulador não modela a corrente da fonte, então planeje você mesmo a alimentação de um projeto real.
A ordem de cores errada. Fitas WS2812B esperam verde primeiro. Um sketch que envia vermelho primeiro, com NEO_RGB, troca vermelho e verde, aqui e na bancada.
Sem terra comum entre a placa e uma fita alimentada separadamente. A linha de dados é medida em relação ao terra da fita.
Uma linha de dados de 3,3 volts em uma fita de 5 volts. Muitas fitas reais aceitam, mas não todas. Um conversor de nível, ou um primeiro pixel alimentado um pouco mais baixo, resolve. A fita simulada lê dados de 3,3 volts sem reclamar.
Esquecer o show(). Definir um pixel muda o buffer na memória; nada chega à fita até que show() o envie.
Abra este circuito no editor. ESP32-C3: arco-íris WS2812B, ligado como roda no topo desta página. Mude um componente ou um valor e rode de novo.
Abrir o circuitoPerguntas
Posso usar um anel ou uma matriz NeoPixel em vez de uma fita?
Sim. Eletricamente, todos são uma fita. O componente simulado tem uma propriedade layout para strip, ring e matrix, incluindo matrizes serpentina, e a numeração segue os produtos reais.
Quantos NeoPixels um pino consegue controlar?
Quantos você tiver memória e tempo para: três bytes cada, e cerca de 30 microssegundos por LED para enviar. A fita simulada comporta até 1024 LEDs por componente.
O FastLED funciona?
Sim. FastLED.h compila aqui, e Adafruit_NeoPixel.h também, nas placas AVR, na família ESP32, no Pico e no Uno R4.
Continuar
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.