Skip to content
| Marketplace
Sign in
Visual Studio Code>Debuggers>Coil for ESP32New to Visual Studio Code? Get it now.
Coil for ESP32

Coil for ESP32

Preview

Coil

|
2 installs
| (0) | Free
Fast ESP32 debugging on Coil's own JTAG stack: one-key debug, build, flash and monitor for ESP-IDF projects.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Coil for ESP32 (preview)

Press F5 in an ESP-IDF project and debug the board on Coil's own JTAG stack: no OpenOCD, no launch.json to write, no tool paths to set. Build, Flash and Monitor are one command each.

Tested with: ESP32-C3, ESP32-C6 and ESP32-S3 over the chip's built-in USB-JTAG, and the classic ESP32 (and the S3's JTAG pins) through an ESP-Prog. Windows 10 and 11 (x64) only for now.

User guide · Benchmarks · Report an issue · coil.zone

Getting started

  1. Install this extension.
  2. Plug in the board by the USB port wired to the chip (USB-JTAG), not a USB-to-serial chip. An ESP-Prog works too: wire it to the board's JTAG pins.
  3. Open the Coil view in the activity bar. Setup checks what you need and installs what's missing in one click: ESP-IDF (through Espressif's installer, EIM), the USB-JTAG driver and code completion.
  4. Open an ESP-IDF project, or make one with Coil: New Project, and press F5. The chip resets and stops in app_main.

What it does

  • Debug (F5). Coil's own debug adapter, so you don't need GDB, OpenOCD or the C/C++ extension. You get breakpoints, stepping (into inlined functions too), the call stack, variables in every frame, registers, watch, hover, the debug console and the memory view. On the ESP32-S3 both cores show as threads. Restart resets the chip and stops in app_main again.
  • Flash over JTAG. Coil's own flasher skips the unchanged parts and checks the rest by MD5. An app edit flashes in about a second or two. During a debug session, Flash ends the session, flashes, and starts it again with the new code.
  • Build (Ctrl+Shift+B), Monitor, Build Flash and Monitor. Monitor opens the board's serial port without resetting the chip, reconnects after resets, and decodes panics into clickable function at file:line lines.
  • Boards view. It lists every connected board (chip, COM port, status) with Debug, Flash and Monitor on each, and notices boards plugged in or out within about a second.
  • Checks before you hit an error. F5 and Flash check that the board's chip matches the project, that no other program holds the board, and that the board runs the build you debug. They offer the fix (Flash, stop the other program, install the driver) instead of failing in the debugger.
  • Settings in place of menuconfig. Task-based sections, presets (Debug, Release, Low power), search over every option, hover on CONFIG_ names, warnings on sdkconfig lines that have no effect, and Undo.
  • Debug and Release profiles, a one-image Release Image, New Source File (added to CMakeLists.txt for you) and code completion through clangd.

Debug configuration

F5 with no launch.json just works. To keep a configuration:

{ "type": "coil", "request": "launch", "name": "Coil: debug ESP32" }
Attribute Default
serial selected board The board's serial number (MAC address)
probe selected board esp-prog: through an ESP-Prog
buildDir build Build folder
reset true false: attach to the running firmware and halt where it is
stopAt app_main Function to stop at after the reset; empty: don't stop
flash false true: build and flash first. "ifDifferent": flash only if the board doesn't run this build
adapter coil gdb: debug through coil-gdb and ESP-IDF's GDB (needs Microsoft's C/C++ extension)

The guide covers the rest: ESP-Prog wiring, settings, troubleshooting and the command-line tools.

Good to know

  • This is a preview. Please open an issue with what you find.
  • Coil is free to use. It is closed source; see the license.
  • Using Espressif-IDE instead? The installer sets Coil up for it.
  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft