Урок 1. FastLED. Установка и первое подключение ESP32, ESP8266, WS2812B.

Перед тем как мы начнем, давайте ответим на важный вопрос: почему именно FastLED? Библиотека FastLED — это не просто способ управлять светодиодами, это один из самых мощных и популярных инструментов для этого. Вот её ключевые преимущества:

• Высокая производительность: FastLED оптимизирована для быстрой работы и минимального использования ресурсов микроконтроллера, что позволяет создавать сложные анимации без "тормозов".
• Расширенное управление цветом: Библиотека включает инструменты для коррекции цвета, настройки яркости и температуры, а также плавных переходов, что делает визуальные эффекты гораздо качественнее.
• Богатый набор инструментов: В FastLED встроены готовые функции для генерации шума, работы с палитрами и математические утилиты, которые значительно упрощают создание красивых анимаций.
• Широкая совместимость: Она поддерживает огромное количество различных типов светодиодных лент и платформ (Arduino, ESP32, ESP8266, Teensy и др.), что делает ваш код легко переносимым между проектами.

Именно поэтому FastLED является стандартом де-факто для серьезных проектов со светодиодными лентами.

Цель урока: После завершения урока вы сможете самостоятельно: установить библиотеку FastLED, правильно подключить адресную светодиодную ленту к ESP32/ESP8266 и загрузить свою первую программу, которая зальет всю ленту сплошным синим цветом.

Ключевые понятия и функции:

• Библиотека FastLED: Наш главный инструмент для управления светодиодами.
• WS2812B: Популярный тип адресных светодиодов.
• CRGB leds[]: "Виртуальная лента" в памяти контроллера, где мы будем хранить цвета.
• NUM_LEDS, LED_PIN: Константы для удобной настройки пина и длины ленты.
• FastLED.addLeds(): Функция инициализации ленты.
• fill_solid(): Новая функция! Заполняет всю ленту (или ее часть) одним цветом.
• CRGB::Blue: Предопределенная константа для синего цвета.
• FastLED.show(): Команда, которая отправляет данные из "виртуальной ленты" на физическую, заставляя ее светиться.
• Общий провод (GND): Важнейшее соединение для стабильной работы схемы.

Подготовка к работе.

Список необходимых компонентов: ESP32/ESP8266, лента WS2812B, блок питания 5В, резистор 220-470 Ом, макетная плата, провода.

Инструменты и ПО: Arduino IDE (с поддержкой ESP), кабель Micro-USB.

1. Питание: +5V и GND ленты к блоку питания.
2. Данные:
   • Для ESP32: Пин GPIO5 → один конец резистора (220 Ом) → другой конец резистора → вход DIN (Data In) на ленте.
   • Для ESP8266: Пин D5 (это GPIO14) → один конец резистора (220 Ом) → другой конец резистора → вход DIN (Data In) на ленте.
3. Общий GND: GND контроллера → GND блока питания.
4. Конденсатор: Параллельно питанию ленты (+ к +5V, - к GND).

Схема подключения WS2812B к ESP32.

Схема подключения WS2812B к ESP8266.

Примечание:

• Ленту можно питать напрямую от ESP (при подключении к USB), если ток потребления не будет превышать 500 мА. В библиотеке FastLED можно настроить программное ограничение тока: FastLED.setMaxPowerInVoltsAndMilliamps(5, 500); – 5V 500mA
• Ленту можно подключать без резистора, если исключена возможность наличия сигнала на ленту без подключенного питания, т.е. когда лента питается от одного источника с микроконтроллером.

Практическая работа: Программный код.

Перед тем как использовать функции FastLED, библиотеку нужно установить в Arduino IDE. Это делается один раз.

1. Запустите Arduino IDE.
2. Перейдите в меню Скетч -> Подключить библиотеку -> Управлять библиотеками... (или Sketch -> Include Library -> Manage Libraries...).
3. В открывшемся окне "Менеджера библиотек" в строке поиска введите FastLED.
4. В результатах поиска найдите библиотеку с автором Daniel Garcia. Это официальная версия.
5. Нажмите на кнопку Установить. Arduino IDE автоматически скачает и установит последнюю версию библиотеки.

Код урока:

/* -------------------
Урок FastLED 1. Установка и первое подключение.
https://arduino-tex.ru/news/230/urok--fastled-1-ustanovka-i-pervoe-podklyuchenie.html
======================================
Автор: Константин Казанцев.
https://arduino-tex.ru/ 
--------------------*/
// Подключаем библиотеку FastLED
#include <FastLED.h>
// --- НАСТРОЙКИ ЛЕНТЫ ---
// Пин, к которому подключен вход данных (DIN) ленты.
// --- Для ESP32: Пин GPIO5
// --- Для ESP8266: Пин D5 (это GPIO14)
#define LED_PIN 5  // ИЛИ 14 
// Количество светодиодов в вашей ленте.
#define NUM_LEDS 20
// Создаем массив объектов CRGB для хранения цвета каждого светодиода.
CRGB leds[NUM_LEDS];
void setup() {
  // Инициализация ленты: тип, пин, порядок цветов, массив, количество.
  // GRB - наиболее частый порядок для WS2812B. Если цвета неправильные, попробуйте RGB.
  FastLED.addLeds<WS2812B, LED_PIN, GRB>(leds, NUM_LEDS);
  // Заполняем весь массив `leds` одним цветом - синим.
  // Функция принимает 3 аргумента:
  // 1. Указатель на массив (наш `leds`).
  // 2. Количество светодиодов для заливки (`NUM_LEDS`).
  // 3. Цвет (`CRGB::Blue` - встроенная константа цвета). В библиотеке есть много таких констант: Red, Green, Yellow, Purple и т.д. 
  fill_solid(leds, NUM_LEDS, CRGB::Blue);
  // Отправляем данные из массива `leds` на физическую ленту.
  // Только после этой команды светодиоды физически загорятся!
  FastLED.show();
}
void loop() {
  // Основной цикл пока пуст.
  // Наша лента уже горит синим, так как мы всё сделали в функции setup(),
  // которая выполняется один раз при старте.
}

Разбор кода:
#include <FastLED.h> — подключаем все функции и определения из установленной библиотеки FastLED.

#define LED_PIN 5 и #define NUM_LEDS 30 — создаем константы для удобства. Если вы поменяете пин или длину ленты, достаточно будет изменить значение только в этих строках.

CRGB leds[NUM_LEDS]; — это ключевая строка. Мы создаем массив с именем leds. CRGB — это специальный тип данных из FastLED, который может хранить информацию о цвете (красный, зеленый, синий). Размер массива равен NUM_LEDS. Фактически, это "виртуальная" копия нашей ленты в памяти контроллера.

void setup() — код в этом блоке выполняется один раз при включении или перезагрузке контроллера.

FastLED.addLeds<WS2812B, LED_PIN, GRB>(leds, NUM_LEDS); — команда инициализации. Мы "знакомим" библиотеку с нашей лентой, указывая все ее параметры.

FastLED.clear(); — вспомогательная функция, которая заполняет весь массив leds нулями (черным цветом).

FastLED.show(); — отправляет данные из массива leds на физическую ленту. Без этой команды изменения в массиве не отобразятся на ленте.

void loop() — этот блок будет выполняться бесконечно после setup(). Пока мы оставляем его пустым.

fill_solid(leds, NUM_LEDS, CRGB::Blue); — Мы вызываем функцию fill_solid, которая "закрашивает" наш виртуальный массив leds от начала и до конца (NUM_LEDS штук) предопределенным цветом CRGB::Blue. В библиотеке есть много таких констант: Red, Green, Yellow, Purple и т.д.

FastLED.show(); — эта команда читывает данные из массива leds (который теперь заполнен синим цветом) и отправляет их на ленту.

Загрузка и проверка кода.

Пошаговая инструкция:

1. Подключите ваш ESP32 или ESP8266 к компьютеру через USB-кабель.
2. В Arduino IDE перейдите в меню Инструменты -> Плата и выберите вашу плату (например, " ESP32 DEVKIT V1" или "NodeMCU 1.0 (ESP-12E Module)").
3. В меню Инструменты -> Порт выберите COM-порт, к которому подключился контроллер.
4. Нажмите кнопку "Загрузить" (стрелка вправо).
5. Дождитесь окончания компиляции и загрузки.

Описание ожидаемого поведения: Светодиодная лента должна заполнен синим цветом. Если это так — поздравляем, вы успешно подготовили аппаратную и программную базу!

Поиск и устранение неисправностей (FAQ)

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

Понравился Урок 1. FastLED. Установка и первое подключение ESP32, ESP8266, WS2812B? Не забудь поделиться с друзьями в соц. сетях.

А также подписаться на наш канал на VK Видео, вступить в группу Вконтакте.

Спасибо за внимание!

Технологии начинаются с простого!

Фотографии к статье

 

 

 

 

 

 

 

 

Файлы для скачивания

Код к уроку 1. FastLED..ino

2 Kb

71

Скачать Вы можете скачать файл.