STM32 AutoDebug Universal Kit CLI
Замкнутый цикл для STM32: агент собирает прошивку в Keil, шьет плату, ловит вывод порта и ищет строку, где упал код.
- 61 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Набор прошивает реальную плату по SWD и запускает сборку Keil, а ошибочная прошивка может вывести из строя подключенное железо.
Установка
- Работает в
Ручная установка
git clone https://github.com/TaoCosmo-Dev/STM32_AutoDebug_Universal_Kit.gitПервый шаг раздела установки README; затем запускают `setup_env.bat`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Набор прошивает реальную плату по SWD и запускает сборку Keil, а ошибочная прошивка может вывести из строя подключенное железо.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Набор команд дает ИИ-агенту обратную связь при разработке под STM32. Он запускает компиляцию Keil UV4 из командной строки и разбирает журнал до файла и строки, прошивает плату по SWD, читает вывод фирменного токена по последовательному порту и после аппаратного сбоя находит строку исходного кода по регистрам ошибок. Прошивка считается прошедшей проверку, если сборка дала 0 ошибок, прошивка завершилась и порт вывел токен успеха. Мастер `setup_env` ставит зависимости и копирует скилл в каталоги Claude Code, Cursor, Codex CLI и Gemini CLI. Отпечаток сбоя показывает, подействовала ли прошлая правка, а при зацикливании движок останавливается и зовет человека.
Для кого. Разработчикам встраиваемых систем на STM32 и Keil, которые устали вручную собирать, шить и пересказывать агенту результаты.
Подходит, если
- Агент пишет драйвер датчика DHT11, и сборка должна вернуть ему ошибки с файлом и строкой.
- Плата падает в HardFault, а причину нужно найти по регистрам и привязать к строке кода.
- Нужно убедиться, что код реально работает на чипе, а не просто собирается.
- Проект Keil правят агентом: добавить исходник, пути включения и макросы без запуска uVision.
Не подходит, если
- Проект на IAR, CMake/GCC или PlatformIO: поддерживается только Keil.
- Нужна работа на macOS или Linux: поддерживается только Windows.
- Нет отладчика ST-Link, DAP-Link или CMSIS-DAP: без него не прошить плату и не прочитать сбой.
Пример запроса к агенту
Мне нужно считывать температуру с DHT11, печатать ее в порт, а светодиод пусть мигает раз в секунду. Собери, прошей и проверь на плате.Ограничения
Нужны Windows, Keil MDK5, Python 3.10 или новее, отладчик с SWD и уже собираемый проект Keil: новых проектов набор не создает (с версии 2.3.0). Лучше добавить USB-UART, иначе проверка по токену недоступна. Пакеты поддержки чипов по 10–60 МБ скачиваются при первой прошивке, зависимости ставятся с зеркала Tsinghua. Текст документации написан по-китайски. Код прошивки должен выводить через порт токен успеха: без него вердикт неполный. MCP-сервер из 10 инструментов подключается по желанию.
Как отключить. Удалите каталог набора и скилл из `~/.agents/skills` и `~/.claude/skills`. Если запускали внедрение в проект, удалите `run_autodebug.py`, каталог `autodebug` и `autodebug.config.yaml` из проекта.
Частые вопросы
Как установить набор?
Выполните `git clone https://github.com/TaoCosmo-Dev/STM32_AutoDebug_Universal_Kit.git`, затем дважды щелкните `setup_env.bat`. Мастер ставит зависимости и скилл для агентов.
Как понять, что все готово?
Самопроверка печатает путь к Keil UV4, найденный отладчик и порт. Строка `NOT FOUND`, пустой отладчик или порт означают, что чего-то не хватает.
Нужно ли править конфиги?
Нет. Путь Keil, тип отладчика и номер порта определяются автоматически, а недоступный путь из конфигурации заменяется найденным.
Можно ли обойтись без MCP?
Да. По умолчанию работает командная строка, а `mcp_server.py` с 10 инструментами подключается по желанию.
Что считается успехом?
Три условия сразу: компиляция без ошибок, прошивка завершилась и порт вывел токен успеха.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыauto-embedded вводит в проект прошивки пять стадий, таблицу занятых пинов и журнал задач, чтобы агент не гадал по регистрам.
24 скилла для прошивок микроконтроллеров: сборка, прошивка, отладка GDB, UART, Modbus, CAN, логические анализаторы и статанализ
ESP32 Workbench дает агенту 11 скиллов и 13 MCP-инструментов для прошивок ESP32: пины, паники, лог сборки, разделы.
Скиллы Claude Code и стенд на Raspberry Pi: агент пишет прошивку для ESP32, прошивает плату и гоняет тесты на железе до зеленого
Отладчик без среды разработки: агент ставит точки останова, шагает по коду и смотрит переменные в десяти языках
LabWired Core запускает прошивку на виртуальной копии настоящего чипа и отдает агенту трассу UART, GPIO и код выхода.
Коротко о README
Документация описывает разделение труда: человек задает параметры железа и подключает провода, агент пишет код и ведет цикл, набор превращает каждый шаг в команду с кодом выхода.