snippetbashTip

pio test — Run local tests on a PlatformIO project. More information: <https://docs.platformio.org/en/latest/co

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

Viewed 0 times

commandlocalrunpio testclitestsplatformioproject

Problem

How to use the pio test command: Run local tests on a PlatformIO project. More information: <https://docs.platformio.org/en/latest/core/userguide/cmd_test.html>.

Solution

pio test — Run local tests on a PlatformIO project. More information: <https://docs.platformio.org/en/latest/core/userguide/cmd_test.html>.

Run all tests in all environments of the current PlatformIO project:

pio test

Test only specific environments:

pio test {{[-e|--environment]}} {{environment1}} {{[-e|--environment]}} {{environment2}}

Run only tests whose name matches a specific glob pattern:

pio test {{[-f|--filter]}} "{{pattern}}"

Ignore tests whose name matches a specific glob pattern:

pio test {{[-i|--ignore]}} "{{pattern}}"

Specify a port for firmware uploading:

pio test --upload-port {{upload_port}}

Specify a custom configuration file for running the tests:

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

Code Snippets

Run all tests in all environments of the current PlatformIO project

pio test

Test only specific environments

pio test {{[-e|--environment]}} {{environment1}} {{[-e|--environment]}} {{environment2}}

Run only tests whose name matches a specific glob pattern

pio test {{[-f|--filter]}} "{{pattern}}"

Ignore tests whose name matches a specific glob pattern

pio test {{[-i|--ignore]}} "{{pattern}}"

Specify a port for firmware uploading

pio test --upload-port {{upload_port}}

Context

tldr-pages: common/pio test

Revisions (0)

No revisions yet.