firmware-sync

Compare GPIO pin assignments between schematic config and firmware header files.

2|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/pjcau/esp32-emu-turbo --skill firmware-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: firmware-sync
Source: https://github.com/pjcau/esp32-emu-turbo/tree/main/.claude/skills/firmware-sync
Command: npx skills add https://github.com/pjcau/esp32-emu-turbo --skill firmware-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It ensures that GPIO pins defined in the firmware align with the schematic’s pinout, preventing hardware mismatches and potential device failures.

Core Features & Use Cases

  • Cross‑reference verification between the schematic configuration file scripts/generate_schematics/config.py and the firmware definitions file software/main/board_config.h.
  • Conflict detection that highlights mismatched or duplicate GPIO assignments.
  • Fix suggestions proposing edits to the firmware file to match the schematic.

Quick Start

Run the firmware‑sync skill to compare GPIO assignments between the schematic config and board_config.h and receive a mismatch report.

Frequently Asked Questions about firmware-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify ESP32 firmware GPIO pin assignments match my PCB schematic?

You can verify ESP32 GPIO pin assignments by running a line-by-line comparison between the schematic configuration file and the board_config.h header to detect any mismatched or duplicate pins.

What causes mismatched GPIO pins between firmware and schematic designs?

Mismatched GPIO pins occur when hardware definitions in the firmware header file diverge from the pinout specified in the schematic configuration, leading to potential hardware integration failures and device damage.

Can I automatically fix firmware GPIO definitions that conflict with the schematic?

Yes, the verification process detects pin assignment conflicts and proposes specific edits to the firmware file to align board_config.h definitions with the schematic configuration.

Do I need specific files to validate GPIO pin assignments on ESP32 projects?

Yes, validating GPIO pin assignments requires access to both the schematic config file at scripts/generate_schematics/config.py and the firmware header at software/main/board_config.h for comparison.

When should I run a GPIO pin verification check on my embedded hardware project?

Run a GPIO pin verification check when reviewing hardware-software integration or before flashing new firmware to ensure embedded definitions align with the PCB schematic pinout.