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

bootloaders-embedded — скилл для Claude Code

Скилл bootloaders-embedded помогает писать загрузчики для микроконтроллеров Cortex-M: безопасный переход из bootloader в приложение, перенос таблицы векторов, обновление прошивки по UART или USB DFU.

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

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

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

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

~/.claude/skills/bootloaders-embedded/SKILL.md

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

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

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

Каталог скиллов SKILL.md →
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установок embedded-iot-mentor Alireza Rezvani embedded-iot-mentor — скилл для Claude Code, который помогает спланировать встроенное или IoT-устройство от выбора платы до способа просмотра показаний. Он подключается к задачам с микроконтроллерами, датчиками и прошивками. CX Codex +1 22установок domain-embedded actionbook Скилл domain-embedded направляет работу с embedded и no_std Rust: памятью, прерываниями и периферией. Пригодится при разработке прошивок для микроконтроллеров. CX Codex +1 3 200установок embedded-stm32-hal PatrickJS Правило embedded-stm32-hal для Cursor, которое задаёт агенту рамки при работе с прошивками на C и C++: STM32 HAL, прерывания, DMA, экономия памяти. CX Codex +1 ★ 41 178звёзд репо

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

Весь набор →
compiler-optimizations-deep Скилл compiler-optimizations-deep разбирает причины неудачной автовекторизации, сброса регистров на стек и настраивает профильную оптимизацию PGO или BOLT при сборке проектов на C и C++. CX Codex +1 402установок kernel-internals Скилл kernel-internals помогает анализировать планировщики CFS и EEVDF, аллокаторы памяти и работу VFS в Linux. Пригодится при разборе падений kmalloc, нехватки памяти и задержек задач. CX Codex +1 399установок cpu-pipelines-and-hazards Скилл cpu-pipelines-and-hazards для Claude Code и Codex объясняет стадии конвейера CPU, конфликты данных и управления, проброс и простои. Раскрывает, почему горячий цикл тормозит. CX Codex +1 398установок low-power-embedded Скилл low-power-embedded для Claude Code и Codex: настройка режимов низкого энергопотребления микроконтроллеров — сон, стоп, ждущий режим, отключение тактирования периферии и конфигурация пробуждения. CX Codex +1 397установок kernel-debugging Скилл kernel-debugging для Claude Code помогает разбирать сбои ядра Linux с помощью трассировки, отладчиков и анализа дампов. Активируется при вопросах о kgdb, kdb, ftrace, kprobes, dyndbg, kdump и уровнях dmesg. CX Codex +1 395установок qemu-kvm Скилл qemu-kvm ведёт агента по запуску виртуальных машин на QEMU с ускорением KVM: флаги, virtio-устройства, проброс VFIO и загрузка своих ядер. CX Codex +1 395установок baremetal-startup Скилл baremetal-startup помогает настроить инициализацию микроконтроллера от сброса до функции main(): таблицы векторов, обнуление .bss и копирование .data для Cortex-M и RISC-V. CX Codex +1 394установок mmio-and-bit-manipulation Скилл mmio-and-bit-manipulation для безопасной работы с памятью периферии: volatile-семантика, read-modify-write паттерны, маски битов и выравнивание. Пригодится при написании драйверов голого железа без HAL. CX Codex +1 392установок

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

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