Home

Cortex-Debug is an extension to add debugging capabilities for ARM Cortex-M devices to Visual Studio Code.

Please read the Overview document to understand this extension and the debugging process better.

Supported Debug Servers/Probes

• Segger J-Link GDB Server (https://www.segger.com/) (https://wiki.segger.com/J-Link_Visual_Studio_Code). Make sure you use the JLinkGDBServerCL.exe or JLinkGDBServerCLexe and not the GUI versions
• STMicroelectronic's ST-LINK GDB server supplied as part of the STM32CubeIDE (https://www.st.com/resource/en/user_manual/dm00613038-stm32cubeide-stlink-gdb-server-stmicroelectronics.pdf)
• PE-Micro GDB Server (http://www.pemicro.com)
• Texane's St-Link Utils (https://github.com/stlink-org/stlink)
• Black Magic Probe Embedded GDB server (https://github.com/blacksphere/blackmagic/wiki)
• PyOCD (https://github.com/mbedmicro/pyOCD)
• OpenOCD (Note: Please use the latest version, 0.11.0 when writing this, prebuilt binaries for Windows)
  • Many vendors (ST, Cypress/Infineon) ship their own modified versions of OpenOCD. You must use their version to be fully compatible with their devices
• QEMU Emulated Environment

Publications with configuration examples you may find useful

• VSCode ARM Cortex-M debugging
• Cortex-Debug for Visual Studio Code
• Cortex-debug debugger introduction
• A Deep Dive into ARM Cortex-M Debug Interfaces
• How to use VSCode to build a SIG MESH development environment