Руководства · 8 мин чтения

Веб-сервер ESP32 для RGB-светодиода: выбирай цвет с телефона

Собери веб-сервер ESP32 для RGB-светодиода и задавай цвет через палитру телефона: схема с общим анодом и катодом, HEX в RGB, ШИМ LEDC, гамма и WS2812B.

Веб-сервер ESP32 для RGB-светодиода позволяет менять цвет светодиода без установки приложений: ESP32 отдаёт маленькую веб-страницу, ты выбираешь оттенок в палитре, которая открывается в браузере телефона, и светодиод сразу меняет цвет. За кадром происходят три вещи: браузер превращает твой выбор в HEX-код вроде #FF8800 и отправляет его по Wi-Fi, ESP32 разбивает этот код на три числа для красного, зелёного и синего, а каждое число становится ШИМ-сигналом от периферии LEDC.

В этом руководстве ты узнаешь, как подключить RGB-светодиод с общим катодом или общим анодом к ESP32, какие резисторы подходят для 3,3 V, как написать код LEDC, работающий и на ядре ESP32 Arduino 2.x, и на 3.x, как перевести HEX в RGB и как гамма-коррекция делает цвета такими, какими их ждёт глаз. В конце ты подключишь тот же интерфейс телефона к светодиодной ленте WS2812B, не меняя ни строчки HTML.

Четырёхвыводной RGB-светодиод
RGB-светодиод: в одном корпусе три светодиода, красный, зелёный и синий; самый длинный вывод общий.

Как это работает? От палитры до светодиода

  1. Телефон подключён к той же сети Wi-Fi, что и ESP32; ты открываешь IP-адрес ESP32 в браузере, и он отдаёт маленькую HTML-страницу с палитрой.
  2. Элемент <input type="color"> на странице открывает встроенную палитру телефона и возвращает выбор в формате #ff8800.
  3. Несколько строк JavaScript отправляют это значение на /set?hex=ff8800; пока ты ведёшь пальцем, новые цвета уходят один за другим.
  4. ESP32 разбивает шесть цифр на три числа, 255, 136 и 0, и применяет к каждому гамма-коррекцию.
  5. LEDC выдаёт ШИМ 5 kHz на трёх выводах; коэффициент заполнения задаёт яркость каждого цвета, а глаз смешивает три света в один оттенок.

Список деталей

  • Отладочная плата ESP32 DevKit (30 или 38 выводов)
  • Один RGB-светодиод (5 мм, с общим катодом или общим анодом)
  • Резистор 150 Ω для красного и резисторы 100 Ω для зелёного и синего (подойдут и три резистора по 220 Ω, если есть только они)
  • Макетная плата и несколько проводов-перемычек
  • USB-кабель, передающий данные
  • По желанию: лента WS2812B, блок питания 5 V, резистор 330 Ω и конденсатор 1000 µF

Общий катод или общий анод: таблица подключения

У четырёхвыводных RGB-светодиодов самый длинный вывод общий. У светодиода с общим катодом (CC) он идёт на GND, а цвет загорается, когда на его выводе HIGH. У светодиода с общим анодом (CA) общий вывод идёт на напряжение питания, а цвет горит, когда на его выводе LOW. Если не знаешь, какой у тебя, подключи самый длинный вывод к GND, а другой вывод к 3V3 через резистор 150 Ω: если загорелся, светодиод с общим катодом. Если нет, поменяй подключение местами; если теперь горит, это общий анод. У большинства моделей порядок выводов от плоской стороны такой: красный, общий, зелёный, синий.

ВыводОбщий катод (CC)Общий анод (CA)Резистор
Красный (R)GPIO 25GPIO 25150 Ω
Общий вывод (самый длинный)GND3V3Нет
Зелёный (G)GPIO 26GPIO 26100 Ω
Синий (B)GPIO 27GPIO 27100 Ω
Настройка в кодеCOMMON_ANODE = falseCOMMON_ANODE = trueНет
Заполнение для цвета на полной яркости1023 (максимум)0 (код инвертирует сам)Нет
Общий вывод светодиода с общим анодом подключай к выводу 3V3 ESP32, а не к 5V. При 5 V на светодиоде остаётся около 1,7 V даже при HIGH на выводе: красный тускло светится, а ток через защитные диоды течёт обратно в вывод 3,3 V и постепенно его портит.

Расчёт резистора — простое применение закона Ома: R = (3,3 V − напряжение светодиода) / ток. Красному светодиоду нужно около 2,0 V; со 150 Ω ток равен (3,3 − 2,0) / 150 ≈ 8,7 mA. Зелёные и синие светодиоды работают примерно при 2,8–3,1 V, так что при 3,3 V запаса почти нет; со 100 Ω течёт от 3 до 5 mA, и цвета достаточно яркие. С 220 Ω на всех трёх выводах схема всё равно работает, но синий и зелёный заметно тусклее, а белый уходит в розовый. Чтобы посчитать для своего светодиода, воспользуйся калькулятором резистора для светодиода. Не бери с вывода ESP32 больше 20 mA постоянно.

ШИМ LEDC на ESP32: три канала, 5 kHz, 10 бит

На ESP32 аналог analogWrite из Arduino Uno — периферия LEDC. У классического ESP32 16 независимых каналов ШИМ, и для каждого можно выбрать частоту и разрешение. В этом проекте 5 kHz и 10 бит: 10 бит означают, что заполнение идёт от 0 до 1023, и переходы получаются гораздо плавнее, чем с 8 битами, особенно в тёмных оттенках. 5 kHz достаточно, чтобы мерцания не видели ни глаз, ни большинство камер телефонов. Подвох в одном: функции LEDC изменились в версии 3.0 ядра ESP32 Arduino, поэтому много старого кода из интернета на свежей установке уже не компилируется. Скетчи ниже проверяют константу ESP_ARDUINO_VERSION_MAJOR и работают на обеих версиях. Основы — в руководстве что такое ШИМ.

Версия ядраНастройкаЗапись значения
3.x (текущая)ledcAttach(pin, 5000, 10)ledcWrite(вывод, duty)
2.x (старая)ledcSetup(канал, 5000, 10) и ledcAttachPin(вывод, канал)ledcWrite(канал, duty)

Сначала проверь подключение

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

C++ (Arduino IDE)
1// RGB LED bağlantı testi: kırmızı, yeşil, mavi, beyaz, kapalı
2// RGB LED wiring test: red, green, blue, white, off
3const int PINS[3] = {25, 26, 27};       // R, G, B pinleri / R, G, B pins
4const bool COMMON_ANODE = false;        // ortak anot ise true / true for common anode
5const int PWM_FREQ = 5000;              // 5 kHz, titreme yok / 5 kHz, no flicker
6const int PWM_BITS = 10;                // 0-1023
7const int PWM_MAX = (1 << PWM_BITS) - 1;
8
9void pwmSetup() {
10  for (int i = 0; i < 3; i++) {
11#if ESP_ARDUINO_VERSION_MAJOR >= 3
12    ledcAttach(PINS[i], PWM_FREQ, PWM_BITS);   // çekirdek 3.x: pin tabanlı / core 3.x: pin based
13#else
14    ledcSetup(i, PWM_FREQ, PWM_BITS);          // çekirdek 2.x: kanal i / core 2.x: channel i
15    ledcAttachPin(PINS[i], i);
16#endif
17  }
18}
19
20void pwmWrite(int i, int duty) {
21  if (COMMON_ANODE) duty = PWM_MAX - duty;     // ortak anotta mantık ters / logic is inverted for common anode
22#if ESP_ARDUINO_VERSION_MAJOR >= 3
23  ledcWrite(PINS[i], duty);
24#else
25  ledcWrite(i, duty);
26#endif
27}
28
29void setRaw(int r, int g, int b) {      // gamasız ham değer / raw duty, no gamma
30  pwmWrite(0, r);
31  pwmWrite(1, g);
32  pwmWrite(2, b);
33}
34
35void setup() {
36  pwmSetup();
37}
38
39void loop() {
40  setRaw(PWM_MAX, 0, 0);             delay(1000);   // kırmızı / red
41  setRaw(0, PWM_MAX, 0);             delay(1000);   // yeşil / green
42  setRaw(0, 0, PWM_MAX);             delay(1000);   // mavi / blue
43  setRaw(PWM_MAX, PWM_MAX, PWM_MAX); delay(1000);   // beyaz / white
44  setRaw(0, 0, 0);                   delay(1000);   // kapalı / off
45}

Перевод HEX-кода цвета в RGB

В вебе цвета записываются как #RRGGBB: первые две цифры — значение красного, следующие две — зелёного, последние две — синего, каждое от 0 до 255 в шестнадцатеричной системе. В #FF8800 FF = 255, 88 = 8 × 16 + 8 = 136 и 00 = 0, то есть полный красный, немного зелёного и без синего: оранжевый. Код делает это в два шага: strtol(hex, NULL, 16) превращает шестизначный текст в одно число (0xFF8800), затем сдвиг битов и маска выделяют три байта: (rgb >> 16) & 0xFF для красного, (rgb >> 8) & 0xFF для зелёного и rgb & 0xFF для синего.

HEXКрасныйЗелёныйСинийЦвет
#FF000025500Красный
#00FF0002550Зелёный
#0000FF00255Синий
#FF88002551360Оранжевый
#8000801280128Фиолетовый
#FFFFFF255255255Белый
#000000000Выключен

Гамма-коррекция: почему цвета выглядят блёклыми?

Глаз воспринимает яркость нелинейно: в темноте он отлично замечает мелкие изменения, а на ярком свету с трудом различает даже большие шаги. Поэтому заполнение 50 % уже выглядит почти как полная яркость, а пастельные оттенки, которые ты выбираешь на экране, на светодиоде превращаются в блёклые, почти белые цвета. Решение — применить к каждому каналу гамма-коррекцию: выход = максимум × (вход / 255)^2,2. Экраны используют ту же кривую, поэтому после коррекции цвет на телефоне и цвет светодиода совпадают гораздо лучше. Таблица показывает, как сильно кривая сжимает тёмные оттенки и почему помогают 10 бит:

Выбранное значение (0–255)8-битный ШИМ (0–255)10-bit PWM (0–1023)
1612
32311
641249
12856225
192137548
2552551023

Основной скетч: веб-сервер с палитрой для телефона

Основной скетч использует библиотеку WebServer, которая идёт вместе с ядром ESP32, так что ставить ничего не нужно. Впиши имя сети и пароль, загрузи скетч и открой монитор порта на 115200 baud. Через несколько секунд появится адрес вроде http://192.168.1.45; открой его в браузере телефона, подключённого к той же сети Wi-Fi. ESP32 подключается только к сетям 2,4 GHz, и телефон должен быть в той же сети.

C++ (Arduino IDE)
1// ESP32 RGB LED: telefondaki renk seçiciden Wi-Fi ile renk ayarı
2// ESP32 RGB LED: set the colour over Wi-Fi from a colour picker on your phone
3#include <WiFi.h>
4#include <WebServer.h>
5#include <math.h>
6
7const char* WIFI_SSID = "AgAdi";        // Wi-Fi adın / your Wi-Fi name
8const char* WIFI_PASS = "Sifre123";     // Wi-Fi şifren / your Wi-Fi password
9
10const int PINS[3] = {25, 26, 27};       // R, G, B pinleri / R, G, B pins
11const bool COMMON_ANODE = false;        // ortak anot ise true / true for common anode
12const int PWM_FREQ = 5000;              // 5 kHz, titreme yok / 5 kHz, no flicker
13const int PWM_BITS = 10;                // 0-1023, koyu tonlar daha yumuşak / smoother dark tones
14const int PWM_MAX = (1 << PWM_BITS) - 1;
15const float GAMMA = 2.2;                // algısal parlaklık düzeltmesi / perceptual correction
16
17WebServer server(80);
18String currentHex = "000000";           // son seçilen renk / last chosen colour
19
20// Telefonda açılan sayfa / the page opened on the phone
21const char PAGE[] PROGMEM = R"rawliteral(
22<!DOCTYPE html><html><head><meta charset="utf-8">
23<meta name="viewport" content="width=device-width,initial-scale=1">
24<title>ESP32 RGB</title>
25<style>
26body{font-family:sans-serif;text-align:center;background:#111;color:#eee;margin-top:40px}
27input[type=color]{width:200px;height:200px;border:none;background:none}
28button{font-size:18px;padding:10px 20px;margin:6px}
29</style></head><body>
30<h2>ESP32 RGB LED</h2>
31<input type="color" id="c" value="#%HEX%">
32<p id="t">#%HEX%</p>
33<button onclick="pick('#000000')">Kapat / Off</button>
34<button onclick="pick('#ffffff')">Beyaz / White</button>
35<button onclick="pick('#ff8800')">Turuncu / Orange</button>
36<script>
37let busy = false, next = null;
38function send(h) {
39  if (busy) { next = h; return; }
40  busy = true;
41  fetch('/set?hex=' + h.substring(1)).finally(() => {
42    busy = false;
43    if (next) { const n = next; next = null; send(n); }
44  });
45}
46function show(h) { document.getElementById('t').textContent = h; send(h); }
47function pick(h) { document.getElementById('c').value = h; show(h); }
48document.getElementById('c').addEventListener('input', e => show(e.target.value));
49</script></body></html>
50)rawliteral";
51
52void pwmSetup() {
53  for (int i = 0; i < 3; i++) {
54#if ESP_ARDUINO_VERSION_MAJOR >= 3
55    ledcAttach(PINS[i], PWM_FREQ, PWM_BITS);   // çekirdek 3.x: pin tabanlı / core 3.x: pin based
56#else
57    ledcSetup(i, PWM_FREQ, PWM_BITS);          // çekirdek 2.x: kanal i / core 2.x: channel i
58    ledcAttachPin(PINS[i], i);
59#endif
60  }
61}
62
63void pwmWrite(int i, int duty) {
64  if (COMMON_ANODE) duty = PWM_MAX - duty;     // ortak anotta mantık ters / logic is inverted for common anode
65#if ESP_ARDUINO_VERSION_MAJOR >= 3
66  ledcWrite(PINS[i], duty);
67#else
68  ledcWrite(i, duty);
69#endif
70}
71
72int gammaCorrect(int v) {                       // 0-255 -> 0-PWM_MAX
73  return (int)(pow(v / 255.0, GAMMA) * PWM_MAX + 0.5);
74}
75
76void setColor(int r, int g, int b) {
77  pwmWrite(0, gammaCorrect(r));
78  pwmWrite(1, gammaCorrect(g));
79  pwmWrite(2, gammaCorrect(b));
80}
81
82bool isHex6(const String& s) {                  // tam 6 onaltılık hane mi? / exactly 6 hex digits?
83  if (s.length() != 6) return false;
84  for (int i = 0; i < 6; i++) {
85    if (!isxdigit((unsigned char)s[i])) return false;
86  }
87  return true;
88}
89
90void handleRoot() {
91  String page(PAGE);
92  page.replace("%HEX%", currentHex);            // sayfa son renkle açılsın / open with the last colour
93  server.send(200, "text/html", page);
94}
95
96void handleSet() {
97  String hex = server.arg("hex");               // örnek / example: ff8800
98  if (!isHex6(hex)) {
99    server.send(400, "text/plain", "hex?");
100    return;
101  }
102  long rgb = strtol(hex.c_str(), NULL, 16);     // "ff8800" -> 0xFF8800
103  int r = (rgb >> 16) & 0xFF;                   // 255
104  int g = (rgb >> 8) & 0xFF;                    // 136
105  int b = rgb & 0xFF;                           // 0
106  setColor(r, g, b);
107  currentHex = hex;
108  server.send(200, "text/plain", "OK");
109}
110
111void setup() {
112  Serial.begin(115200);
113  pwmSetup();
114  setColor(0, 0, 0);
115  WiFi.mode(WIFI_STA);
116  WiFi.begin(WIFI_SSID, WIFI_PASS);
117  while (WiFi.status() != WL_CONNECTED) {
118    delay(500);
119    Serial.print(".");
120  }
121  WiFi.setSleep(false);                         // daha hızlı yanıt / faster response
122  Serial.println();
123  Serial.print("Telefonda aç / open on your phone: http://");
124  Serial.println(WiFi.localIP());
125  server.on("/", handleRoot);
126  server.on("/set", handleSet);
127  server.begin();
128}
129
130void loop() {
131  server.handleClient();
132}

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

ЧастьЧто делает
PAGEHTML, CSS и JavaScript, которые уходят на телефон; R"rawliteral(...)" позволяет писать их без экранирования кавычек
input type="color"Открывает встроенную палитру телефона и возвращает выбор в виде #rrggbb
send() и busyОтправляет только один запрос за раз; из цветов, накопившихся, пока ты ведёшь пальцем, уходит только последний
/set?hex=ff8800Запрос, который приходит на ESP32; на него отвечает handleSet()
isHex6()Проверяет, что текст состоит ровно из шести шестнадцатеричных цифр, и отклоняет кривые запросы
strtol и сдвиг битовПревращают текст в число и разделяют байты красного, зелёного и синего
gammaCorrect()Переводит значение 0–255 в 0–1023 по гамма-кривой 2,2
pwmWrite()Инвертирует значение для общего анода и вызывает нужный ledcWrite для версии ядра
%HEX%Показывает последний цвет при каждом открытии страницы, чтобы и второй телефон видел текущий цвет
WiFi.setSleep(false)Отключает энергосбережение Wi-Fi, чтобы смена цвета приходила без задержки
Пока ты ведёшь пальцем по палитре, браузер генерирует десятки событий input в секунду. Если отправлять их все разом, маленький веб-сервер ESP32 захлёбывается и цвета отстают. Флаг busy в коде не отправляет новый запрос, пока не завершился предыдущий, а из накопившихся значений отправляет только последнее; так светодиод следует за пальцем без задержки. Добавь страницу на главный экран телефона, и она будет открываться одним касанием, как приложение.

Тот же интерфейс с лентой WS2812B

Если хочешь управлять лентой из десятков светодиодов вместо одного RGB-светодиода, HTML и веб-сервер трогать не нужно; меняются только функции, управляющие светодиодом. У каждого светодиода WS2812B свой чип-драйвер, поэтому хватает одного вывода данных. Подключи вход DIN ленты к GPIO 13 через резистор 330 Ω, питай ленту от отдельного блока на 5 V и соедини GND блока с GND ESP32. Каждый светодиод на полном белом берёт около 60 mA; лента из 30 светодиодов может дойти до 1,8 A, поэтому код ограничивает яркость до 80/255. Конденсатор 1000 µF на клеммах питания защищает светодиоды от броска тока при включении. При ленте на 5 V сигнала данных 3,3 V от ESP32 обычно хватает; если появляется мерцание или случайные цвета, добавь преобразователь уровня вроде 74AHCT125. Подробности про ленту — в руководстве WS2812B NeoPixel. Вставь фрагмент ниже вместо четырёх функций светодиода в основном скетче и установи библиотеку Adafruit NeoPixel через менеджер библиотек:

C++ (Arduino IDE)
1// WS2812B şerit: ana koddaki pwmSetup, pwmWrite, gammaCorrect ve setColor yerine bunu koy
2// WS2812B strip: use this instead of pwmSetup, pwmWrite, gammaCorrect and setColor in the main sketch
3#include <Adafruit_NeoPixel.h>
4
5const int STRIP_PIN = 13;               // DIN, 330 Ω direnç üzerinden / through a 330 Ω resistor
6const int NUM_LEDS = 30;                // şeritteki LED sayısı / number of LEDs on the strip
7Adafruit_NeoPixel strip(NUM_LEDS, STRIP_PIN, NEO_GRB + NEO_KHZ800);
8
9void pwmSetup() {                       // adı aynı, setup() değişmez / same name, setup() stays as is
10  strip.begin();
11  strip.setBrightness(80);              // akımı sınırla / limit the current
12}
13
14void setColor(int r, int g, int b) {
15  strip.fill(strip.gamma32(strip.Color(r, g, b)));   // kütüphanenin gama tablosu / the library's gamma table
16  strip.show();
17}
Адресуемый RGB-светодиод WS2812B
WS2812B: в каждом светодиоде свой чип-драйвер, поэтому одна линия данных задаёт цвет сотен светодиодов по отдельности.

То же преобразование на MicroPython (ESP32 и Pico)

Если ты программируешь ESP32 или Raspberry Pi Pico на MicroPython, путь от HEX до ШИМ тот же; разница лишь в том, что заполнение пишется 16 битами (0–65535). Функцию ниже можно добавить в свой веб-сервер или код MQTT. На Pico, например, можно взять GP11, GP12 и GP13 для красного, зелёного и синего.

MicroPython
1# MicroPython (ESP32 ya da Pico): HEX rengi üç PWM kanalına yazar
2# MicroPython (ESP32 or Pico): writes a HEX colour to three PWM channels
3from machine import Pin, PWM
4
5PINS = (25, 26, 27)        # Pico'da örneğin (11, 12, 13) / on a Pico e.g. (11, 12, 13)
6GAMMA = 2.2
7leds = []
8for p in PINS:
9    pwm = PWM(Pin(p))
10    pwm.freq(5000)
11    leds.append(pwm)
12
13def set_hex(color):
14    color = color.lstrip("#")
15    rgb = (int(color[0:2], 16), int(color[2:4], 16), int(color[4:6], 16))
16    for led, v in zip(leds, rgb):
17        led.duty_u16(int(((v / 255) ** GAMMA) * 65535))   # 16 bit görev oranı / 16-bit duty
18
19set_hex("#ff8800")         # turuncu / orange

Идеи проектов с RGB-светодиодом на ESP32

  • Лампа настроения: помести RGB-светодиод в матовую стеклянную банку и вечером переключай его с телефона на тёплый оранжевый.
  • Индикатор уведомлений: пусть светодиод становится синим, когда приходит письмо или сообщение; про сообщения смотри руководство Telegram-бот на ESP32.
  • Фоновая подсветка комнаты: примени тот же интерфейс к обычной RGB-ленте на 12 V с MOSFET; подробности в руководстве управление RGB-лентой.
  • Все видят один цвет: используй WebSocket вместо HTTP, чтобы цвет, выбранный на одном телефоне, сразу появлялся на всех открытых страницах; как это сделать, показано в руководстве WebSocket на ESP32.
  • Будильник-рассвет: получай время по NTP и за полчаса до подъёма медленно переходи от тёмно-красного к белому; про часы смотри руководство часы NTP на ESP32.
  • Умный дом: управляй цветом из Home Assistant через MQTT; шаги — в руководстве ESP32, MQTT и Home Assistant.

Частые ошибки и решения

СимптомПричинаРешение
Выбираешь красный, а загорается зелёныйВыводы подключены к другим пинамПоменяй порядок в массиве PINS под свой светодиод
Чёрный даёт полную яркость, а белый гасит светодиодСветодиод с общим анодомУстанови COMMON_ANODE = true и подключи общий вывод к 3V3
Синий и зелёный очень тусклые, белый розоватыйСлишком большой резистор для 3,3 VВозьми 100 Ω или 68 Ω для зелёного и синего
'ledcSetup' was not declared in this scopeСтарый код на ядре ESP32 3.xИспользуй проверку #if ESP_ARDUINO_VERSION_MAJOR из этого руководства
Страница не открываетсяТелефон в другой сети, в гостевой сети или на мобильном интернетеПодключи телефон к той же сети 2,4 GHz, что и ESP32, и снова посмотри IP в мониторе порта
Смена цвета дёргаетсяЭнергосбережение Wi-Fi или слишком много запросовWiFi.setSleep(false) и флаг busy; если сигнал слабый, поставь ESP32 ближе к роутеру

Выбор цвета с телефона — первый проект с Wi-Fi, настолько же познавательный, насколько эффектный: одна схема показывает веб-сервер, HTTP-запросы, ШИМ и гамма-коррекцию. В приложении BlueGrays проект «Управление RGB-светодиодом на ESP32» и «Лампа-смеситель цветов на ESP32» с тремя потенциометрами проведут тебя по этой схеме шаг за шагом со схемой подключения и готовым кодом, а потом ты сможешь перенести идею в собственную лампу.

Частые вопросы

Как управлять RGB-светодиодом с ESP32?

Подключи красный, зелёный и синий выводы RGB-светодиода к трём GPIO через резисторы, а общий вывод к GND (к 3V3 при общем аноде). Привяжи к каждому выводу канал ШИМ через LEDC и задавай яркость каждого цвета изменением заполнения. Смешивая три цвета, получишь любой оттенок.

Почему ledcSetup не работает на ядре ESP32 3.0?

Функции LEDC изменились в версии 3.0 ядра ESP32 Arduino: ledcSetup и ledcAttachPin убраны, вместо них появилась ledcAttach(вывод, частота, разрешение), а ledcWrite теперь принимает вывод вместо канала. С проверкой #if ESP_ARDUINO_VERSION_MAJOR >= 3 один и тот же код компилируется на обеих версиях.

Как понять, у RGB-светодиода общий анод или общий катод?

Подключи самый длинный вывод к GND, а другой вывод к 3,3 V через резистор; если загорелся, это общий катод. Если нет, поменяй подключение местами; если теперь горит, это общий анод. При общем аноде логика кода инвертирована, и цвет горит, когда на его выводе LOW.

Какой резистор нужен для RGB-светодиода на ESP32?

При 3,3 V хорошая отправная точка — 150 Ω для красного и 100 Ω для зелёного и синего. С 220 Ω на всех трёх выводах светодиод работает, но зелёный и синий остаются тусклыми. Не бери с вывода больше 20 mA постоянно.

Как перевести HEX-цвет в RGB?

В формате #RRGGBB каждая пара цифр — шестнадцатеричное значение одного цвета. В #FF8800 FF = 255 красного, 88 = 136 зелёного и 00 = 0 синего. В коде Arduino текст можно превратить в число через strtol(hex, NULL, 16) и разделить каналы сдвигом на 16 и 8 бит вправо.

Можно ли управлять лентой WS2812B с телефона через ESP32?

Да. Веб-страница и код сервера остаются прежними; меняется только функция записи цвета: она вызывает fill и show из библиотеки Adafruit NeoPixel. Питай ленту от отдельного блока на 5 V и соедини земли.

Все проекты
Мигающий светодиод на ESP32
ES-1Новичок

Мигающий светодиод на ESP32

Учит базовой работе с выходами GPIO на ESP32. Эффект мигания получается включением и выключением светодиода с цифрового пина. Это ESP32-версия классического проекта мигания на Arduino UNO; базовые команды мигания в среде Arduino те же, но расположение пинов ESP32 и уровни GPIO 3,3 V отличаются от Arduino UNO.

4.7(37)
108
Управление RGB-светодиодом на ESP32
ES-9Новичок

Управление RGB-светодиодом на ESP32

Бесконечное число цветов одним RGB-светодиодом вместо 3 отдельных. Как в Arduino, радужный переход получается заданием значений R/G/B через analogWrite(). Теория цвета (например, красный + зелёный = жёлтый) видна на практике.

4.6(29)
52
Смеситель цветов на ESP32 (3 потенциометра + RGB-светодиод + OLED)
ES-36Продвинутый
Premium

Смеситель цветов на ESP32 (3 потенциометра + RGB-светодиод + OLED)

Умная лампа для смешивания цветов на ESP32: вращая три потенциометра, можно получить любой цвет! Когда крутишь потенциометры красного, зелёного и синего, RGB-светодиод с общим катодом меняет цвет в реальном времени. OLED-дисплей SSD1306 показывает значения каждого цвета в диапазоне 0–255, полосы заполнения и веб-код цвета HEX (например, #FF8040). Мини-студия цвета, которая учит теории цвета RGB, чтению АЦП, регулировке яркости через PWM и дизайну экрана I2C.

4.7(6)
10
Плавное затухание светодиода с PWM на ESP32
ES-8Новичок

Плавное затухание светодиода с PWM на ESP32

Плавное изменение яркости светодиода от 0 до максимума и от максимума до 0. PWM управляется через analogWrite(), как в Arduino, — тот же синтаксис без проблем работает в ESP32 Arduino Core 3.0+. Достаточно определения пина, pinMode и analogWrite.

4.8(36)
55
Управление лентой WS2812B NeoPixel на ESP32
ES-24Средний
Premium

Управление лентой WS2812B NeoPixel на ESP32

Адресуемые светодиоды WS2812B (NeoPixel) — умные RGB-светодиоды, которыми управляют цепочкой через один пин данных. В этом проекте лента WS2812B из 8 светодиодов управляется библиотекой Adafruit_NeoPixel и показывает плавную радужную анимацию. Логика 3,3V у ESP32 работает с большинством WS2812B, но на случай нестабильности показано решение с последовательным резистором 470Ω и конденсатором 1000µF. Анимация получается сдвигом значения оттенка.

4.9(19)
30
Асинхронный веб-сервер на ESP32 (с выводом IP на LCD)
ES-27Продвинутый

Асинхронный веб-сервер на ESP32 (с выводом IP на LCD)

В этом проекте ESP32 превращается в асинхронный веб-сервер, которым можно управлять с телефона или компьютера в той же сети Wi-Fi. Благодаря библиотеке ESPAsyncWebServer сервер может обрабатывать несколько запросов одновременно (в отличие от классического WebServer.h, который блокируется на одном запросе). Открыв IP-адрес ESP32 в браузере, ты нажимаешь кнопки ON/OFF (маршруты /on и /off) и включаешь и выключаешь светодиод на GPIO 5.

4.8(16)
26
Счётчик на WebSocket с ESP32 (2 кнопки + LCD + веб в реальном времени)
ES-28Продвинутый
Premium

Счётчик на WebSocket с ESP32 (2 кнопки + LCD + веб в реальном времени)

В этом проекте две кнопки, подключённые к ESP32 (GPIO 5 увеличивает, GPIO 4 уменьшает), меняют счётчик. Значение сразу обновляется и на I2C LCD 16x2, и — через поддержку WebSocket в ESPAsyncWebServer — во всех подключённых браузерах без перезагрузки страницы. Вместо опроса по HTTP используется одно постоянное соединение, и ESP32 отправляет новое значение всем через ws.textAll().

4.5(14)
23
Регулировка яркости светодиода потенциометром на ESP32 (аналог → PWM)
ES-13Средний
Premium

Регулировка яркости светодиода потенциометром на ESP32 (аналог → PWM)

В этом проекте яркость светодиода плавно регулируется потенциометром. Пин АЦП ESP32 читает напряжение 0–3,3V с потенциометра, затем это значение превращается в сигнал PWM (широтно-импульсная модуляция) и подаётся на светодиод. В результате при повороте потенциометра светодиод постепенно становится ярче или тусклее. В Arduino Core 3.0+ можно сразу использовать analogWrite(); на ESP32-S2/S3 разрешение АЦП фиксировано — 12 бит.

4.5(19)
32