snippetbashTip

pio debug — Debug PlatformIO projects. More information: <https://docs.platformio.org/en/latest/core/userguide/c

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

commandpio debugcliprojectsinformationplatformiomoredebug

Problem

How to use the pio debug command: Debug PlatformIO projects. More information: <https://docs.platformio.org/en/latest/core/userguide/cmd_debug.html>.

Solution

pio debug — Debug PlatformIO projects. More information: <https://docs.platformio.org/en/latest/core/userguide/cmd_debug.html>.

Debug the PlatformIO project in the current directory:

pio debug

Debug a specific PlatformIO project:

pio debug {{[-d|--project-dir]}} {{path/to/platformio_project}}

Debug a specific environment:

pio debug {{[-e|--environment]}} {{environment}}

Debug a PlatformIO project using a specific configuration file:

pio debug {{[-c|--project-conf]}} {{path/to/platformio.ini}}

Debug a PlatformIO project using the gdb debugger:

pio debug --interface {{gdb}} {{gdb_options}}

Code Snippets

Debug the PlatformIO project in the current directory

pio debug

Debug a specific PlatformIO project

pio debug {{[-d|--project-dir]}} {{path/to/platformio_project}}

Debug a specific environment

pio debug {{[-e|--environment]}} {{environment}}

Debug a PlatformIO project using a specific configuration file

pio debug {{[-c|--project-conf]}} {{path/to/platformio.ini}}

Debug a PlatformIO project using the `gdb` debugger

pio debug --interface {{gdb}} {{gdb_options}}

Context

tldr-pages: common/pio debug

Revisions (0)

No revisions yet.