Светодиодная лента WS2812B NeoPixel и Arduino: руководство по адресным RGB-светодиодам

WS2812B — это RGB-светодиод со встроенной микросхемой-драйвером. Обычному RGB-светодиоду нужен отдельный пин на каждый цвет, а WS2812B позволяет управлять сотнями светодиодов по одному проводу данных и задавать каждому свой цвет и яркость. NeoPixel — так Adafruit называет это семейство адресных светодиодов. Их продают в виде лент, колец, линеек и матриц и используют в бесчисленных проектах: от фоновой подсветки и светодиодных часов до игр и ламп-уведомлений.

Как работает WS2812B?

В корпусе каждого WS2812B размером 5x5 мм спрятаны три крошечных светодиода — красный, зелёный и синий — и миниатюрная микросхема, которая ими управляет. Arduino отправляет по линии данных 24-битные пакеты цвета один за другим: 8 бит зелёного, 8 красного и 8 синего (порядок GRB). Первый светодиод оставляет себе первые 24 бита, а остальное передаёт следующему через свой пин DO; так поступает каждый светодиод. Когда линия данных держится в LOW не меньше 50 микросекунд (у новых версий 280), все светодиоды одновременно загораются своим цветом. При 256 уровнях на цвет один светодиод может показать 16,7 миллиона разных цветов.

Ленты, кольца и матрицы

Подключение WS2812B

У WS2812B три контакта: 5V, GND и DIN (вход данных). Стрелки на ленте показывают, куда идут данные; Arduino всегда подключают к тому концу, откуда стрелки начинаются, то есть к стороне DIN. Резистор 330–470 Ω последовательно в линии данных и конденсатор 1000 µF между 5V и GND на входе питания ленты защищают первый светодиод от резких скачков напряжения.

Расчёт питания: сколько ампер нужно?

Формула для худшего случая простая: число светодиодов × 60 mA. В анимациях все светодиоды редко горят полным белым одновременно; на практике в среднем выходит около 20 mA на светодиод. И всё же адаптер стоит выбирать под худший случай или ограничивать яркость программно. Утилита закон Ома поможет посчитать мощность в ваттах, а утилита время работы от батареи — оценить время работы в проектах с батарейным питанием.

Первый код с библиотекой Adafruit NeoPixel

В «Менеджере библиотек» (Library Manager) найди Adafruit NeoPixel и установи её. Код ниже «закрашивает» ленту цветом, зажигая светодиоды по одному красным, зелёным и синим:

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}

setPixelColor() меняет цвет только в памяти; чтобы светодиоды действительно загорелись, нужно вызвать show(). Так можно задать цвет каждого светодиода и показать их все разом. Поскольку setBrightness() необратимо масштабирует данные цвета, её лучше вызвать один раз в setup(), а не менять постоянно в loop(). Каждый светодиод занимает 3 байта ОЗУ Arduino; 2 КБ у Uno быстро заканчиваются, когда светодиодов сотни.

Эффект радуги: цвета HSV

Если вместо красного, зелёного и синего задавать цвета в HSV (тон, насыщенность, яркость), эффекты пишутся гораздо проще: по всему цветовому кругу движешься, меняя только тон. В библиотеке Adafruit тон идёт от 0 до 65535. gamma32() подстраивает цвета под то, как их воспринимает глаз, поэтому переходы выглядят естественнее:

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}

Библиотека FastLED

Для более сложных эффектов очень популярна и библиотека FastLED. Она хранит светодиоды в массиве CRGB, даёт понятные команды вроде leds[3] = CRGB::Red; и использует диапазон тона 0–255. Готовые функции, например fill_rainbow() и fadeToBlackBy(), позволяют написать эффекты огня, падающей звезды или «дыхания» в несколько строк. Одна из самых удобных возможностей — FastLED.setMaxPowerInVoltsAndMilliamps(5, 2000);: библиотека сама снижает яркость, чтобы ток не превышал 2 A.

Матрица NeoPixel 8x8

Матрица на самом деле просто длинная лента: 64 светодиода, соединённых цепочкой на одной линии данных. У большинства матриц строки идут зигзагом (змейкой): чётные строки слева направо, нечётные справа налево. Поэтому, чтобы превратить координаты x, y в номер светодиода, на чётных строках используют y × 8 + x, а на нечётных y × 8 + (7 − x). Поскольку 64 светодиода на полном белом могут потреблять 3,8 A, держать яркость низкой на матрицах особенно важно.

WS2812B с ESP32 и Raspberry Pi Pico

Библиотеки Adafruit NeoPixel и FastLED работают и на ESP32; благодаря Wi-Fi легко управлять светодиодами с телефона или собрать лампу, которая меняет цвет в зависимости от погоды. Следить нужно за уровнем напряжения: WS2812B с питанием 5 V ждёт на входе данных не меньше 3,5 V, а ESP32 и Pico выдают 3,3 V. Большинство лент всё равно работает, но если первый светодиод мерцает или появляются случайные цвета, добавь в линию данных преобразователь уровней, например 74AHCT125. На Raspberry Pi Pico в MicroPython есть встроенный модуль neopixel:

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)

Идеи проектов с WS2812B

• Фоновая подсветка телевизора: наклей ленту на заднюю стенку телевизора, и комната наполнится мягким светом.
• Часы NeoPixel: показывай часы, минуты и секунды разными цветами на кольце из 60 светодиодов.
• Индикатор уровня звука: с модулем микрофона собери светодиодную шкалу, которая растёт вместе с громкостью музыки.
• Лампа-уведомление: меняй цвет с помощью ESP32 в зависимости от погоды или новых писем из интернета.
• Полицейская мигалка и Knight Rider: напиши эффекты красно-синих вспышек или бегающего туда-обратно огонька.
• Пиксельная змейка: воссоздай классическую игру «Змейка» на матрице 8x8 и джойстике.

Частые ошибки и как их исправить

• Не горит ни один светодиод: Arduino подключена не к тому концу ленты, к стороне DOUT; посмотри на стрелки и используй конец DIN.
• Цвета перепутаны (зелёный вместо красного): неверный порядок цветов; укажи в коде NEO_GRB, хотя некоторым лентам нужен NEO_RGB.
• Первый светодиод мерцает или показывает случайные цвета: нет последовательного резистора, нет общей GND или сигнала данных 3,3 V не хватает.
• Конец ленты желтоватый: падает напряжение; подводи питание к ленте в нескольких точках или снизь яркость.
• Arduino перезагружается, когда загораются светодиоды: от USB берётся слишком большой ток; используй внешний адаптер и конденсатор 1000 µF.
• Горят только первые несколько светодиодов: NUM_LEDS в коде меньше реального числа светодиодов или где-то вдоль ленты нарушен контакт.

WS2812B — отличная отправная точка, чтобы понять, как смешиваются цвета; логику цвета найдёшь в статье Как пользоваться RGB-светодиодом, а управление яркостью — в статье Что такое PWM? В приложении BlueGrays есть основы WS2812B, полицейская мигалка, бегущие огни, сканер Knight Rider, эффекты анимации и управление лентой NeoPixel с ESP32 — со схемами подключения и кодом.