Руководство по симулятору Wokwi: ESP32, Arduino и Pico онлайн
Симулятор Wokwi для ESP32, Arduino и Pico: подключение в diagram.json, Wi-Fi, MicroPython, логический анализатор, расширение VS Code и преимущества перед Tinkercad.
Wokwi — бесплатный симулятор электроники, в котором можно запускать проекты на ESP32, Arduino и Raspberry Pi Pico в браузере, не покупая ни одной детали. Ты пишешь код, размещаешь светодиоды, кнопки, дисплеи и датчики рядом с виртуальной платой и нажимаешь зелёную кнопку запуска: код компилируется, светодиод загорается, на OLED появляется текст, а в мониторе порта начинают прокручиваться сообщения. Главное отличие от Tinkercad — поддержка ESP32 и Pico; можно даже подключить ESP32 к настоящему интернету через виртуальную сеть Wi-Fi и запустить MicroPython на Pico.
В этом руководстве ты начнёшь с открытия первого проекта на wokwi.com, затем научишься соединять компоненты мышью и через файл diagram.json, добавлять библиотеки, попробуешь Wi-Fi и получение времени из интернета на ESP32, запустишь MicroPython на Pico, измеришь сигнал ШИМ (PWM) логическим анализатором и запустишь ту же симуляцию в VS Code. В конце разберём, какие датчики поддерживаются, чем симуляция отличается от реальной схемы и как поделиться проектом.

Что такое Wokwi и как он работает?
Wokwi компилирует твой код в облаке настоящими компиляторами и передаёт полученный машинный код эмулятору процессора, работающему в браузере. Так, при моделировании Arduino Uno инструкции ATmega328P выполняются одна за другой; тот же подход используется для ESP32 и RP2040. Поэтому аппаратные функции, такие как millis(), прерывания, таймеры, ШИМ, I2C и SPI, ведут себя как на реальной плате, а настоящие библиотеки работают без изменений. Wokwi не рассчитывает токи и напряжения в схеме; он моделирует цифровые уровни пинов и значения, подаваемые на аналоговые входы. Благодаря этому он отлично подходит для проверки встроенного ПО, а не для изучения основ электроники.
| Возможность | Wokwi |
|---|---|
| Где работает | Браузер (wokwi.com) и расширение VS Code |
| Платы | Arduino Uno, Nano, Mega; ESP32, ESP32-S3, ESP32-C3; Raspberry Pi Pico и Pico W |
| Языки | Arduino C++, MicroPython, CircuitPython (Pico), ESP-IDF |
| Библиотеки | Большинство библиотек из менеджера библиотек Arduino (libraries.txt) |
| Сеть | Виртуальная сеть Wi-Fi для ESP32 и Pico W: Wokwi-GUEST |
| Измерительный инструмент | 8-канальный логический анализатор; электрических измерений нет |
| Аккаунт | Для пробы не нужен; для сохранения проекта нужно войти |
| Цена | Основные возможности бесплатны; дополнительные доступны по платному тарифу |
Какие платы поддерживает Wokwi?
У каждой детали в Wokwi есть имя типа, которое можно увидеть в файле diagram.json. В таблице ниже приведены обозначения трёх платформ, которым посвящён этот блог, в Wokwi. В старых проектах для ESP32 также встречается wokwi-esp32-devkit-v1; оба варианта моделируют одну и ту же микросхему ESP32, отличается лишь расположение пинов на плате.
| Плата | Имя типа в Wokwi | Доступные языки | Примечание |
|---|---|---|---|
| Arduino Uno | wokwi-arduino-uno (тип платы в diagram.json) | Arduino C++ | ATmega328P, логика 5 V, самая быстрая симуляция |
| Arduino Nano | wokwi-arduino-nano (тип платы в diagram.json) | Arduino C++ | Та же микросхема, что у Uno, плата меньше |
| Arduino Mega | wokwi-arduino-mega (тип платы в diagram.json) | Arduino C++ | 8 КБ SRAM, проекты с большим числом пинов |
| ESP32 DevKit | board-esp32-devkit-c-v4 | Arduino C++, MicroPython, ESP-IDF | Wi-Fi есть, Bluetooth нет |
| ESP32-S3 / ESP32-C3 | board-esp32-s3-devkitc-1 / board-esp32-c3-devkitm-1 (типы плат ESP32-S3 / ESP32-C3) | Arduino C++, MicroPython, ESP-IDF | Более новые семейства ESP32 |
| Raspberry Pi Pico | wokwi-pi-pico | MicroPython, CircuitPython, Arduino C++ | RP2040, логика 3,3 V |
| Raspberry Pi Pico W | board-pi-pico-w | MicroPython, Arduino C++ | С Wi-Fi |
Твой первый проект Wokwi в браузере: шаг за шагом
- Открой wokwi.com в браузере. На главной странице есть разделы Arduino, ESP32 и Raspberry Pi Pico; выбери один из них, чтобы увидеть готовые шаблоны и примеры проектов.
- Чтобы начать с пустого проекта, выбери шаблон Arduino Uno в разделе Arduino. Экран разделён надвое: слева редактор кода (sketch.ino), справа область схемы, где изображена электрическая цепь.
- Нажми синюю кнопку + над правой областью и введи LED в поле поиска. Выбранная деталь появится рядом с платой; перетащи её мышью в нужное место.
- Таким же способом добавь Resistor (резистор) и Pushbutton (кнопку). При нажатии на деталь открывается небольшая панель, где можно изменить её цвет или номинал; задай резистору 220 Ω.
- Чтобы нарисовать провод, нажми на конец пина, затем на пин, к которому он должен подключаться. Для изгиба провода нажми на свободное место между ними. Нажми на провод, чтобы изменить его цвет, или удали его клавишей Delete.
- Введи код слева или вставь пример ниже, затем нажми зелёную кнопку запуска. Первая сборка занимает несколько секунд; затем начинается симуляция, а если используется Serial.begin, внизу открывается монитор порта.
- Во время симуляции нажимай кнопку мышью. Чтобы остановить симуляцию, нажми квадратную кнопку. Для сохранения проекта нажми Save («Сохранить»); при первом сохранении потребуется войти в аккаунт, после чего проект получит постоянную ссылку.
Первая схема: включение и выключение светодиода кнопкой
Классический первый опыт с кнопкой и светодиодом можно собрать на всех трёх платах с одинаковой логикой работы. Длинная ножка светодиода (анод, A в Wokwi) подключается через резистор к выходному пину, а короткая (катод, C) — к GND. Одна сторона кнопки подключается к входному пину, другая — к GND; код включает встроенный подтягивающий резистор. Для расчёта резистора светодиода в своей схеме используй калькулятор резистора для светодиода.
| Подключение | Arduino Uno | ESP32 | Raspberry Pi Pico |
|---|---|---|---|
| Анод светодиода (A), через резистор 220 Ω | D13 | GPIO 18 | GP14 |
| Катод светодиода (C) | GND | GND | GND |
| Ножка кнопки 1 | D2 | GPIO 4 | GP2 |
| Ножка кнопки 2 | GND | GND | GND |
| Логический уровень | 5 V | 3,3 V | 3,3 V |
1// Wokwi ilk proje: buton ile LED aç/kapat / Wokwi first project: toggle an LED with a button
2const int LED_PIN = 13; // ESP32'de 18 / 18 on ESP32
3const int BUTON_PIN = 2; // ESP32'de 4, diğer uç GND / 4 on ESP32, other leg to GND
4
5bool ledDurum = false; // LED durumu / LED state
6bool oncekiOkuma = HIGH; // önceki buton okuması / previous button reading
7unsigned long sonDegisim = 0; // son kabul edilen değişim / last accepted change
8
9void setup() {
10 pinMode(LED_PIN, OUTPUT);
11 pinMode(BUTON_PIN, INPUT_PULLUP); // dahili pull-up: basılınca LOW / internal pull-up: LOW when pressed
12 Serial.begin(115200);
13 Serial.println("Wokwi hazir / ready");
14}
15
16void loop() {
17 bool okuma = digitalRead(BUTON_PIN);
18 if (okuma != oncekiOkuma && millis() - sonDegisim > 50) { // 50 ms debounce
19 sonDegisim = millis();
20 oncekiOkuma = okuma;
21 if (okuma == LOW) { // basıldı / pressed
22 ledDurum = !ledDurum;
23 digitalWrite(LED_PIN, ledDurum ? HIGH : LOW);
24 Serial.print("LED: ");
25 Serial.println(ledDurum ? "ACIK / ON" : "KAPALI / OFF");
26 }
27 }
28}Контакты кнопки Wokwi дребезжат, как у настоящей: при одном нажатии контакт несколько миллисекунд то замыкается, то размыкается. Поэтому в коде есть ожидание 50 мс; убери его, и иногда светодиод будет переключаться дважды. Эта полезная деталь помогает применять знания из симулятора в реальной схеме. Логика работы со временем подробно разобрана в статье «millis и delay».
diagram.json: подключение компонентов через файл
Всё, что ты рисуешь мышью, на самом деле записывается в файл проекта diagram.json. Его можно открыть во вкладках над редактором кода, изменить вручную или скопировать в другой проект. В файле три важных раздела: parts (детали, их типы, координаты и настройки), connections (провода) и необязательный dependencies. Вот файл diagram.json для схемы с Uno выше:
1{
2 "version": 1,
3 "author": "BlueGrays",
4 "editor": "wokwi",
5 "parts": [
6 { "type": "wokwi-arduino-uno", "id": "uno", "top": 0, "left": 0, "attrs": {} },
7 { "type": "wokwi-led", "id": "led1", "top": -96, "left": 172, "attrs": { "color": "red" } },
8 { "type": "wokwi-resistor", "id": "r1", "top": -24, "left": 120, "rotate": 90, "attrs": { "value": "220" } },
9 { "type": "wokwi-pushbutton", "id": "btn1", "top": -110, "left": 260, "attrs": { "color": "green", "bounce": "1" } }
10 ],
11 "connections": [
12 [ "uno:13", "r1:1", "green", [] ],
13 [ "r1:2", "led1:A", "green", [] ],
14 [ "led1:C", "uno:GND.1", "black", [] ],
15 [ "uno:2", "btn1:1.l", "blue", [] ],
16 [ "btn1:2.l", "uno:GND.2", "black", [] ]
17 ],
18 "dependencies": {}
19}| Поле | Что делает? | Пример |
|---|---|---|
| type | Тип детали | wokwi-led, wokwi-dht22, board-ssd1306 (примеры типов компонентов) |
| id | Имя детали; используется в описании проводов | led1, uno, esp |
| top / left / rotate (ключи положения и поворота) | Положение на экране (в пикселях) и угол поворота | "rotate": 90 |
| attrs | Настройки конкретной детали | "color": "red", "value": "220" (пример настроек attrs) |
| connections | Каждый провод: [начальный пин, конечный пин, цвет, путь] | ["uno:13", "r1:1", "green", []] |
| Формат имени пина | part-id:pin-name (формат id-компонента:имя-вывода) | uno:GND.1, esp:18, pico:GP14, btn1:1.l (примеры имён выводов) |
Самый простой способ узнать имя пина — навести на него курсор в области схемы; Wokwi покажет имя в небольшой подсказке. Четыре ножки кнопки называются 1.l, 2.l, 1.r, 2.r: ножки с одинаковым номером соединены внутри, а нажатие соединяет 1 и 2. Задай атрибуту кнопки bounce значение "0", чтобы отключить дребезг; если задать атрибуту key значение, например "1", кнопку можно будет нажимать и с клавиатуры. В больших схемах редактировать diagram.json вручную гораздо быстрее, чем по одному рисовать десятки проводов.
Добавление библиотек: libraries.txt
Чтобы установить библиотеку Arduino в Wokwi, открой вкладку Library Manager («Менеджер библиотек») над редактором кода, нажми кнопку + и найди библиотеку по имени. Выбранная библиотека добавляется отдельной строкой в файл проекта libraries.txt и автоматически устанавливается в облаке при сборке. Файл можно заполнить и вручную: каждая строка содержит имя одной библиотеки в точности как в менеджере библиотек Arduino:
1# Wokwi Library List
2Adafruit SSD1306
3Adafruit GFX Library
4DHT sensor library
5Adafruit NeoPixelВзаимодействие с датчиками: изменение значений во время симуляции
Самое наглядное в Wokwi — возможность задавать значения датчиков мышью. Во время симуляции нажми на DHT22, чтобы открыть ползунки температуры и влажности; нажми на HC-SR04, чтобы выбрать расстояние от 2 до 400 см. У датчика PIR есть кнопка имитации движения, у потенциометра — вращаемая ручка, а у модуля LDR — ползунок освещённости в люксах. Так можно за секунды проверить условие вроде «включить вентилятор, когда температура превысит 30 °C» и проверить пороги в коде, даже не имея настоящего датчика.
Моделирование Wi-Fi на ESP32
ESP32 в Wokwi подключается к виртуальной точке доступа Wokwi-GUEST. У этой сети нет пароля, она работает на канале 6; указание канала ускоряет подключение. Через шлюз Wokwi сеть получает доступ к настоящему интернету: можно узнавать время по NTP, отправлять HTTP-запросы на сервер или публиковать данные в MQTT-брокере. Код ниже подключает ESP32, выводит её IP-адрес и получает из интернета время Стамбула.
1#include <WiFi.h>
2#include <time.h>
3
4void setup() {
5 Serial.begin(115200);
6 WiFi.begin("Wokwi-GUEST", "", 6); // Wokwi sanal ağı: şifresiz, kanal 6 / Wokwi virtual network: open, channel 6
7 Serial.print("Baglaniyor / Connecting");
8 while (WiFi.status() != WL_CONNECTED) {
9 delay(250);
10 Serial.print(".");
11 }
12 Serial.println();
13 Serial.print("IP: ");
14 Serial.println(WiFi.localIP());
15 configTime(3 * 3600, 0, "pool.ntp.org"); // UTC+3 İstanbul, yaz saati yok / UTC+3 Istanbul, no DST
16}
17
18void loop() {
19 struct tm zaman; // saat bilgisi / time info
20 if (getLocalTime(&zaman)) {
21 Serial.printf("%02d:%02d:%02d\n", zaman.tm_hour, zaman.tm_min, zaman.tm_sec);
22 } else {
23 Serial.println("Saat alinamadi / Time not ready");
24 }
25 delay(1000);
26}При использовании этого кода на настоящей ESP32 достаточно указать имя и пароль своей сети; параметр канала можно убрать. На бесплатном тарифе ESP32 может устанавливать исходящие соединения с интернетом, но браузер на компьютере не может напрямую обратиться к веб-серверу внутри ESP32. Для этого нужен проброс портов в расширении VS Code или частный шлюз на платном тарифе. Подробности NTP и часовых поясов — в статье «Время по NTP на ESP32», а проблемы подключения реальной платы разобраны в статье «ESP32 не подключается к Wi-Fi».
Поддержка Raspberry Pi Pico и MicroPython

Если на главной странице выбрать шаблон MicroPython для Pico, откроется проект с файлом main.py. Нажми кнопку запуска: загрузится интерпретатор MicroPython, выполнится main.py, а в консоли внизу появится вывод print. После завершения программы эта же консоль переходит в REPL, где можно вводить команды и сразу экспериментировать. Если нужны дополнительные модули, например драйвер SSD1306, создай новый файл через меню файлов и вставь содержимое модуля. То же относится к ESP32: просто выбери шаблон MicroPython в разделе ESP32.
1from machine import Pin, ADC
2import time
3
4led = Pin(14, Pin.OUT) # LED + 220 ohm direnç / LED + 220 ohm resistor
5buton = Pin(2, Pin.IN, Pin.PULL_UP) # diğer uç GND / other leg to GND
6pot = ADC(26) # potansiyometre orta ucu GP26 / pot wiper on GP26
7
8durum = False
9onceki = 1
10son = time.ticks_ms() # son pot yazdırma zamanı / last pot print time
11while True:
12 okuma = buton.value()
13 if okuma == 0 and onceki == 1: # yeni basış / new press
14 durum = not durum
15 led.value(durum)
16 print("LED:", "ACIK" if durum else "KAPALI")
17 time.sleep_ms(50) # debounce
18 onceki = okuma
19 if time.ticks_diff(time.ticks_ms(), son) >= 500:
20 son = time.ticks_ms()
21 gerilim = pot.read_u16() * 3.3 / 65535 # 16 bit okuma -> volt / 16-bit reading -> volts
22 print("Pot: {:.2f} V".format(gerilim))
23 time.sleep_ms(10)В коде светодиод подключён к GP14, кнопка — к GP2, а движок потенциометра — к GP26 (ADC0); крайние выводы потенциометра идут к 3V3 и GND. АЦП Pico имеет разрядность 12 бит, но read_u16() в MicroPython возвращает значение, масштабированное в диапазон 0–65535. Если MicroPython пока незнаком, в статье «Основы MicroPython» поочерёдно разобраны Pin, ADC, PWM и команды работы со временем.
Просмотр сигналов с помощью логического анализатора
В Wokwi нет мультиметра, зато есть гораздо более мощный инструмент — Logic Analyzer (логический анализатор). Добавь его из списка деталей: он записывает 8 цифровых каналов (D0–D7). Подключи каналы к пинам, сигналы которых нужно измерить, а GND анализатора — к GND платы. После остановки симуляции запись скачивается в виде файла .vcd; открой его в бесплатной программе, например PulseView или GTKWave, чтобы определить частоту и длительность импульса, а также декодировать байты UART, I2C или SPI.
1// Mantık analizörü D0 -> Uno D9, D1 -> Uno D1 (TX), GND -> GND
2// Logic analyzer D0 -> Uno D9, D1 -> Uno D1 (TX), GND -> GND
3void setup() {
4 Serial.begin(9600);
5 analogWrite(9, 64); // %25 doluluk, yaklaşık 490 Hz / 25% duty, about 490 Hz
6}
7
8void loop() {
9 Serial.write('A'); // TX hattında çözülecek bayt / byte to decode on the TX line
10 delay(100);
11}В открытой записи канал D0 показывает прямоугольный сигнал с периодом около 2,04 мс (490 Hz); высокий уровень занимает четверть периода, примерно 0,51 мс. Это связано с тем, что analogWrite(9, 64) соответствует коэффициенту заполнения 64/255 ≈ 25%. На Uno пины 5 и 6 выдают 980 Hz, а остальные пины ШИМ — 490 Hz; это можно проверить анализатором. Добавь декодер UART к каналу D1 в PulseView, и каждые 100 мс будет виден байт 0x41 (A). О принципе работы ШИМ читай в статье «Что такое ШИМ?».
Расширение Wokwi для VS Code
Если для крупных проектов удобнее собственный редактор, чем браузер, установи расширение Wokwi Simulator в VS Code. Расширение не компилирует код; оно моделирует работу файла прошивки, собранного через PlatformIO, ESP-IDF или arduino-cli. Для личного использования действует бесплатная лицензия, которую нужно периодически продлевать. Порядок настройки:
- В VS Code найди Wokwi Simulator в разделе расширений (Extensions) и установи его.
- Открой палитру команд клавишей F1, выполни Wokwi: Request a New License (запросить новую лицензию) и подтверди лицензию на открывшейся в браузере странице.
- Добавь файлы wokwi.toml и diagram.json в корневую папку проекта. diagram.json можно скопировать из проекта со схемой, нарисованной в браузере.
- Собери проект обычным способом (Build в PlatformIO). Пути в wokwi.toml должны указывать на скомпилированные файлы .bin и .elf.
- Нажми F1 и выполни Wokwi: Start Simulator (запустить симулятор). Симуляция откроется во вкладке VS Code; после изменения кода и повторной сборки она перезапустится.
1# wokwi.toml (PlatformIO, esp32dev ortamı / environment)
2[wokwi]
3version = 1
4firmware = ".pio/build/esp32dev/firmware.bin"
5elf = ".pio/build/esp32dev/firmware.elf"
6
7# ESP32 web sunucusunu bilgisayardan açmak: http://localhost:8180
8# Open the ESP32 web server from your computer: http://localhost:8180
9[[net.forward]]
10from = "localhost:8180"
11to = "target:80"Раздел net.forward здесь перенаправляет веб-сервер с порта 80 на ESP32 на порт 8180 твоего компьютера. Так можно открыть в своём браузере проекты вроде веб-сервера ESP32 с WebSocket, не загружая прошивку в плату. Расширение также поддерживает пошаговую отладку через GDB; добавь строку gdbServerPort в wokwi.toml и подключи отладчик VS Code.
Различия Wokwi и Tinkercad
Оба симулятора бесплатны и работают в браузере, но решают разные задачи. Tinkercad выполняет электрический расчёт схемы: мультиметром можно измерить ток через резистор или напряжение на светодиоде; также он поддерживает блочный код. Wokwi эмулирует процессор платы и предлагает ESP32, Pico, Wi-Fi, MicroPython и широкую поддержку библиотек. Эффективнее всего начинать изучение основ электроники в Tinkercad, а проекты на ESP32 и IoT — в Wokwi. Подробнее познакомиться с Tinkercad поможет руководство по симулятору Arduino в Tinkercad.
| Возможность | Wokwi | Tinkercad Circuits |
|---|---|---|
| Платы | Uno, Nano, Mega, семейство ESP32, Pico, Pico W | Arduino Uno R3, ATtiny, micro:bit |
| Электрический расчёт | Нет; модель цифровых уровней и аналоговых значений | Есть; мультиметр и осциллограф |
| Wi-Fi и интернет | Есть, с ESP32 и Pico W | Нет |
| MicroPython | Есть, на Pico и ESP32 | Нет |
| Библиотеки | Большинство из менеджера библиотек | Около одиннадцати встроенных библиотек |
| Блочный код | Нет | Есть |
| Файл схемы | diagram.json, можно редактировать вручную | Только визуальный редактор |
| Измерения | Логический анализатор (.vcd) | Мультиметр, осциллограф |
| Работа на компьютере вне браузера | Расширение VS Code | Нет |
Поддерживаемые датчики и модули
| Группа | Есть в Wokwi | Отсутствует или ограничено |
|---|---|---|
| Свет и дисплеи | Светодиод, RGB-светодиод, лента и кольцо NeoPixel, LCD 16x2 и 20x4 (включая I2C), OLED SSD1306, TFT ILI9341, матрица MAX7219, TM1637, 7-сегментный индикатор | Электронная бумага и большинство цветных OLED |
| Ввод | Кнопка, переключатель, DIP-переключатель, потенциометр, поворотный энкодер (KY-040), джойстик, плёночная матричная клавиатура, ИК-приёмник и пульт | Сенсорный экран |
| Датчики | DHT22, DS18B20, HC-SR04, PIR, MPU6050, модуль LDR, модуль NTC, HX711 и тензодатчик, датчик газа MQ-2, датчики пламени, звука и наклона | DHT11 (используй DHT22), датчики цвета и отпечатков пальцев |
| Движение | Сервопривод, шаговый двигатель, драйвер A4988, модуль реле, зуммер | DC-мотор и драйверы моторов, например L298N |
| Связь и хранение данных | Часы реального времени DS1307, карта microSD, 74HC595, I2C, SPI, UART | RC522 RFID, nRF24L01, HC-05, SIM800L, GPS |
| Аналоговые схемы | Потенциометр и модули аналоговых датчиков | Настоящий аналоговый расчёт транзисторов, ОУ и конденсаторов |
Для детали, которой нет в списке, есть два варианта. Первый — использовать деталь с похожим поведением; например, проверять код для DHT11 на модели DHT22. Второй — функция Custom Chips (пользовательские микросхемы): небольшая программа, написанная тобой на C, компилируется в WebAssembly и добавляется в схему как новая деталь со своими пинами. Так можно самостоятельно смоделировать простой датчик I2C или модуль, обменивающийся данными по UART.
Ограничения симуляции: отличия от реальной схемы
- Нет электрического расчёта: светодиод без резистора продолжает светиться, а подача 5 V на пин ESP32 ничего не сжигает. В реальной схеме оба случая приводят к потере деталей. Рассчитывай ток и напряжение самостоятельно по закону Ома.
- Скорость: индикатор в углу области схемы показывает скорость симуляции в процентах от реального времени. Проекты ESP32 с Wi-Fi или большим числом деталей могут работать медленнее реального времени; учитывай это в коде, измеряющем длительности.
- Идеальные датчики: виртуальные датчики не шумят и не требуют калибровки. У настоящего DHT22 погрешность составляет ±0,5 °C, а HC-SR04 ошибается на мягких поверхностях; всё равно добавляй фильтрацию и проверку ошибок.
- Питание и батареи не моделируются: потребление тока, падение напряжения, нагрев стабилизатора и просадки питания в симуляции не проявляются.
- Нет Bluetooth: функции BLE и классического Bluetooth на ESP32 не моделируются.
- Ошибки подключения: в симуляции нет таких реальных проблем, как неплотно вставленная перемычка, неверный ряд макетной платы или холодная пайка; схема, работающая в симуляторе, может не заработать с первой попытки в реальности.
Как поделиться проектом и перенести его на реальную плату
Каждый сохранённый проект получает постоянный адрес; кнопкой Share («Поделиться») можно скопировать ссылку и отправить её другу, преподавателю или на форум. Тот, кто откроет ссылку, запустит проект одним нажатием и сможет скопировать его в свой аккаунт для внесения изменений. Поэтому Wokwi — самый быстрый способ показать схему вместе с кодом, когда обращаешься за помощью со словами «мой код не работает». Из меню рядом с кнопкой Save можно скачать проект в виде zip-архива с файлами sketch.ino, diagram.json и libraries.txt.
- Вставь код, работающий в симуляции, в новый скетч Arduino IDE или открой sketch.ino из скачанного zip-архива.
- Установи все библиотеки из libraries.txt через «Менеджер библиотек» (Library Manager) Arduino IDE.
- В коде Wi-Fi вместо Wokwi-GUEST укажи имя и пароль своей сети.
- Составь таблицу пинов по соединениям из diagram.json и собери схему на макетной плате по этой таблице. Не забудь добавить резисторы, которые не требовались в Wokwi (резистор светодиода, подтягивающие резисторы I2C).
- Выбери плату и порт и загрузи код. Если что-то пойдёт не так, следуй шагам из руководства «Код не загружается в Arduino».
Идеи проектов для Wokwi
- Метеостанция с OLED: выводи температуру и влажность на экран с помощью ESP32, DHT22 и SSD1306; изменяй значения ползунками. Код для дисплея есть в статье «OLED-дисплей SSD1306».
- Парктроник: меняй частоту сигналов зуммера в зависимости от расстояния HC-SR04 и проверяй все пороги ползунком расстояния. Подробности — в статье «Датчик расстояния HC-SR04».
- Анимации NeoPixel: пробуй цветовые переходы на кольце или матрице WS2812B и создавай эффекты, прежде чем думать об источнике питания для настоящей ленты. См. статью «Светодиоды WS2812B NeoPixel».
- Домашняя автоматизация с MQTT: отправляй температуру с виртуальной ESP32 на MQTT-брокер. Для настройки следуй руководству «ESP32, MQTT и Home Assistant».
- Кодовый замок с клавиатурой: собери дверной замок с плёночной матричной клавиатурой, сервоприводом и LCD и отслеживай неверные попытки ввода кода в мониторе порта.
- Опыты с прерываниями: считывай кнопку через attachInterrupt и наблюдай логическим анализатором, как дребезг увеличивает число прерываний. См. статью «Прерывания Arduino».
Частые ошибки и их решения
| Симптом | Возможная причина | Решение |
|---|---|---|
| ESP32 не подключается к Wi-Fi, точки выводятся бесконечно | Неверное имя сети или указан пароль | Используй WiFi.begin("Wokwi-GUEST", "", 6); имя сети чувствительно к регистру |
| Ошибка «No such file or directory» (нет такого файла или каталога) | Библиотеки нет в libraries.txt | Добавь библиотеку на вкладке Library Manager |
| Светодиод не горит | Светодиод подключён наоборот (перепутаны A и C) или нет провода GND | Подключи длинную ножку A к резистору, а C к GND |
| Одно нажатие кнопки увеличивает счётчик дважды | Моделируется дребезг контактов кнопки | Добавь антидребезг в код или используй "bounce": "0" при проверке |
| Симуляция работает очень медленно | Непрерывный вывод через Serial без задержки в цикле | Добавь небольшую задержку delay в loop и сократи лишний вывод |
| Ошибка «ImportError: no module named» в MicroPython (модуль не найден) | В проекте нет файла модуля | Создай новый файл через меню файлов и вставь модуль |
| Веб-сервер ESP32 не открывается в браузере | Бесплатный шлюз разрешает только исходящие соединения | Используй net.forward в расширении VS Code |
| Проект исчез | Работа велась без входа в аккаунт | Сохрани проект через Save; для чужого проекта выбери Save a copy |
Wokwi — самый удобный способ проверить идею до покупки деталей, показать ошибку вместе со схемой и безопасно попробовать код Wi-Fi, особенно для ESP32 и Pico. В большинстве проектов приложения BlueGrays есть видео симуляции, записанное во время работы схемы в Wokwi; ещё до сборки можно увидеть, когда загорается светодиод и как обновляется дисплей, а затем собрать тот же проект на реальной плате по пошаговой схеме и коду.
Частые вопросы
Wokwi бесплатный?
Да, основные возможности браузерной версии Wokwi бесплатны: можно создавать, сохранять и публиковать проекты, а также выводить ESP32 в интернет через виртуальный Wi-Fi. Дополнительные функции, такие как частный шлюз и ускоренная сборка, доступны на платном тарифе. Расширение VS Code также работает по бесплатной лицензии для личного использования.
Как подключить ESP32 к Wi-Fi в Wokwi?
В коде ESP32 используй Wokwi-GUEST в качестве имени сети и пустую строку вместо пароля: WiFi.begin("Wokwi-GUEST", "", 6). Последний параметр, канал 6, ускоряет подключение. После подключения ESP32 получает доступ к настоящему интернету по NTP, HTTP и MQTT.
Что лучше: Wokwi или Tinkercad?
Tinkercad лучше подходит для изучения основ электроники, измерения тока и напряжения мультиметром и работы с блочным кодом. Wokwi выделяется в проектах, которым нужны ESP32, Raspberry Pi Pico, Wi-Fi, MicroPython и множество библиотек. Многие ученики используют оба симулятора.
Как добавить библиотеку в Wokwi?
Открой вкладку Library Manager над редактором кода, нажми кнопку +, найди библиотеку и выбери её. Библиотека добавится в файл libraries.txt и автоматически установится при сборке. Можно также вручную вписать её имя в файл в точности как в менеджере библиотек Arduino.
Есть ли DHT11 в Wokwi?
В списке деталей Wokwi есть DHT22, но нет DHT11. Чтобы проверить код для DHT11, добавь в схему DHT22 и укажи в библиотеке тип датчика DHT22. При переходе на реальную плату достаточно снова изменить тип на DHT11.
Можно ли загрузить код из Wokwi в реальную плату?
Да. Wokwi выполняет стандартный код Arduino и MicroPython, поэтому тот же код можно загрузить в реальную плату через Arduino IDE или Thonny. Достаточно установить библиотеки, изменить имя и пароль сети Wi-Fi и добавить в схему резисторы, которые не требовались в Wokwi.
Что собрать после прочтения
Все проекты
Мигающий светодиод на ESP32
Учит базовой работе с выходами GPIO на ESP32. Эффект мигания получается включением и выключением светодиода с цифрового пина. Это ESP32-версия классического проекта мигания на Arduino UNO; базовые команды мигания в среде Arduino те же, но расположение пинов ESP32 и уровни GPIO 3,3 V отличаются от Arduino UNO.

Управление светодиодом кнопкой на ESP32 (удержание)
Светодиод горит, когда кнопка нажата, и гаснет, когда её отпускают. Показывает, как используются цифровой входной пин ESP32 и встроенный подтягивающий резистор. Режим INPUT_PULLUP избавляет от внешнего резистора.

Управление светодиодом кнопкой на ESP32 (переключение)
При каждом нажатии кнопки состояние светодиода меняется: если горел — гаснет, если не горел — загорается. Классический шаблон переключения. Антидребезг убирает механический шум кнопки, чтобы одно нажатие давало одно переключение.

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

Raspberry Pi Pico: управление внешним светодиодом (макетная плата)
Следующий шаг после встроенного светодиода Pico: подключить внешний светодиод на макетной плате и управлять им через пин GP14. В этом проекте ты узнаешь, как использовать любой пин GPIO общего назначения у Pico как выход, какая полярность у светодиода (длинная ножка = анод/+, короткая = катод/–) и зачем нужен токоограничивающий резистор (220Ω). Без резистора через светодиод пойдёт слишком большой ток, и он может сгореть. Схема очень простая: Pico GP14 → резистор 220Ω → светодиод → GND.

Светодиод с управлением кнопкой на Pico (удержание)
Первый проект Pico с входом — чтение кнопки! Светодиод горит, пока кнопка нажата, и гаснет после отпускания. Это большой шаг после светодиодных анимаций: сигнал из внешнего мира в Pico. Изучи Pin.IN (режим входа), Pin.PULL_UP (встроенный подтягивающий резистор — стандарт для кнопок) и чтение button.value(). Светодиод на GP14, кнопка на GP2 (встроенный PULL_UP). Нажата = LOW (0), отпущена = HIGH (1) — обратная логика сначала путает, но это промышленный стандарт.

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

Точное время из интернета через NTP на ESP32
ESP32 подключается к Wi-Fi и получает точное время с точностью до миллисекунд от серверов NTP (Network Time Protocol). Благодаря функции configTzTime() автоматически применяется часовой пояс Турции (TRT, UTC+3), а в странах с летним временем переходы обрабатываются автоматически по строке POSIX TZ. Время выводится в монитор порта и на необязательный I2C LCD. configTzTime() запускает службу SNTP, которая периодически пересинхронизирует часы.
Другие статьи
Приложение BlueGrays
Собери эту схему шаг за шагом в телефоне
Схема подключения, код и список деталей на одном экране. 500+ проектов на Arduino, ESP32 и Pico готовы к сборке.
Наведи камеру телефона
Наведи камеру на код — откроется магазин приложений на телефоне.
или открыть магазин

