Skip to main content

IBM Rational Test RealTime 7.5 Integration with Wind River Workbench 3.0

Luc Auvray (luc.auvray@fr.ibm.com), Software Quality Engineer, Team Lead, IBM
Luc Auvray is an IBM software quality engineer and team lead in the Rational Toulouse development lab, in France. He currently works on IBM Rational Test RealTime, IBM Rational Service Tester for SOA and Performance Tester in the System Verification Team.

Summary:  IBM Rational Test RealTime is cross-platform software for component testing and runtime analysis. This article explains how to integrate it with the Wind River Workbench IDE.

Date:  07 Apr 2009
Level:  Intermediate
Activity:  577 views

This article explains how to set up IBM® Rational® Test RealTime Version 7.5 with Wind River Workbench Version 3.0 and demonstrates how Rational Test RealTime works with Wind River.

Install the Rational Test RealTime integration for Wind River Workbench

To install the integration, follow these steps:

  1. Install Rational Test RealTime 7.5.
  2. Install Wind River Workbench 3.0.
  3. Open the TDP (Target Deployment Port) Editor and save the cwinVx86WB3.xdp file. You can get this TDP from IBM Rational Test RealTime support.
  4. Get and install the runtime XSD from the Eclipse EMF release 2.3.1 (xsd-runtime-2.3.1.zip) project Web site: http://www.eclipse.org/modeling/emf/
  5. Launch Wind River Workbench. Select Help> Software Updates > Manage configuration > Add an extension location, and then select:
	C:\Program Files\Rational\TestRealTime\eclipse_33\cdt_40\eclipse

  1. Close and then restart Wind River Workbench.

To check that Rational Test RealTime is correctly integrated into the Carbide workbench, select Windows > Preferences > Test RealTime. The Test RealTime preferences should be displayed, as shown in Figure 1.


Figure 1. Rational Test RealTime preferences
An image showing tree view on left, details on right


If Rational Test RealTime is not visible in the preferences, check that XSD is properly installed. To do so, click Help > Software Updates > Manage Configuration, and check the content of the following directory: C:\WindRiver\workbench3-0\tools\eclipse.


Create the C project for runtime analysis

To create a simple Wind River VxWorks V6.6 RealTime process project integrated with Rational Test RealTime, follow these steps:

  1. Select File > New > VxWorks Real Time Process Project, as shown in Figure 2.

Figure 2. Create a project
An image showing a menu command

  1. Type a name for the project (for example, TestAppli), as shown in Figure 3.

Figure 3. Project name and location
An image showing the project name and location settings

  1. In the wizard, click Next until you reach the Build Specs page.
  2. On the Build Specs page, in the Active build spec list, select SIMPENTIUMgnu_RTB, as shown in Figure 4.

Figure 4. Select available and enabled build specs
Drop-down list showing multiple build spec options

  1. Click Next and Finish. This creates the project in the workbench.
  2. Right-click the project and click Properties to check the properties of the application, as shown in Figure 5.

Figure 5. Right-click the project in Project Explorer
A menu selection within the Project Explorer

  1. Select Build Properties and ensure that SIMPENTIUMgnu_RTP is selected as the Active build spec, as shown in Figure 6.

Figure 6. Verify the Active build spec
Properties page showing tree view on left, details on right

  1. To create a simple C application, right-click the project and select New > File (see Figure 7).

Figure 7. Create a C application
Project Explorer menu selection

  1. Type a name (for example, main.c), as Figure 8 shows.

Figure 8. Create a new file resource
Set parent folder using the New File dialog box

  1. Create a bit of simple source code. You can copy the example in Listing 1.

Listing 1. Source code

#include <vxWorks.h>
#include <stdio.h>
#include <stdlib.h>
#include <taskLib.h>
#include <semLib.h>
#include <string.h>
#include <ioLib.h>

int main() 
{
	int fd;
	char buffer[15];
	int nBytes;
	fd = open ("/TestRTReportVxWorks6.txt", O_CREAT | O_WRONLY, 0644);
	printf("in the main\n");
	strcpy(buffer,"The buffer\n");
	nBytes=10;
	if(fd){
		nBytes = write (fd, buffer, nBytes);
		close(fd);
		printf("file closed\n");
	}
	else
	{
		printf("file not opened\n");
	}
	return 0;
}

  1. Save the source code.

Enable Rational Test RealTime

To enable Rational Test RealTime runtime analysis on the application:

  1. Right-click the project and select Test RealTime > Enabled, as shown in Figure 9. This creates a Test RealTime folder in the project.

Figure 9. Enable Rational Test RealTime
A menu command in the Project Explorer

  1. In the Test RealTime folder, open Default, and then, double-click Default.settings (Figure 10).

Figure 10. Folder expanded in the Project Explorer
Showing the expanded set of project folders

  1. In the settings window, select Build > Build options.
  2. In Target Deployment Port, select the TDP (for example, C++ VxWorks6.6 for Gnu on Windows vxsim), as shown in Figure 11.

Figure 11. Select "Target Deployment Port"
Tree view on left, Value table on right

  1. In Build options, select All code insertion, and then, click the ellipses (…) button, as shown in Figure 12.

Figure 12. Open Build options
Select button in Value column

  1. Select the runtime analysis features that you want to enable (for example, Code Coverage), as shown in Figure 13.

Figure 13. List of options
An image showing the Build Options list

  1. Click OK, and then save and close the settings.

Update the instrumentation command for Rational Test RealTime

  1. In the Wind River workbench, click Project > Properties > Build Properties > Build Tools.
  2. For each build tool, except the Assembler, add TestRTcc (with a space before and after) to the Command line after the semicolon (;).

For C-Compiler, the Command field should look like the screen capture in Figure 14, where the Command code includes TestRTcc %, so that this line reads:

echo "building $@'; TestRTcc % :compilerprefix%


Figure 14. Edited Code
List on left, Build Properties dialog on right


For Linker, that line in the Command should look like what Figure 15 shows: echo "building $@'; TestRTcc %: cpplinkerprefix%


Figure 15. Amend the command code
List on left, Build Properties dialog on right


Build and run the project

  1. To build the project with Rational Test RealTime enabled, select Project > Clean (Figure 16). This performs the instrumented compilation with Rational Test RealTime.

Figure 16. Clean the project
An image showing a menu command

  1. To run the application, right-click the application and select Run RTP on target (Figure 17).

Figure 17. Run the application
A menu command for starting the application

After execution, the Rational Test RealTime result files are generated in Wind River (this is defined in the TDP basic setting: ATL_TRACES_FILE)

  1. In the Run window, click the Main tab, and in Connection to use, select vxsim0, as shown in Figure 18.

Figure 18. Create, manage, and run configurations
List on left, configuration dialog on right

  1. Open the TestRealTime folder and refresh the view (F5) to see the result file, result.xtp, as shown in Figure 19.

Figure 19. View the result file
An image showing the tree view in Project Explorer

  1. To see the results, right-click the results.xtp file and click Open with > TestRealTime Results, as shown in Figure 20.

Figure 20. View the results
An image showing a menu command

This opens the Rational Test RealTime report view shown in Figure 21.


Figure 21. Report view
Project Explorer on left, Bar Chart on right

To learn more about IBM Rational Test RealTime and other Rational testing software, see the citations in Resources.


Resources

Learn

Get products and technologies

Discuss

About the author

Luc Auvray is an IBM software quality engineer and team lead in the Rational Toulouse development lab, in France. He currently works on IBM Rational Test RealTime, IBM Rational Service Tester for SOA and Performance Tester in the System Verification Team.

Comments (Undergoing maintenance)



Trademarks  |  My developerWorks terms and conditions

Help: Update or add to My dW interests

What's this?

This little timesaver lets you update your My developerWorks profile with just one click! The general subject of this content (AIX and UNIX, Information Management, Lotus, Rational, Tivoli, WebSphere, Java, Linux, Open source, SOA and Web services, Web development, or XML) will be added to the interests section of your profile, if it's not there already. You only need to be logged in to My developerWorks.

And what's the point of adding your interests to your profile? That's how you find other users with the same interests as yours, and see what they're reading and contributing to the community. Your interests also help us recommend relevant developerWorks content to you.

View your My developerWorks profile

Return from help

Help: Remove from My dW interests

What's this?

Removing this interest does not alter your profile, but rather removes this piece of content from a list of all content for which you've indicated interest. In a future enhancement to My developerWorks, you'll be able to see a record of that content.

View your My developerWorks profile

Return from help

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=Rational
ArticleID=379322
ArticleTitle=IBM Rational Test RealTime 7.5 Integration with Wind River Workbench 3.0
publish-date=04072009
author1-email=luc.auvray@fr.ibm.com
author1-email-cc=

My developerWorks community

Tags

Help
Use the search field to find all types of content in My developerWorks with that tag.

Use the slider bar to see more or fewer tags.

Popular tags shows the top tags for this particular content zone (for example, Java technology, Linux, WebSphere).

My tags shows your tags for this particular content zone (for example, Java technology, Linux, WebSphere).

Use the search field to find all types of content in My developerWorks with that tag. Popular tags shows the top tags for this particular content zone (for example, Java technology, Linux, WebSphere). My tags shows your tags for this particular content zone (for example, Java technology, Linux, WebSphere).

Rate a product. Write a review.

Special offers