Библиотека Arduino для мигания светодиодами

 

ledOn();                // светодиод включен
ledOff();               // светодиод выключен
flashSet(3, 100, 500);  // светодиод мигнет три раза с длительностью 100 мс с паузой между вспышками по 500 мс, после чего погаснет
blinkSet(2, 100, 5000); // светодиод начинает мигать сериями из 2 вспышек с длительностью 100 мс и паузой между сериями 5000 мс
ledOn();                // светодиод включен, мигание временно приостановлено
ledOff();               // возвращаемся к последнему режим мигания (сериями из 2-х миганий по 100 мс через 5 секунд)
flashSet(30, 100, 500); // светодиод мигнет 30 раз с длительностью 100 мс с паузой между вспышками 500 мс
                        // после чего снова автоматически возвращаемся в последний режим мигания (сериями из 2-х миганий по 100 мс через 5 секунд)
ledOff();               // ничего не изменится ;-)
blinkSet(1, 500, 500);  // изменение режима мигания - непрерывное равномерное мигание 0,5 с горит / 0,5 с не горит
blinkOff();             // отключить режим мигания, светодиод выключен

Разумеется, между командами должны быть какие-нибудь промежутки времени, чтобы светодиод успел отработать команды. Без этих пауз светодиод сразу выполнит их все и выключится (последняя команда).

---

Видео, демонстрирующее работу библиотеки:

Видео было записано на версии для ESP32, но на других контроллерах все выглядит точно также.

• Красный светодиод на видео – “системный”. Он отображает “общее” состояние устройства. При включении имитирует подключение к WiFi (равномерное мигание). После соединения с WiFi (через 10 секунд) переходит в режим “проверка интернета / нет интернета” (две вспышки – пауза, две вспышки – пауза и т.д.). Еще через 5 секунд переходит в нормальный режим (редкие вспышки). Еще через некоторое время светодиод мигнет однократной серией для отображения передачи данных в эфир и вернется в “нормальный” режим.
• Синий светодиод просто мигает с частотой 1 Гц (0,5 секунды вспышка + 0,5 секунды пауза)
• Желтый светодиод тоже мигает постоянно, но уже длительность паузы в 4 раза больше длительности вспышки.
• Зеленый светодиод мигает сериями по 3 коротких (100 мс) вспышки через каждые 2 секунды.

Пример работы на реальном проекте: WiFi-сигнализации

• Синий светодиод – системный. Редкие вспышки – признак нормальной работы устройства. Короткие серии 3*75мс – передача данных на MQTT брокер, их видно при переключении режимов.
• Красный светодиод – отображает прием управляющих команд с приемника 433 MHz
• Извещатель (сирена + мигалка) подключен через ключи на биполярных транзисторах, но суть та же. Отображает тревоги (равномерное мигание) и переключение режимов (серии с разным количеством вспышек).

---

Демонстрационный проект

Подходит как для PlatfromIO, так и для Arduino IDE (скачать архив вместе с вложенной библиотекой можно в конце статьи)

#include "rLed.h"
#include "rLedSys.h"

rLed ledBlue(D3, true);
int step = 0;

void setup() {
  Serial.begin(74880);

  Serial.println("ledSystem: Connect to WiFi...");
  ledSysInit(D4, false, false, NULL);
  ledSysBlinkAuto();

  Serial.println("ledBlue: Init LED & turn on");
  ledBlue.initGPIO();
  ledBlue.ledOn();
}

void loop() {
  ledSysLoop();
  ledBlue.ledLoop();

  if (step == 0 && millis() > 5000) {
    step = 1;
    Serial.println("ledSystem: Connected to WiFi, retrive SNTP time...");
    ledSysStateSet(SYSLED_WIFI_CONNECTED);

    Serial.println("ledBlue: Set blink mode");
    ledBlue.blinkSet(3, 100, 1000);  
  };
  
  if (step == 1 && millis() > 25000) {
    step = 2;
    Serial.println("ledSystem: Connected to WiFi, all OK...");
    ledSysStateSet(SYSLED_WIFI_INET_AVAILABLE);

    Serial.println("ledBlue: Set flash mode");
    ledBlue.flashSet(10, 100, 300);  
  };
  
  if (step == 2 && millis() > 60000) {
    step = 3;

    Serial.println("ledSystem: set error...");
    ledSysStateSet(SYSLED_ERROR);

    Serial.println("ledBlue: Disable LED");
    ledBlue.ledEnabled(false);  
  };
  
  if (step == 3 && millis() > 90000) {
    Serial.println("ledSystem: clear error...");
    ledSysStateClear(SYSLED_ERROR);

    Serial.println("ledBlue: Enable LED");
    step = 4;
    ledBlue.ledEnabled(true);  
  };
}

 

Описание функций

Для создания экземпляра класса rLed используйте конструктор:

rLed(const int8_t ledGPIO, const bool ledHigh);

где: ledGPIO – номер вывода, к которому подключен светодиод. ledHigh – true = включение с помощью установки на GPIO высокого уровня, false = с помощью установки на GPIO низкого уровня.

Если необходимо использовать функцию обратного вызова, укажите ее дополнительно через setCustomControl(const ledCustomControl_t customControl).

Для инициализации GPIO на вывод используйте функцию initGPIO(). Но можно этого не делать, она будет вызвана автоматически при первом обращении к светодиоду. При использовании customControl инициализация порта не производится, Вы должны сделать это самостоятельно.

После этого можно использовать остальные публичные методы для изменения режимов:

void ledEnabled(const bool newEnabled);
void ledOn();
void ledOff();
void blinkOn(const ledMode_t newMode, const uint16_t blinkQuantity, const uint16_t blinkDuration, const uint16_t blinkInterval);
void blinkSet(const uint16_t blinkQuantity, const uint16_t blinkDuration, const uint16_t blinkInterval);
void flashSet(const uint16_t flashQuantity, const uint16_t flashDuration, const uint16_t flashInterval);
void blinkOff();

Самое главное – не забудьте добавить ledLoop() в Вашу главную функцию loop()!

Изменение режимов мигания для системного светодиода может быть осуществлено с помощью макросов предпроцессора, определенных в файле project_config.h. Файл project_config.h может отсутствовать, в этом случае будут использованы значения по умолчанию. Необходимо, чтобы этот файл при компиляции был доступен не только из главного скетча, но и из библиотек.

В PlatformIO можно указать компилятору, где искать файл project_config.h, с помощью опции build_flags = -Iкаталог в platformio.ini. Например, я поместил project_config.h в подкаталог src (там же, где и основной файл проекта). В этом случае я добавлю в platformio.ini следующие строки:

[env]
build_flags = -Isrc

В Arduino IDE я пока не нашел другого способа, кроме как скопировать исходники библиотек и project_config.h в тот же каталог, где и располагается сам скетч. Это не очень удобно, но Arduino IDE и сама по себе не самый удобный инструмент.

---

Скачать библиотеку можно с помощью кнопки:

В архиве Вы также найдете примеры скетча для Arduino IDE и PlatformIO – загляните в папку examples

Версия для ESP32:

То же самое, но реализовано в виде задачи FreeRTOS. Читать здесь.

 

---

✳️ Другие мои библиотеки для PlatformIO и ArduinoIDE

Благодарю за внимание.