qemu-embedded-simulation — скилл для Claude Code: запуск и установка
Скилл qemu-embedded-simulation для Claude Code помогает запускать bare-metal прошивки ARM и RISC-V в QEMU и подключать GDB. Проверяет прошивку без платы.
MIT 389 установок ★ 298 обновлён 2026-06-27
npx skills add mohitmishra786/low-level-dev-skills --skill qemu-embedded-simulation -a claude-codeЧто делает qemu-embedded-simulation
Скилл подсказывает, как выбрать модель машины QEMU, загрузить ELF и настроить отладку через GDB. Он охватывает STM32, универсальную машину ARM virt и RISC-V virt, а также запуск printf через semihosting при поддержке toolchain.
У моделей STM32 нет GPIO, DMA и I2C; USART, SPI, ADC и таймеры поддерживаются частично. Поэтому тест мигания светодиодом в такой симуляции не сработает. QEMU также не воспроизводит точные циклы микроконтроллера, а перед выпуском прошивку нужно проверить на железе.
Какие задачи решает
- выбрать модель QEMU для платы STM32
- загрузить ELF прошивки ARM или RISC-V
- проверить запуск прошивки без платы
- подключить GDB к запущенной симуляции
- найти причину отсутствия UART-вывода
Примеры запросов агенту
- Запусти прошивку
firmware.elfдляstm32vldiscoveryв QEMU и подготовь подключение GDB на порту 3333. - Проверь, почему
firmware.elfдля RISC-V не начинает выполнение на машинеvirt. - Разберись, почему прошивка для STM32 не выводит данные через UART в QEMU.
Как установить qemu-embedded-simulation
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill qemu-embedded-simulation -a claude-code2Вручную: положить файлы
~/.claude/skills/qemu-embedded-simulation/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/qemu-embedded-simulation/
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill qemu-embedded-simulation -a codex2Вручную: положить файлы
.agents/skills/qemu-embedded-simulation/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill qemu-embedded-simulation -a cursor2Вручную: положить файлы
.cursor/skills/qemu-embedded-simulation/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mohitmishra786/low-level-dev-skills skills/qemu/qemu-embedded-simulation2Вручную: положить файлы
.github/skills/qemu-embedded-simulation/SKILL.md1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill qemu-embedded-simulation -a gemini-cli2Командой платформы
gemini skills install https://github.com/mohitmishra786/low-level-dev-skills --path skills/qemu/qemu-embedded-simulationВручную: положить файлы
.devin/skills/qemu-embedded-simulation/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill qemu-embedded-simulation -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о qemu-embedded-simulation
Как установить qemu-embedded-simulation в Claude Code?
Выполните npx skills add mohitmishra786/low-level-dev-skills --skill qemu-embedded-simulation -a claude-code. Файл скилла появится по пути ~/.claude/skills/qemu-embedded-simulation/SKILL.md.
Что делает qemu-embedded-simulation?
Помогает настроить запуск bare-metal прошивок ARM и RISC-V в QEMU, выбрать модель машины и подключить GDB для отладки.
Можно ли проверить GPIO на STM32 в QEMU?
Нет, контроллер GPIO в моделях STM32 не реализован. Проверку мигания светодиода нужно проводить на плате или другой машине.
Исходный текст
SKILL.md · MIT
--- name: qemu-embedded-simulation description: QEMU embedded simulation skill for bare-metal MCU testing. Use when running ARM/RISC-V firmware in QEMU, selecting machine models, loading -kernel ELF, or GDB debugging without hardware. Activates on queries about QEMU bare metal, qemu-system-arm -kernel, STM32 QEMU machine, RISC-V virt, or firmware simulation. --- # QEMU Embedded Simulation ## Purpose Guide agents through QEMU for bare-metal and RTOS firmware: machine selection, loading ELF images, semihosting, peripheral models, and GDB debug — distinct from Linux-focused `skills/virtualization/qemu-kvm` and `skills/kernel-dev/qemu-for-kernel-development`. ## When to Use - Test Cortex-M firmware without board - CI smoke test for linker script / startup - GDB single-step before OpenOCD on hardware - RISC-V bring-up on `virt` machine ## Workflow ### 1. ARM Cortex-M (QEMU STM32 boards) QEMU models a **subset** of STM32 boards (see [qemu.org STM32 docs](https://www.qemu.org/docs/master/system/arm/stm32.html)): | Machine | MCU | Core | |---------|-----|------| | `stm32vldiscovery` | STM32F100RBT6 | Cortex-M3 | | `netduino2` | STM32F205RFT6 | Cortex-M3 | | `netduinoplus2` | STM32F405RGT6 | Cortex-M4F | | `olimex-stm32-h405` | STM32F405RGT6 | Cortex-M4F | ```bash # stm32vldiscovery — Cortex-M3 (not F4); match -mcpu to the board arm-none-eabi-gcc -mcpu=cortex-m3 -T linker.ld -o firmware.elf main.c startup.s qemu-system-arm \ -machine stm32vldiscovery \ -kernel firmware.elf \ -nographic \ -serial mon:stdio ``` Boot with `-kernel firmware.bin` or `.elf` per QEMU STM32 boot options. Machine list: `qemu-system-arm -machine help`. **GPIO, DMA, and I2C are not modeled** on current QEMU STM32 machines — USART/SPI/ADC/timer are partially supported. ### 2. Generic ARM virt (Cortex-A test) ```bash qemu-system-aarch64 -machine virt -cpu cortex-a53 -m 128M \ -kernel firmware.elf -nographic ``` ### 3. RISC-V bare metal ```bash qemu-system-riscv32 -machine virt -nographic \ -bios none \ -kernel firmware.elf ``` `-bios none` starts at reset vector without OpenSBI. ### 4. GDB stub ```bash qemu-system-arm -machine stm32vldiscovery -kernel firmware.elf \ -S -gdb tcp::3333 -nographic arm-none-eabi-gdb firmware.elf (gdb) target remote :3333 (gdb) monitor reset halt (gdb) load ``` Pair with `skills/embedded/openocd-jtag` for on-target workflow. ### 5. Semihosting (if supported) ```bash qemu-system-arm ... -semihosting-config enable=on,target=native ``` Allows `printf` via semihosting syscall — toolchain must be built with semihosting support. ### 6. Limitations (QEMU STM32 per upstream docs) | Gotcha | Reality | |--------|---------| | No GPIO in QEMU STM32 | GPIO controller not implemented — LED blink tests need hardware or another machine | | No DMA / I2C | DMA and I2C missing on STM32 QEMU models | | Partial RCC | RCC reset/enable only on F4; not full clock tree | | Wrong MCU assumed | `stm32vldiscovery` is F100 M3, not F407 — match CPU flags and linker memory | | Timing | Not cycle-accurate vs silicon | Validate on hardware before production sign-off. ### 7. Agent usage ``` /qemu-embedded-simulation Run STM32VL discovery firmware in QEMU with GDB on port 3333 ``` ## Common Problems | Symptom | Cause | Fix | |---------|-------|-----| | QEMU exits immediately | `main` returned | Loop or `WFI` at end | | Wrong entry address | ELF not linked for model | Check `readelf -h` entry | | No serial output | Wrong UART model address | Use machine-specific map or semihosting | | GDB can't connect | Forgot `-S` | Add `-S -gdb tcp::3333` | | HardFault in QEMU | Stack/vector invalid | Fix startup — see baremetal-startup | ## Related Skills - `skills/baremetal/baremetal-startup` — vectors and linker script - `skills/baremetal/stm32-baremetal` — STM32 layout - `skills/embedded/openocd-jtag` — hardware debug - `skills/kernel-dev/qemu-for-kernel-development` — Linux kernel in QEMU - `skills/platform/riscv-privileged` — RISC-V reset and virt
© mohitmishra786 · MIT · mohitmishra786/low-level-dev-skills