gpio-baremetal — Claude Code skill: what it does, how to install
gpio-baremetal configures GPIO modes, alternate functions, pull resistors, and EXTI interrupts on bare-metal microcontrollers without HAL.
MIT 383 installs ★ 298 updated 2026-06-27
npx skills add mohitmishra786/low-level-dev-skills --skill gpio-baremetal -a claude-codeWhat gpio-baremetal does
The skill generates low-level C code to manage hardware I/O pins across STM32, nRF52, and ESP32 targets. It configures pin directions in MODER, manages internal pull resistors via PUPDR, performs atomic toggling through BSRR, and routes peripheral signals like UART or SPI via AFR register fields.
For edge detection, it provides setup sequences covering SYSCFG->EXTICR pin routing, EXTI event masking, edge trigger selections, and vector registration in NVIC. Peripheral bus clocks in RCC or power domains must be activated first; otherwise, any register writes to GPIO peripherals fail silently.
What it helps with
- Toggle output pins and blink LEDs without vendor HAL code
- Multiplex microcontroller pins to USART or SPI peripheral functions
- Configure active-low button inputs with internal pull-up resistors
- Set up edge-triggered external interrupts via EXTI and NVIC
Example prompts for the agent
- /gpio-baremetal Configure PA2 as USART2 TX alternate function on STM32F4
- /gpio-baremetal Set up PC13 as an active-low button input with pull-up
- /gpio-baremetal Configure a falling-edge EXTI interrupt on PC13 with NVIC setup
How to install gpio-baremetal
1Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill gpio-baremetal -a claude-code2Manually: put the files in place
~/.claude/skills/gpio-baremetal/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gpio-baremetal/
1Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill gpio-baremetal -a codex2Manually: put the files in place
.agents/skills/gpio-baremetal/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill gpio-baremetal -a cursor2Manually: put the files in place
.cursor/skills/gpio-baremetal/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install mohitmishra786/low-level-dev-skills skills/baremetal/gpio-baremetal2Manually: put the files in place
.github/skills/gpio-baremetal/SKILL.md1Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill gpio-baremetal -a gemini-cli2Platform CLI
gemini skills install https://github.com/mohitmishra786/low-level-dev-skills --path skills/baremetal/gpio-baremetalManually: put the files in place
.devin/skills/gpio-baremetal/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill gpio-baremetal -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about gpio-baremetal
How to install gpio-baremetal in Claude Code?
Run npx skills add mohitmishra786/low-level-dev-skills --skill gpio-baremetal -a claude-code. The skill file will be created at ~/.claude/skills/gpio-baremetal/SKILL.md.
Which microcontrollers does this skill cover?
It focuses on STM32 register structures while supplying configuration patterns for nRF52 and ESP32 hardware.
Why write bare-metal GPIO routines instead of using HAL?
Direct register manipulation removes runtime library overhead and verifies hardware pin connections before initializing complex system drivers.
Source text
SKILL.md · MIT
--- name: gpio-baremetal description: Bare-metal GPIO skill for pin configuration and interrupts. Use when configuring GPIO modes, alternate functions, pull resistors, or EXTI interrupts on STM32/nRF/ESP32-class MCUs. Activates on queries about GPIO MODER, alternate function, pin interrupt, or LED/button bare-metal setup. --- # GPIO (Bare-Metal) ## Purpose Configure and use GPIO without HAL: input/output modes, alternate function mapping, pull-up/down, speed/slew, and pin-change interrupts for LEDs, buttons, and peripheral pin mux. ## When to Use - Blink LED or read button before bringing up UART/SPI - Mux pins to USART/SPI alternate functions - EXTI line interrupts on pin edges - Porting GPIO code between vendors ## Workflow ### 1. STM32 GPIO pattern ```c /* Enable GPIOA clock */ RCC->AHB1ENR |= RCC_AHB1ENR_GPIOAEN; /* PA5 output — MODER[11:10] = 01 */ GPIOA->MODER &= ~(3U << (5 * 2)); GPIOA->MODER |= (1U << (5 * 2)); /* Toggle via BSRR — atomic set/reset */ GPIOA->BSRR = (1U << 5); /* set */ GPIOA->BSRR = (1U << (5+16)); /* reset */ ``` Alternate function (e.g., USART2 TX on PA2): ```c GPIOA->MODER &= ~(3U << (2*2)); GPIOA->MODER |= (2U << (2*2)); /* AF mode */ GPIOA->AFR[0] &= ~(0xFU << (2*4)); GPIOA->AFR[0] |= (7U << (2*4)); /* AF7 = USART2 */ ``` ### 2. Input with pull-up ```c /* PC13 input, pull-up */ GPIOC->MODER &= ~(3U << (13*2)); /* input mode 00 */ GPIOC->PUPDR &= ~(3U << (13*2)); GPIOC->PUPDR |= (1U << (13*2)); /* pull-up */ int pressed = !(GPIOC->IDR & (1U << 13)); /* active low */ ``` ### 3. EXTI interrupt (STM32) ```c /* SYSCFG: map EXTI13 to PC13 */ SYSCFG->EXTICR[3] = (SYSCFG->EXTICR[3] & ~0xFU) | 0x2; /* port C */ EXTI->IMR |= (1U << 13); EXTI->FTSR |= (1U << 13); /* falling edge */ NVIC_EnableIRQ(EXTI15_10_IRQn); ``` ISR: check `EXTI->PR`, clear with write-1. ### 4. nRF52 / ESP32 notes | Platform | Pattern | |----------|---------| | nRF52 | `NRF_P0->PIN_CNF[n]` — direction, pull, drive | | ESP32 | `GPIO.out_w1ts`, `GPIO.enable`; IO_MUX for function | Always enable peripheral clock / power domain before pin config. ### 5. Agent usage ``` /gpio-baremetal Configure PA2 as USART2 TX alternate function on STM32F4 ``` ## Common Problems | Symptom | Cause | Fix | |---------|-------|-----| | Pin stuck | Wrong MODER / not AF | Re-read RM pin table | | EXTI storm | No debounce / floating input | Enable pull; debounce in software | | AF mismatch | Wrong AFR nibble | Pin-specific AF table in RM | | No toggle visible | Wrong port bit / LED active low | Check schematic | ## Related Skills - `skills/baremetal/mmio-and-bit-manipulation` — BSRR/MODER masks - `skills/baremetal/peripherals-from-datasheet` — RM pinout tables - `skills/baremetal/uart-serial-baremetal` — AF mux for serial
© mohitmishra786 · MIT · mohitmishra786/low-level-dev-skills