From 6e6711f2e3751ff21b83c1b32a91bee66b96d53e Mon Sep 17 00:00:00 2001
From: marchersimon <50295997+marchersimon@users.noreply.github.com>
Date: Sat, 1 May 2021 19:27:19 +0200
Subject: [PATCH] pio-test: add page (#5815)

---
 pages/common/pio-test.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 pages/common/pio-test.md

diff --git a/pages/common/pio-test.md b/pages/common/pio-test.md
new file mode 100644
index 0000000000..49643e07d3
--- /dev/null
+++ b/pages/common/pio-test.md
@@ -0,0 +1,28 @@
+# 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 --environment {{environment1}} --environment {{environment2}}`
+
+- Run only tests whose name matches a specific glob pattern:
+
+`pio test --filter "{{pattern}}"`
+
+- Ignore tests whose name matches a specific glob pattern:
+
+`pio test --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 --project-conf {{path/to/platformio.ini}}`