A remote debugging session consists of a Host-Target connection, where the Visual Studio IDE resides on the host system and the process to be debugged resides on a target system on the local network. This section describes the steps necessary for setting up an eRTOS target PC and a host PC for debugging eRTOS applications remotely with Visual Studio.
Sections in this Topic:
For a more comprehensive example of debugging an eRTOS application, see MiniTutorial: Debugging Applications in Visual Studio.
Target Setup
Setup of the Target system requires the following steps:
Install the eRTOS Runtime:
- Install eRTOS Runtime. See the Runtime Installation Guide or
For remote debugging with Visual Studio, the eRTOS network must be configured on the target system.
Configure remote debugging:
For launch and attach:
• Run eRTOS Visual Studio Remote Debugger by calling Run RtVSMon.ertos.
Note: The eRTOS network MUST be configured with one network interface and connected to the host system running Visual Studio.
• By default, RtVSMon.ertos uses the first available IP address and 9999 as the port number if not specified. For more detailed information, please refer to eRTOS Visual Studio Remote Debug Monitor.
Host Setup
Create or open the project in Visual Studio:
- Launch one of the supported versions of Visual Studio and either create a new project or open an existing project. For more information on creating a new project, see Developing Applications and DLLs with Visual Studio.
Select the MaxRT eRTOS Debugger:
- With the project open in Visual Studio, select the MaxRT eRTOS Debugger from the Debugger drop-down.
- In the Property Pages dialog, click Configuration Properties > Debugging. Do the following:
- Make sure MaxRT eRTOS Debugger is selected.
- Set the Command line to the full local path to the binary you want to launch on the Target system. For example:
C:\Debug\eRTOSRemoteApp.ertos. - Set Remote Server Name to the IP address of the eRTOS Target System.
- Optionally. If the eRTOS Visual Studio Remote Debug Monitor is listening on a port other than the default port, specify the Remote Server Port.
- Specify any Command Arguments.
Note: If the Remote Server IP address you provide is invalid, the following error is encountered: The MaxRT eRTOS debugger is unable to connect to eRTOS target. Debugging will be aborted.
Debug the Target Application
Start RtVsMon:
- On the Target system, launch the Visual Studio Remote Debugger from Start > All Programs > Visual Studio
- On the Host system, build the eRTOSDebug 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.
- On the Host system, in Visual Studio, press F5 or Debug > Start Debugging to debug the binary on the Target system.
Troubleshooting
If there are any problems connecting the host and target systems:
- Make sure the eRTOS Visual Studio Remote Debug Monitor (RtVSMON.ertos) is running on the Target system.
- Make sure the eRTOS target system IP address matches the Remote Server Name property found in the Configuration Properties > Debugging dialog on the Host system
- Make sure the application you want to debug has been copied to the Target path specified in the Command property in the Configuration Properties > Debugging dialog on the Host System.
- If a firewall uses the Host System, you may need to configure it to allow specific ports for remote debugging.
- Antivirus software programs may cause problems with remote debugging. If you cannot create a successful remote debugging session, check to see if Antivirus is installed on the Host System.
- The eRTOS with networking support has been started on the target system
Note: Visual Studio may close and restart if the connection is lost during remote debugging.
For a more comprehensive example of debugging an eRTOS application, see MiniTutorial: Debugging Applications in Visual Studio.
