Компоненты · 7 мин чтения

Распиновка 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
ESPDuino-32: модуль ESP32-WROOM-32 на плате размером с Uno, с микросхемой USB-UART, разъёмом питания и штыревыми разъёмами там же, где у Uno.

Что такое ESPDuino-32? Сравнение с Uno и ESP32 DevKit

Сердце ESPDuino-32 — модуль ESP32-WROOM-32, тот же, что на классических платах ESP32. С точки зрения программ это обычный ESP32: на нём работают все скетчи и библиотеки, написанные для ESP32. Отличие — в разводке платы: пины выведены на разъёмы в стиле Uno, а на плате есть разъём питания, стабилизатор 3,3 V и преобразователь USB-UART (обычно CH340). Если с ESP32 ещё не доводилось работать, основы — в статье Что такое ESP32?

ХарактеристикаArduino Uno R3ESPDuino-32ESP32 DevKit
ПроцессорATmega328P, 8 бит, 16 MHzESP32, два ядра, 240 MHzESP32, два ядра, 240 MHz
Оперативная память2 КБ520 КБ520 КБ
Флеш-память32 КБ4 МБ4 МБ
Логический уровень5 V3,3 V3,3 V
Беспроводная связьНетWi-Fi и BluetoothWi-Fi и Bluetooth
Аналоговые входы6 каналов, 10 бит6 каналов на разъёме Uno, 12 битДо 18 каналов, 12 бит
Размер и шилды68,6 × 53,4 мм, шилды UnoРазмер как у Uno, принимает шилдыВстаёт в макетную плату, без шилдов
Микросхема USBATmega16U2Обычно CH340CP2102 или 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 есть и в инструменте Распиновка.

Пин UnoGPIO ESP32СостояниеПримечание
D0 (RX)GPIO 3ИзбегатьПоследовательная линия USB
D1 (TX)GPIO 1ИзбегатьПоследовательная линия USB
D2GPIO 26БезопасноМожно использовать и как выход DAC2
D3GPIO 25БезопасноМожно использовать и как выход DAC1
D4GPIO 17БезопасноТакже служит TX для Serial2
D5GPIO 16БезопасноТакже служит RX для Serial2
D6GPIO 27БезопасноСенсорный вход (T7)
D7GPIO 14С осторожностьюПри загрузке выдаёт короткий ШИМ-сигнал
D8GPIO 12С осторожностьюStrapping-пин: если при включении на нём HIGH, плата не запустится
D9GPIO 13БезопасноВход и выход общего назначения
D10GPIO 5С осторожностьюSS для SPI; при загрузке выдаёт короткий ШИМ-сигнал
D11GPIO 23БезопасноMOSI для SPI
D12GPIO 19БезопасноMISO для SPI
D13GPIO 18БезопасноSCK для SPI; светодиода здесь нет, в отличие от Uno
A0GPIO 2С осторожностьюADC2 (не читает при включённом Wi-Fi), встроенный светодиод, strapping-пин
A1GPIO 4С осторожностьюADC2 (не читает при включённом Wi-Fi)
A2GPIO 35Только входADC1, работает вместе с Wi-Fi
A3GPIO 34Только входADC1, работает вместе с Wi-Fi
A4GPIO 36 (VP)Только входADC1; не SDA, как на Uno
A5GPIO 39 (VN)Только входADC1; не SCL, как на Uno
SDAGPIO 21БезопасноЛиния данных I2C
SCLGPIO 22БезопасноЛиния тактового сигнала I2C
A4 и A5 здесь не I2C. На Uno A4 и A5 одновременно служат SDA и SCL; на ESPDuino-32 они подключены к GPIO 36 и 39 и работают только как входы. Для I2C-дисплеев и датчиков используй отдельные пины SDA (GPIO 21) и SCL (GPIO 22) рядом с AREF.

Есть ещё две аналоговые ловушки. Во-первых, 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, сам шилд питание получает; проблемы всегда возникают на сигнальных пинах. Вот как ведут себя распространённые шилды:

Шилд драйвера моторов L293D
Шилд моторов L293D: его сдвиговый регистр 74HC595 работает на 5 V, поэтому едва распознаёт сигналы 3,3 V от ESPDuino-32.
ШилдСостояниеПочему
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)
Чтобы оценить совместимость шилда, посмотри на его схему и задай два вопроса: подаёт ли он сигнал 5 V на какой-нибудь пин и использует ли он какой-либо из A2–A5 как выход? Если на оба вопроса ответ «нет», шилд, скорее всего, заработает. Если хотя бы одна линия подаёт 5 V, поставь между ними делитель напряжения или преобразователь логических уровней.

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

  1. Установи в Arduino IDE пакет плат esp32 от Espressif; шаги описаны в статье Что такое ESP32?
  2. Подключи плату по USB. Если порт не появился, установи драйвер для её USB-микросхемы (обычно CH340) и проверь, что кабель передаёт данные.
  3. В меню Инструменты > Плата > esp32 выбери WEMOS D1 R32: в этом описании имена D2–D13 и A0–A5 точно совпадают с надписями на плате. DOIT ESPduino32 или ESP32 Dev Module тоже подойдут, но тогда придётся использовать только номера GPIO.
  4. Выбери порт платы; если загрузка не проходит при Upload Speed 921600, снизь скорость до 115200.
  5. Нажми «Загрузка» и открой монитор порта на 115200 бод. Если плата не входит в режим загрузки, решения есть в статье ESP32: ошибка Failed to Connect.
От выбранной платы зависит, что значит A0. При выборе ESP32 Dev Module A0 в коде указывает на GPIO 36, то есть на пин с надписью A4 на ESPDuino-32; с DOIT ESPduino32, в зависимости от версии ядра, A0 может быть вообще не определён, и компилятор остановится с ошибкой. Проще всего избежать путаницы, всегда указывая в коде номера GPIO.

Первая проверка: встроенный светодиод, D13 и аналоговое чтение

Синий встроенный светодиод платы находится на GPIO 2, а не на D13, как у Uno. Скетч ниже по очереди зажигает встроенный светодиод и светодиод, подключённый к D13 (GPIO 18) через резистор на 220 Ω, и выводит в монитор порта значение потенциометра на A2 (GPIO 35). Крайние выводы потенциометра подключи к 3V3 и GND, а не к 5V; средний вывод — к A2.

C++ (Arduino IDE)
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.

C++ (Arduino IDE)
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

ИсточникНапряжениеПримечание
Порт USB5 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
ES-1Новичок

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

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

4.7(37)
108
Мигание встроенным светодиодом ESP32
ES-4Новичок

Мигание встроенным светодиодом ESP32

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

4.8(29)
54
Светофор на ESP32
ES-5Новичок

Светофор на ESP32

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

4.4(22)
45
Измерение освещённости модулем LDR на ESP32
ES-11Новичок

Измерение освещённости модулем LDR на ESP32

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

4.6(36)
55
Регулировка яркости светодиода потенциометром на 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
Подключение ESP32 к Wi-Fi в режиме STA (с экраном LCD)
ES-25Продвинутый

Подключение ESP32 к Wi-Fi в режиме STA (с экраном LCD)

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

4.4(21)
38
Асинхронный веб-сервер на 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
mDNS на ESP32: доступ к устройству через bluegrays-esp.local (с экраном LCD)
ES-29Продвинутый
Premium

mDNS на ESP32: доступ к устройству через bluegrays-esp.local (с экраном LCD)

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

4.8(14)
23