// базовый пример работы с лентой, основные возможности
// библиотека microLED версии 3.0+
// для более подробной информации читай документацию
// константы для удобства
#define STRIP_PIN 2     // пин ленты
#define NUMLEDS 20      // кол-во светодиодов
// ===== ЦВЕТОВАЯ ГЛУБИНА =====
// 1, 2, 3 (байт на цвет)
// на меньшем цветовом разрешении скетч будет занимать в разы меньше места,
// но уменьшится и количество оттенков и уровней яркости!
// дефайн делается ДО ПОДКЛЮЧЕНИЯ БИБЛИОТЕКИ
// без него будет 3 байта по умолчанию
#define COLOR_DEBTH 3
#include <microLED.h>   // подключаем библу
// ======= ИНИЦИАЛИЗАЦИЯ =======
// <колво-ледов, пин, клок пин, чип, порядок>
// microLED<NUMLEDS, DATA_PIN, CLOCK_PIN, LED_WS2818, ORDER_GRB> strip;
// CLOCK пин нужен только для SPI лент (например APA102)
// для обычных WS лент указываем MLED_NO_CLOCK
// по APA102 смотри отдельный гайд в примерах
// различные китайские подделки могут иметь совместимость
// с одним чипом, но другой порядок цветов!
// поддерживаемые чипы лент и их официальный порядок цветов:
// microLED<NUMLEDS, STRIP_PIN, MLED_NO_CLOCK, LED_WS2811, ORDER_GBR> strip;
// microLED<NUMLEDS, STRIP_PIN, MLED_NO_CLOCK, LED_WS2812, ORDER_GRB> strip;
// microLED<NUMLEDS, STRIP_PIN, MLED_NO_CLOCK, LED_WS2813, ORDER_GRB> strip;
// microLED<NUMLEDS, STRIP_PIN, MLED_NO_CLOCK, LED_WS2815, ORDER_GRB> strip;
// microLED<NUMLEDS, STRIP_PIN, MLED_NO_CLOCK, LED_WS2818, ORDER_RGB> strip;
// microLED<NUMLEDS, STRIP_PIN, MLED_NO_CLOCK, LED_WS6812, ORDER_RGB> strip;
// microLED<NUMLEDS, STRIP_PIN, CLOCK_PIN, LED_APA102, ORDER_BGR> strip;
// microLED<NUMLEDS, MLED_NO_CLOCK, MLED_NO_CLOCK, LED_APA102_SPI, ORDER_BGR> strip;  // для аппаратного SPI
// ======= ПРЕРЫВАНИЯ =======
// для повышения надёжности передачи данных на ленту можно отключать прерывания.
// В библиотеке есть 4 режима:
// CLI_OFF - прерывания не отключаются (возможны сбои в работе ленты)
// CLI_LOW - прерывания отключаются на время передачи одного цвета
// CLI_AVER - прерывания отключаются на время передачи одного светодиода (3 цвета)
// CLI_HIGH - прерывания отключаются на время передачи даных на всю ленту
// По умолчанию отключение прерываний стоит на CLI_OFF (не отключаются)
// Параметр передаётся 5ым при инициализации:
// microLED<NUMLEDS, STRIP_PIN, LED_WS2818, ORDER_GRB, CLI_AVER> strip;
// ======= СПАСИТЕ МИЛЛИС =======
// При отключении прерываний в режиме среднего и высокого проритета (CLI_AVER и CLI_HIGH)
// неизбежно будут чуть отставать функции времени millis() и micros()
// В библиотеке встроено обслуживание функций времени, для активации передаём SAVE_MILLIS
// 6-ым аргументом при инициализации:
// microLED<NUMLEDS, STRIP_PIN, MLED_NO_CLOCK, LED_WS2818, ORDER_GRB, CLI_AVER, SAVE_MILLIS> strip;
// это НЕЗНАЧИТЕЛЬНО замедлит вывод на ленту, но позволит миллису считать без отставания!
// инициализирую ленту (выше был гайд!)
microLED<NUMLEDS, STRIP_PIN, MLED_NO_CLOCK, LED_WS2818, ORDER_GRB, CLI_AVER> strip;
void setup() {
// ===================== БАЗОВЫЕ ШТУКИ =====================
// яркость (0-255)
strip.setBrightness(60);
// яркость применяется по CRT гамме
// применяется при выводе .show() !
// очистка буфера (выключить диоды, чёрный цвет)
strip.clear();
// применяется при выводе .show() !
strip.show(); // вывод изменений на ленту
delay(1);     // между вызовами show должна быть пауза минимум 40 мкс !!!!
// ===================== УСТАНОВКА ЦВЕТА =====================
// Библиотека поддерживает два варианта работы с лентой:
// изменение цвета конкретного диода при помощи функции set(диод, цвет)
// или работа с массивом .leds[] "вручную"
// запись strip.set(диод, цвет); равносильна strip.leds[диод] = цвет;
// ------------- ОСНОВНЫЕ ФУНКЦИИ РАБОТЫ С ЦВЕТОМ ------------
// указанные ниже функции врзвращают тип данных mData - сжатое представление цвета
// mRGB(uint8_t r, uint8_t g, uint8_t b);   // цвет RGB, 0-255 каждый канал
strip.set(0, mRGB(255, 0, 0));              // диод 0, цвет RGB (255 0 0) (красный)
// mHSV(uint8_t h, uint8_t s, uint8_t v);   // цвет HSV, 0-255 каждый канал
strip.leds[1] = mHSV(30, 255, 255);         // диод 1, (цвет 30, яркость и насыщенность максимум)
// mHSVfast(uint8_t h, uint8_t s, uint8_t v); // цвет HSV, 0-255 каждый канал
// расчёт выполняется чуть быстрее, но цвета не такие плавные
strip.set(2, mHSVfast(90, 255, 255));         // диод 2, цвет 90, яркость и насыщенность максимум
// mHEX(uint32_t color);        // WEB цвета (0xRRGGBB)
strip.set(3, mHEX(0x30B210));   // диод 3, цвет HEX 0x30B210
// в библиотеке есть 17 предустановленных цветов (макс. яркость)
strip.leds[4] = mAqua;          // диод 4, цвет aqua
// mWheel(int color);                   // цвета радуги 0-1530
// mWheel(int color, uint8_t bright);   // цвета радуги 0-1530 + яркость 0-255
strip.set(5, mWheel(1200));             // диод 5, цвет 1200
// mWheel8(int color);                  // цвета радуги 0-255
// mWheel8(int color, uint8_t bright);  // цвета радуги 0-255 + яркость 0-255
//strip.set(6, mWheel8(100));     // диод 6, цвет 100 (диапазон 0-255 вдоль радуги)
strip.set(6, mWheel8(100, 50));   // вторым параметром можно передать яркость
// mKelvin(int kelvin);           // цветовая температура 1'000-40'000 Кельвин
strip.set(7, mKelvin(3500));      // диод 7, цветовая температура 3500К
strip.show();                     // выводим все изменения на ленту
delay(2000);                      // задержка показа
// ===================== ЗАЛИВКА =====================
// Есть готовая функция для заливки всей ленты цветом - .fill()
// принимает конвертированный цвет, например от функций цвета или констант выше
strip.fill(mYellow);  // заливаем жёлтым
strip.show();         // выводим изменения
delay(2000);
// также можно указать начало и конец заливки
strip.fill(3, 7, mWheel8(100));   // заливаем ~зелёным с 3 по 6: счёт идёт с 0, заливается до указанного -1
strip.show();                     // выводим изменения
delay(2000);
// ------------- РУЧНАЯ ЗАЛИВКА В ЦИКЛЕ ------------
// Например покрасим половину ленты в один, половину в другой
for (int i = 0; i < NUMLEDS / 2; i++) strip.leds[i] = mHSV(0, 255, 255);      // красный
for (int i = NUMLEDS / 2; i < NUMLEDS; i++) strip.leds[i] = mHSV(80, 255, 255); // примерно зелёный
strip.show(); // выводим изменения
delay(2000);
// ------------------------------------------
// Для ускорения ручных заливок (ускорения расчёта цвета) можно создать переменную типа mData
mData value1, value2;
value1 = mHSV(60, 100, 255);
value2 = mHSV(190, 255, 190);
for (int i = 0; i < NUMLEDS; i++) {
if (i < NUMLEDS / 2) strip.leds[i] = value1;  // первая половина ленты
else strip.leds[i] = value2;                  // вторая половина ленты
}
strip.show(); // выводим изменения
delay(2000);
// ------------------------------------------
// в цикле можно менять параметры генерации цвета. Например, сделаем радугу
for (int i = 0; i < NUMLEDS; i++) strip.set(i, mWheel8(i * 255 / NUMLEDS)); // полный круг от 0 до 255
strip.show(); // выводим изменения
delay(2000);
// или градиент от красного к чёрному (последовательно меняя яркость)
for (int i = 0; i < NUMLEDS; i++) strip.set(i, mWheel8(0, i * 255 / NUMLEDS)); // полный круг от 0 до 255
strip.show(); // выводим изменения
}
void loop() {
}