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

mmio-and-bit-manipulation — скилл для Claude Code

Скилл mmio-and-bit-manipulation для безопасной работы с памятью периферии: volatile-семантика, read-modify-write паттерны, маски битов и выравнивание. Пригодится при написании драйверов голого железа без HAL.

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

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

Что делает mmio-and-bit-manipulation

Помогает агенту правильно обращаться к регистрам периферии через memory-mapped I/O. Учит использовать volatile для того, чтобы компилятор не оптимизировал доступы в кеш, показывает, как безопасно менять отдельные биты через RMW-макросы, когда это не вызовет гонку с прерываниями. Объясняет, почему C-битфилды непредсказуемы и как их заменить явными масками.

В скилле — справка по эндианности, выравниванию адресов (важно на ARM: невыровненный доступ может вызвать HardFault), примеры макросов для работы с 8- и 32-битными регистрами, таблица типичных ошибок вроде оптимизированного-почему-то чтения или RMW-гонки с обработчиком прерывания. Даёт ссылки на связанные скиллы про GPIO на голом железе и распределение памяти через линкер-скрипты.

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

  • безопасно менять биты регистра, когда в ISR трогают другие биты
  • избежать оптимизации доступов к регистрам периферии компилятором
  • отладить случайные биты-флипы и зависания при работе с MMIO
  • перенести драйвер регистра с одной архитектуры на другую с учётом эндианности
  • понять, почему volatile нужен везде в регистровом коде

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

  • Покажи безопасный паттерн, чтобы установить бит 3 в MMIO без влияния на другие биты в контексте ISR
  • Почему указатели на периферию должны быть volatile?
  • Как правильно написать макрос REG_SET для атомной установки бита в регистре, если аппаратная поддержка BSRR не доступна?

Как установить mmio-and-bit-manipulation

1Через Skills CLI (Vercel)

npx skills add mohitmishra786/low-level-dev-skills --skill mmio-and-bit-manipulation -a claude-code

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

~/.claude/skills/mmio-and-bit-manipulation/SKILL.md

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

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

Вопросы о mmio-and-bit-manipulation

Как установить скилл mmio-and-bit-manipulation в Claude Code?

Выполни npx skills add mohitmishra786/low-level-dev-skills --skill mmio-and-bit-manipulation -a claude-code, затем открой файл ~/.claude/skills/mmio-and-bit-manipulation/SKILL.md.

Что делает скилл mmio-and-bit-manipulation?

Учит агента писать безопасный код для memory-mapped I/O: как использовать volatile, избежать RMW-гонок с прерываниями, работать с битовыми масками вместо непредсказуемых битфилдов, учитывать эндианность и выравнивание адресов.

На каких платформах работает скилл?

Скилл поддерживает Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Для каждой платформы своя команда установки.

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

SKILL.md · MIT
---
name: mmio-and-bit-manipulation
description: MMIO and register access skill for bare-metal firmware. Use when accessing memory-mapped peripherals with volatile, bit masks, RMW patterns, or endianness concerns. Activates on queries about MMIO, volatile register, bit manipulation, read-modify-write, or register alignment.
---

# MMIO and Bit Manipulation

## Purpose

Guide agents through safe memory-mapped I/O: `volatile` semantics, read-modify-write patterns, bitfield pitfalls, alignment and endianness, and portable register access macros for bare-metal drivers.

## When to Use

- Writing peripheral register drivers without HAL
- Fixing intermittent register corruption or stale reads
- Replacing C bitfields with explicit masks
- Porting drivers between little-endian MCUs
- Auditing ISR vs main-line register access

## Workflow

### 1. MMIO fundamentals

Peripheral registers live at fixed addresses in the CPU memory map. The compiler must not cache reads/writes.

```c
#include <stdint.h>

#define PERIPH_BASE   0x40000000U
#define GPIOA_MODER   (*(volatile uint32_t *)(PERIPH_BASE + 0x20000U))
```

| Qualifier | Effect |
|-----------|--------|
| `volatile` | Forces load/store each access — required for hardware |
| `const volatile` | Read-only hardware (rare) |
| Plain `uint32_t *` | **Wrong** — compiler may optimize away |

### 2. Read-modify-write macros

```c
#define REG32(addr)        (*(volatile uint32_t *)(addr))
#define REG_SET(addr, mask)   (REG32(addr) |= (mask))
#define REG_CLR(addr, mask)   (REG32(addr) &= ~(mask))
#define REG_TOGGLE(addr, mask) (REG32(addr) ^= (mask))
#define REG_WRITE(addr, val)  (REG32(addr) = (val))
#define REG_READ(addr)        (REG32(addr))
```

**Good** — atomic intent for single-bit updates when register supports it:

```c
#define GPIOA_BSRR  REG32(0x40020018U)
GPIOA_BSRR = (1U << 5);        /* set PA5 */
GPIOA_BSRR = (1U << (5+16));   /* reset PA5 — STM32 BSRR pattern */
```

**Bad** — non-atomic RMW on interrupt-shared registers:

```c
uint32_t v = REG_READ(GPIOA_MODER);
v |= (1U << 10);
REG_WRITE(GPIOA_MODER, v);  /* ISR may interleave — lost update */
```

Fix: disable IRQ briefly, use hardware set/clear registers, or LL atomic bitband if available.

### 3. Bitfield pitfalls

```c
/* Bad — layout is implementation-defined, not portable */
typedef struct {
    uint32_t mode  : 2;
    uint32_t type  : 1;
    uint32_t speed : 2;
} gpio_moder_bits_t;
```

Prefer explicit masks:

```c
#define GPIO_MODER_MODE0_SHIFT   0
#define GPIO_MODER_MODE0_MASK    (3U << GPIO_MODER_MODE0_SHIFT)
#define GPIO_MODER_MODE0_VAL(n)  ((n) << GPIO_MODER_MODE0_SHIFT)

REG32(GPIOA_MODER) = (REG32(GPIOA_MODER) & ~GPIO_MODER_MODE0_MASK)
                   | GPIO_MODER_MODE0_VAL(1);  /* output */
```

### 4. Endianness and alignment

- Cortex-M and most MCUs: **little-endian** — `uint32_t` MMIO at word-aligned addresses
- Unaligned `uint32_t` access may fault on ARMv7-M+
- 8-bit registers: use `volatile uint8_t` with correct byte lane address

```c
#define REG8(addr)  (*(volatile uint8_t *)(addr))
```

### 5. Memory barriers (when needed)

```c
/* After configuring peripheral before first use */
__DSB();
__ISB();

/* After DMA setup, before enabling channel */
__DMB();
```

Use CMSIS barriers (`core_cm4.h`) on Cortex-M.

### 6. Agent usage examples

```
/mmio-and-bit-manipulation Safe pattern to set bit 3 without affecting other bits in ISR context
/mmio-and-bit-manipulation Why must peripheral pointers be volatile?
```

## Common Problems

| Symptom | Cause | Fix |
|---------|-------|-----|
| Register write ignored | Wrong address/clock gated | Enable peripheral clock first |
| Random bit flips | RMW race with ISR | BSRR-style atomic regs or critical section |
| HardFault on access | Unaligned or protected bus | Match access width to datasheet |
| Optimized-away read | Missing `volatile` | Use `volatile uint32_t` |
| Bitfield wrong value | Compiler packs unexpectedly | Use shift/mask macros |

## Related Skills

- `skills/baremetal/peripherals-from-datasheet` — extracting register maps
- `skills/baremetal/gpio-baremetal` — GPIO register patterns
- `skills/low-level-programming/assembly-arm` — inline asm barriers
- `skills/embedded/linker-scripts` — peripheral memory map regions

© 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звёзд репо LabWired w1ne MCP-сервер LabWired для Claude Code, запускающий прошивку в виртуальной среде поверх моделируемого кремния, периферии и шин данных. Выполняет автоматизированную проверку встроенного ПО в CI или через ИИ-агентов. CX Codex +1 ★ 206звёзд репо arm-cortex-microcontrollers Ryan Snodgrass Плагин arm-cortex-microcontrollers для Claude Code помогает разрабатывать прошивки для ARM Cortex-M с драйверами периферии и паттернами безопасности памяти. Работа с прошивками для Teensy, STM32, nRF52 и SAMD. CX Codex ★ 42 780звёзд репо embedded-systems https://github.com/Jeffallan Скилл embedded-systems настраивает агента на разработку прошивок для STM32 и ESP32. Он помогает писать драйверы, FreeRTOS-задачи и оптимизировать потребление памяти и энергии. CX Codex +1 7 300установок domain-embedded actionbook Скилл domain-embedded направляет работу с embedded и no_std Rust: памятью, прерываниями и периферией. Пригодится при разработке прошивок для микроконтроллеров. CX Codex +1 3 200установок mspm0-ccs mc3545dada Скилл mspm0-ccs для Claude Code задаёт правила работы с прошивкой MSPM0: что менять в .syscfg и какие сгенерированные файлы не трогать. CX Codex +1 507установок

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

Весь набор →
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установок baremetal-startup Скилл baremetal-startup помогает настроить инициализацию микроконтроллера от сброса до функции main(): таблицы векторов, обнуление .bss и копирование .data для Cortex-M и RISC-V. CX Codex +1 394установок 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установок kernel-concurrency Скилл kernel-concurrency помогает выбрать правильный примитив синхронизации в ядре Linux: spinlock, mutex, RCU, seqlock или completion. CX Codex +1 391установок

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

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