Ctools Use Case Library
CTools use case Library

Introduction

The Ctools use case library provides easy to use APIs to integrate commonly used Debug and Trace features like PC trace, memory watch point, profiling etc into the application software. This use case library provides APIs to integrate both Core Trace and System (SoC) Trace features:

The ctools use-case library APIs internally call the low level ctools Libraries (ETBLib, DSPTraceLib, CPTLib, AETLib and STMLib) APIs. For ease of use, the ctools use-case library is designed as a wrapper, which provides complete abstraction from the low level ctools libraries.

Devices Supported

TMS320C6657, TMS320C6670, TMS320C6672, TMS320C6674, TMS320C6678, TMS320TCI6612, TMS320TCI6614, TMS320TCI6616 and TMS320TCI6618

CTOOLS Use Case Library Revision History

Revision Date Notes
1.0 10/12/2012 First release implementation
1.1 12/17/2012 Added support for keystone2 (C66AK2Hxx). Added ETB-EDMA support for C6657
1.2 05/15/2013 Updates for SDOCM00100802 (cToolsLib examples have some errors), SDOCM00100576 (for keystone2, ctools mc_pc_trace_edma_drn unit test fails to initialize dsp trace function) and SDOCM00101368 (ctools use-case library: PC trace capture on a App SW fault)
1.3 04/07/2014 Added support for Edison (C66AK2Exx) and Lamarr (TCI6630K2L) devices
1.4 07/30/2014 For all supported PCT use cases, DSPTrace TEND state needs to be cleared before starting PC trace, Fixed a bug: AET needs to claimed before DSPTrace_setState() API can be used to set DSPTrace TEND state
1.5 05/13/2015 Added support for 66AK2Gxx devices

Ctools Usecase Library

The ctools use case library is intended to demonstrate the following Debug and Trace use cases:

Integration with Application Software

The ctools use case library for all supported devices are available at Ctools_UCLib\lib. For all the supported devices, the following are the instructions to integrate the ctools use case library with the application software:

Please Note: For Big endian support, use the libraries with 'e' appended to the device part number. For Debug versions, use the libraries with '_d' appended to the library name.

Rebuilding the Libraries

For each of the supported targets, CCSv5 projects available at Ctools_UCLib\projects. These projects can be imported into CCS, to rebuild the corresponding use case libraries.

References