SavaLED_ESP32 - Высокопроизводительная библиотека для ESP32

• Версия: 2.1.0
• Версия: 2.1.1

Автор: SavaLab

• SavaLED_ESP32 — это мощная, эффективная и полностью неблокирующая библиотека для платформы ESP32 (в среде Arduino IDE), предназначенная для управления адресными светодиодами (WS2812, SK6812 и совместимыми).
• Библиотека разработана с нуля для проектов, требующих максимальной производительности и отзывчивости. Благодаря использованию аппаратного модуля RMT и асинхронной архитектуры,
• SavaLED_ESP32 не останавливает выполнение основного цикла (loop()), что делает ее идеальным выбором для сложных задач, таких как аудиовизуализаторы, интерактивные инсталляции,
• IoT-устройства с сетевым управлением и любые проекты, где задержки недопустимы.

• Полностью неблокирующая: Вся логика, включая сложные встроенные эффекты, работает по асинхронному принципу, не "замораживая" loop().
• Высокая производительность: Использует аппаратный RMT-модуль ESP32 для генерации идеально стабильного сигнала, достигая максимально возможной частоты обновления ленты.
• Гибкие встроенные эффекты: Включает готовые к использованию, настраиваемые эффекты ("Радуга", "Кометы" и др.), которые можно комбинировать и применять к отдельным сегментам ленты.
• Удобное управление цветом: Поддерживает как RGB, так и интуитивно понятную модель HSV. Содержит богатую палитру из 24 предопределенных цветовых констант и функции для тонкого управления яркостью.
• Визуальное качество: Встроенная, оптимизированная гамма-коррекция обеспечивает более плавные и естественные градиенты и переходы яркости.
• Профессиональная архитектура: API спроектирован так, чтобы способствовать написанию чистого, эффективного и масштабируемого кода.

• Скачайте эту библиотеку в виде ZIP-архива.
• В Arduino IDE выберите Скетч -> Подключить библиотеку -> Добавить .ZIP библиотеку....
• Выберите скачанный ZIP-файл. Библиотека будет установлена.
• Примеры будут доступны в меню Файл -> Примеры -> SavaLED_ESP32.
• Архитектура правильного loop()
• Чтобы достичь максимальной производительности и плавности, вся работа с лентой должна строиться по единому принципу "Синхронизация кадра".

void loop() {
  // Выполняем расчеты и отрисовку ТОЛЬКО тогда, 
  // когда лента физически готова принять новый кадр.
  if (strip.canShow()) {
    
    // 1. ПОДГОТОВКА в исключительных случаях если есть проблемы с наложение эфектов:
    // При отчсутствии проблем не использовать. Рисуем фон (например, очищаем ленту).
    // Это гарантирует отсутствие "фантомных" пикселей от прошлого кадра.
    strip.clear(); 
    
    // 2. РИСОВАНИЕ: Вызываем функции эффектов или setPixel/fill.
    // Здесь можно комбинировать несколько вызовов для создания сложной сцены.
    strip.rainbowCycle(0, 50, false, 50, 200);
    strip.setPixel(75, WHITE);
    
    // 3. ОТОБРАЖЕНИЕ: Отправляем готовый кадр на ленту.
    strip.show();
  }
  
  // Здесь может быть любой другой ваш код (работа с датчиками, сетью и т.д.)
}

• Этот паттерн — ключ к стабильной и эффективной работе со всеми функциями библиотеки.

• bool begin(uint16_t numLeds, int pin) Инициализирует библиотеку. Вызывается один раз в setup()

• void show() Инициирует асинхронную отправкуданных из буфера на ленту.

• bool canShow() Ключевая функция! Проверяет, свободен ли RMT-модуль. Возвращает true, если можно рисовать и отправлять новый кадр

• void setBrightness(uint8_t brightness) Устанавливает глобальную яркость для всей ленты (0-255). Применяется как финальный модификатор ко всем цветам в момент вызова show()

• uint16_t getNumLeds() Возвращает количество светодиодов в ленте

Таблица предопределенных цветов (RGB)

• 0 Красный
• 42 Желтый
• 85 Зеленый (Лайм)
• 127 Голубой (Циан)
• 170 Синий
• 212 Пурпурный (Маджента)
• 255 Красный (цикл)

• Важно: Все эти функции должны вызываться внутри if (strip.canShow()), непосредственно перед strip.show().

void runCometsEffect(
  uint8_t num_comets, 
  uint8_t tail_length, 
  const uint32_t palette[], 
  int palette_size, 
  uint32_t background_color = BLACK, 
  uint16_t spawn_interval_ms = 1500
);

• Пример использования:

const uint32_t my_palette[] = { GOLD, CYAN };

void loop() {
  if (strip.canShow()) {
    // Эта функция сама рисует фон, поэтому strip.clear() не нужен
    strip.runCometsEffect(3, 15, my_palette, 2);
    strip.show();
  }
}