uart-serial-baremetal — скилл для Claude Code: что делает
Скилл uart-serial-baremetal помогает настроить bare-metal UART и USART на микроконтроллерах для вывода логов, расчёта битрейта и отладки.
MIT 391 установок ★ 298 обновлён 2026-06-27
npx skills add mohitmishra786/low-level-dev-skills --skill uart-serial-baremetal -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/uart-serial-baremetal/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/uart-serial-baremetal/
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill uart-serial-baremetal -a codex2Вручную: положить файлы
.agents/skills/uart-serial-baremetal/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill uart-serial-baremetal -a cursor2Вручную: положить файлы
.cursor/skills/uart-serial-baremetal/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mohitmishra786/low-level-dev-skills skills/baremetal/uart-serial-baremetal2Вручную: положить файлы
.github/skills/uart-serial-baremetal/SKILL.md1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill uart-serial-baremetal -a gemini-cli2Командой платформы
gemini skills install https://github.com/mohitmishra786/low-level-dev-skills --path skills/baremetal/uart-serial-baremetalВручную: положить файлы
.devin/skills/uart-serial-baremetal/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill uart-serial-baremetal -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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