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

uart-serial-baremetal — скилл для Claude Code: что делает

Скилл uart-serial-baremetal помогает настроить bare-metal UART и USART на микроконтроллерах для вывода логов, расчёта битрейта и отладки.

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

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

Что делает uart-serial-baremetal

Скилл генерирует код прямой работы с регистрами UART и USART без блокирующего HAL. Внутри собраны формулы расчёта регистра BRR по частоте шины PCLK, настройка кадров 8N1 и типовые функции опроса флагов TXE и RXNE.

Промпты помогают поднять кольцевой буфер приёма по прерываниям и перенаправить вывод printf через переопределение системной функции _write в newlib. При этом сборку с перенаправленным выводом нужно линковать с флагом --specs=nosys.specs.

Также скилл подсказывает решения для частых аппаратных сбоев. Например, сброс ошибки переполнения ORE через чтение регистра DR или настройку альтернативных функций выводов GPIO.

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

  • рассчитать значение регистра BRR для заданной скорости и частоты PCLK
  • организовать приём данных в кольцевой буфер через прерывание USART
  • перенаправить вывод функции printf в последовательный порт через _write
  • устранить зависания и потерю байтов из-за ошибки ORE

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

  • /uart-serial-baremetal Рассчитай USART BRR для 115200 при 84 МГц PCLK
  • Напиши функцию _write для перенаправления printf в USART2 на STM32
  • Сделай обработчик прерывания USART2_IRQHandler с кольцевым буфером и очисткой ORE

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

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/uart-serial-baremetal/SKILL.md

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

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

Вопросы об uart-serial-baremetal

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

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

Что делает этот скилл?

Он предоставляет инструкции и шаблоны Си-кода для работы с UART на уровне регистров: расчёт baud rate, polling, обработку прерываний и вывод логов.

Почему зависает стандартный printf при выводе в UART?

В среде newlib для работы printf требуется собственная реализация функции _write, а проект необходимо линковать с флагом --specs=nosys.specs.

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

SKILL.md · MIT
---
name: uart-serial-baremetal
description: Bare-metal UART skill for serial console and debug. Use when configuring baud rate, polling or IRQ-driven TX/RX, or integrating DMA with UART. Activates on queries about UART bare-metal, baud BRR, serial printf, or USART interrupt.
---

# UART Serial (Bare-Metal)

## Purpose

Implement UART/USART for debug console and device communication: baud rate calculation, 8N1 framing, polling and interrupt-driven I/O, overrun handling, and optional DMA basics.

## When to Use

- First `printf`/log output on new hardware
- Serial protocol to sensor/module
- Replacing blocking HAL_UART with minimal driver
- Fixing garbled or missing characters

## Workflow

### 1. Baud rate (STM32)

```
BRR = pclk / (16 * baud)   /* oversampling by 16 — check RM for USART */
```

```c
void usart2_init(uint32_t pclk, uint32_t baud) {
    RCC->APB1ENR |= RCC_APB1ENR_USART2EN;
    /* GPIO PA2/PA3 AF — see gpio-baremetal */

    USART2->BRR = pclk / baud;  /* simplified — RM has fractional formula */
    USART2->CR1 = USART_CR1_TE | USART_CR1_RE | USART_CR1_UE;
}
```

Verify `pclk` from actual clock tree (`SystemCoreClock`, APB prescaler).

### 2. Polling TX/RX

```c
void uart_putc(USART_TypeDef *u, char c) {
    while (!(u->SR & USART_SR_TXE))
        ;
    u->DR = (uint8_t)c;
}

char uart_getc(USART_TypeDef *u) {
    while (!(u->SR & USART_SR_RXNE))
        ;
    return (uint8_t)u->DR;
}
```

### 3. Interrupt-driven RX ring buffer

```c
void USART2_IRQHandler(void) {
    if (USART2->SR & USART_SR_RXNE) {
        uint8_t b = USART2->DR;
        rb_push(&rx_rb, b);
    }
    if (USART2->SR & USART_SR_ORE) {
        (void)USART2->DR;  /* clear overrun — required on STM32 */
    }
}
```

### 4. retarget `printf` (newlib)

```c
int _write(int fd, char *ptr, int len) {
    (void)fd;
    for (int i = 0; i < len; i++)
        uart_putc(USART2, ptr[i]);
    return len;
}
```

Link with `--specs=nosys.specs` or provide full syscalls.

### 5. Agent usage

```
/uart-serial-baremetal Calculate USART BRR for 115200 at 84 MHz PCLK
```

## Common Problems

| Symptom | Cause | Fix |
|---------|-------|-----|
| Garbage chars | Wrong baud/PCLK | Recompute BRR; check APB divider |
| Lost bytes | ORE not cleared | Read DR on ORE; use IRQ + ringbuf |
| No output | TX pin not AF | GPIO alternate function |
| `printf` hangs | `_write` missing | Implement retarget |

## Related Skills

- `skills/baremetal/gpio-baremetal` — TX/RX pin mux
- `skills/baremetal/interrupts-and-exceptions-baremetal` — USART IRQ
- `skills/baremetal/dma-baremetal` — UART RX DMA
- `skills/embedded/openocd-jtag` — semihosting alternative

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

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

Все скиллы по теме «Языки программирования» →
Serial MCP qarnet Связывает ИИ-агента с микроконтроллерами через UART и USB-serial. Через диалог с агентом можно отлаживать платы Arduino и STM32. CX Codex +1 ★ 21звёзд репо serial-mcp-server es617 MCP-сервер serial-mcp-server даёт агенту инструменты для работы с последовательным портом: открыть соединение, отправить команду, прочитать ответ, дёрнуть DTR. CX Codex +1 ★ 27звёзд репо arduino-serial-monitor wedsamuel1230 Скилл arduino-serial-monitor для Claude Code читает и анализирует вывод последовательного порта Arduino: логи загрузки, данные датчиков и ошибки связи. CX Codex +1 1установок Agentic HIL agentic-hil MCP-сервер Agentic HIL связывает ИИ-агента с реальной отладочной платой через программатор. Позволяет безопасно прошивать чип, читать UART и отправлять CAN-сообщения прямо в цикле разработки. CX Codex +1 ★ 33звёзд репо Chiplab veecle MCP-сервер Chiplab для Claude Code и других редакторов. Агент собирает прошивку в ELF, загружает её на виртуальную плату и читает вывод UART — без физического железа. CX Codex +1 ★ 19звёзд репо embedded-systems https://github.com/Jeffallan Скилл embedded-systems настраивает агента на разработку прошивок для STM32 и ESP32. Он помогает писать драйверы, FreeRTOS-задачи и оптимизировать потребление памяти и энергии. CX Codex +1 7 300установок

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

Весь набор →
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установок 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установок 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установок qemu-embedded-simulation Скилл qemu-embedded-simulation для Claude Code помогает запускать bare-metal прошивки ARM и RISC-V в QEMU и подключать GDB. Проверяет прошивку без платы. CX Codex +1 389установок

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

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