From 755dd21646075afb72502dca5ffd7fe5f7326abb Mon Sep 17 00:00:00 2001 From: Chris Reed Date: Sun, 29 May 2022 17:54:07 -0500 Subject: [PATCH] docs: gdb_setup: add note about GNU Arm Toolchain not working --- docs/gdb_setup.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/gdb_setup.md b/docs/gdb_setup.md index a230048ab..d8214a9eb 100644 --- a/docs/gdb_setup.md +++ b/docs/gdb_setup.md @@ -37,9 +37,13 @@ Recommended GDB and IDE setup ----------------------------- The recommended toolchain for embedded Arm Cortex-M development is [GNU Arm -Embedded](https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm), +Embedded](https://developer.arm.com/downloads/-/gnu-rm) (GNU-RM), provided by Arm. GDB is included with this toolchain. +Note that the version of GDB included with the new, combined Arm GNU Toolchain as of version 11.2-2022.02 +_will not_ work with pyOCD. This is because it is currently built without the required support for the XML +target descriptions that pyOCD sends to GDB. Versions later than 11.2-2022.02 may have this bug fixed. + For [Visual Studio Code](https://code.visualstudio.com), the [cortex-debug](https://marketplace.visualstudio.com/items?itemName=marus25.cortex-debug) plugin is available that supports pyOCD.