Распиновка ESPDuino-32: соответствие пинам Uno, шилды и первый Wi-Fi
Распиновка ESPDuino-32: таблица соответствия Uno и GPIO, ловушка 3,3 V, какие шилды не работают, выбор платы в Arduino IDE и первый скетч с Wi-Fi.
ESPDuino-32 — отладочная плата, которая помещает ESP32 в размер и расположение пинов Arduino Uno: снаружи она выглядит как Uno, но внутри у неё двухъядерный процессор на 240 MHz, Wi-Fi и Bluetooth. Это разработка DOIT, а почти такая же плата продаётся под названием WEMOS D1 R32. В этом руководстве распиновка ESPDuino-32 сопоставляется с пинами Uno по одному, показано, какие шилды Uno работают, а какие нет, и объяснено, как выбрать плату в Arduino IDE.
Главная приманка — можно поставить уже имеющиеся шилды Uno и добавить в проект Wi-Fi. Но есть важная ловушка: Uno работает на 5 V, а все сигнальные пины ESPDuino-32 работают на 3,3 V и не выдерживают 5 V. Шилды и датчики об этой разнице не знают, и неправильное подключение может сжечь пин или даже всю плату. Сначала познакомимся с платой.

Что такое ESPDuino-32? Сравнение с Uno и ESP32 DevKit
Сердце ESPDuino-32 — модуль ESP32-WROOM-32, тот же, что на классических платах ESP32. С точки зрения программ это обычный ESP32: на нём работают все скетчи и библиотеки, написанные для ESP32. Отличие — в разводке платы: пины выведены на разъёмы в стиле Uno, а на плате есть разъём питания, стабилизатор 3,3 V и преобразователь USB-UART (обычно CH340). Если с ESP32 ещё не доводилось работать, основы — в статье Что такое ESP32?
| Характеристика | Arduino Uno R3 | ESPDuino-32 | ESP32 DevKit |
|---|---|---|---|
| Процессор | ATmega328P, 8 бит, 16 MHz | ESP32, два ядра, 240 MHz | ESP32, два ядра, 240 MHz |
| Оперативная память | 2 КБ | 520 КБ | 520 КБ |
| Флеш-память | 32 КБ | 4 МБ | 4 МБ |
| Логический уровень | 5 V | 3,3 V | 3,3 V |
| Беспроводная связь | Нет | Wi-Fi и Bluetooth | Wi-Fi и Bluetooth |
| Аналоговые входы | 6 каналов, 10 бит | 6 каналов на разъёме Uno, 12 бит | До 18 каналов, 12 бит |
| Размер и шилды | 68,6 × 53,4 мм, шилды Uno | Размер как у Uno, принимает шилды | Встаёт в макетную плату, без шилдов |
| Микросхема USB | ATmega16U2 | Обычно CH340 | CP2102 или CH340 |
Так что же купить? Если есть шилды Uno, хочется прикрутить плату в корпус по крепёжным отверстиям Uno или ты занимаешься по книге или курсу для Uno, ESPDuino-32 упростит жизнь. Если работаешь на макетной плате, нужен доступ к пинам ESP32, которые не выведены на разъём Uno, например GPIO 32 и 33, или требуется компактное устройство, лучше подойдёт классический ESP32 DevKit. Код на обеих платах одинаковый, меняются только номера пинов.
Распиновка ESPDuino-32: какой GPIO стоит за каждым пином Uno?
Хотя на плате написано D2, D3, A0, как на Uno, в коде обычно нужен номер GPIO. В таблице ниже указан GPIO ESP32 за каждым пином Uno и то, на что стоит обратить внимание. Полный список пинов ESP32 есть и в инструменте Распиновка.
| Пин Uno | GPIO ESP32 | Состояние | Примечание |
|---|---|---|---|
| D0 (RX) | GPIO 3 | Избегать | Последовательная линия USB |
| D1 (TX) | GPIO 1 | Избегать | Последовательная линия USB |
| D2 | GPIO 26 | Безопасно | Можно использовать и как выход DAC2 |
| D3 | GPIO 25 | Безопасно | Можно использовать и как выход DAC1 |
| D4 | GPIO 17 | Безопасно | Также служит TX для Serial2 |
| D5 | GPIO 16 | Безопасно | Также служит RX для Serial2 |
| D6 | GPIO 27 | Безопасно | Сенсорный вход (T7) |
| D7 | GPIO 14 | С осторожностью | При загрузке выдаёт короткий ШИМ-сигнал |
| D8 | GPIO 12 | С осторожностью | Strapping-пин: если при включении на нём HIGH, плата не запустится |
| D9 | GPIO 13 | Безопасно | Вход и выход общего назначения |
| D10 | GPIO 5 | С осторожностью | SS для SPI; при загрузке выдаёт короткий ШИМ-сигнал |
| D11 | GPIO 23 | Безопасно | MOSI для SPI |
| D12 | GPIO 19 | Безопасно | MISO для SPI |
| D13 | GPIO 18 | Безопасно | SCK для SPI; светодиода здесь нет, в отличие от Uno |
| A0 | GPIO 2 | С осторожностью | ADC2 (не читает при включённом Wi-Fi), встроенный светодиод, strapping-пин |
| A1 | GPIO 4 | С осторожностью | ADC2 (не читает при включённом Wi-Fi) |
| A2 | GPIO 35 | Только вход | ADC1, работает вместе с Wi-Fi |
| A3 | GPIO 34 | Только вход | ADC1, работает вместе с Wi-Fi |
| A4 | GPIO 36 (VP) | Только вход | ADC1; не SDA, как на Uno |
| A5 | GPIO 39 (VN) | Только вход | ADC1; не SCL, как на Uno |
| SDA | GPIO 21 | Безопасно | Линия данных I2C |
| SCL | GPIO 22 | Безопасно | Линия тактового сигнала I2C |
Есть ещё две аналоговые ловушки. Во-первых, A0 (GPIO 2) и A1 (GPIO 4) относятся к блоку ADC2 ESP32, который не может проводить измерения при включённом Wi-Fi; в проектах с Wi-Fi подключай аналоговые датчики к A2–A5 (ADC1). Во-вторых, АЦП ESP32 12-битный: analogRead() возвращает 0–4095 вместо 0–1023, а полная шкала — около 3,3 V, а не 5 V. Расчёты вроде «value × 5.0 / 1023» из скетчей для Uno придётся поменять; а ещё лучше использовать analogReadMilliVolts(), которая возвращает откалиброванный результат в милливольтах.
Ловушка 3,3 V: работают ли шилды Uno на ESPDuino-32?
Шилд, который встал на место, не обязательно заработает. На ESPDuino-32 шилд создаёт проблемы одним из трёх способов: подаёт на ESP32 сигнал 5 V и повреждает пин, ждёт логики 5 V и не всегда считает 3,3 V за HIGH или использует пины A2–A5, работающие только на вход, там, где нужен выход. Поскольку пин 5V платы выдаёт 5 V, как у Uno, сам шилд питание получает; проблемы всегда возникают на сигнальных пинах. Вот как ведут себя распространённые шилды:

| Шилд | Состояние | Почему |
|---|---|---|
| CNC Shield V3 (A4988 / DRV8825) | Обычно работает | STEP и DIR попадают на GPIO с выходом; версии GRBL для ESP32 поставляются с готовой картой пинов для этой платы |
| Релейный шилд | Обычно работает | Реле питаются от пина 5V, а управляющий транзистор всё равно открывается сигналом 3,3 V |
| Шилд для записи данных (SD-карта + RTC) | Частично | SD-карта на D10–D13 работает, потому что это SPI-пины ESP32; RTC не работает, если его линии I2C идут только на A4/A5 |
| Шилд моторов L293D | Ненадёжно | 74HC595 на 5 V едва читает входы 3,3 V, а его линия данных на D8 (GPIO 12), что ещё и может сорвать загрузку |
| Шилд LCD Keypad | Рискованно | Кнопки подключены к A0 через резисторную лестницу, привязанную к 5 V, поэтому при ненажатых кнопках на GPIO 2 приходит 5 V |
| Параллельный TFT-шилд 2,4 дюйма | Не работает | Его линии управления на A0–A4; A2, A3 и A4 работают только на вход, поэтому управлять дисплеем не могут |
| Старые шилды, берущие I2C только с A4/A5 | Не работает | На ESPDuino-32 I2C находится на отдельных пинах SDA/SCL (GPIO 21/22) |
Strapping-пины: следи за D8 и A0
При включении ESP32 проверяет уровень нескольких пинов, чтобы решить, как запускаться. Два из них на ESPDuino-32 выведены на разъём Uno. Если на D8 (GPIO 12) при загрузке HIGH, ESP32 пытается запустить флеш-память с неправильным напряжением, и плата не стартует. На A0 (GPIO 2) во время загрузки кода должно быть неподключённое состояние или LOW. Если к D8 подключён модуль или шилд с подтяжкой вверх и плата не запускается, это первый подозреваемый. D7 (GPIO 14) и D10 (GPIO 5) при загрузке тоже выдают короткий ШИМ-сигнал, поэтому реле на этих пинах может коротко щёлкнуть при включении.
Настройка ESPDuino-32 в Arduino IDE
- Установи в Arduino IDE пакет плат esp32 от Espressif; шаги описаны в статье Что такое ESP32?
- Подключи плату по USB. Если порт не появился, установи драйвер для её USB-микросхемы (обычно CH340) и проверь, что кабель передаёт данные.
- В меню Инструменты > Плата > esp32 выбери WEMOS D1 R32: в этом описании имена D2–D13 и A0–A5 точно совпадают с надписями на плате. DOIT ESPduino32 или ESP32 Dev Module тоже подойдут, но тогда придётся использовать только номера GPIO.
- Выбери порт платы; если загрузка не проходит при Upload Speed 921600, снизь скорость до 115200.
- Нажми «Загрузка» и открой монитор порта на 115200 бод. Если плата не входит в режим загрузки, решения есть в статье ESP32: ошибка Failed to Connect.
Первая проверка: встроенный светодиод, D13 и аналоговое чтение
Синий встроенный светодиод платы находится на GPIO 2, а не на D13, как у Uno. Скетч ниже по очереди зажигает встроенный светодиод и светодиод, подключённый к D13 (GPIO 18) через резистор на 220 Ω, и выводит в монитор порта значение потенциометра на A2 (GPIO 35). Крайние выводы потенциометра подключи к 3V3 и GND, а не к 5V; средний вывод — к A2.
1// ESPDuino-32: Uno adları yerine GPIO numaraları / GPIO numbers instead of Uno pin names
2const int ONBOARD_LED = 2; // kart üstü mavi LED (A0 ile aynı pin) / onboard blue LED (same pin as A0)
3const int LED_D13 = 18; // Uno D13 = GPIO 18
4const int POT_A2 = 35; // Uno A2 = GPIO 35 (ADC1, yalnız giriş / input only)
5
6void setup() {
7 Serial.begin(115200);
8 pinMode(ONBOARD_LED, OUTPUT);
9 pinMode(LED_D13, OUTPUT);
10 analogReadResolution(12); // 0–4095 (varsayılan / default)
11}
12
13void loop() {
14 int raw = analogRead(POT_A2); // 0–4095, Uno'daki gibi 0–1023 değil / not 0–1023 like the Uno
15 int mv = analogReadMilliVolts(POT_A2); // kalibre edilmiş mV / calibrated millivolts
16 Serial.printf("A2 ham / raw: %d gerilim / voltage: %d mV\n", raw, mv);
17
18 digitalWrite(ONBOARD_LED, HIGH); // LED'ler sırayla / LEDs take turns
19 digitalWrite(LED_D13, LOW);
20 delay(500);
21 digitalWrite(ONBOARD_LED, LOW);
22 digitalWrite(LED_D13, HIGH);
23 delay(500);
24}Первый проект с Wi-Fi: управление светодиодом с телефона
Теперь посмотрим, чем плата на самом деле отличается от Uno. Скетч ниже подключает ESPDuino-32 к домашней сети и запускает небольшой веб-сервер. Введи IP-адрес из монитора порта в браузере телефона в той же сети — появится кнопка, переключающая светодиод на D13, и показание потенциометра на A2 в милливольтах. Потенциометр специально стоит на A2: A0 и A1 не читают аналоговые значения при включённом Wi-Fi.
1#include <WiFi.h>
2#include <WebServer.h>
3
4const char* WIFI_SSID = "AgAdi"; // Wi-Fi adın / your Wi-Fi name
5const char* WIFI_PASS = "Sifre123"; // Wi-Fi şifren / your Wi-Fi password
6
7const int LED_PIN = 18; // Uno D13 = GPIO 18
8const int POT_PIN = 35; // Uno A2 = GPIO 35 (ADC1: Wi-Fi ile çalışır / works with Wi-Fi)
9
10WebServer server(80);
11bool ledOn = false;
12
13String page() {
14 String html = "<!DOCTYPE html><html><head><meta charset='utf-8'>";
15 html += "<meta name='viewport' content='width=device-width,initial-scale=1'>";
16 html += "<title>ESPDuino-32</title></head>";
17 html += "<body style='font-family:sans-serif;text-align:center'><h1>ESPDuino-32</h1>";
18 html += "<p>LED (D13): <b>" + String(ledOn ? "ON" : "OFF") + "</b></p>";
19 html += "<p><a href='/toggle'><button style='font-size:24px;padding:12px 32px'>LED</button></a></p>";
20 html += "<p>A2: " + String(analogReadMilliVolts(POT_PIN)) + " mV</p>";
21 html += "</body></html>";
22 return html;
23}
24
25void handleRoot() {
26 server.send(200, "text/html", page());
27}
28
29void handleToggle() {
30 ledOn = !ledOn;
31 digitalWrite(LED_PIN, ledOn ? HIGH : LOW);
32 server.sendHeader("Location", "/"); // ana sayfaya dön / back to the main page
33 server.send(303);
34}
35
36void setup() {
37 Serial.begin(115200);
38 pinMode(LED_PIN, OUTPUT);
39
40 WiFi.mode(WIFI_STA);
41 WiFi.begin(WIFI_SSID, WIFI_PASS);
42 Serial.print("Baglaniyor / Connecting");
43 while (WiFi.status() != WL_CONNECTED) { // bağlanana kadar bekle / wait until connected
44 delay(500);
45 Serial.print(".");
46 }
47 Serial.println();
48 Serial.print("IP: ");
49 Serial.println(WiFi.localIP()); // bu adresi telefonda aç / open this address on your phone
50
51 server.on("/", handleRoot);
52 server.on("/toggle", handleToggle);
53 server.begin();
54}
55
56void loop() {
57 server.handleClient(); // gelen istekleri işle / handle incoming requests
58}В скетче два адреса: / отдаёт главную страницу, а /toggle переключает светодиод и возвращает браузер на главную страницу. При каждой перезагрузке страницы потенциометр считывается заново. Для живого интерфейса, который обновляется без перезагрузки, используй подход из статьи Асинхронный веб-сервер и WebSocket на ESP32. Если плата не подключается к сети, проверь, что это сеть 2,4 GHz: ESP32 не видит сети 5 GHz.
Питание платы: USB, разъём питания и пин 3V3
| Источник | Напряжение | Примечание |
|---|---|---|
| Порт USB | 5 V | Достаточно для разработки и небольших схем |
| Разъём питания | Обычно 7–12 V (проверь маркировку на своей плате) | Стабилизатор греется; при 9 V он холоднее, чем при 12 V |
| Пин VIN | Напряжение на разъёме питания | Для питания платы от внешнего источника |
| Пин 5V | Выход 5 V | Питает шилды и модули на 5 V; не забудь снизить их сигналы до 3,3 V |
| Пин 3V3 | Выход 3,3 V | Для датчиков; не подключай моторы и длинные светодиодные ленты |
Во время передачи по Wi-Fi ESP32 может кратковременно потреблять почти 250 mA. Слабый USB-кабель или порт в эти моменты даёт просадку напряжения, и плата перезагружается с сообщением «Brownout detector was triggered». В таком случае возьми короткий качественный кабель или питай плату через разъём питания; подробности в статье ESP32: Brownout и Guru Meditation.
Частые ошибки и как их исправить
- Скетч для Uno не работает: номера пинов написаны для Uno. pinMode(13, OUTPUT) на ESPDuino-32 управляет GPIO 13, а это D9, а не D13; найди номер GPIO в таблице.
- analogRead всегда 4095 или всегда 0: датчик питается от 5 V и его выход превышает 3,3 V, или датчик стоит на пине ADC2 (A0, A1) при включённом Wi-Fi.
- I2C-дисплей не находится: он подключён к A4/A5; перенеси провода на пины SDA/SCL (GPIO 21/22).
- Плата не запускается или постоянно перезагружается: что-то на D8 (GPIO 12) подтягивает пин к HIGH при включении; перенеси эту деталь на другой пин.
- После установки шилда греется плата или деталь: шилд подаёт 5 V на пин; сразу отключи плату и понизь эту линию делителем или преобразователем уровней.
- SoftwareSerial или библиотека Servo не компилируются: вместо библиотек только для AVR используй аналоги для ESP32: аппаратный последовательный порт Serial2 и ESP32Servo.
ESPDuino-32 — самый привычный способ перейти с Uno на ESP32: тот же форм-фактор и те же разъёмы, но тактовая частота в 15 раз выше и беспроводная связь. Держи рядом открытой статью Распиновка Arduino Uno, чтобы помнить о различиях. Все проекты на ESP32 из приложения BlueGrays работают и на этой плате, так что проекты со светодиодом, светофором, подключением к Wi-Fi и веб-сервером можно пошагово собрать по схемам и коду; достаточно сопоставить пины по таблице выше.
Частые вопросы
ESPDuino-32 и WEMOS D1 R32 — это одно и то же?
На практике — да. Обе платы ставят модуль ESP32-WROOM-32 на плату размером с Uno с одинаковым соответствием пинов на разъёмах Uno. В Arduino IDE для каждой есть отдельное описание, и описание WEMOS D1 R32 удобнее, потому что связывает надписи D и A на плате с правильными GPIO.
Можно ли использовать шилды Arduino Uno на ESPDuino-32?
Физически они встают, но заработают или нет — зависит от шилда. Шилды, которые не подают на ESP32 сигналы 5 V, не используют A2–A5 как выходы и не берут I2C только с A4/A5, обычно работают; шилды LCD Keypad и параллельные TFT без доработки не работают.
Работает ли ESPDuino-32 с 5 V?
Плата питается 5 V от USB или через пин 5V и принимает более высокое напряжение через разъём питания. А вот её сигнальные пины работают на 3,3 V и не выдерживают 5 V, поэтому датчикам с выходом 5 V нужен делитель напряжения или преобразователь уровней.
На каком пине встроенный светодиод ESPDuino-32?
Синий встроенный светодиод подключён к GPIO 2, который на плате обозначен ещё и как A0. Светодиода на D13, как у Uno, нет, а константа LED_BUILTIN возвращает 2.
Какую плату выбрать для ESPDuino-32 в Arduino IDE?
Выбирай WEMOS D1 R32, если хочешь использовать в коде обозначения Uno (например, D2 или A0). DOIT ESPduino32 или ESP32 Dev Module загружают код так же хорошо, но с ними пины приходится указывать номерами GPIO.
Почему не работает analogRead на ESPDuino-32?
Чаще всего датчик стоит на A0 или A1 при включённом Wi-Fi; эти пины относятся к ADC2, который не читает, пока активен Wi-Fi. Перенеси датчик на A2–A5 (ADC1) и помни, что результат идёт от 0 до 4095, а полная шкала — около 3,3 V.
Что собрать после прочтения
Все проекты
Мигающий светодиод на ESP32
Учит базовой работе с выходами GPIO на ESP32. Эффект мигания получается включением и выключением светодиода с цифрового пина. Это ESP32-версия классического проекта мигания на Arduino UNO; базовые команды мигания в среде Arduino те же, но расположение пинов ESP32 и уровни GPIO 3,3 V отличаются от Arduino UNO.

Мигание встроенным светодиодом ESP32
Мигание встроенным синим светодиодом на ESP32 DevKit V1. Внешние компоненты не нужны! Первый проект, который стоит попробовать после покупки ESP32. Встроенный светодиод подключён к GPIO 2.

Светофор на ESP32
Реалистичная симуляция светофора на 3 светодиодах — красном, жёлтом и зелёном. Тайминги близки к реальной логике движения: красный долго, жёлтый коротко, зелёный долго. Классический пример последовательного управления GPIO.

Измерение освещённости модулем LDR на ESP32
Наблюдение в мониторе порта в реальном времени за сырым значением ADC модуля LDR и относительным процентом освещённости, вычисленным по опорным значениям темноты и света. Этот процент — не измерение в люксах. Учит логике калибровки модуля. Идеально выполнить его перед проектом 10, потому что он нужен для определения порога.

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

Подключение ESP32 к Wi-Fi в режиме STA (с экраном LCD)
В этом проекте ESP32 надёжно и устойчиво к сбоям подключается к домашней сети Wi-Fi в режиме станции (STA). SSID и пароль хранятся в отдельном файле secrets.h, чтобы не утекли в Git; настроено автоматическое переподключение, а уровень сигнала RSSI и IP-адрес выводятся на I2C LCD-экран. Встроенный светодиод служит индикатором состояния. Это менеджер подключения уровня реальных устройств.

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

mDNS на ESP32: доступ к устройству через bluegrays-esp.local (с экраном LCD)
В этом проекте к ESP32 добавляется служба mDNS (Multicast DNS), и к устройству можно обращаться по понятному имени вроде bluegrays-esp.local вместо IP-адреса. Даже если IP, выданный DHCP, меняется, устройство всегда доступно по одному имени. На устройстве также работает маленький веб-сервер, через который по адресу http://bluegrays-esp.local/ из браузера отправляются команды светодиоду. I2C LCD показывает имя хоста, IP-адрес и состояние светодиода.
Другие статьи
Приложение BlueGrays
Собери эту схему шаг за шагом в телефоне
Схема подключения, код и список деталей на одном экране. 500+ проектов на Arduino, ESP32 и Pico готовы к сборке.
Наведи камеру телефона
Наведи камеру на код — откроется магазин приложений на телефоне.
или открыть магазин

