Библиотека FastLED: скачать и подключить WS2812

Установка FastLED в Arduino IDE

• Откройте Sketch → Include Library → Manage Libraries (или Ctrl+Shift+I).
• В поиске наберите FastLED, автор библиотеки Daniel Garcia, счётчик установок в миллионах.
• Нажмите Install, библиотека встанет со всеми зависимостями.
• Проверка: File → Examples → FastLED → Blink, скетч должен компилироваться.

Как устроена адресная лента

Обычная лента из отдельных светодиодов питается от общих проводов, и цвет задаётся на всю ленту сразу. В адресной ленте каждый светодиод это отдельный микроконтроллер с тремя каналами яркости и своим адресом. Они соединены цепочкой: данные приходят на первый пиксель, тот формирует сигнал для второго и так далее. Arduino при этом не переключает 16 выводов, он отправляет по одному проводу последовательность бит, и каждый пиксель сам выбирает, что ему показать.

Отсюда два важных следствия. Первое: скорость передачи фиксирована, у WS2812B это 800 кГц, и длина провода до первого пикселя ограничена примерно пятью метрами, дальше сигнал рассыпается. Второе: у WS2812B физический порядок цветов GRB, а не RGB. Если в коде написать RGB, лента загорится, но цвета будут ехать: вместо красного получится зелёный, вместо синего, наоборот, красный. Быстрые чипы SK6812 встречаются в двух вариантах с порядком GRB и RGB, так что на новой ленте стоит проверить, что горит правильно.

Минимальный скетч: залить ленту красным

#include <FastLED.h>
#define LED_PIN 6
#define NUM_LEDS 16
CRGB leds[NUM_LEDS];
 
void setup() {
  FastLED.addLeds<WS2812B, LED_PIN, GRB>(leds, NUM_LEDS);
  FastLED.setBrightness(100);
  fill_solid(leds, NUM_LEDS, CRGB::Red);
  FastLED.show();
}
 
void loop() {}

Четыре строки делают всю работу, и каждая важна. addLeds с параметрами в угловых скобках говорит библиотеке тип чипа, пин и порядок цветов, а заодно создаёт таймер, который формирует импульсы. setBrightness ограничивает общую яркость шкалой от 0 до 255 и имеет смысл ставить сразу: кроме красоты это снижает ток, а ток это нагрев и риск сброса платы. fill_solid заливает все пиксели одним цветом, а вот show() отправляет данные в ленту. Без вызова show() экран останется пустым, и это самая частая причина «всё написано, но ничего не горит».

FastLED или Adafruit NeoPixel: что выбрать

NeoPixel проще для первого знакомства, FastLED функциональнее: цвета в модели HSV, палитры, шум Перлина, более быстрая выводка и поддержка десятков чипов. Для эффектов и матриц мы берём FastLED и не вспоминаем о NeoPixel, а для «помигать одним светодиодом» разницы нет. Технически обе библиотеки дают одно и то же, выбор только в удобстве и в том, сколько готовых примеров вы найдёте.

Питание: три правила

• Один пиксель на полной яркости белым съедает до 60 мА: 100 пикселей это до 6 А, и блок питания нужно брать с запасом.
• Резистор 300–500 Ом в линию данных у первого пикселя и конденсатор 1000 мкФ по питанию защищают первый светодиод от выбросов.
• Каждый метр ленты, а это примерно 60 пикселей, на полной яркости требует подпитки 5 В от блока питания, иначе хвост желтит.

Правило простое: Arduino не питает ленту, кроме как в самых коротких демонстрациях. Пины Arduino дают десятки миллиампер, лента из 60 пикселей просит около 3,6 А в белом, и при попытке запитать её от платы вы получите не картинку, а перезагрузку платы и погасшую ленту. Схема правильная выглядит так: блок питания 5 В идёт на ленту и на Vin платы, земля общая, а сигнальный провод идёт от вывода Arduino к первому пикселю через резистор. Отдельный выключатель по питанию ленты при таком подключении обязателен.

Тупик: лента работает, но хвост желтит

Симптом, который мы видим чаще всего. Первые пиксели горят правильным цветом, а дальше по ленте цвет уходит в жёлтый, и чем дальше, тем сильнее. Проверка мультиметром даёт ответ мгновенно: на первом пикселе напряжение 5 В, а на последнем оно заметно ниже.

Причина в питании, а не в коде. Лента подключена к блоку питания тонким проводом или через длинную цепочку, сопротивление провода съедает падение напряжения, и дальние пиксели получают меньше вольт, чем нужно. Лечится тремя способами: питать ленту напрямую от блока коротким и толстым проводом, подключить клеммы питания у начала и у конца ленты, чтобы ток шёл с двух сторон, либо снизить яркость через setBrightness. Мы проверяли это на ленте в метр: при подпитке с двух концов желтизна уходила полностью, при питании через всю длину одним тонким проводом оставалась заметной.

Личный опыт: сколько тока ест лента на самом деле

Слово «до 60 мА на пиксель» из datasheet пугает, пока не посчитаешь. Мы брали ленту на 60 пикселей и мерили ток блоком питания с ограничением по яркости. На полной белой заливке с setBrightness(255) блок показывал ток ближе к верхней границе расчётного, а при setBrightness(100) ток падал примерно вдвое. То есть заявленная цифра достигается только на максимуме, а на рабочей яркости запас вдвое больше.

Второе наблюдение касается нагрева. Мы оставили ленту включённой на полной яркости на несколько минут и замерили температуру корпусов пикселей: она заметно поднималась, особенно у первых пятидесяти светодиодов, от которых шёл основной ток. Плата при этом оставалась холодной, и это важный признак: если греется именно Arduino, значит ленту всё-таки питают от платы. Мы добавили в скетч ограничение мощности, и после этого лента не перегружала блок даже при эффектах с белыми пикселями.

Авторская позиция: что брать новичку

Берите FastLED, а не NeoPixel, и вот почему. Через месяц вы захотите радугу, бегущий огонь или шкалу температуры, и с FastLED это готовая строка кода плюс пара чисел, а с NeoPixel придётся писать эффект с нуля. Разница в размере библиотеки для нас несущественна, а разница в скорости разработки ощутима. Единственный случай, когда мы выбираем NeoPixel, это проект, где важна минимальная память и каждый килобайт на счётчике.

Отдельно про железо. Новичку мы советуем купить ленту на 30–60 пикселей, отдельный блок питания 5 В с запасом по току и не тянуть сразу метровые гирлянды. Первая лента нужна, чтобы увидеть, что библиотека работает, а не чтобы устроить настоящую иллюминацию. И ещё одно: покупайте ленты с клеммами на обоих концах, а не с припаянным шнуром, иначе подпитка второго конца станет невозможной, а именно она спасает от желтизны.

Частые вопросы