Devtools

[desmonddak]

Description & Motivation

A baseline for a ROHD design debugger: this version has a strong ability to connect to DTD and multiple VMs, and has reconnection and state restoration if we restart the debugger.

It currently will display the latest values in the Details pane, demonstrating a rudimentary connection to the simulator via DTD/VM.

Related Issue(s)

Replaces PR #657

Testing

Tested web build version as well as Devtools in Browser versions.

Backwards-compatibility

Is this a breaking change that will not be backwards-compatible? If yes, how so?

No

Documentation

Does the change require any updates to documentation? If so, where? Are they included?

Yes. Help popups are enabled to describe features currently available.

[desmonddak]

This is semi-usable for debug, allowing for hierarchy traversal, port listings, and live value display.

You can build the full devtools version, which installs in extension/ locally.

./tool/gh_actions/devtools/install_devtool.sh

Then you can use the VSCode command Run Devtools in Browser and debug a live ROHD test being debugged in the current VSCode session because the details pane will maintain live port values for whatever level of hierarchy you want to observe.

If you want to debug a remote VSCode session, you can use the tasks that are built into the rohd_devtool_extension area or you can build it yourself. Either way you need to be in the rohd_devtool_extension/ subdirectory:

make web

and then use Flutter to start up the application (see the .vscode/tasks.json for the exact command).

Once started, you paste in the DTD address (or the port-forwarded version) and it will discover the VM debug sessions in that VSCode session, link, and retrieve the design hierarchy and current values (updated live).

This is a baseline framework to which we will add schematic viewing and live waveforms.