MiniTutorial:

Debugging RTSS Applications Remotely in Visual Studio

RTX applications can be debugged remotely, from a Target system, using the familiar Microsoft Visual Studio development environment on a Host system. This MiniTutorial will show how to debug an application remotely.

In this tutorial, we will use Visual Studio 2015.

Sections in this Topic:

Target Setup

Setup of the Target system requires the following steps:

Install the Remote Debugger:

Install the Visual Studio 2015/2013 C Runtime:

Install the RTX Runtime:

Start the Subsystem:

Copy/Paste Remote Debugging Files:

  1. Navigate to C:\Program Files\IntervalZero\RTX\DebuggerExtensions.
  2. Copy these files:
  1. Navigate to C:\Program Files\Microsoft Visual Studio (2013/2015)\Common7\IDE\Remote Debugger\x86, and then paste the two files into that folder.

Launch the Visual Studio Remote Debugger:

Host Setup

Create or open the project in Visual Studio:

In this example, we'll create an RTSS application called RtssRemoteApp.

Configure the IntervalZero Remote Real-Time Debugger:

  1. With the project open in Visual Studio, select the IntervalZero Remote Real-Time Debugger from the Debugger drop-down.
  2. In the Property Pages dialog, click Configuration Properties > Debugging. Do the following:
  1. Make sure IntervalZero Remote Real-Time Debugger is selected.
  2. Set the Command line to the full local path to the binary you want to launch on the Target system. For example: C:\Debug\Srtm.rtss.
  3. Specify any Command Arguments.
  4. Set the Remote Server Name to the name of the Target system.

NOTE:  If the Remote Server Name you provide is invalid, the following error is encountered: The Microsoft Visual Studio Remote Debugging Monitor (MSVSMON.EXE) does not appear to be running on the remote computer. More appropriately, the Visual Studio Remote Debugger service on the target computer cannot connect back to this computer. The debugger is unable to resolve the specified computer name.

Debug the Target Application

IMPORTANT!  The version of the Visual Studio Remote Tools installed on the Target system must exactly match the Visual Studio version on the Local system (the system running the debugger).

Start Debugging:

  1. On the Host system, build the RtssDebug configuration of the binary you want to debug, and then copy that binary to the Command line path on the Target system that you specified in Step 2b under Host Setup.
  2. On the Host System, in Visual Studio, press F5 or Debug > Start Debugging to debug the binary on the Target system.

You should see the Host/Target connection in the Visual Studio Remote Debugging Monitor dialog.

Topics:

MiniTutorials:

IntervalZero.com | Support | Give Feedback