Troubleshooting
Problem
How do I manually download and run an IBM Rational Rose RealTime application on Tornado / VxWorks and how do I use manual mode Target Observability (T.O.)?
Resolving The Problem
Downloading Rose RealTime Application
Note: You must have WindShell running. This assumes your target board is correctly booting VxWorks and you have a target server running on your host. For more information on these topics refer to your Tornado/VxWorks documentation.
In a WindShell session, change directories to where the IBM Rational Rose RealTime application was built. This file is located in a subdirectory specified by the OutputDirectory (Component, C++ Generation) property. If your executable is currently stored in /home/myhome/RoseRT/mycomponent/build, then you can change the directory to this location by :
cd "/home/myhome/RoseRT/mycomponent/build"
Note that the directory name is in quotes, this is required by the WindShell cd command. To load the model use the ld command :
ld < Top.out
The file to use is the executable located in the Rose RealTime component's build directory. The filename base is set by the TopCapsule (Component, C++ Executable) property in Rose RealTime. The usual filename extension used for VxWorks executables is ".out".
The application is linked during (down)load, so you may see link errors at this stage. If you do not see any errors, you may proceed and run the application on your target.
Running a Rose RealTime Application :
The "main" function, in a Rose RealTime application built for VxWorks, is called "rtsMain". It is the entry point for the application and must be used with the spawn command, "sp", as follows:
sp rtsMain
The application should now be running.
Note that standard input/output (I/O) does not appear in the WindShell session. Normally the standard I/O goes to a serial line which you must monitor separately. You should see something like the following header :
ObjecTime Micro Run Time System
Release 6.01.C.01
Copyright (c) 1993-1999 ObjecTime Limited
objectime: observability listening not enabled
RTS debug: ->
In this example the debugger is waiting for input and you must type "q" to quit the RTS debugger and to let the application run. To disable the debugger at start up, use the "-URTS_DEBUG=quit" option (quotes are required) :
sp rtsMain, "-URTS_DEBUG=quit"
Running Rose RealTime Applications with Manual Mode Target Observability
Set the Operation mode (Component Instance, Detail) property to Manual.
Add "-oblisten=<portnum>" to the Parameters (Component Instance, Detail) property, without the quotes and substitute a real number instead of <portnum>. (In order to use manual mode target observability, you must specify on which port the Rose RealTime toolset listens.)
Assuming you specified 9000 as the port number above, the WindShell command line to start your Rose RealTime application would be (quotes are required):
sp rtsMain, "-obslisten=9000"
Right click on the Component Instance in Rose RealTime and select "Attach Target" from the context menu. This should connect to toolset to the target and bring up the Runtime View browser in Rose RealTime.
You are now in manual mode target observability and can open monitors, place probes, and otherwise control the application running on target.
See the following section and its subsections in the online documentation for more information on target observability and debugging Rose RealTime models:
Toolset Guide > Running and Debugging
Related Information
Historical Number
9133
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21133956