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

baremetal-startup — скилл для Claude Code: обзор и установка

Скилл baremetal-startup помогает настроить инициализацию микроконтроллера от сброса до функции main(): таблицы векторов, обнуление .bss и копирование .data для Cortex-M и RISC-V.

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

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

Что делает baremetal-startup

Скилл инструментирует агента при написании низкоуровневого кода инициализации (startup.s, entry.S и crt0). Он содержит шаблоны для Cortex-M и RISC-V, включая заполнение таблицы векторов прерываний, настройку указателя стека _estack, циклы переноса секции .data из Flash в RAM и обнуление секции .bss.

В инструкциях разобрана интеграция со скриптами линковщика и регистром SCB->VTOR для переноса векторов при запуске из бутлоадера. Без обязательного выравнивания адреса по спецификации ARM вызов SCB->VTOR приведёт к ошибкам диспетчеризации прерываний.

Также скилл описывает типичные сбои начального этапа: падение в HardFault из-за неверного стека, мусор в глобальных переменных, зависание конструкторов C++ до включения тактирования и отсутствие бесконечного цикла или WFI после выхода из main().

Какие задачи решает

  • написать минимальный startup.s или Reset_Handler для Cortex-M
  • настроить перенос секции .data и обнуление .bss перед вызовом main()
  • настроить смещение таблицы векторов через VTOR после перехода из бутлоадера
  • устранить падение в HardFault на этапе старта микроконтроллера

Примеры запросов агенту

  • /baremetal-startup Контроллер STM32 зависает до входа в main, проверь мой Reset_Handler
  • /baremetal-startup Как правильно сместить VTOR после прыжка из бутлоадера?
  • /baremetal-startup Напиши цикл инициализации .data и .bss для RISC-V на ассемблере

Как установить baremetal-startup

1Через Skills CLI (Vercel)

npx skills add mohitmishra786/low-level-dev-skills --skill baremetal-startup -a claude-code

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

~/.claude/skills/baremetal-startup/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о baremetal-startup

Как установить baremetal-startup в Claude Code?

Выполните команду npx skills add mohitmishra786/low-level-dev-skills --skill baremetal-startup -a claude-code.

Что делает скилл baremetal-startup?

Он помогает писать и отлаживать код начальной загрузки прошивки от сигнала сброса до функции main(), включая таблицы векторов, стек и секции памяти.

Почему контроллер падает в HardFault сразу после включения?

Частая причина заключается в неверном значении указателя стека _estack в нулевом элементе таблицы векторов, указывающем за пределы доступного ОЗУ.

Исходный текст

SKILL.md · MIT
---
name: baremetal-startup
description: Bare-metal startup skill for reset-to-main bring-up. Use when writing startup code, vector tables, .data/.bss init, stack setup, or crt0 for Cortex-M/RISC-V. Activates on queries about reset vector, VTOR, startup.s, bss init, or bare-metal entry point.
---

# Bare-Metal Startup

## Purpose

Guide agents through bare-metal startup from reset to `main()`: reset and exception vectors, `.data`/`.bss` initialization, stack and heap setup, C runtime integration with linker scripts, and common Cortex-M and RISC-V bring-up bugs.

## When to Use

- Firmware hangs before reaching `main()`
- Porting to a new MCU without vendor HAL
- Writing custom `startup.s` or `Reset_Handler`
- Integrating with `skills/embedded/linker-scripts`
- Debugging uninitialized globals or stack overflows at boot

## Workflow

### 1. Boot sequence mental model

```
Power-on / reset
├── CPU loads SP from vector[0]
├── CPU branches to Reset_Handler from vector[1]
├── Reset_Handler: init clocks (optional), copy .data, zero .bss
├── Configure stack pointer (if not already from vector)
├── Call SystemInit() / platform_init()
└── Call main() — must not return (loop or WFI)
```

### 2. Cortex-M vector table

On Cortex-M, the vector table starts at address 0 or a relocatable base (VTOR):

| Index | Entry |
|-------|-------|
| 0 | Initial stack pointer (`_estack`) |
| 1 | `Reset_Handler` |
| 2 | `NMI_Handler` |
| 3 | `HardFault_Handler` |
| 4+ | IRQ handlers per NVIC |

```asm
/* startup.s — minimal Cortex-M */
.syntax unified
.thumb

.section .isr_vector,"a",%progbits
.global g_pfnVectors
g_pfnVectors:
    .word _estack
    .word Reset_Handler
    .word NMI_Handler
    .word HardFault_Handler
    /* ... device IRQ vectors from vendor CMSIS ... */

.section .text.Reset_Handler
.thumb_func
.global Reset_Handler
Reset_Handler:
    ldr r0, =_sidata    /* .data load address (LMA) */
    ldr r1, =_sdata     /* .data VMA start */
    ldr r2, =_edata
    b LoopCopyDataInit
CopyDataInit:
    ldr r3, [r0], #4
    str r3, [r1], #4
LoopCopyDataInit:
    cmp r1, r2
    blt CopyDataInit
    ldr r2, =_sbss
    ldr r4, =_ebss
    movs r3, #0
    b LoopFillZerobss
FillZerobss:
    str r3, [r2], #4
LoopFillZerobss:
    cmp r2, r4
    blt FillZerobss
    bl SystemInit
    bl main
    b .
```

```c
/* Linker symbols — declared extern in startup */
extern uint32_t _estack, _sidata, _sdata, _edata, _sbss, _ebss;
```

### 3. VTOR relocation (Cortex-M)

```c
#include "core_cm4.h"  /* CMSIS */

void relocate_vector_table(uint32_t base) {
    SCB->VTOR = base & 0xFFFFFF80U;  /* must be aligned per ARM ref manual */
    __DSB();
    __ISB();
}
```

Bootloader jumping to app often requires setting VTOR to the application's vector table address (e.g., `0x08020000` on STM32 flash).

### 4. RISC-V startup (overview)

```asm
/* entry.S — simplified */
.section .text.entry
.global _start
_start:
    la sp, _stack_top
    la t0, _bss_start
    la t1, _bss_end
clear_bss:
    beq t0, t1, bss_done
    sw zero, 0(t0)
    addi t0, t0, 4
    j clear_bss
bss_done:
    call main
    j .
```

Trap vector: `mtvec` for M-mode; see `skills/platform/riscv-privileged`.

### 5. crt0 responsibilities

| Task | Who does it |
|------|-------------|
| Copy `.data` LMA→VMA | `Reset_Handler` / crt0 |
| Zero `.bss` | `Reset_Handler` |
| Init stack | Vector[0] or explicit `sp` |
| Heap (`_sbrk`) | Optional; libc or custom |
| C++ constructors | `__libc_init_array()` if using full libc |
| FPU enable | `SystemInit` on Cortex-M4F/M7 |

### 6. Linker script integration

```ld
_estack = ORIGIN(RAM) + LENGTH(RAM);
_sidata = LOADADDR(.data);
```

Cross-link `skills/embedded/linker-scripts` for MEMORY/SECTIONS layout.

### 7. Agent usage examples

```
/baremetal-startup My STM32 never reaches main — what should Reset_Handler do?
/baremetal-startup How do I relocate the vector table after bootloader jump?
```

## Common Problems

| Symptom | Cause | Fix |
|---------|-------|-----|
| HardFault immediately | Stack pointer invalid | Set `_estack` to valid RAM top |
| Globals wrong at boot | `.data` not copied | Copy LMA→VMA in Reset_Handler |
| BSS non-zero | `.bss` not zeroed | Add bss clear loop |
| IRQs don't fire | VTOR points to wrong table | `SCB->VTOR = app_vector_addr` |
| `main` returns into garbage | No loop after main | `while(1)` or `WFI` loop |
| C++ static init crash | Constructors before clocks | Call `SystemInit` first |

## Related Skills

- `skills/embedded/linker-scripts` — `_estack`, LMA/VMA, section placement
- `skills/baremetal/interrupts-and-exceptions-baremetal` — vector table IRQ entries
- `skills/baremetal/bootloaders-embedded` — VTOR relocation on app jump
- `skills/embedded/openocd-jtag` — halt at `Reset_Handler` with GDB
- `skills/low-level-programming/assembly-arm` — Thumb-2 syntax
- `skills/platform/riscv-privileged` — RISC-V trap setup

© mohitmishra786 · MIT · mohitmishra786/low-level-dev-skills

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

Все скиллы по теме «Языки программирования» →
arm-cortex-expert Ryan Snodgrass Субагент arm-cortex-expert для Claude Code помогает разрабатывать прошивки и драйверы для микроконтроллеров ARM Cortex-M. Разбирает работу с периферией, прерываниями, DMA и кэшем. CX Codex ★ 42 780звёзд репо J-Link MCP Klievan Подключает ИИ-ассистента к реальному железу через пробники SEGGER J-Link: чтение регистров, прошивка, RTT-логи и разбор падений Cortex-M. CX Codex +1 ★ 45звёзд репо esp32c6-lcd147 alexex1993 Помогает писать прошивку для Waveshare ESP32-C6-LCD-1.47. Разбирает настройку проекта, дисплея, SD-карты и отладку платы. CX Codex +1 ★ 29звёзд репо arm-cortex-microcontrollers Ryan Snodgrass Плагин arm-cortex-microcontrollers для Claude Code помогает разрабатывать прошивки для ARM Cortex-M с драйверами периферии и паттернами безопасности памяти. Работа с прошивками для Teensy, STM32, nRF52 и SAMD. CX Codex ★ 42 780звёзд репо Compiler Explorer compiler-explorer MCP-сервер Compiler Explorer для Claude Code и других AI-агентов. Компилирует код через godbolt.org, показывает ассемблер и создаёт ссылки для обмена результатами. CX Codex +1 ★ 19 201звёзд репо Arm MCP Server arm Arm MCP Server — MCP-сервер для Claude Code, который помогает переносить код с x86 на Arm и разбирать вопросы архитектуры Arm. Он также проверяет образы Docker и анализирует ассемблер. CX Codex +1 ★ 95звёзд репо

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

Весь набор →
low-power-embedded Скилл low-power-embedded для Claude Code и Codex: настройка режимов низкого энергопотребления микроконтроллеров — сон, стоп, ждущий режим, отключение тактирования периферии и конфигурация пробуждения. CX Codex +1 397установок bootloaders-embedded Скилл bootloaders-embedded помогает писать загрузчики для микроконтроллеров Cortex-M: безопасный переход из bootloader в приложение, перенос таблицы векторов, обновление прошивки по UART или USB DFU. CX Codex +1 395установок 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установок mmio-and-bit-manipulation Скилл mmio-and-bit-manipulation для безопасной работы с памятью периферии: volatile-семантика, read-modify-write паттерны, маски битов и выравнивание. Пригодится при написании драйверов голого железа без HAL. CX Codex +1 392установок dma-baremetal Скилл dma-baremetal помогает настраивать прямую передачу данных в память на микроконтроллерах без операционной системы. Пригодится при разгрузке CPU от приёма пакетов UART, SPI или ADC. CX Codex +1 392установок bus-drivers-i2c-spi Скилл bus-drivers-i2c-spi помогает писать клиентские драйверы Linux для датчиков и PMIC на шинах I2C и SPI: регистрация, regmap, привязка к device tree. CX Codex +1 392установок uart-serial-baremetal Скилл uart-serial-baremetal помогает настроить bare-metal UART и USART на микроконтроллерах для вывода логов, расчёта битрейта и отладки. CX Codex +1 391установок

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

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