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

Руководство по симулятору 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. В конце разберём, какие датчики поддерживаются, чем симуляция отличается от реальной схемы и как поделиться проектом.

Отладочная плата ESP32
Сильная сторона Wokwi — поддержка ESP32: Wi-Fi, ШИМ, АЦП, I2C и SPI моделируются так же, как на реальной плате.

Что такое 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 Unowokwi-arduino-uno (тип платы в diagram.json)Arduino C++ATmega328P, логика 5 V, самая быстрая симуляция
Arduino Nanowokwi-arduino-nano (тип платы в diagram.json)Arduino C++Та же микросхема, что у Uno, плата меньше
Arduino Megawokwi-arduino-mega (тип платы в diagram.json)Arduino C++8 КБ SRAM, проекты с большим числом пинов
ESP32 DevKitboard-esp32-devkit-c-v4Arduino C++, MicroPython, ESP-IDFWi-Fi есть, Bluetooth нет
ESP32-S3 / ESP32-C3board-esp32-s3-devkitc-1 / board-esp32-c3-devkitm-1 (типы плат ESP32-S3 / ESP32-C3)Arduino C++, MicroPython, ESP-IDFБолее новые семейства ESP32
Raspberry Pi Picowokwi-pi-picoMicroPython, CircuitPython, Arduino C++RP2040, логика 3,3 V
Raspberry Pi Pico Wboard-pi-pico-wMicroPython, Arduino C++С Wi-Fi

Твой первый проект Wokwi в браузере: шаг за шагом

  1. Открой wokwi.com в браузере. На главной странице есть разделы Arduino, ESP32 и Raspberry Pi Pico; выбери один из них, чтобы увидеть готовые шаблоны и примеры проектов.
  2. Чтобы начать с пустого проекта, выбери шаблон Arduino Uno в разделе Arduino. Экран разделён надвое: слева редактор кода (sketch.ino), справа область схемы, где изображена электрическая цепь.
  3. Нажми синюю кнопку + над правой областью и введи LED в поле поиска. Выбранная деталь появится рядом с платой; перетащи её мышью в нужное место.
  4. Таким же способом добавь Resistor (резистор) и Pushbutton (кнопку). При нажатии на деталь открывается небольшая панель, где можно изменить её цвет или номинал; задай резистору 220 Ω.
  5. Чтобы нарисовать провод, нажми на конец пина, затем на пин, к которому он должен подключаться. Для изгиба провода нажми на свободное место между ними. Нажми на провод, чтобы изменить его цвет, или удали его клавишей Delete.
  6. Введи код слева или вставь пример ниже, затем нажми зелёную кнопку запуска. Первая сборка занимает несколько секунд; затем начинается симуляция, а если используется Serial.begin, внизу открывается монитор порта.
  7. Во время симуляции нажимай кнопку мышью. Чтобы остановить симуляцию, нажми квадратную кнопку. Для сохранения проекта нажми Save («Сохранить»); при первом сохранении потребуется войти в аккаунт, после чего проект получит постоянную ссылку.
Проект, созданный без входа в аккаунт, не сохраняется и исчезает при закрытии вкладки. Если открыть чужой проект, твои изменения не записываются в него; используй Save a copy («Сохранить копию»), чтобы скопировать проект в свой аккаунт.

Первая схема: включение и выключение светодиода кнопкой

Классический первый опыт с кнопкой и светодиодом можно собрать на всех трёх платах с одинаковой логикой работы. Длинная ножка светодиода (анод, A в Wokwi) подключается через резистор к выходному пину, а короткая (катод, C) — к GND. Одна сторона кнопки подключается к входному пину, другая — к GND; код включает встроенный подтягивающий резистор. Для расчёта резистора светодиода в своей схеме используй калькулятор резистора для светодиода.

ПодключениеArduino UnoESP32Raspberry Pi Pico
Анод светодиода (A), через резистор 220 ΩD13GPIO 18GP14
Катод светодиода (C)GNDGNDGND
Ножка кнопки 1D2GPIO 4GP2
Ножка кнопки 2GNDGNDGND
Логический уровень5 V3,3 V3,3 V
C++ (Arduino IDE)
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
Если при сборке появляется ошибка No such file or directory (нет такого файла или каталога), библиотеки нет в libraries.txt или её имя написано с ошибкой. Как установить библиотеку в настоящей Arduino IDE, читай в статье «Как добавить библиотеку Arduino».

Взаимодействие с датчиками: изменение значений во время симуляции

Самое наглядное в Wokwi — возможность задавать значения датчиков мышью. Во время симуляции нажми на DHT22, чтобы открыть ползунки температуры и влажности; нажми на HC-SR04, чтобы выбрать расстояние от 2 до 400 см. У датчика PIR есть кнопка имитации движения, у потенциометра — вращаемая ручка, а у модуля LDR — ползунок освещённости в люксах. Так можно за секунды проверить условие вроде «включить вентилятор, когда температура превысит 30 °C» и проверить пороги в коде, даже не имея настоящего датчика.

Моделирование Wi-Fi на ESP32

ESP32 в Wokwi подключается к виртуальной точке доступа Wokwi-GUEST. У этой сети нет пароля, она работает на канале 6; указание канала ускоряет подключение. Через шлюз Wokwi сеть получает доступ к настоящему интернету: можно узнавать время по NTP, отправлять HTTP-запросы на сервер или публиковать данные в MQTT-брокере. Код ниже подключает ESP32, выводит её IP-адрес и получает из интернета время Стамбула.

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

Wokwi моделирует Wi-Fi ESP32, но Bluetooth и BLE не моделируются. Код с BLE или классическим Bluetooth компилируется, однако устройство, к которому можно подключиться с телефона, не появляется; эти части нужно проверять на реальной плате.

Поддержка Raspberry Pi Pico и MicroPython

Плата Raspberry Pi Pico
В Wokwi можно запустить Pico с MicroPython и проверить код в браузере, прежде чем переходить к Thonny.

Если на главной странице выбрать шаблон MicroPython для Pico, откроется проект с файлом main.py. Нажми кнопку запуска: загрузится интерпретатор MicroPython, выполнится main.py, а в консоли внизу появится вывод print. После завершения программы эта же консоль переходит в REPL, где можно вводить команды и сразу экспериментировать. Если нужны дополнительные модули, например драйвер SSD1306, создай новый файл через меню файлов и вставь содержимое модуля. То же относится к ESP32: просто выбери шаблон MicroPython в разделе ESP32.

MicroPython
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.

C++ (Arduino IDE)
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. Для личного использования действует бесплатная лицензия, которую нужно периодически продлевать. Порядок настройки:

  1. В VS Code найди Wokwi Simulator в разделе расширений (Extensions) и установи его.
  2. Открой палитру команд клавишей F1, выполни Wokwi: Request a New License (запросить новую лицензию) и подтверди лицензию на открывшейся в браузере странице.
  3. Добавь файлы wokwi.toml и diagram.json в корневую папку проекта. diagram.json можно скопировать из проекта со схемой, нарисованной в браузере.
  4. Собери проект обычным способом (Build в PlatformIO). Пути в wokwi.toml должны указывать на скомпилированные файлы .bin и .elf.
  5. Нажми 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.

ВозможностьWokwiTinkercad Circuits
ПлатыUno, Nano, Mega, семейство ESP32, Pico, Pico WArduino 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, UARTRC522 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.

  1. Вставь код, работающий в симуляции, в новый скетч Arduino IDE или открой sketch.ino из скачанного zip-архива.
  2. Установи все библиотеки из libraries.txt через «Менеджер библиотек» (Library Manager) Arduino IDE.
  3. В коде Wi-Fi вместо Wokwi-GUEST укажи имя и пароль своей сети.
  4. Составь таблицу пинов по соединениям из diagram.json и собери схему на макетной плате по этой таблице. Не забудь добавить резисторы, которые не требовались в Wokwi (резистор светодиода, подтягивающие резисторы I2C).
  5. Выбери плату и порт и загрузи код. Если что-то пойдёт не так, следуй шагам из руководства «Код не загружается в 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
Прежде чем расширять проект, сделай копию рабочей версии через Save a copy и пробуй новую возможность в копии. Если что-то сломается, вернуться к рабочей версии можно одним нажатием; эта привычка также хорошо готовит к использованию git в реальных проектах.

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
ES-1Новичок

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

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

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

Управление светодиодом кнопкой на ESP32 (удержание)

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

4.6(36)
57
Управление светодиодом кнопкой на ESP32 (переключение)
ES-3Новичок

Управление светодиодом кнопкой на ESP32 (переключение)

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

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

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

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

4.6(36)
55
Raspberry Pi Pico: управление внешним светодиодом (макетная плата)
PI-2Новичок

Raspberry Pi Pico: управление внешним светодиодом (макетная плата)

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

4.5(2)
7
Светодиод с управлением кнопкой на Pico (удержание)
PI-9Новичок
Premium

Светодиод с управлением кнопкой на Pico (удержание)

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

11
Подключение 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
Точное время из интернета через NTP на ESP32
ES-26Продвинутый
Premium

Точное время из интернета через NTP на ESP32

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

4.5(13)
22