pio-upload

Upload firmware to ESP32 and other microcontrollers via PlatformIO.

161|53|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/SensorsIot/Universal-ESP32-Workbench --skill pio-upload
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pio-upload
Source: https://github.com/SensorsIot/Universal-ESP32-Workbench/tree/main/.claude/skills/pio-upload
Command: npx skills add https://github.com/SensorsIot/Universal-ESP32-Workbench --skill pio-upload

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates firmware uploads to ESP32 and other microcontrollers within a PlatformIO workflow, reducing setup time and human error during flashing.

Core Features & Use Cases

  • Local Uploads: Flash firmware via USB using PlatformIO.
  • Remote Uploads (RFC2217): Deploy firmware over the RFC2217 port from the Portal or remote host.
  • Post-Upload Actions: Optionally start the serial monitor after a successful upload or verify the environment.

Quick Start

Initiate the PlatformIO upload workflow for your ESP32 project by selecting the environment and running the upload sequence.

Frequently Asked Questions about pio-upload

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

FAQPage Schema
How do I upload firmware to ESP32 using PlatformIO?

Uploading firmware to ESP32 using PlatformIO involves selecting the correct environment, configuring the port, checking permissions, and running the upload sequence. The workflow covers device discovery, boot mode guidance, and error handling.

Can I do remote firmware uploads to ESP32 over RFC2217?

Yes, remote firmware uploads to ESP32 over RFC2217 are supported. You can deploy firmware over the RFC2217 port from a remote host or portal, streamlining remote device updates without requiring direct physical USB access.

What is the process for flashing ESP32 firmware via USB in PlatformIO?

Flashing ESP32 firmware via USB in PlatformIO requires local port configuration and boot mode guidance to ensure proper device discovery. The workflow verifies environment selection and permissions before executing the local upload.

Does PlatformIO support post-upload serial monitoring for ESP32?

Yes, PlatformIO supports post-upload serial monitoring for ESP32. After a successful firmware upload, you can optionally start the serial monitor or verify the environment to immediately observe device output.

Why does my PlatformIO ESP32 upload fail during port configuration?

A PlatformIO ESP32 upload often fails during port configuration due to incorrect port settings or missing permissions. The workflow includes permissions checks and error handling to guide you through resolving device discovery and boot mode issues.