Skip to content

Instantly share code, notes, and snippets.

View gknops's full-sized avatar

Gerd Knops gknops

View GitHub Profile
@jonlidgard
jonlidgard / zed_esp32_debugging.md
Last active June 30, 2026 10:23
Debugging ESP-IDF using the Zed Editor on a Mac

Zed Editor set-up to do ESP32 Embedded Debugging with the ESP-IDF Framework (macOS).

This gist refers to ESP-IDF v5.5.2 - the current stable version as of Dec '25, paths will obviously change slightly in future versions.

The debugging toolchain works as follows:

  • zed talks to gdb via it's Debug Adapter Protocol (dap) interface. This is configured in .zed/debug.json residing in your project directory. It's crucial to use a version of gdb built with the python extension in order for the dap interface to work - more on this later.
  • gdb talks to openocd via it's built-in gdb server's tcp port (usually 3333).