Introduction

Apex offers a number of utilities that enhance the performance and functionality of Rational Apex Embedded. These utilities, except for TestMate, are included on the Apex CD–ROM. For some, noted here, an additional license is required.

This chapter provides a brief introduction to each of the utilities and links to their documentation:

• Assembly Statements
• EneT
• Apex Disassembler
• Format Converter
• Agilent Emulation Probe Interface Guide
• Patching Linker Guide
• Instruction Set Simulator
• Memory Simulator
• Statistical Profiling
• TestMate Runtime Support
• Tasking Logic Analyzer

Note: Not all utilities are available for all Rational Apex Embedded products.

---

Assembly Statements

Note: This utility is available only with Rational ApexEmbedded for Rational Exec and Rational Apex Embedded for Tornado.

Rational Software Corporation provides the asm.h include file for Rational Exec as a machine language interface to the target processor. For Tornado you must use the VxWorks-supplied asm.h file

ASM statements provide, from within the C and C++ languages, low-level access to the processor that is normally available only from assembly language.

Note: Assembly statements are supported only in the Apex Duo product for the PowerPC.

• Assembly Statements

---

EneT

Note: This utility is available only with Rational Apex Embedded for Rational Exec.

Note: EneT is a separately licensed utility. Contact your Rational sales representative to purchase a license.

EneT adds networking capabilities to the Apex Embedded runtime environment. Its two major components are:

TCP/IP Networking	Allows user programs to communicate over a network
Network TDM	Allows developers to download and debug embedded programs over the network

EneT includes configurable device driver libraries for several popular network devices. Users may also write custom device drivers for EneT.

EneT is covered in the Using EneT with Rational Exec.

---

Apex Disassembler

Note: This utility is available with all Rational Apex Embedded products.

The Apex disassembler is an object module disassembler that interleaves source lines and assembler instructions. Unlike disassembling from within the debugger, it needs no target hardware to operate.

The disassembler creates a file with the .asm extension containing the disassembled code. This file can be referred to later, or simply deleted.

• Apex Disassembler

---

Format Converter

Note: This utility is available only with Rational Apex Embedded for Rational Exec and Rational Apex Embedded for Tornado.

For embedded systems, it is sometimes necessary to change the format of executable or relocatable files generated or used by the system. The Format Converter provides this capability.

The command line invocation is presented in the Rational Apex Embedded Command Reference.

• Format Converter

---

Agilent Emulation Probe Interface Guide

Note: This utility is available only with Rational Apex Embedded for Rational Exec.

The Rational Apex Agilent Emulation Probe Interface provides the capability to use the Agilent Emulation Probe to download, debug, and execute programs.

• Agilent Emulation Probe Interface Guide

---

Patching Linker Guide

Note: This utility is available only with Rational Apex Embedded for Rational Exec.

Note: The Patching Linker is a separately licensed utility. Contact your Rational sales representative to purchase a license.

An application is initially linked using the normal Apex linking mechanism. After compiling modifications to your application, a patch of the original VOX executable can be made by adding the DIFF option to your linker description file and re-linking. This produces a new VOX executable that is linked so that differences between the two VOX files are minimized.

• Patching Linker Guide

---

Instruction Set Simulator

Note: This utility is available only with Rational Apex Embedded for Rational Exec.

Note: The Instruction Set Simulator is a separately licensed utility. Contact your Rational sales representative to purchase a license.

The Instruction Set Simulator is not currently available for the M68000 Family and Intel Architecture target processors.

The combination of the Apex compiler and the Apex simulator compiles and executes target code on your host system.

In addition to executing code, the Apex simulator gathers statistics and timing information about your code. Instruction tracing is also available and can record up to the 1000 last executed instructions.

The command line invocation is presented in the Rational Apex Embedded Command Reference.

• Instruction Set Simulator

---

Memory Simulator

Note: This utility is available only with Rational Apex Embedded for Rational Exec.

The memory simulator is a tool designed to allow you to browse your source code and disassembly while in the debugger without using a target.

• Memory Simulator

---

Statistical Profiling

Note: This utility is available with all Rational Apex Embedded products.

The Apex Statistical Profiler provides an estimate of the CPU usage by all parts of a program, including time spent in the runtime system. The profiler examines the program counter at regular intervals and keeps track of where the program is executing. Profiling shares the time-of-day timer interrupt already in use by the kernel. This makes profiling effective yet nonintrusive.

The command line invocation is presented in the Rational Apex Embedded Command Reference.

• Statistical Profiler

---

TestMate Runtime Support

Note: This utility is available with all Rational Apex Embedded products.

Note: TestMate is a separately licensed utility. Contact your Rational sales representative to purchase a license.

TestMate tests applications as they run on the target hardware. It provides test generation, test management, and coverage analysis capabilities.

Because the required TestMate runtime support is included in Apex, it is tightly integrated with the Apex environment.

When TestMate is installed, access online help with the Help > Manuals pulldown in the Apex GUI.

---

Tasking Logic Analyzer

Note: This utility is available only with Rational Apex Embedded for Rational Exec and Rational Apex Embedded for LynxOS.

The Tasking Logic Analyzer allows the Apex Ada programmer to trace task execution and analyze it using saved event files or, by using the debugger, to examine the most recent events. The Trace tool is provided to display event data in such a way as to help in understanding the behavior of the tasks in a number of different ways.

The software consists of an instrumented Ada runtime library, Ada packages to support user program control of logging, support within the Ada debugger, apex_debug, for display of interpreted events and an analysis program, apex_trace_driver. For some systems, Ada compiler options have been implemented to generate trace information for call-return and basic block analysis.

Trace is covered in Using the Tasking Logic Analyzer.