dma-baremetal — скилл для Claude Code: что делает и как установить
Скилл dma-baremetal помогает настраивать прямую передачу данных в память на микроконтроллерах без операционной системы. Пригодится при разгрузке CPU от приёма пакетов UART, SPI или ADC.
MIT 392 установок ★ 298 обновлён 2026-06-27
npx skills add mohitmishra786/low-level-dev-skills --skill dma-baremetal -a claude-codeЧто делает dma-baremetal
Скилл генерирует C-код прямой работы с регистрами контроллеров DMA для архитектур STM32 и Cortex-M. Он конфигурирует каналы и потоки, выставляет инкремент адресов памяти, настраивает циклический режим со сбросом счётчика NDTR и прерывания по половине передачи HTIF или полному завершению TCIF.
В инструкциях разобран перенос буферов приёма USART в память и работа с двойной буферизацией. На ядрах Cortex-M7 вроде STM32H7 память для DMA требует инвалидации D-Cache через SCB_InvalidateDCache_by_Addr, иначе приём данных вернёт повреждённый массив из кэша.
Скилл также подсказывает порядок очистки флагов в ISR через регистры LISR и HIFCR, предотвращая зацикливание прерываний.
Какие задачи решает
- настроить кольцевой буфер UART RX через регистры DMA
- разгрузить ядро процессора при поточной передаче пакетов ADC
- устранить сбои кэш-когерентности на ядрах Cortex-M7
- найти несоответствие потока и канала DMA в таблице периферии
Примеры запросов агенту
- /dma-baremetal Настрой кольцевой буфер приёма UART через DMA на STM32F4
- /dma-baremetal Добавь сброс кэша D-Cache для буфера приёма на STM32H7
- /dma-baremetal Почему не стартует передача DMA2 Stream 5 для USART2?
Как установить dma-baremetal
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill dma-baremetal -a claude-code2Вручную: положить файлы
~/.claude/skills/dma-baremetal/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/dma-baremetal/
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill dma-baremetal -a codex2Вручную: положить файлы
.agents/skills/dma-baremetal/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill dma-baremetal -a cursor2Вручную: положить файлы
.cursor/skills/dma-baremetal/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mohitmishra786/low-level-dev-skills skills/baremetal/dma-baremetal2Вручную: положить файлы
.github/skills/dma-baremetal/SKILL.md1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill dma-baremetal -a gemini-cli2Командой платформы
gemini skills install https://github.com/mohitmishra786/low-level-dev-skills --path skills/baremetal/dma-baremetalВручную: положить файлы
.devin/skills/dma-baremetal/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill dma-baremetal -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о dma-baremetal
Как установить dma-baremetal в Claude Code?
Выполните в терминале команду npx skills add mohitmishra786/low-level-dev-skills --skill dma-baremetal -a claude-code.
Для чего нужен этот скилл?
Он помогает ИИ-агенту писать корректный bare-metal код для периферии DMA: настраивать потоки, связывать каналы с регистрами устройств и обрабатывать прерывания передачи.
Как решается проблема искажения данных на Cortex-M7?
Скилл добавляет размещение буфера в некэшируемой области памяти либо вызовы SCB_CleanDCache_by_Addr перед передачей и SCB_InvalidateDCache_by_Addr сразу после приёма DMA.
Исходный текст
SKILL.md · MIT
---
name: dma-baremetal
description: Bare-metal DMA skill for memory-peripheral transfers. Use when configuring DMA channels, circular mode, double buffering, or DMA IRQ completion. Activates on queries about DMA bare-metal, circular buffer, memory-to-peripheral, or DMA stream configuration.
---
# DMA (Bare-Metal)
## Purpose
Configure DMA controllers for memory-to-peripheral and peripheral-to-memory transfers: channel/stream setup, burst sizes, circular mode, half-transfer interrupts, and cache coherency on Cortex-M7.
## When to Use
- Offloading UART/SPI/ADC bulk transfers from CPU
- Audio/streaming double buffers
- Debugging DMA not triggering or corrupt data
## Workflow
### 1. STM32 DMA2 stream (periph→mem)
```c
/* UART2 RX DMA — Stream5, Channel 4 (verify RM matrix) */
RCC->AHB1ENR |= RCC_AHB1ENR_DMA1EN;
DMA1_Stream5->PAR = (uint32_t)&USART2->DR;
DMA1_Stream5->M0AR = (uint32_t)rx_buf;
DMA1_Stream5->NDTR = sizeof(rx_buf);
DMA1_Stream5->CR = DMA_SxCR_MINC /* mem increment */
| DMA_SxCR_TCIE /* transfer complete IRQ */
| DMA_SxCR_CHSEL_2 /* channel 4 */
| DMA_SxCR_EN;
USART2->CR3 |= USART_CR3_DMAR;
```
### 2. Circular / double buffer
```c
DMA1_Stream5->CR |= DMA_SxCR_CIRC; /* auto-reload NDTR */
/* HTIF = first half, TCIF = second half — process in IRQ */
```
### 3. Cortex-M7 cache (H7)
DMA buffer in non-cacheable region or clean/invalidate D-Cache:
```c
SCB_CleanDCache_by_Addr((void*)tx_buf, len);
/* after DMA TX */
SCB_InvalidateDCache_by_Addr((void*)rx_buf, len);
```
### 4. Agent usage
```
/dma-baremetal Configure UART RX DMA circular buffer on STM32F4
```
## Common Problems
| Symptom | Cause | Fix |
|---------|-------|-----|
| DMA no start | Stream/channel mismatch | RM DMA request mapping table |
| Corrupt RX | Cache coherency (M7) | Invalidate after RX complete |
| NDTR stuck | Peripheral DMA enable missing | USART_CR3 DMAR/DMAT |
| IRQ flood | Clear flags in ISR | `DMA_LISR`/`HIFCR` |
## Related Skills
- `skills/baremetal/uart-serial-baremetal` — USART DMA enable
- `skills/baremetal/adc-dac-baremetal` — ADC DMA mode
- `skills/low-level-programming/cpu-cache-opt` — cache line concepts
© mohitmishra786 · MIT · mohitmishra786/low-level-dev-skills