pio

Initialize new project

$ pio project init --board [uno]

$ pio run

$ pio run --target upload

$ pio device monitor

$ pio boards [search_term]

$ pio pkg install --library "[library_name]"

$ pio test

$ pio pkg update

pio [project] [run] [device] [pkg] [boards] [options] [args]

pio (PlatformIO Core CLI) is a development platform for embedded systems. It supports hundreds of boards including Arduino, ESP32, STM32, and more.
Project initialization creates the directory structure and configuration. The platformio.ini file defines boards, frameworks, and dependencies.
Building compiles code for target platforms. Multiple environments can be defined for different boards or configurations.
Upload transfers firmware to connected devices. Serial monitor provides interactive communication for debugging.
Library management handles dependencies. Libraries are installed globally or per-project. The registry contains thousands of libraries.
Unit testing runs on embedded devices or host machines. This enables test-driven development for firmware.
VS Code integration through the PlatformIO IDE extension provides a full development environment.

project init

Initialize project.

Build project.

Upload firmware.

Clean build.

Serial monitor.

List devices.

Search boards.

Install package.

Update packages.

List packages.

Run unit tests.

Target environment.

Project directory.

Verbose output.

Large download for platform support. First build downloads toolchains. Some obscure boards may lack support. Configuration can be complex for advanced use.

PlatformIO was created by Ivan Kravets starting around 2014. It unified fragmented embedded development tooling, providing cross-platform, vendor-independent infrastructure for IoT development.

arduino-cli(1), esptool(1), avrdude(1), openocd(1)