MIK32 Амур + PlatformIO: пошаговый гайд по настройке среды разработки на Windows / Хабр

MIK32 Амур (К1948ВК018) — первый российский 32-битный микроконтроллер на ядре RISC-V от АО «Микрон». Для работы с ним разработчики предлагают связку VS Code + PlatformIO. Казалось бы, всё просто — но на практике сталкиваешься с множеством неочевидных шагов, которые нигде не собраны в одном месте. В этой статье я пошагово покажу, как развернуть полноценную среду разработки для MIK32 Амур на Windows.

Что понадобится

Отладочная плата с MIK32 Амур
JTAG-адаптер (Mikron-Link/Start-Link — часто встроен прямо в отладочную плату)
Кабель USB (micro-USB или Type-C, зависит от программатора)
Windows 11 (У меня такая версия. Возможно, на других версиях будут другие сюрпризы)
С такой отладочной платой я и работал (отмечу сходство с платой NUCLEO)

Шаг 1. Установка Visual Studio Code

Скачайте VS Code с официального сайта: code.visualstudio.com — пояснять тут нечего.

Шаг 2. Установка PlatformIO

Откройте VS Code, нажмите Ctrl+Shift+X — откроется панель расширений. В строке поиска введите «PlatformIO IDE» и нажмите Install. Установка займёт пару минут — PlatformIO скачает Python-окружение и необходимые утилиты.

После установки в левой панели VS Code появится иконка PlatformIO (муравей).

PlatformIO — кроссплатформенный инструмент для встраиваемой разработки, который автоматически подтягивает тулчейн, HAL и настройки сборки под конкретный микроконтроллер, работает как расширение VS Code.

Шаг 3. Установка платформы MIK32

Это ключевой шаг, на котором многие спотыкаются. MIK32 не входит в стандартную библиотеку платформ PlatformIO — её нужно установить вручную.

Перейдите на страницу релизов: github.com/MikronMIK32/mik32-platformio/releases
Скачайте архив последней версии (например, mik32-platformio-0.5.0.zip).
Распакуйте архив. Внутри будут папки packages и platforms.
Слейте содержимое этих папок с директорией PlatformIO. На Windows путь:
```
C:\Users\ВАШ_ПОЛЬЗОВАТЕЛЬ\.platformio\
```
Перезапустите VS Code.

Шаг 4. Установка драйвера программатора

Программатор Mikron-Link (M-Link) / Start-Link использует чип FTDI. Windows может не установить правильный драйвер автоматически. Нужно заменить драйвер на WinUSB через утилиту Zadig:

Скачайте Zadig: zadig.akeo.ie
Подключите программатор по USB.
Запустите Zadig от имени администратора. В меню Options включите List All Devices.
Выберите ваш FTDI-адаптер в списке: Dual RS232-HS (Interface 1). Interface 0 не трогайте — он должен остаться обычным COM-портом.
Выберите драйвер WinUSB и нажмите Replace Driver.
Попробуйте различные версии Zadig. Свежие версии у меня не работали (просто вылетали при нажатии на кнопку Replace Driver. Рабочей версией оказалась 2.4.

Здесь у меня возникла проблема: установка стабильно завершалась ошибкой Driver Installation: FAILED (Other error). Причина оказалась в проверке цифровой подписи драйверов в Windows: Zadig ставит самоподписанный драйвер, а Windows его блокирует.

Решение — на время установки отключить проверку подписи драйверов:

Win + I → Система → Восстановление → Расширенные параметры запуска → «Перезагрузить сейчас».
В синем меню: Troubleshoot → Advanced options → Startup Settings → Restart.
После перезагрузки появится пронумерованный список опций — выберите Disable driver signature enforcement (клавиша F7).

Компьютер загрузится в обычном режиме, но с отключенной проверкой подписи. После этого запускайте Zadig — установка WinUSB должна пройти без ошибок. Проверить успех просто: устройство Dual RS232-HS (Interface 1) должно пропасть из списка COM-портов в Диспетчере устройств.

Шаг 5. Настройка platformio.ini

В корне проекта нужен файл platformio.ini(Можно посмотреть его в одном из примеров официального репозитория) :

[env:mik32v2]
platform = MIK32
board = mik32v2
framework = framework-mik32v2-sdk
board_build.ldscript = eeprom

Если PlatformIO не находит платформу по имени (UnknownPackageError: Could not find the package with 'MIK32' requirements) - укажите платформу прямой git-ссылкой в platformio.ini вместо имени:
platform = https://github.com/MikronMIK32/platform-mik32.git

Параметр board_build.ldscript определяет, куда загружается прошивка:

eeprom — энергонезависимая, сохраняется после выключения
ram — быстрая загрузка для отладки, теряется при выключении
spifi — внешняя Flash-память, если есть на плате

Шаг 6. Скачиваем библиотеки

Заголовочные файлы с картой регистров, стартовый файл и линкер-скрипты лежат здесь — переписывать регистры вручную не нужно.

После инициализации проекта в появившейся папке .vscode откройте файл c_cpp_properties.json и добавьте путь до скачанных внешних библиотек в includePath.

Шаг 7. Компиляция и загрузка

Откройте палитру команд в VS Code (Ctrl+Shift+P) и выберите PlatformIO: Open PlatformIO Core CLI — это откроет терминал с уже активированным виртуальным окружением PlatformIO.

Подключите программатор к плате и к ПК по USB.

Компиляция:

pio run

После этой команды PlatformIO создаёт папку .pio, внутри в build/mik32v2/ будет firmware.hex.

Прошивка:

pio run -t upload

Если всё настроено правильно — в терминале появится SUCCESS.

Шаг 8. Отладка (Debug)

PlatformIO поддерживает пошаговую отладку через JTAG. Нажмите F5 или откройте панель Run and Debug слева в VS Code. Появится панель отладки, где можно ставить breakpoints, смотреть переменные и пошагово выполнять код.

Важный нюанс: у RISC-V ядра MIK32 всего 3 аппаратных триггера для breakpoint'ов (это видно в логе OpenOCD: Found 3 triggers). Один из них PlatformIO использует автоматически под временный breakpoint на вход в main() (tbreak main), и ещё один под внутренние нужды — то есть реально доступно не более одного breakpoint'а. Если поставить больше — получите ошибку Cannot insert hardware breakpoint: resource not available, и отладчик откажется продолжать выполнение.

Заключение

После выполнения всех 8-ми шаговых Вы успешно запустите свой первый код на отечественном МК. Пишите в комментариях, если у Вас возникают какие-то траблы в ходе алгоритма. Также приглашаю в свой ТГ канал — там больше материалов про embedded-разработку, AI и подобные вещи.