К основному содержанию
скилл CX Codex

qemu-embedded-simulation — скилл для Claude Code: запуск и установка

Скилл qemu-embedded-simulation для Claude Code помогает запускать bare-metal прошивки ARM и RISC-V в QEMU и подключать GDB. Проверяет прошивку без платы.

MIT 389 установок ★ 298 обновлён 2026-06-27

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add mohitmishra786/low-level-dev-skills --skill qemu-embedded-simulation -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/qemu-embedded-simulation/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/qemu-embedded-simulation/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
embedded-systems https://github.com/Jeffallan Скилл embedded-systems настраивает агента на разработку прошивок для STM32 и ESP32. Он помогает писать драйверы, FreeRTOS-задачи и оптимизировать потребление памяти и энергии. CX Codex +1 7 300установок arm-cortex-microcontrollers Ryan Snodgrass Плагин arm-cortex-microcontrollers для Claude Code помогает разрабатывать прошивки для ARM Cortex-M с драйверами периферии и паттернами безопасности памяти. Работа с прошивками для Teensy, STM32, nRF52 и SAMD. CX Codex ★ 42 780звёзд репо embedded-stm32 Mindrally Скилл embedded-stm32 для Claude Code и Codex задаёт правила разработки встроенного ПО на C/C++ под микроконтроллеры STM32 с библиотекой HAL. Включается при генерации кода в CubeMX, настройке DMA и обработке прерываний. CX Codex +1 132установок qemu-mcp 0xmortuex Запускает виртуальные машины QEMU и передаёт агенту управление ими. Агент может загружать ISO или ядро, вводить команды и читать экран либо последовательную консоль. CX Codex +1 ★ 5звёзд репо embedded-stm32-hal PatrickJS Правило embedded-stm32-hal для Cursor, которое задаёт агенту рамки при работе с прошивками на C и C++: STM32 HAL, прерывания, DMA, экономия памяти. CX Codex +1 ★ 41 178звёзд репо embedded-iot-mentor Alireza Rezvani embedded-iot-mentor — скилл для Claude Code, который помогает спланировать встроенное или IoT-устройство от выбора платы до способа просмотра показаний. Он подключается к задачам с микроконтроллерами, датчиками и прошивками. CX Codex +1 22установок

Из того же набора140

Весь набор →
uart-serial-baremetal Скилл uart-serial-baremetal помогает настроить bare-metal UART и USART на микроконтроллерах для вывода логов, расчёта битрейта и отладки. CX Codex +1 391установок kernel-concurrency Скилл kernel-concurrency помогает выбрать правильный примитив синхронизации в ядре Linux: spinlock, mutex, RCU, seqlock или completion. CX Codex +1 391установок gpu-memory-model Скилл gpu-memory-model объясняет модели памяти GPU, расхождения варпов и конфликты банков памяти. Помогает находить узкие места в ядрах CUDA и HIP. CX Codex +1 391установок compiler-frontend Скилл compiler-frontend для Claude Code помогает проектировать лексер, парсер и проверку типов, а затем генерировать LLVM IR. Описывает фронтенд компилятора, интерпретатора или собственного языка. CX Codex +1 390установок kernel-memory-management Скилл kernel-memory-management по памяти ядра Linux: помогает выбрать между kmalloc, vmalloc и страничным аллокатором и понять, почему драйвер упирается в OOM. CX Codex +1 388установок cuda-debugging Скилл cuda-debugging для Claude Code и Codex: ведёт агента по отладке CUDA через cuda-gdb, Compute Sanitizer, дампы GPU и разбор ошибок 700/702. Покрывает падения ядра и неверный результат. CX Codex +1 386установок llvm-ir-and-passes Скилл llvm-ir-and-passes для Claude Code учит агента читать LLVM IR, понимать SSA и пайплайн оптимизаций. Помогает проследить изменения от -O2 и подготовиться к написанию пасса. CX Codex +1 384установок spi-i2c-baremetal Скилл spi-i2c-baremetal помогает писать bare-metal драйверы SPI и I2C: настраивать обмен с датчиками и памятью, читать регистры и искать причины сбоев шины. CX Codex +1 384установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой