Debugging with Wokwi

See manual.

Before starting the Wokwi simulator, one must build the project using the debug build configuration. Either by

• PlatformIO IDE: start project task "Pre-Debug" or "Pre-Debug All"
• PlatformIO CLI:

  platformio debug
  

Configuration to be added to .vscode/launch.json:

For Linux:

        {
            "name": "Wokwi GDB",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/.pio/build/esp32-s3-devkitc-1/firmware.elf",
            "cwd": "${workspaceFolder}",
            "MIMode": "gdb",
            "miDebuggerPath": "~/.platformio/packages/toolchain-xtensa-esp32s3/bin/xtensa-esp32s3-elf-gdb",
            "miDebuggerServerAddress": "localhost:3333"
        },

⚠ If you have more than one launch configuration, make sure to select the right one in the debug view before starting the debugger.