How do I install the Platformio skill?

Run npx skillmds add majiayu000/platformio-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Platformio safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Platformio?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Platformio free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Platformio?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Platformio by majiayu000 — Agent Skill

Name: Platformio
Rating: 4.666666666666667 (3 reviews)
Author: majiayu000

File contents

PlatformIO Skill

PlatformIO manages the ESP32 firmware for VanDaemon's 8-channel PWM LED dimmer. The firmware handles MQTT communication, WiFi provisioning via captive portal, and NVS state persistence. All firmware lives in hw/LEDDimmer/firmware/.

Quick Start

Build and Upload

cd hw/LEDDimmer/firmware

# Build for 8-channel variant (default)
pio run -e 8ch

# Upload via USB
pio run -e 8ch -t upload

# Build 4-channel variant
pio run -e 4ch -t upload

Monitor Serial Output

# Start serial monitor at 115200 baud
pio device monitor -e 8ch

# Monitor with timestamp
pio device monitor -e 8ch --filter time

Key Concepts

Concept	Usage	Example
Environment	Build target variant	`-e 8ch`, `-e 4ch`, `-e 8ch-ota`
Upload	Flash firmware to device	`pio run -e 8ch -t upload`
Monitor	Serial debugging	`pio device monitor`
Clean	Remove build artifacts	`pio run -t clean`
OTA	Over-the-air updates	`-e 8ch-ota` environment

Common Patterns

Full Development Cycle

When: Making firmware changes

# Clean, build, upload, then monitor
pio run -e 8ch -t clean && pio run -e 8ch -t upload && pio device monitor -e 8ch

OTA Update

When: Device deployed and accessible via WiFi

# Build and upload via OTA (requires device IP in platformio.ini)
pio run -e 8ch-ota -t upload

Upload Filesystem

When: Updating SPIFFS/LittleFS data

pio run -e 8ch -t uploadfs

Pin Configuration

// PWM Outputs (8 channels)
GPIO 25, 26, 27, 14, 4, 5, 18, 19

// Status LED (WS2812)
GPIO 16

// Buttons
GPIO 32 (Button 1), GPIO 33 (Button 2)

MQTT Integration

The firmware publishes to topics under vandaemon/leddimmer/{deviceId}/:

status - online/offline
config - device configuration JSON
channel/{N}/state - current brightness (0-255)

Subscribes to channel/{N}/set for brightness commands.

See the mqttnet skill for backend MQTT handling.

Related Skills

kicad - PCB design for the LED dimmer hardware
mqttnet - Backend MQTT communication with the dimmer
docker - Running MQTT broker for testing

---name: platformio-2description: Builds and deploys ESP32 firmware with PlatformIO for the VanDaemon LED dimmer hardware. Use when: Building, uploading, or debugging ESP32 firmware in hw/LEDDimmer/--- # PlatformIO Skill PlatformIO manages the ESP32 firmware for VanDaemon's 8-channel PWM LED dimmer. The firmware handles MQTT communication, WiFi provisioning via captive portal, and NVS state persistence. All firmware lives in `hw/LEDDimmer/firmware/`. ## Quick Start ### Build and Upload ```bash cd hw/LEDDimmer/firmware # Build for 8-channel variant (default) pio run -e 8ch # Upload via USB pio run -e 8ch -t upload # Build 4-channel variant pio run -e 4ch -t upload ``` ### Monitor Serial Output ```bash # Start serial monitor at 115200 baud pio device monitor -e 8ch # Monitor with timestamp pio device monitor -e 8ch --filter time ``` ## Key Concepts | Concept | Usage | Example | |---------|-------|---------| | Environment | Build target variant | `-e 8ch`, `-e 4ch`, `-e 8ch-ota` | | Upload | Flash firmware to device | `pio run -e 8ch -t upload` | | Monitor | Serial debugging | `pio device monitor` | | Clean | Remove build artifacts | `pio run -t clean` | | OTA | Over-the-air updates | `-e 8ch-ota` environment | ## Common Patterns ### Full Development Cycle **When:** Making firmware changes ```bash # Clean, build, upload, then monitor pio run -e 8ch -t clean && pio run -e 8ch -t upload && pio device monitor -e 8ch ``` ### OTA Update **When:** Device deployed and accessible via WiFi ```bash # Build and upload via OTA (requires device IP in platformio.ini) pio run -e 8ch-ota -t upload ``` ### Upload Filesystem **When:** Updating SPIFFS/LittleFS data ```bash pio run -e 8ch -t uploadfs ``` ## Pin Configuration ```cpp // PWM Outputs (8 channels) GPIO 25, 26, 27, 14, 4, 5, 18, 19 // Status LED (WS2812) GPIO 16 // Buttons GPIO 32 (Button 1), GPIO 33 (Button 2) ``` ## MQTT Integration The firmware publishes to topics under `vandaemon/leddimmer/{deviceId}/`: - `status` - online/offline - `config` - device configuration JSON - `channel/{N}/state` - current brightness (0-255) Subscribes to `channel/{N}/set` for brightness commands. See the **mqttnet** skill for backend MQTT handling. ## See Also - [patterns](references/patterns.md) - Build configurations and debugging - [workflows](references/workflows.md) - Development and deployment workflows ## Related Skills - **kicad** - PCB design for the LED dimmer hardware - **mqttnet** - Backend MQTT communication with the dimmer - **docker** - Running MQTT broker for testing

Frequently asked questions