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

Установка PlatformIO: руководство по Arduino, ESP32 и Pico в VS Code

Установка PlatformIO в VS Code: настройка Uno, ESP32 и Pico в platformio.ini, библиотеки через lib_deps, загрузка кода и переход с Arduino IDE.

Установка PlatformIO добавляет в VS Code одно расширение и позволяет программировать такие платы, как Arduino Uno, ESP32 и Raspberry Pi Pico, из одной профессиональной среды. Коротко: установи VS Code, найди на вкладке «Расширения» PlatformIO IDE и установи его, дождись, пока при первом запуске скачаются нужные инструменты, а затем создай новый проект на экране PIO Home, выбрав свою плату. Всё остальное задаётся в небольшом файле настроек platformio.ini: какая плата, какой фреймворк, какие библиотеки и какая скорость последовательного порта используются — всё записано там.

Arduino IDE — отличный инструмент для обучения, но по мере роста проекта начинают ощущаться её ограничения: автодополнение кода базовое, библиотеки общие для всех проектов, обновление библиотеки может сломать старый проект, а настройки платы не сохраняются вместе с проектом. PlatformIO решает эти проблемы. В этом руководстве пошагово разберём установку, создадим первый проект, опишем три разные платы в одном проекте через platformio.ini, добавим библиотеку, загрузим код, откроем монитор порта и узнаем, как перенести существующие проекты из Arduino IDE. В последнем разделе честно сравним оба инструмента, чтобы было проще решить, какой из них подходит тебе.

Плата Arduino Uno, которую программируют в PlatformIO
С PlatformIO такие платы, как Arduino Uno, ESP32 и Raspberry Pi Pico, можно программировать из одного редактора с одним файлом настроек.

Что такое PlatformIO и как он работает?

PlatformIO — экосистема для разработки встраиваемых систем с открытым исходным кодом. В её основе лежит инструмент командной строки на Python под названием PlatformIO Core; расширение для VS Code делает работу с ним удобной благодаря кнопкам, меню и экрану PIO Home. При сборке проекта PlatformIO сначала читает platformio.ini, затем скачивает из своего реестра нужный компилятор (avr-gcc для Uno, тулчейн Xtensa для ESP32, arm-none-eabi-gcc для Pico), фреймворк и библиотеки и компилирует твой код. Эти пакеты скачиваются только один раз и хранятся в папке .platformio в каталоге пользователя; следующие проекты используют те же пакеты повторно. Если знать понятия ниже, читать этот файл гораздо проще:

ПонятиеЗначениеПример
Платформа (platform)Пакет компилятора и инструментов загрузки для семейства микроконтроллеровatmelavr, espressif32, raspberrypi
Board (плата)Конкретная плата внутри платформы; карта пинов, тактовая частота и сведения о памятиuno, nanoatmega328, esp32dev, pico
Framework (фреймворк)Программная основа, на которой пишется твой кодarduino, espidf
Окружение (env)Раздел, в котором вместе задаются платформа, плата, фреймворк и дополнительные настройки[env:uno]
БиблиотекаГотовый пакет кода, который добавляется в проект через lib_depsadafruit/DHT sensor library (название библиотеки)
PIO HomeЭкран для открытия проектов и поиска плат и библиотекЗначок домика в строке состояния

Установка PlatformIO шаг за шагом

  1. Скачай Visual Studio Code с официального сайта и установи. В Windows галочка Add to PATH при установке упрощает работу с терминалом.
  2. Открой VS Code и нажми на вкладку «Расширения» (Extensions) слева или используй сочетание Ctrl+Shift+X (Cmd+Shift+X в macOS).
  3. Введи в поле поиска PlatformIO IDE и установи расширение от издателя PlatformIO кнопкой Install («Установить»). Нужное расширение C/C++ установится автоматически.
  4. Справа внизу появится уведомление «Installing PlatformIO Core» (установка PlatformIO Core). В зависимости от скорости интернета это занимает несколько минут; в это время не закрывай VS Code.
  5. Когда установка завершится, VS Code предложит перезапуститься. После перезапуска на левой панели появится значок PlatformIO, а в нижней строке состояния — значок домика.
  6. Нажми на значок домика, чтобы открыть экран PIO Home. Если этот экран отображается нормально, установка завершена.
Если в имени пользователя Windows есть символы не из английского алфавита (например, ş, ğ, ı, ü или кириллица) или пробелы, у тулчейна PlatformIO могут возникнуть проблемы с путём C:\Users\<name>\.platformio, и сборка может остановиться с непонятными ошибками путей. Решение — добавить в системные переменные среды PLATFORMIO_CORE_DIR и указать в качестве значения папку только из английских букв, например C:\platformio. Если установка в Linux завершается ошибкой, сначала убедись, что установлен пакет python3-venv.

Создание первого проекта и структура папок

Нажми в PIO Home кнопку New Project («Новый проект»). В открывшемся окне дай проекту имя (например, blink-uno), введи в поле Board Arduino Uno и выбери её из списка, оставь фреймворк Arduino и укажи расположение. После нажатия Finish PlatformIO впервые скачивает пакет платформы для выбранной платы; поэтому первый проект может создаваться несколько минут, а следующие открываются за секунды. Когда проект создан, VS Code открывает папку, и в ней видна такая структура:

Папка / файлДля чего нужна
platformio.iniСердце проекта: настройки платы, фреймворка, библиотек и порта
src/Твой исходный код; программа начинается с main.cpp
include/Твои собственные заголовочные файлы (.h)
lib/Локальные библиотеки проекта, добавленные вручную (каждая в своей подпапке)
test/Папка для модульных тестов (unit test)
.pio/Результаты сборки и скачанные библиотеки; при удалении создаётся заново
.vscode/Настройки VS Code и IntelliSense; создаются автоматически

Что такое файл platformio.ini?

platformio.ini — обычный текстовый файл в формате INI. Каждый раздел [env:имя], начинающийся с квадратной скобки, задаёт окружение сборки. Плата и скорость порта, которые в Arduino IDE выбираются в меню «Инструменты» (Tools), здесь записываются текстом; поэтому при переносе проекта на другой компьютер или передаче другу настройки едут вместе с кодом. Строки, начинающиеся с точки с запятой, — это комментарии. Если добавить в файл, созданный для Uno, скорость монитора порта, он выглядит так:

C++ (Arduino IDE)
1; PlatformIO proje ayarları / PlatformIO project settings
2[env:uno]
3platform = atmelavr
4board = uno
5framework = arduino
6; Seri monitör hızı, Serial.begin ile aynı olmalı / Monitor speed, must match Serial.begin
7monitor_speed = 115200
НастройкаЧто делаетПример значения
platformИспользуемый пакет платформы; версию тоже можно зафиксироватьatmelavr, [email protected]
boardИдентификатор платыuno, megaatmega2560, esp32dev, pico
frameworkПрограммный фреймворкarduino
monitor_speedСкорость монитора порта (по умолчанию 9600)115200
upload_portПорт для загрузки (если не указан, находится автоматически)COM5, /dev/ttyUSB0
upload_speedСкорость загрузки в бодах (особенно на платах ESP)921600
lib_depsБиблиотеки для автоматического скачиванияadafruit/DHT sensor library@^1.4.4 (библиотека версии 1.4.4 или совместимой)
build_flagsДополнительные флаги и макросы для компилятора-D LED_PIN=2
monitor_filtersФильтры, применяемые к выводу монитора портаtime, esp32_exception_decoder

Первый код: main.cpp и разница с Arduino.h

Файл main.cpp в папке src — аналог файла .ino в Arduino IDE, но есть два важных отличия. Во-первых, файл должен начинаться со строки #include, подключающей заголовочный файл Arduino.h; Arduino IDE добавляет его незаметно, а PlatformIO — нет. Во-вторых, файл .cpp подчиняется настоящим правилам C++: компилятор должен знать функцию до того, как её вызывают. Arduino IDE создаёт прототипы функций за тебя; в PlatformIO нужно либо определить функцию до её использования, либо написать однострочный прототип в начале файла. Пример ниже — программа blink, которая одинаково работает на Uno, ESP32 и Pico:

C++ (Arduino IDE)
1#include <Arduino.h>
2
3// LED_PIN platformio.ini'den gelebilir / LED_PIN may come from platformio.ini
4#ifndef LED_PIN
5#define LED_PIN LED_BUILTIN   // Uno: 13, Pico: GP25
6#endif
7
8void blinkLed(int count);     // prototip / prototype
9
10void setup() {
11  Serial.begin(115200);
12  pinMode(LED_PIN, OUTPUT);
13  Serial.println("PlatformIO hazir / ready");
14}
15
16void loop() {
17  blinkLed(3);
18  delay(1000);
19}
20
21void blinkLed(int count) {
22  for (int i = 0; i < count; i++) {
23    digitalWrite(LED_PIN, HIGH);
24    delay(150);
25    digitalWrite(LED_PIN, LOW);
26    delay(150);
27  }
28  Serial.print("Yanip sondu / Blinked: ");
29  Serial.println(count);
30}
Если при компиляции появляется ошибка 'blinkLed' was not declared in this scope (функция не объявлена в этой области видимости), почти всегда не хватает прототипа. Достаточно скопировать первую строку функции над setup() без тела и с точкой с запятой в конце. Если функций много, аккуратнее собрать их в файле .h в папке include.

Сборка, загрузка и монитор порта

ДействиеСтрока состояния / менюКоманда терминала
Сборка (Build)Галочкаpio run
Загрузка (Upload)Стрелка вправоpio run -t upload (команда загрузки прошивки)
Загрузить и открыть мониторМеню PlatformIO › Upload and Monitorpio run -t upload -t monitor (загрузка и открытие монитора порта)
Монитор портаЗначок вилкиpio device monitor (открывает монитор последовательного порта)
ОчисткаКорзинаpio run -t clean (удаляет файлы сборки)
Список портовPIO Home › Devicespio device list (выводит список портов)
Собрать конкретное окружениеПереключатель окружений (env:...)pio run -e esp32dev
Установить библиотекуPIO Home › Librariespio pkg install -l "adafruit/DHT sensor library" (устанавливает библиотеку)

Чтобы монитор порта работал правильно, значение monitor_speed в platformio.ini должно совпадать со скоростью Serial.begin() в коде; иначе на экране будут мусорные символы. Обычно PlatformIO сам находит подключённую плату, но если к компьютеру подключено несколько последовательных устройств, он может попытаться загрузить код не в тот порт. В этом случае выведи список портов командой pio device list и впиши нужный в строки upload_port и monitor_port. Если порт занят монитором порта Arduino IDE или другой терминальной программой, загрузка останавливается с ошибкой «Access is denied» (доступ запрещён) или «Resource busy» (ресурс занят); достаточно закрыть эту программу. Чтобы лучше разобраться в самом мониторе порта, загляни в статью Монитор порта Arduino. Команда pio всегда работает в терминале PlatformIO Core CLI, который открывается из меню PlatformIO.

Uno, ESP32 и Pico в одном проекте

Одна из самых сильных сторон PlatformIO — возможность собирать один и тот же код для нескольких плат. Для каждой платы пишется отдельный раздел [env:...]; если вынести общие настройки в безымянный раздел [env], все окружения унаследуют их. В таблице ниже собраны основные значения для трёх популярных плат:

ПараметрArduino UnoESP32 DevKitRaspberry Pi Pico
platformatmelavrespressif32raspberrypi
boardunoesp32devpico
frameworkarduinoarduinoarduino (ядро Arduino Mbed)
Встроенный светодиодD13GPIO 2 (на большинстве плат DevKit)GP25
Способ загрузкиUSB-UART и загрузчикUSB-UART и esptoolUSB и режим BOOTSEL
Типичный monitor_speed9600 или 115200115200115200
C++ (Arduino IDE)
1[platformio]
2; Varsayılan ortam / Default environment
3default_envs = uno
4
5; Tüm ortamlarda ortak ayarlar / Settings shared by all environments
6[env]
7framework = arduino
8monitor_speed = 115200
9
10[env:uno]
11platform = atmelavr
12board = uno
13
14[env:esp32dev]
15platform = espressif32
16board = esp32dev
17upload_speed = 921600
18monitor_filters = esp32_exception_decoder
19; Dahili LED GPIO 2 / Onboard LED on GPIO 2
20build_flags = -D LED_PIN=2
21
22[env:pico]
23platform = raspberrypi
24board = pico

Строка default_envs определяет, какое окружение используют кнопки сборки и загрузки в строке состояния; если её не написать, PlatformIO по очереди соберёт все окружения из файла. Переключиться на другую плату можно на лету через переключатель окружений в строке состояния или загрузить код сразу в ESP32, набрав в терминале pio run -e esp32dev -t upload. Флаг -D LED_PIN=2 в окружении ESP32 определяет в коде макрос LED_PIN; поскольку у Uno и Pico этого флага нет, код берёт значение LED_BUILTIN (13 и 25). Так один и тот же main.cpp работает на всех трёх платах без единого изменения. Чтобы быстро посмотреть расположение пинов на платах, воспользуйся утилитой распиновки.

Настройки PlatformIO для ESP32

Платы ESP32 в PlatformIO загружаются через esptool, как и в Arduino IDE. upload_speed = 921600 заметно сокращает время загрузки; если кабель длинный или некачественный и появляются ошибки, снизь скорость до 460800 или 115200. Фильтр esp32_exception_decoder превращает непонятный дамп адресов, который выводится в монитор порта при падении платы, в имена функций и номера строк; это очень ценно для поиска ошибок Guru Meditation. Если загрузка зависает на этапе «Connecting...» (подключение), зажми кнопку BOOT на плате и отпусти, когда загрузка начнётся; подробные решения — в статье ESP32 Failed to Connect. Ещё одна деталь, которую стоит знать, — версия ядра: официальная платформа espressif32 в PlatformIO долгое время использовала ядро Arduino-ESP32 версии 2.x; если нужны API, появившиеся в 3.x, можно перейти на платформу pioarduino, которую поддерживает сообщество. Какое ядро используется, видно по версии framework-arduinoespressif32 в строке PACKAGES в начале вывода сборки. Если нужно, чтобы код компилировался на обеих версиях, их можно различать с помощью макроса ESP_ARDUINO_VERSION_MAJOR.

Raspberry Pi Pico и PlatformIO

С настройкой board = pico официальная платформа raspberrypi использует официальное ядро RP2040 от Arduino на основе Mbed OS. Многие предпочитают ядро arduino-pico от Earle Philhower, у которого больше возможностей и лучше совместимость с библиотеками; в PlatformIO оно подключается через отдельный пакет платформы, который поддерживает сообщество, и настройку board_build.core = earlephilhower. Какое бы ядро ни было выбрано, для первой загрузки может понадобиться подключить Pico к USB с зажатой кнопкой BOOTSEL; плата появится на компьютере как диск RPI-RP2, а после того как PlatformIO загрузит программу, она сама перезагрузится. Для последующих загрузок кнопка обычно не нужна. Важное замечание: PlatformIO не поддерживает MicroPython. Чтобы программировать Pico на MicroPython, нужен редактор вроде Thonny; подробности — в статьях Основы MicroPython и Что такое Raspberry Pi Pico?

Добавление библиотек: lib_deps

В PlatformIO библиотеки устанавливаются не для всего компьютера, а отдельно для каждого проекта. Самый чистый способ — добавить строку lib_deps в platformio.ini: при первой сборке PlatformIO скачает библиотеку из реестра (registry) и положит её в папку .pio/libdeps/. Можно также найти точное название библиотеки на вкладке Libraries в PIO Home и добавить её кнопкой Add to Project («Добавить в проект»); эта кнопка сама напишет строку lib_deps. Ниже пример с датчиком DHT11, подключённым к пину D2 платы Uno; схема подключения датчика — в статье Датчик температуры и влажности DHT11.

C++ (Arduino IDE)
1[env:uno]
2platform = atmelavr
3board = uno
4framework = arduino
5monitor_speed = 115200
6; Kütüphaneler ilk derlemede otomatik iner / Libraries download on first build
7lib_deps =
8    adafruit/DHT sensor library@^1.4.4
9    adafruit/Adafruit Unified Sensor@^1.1.9
C++ (Arduino IDE)
1#include <Arduino.h>
2#include <DHT.h>
3
4#define DHT_PIN 2        // Uno D2 pini / Uno pin D2
5#define DHT_TYPE DHT11
6
7DHT dht(DHT_PIN, DHT_TYPE);
8
9void setup() {
10  Serial.begin(115200);
11  dht.begin();
12}
13
14void loop() {
15  delay(2000);                        // DHT11 en fazla 1 Hz / DHT11 max 1 Hz
16  float h = dht.readHumidity();
17  float t = dht.readTemperature();
18  if (isnan(h) || isnan(t)) {
19    Serial.println("Sensor okunamadi / Read failed");
20    return;
21  }
22  Serial.print("Sicaklik / Temp: ");
23  Serial.print(t, 1);
24  Serial.print(" C  Nem / Hum: ");
25  Serial.print(h, 0);
26  Serial.println(" %");
27}

В записи версий ^1.4.4 разрешает версии от 1.4.4 и выше, но ниже 2.0.0; ~1.4.4 принимает только исправления 1.4.x; если написать просто 1.4.4, версия фиксируется полностью. Фиксация версий гарантирует, что через год тот же код соберётся точно так же. Если положить библиотеку, которой нет в реестре, или собственную библиотеку в папку lib проекта как подпапку с её названием, PlatformIO найдёт её автоматически. Чтобы сравнить это с тем, как устроены библиотеки в Arduino IDE, прочитай статью Как добавить библиотеку в Arduino.

Перенос проекта из Arduino IDE в PlatformIO

  1. Создай новый проект в PIO Home и выбери ту же плату, что и в Arduino IDE.
  2. Вставь содержимое файла .ino в src/main.cpp; другие вкладки .ino из той же папки добавь в конец main.cpp, а файлы .h и .cpp скопируй в папку src.
  3. Добавь в самое начало файла строку #include для Arduino.h.
  4. Для каждой функции, кроме setup() и loop(), напиши прототип в верхней части файла.
  5. Найди используемые библиотеки через PIO Home › Libraries и добавь их в lib_deps; если указать номер версии из Arduino IDE, поведение будет таким же.
  6. Впиши скорость Serial.begin() в строку monitor_speed и собери проект. Оставшиеся предупреждения из списка ошибок исправь по одному.

Другой вариант — импортировать существующую папку напрямую кнопкой Import Arduino Project («Импортировать проект Arduino») в PIO Home. При сборке PlatformIO сам преобразует файлы .ino в папке src в .cpp и пытается создать прототипы. Но поскольку на сложном коде это преобразование может ошибаться, а IntelliSense работает с файлами .ino не в полную силу, в долгосрочной перспективе лучше перейти на main.cpp. Если сообщения сборки трудно понять, объяснения из статьи Ошибки компиляции Arduino подходят и для PlatformIO.

Arduino IDE или PlatformIO?

ХарактеристикаArduino IDE 2.xPlatformIO (VS Code)
УстановкаОдин пакет, несколько минутVS Code и расширение; при первой настройке скачиваются инструменты
Автодополнение кодаБазовоеПродвинутый IntelliSense, переход к определению, массовое переименование
Настройки платыВ меню «Инструменты», не сохраняются вместе с проектомВ platformio.ini, переносятся вместе с проектом
БиблиотекиОбщие для всего компьютераОтдельные для каждого проекта, версии можно зафиксировать
Несколько платКаждый раз меняются через менюНесколько окружений в одном проекте
Структура файлов.ino; имя папки должно совпадать с именем файлаsrc, include, lib; стандартные .cpp и .h
Прототипы функцийСоздаются автоматическиПишутся вручную (автоматически при импорте .ino)
Контроль версий в GitВозможен, но настройки платы остаются за бортомПросто; отслеживается всё, кроме папки .pio
Отладка и тестированиеОтладчик на некоторых платахОтладчик (debug probe) и поддержка модульных тестов
Удобство для новичковОчень высокоеСреднее; нужно немного времени, чтобы привыкнуть

Коротко: если это первый светодиод или школьный проект из нескольких файлов, Arduino IDE вполне хватит, и в ней меньше путаницы. Если речь о нескольких платах, коде из многих файлов, контроле версий в Git или командной работе, PlatformIO экономит много времени. Инструменты не исключают друг друга; оба можно использовать на одном компьютере. Если Arduino IDE ещё не установлена, начни со статьи Установка Arduino IDE.

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

СимптомВероятная причинаРешение
'xyz' was not declared in this scope (не объявлено в этой области видимости)Нет прототипа функцииНапиши прототип перед setup() или перенеси функцию выше
fatal error: DHT.h: No such file or directory (файл не найден)Библиотеки нет в lib_deps или она добавлена в другое окружениеДобавь библиотеку в нужный раздел [env] и пересобери
Мусорные символы в мониторе портаmonitor_speed не совпадает со скоростью Serial.begin()Сделай оба значения одинаковыми (например, 115200)
Плата не видна, порта нетКабель только для зарядки или нет драйвера CH340/CP2102Возьми кабель с передачей данных, установи драйвер, проверь через pio device list
Access is denied / Resource busy (доступ запрещён / ресурс занят)Порт открыт в другой программеЗакрой монитор порта Arduino IDE и другие терминалы
ESP32: Failed to connect, Wrong boot mode (нет подключения, неверный режим загрузки)Плата не перешла в режим загрузкиЗапусти загрузку, удерживая кнопку BOOT
Загрузка в Pico не начинаетсяПлата не в режиме BOOTSELПодключи её с зажатой BOOTSEL, проверь, что появился диск RPI-RP2
Permission denied: /dev/ttyUSB0 в Linux (нет доступа)Нет правила udev или прав пользователяУстанови файл 99-platformio-udev.rules, добавь своего пользователя в группу dialout
В Windows сборка останавливается с непонятными ошибками путейСимволы не из английского алфавита или пробелы в имени пользователяПеренеси папку ядра в C:\platformio с помощью PLATFORMIO_CORE_DIR
Установка зависла на этапе Installing PlatformIO CoreПроблема с интернетом, антивирусом или PythonПерезапусти VS Code, изучи журнал Output › PlatformIO
Иногда IntelliSense подчёркивает код красной волнистой линией, хотя сборка проходит успешно. Обычно это значит, что в VS Code открыта подпапка проекта или индекс не обновился. Всегда открывай папку, в которой лежит platformio.ini, и запускай из палитры команд (Ctrl+Shift+P) команду PlatformIO: Rebuild IntelliSense Index (перестроить индекс IntelliSense).

Первые проекты, которые стоит попробовать в PlatformIO

  • Blink на нескольких платах: по очереди загрузи проект с тремя окружениями из примера выше в Uno, ESP32 и Pico, чтобы понять, как работает переключатель окружений.
  • Журнал датчика с отметками времени: выводи данные DHT11 в монитор порта с отметками времени с помощью настройки monitor_filters = time.
  • Веб-сервер по Wi-Fi: в проекте веб-сервера на ESP32 раздели код на несколько файлов .cpp и .h и выстрой аккуратную структуру.
  • Беспроводные обновления: с ESP32 OTA загружай код по Wi-Fi, указав upload_protocol = espota и вписав IP-адрес платы в строку upload_port.
  • Конечный автомат: напиши логику конечного автомата на Arduino в отдельном файле класса и воспользуйся структурой папок PlatformIO.
  • Тайминг без delay: напиши программу, которая выполняет несколько задач одновременно с помощью millis().

Хотя поначалу установка PlatformIO занимает чуть больше времени, чем Arduino IDE, файл platformio.ini хранит все настройки проекта в одном месте, поэтому со временем именно этот инструмент экономит больше всего времени. После установки первым делом собери и загрузи простой проект со светодиодом, а затем переходи к проектам с библиотеками и несколькими платами. В приложении BlueGrays есть мигание светодиодом, стартовые проекты для ESP32 и Pico, а также проекты с датчиками вроде DHT11 и HC-SR04 — шаг за шагом, со схемами подключения и кодом; этот код можно сразу перенести в свой проект PlatformIO и попробовать.

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

PlatformIO бесплатный?

Да. PlatformIO Core и расширение PlatformIO IDE для VS Code имеют открытый исходный код и бесплатны. Для хобби, школьных или коммерческих проектов не нужно платить за лицензию на описания плат, менеджер библиотек, сборку и загрузку.

Работает ли код из Arduino IDE в PlatformIO?

Да, потому что при выборе framework = arduino используются то же ядро Arduino и те же функции. Нужно лишь перенести код в src/main.cpp, добавить в начало #include Arduino.h, написать прототипы функций и добавить используемые библиотеки в lib_deps.

Почему установка PlatformIO длится так долго?

При первой настройке скачиваются PlatformIO Core, окружение Python и базовые инструменты; в первом проекте дополнительно скачиваются компилятор и фреймворк для выбранной платы. Пакеты ESP32 могут весить сотни мегабайт, поэтому в зависимости от скорости подключения это может занять 5–15 минут. Когда пакеты скачаны, следующие проекты открываются быстро.

Поддерживает ли PlatformIO MicroPython?

Нет, PlatformIO рассчитан на фреймворки на C/C++, такие как Arduino и ESP-IDF. Чтобы программировать Raspberry Pi Pico или ESP32 на MicroPython, нужен редактор вроде Thonny. При желании ту же плату можно программировать и во фреймворке Arduino в PlatformIO.

Как добавить библиотеку в PlatformIO?

Проще всего открыть вкладку Libraries в PIO Home, найти библиотеку и выбрать свой проект кнопкой Add to Project. Так в platformio.ini добавится строка lib_deps, а библиотека автоматически скачается при первой сборке. Собственные библиотеки можно положить в папку lib проекта как подпапки.

Как выбрать COM-порт в PlatformIO?

Чаще всего PlatformIO сам находит подключённую плату. Если последовательных устройств несколько, порт можно зафиксировать через переключатель портов в строке состояния или прописав в platformio.ini строки upload_port = COM5 и monitor_port = COM5. Какие порты подключены, видно по команде pio device list.

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

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

Самое первое «привет» в электронике: включение и выключение одного светодиода. Arduino включает и выключает светодиод через короткие промежутки, поэтому свет быстро мигает.

4.6(200)
1246
Мигающий светодиод на ESP32
ES-1Новичок

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

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

4.7(37)
108
Мигание встроенным светодиодом Raspberry Pi Pico (Pico и Pico W)
PI-1Новичок

Мигание встроенным светодиодом Raspberry Pi Pico (Pico и Pico W)

Первый проект серии Raspberry Pi Pico! Мигаем зелёным встроенным светодиодом, чтобы проверить, что плата работает, — классический первый опыт «Hello World». НИКАКИХ внешних компонентов, только Pico и USB-кабель. Код написан на MicroPython (официальном языке, поддерживаемом Raspberry Pi Foundation). Изучи в Thonny IDE класс machine.Pin, режим Pin.OUT, методы led.on()/off() и time.sleep(). Каждое переключение видно в выводе (REPL).

5.0(1)
10
Температура и влажность с DHT11
AR-55Средний

Температура и влажность с DHT11

Насколько тепло в твоей комнате и влажный ли воздух или сухой? Датчик DHT11 измеряет температуру и влажность, а Arduino выводит значения на двухстрочный LCD-экран и обновляет их каждые пару секунд.

4.7(47)
83
Измерение расстояния HC-SR04 (вывод в порт)
AR-27Новичок

Измерение расстояния HC-SR04 (вывод в порт)

Датчик HC-SR04 работает совсем как летучая мышь, которая находит дорогу в темноте: он посылает звук, которого ты не слышишь, слушает эхо и измеряет, насколько далеко предмет перед ним.

4.6(50)
82
Мигание встроенным светодиодом ESP32
ES-4Новичок

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

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

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

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

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

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

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

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

4.6(36)
57