bootloaders-embedded — скилл для Claude Code
Скилл bootloaders-embedded помогает писать загрузчики для микроконтроллеров Cortex-M: безопасный переход из bootloader в приложение, перенос таблицы векторов, обновление прошивки по UART или USB DFU.
MIT 395 установок ★ 298 обновлён 2026-06-27
npx skills add mohitmishra786/low-level-dev-skills --skill bootloaders-embedded -a claude-codeЧто делает bootloaders-embedded
Когда приложение должно работать не с начала flash-памяти, а с нужного смещения (например 0x08010000), bootloader должен корректно передать управление. Скилл покрывает проверку валидности образа приложения — контроль того, что стек указателей (вектор[0]) лежит в RAM, а адрес сброса (вектор[1]) имеет бит Thumb и попадает в допустимый диапазон flash.
Вторая часть — сама передача управления: отключение прерываний, деинициализация периферии, установка SCB->VTOR на базу приложения, загрузка стека и перепрыгивание на адрес сброса. Скилл включает пример на C для STM32F4 и объясняет, почему это нужно делать именно в таком порядке.
Третья часть — организация обновления: откуда и как получить новый образ (UART, USB DFU), где его писать, как проверить целостность и откатиться, если что-то сломалось. Скилл указывает на связь с другими низкоуровневыми навыками: настройка вектора исключений, конфигурация стартапа, работа с linker-скриптами.
Какие задачи решает
- Написать функцию безопасного перехода из bootloader в приложение на Cortex-M
- Проверить валидность образа приложения перед прыжком
- Переместить таблицу векторов при запуске приложения из нестандартного адреса flash
- Реализовать обновление прошивки по USB DFU или UART без vendor HAL
- Отладить ситуацию, когда приложение работает при прямой заливке, но падает при загрузке bootloader'ом
Примеры запросов агенту
- Напиши функцию для STM32F4, которая проверит валидность приложения по адресу
0x08010000и совершит безопасный прыжок - Помоги настроить linker-скрипт приложения так, чтобы оно корректно работало при загрузке из bootloader'а
- Реализуй OTA-обновление прошивки с двумя банками flash и откатом при ошибке
Как установить bootloaders-embedded
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill bootloaders-embedded -a claude-code2Вручную: положить файлы
~/.claude/skills/bootloaders-embedded/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/bootloaders-embedded/
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill bootloaders-embedded -a codex2Вручную: положить файлы
.agents/skills/bootloaders-embedded/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill bootloaders-embedded -a cursor2Вручную: положить файлы
.cursor/skills/bootloaders-embedded/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mohitmishra786/low-level-dev-skills skills/baremetal/bootloaders-embedded2Вручную: положить файлы
.github/skills/bootloaders-embedded/SKILL.md1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill bootloaders-embedded -a gemini-cli2Командой платформы
gemini skills install https://github.com/mohitmishra786/low-level-dev-skills --path skills/baremetal/bootloaders-embeddedВручную: положить файлы
.devin/skills/bootloaders-embedded/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill bootloaders-embedded -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о bootloaders-embedded
Как установить bootloaders-embedded в Claude Code?
Выполни в терминале npx skills add mohitmishra786/low-level-dev-skills --skill bootloaders-embedded -a claude-code, затем открой ~/.claude/skills/bootloaders-embedded/SKILL.md. Скилл активируется при вопросах про прыжок из bootloader'а, переносы VTOR или USB DFU на Cortex-M.
Что делает bootloaders-embedded?
Помогает писать встроенные загрузчики для микроконтроллеров: проверка валидности приложения, безопасный переход управления из bootloader'а в приложение, релокация таблицы векторов, реализация OTA или USB DFU обновлений на STM32 и похожих чипах.
Почему приложение работает при прямой заливке, но падает при загрузке bootloader'ом?
Обычно linker-скрипт приложения всё ещё указывает на 0x08000000, хотя bootloader требует 0x08010000. Нужно пересобрать приложение с правильным ORIGIN, а в стартапе установить SCB->VTOR на базу приложения перед включением прерываний.
Исходный текст
SKILL.md · MIT
---
name: bootloaders-embedded
description: Embedded bootloader skill for firmware update and app handoff. Use when writing a custom bootloader, jumping to application code, relocating VTOR, or implementing DFU/USB firmware update on Cortex-M. Activates on queries about bootloader jump, vector table relocation, application entry point, STM32 DFU, or dual-bank flash.
---
# Embedded Bootloaders
## Purpose
Guide agents through embedded bootloader fundamentals: vector table relocation, safe handoff from bootloader to application, flash partitioning, and basic firmware-update patterns (UART, USB DFU, or custom protocol) on Cortex-M and similar MCUs.
## When to Use
- Application must run at non-zero flash offset (e.g. `0x08010000`)
- Implementing OTA or USB DFU without vendor HAL
- Debugging "app works when flashed alone but not via bootloader"
- Integrating with `skills/baremetal/baremetal-startup` and `skills/baremetal/stm32-baremetal`
## Workflow
### 1. Memory layout (typical STM32)
| Region | Address | Size | Content |
|--------|---------|------|---------|
| Bootloader | `0x08000000` | 16–64 KB | BL code, update logic |
| Application | `0x08010000` | remainder | App vector + code |
Linker script for app must set `FLASH ORIGIN` to app base; vector table must live at app base.
### 2. Valid application image check
Before jump, verify:
```
App vector[0] (initial SP) points into RAM region
App vector[1] (Reset) points into flash region and has Thumb bit set (LSB=1)
Optional: CRC or magic word in app metadata section
```
```c
#define APP_BASE 0x08010000U
static int app_valid(uint32_t base)
{
uint32_t sp = *(uint32_t *)base;
uint32_t reset = *(uint32_t *)(base + 4);
if (sp < SRAM_BASE || sp > SRAM_END)
return 0;
if ((reset & 1U) == 0U)
return 0;
if (reset < base || reset > FLASH_END)
return 0;
return 1;
}
```
### 3. Cortex-M handoff sequence
```c
typedef void (*app_entry_t)(void);
void jump_to_app(uint32_t app_base)
{
uint32_t sp = *(uint32_t *)app_base;
uint32_t reset = *(uint32_t *)(app_base + 4);
/* Disable interrupts and de-init peripherals/boot-owned hardware */
__disable_irq();
SysTick->CTRL = 0;
for (int i = 0; i < 8; i++) {
NVIC->ICER[i] = 0xFFFFFFFFU;
NVIC->ICPR[i] = 0xFFFFFFFFU;
}
SCB->VTOR = app_base;
__set_MSP(sp);
__DSB();
__ISB();
app_entry_t entry = (app_entry_t)reset;
entry(); /* does not return */
}
```
Application must set `SCB->VTOR = APP_BASE` early in `Reset_Handler` if startup assumes relocatable vector table.
### 4. Bootloader responsibilities
```
Power-on
├── Init minimal clock + UART/USB for update
├── Check update flag in RTC backup / GPIO strap
├── If update requested → receive image, verify, program flash
└── Else if valid app → jump_to_app()
└── Else stay in bootloader shell
```
### 5. STM32 system memory DFU (factory ROM)
STM32 chips expose USB DFU in system memory when BOOT0=1. Custom bootloaders are separate — do not confuse ROM DFU with user flash BL.
### 6. Update safety
- Write to scratch sector, verify CRC, then swap metadata pointer (A/B)
- Never erase the only valid image without recovery path
- Reset watchdog only after verified commit
### 7. Agent usage
```
/bootloaders-embedded Write STM32F4 jump-to-app at 0x08010000 with VTOR setup
```
## Common Problems
| Symptom | Cause | Fix |
|---------|-------|-----|
| HardFault after jump | SP invalid or Thumb bit missing | Validate vectors; ensure `reset \| 1` |
| IRQs hit bootloader handlers | VTOR not relocated | Set `SCB->VTOR` before enabling IRQs |
| App OK standalone, fails via BL | Linker still at `0x08000000` | Relink app with correct ORIGIN |
| UART garbage after jump | BL left UART running | De-init or reset peripherals |
| Brick after OTA | Power loss mid-erase | Dual-bank or metadata rollback |
## Related Skills
- `skills/baremetal/baremetal-startup` — vector table and Reset_Handler
- `skills/baremetal/stm32-baremetal` — flash map and CMSIS
- `skills/baremetal/interrupts-and-exceptions-baremetal` — NVIC disable pattern
- `skills/embedded/linker-scripts` — VMA/LMA for split images
- `skills/embedded/openocd-jtag` — recover bricked flash
© mohitmishra786 · MIT · mohitmishra786/low-level-dev-skills