🌈 Проект: цветовой индикатор уровня на RGB-светодиоде KY-016, управляемый потенциометром

RGB-светодиод KY-016, уже встречавшийся в других проектах на сайте как вспомогательный индикатор, здесь становится главным героем: потенциометр плавно двигает цвет от зелёного через жёлтый к красному, как цветовая шкала уровня — похожая на индикаторы заряда или громкости во многих бытовых приборах.

Как это работает

Потенциометр подключён как обычный делитель напряжения, и его положение считывается через `analogRead()` как число от 0 до 1023. Вместо того чтобы напрямую управлять яркостью одного канала, как в большинстве других проектов с RGB-светодиодами на сайте, здесь это число используется для плавного смешивания ДВУХ каналов одновременно: в начале диапазона горит только зелёный канал, затем к нему постепенно добавляется красный (давая жёлтый как их смесь), и к концу диапазона зелёный канал гаснет, оставляя чистый красный.

Это классический приём отображения "уровня" цветом (зелёный = хорошо, жёлтый = внимание, красный = критично), который используется гораздо шире, чем просто для потенциометров — тот же принцип подойдёт для отображения любого измеренного уровня (заряда батареи, температуры, расстояния) из других проектов на сайте, если заменить `analogRead()` потенциометра на реальные показания соответствующего датчика.

Пошаговая сборка

Так как реализации данного модуля бывают разные, если у вас на плате нет тех контактов, которые указаны ниже — сориентируйтесь по названиям контактов на своей плате.

Потенциометр: средний вывод → A0, крайние выводы → 5V и GND.
RGB-светодиод KY-016: R → D9, G → D10, каждый через свой токоограничивающий резистор (обычно 220-330 Ом), если на самой плате модуля их нет.
Общий вывод светодиода подключите к GND или 5V в зависимости от типа вашего экземпляра (общий катод или общий анод) — при общем аноде логику ШИМ в коде нужно будет инвертировать.

Скетч

// ВНИМАНИЕ: рекомендую отладить код через монитор порта, так как я языковая
// модель, а не специализированный кодер, и могу что-то упустить. Основу
// и идею я накидал, но проверьте под свою схему. Логика ниже рассчитана
// на светодиод с общим катодом — для общего анода инвертируйте значения ШИМ.

const int POT_PIN = A0;
const int RED_PIN = 9;
const int GREEN_PIN = 10;

void setup() {
  Serial.begin(9600);
}

void loop() {
  int level = analogRead(POT_PIN); // 0-1023

  int redValue;
  int greenValue;

  if (level < 512) {
    // первая половина диапазона: зелёный горит на максимум, красный плавно растёт от 0
    greenValue = 255;
    redValue = map(level, 0, 511, 0, 255);
  } else {
    // вторая половина: красный на максимуме, зелёный плавно гаснет до 0
    redValue = 255;
    greenValue = map(level, 512, 1023, 255, 0);
  }

  analogWrite(RED_PIN, redValue);
  analogWrite(GREEN_PIN, greenValue);

  delay(50);
}

Дополнительных библиотек не требуется — только встроенные `analogRead()`, `map()` и `analogWrite()`. Если цвета выглядят "вывернутыми" (красный горит, где должен быть зелёный, и наоборот) — у вас, скорее всего, светодиод с общим анодом; замените каждое значение ШИМ на `255 - значение`.

Частые проблемы

Цвет не меняется совсем — проверьте подключение потенциометра (крайние выводы к 5V/GND, средний к A0) и резисторы на линиях R/G.
Виден только зелёный или только красный, без промежуточного жёлтого — проверьте, что оба пина действительно ШИМ-способные на вашей плате.
Цвета выглядят перепутанными местами — скорее всего, светодиод с общим анодом вместо общего катода; инвертируйте значения ШИМ (`255 - значение`).
Переход между зелёным и жёлтым выглядит неравномерным на глаз — человеческое восприятие яркости нелинейно; для более равномерного на глаз перехода можно использовать не линейный `map()`, а таблицу гамма-коррекции.

Как улучшить проект

Добавить третий канал (синий) для более широкой палитры, если нужна не только зелёно-красная шкала.
Заменить потенциометр на реальный датчик из другого проекта на сайте (температура, расстояние, уровень шума) для настоящего цветового индикатора измеренной величины.
Добавить резкий переход в мигающий красный при самых критичных значениях, а не только плавный цвет.