From 0a8b66ee95e0dc5f7a7e72eafb7d2aee05dd626c Mon Sep 17 00:00:00 2001
From: Ivan Kravets <me@ikravets.com>
Date: Tue, 26 Jan 2021 21:21:41 +0200
Subject: [PATCH] Configure a custom debug adapter speed using a new
 `debug_speed` option // Resolve #3799

---
 HISTORY.rst                   | 6 +++++-
 docs                          | 2 +-
 platformio/__init__.py        | 2 +-
 platformio/project/options.py | 5 +++++
 4 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/HISTORY.rst b/HISTORY.rst
index 5bccb302..9b5218b9 100644
--- a/HISTORY.rst
+++ b/HISTORY.rst
@@ -34,10 +34,14 @@ PlatformIO Core 5
   - Significantly speedup PlatformIO Home loading time by migrating to native Python 3 Asynchronous I/O
   - Added a new ``--session-id`` option to `pio home <https://docs.platformio.org/page/core/userguide/cmd_home.html>`__ command that helps to keep PlatformIO Home isolated from other instances and protect from 3rd party access (`issue #3397 <https://github.com/platformio/platformio-core/issues/3397>`_)
 
+* **Debugging**
+
+  - Configure a custom debug adapter speed using a new `debug_speed <https://docs.platformio.org/page/projectconf/section_env_debug.html#debug-speed>`__ option (`issue #3799 <https://github.com/platformio/platformio-core/issues/3799>`_)
+  - Handle debugging server's "ready_pattern" in "stderr" output
+
 * **Miscellaneous**
 
   - Improved listing of `multicast DNS services <https://docs.platformio.org/page/core/userguide/device/cmd_list.html>`_
-  - Check for debugging server's "ready_pattern" in "stderr"
   - Fixed a "UnicodeDecodeError: 'utf-8' codec can't decode byte" when using J-Link for firmware uploading on Linux (`issue #3804 <https://github.com/platformio/platformio-core/issues/3804>`_)
   - Fixed an issue with a compiler driver for ".ccls" language server (`issue #3808 <https://github.com/platformio/platformio-core/issues/3808>`_)
 
diff --git a/docs b/docs
index 24f57666..d50d1e2c 160000
--- a/docs
+++ b/docs
@@ -1 +1 @@
-Subproject commit 24f57666602e68e53904ec3600e5f011d55b3aba
+Subproject commit d50d1e2c75a44aac26dda85f58787a5210125927
diff --git a/platformio/__init__.py b/platformio/__init__.py
index f049e6fd..cebcd1ed 100644
--- a/platformio/__init__.py
+++ b/platformio/__init__.py
@@ -47,7 +47,7 @@ __pioremote_endpoint__ = "ssl:host=remote.platformio.org:port=4413"
 __default_requests_timeout__ = (10, None)  # (connect, read)
 
 __core_packages__ = {
-    "contrib-piohome": "~3.3.2",
+    "contrib-piohome": "~3.3.3",
     "contrib-pysite": "~2.%d%d.0" % (sys.version_info.major, sys.version_info.minor),
     "tool-unity": "~1.20500.0",
     "tool-scons": "~2.20501.7" if sys.version_info.major == 2 else "~4.40100.0",
diff --git a/platformio/project/options.py b/platformio/project/options.py
index b5eaf337..213a2104 100644
--- a/platformio/project/options.py
+++ b/platformio/project/options.py
@@ -681,6 +681,11 @@ ProjectOptions = OrderedDict(
                     "network address)"
                 ),
             ),
+            ConfigEnvOption(
+                group="debug",
+                name="debug_speed",
+                description="A debug adapter speed (JTAG speed)",
+            ),
             ConfigEnvOption(
                 group="debug",
                 name="debug_svd_path",