Урок 2. Структура скетча: setup(), loop() и комментарии

// Однострочный комментарий. Начинается с двух слешей, и после них в этой строке можно писать что угодно на любом языке.

/*
   Многострочный комментарий.
   Такие используют, если нужно закомментировать много строк текста или кода.
   digitalWrite(5, HIGH); - этот код не будет выполняться, потому что он внутри комментария.
*/

pinMode(3, INPUT); // Можно комментарий написать в конце строки после кода, код будет работать и комментарий не помешает.

void setup(){
   // Здесь будем писать функции инициализации библиотек, обозначения пинов и т.д.
   // Обычно в функции SETUP пишут такой код:
   pinMode(3, OUTPUT); // Говорим программе, что пин D3 платы будет использоваться в режиме вывода сигнала - OUT put.
   Serial.begin(9600); // Говорим программе, что мы будем использовать передачу данных по Serial (технология передачи данных по двум проводам - UART, Serial).
   int svetodiod = 5; // Можно создать переменную
}

/*
  Blink - Мигание

  Turns an LED on for one second, then off for one second, repeatedly.
  Включает светодиод на одну секунду, затем выключает на одну секунду, и так повторяется бесконечно.

  Most Arduinos have an on-board LED you can control. On the UNO, MEGA and ZERO
  it is attached to digital pin 13, on MKR1000 on pin 6. LED_BUILTIN is set to
  the correct LED pin independent of board which is what you should use.
  На многих ардуинах есть светодиод, которым можно управлять. На ардуино уно, мега и зеро
  светодиод подключен к пину 13, на плате MKR1000 - к пину 6. Для простоты использования этого светодиода
  в среде Arduino IDE добавлена константа LED_BUILTIN, в которой записан номер пина, к которому подключен
  светодиод на выбранной в настройках плате.

  The Arduino Nano 33 BLE Sense has an internal RGB LED, but you can connect an
  external LED to any digital pin.
  На Arduino Nano 33 BLE Sense есть встроенный трёхцветный RGB светодиод,
  но этот скетч может управлять одноцветным светодиодом на любом пине.

  modified 8 May 2014
  by Scott Fitzgerald
  modified 2 Sep 2016
  by Arturo Guadalupi
  modified 8 Sep 2016
  by Colby Newman

  This example code is in the public domain.
  Этот скетч-пример доступен на официальном сайте Arduino.

  https://www.arduino.cc/en/Tutorial/BuiltInExamples/Blink
*/

// the setup function runs once when you press reset or power the board - в функции настроек, setup(), настраиваем пин со светодиодом на выход сигнала
void setup() {
  // initialize digital pin LED_BUILTIN as an output. - включаем цифровой пин LED_BUILTIN на выход сигнала
  pinMode(LED_BUILTIN, OUTPUT);
}

// the loop function runs over and over again forever - цикличная функция loop() крутится в цикле по кругу, бесконечно
void loop() {
  digitalWrite(LED_BUILTIN, HIGH);   // turn the LED on (HIGH is the voltage level) - включаем светодиод, подаём напряжение на пин
  delay(1000);                       // wait for a second - ждём секунду, то есть одну тысячу миллисекунд. 1 сек - 1000 мсек
  digitalWrite(LED_BUILTIN, LOW);    // turn the LED off (LOW is the voltage level) - выключаем светодиод, убирая напряжение
  delay(1000);                       // wait for a second - ждём секунду.
}

/*
  Мигаем тремя встроенными светодиодами:
  - L (пин 13)  -> зажигается от HIGH
  - RX (пин 0)  -> зажигается от LOW
  - TX (пин 1)  -> зажигается от LOW
  
  Эффекты: 1) все сразу, 2) волна вперёд, 3) волна назад
*/

// Пины встроенных светодиодов
#define LED_L   13  // Встроенный светодиод (зажигается от HIGH)
#define LED_RX  0   // RX светодиод (зажигается от LOW)
#define LED_TX  1   // TX светодиод (зажигается от LOW)

// Массив пинов для удобства перебора
byte pins[] = {LED_L, LED_RX, LED_TX};
int pinCount = 3;

// Тайминг
unsigned long effectStartTime = 0;
int currentEffect = 0;        // 0 - все сразу, 1 - волна вперёд, 2 - волна назад
int step = 0;
unsigned long effectDuration = 5000; // 5 секунд на эффект

void setup() {
  // Настраиваем все пины как выходы
  for (int i = 0; i < pinCount; i++) {
    pinMode(pins[i], OUTPUT);
  }
  
  // Гасим все при старте
  allOff();
  
  effectStartTime = millis();
}

void loop() {
  unsigned long currentTime = millis();
  
  // Переключение эффектов каждые 5 секунд
  if (currentTime - effectStartTime >= effectDuration) {
    effectStartTime = currentTime;
    currentEffect = (currentEffect + 1) % 3;
    step = 0;
    allOff();
  }
  
  switch (currentEffect) {
    case 0:
      effectAllTogether();
      break;
    case 1:
      effectWaveForward();
      break;
    case 2:
      effectWaveBackward();
      break;
  }
}

// ---- ВКЛЮЧЕНИЕ/ВЫКЛЮЧЕНИЕ с учётом полярности ----
void setLED(int pin, bool state) {
  if (pin == LED_L) {
    // L светодиод: HIGH = ВКЛ, LOW = ВЫКЛ
    digitalWrite(pin, state ? HIGH : LOW);
  } else {
    // RX и TX: LOW = ВКЛ, HIGH = ВЫКЛ (инвертированы)
    digitalWrite(pin, state ? LOW : HIGH);
  }
}

// ---- ПОГАСИТЬ ВСЕ ----
void allOff() {
  setLED(LED_L, false);
  setLED(LED_RX, false);
  setLED(LED_TX, false);
}

// ---- ЭФФЕКТ 1: Все сразу мигают ----
void effectAllTogether() {
  static bool ledState = LOW;
  static unsigned long lastToggle = 0;
  
  if (millis() - lastToggle >= 200) { // Мигаем каждые 200 мс
    lastToggle = millis();
    ledState = !ledState;
    
    setLED(LED_L, ledState);
    setLED(LED_RX, ledState);
    setLED(LED_TX, ledState);
  }
}

// ---- ЭФФЕКТ 2: Волна вперёд (L -> RX -> TX) ----
void effectWaveForward() {
  static unsigned long lastStep = 0;
  
  if (millis() - lastStep >= 150) { // Шаг каждые 150 мс
    lastStep = millis();
    
    // Гасим все
    allOff();
    
    // Зажигаем текущий светодиод
    switch (step) {
      case 0: setLED(LED_L, true); break;   // Сначала L
      case 1: setLED(LED_RX, true); break;  // Потом RX
      case 2: setLED(LED_TX, true); break;  // Потом TX
    }
    
    step++;
    if (step >= pinCount) {
      step = 0;
    }
  }
}

// ---- ЭФФЕКТ 3: Волна назад (TX -> RX -> L) ----
void effectWaveBackward() {
  static unsigned long lastStep = 0;
  
  if (millis() - lastStep >= 150) {
    lastStep = millis();
    
    allOff();
    
    // Зажигаем в обратном порядке
    switch (step) {
      case 0: setLED(LED_TX, true); break;  // Сначала TX
      case 1: setLED(LED_RX, true); break;  // Потом RX
      case 2: setLED(LED_L, true); break;   // Потом L
    }
    
    step++;
    if (step >= pinCount) {
      step = 0;
    }
  }
}