Skip to main content

Debug Features

mcu-debug extends basic GDB debugging with several features designed for embedded development. These go beyond run, pause, step, and breakpoints to give you visibility into your target's state while it is running.

Feature Overview

FeatureDescription
Live WatchMonitor variable values in real time while the target runs — no halt required
DisassemblyView and step through ARM assembly interleaved with source code
Memory ViewInspect and modify any memory address, with hex/decimal/binary display
Peripheral ViewBrowse peripheral registers and bitfields using SVD files from your MCU vendor
Multi-coreDebug CM0+ and CM4 cores simultaneously on devices like PSoC6
RTOS ViewsThread-aware debugging via the rtos-views companion extension

Debug Output Channels

In addition to the features above, mcu-debug supports three channels for capturing debug output from the target while it runs. These are covered in the Tracing section:

  • RTT — bidirectional communication over the SWD debug connection, no extra pins
  • UART — serial port output from a UART on the target
  • SWO — ITM/TPIU trace output (limited support)