UIAcTools

UIAcTools: The UIA cTools Target Content Package

Many of TI's devices provide advanced emulation capabilities that can be configured by software to enable real-time visibility into the operation of the device without requiring a JTAG connection. The low-level programming of the emulation silicon is handled by CToolsLib, a collection of software libraries that provide programming APIs to configure and use the emulation capabilities. The Unified Instrumentation Architecture cTools package (UIAcTools) provides a number of modules that make it easier to use the functionality provided by the cToolsLib libraries with System Analyzer.

Features

The UIAcTools package provides the following features:

LoggerSTM: Logging UIA events via System Trace The LoggerSTM module is included in uiactools_1_01_00_09 and later. LoggerSTM allows UIA software events to be streamed from a running target directly over the STM serial interface to an XDS560v2 (see XDS560v2_System_Trace) without requiring the allocation of a memory buffer on the target or an Ethernet connection to the device. System Analyzer 1.1 and later supports using System Trace as an event transport, allowing UIA events logged via LoggerSTM to be decoded and analyzed the same way as events logged using the loggers that ship with the UIA package.

Supported Devices

Please see the UIAcTools release notes that ship with the uiactools package for a list of devices that release supports. Unless otherwise noted, UIAcTools can be used with all C66XX devices as well as ARM Cortex M3 CPUs on devices that provide System Trace capabilities.

UIAcTools Tutorials

System Analyzer Tutorial 6 introduces the basics of using the UIAcTools target content package with System Analyzer. The tutorial is based on a project that you can build and run in CCS on an emulation target.

Prerequisites

Before starting the tutorial, you should have done the following:

• Installed Code Composer Studio v5.2.1 or later.

• If you are using a Code Composer Studio release prior to CCSv5.3, you will need to install System Analyzer 1.1 or later

• Please see System Analyzer Installation for details

• You can find out which version of CCS you have installed by opening Help / About Code Composer Studio.
• On some older releases of CCS, the About box version is based on a build date (e.g. N20110110900). In these cases, the CCS version and build number can usually be determined by the name of the ccsv5\ccs_base folder. E.g. ccsv5\ccs_base_5.0.3.00009 indicates that CCSv5.0.3.00009 is installed.
• You can download the latest version of CCS from http://processors.wiki.ti.com/index.php/Category:Code_Composer_Studio_v5#Downloads .
• Please see System Analyzer - Known Issues & Errata for any known issues that may require additional steps to work around.

• Learned how to use Code Composer Studio to create, build, run, and test a program.

• For example, you should be able to launch and step through a program.
• The CCSv5 Getting Started guide is available at CCSv5_Getting_Started_Guide .
• More information on CCSv5 is available at http://processors.wiki.ti.com/index.php/Category:Code_Composer_Studio_v5.

• Read through UIA Tutorial 1 in order to get a basic understanding of how to log UIA events and use System Analyzer to display the events.

• Read through UIA Tutorial 3 in order to get a basic understanding of SysBios software instrumentation.

• Installed the UIA package (uia_1_01_00_09 or later) in the same folder as your CCS installation. (e.g. c:\ti )

• Installed the UIAcTools package (uiactools_1_01_00_09 or later) in the same folder as your CCS installation

• Note that the UIAcTools version is used to indicate which UIA release it depends on. For example, uiactools_1_01_00_09 depends on uia_1_01_00_09 or later.

• For the LoggerSTM Tutorial (System Analyzer Tutorial 6), you will require a JTAG emulator that supports System Trace (e.g. an XDS560v2, or an EVM that has an XDS560v2 Mezzanine board such as the TMDXEVM6670 or TMDXEVM6678).

Overview of the tutorials

--- Links:

• Back up to the System Analyzer Tutorials page
• Back up to the System Analyzer Home