Remote Access Settings

On the Remote Access page in wRTOS Settings, you can choose whether to allow new remote debugging attach connections to this computer and configure remote connections when allowed. You can also see a list of the Microsoft remote tools installed on the system and add or remove support as necessary.

In this section:

Click to expandAccessing Remote Access Settings

To open the Remote Access page in wRTOS Settings:

  1. Open wRTOS Settings.
  2. Do one of the following:
  • From the Home page, click Subsystem. On the Subsystem page, click Remote Access.

  • From any other wRTOS Settings page, click Contents / Subsystem / Remote Access in the sidebar menu.

 

Configure the Remote Connection

Allow remote debugging connections on this computer

This toggle switch determines whether remote debugging attach connections are allowed on this computer. By default, new remote connections are not allowed.

To change this setting:

Do one of the following:

Note: The IP address setting (see below) cannot be changed when Allow remote debugging connections on this computer is set to OFF.

wRTOS Settings displays one of the following messages depending on the toggle state of this setting:

Status Meaning
Remote debugging is not active The Allow remote debugging connections on this computer toggle is set to OFF. This is the default behavior.
Listening on <IP:Port number>

The Subsystem is listening for new remote debugging attached connections to this computer.

Note: The Port number cannot be changed when listening for new remote debugging attached connections.
Not listening. Please specify another IP address for new remote debug attach connections. The Subsystem is not listening for new remote debugging attached connections to this computer because the previously specified IP address is no longer available. Please specify a new IP address (see below).

Note: Setting Allow remote debugging connections on this computer to OFF does not terminate active remote debugger attach sessions. It only prohibits future remote debug attach connections.

IP address

When the Allow remote debugging connections on this computer toggle is set to ON, you can set the IP address for new remote debugging attach connections. You can accept the default (Use first available IP address) or specify a new address. The drop-down menu displays the active IP addresses already in use.

To change this setting:

Do one of the following:

Port number

When the Allow remote debugging connections on this computer toggle is set to OFF, you can set the port number for new remote debugging attach connections. You can accept the default of 31094 or specify a new port number.

Note: This value cannot be changed when the Subsystem is listening for new remote debugging attached connections.

To change this setting:

Enter a positive integer value in the Port number text box. The range is 1 to 65535. wRTOS Settings automatically validates this number against the specified IP address.

Microsoft Remote Tools on the System

wRTOS Settings automatically detects whether the supported Visual Studio remote tools are configured for remote launch and attach and displays their status.

Visual Studio version wRTOS remote debug support
Lists the supported Visual Studio remote tools versions. wRTOS supports remote launch and attach using remote tools for Visual Studio 2022 and 2019.

Displays whether wRTOS remote launch and attach debug support is configured for each version of Visual Studio remote tools.

  • Configured indicates that the version of Visual Studio remote tools is ready for remote debugging via launch and attach. You must now manually start the corresponding version of MSVSMON. For additional information see wRTOSRemoteConfig.

To remove support for a Visual Studio remote tools version, click Remove support.

  • Installed indicates that the version of Visual Studio remote tools is installed but not ready for remote debugging. Further setup is required.

To configure a Visual Studio remote tools version through the wRTOSRemoteConfig command line utility, click Add support.

  • Not Installed indicates that the version of Visual Studio remote tools is not installed.

View the Microsoft documentation to determine the version of Visual Studio remote tools that you need:

https://docs.microsoft.com/en-us/visualstudio/debugger/remote-debugging

RELATED Topics: