Installing debugger

VS Code has a built-in debugger, its setup documentation is here. Apparently some people use it successfully for Espressif chips (launch.json “type”: “gdb”).

Espressif have a dedicated VS Code extension for debugging which is likely the better choice (launch.json “type”: “espidf”):


More details on how to set it up

How to use it



Bin icon in bottom blue toolbar.


Barrel icon in bottom blue toolbar.

Or Menu > Terminal > Run Build Task

Visual Studio Code configuration for debugging


The config in this file sets up your debug adapter and what is run when you debug (see )

Start debugging

Press: F5


Debugger settings

.vscode/launch.json > “gdbpath” field

.vscode/settings.json > idf.openOCDConfigs

We benefit hugely from resources on the web so we decided we should try and give back some of our knowledge and resources to the community by opening up many of our company’s internal notes and libraries through mini sites like this. We hope you find the site helpful.
Please feel free to comment if you can add help to this page or point out issues and solutions you have found, but please note that we do not provide support on this site. If you need help with a problem please use one of the many online forums.


Your email address will not be published. Required fields are marked *