Copyright (c) 2007, 2008 Wind River Systems, Inc. Made available under the EPL v1.0
Direct comments, questions to the firstname.lastname@example.org mailing list
Eclipse can be used for developing clients for TCF in Java. TCF host side code is organized into several Eclipse plug-in projects, below are steps to create and populate Eclipse workspace with TCF projects:
svn co svn://dev.eclipse.org/svnroot/dsdp/org.eclipse.tm.tcf
eclipse.exe -vm <JDK path>\bin\javaw.exe -data <Workspace path> -vmargs -Xmx200M
TCF plugins source code is stored in
<TCF Root>\plugins directory.
<TCF Root>/examples/org.eclipse.tm.tcf.examples.daytime.agentfor example code of a customized TCF agent, which implements DayTime service.
CDT can be used to build TCF agent.
CDT .project file is located in
<TCF Root>/agent directory.
Linux is the recommended evaluation platform, since most TCF services are implemented. To build the agent:
GNU/Linux/i686/Debug/agent -L- -l0Use other -l option values to increase agent log details level.
On Windows, SysMonitor service is not implemented, so RSE Processes demos will not work. For building the agent, there are two possibilities:
make SYSOP=Msysin the agent directory.
<TCF Root>/agent/agent.slnand then build and run the agent using Development Studio commands. If getting an error about IPHlpApi.h missing, you'll need to install the latest MS Platform SDK. For the free Visual C++ Express Edition, the following changes in settings may be necessary:
On VxWorks, the file service as well as most debug services are currently
working. Line number mapping and the SysMonitor service (required for RSE Processes
Demo) are not yet implemented.
To build the agent: Use Wind River Workbench 3.0 and VxWorks 6.6 to create a Kernel Module project out of source code in
<TCF Root>/agent directory. Use Workbench
commands to build and run the agent. To run the agent on VxWorks Simulator
you will need to setup a simulated network - see Networking with the VxWorks Simulator chapter
in Wind River VxWorks Simulator user's guide for details.
On Windows, open Project Properties of the agent project, and under C/C++ General > Indexer switch the configuration to "Win32 - Cygwin" or "Win32 - DevStudio" as needed.
For VxWorks, browsing should be configured automatically through the WR Workbench Kernel Module Project.
Remote System Explorer is an Eclipse based component that allows users to create connections to remote machines and explore their file systems, see list of processes and access some other resources, like remote shells. Remote System Explorer has been designed as a flexible, extensible framework to which Eclipse plug-in developers can contribute their own system definitions, actions, etc.
Plugin org.eclipse.tm.tcf.rse enables use of Processes and Files subsystems of Remote System Explorer over TCF. It also extends Processes subsystem to include CPU utilization data and some other process attributes in RSE views.
To connect a remote machine over TCF:
RSE features supported by TCF connection:
Plugins org.eclipse.tm.tcf.debug and org.eclipse.tm.tcf.debug.ui allow to start a debug session by connecting to a machine runnning TCF agent.
To start a debug session over TCF:
In TCF debug session "Debug", "Breakpoints", "Registers", "Variables" and "Expressions" views are populated. Source level debugging is fully supported if the source code can be found in a CDT project in current workspace.