OpenParable
Skip to content
← Back to skills

Platform Port

Development
platform-port

Platform Port is an Agent Skill for development published in the FastLED/FastLED repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Guide porting FastLED to new MCU platforms, including int.h types, clockless drivers, SPI implementations, and platform detection. Use when adding support for a new microcontroller family or board.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/FastLED/FastLED/blob/HEAD/.claude/skills/platform-port/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/platform-port, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Guide the process of porting FastLED to a new microcontroller platform.

$ARGUMENTS

What This Skill Covers

Platform Detection Setup

  • Create platform detection headers (is_<platform>.h)
  • Define FL_IS_<PLATFORM> macros following naming convention
  • Wire into existing detection chain (src/platforms/)

Integer Type Definitions

  • Create platform-specific int.h with correct primitive type mappings
  • Register in the src/platforms/int.h dispatcher

LED Output Drivers

  • Clockless (bit-bang) driver implementation
  • SPI hardware driver if platform supports it
  • RMT/I2S/PARLIO drivers for ESP32 variants
  • GPIO register access patterns for the target MCU
  • Peripheral existence check FIRST — before naming any <Peripheral>_Type typedef or <Peripheral>_BASE address, verify the peripheral EXISTS on the target chip against BOTH the vendor CMSIS PAL header for that specific variant AND the chip's datasheet chapter. See agents/docs/peripheral-existence.md for the halt-on-phantom rule and the LPC804 anti-example (framework-arduino-lpc8xx#35).
  • Register-map authoring — use the vendor CMSIS PAL header (LPC845.h, stm32f4xx.h, nrf52840.h, hardware/structs/*.h, etc.); do not hand-roll register shims. See agents/docs/register-maps.md for the rule, the vendor-source table, and the tier-1/2/3 integration pattern.

Build System Integration

  • PlatformIO board definition
  • Meson build configuration
  • Compiler flags and linker scripts

How To Use

/platform-port STM32H7
/platform-port RP2040
/platform-port nRF52840
/platform-port I need to add support for the ESP32-P4

What You'll Get

  • Step-by-step porting checklist with file locations
  • Platform detection header template
  • Integer type mapping research and implementation
  • Clockless driver skeleton based on platform GPIO speed
  • Build system configuration guidance
  • Testing strategy for the new platform