Start here

Use MCUHex with your own firmware.

Upload your .elf, resolve symbols, connect your probe over SWD, and read live variables from your board.

You can create the project now. Sign-in is requested when you upload and parse your .elf.

1

Create or select a project

A project gives MCUHex a place to keep your parsed symbols and monitor state.

2

Drop your .elf file

MCUHex resolves debug symbols so you can search variables by name instead of manual addresses.

3

Connect the SDK and read values

Use the local bridge with ST-Link, J-Link or DAPLink over SWD to flash and monitor your board.

The tray app ships for macOS Apple Silicon and Windows x64. On Linux, run the SDK from source — the README has per-distro steps. The SDK has to run on the computer the probe is plugged into. On Windows, plug the probe in; if an ST-Link shows up greyed out as [no driver], bind it to WinUSB with Zadig (see how it’s done); a J-Link needs SEGGER's software pack.

If the SDK will not start or your probe is not picked up, the troubleshooting guides cover each error with step-by-step fixes.