Remote Connections view

diff -r 16e8bfa397ad -r ff0156b93599 core/com.nokia.carbide.cpp.doc.user/html/projects/remote_conn/view_remote_connection.htm --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/remote_conn/view_remote_connection.htm Wed Oct 06 10:31:32 2010 -0500 @@ -0,0 +1,181 @@ + + + + + + +Remote Connections view + + + + + +

Remote Connections view

Use the Remote Connections view to monitor, create, edit, or remove common connection settings for remote agents. Remote agents provide support for debugging, profiling, trace, and more. The connection types currently supported include:

Bluetooth — available for debug support
Serial — mainly for boards with a serial interface
USB — available for both debug and trace support

The columns in the Remote Connections view include:

Connection/Services - connection name defined by you and remote agent type
Type - connection type, i.e. Bluetooth, USB, TCP/IP, etc.
Status - current connection status, i.e. Available, Not Accessible, Ready, etc.
Description - provides information on the current connection test status.

Figure 1 - Remote Connections view

When the view is closed or another perspective opened, a small display appears in the trim area in the lower-right corner of the workspace showing the current active remote connection. Click the connection name to open the drop-down menu where you can open the Remote Connections view or switch between connections.

Figure 2. Available remote connection trim indicator

Remote Connections view toolbar icons

The following commands appear on the toolbar within the Remote Connections view:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Item	Icon	Explanation
Toggle periodic service testing		Toggles service testing on or off.
Refresh Connections	+ +	Click to update the connection list status.
New Connection	+ +	Click to open the New Connection wizard to add a connection.
Edit Connection	+ +	Click to edit the selected remote connection.
View menu		Select the connection types to monitor for remote connections.

Remote Connections view Status icons

The following status indicators appear in the Remote Connections view:

+ + + + + + + + + + + + + + + + + + + + + + + + + + +

Item	Icon	Explanation
Connection	+ +	Indicates an inactive remote connection setting.
Not Active	+ +	Indicates an inactive connection type.
Ready / Available	+ +	Indicates an active remote connection is ready or that a particular connection type is available.
Not Accessible	+ +	Cannot access the connection type within the connection setup. This could be due to one of the following conditions: + + Nokia Ovi/PC Suite is not installed (Carbide uses their drivers to connect to remote devices) + User did not select Ovi/PC Suite mode on the device + CODA (Carbide On-device Debug Agent) is not installed on the device + + If all the above is setup the remote device should automatically appear when it is connected to the PC. The Description field contains useful debug information that can help solve the issue as well.

Remote Connections view context menu options

Based on the current selection, one or more of the following commands appear on the context menu when you right-click within the Remote Connections view. For example, if no connections are defined, only the New Connection command is available on the context menu.

Figure 3 - Remote Connections context menu

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Item	Icon	Explanation
New Connection...	+ +	Select to open the New Connection wizard to add a connection.
Rename		Select to rename the currently selected connection.
Edit Settings...	+ +	Select to edit the selected remote connection settings.
Delete	+ +	Select to delete the selected connection from the connection list.
Help for...	+ +	Select to open the Help view for connection information.
Make Current		Make the selected connection the current connection.

Related references

+ + + +