*************************************************************

Copyright (c) 2010-2014 Texas Instruments Inc. (www.ti.com)

All rights reserved.

Last updated: April 28, 2014

Description: This document navigates through all the CToolsLib contents and usage of the

ETBLib, DSPTraceLib, AETLib, STMLib, CPTLib, Ctools_UCLib, PMICMILib and SCILib.

*************************************************************

Except where noted all projects are CCSv5.

ETBLib:

ETBLib provides an application interface to program and drain the Embedded Trace Buffer (ETB). There are two kinds of ETB in TI devices, CSETB and TIETB. The ETBLib contains CCSv5 projects in the ETBLib/project directory specifying the supported devices and rules to pickup specific files and flags for different devices.

New for C66xx, TCI66xx, 66AK2Hxx, 66AK2Exx, 66AK2Gxx, TCI6630K2L, TCI6636K2H and TCI663xK2K devices: EDMA draining to system memory for TI-ETB expansion. Supported by all devices in keystone1 and keystone2 family.

Docs

ETBLib API documentation (Doxygen) at:

ETBLib/doc/html/index.html

API

ETBLib/include/ETBInterface.h

Sources

ETBLib/src/ti (for TI ETB)

ETBLib/src/coresight (for CS ETB)

Projects

TCI6488 - ETBLib/project/TCI6488

TCI6486 - ETBLib/project/TCI6486

TCI6484 - ETBLib/project/TCI6484

C66xx - ETBLib/project/C66xx

C6678 - ETBLib/project/C6678

TCI6614 - ETBLib/project/TCI6614

C6657 - ETBLib/project/C6657

66AK2Hxx, 66AK2Exx and TCI6630K2L - ETBLib/project/C66AK2Hxx-C66x

66AK2Hxx, 66AK2Exx and TCI6630K2L - ETBLib/project/C66AK2Hxx-A15

66AK2Gxx - ETBLib/project/66AK2Gxx-C66x

66AK2Gxx - ETBLib/project/66AK2Gxx-A15

66AK2Gxx - ETBLib/project/66AK2Gxx-M3

C6A816x - ETBLib/project/C6A816x (Formerly TI816x)

OMAP-A9 – ETBLib/project/OMAP-A9

OMAP-A15 - ETBLib/project/OMAP-A15

DRA7xx - ETBLib/project/DRA7xx-A15

DRA7xx - ETBLib/project/DRA7xx-C66x

AM437x – ETBLib/project/AM437x-A9

TDA3x- ETBLib/project/TDA3x-M4

Libraries

ETBLib/lib

If you do not plan to use the CCSV5/5 project to build these libraries, you need to use the following information in your non-CCSv5 makefile

TCI6488 - \ETBLib\src\coresight\CSETB.c, preprocessor flag TCI6488 (Do not use TIETB.c)

TCI6486 - \ETBLib\src\coresight\CSETB.c, preprocessor flag TCI6486 (Do not use TIETB.c)

TCI6484 - \ETBLib\src\ti\TIETB.c, preprocessor flag TCI6484 (Do not use CSETB.c)

CA6816x - \ETBLib\src\coresight\CSETB.c, preprocessor flag TI816X & ETM, DSP or STM (Do not use TIETB.c)

C66xx - \ETBLib\src\ti\TIETB.c, preprocessor flag C6670 (Do not use CSETB.c)

C6678 - \ETBLib\src\ti\TIETB.c, preprocessor flag C6678 (Do not use CSETB.c)

C6657 - \ETBLib\src\ti\TIETB.c, preprocessor flag C6657 (Do not use CSETB.c)

C66AK2Hxx-C66x - \ETBLib\src\ti\TIETB.c, preprocessor flag C66AK2Hxx (Do not use CSETB.c)

C66AK2Hxx-A15 - \ETBLib\src\ti\TIETB.c, preprocessor flag C66AK2Hxx_CSSTM_ETB (Do not use CSETB.c)

66AK2Gxx-C66x - \ETBLib\src\ti\TIETB.c, preprocessor flag _66AK2Gxx (Do not use CSETB.c)

66AK2Gxx-A15 - \ETBLib\src\ti\TIETB.c, preprocessor flag _66AK2Gxx (Do not use CSETB.c)

66AK2Gxx-M3 - \ETBLib\src\ti\TIETB.c, preprocessor flag _66AK2Gxx_M3 (Do not use CSETB.c)

TCI6614 - \ETBLib\src\ti\TIETB.c, preprocessor flag TCI6614 (Do not use CSETB.c)

OMAP4xxx - \ETBLib\src\coresight\CSETB.c, preprocessor flag _OMAP & ETM, DSP or STM (Do not use TIETB.c)

OMAP54xx ES2 - \ETBLib\src\ti\TIETB.c, preprocessor flag _OMAP54xx & STM (Do not use CSETB.c)

DRA7xx-A15 - \ ETBLib\src\ti\TIETB.c, preprocessor flag _DRA7xx (Do not use CSETB.c)

DRA7xx-C66x \ ETBLib\src\ti\TIETB.c, preprocessor flag _DRA7xx (Do not use CSETB.c)

AM437x - \ETBLib\src\coresight\CSETB.c, preprocessor flag _AM437x (Do not use TIETB.c)

TDA3x-M4 - \ ETBLib\src\ti\TIETB.c, preprocessor flag _TDA3x (Do not use CSETB.c)

Note: All ETBLib builds for 66AK2Gxx are compatible with D1030.

DSPTraceLib:

DSPTraceLib provides an application interface to program the DSP trace export. The DSPTraceLib contains the CCSv5 projects in the DSPTraceLib/project directory specifying the supported devices and rules to pickup specific files and flags for different devices

Docs

DSPTraceLib API documentation (Doxygen) at:

DSPTraceLib/doc/html/index.html

API

DSPTraceLib/include/DSPTraceExport.h

Projects

TCI6488 - DSPTraceLib/project/TCI6488

TCI6486 - DSPTraceLib/project/TCI6486

TCI6484 - DSPTraceLib/project/TCI6484

C66xx - DSPTraceLib/project/C66xx

DRA7xx - DSPTraceLib/project/DRA7xx

Libraries

DSPTraceLib/lib

If you do not plan to use the CCSV5 project to build these libraries, you need to use the following information in your non-CCSv5 makefile

TCI6488 - DSPTraceLib/src/DSPTraceExport.c, preprocessor flag TCI6488

TCI6486 - DSPTraceLib/src/DSPTraceExport.c, preprocessor flag TCI6486

TCI6484 - DSPTraceLib/src/DSPTraceExport.c, preprocessor flag TCI6484

C66xx - DSPTraceLib/src/DSPTraceExport.c, preprocessor flag C66xx

DRA7xx - DSPTraceLib/src/DSPTraceExport.c, preprocessor flag _DRA7xx

Note:

TDA3x C66x is compatible with the DRA7xx build.

AETLib:

AETLib provides an application interface to program the Advanced Event Triggering (AET) module. This interface can be used to program the Trace trigger rules specifying trace start, stop, and ranges, etc.

Implementation of AET does not change from device to device. This library can be used for all C6x and C66x devices.

Docs

AETLib API documentation (Doxygen) at:

AET/doc/html/index.html

API

AET/include/aet.h

Libraries

AET/lib

STMLib:

STMLib provides an application interface for the STM instrumentation. The STMLib contains the CCSv5 projects in the STMLib/projects directory specifying the supported devices and rules to pickup specific files and flags for different devices.

Docs

STMLib API documentation (Doxygen) at:

STMLib/doc/html//index.html

API

STMLib/include/StmLibrary.h

Projects

CortexA8 - STMLib/projects/A8

CortexA9 - STMLib/projects/A9

CortextA15 – STMlib/projects/A15

CortexM3 - STMLib/projects/M3

C66xx - STMLib/projects/C66xx

Libraries

STMLib/lib

If you do not plan to use the CCSV5 project to build these libraries, you need to use the following information in your non-CCSv5 makefile

CortexA8 -STMLib/src/StmLibrary.c, preprocessor flag _STM

CortexA9 - STMLib/src/StmLibrary.c, preprocessor flag _STM

CortexA15 - STMLib/src/StmLibrary.c, preprocessor flag _STM (for MIPI STM module) or _CS_STM (for ARM 2.0 module)

CortexM3 - STMLib/src/StmLibrary.c, preprocessor flag _STM

C66xx - STMLib/src/StmLibrary.c, preprocessor flag _STM

Note:

The CoretxM3 build can also be used with CoretexM4 devices that contain a either a STM module.

CPTLib:

CPTLib provides an application interface to program the Common Platform Tracers (CPT). CPTLib contains the CCSv5 projects in the CPTLib/projects directory specifying the supported devices and rules to pickup specific files and flags for different devices.

Docs

Each device supported has unique CPTLib API documentation (Doxygen) at:

CPTLib/doc/CPT_C6670_html.index.html for both TMS320C6670 and TMS320TCI6616

CPTLib/doc/CPT_C6672_html.index.html for TMS320C6672

CPTLib/doc/CPT_C6674_html.index.html for TMS320C6674

CPTLib/doc/CPT_C6678_html.index.html for TMS320C6678

CPTLib/doc/CPT_TCI6612_html.index.html for TMS320TCI6612

CPTLib/doc/CPT_TCI6614_html.index.html for TMS320TCI6614

CPTLib/doc/CPT_C6657_html.index.html for TMS320C6657

CPTLib/doc/CPT_C66AK2Hxx_html.index.html for keystone2 devices (66AK2Hxx, TCI6636K2H and TCI663xK2K)

CPTLib/doc/CPT_66AK2Exx_html.index.html for 66AK2Exx device

CPTLib/doc/CPT_TCI6630K2L_html.index.html for TCI6630K2L device

CPTLib/doc/CPT_66AK2Gxx_html.index.html for 66AK2Gxx and D1030 devices

A helper API is provided that can be used as a library wrapper to setup the supported use cases. Documentation is included in the API header include file at:

CPTLib/src/CPTHelper.h

For a CP Tracer detailed description and instructions for running the use case examples see:

https://processors.wiki.ti.com/index.php/Common_Platform_Tracer_Examples

API

CPTLib/include/CPTLib.h

Sources

CPTLib/src/

Projects

C667x - CTPLib/projects/C667x for TMS320C6670 and TMS320TCI6616/18

Note that TMS320C6672, TMS320C6674, TMS320C6678 versions can be built by modifying the CCSv5 project build properties predefined symbol from _C6670 to _C6672, _C6674, or _C6678.

C6657 - CTPLib/projects/C6657 for TMS320C6657

TCI6614 - CTPLib/projects/TCI6614 for TMS320TCI6614

C66AK2Hxx - CTPLib/projects/C66AK2Hxx for 66AK2Hxx, TCI6636K2H and TCI663xK2K family of devices

66AK2Exx - CTPLib/projects/66AK2Exx for 66AK2Exx

TCI6630K2L - CTPLib/projects/TCI6630K2L for TCI6630K2L

66AK2Gxx - CTPLib/projects/66AK2Gxx for 66AK2Gxx and D1030

Libraries

CPTLib/lib

If you do not plan to use CCSV5 project to build this library, you need to use the following information in your non-CCSv5 makefile

_C6670 - Predefined symbol required for TMS320C6670 and TMS320TCI6616 builds

_C6672 - Predefined symbol required for TMS320C6672 build

_C6674 - Predefined symbol required for TMS320C6674 build

_C6678 - Predefined symbol required for TMS320C6678 build

_TCI6614 - Predefined symbol required for TMS320TCI6614 build

_TCI6612 - Predefined symbol required for TMS320TCI6612 build

_C6657- Predefined symbol required for TMS320C6657 build

_C66AK2Hxx- Predefined symbol required for 66AK2Hxx, TCI6636K2H and TCI663xK2K build

_66AK2Exx- Predefined symbol required for 66AK2Exx build

_TCI6630K2L- Predefined symbol required for TCI6630K2L build

_66AK2Gxx- Predefined symbol required for 66AK2Gxx build

_STM_Logging – Predefined symbol for all builds that enables the designed-in STMLib dependency. The STM Library is used to provide logging and metadata transport for the CPTLib. Without the metadata, all CP Tracer data is displayed in its raw format. CPTLib supports both internal logging for CP Tracer state changes and user logging. The user logging support provides a mechanism for users to annotate their CP Tracer data.

Ctools_UCLib:

Ctools_UCLib is a Keystone specific library that provides a use case based API for configuring and controlling AETLib, DSPTraceLib, ETBLib, STMLib and CPTLib.

Docs

CTools_UCLib API documentation (Doxygen) at:

Ctools_UCLib/doc/Ctools_UCLib.html/index.html

API

Ctools_UCLib /include/ctools_uclib.h

Projects

C6657 - Ctools_UCLib/projects/C6657 for TMS320C6657

C6670 - Ctools_UCLib/projects/C6670 for TMS320C6670

C6678 - Ctools_UCLib/projects/C6678 for TMS320C6678

TCI6614 - Ctools_UCLib/projects/TCI6614 for TMS320TCI6614

C66AK2Hxx - Ctools_UCLib/projects/C66AK2Hxx for 66AK2Hxx, TCI6636K2H and TCI663xK2K family of devices

C66AK2Exx - Ctools_UCLib/projects/C66AK2Exx for 66AK2Exx

TCI6630K2L - Ctools_UCLib/projects/TCI6630K2L for TCI6630K2L

66AK2Gxx - Ctools_UCLib/projects/66AK2Gxx for 66AK2Gxx

Libraries

Ctools_UCLib /lib

Examples

Keystone Ctools_UCLib use-case examples are available as a standalone zip package (Ctools_UCLib_Examples_1.x.zip), which can be downloaded from the CtoolsLib gforge site

Keystone Ctools_UCLib use-case examples are also available as a part of Keystone MCSDK instrumentation. For more details please refer to the link below:

https://processors.wiki.ti.com/index.php/BIOS_MCSDK_2.0_User_Guide#cToolsLibrary

If you do not plan to use the CCSV5 project to build these libraries, you need to use the following pre-define symbols in your non-CCSv5 makefile

TCI6614 and _MIPI_STM - Predefined symbol required for TMS320TCI6614 build

C6657 and _MIPI_STM - Predefined symbol required for TMS320C6657 build

C6670 and _MIPI_STM - Predefined symbol required for TMS320C6670 build

C6678 and _MIPI_STM - Predefined symbol required for TMS320C6678 build

C66AK2Hxx and _MIPI_STM - Predefined symbol required for 66AK2Hxx, TCI6636K2H and TCI663xK2K build

C66AK2Exx and _MIPI_STM - Predefined symbol required for 66AK2Exx build

TCI6630K2L and _MIPI_STM - Predefined symbol required for TCI6630K2L build

_66AK2Gxx and _MIPI_STM - Predefined symbol required for 66AK2Gxx build

_STM_LOGGING – See CPTLib for details.

ETMLib:

ETMLib provides APIs to program and capture ETM trace on TCI6614 ARM A8 and C6A816x ARM A8. The same APIs also support programming and capture of PTM trace from 66AK2Hxx, TCI6636K2H, TCI6638K2K, OMAP54xx, and DRA7xx ARM A15s.

Docs

ETMLib API documentation (Doxygen) at:

ETMLib/doc/html/index.html

API

ETMLib /include/etm_lib.h

Projects

ETMLib /projects/A8

Libraries

ETMLib /lib

PMICMILib:

PMICMILib provides an application interface for the PMI and CMI instrumentation. It contains the CCSv5 projects in the PMICMILib/projects directory specifying the supported devices and rules to pickup specific files and flags for different devices.

Docs

PMICMILib API documentation (Doxygen) at:

PMICMILib/doc/html/index.html

API

PMICMILib/include/CMILib.h

PMICMILib/include/PMILib.h

Projects

CMI CortexA9 - PMICMILib/projects/CMI_A9

PMI CortexA9 - PMICMILib/projects/PMI_A9

PMICMI CortexA9 - PMICMILib/projects/PMICMI_A9

PMICMI CortexA9 Linux - PMICMILib/projects/PMICMI_A9_Linux

PMICMI CortexA15 (OMAP5430) - PMICMILib/projects/PMICMI_A15

PMICMI CortexA15 (DRA7xx) - PMICMILib/projects/PMICMI_A15_DRA7xx

Libraries

PMICMILib/lib

If you do not plan to use the CCSV5 project to build these libraries, you need to use the following information in your non-CCSv5 makefile

_OMAP4430 (not required for OMAP54xx)

_DRA7xx – For DRA7xx PMICMILib builds

_CMI – For CMILib and PMICMILib builds

_PMI – For PMILib and PMICMILib builds

_STMLogging – When using STM library

Note: The STMLib directory structure must exist to build the PMICMILib.

SCILib:

SCILib provides a use case based API for configuring and controlling OMAP44xx, OMAP54xx, and DRA7xx, AM437x, and TDA3x Statistic Collectors. The Statistic Collectors generate bus profile data for SDRAM and Masters.

Docs

SCILib API documentation (Doxygen) at:

SCILib/doc/sci_omap4430_html/index.html

SCILib/doc/sci_omap4460_html/index.html

SCILib/doc/sci_omap4470_html/index.html

SCILib/doc/sci_omap5430_html/index.html

SCILib/doc/sci_dra7xx_html/index.html

SCILib/doc/sci_am437x_html/index.html

API

SCILib/include/SCILib.h

Projects

SCILib/projects/omap4430_A9

SCILib/projects/omap4460_A9

SCILib/projects/omap4470_A9

SCILib/projects/omap5430_A15

SCILib/projects/dra7xx_A15

SCILib/projects/am437x_A9

SCILib/projects/tda3x_M4

Libraries

SCILib/lib

If you do not plan to use the CCSV5 project to build these libraries, you need to use the following pre-define symbols in your non-CCSv5 makefile

_OMAP4430 - Predefined symbol required for OMAP4430 build

_SC_VER_1_12 - Predefined symbol required for OMAP4430 build

_STM_LOGGING - Predefined symbol for all builds that enables the designed-in STMLib dependency. The STM Library is used to provide logging and metadata transport for SCILib. Without the metadata, all Statistic Collector data is displayed in its raw format. SCILib supports both internal logging for Statistic Collector state changes and user logging. The user logging support provides a mechanism for users to annotate their Statistic Collector data.

_OMAP4460 - Predefined symbol required for OMAP4460 build

_SC_VER_1_16 - Predefined symbol required for OMAP4460, OMAP4470, OMAP5430, DRA7xx and AM437x builds

_OMAP4470 - Predefined symbol required for OMAP4470 build

_OMAP5430 - Predefined symbol required for OMAP5430 build

_DRA7xx - Predefined symbol required for DRA7xx build

_AM437x - Predefined symbol required for AM437x build

_TDA3x - Predefined symbol required for TDA3x build

Examples:

Examples of using all these libraries together are also posted as part of Examples.zip file (CCSv5 projects)

TCI6488

• DSP Trace - Examples\TCI6488\DSPTrace_CSETB_Ex_core0
• Debug file name: Examples\bin\dsptrace_csetb_d_core0.tci6488.out
• Release file name: Examples\bin\dsptrace_csetb_core0.tci6488.out

TCI6486

• DSP Trace - Examples\TCI6486\DSPTrace_CSETB_Ex_core0
• Debug file name: Examples\bin\dsptrace_csetb_d_core0.tci6486.out
• Debug_be file name: Examples\bin\dsptrace_csetb_d_core0.tci6486e.out
• Release file name: Examples\bin\dsptrace_csetb_core0.tci6486.out
• Release_be file name: Examples\bin\dsptrace_csetb_core0.tci6486e.out

TCI6484

• DSP Trace - Examples\TCI6484\DSPTrace_TIETB_Ex_core0
• Debug file name: Examples\bin\ dsptrace_tietb_d_core0.tci6484.out
• Release file name: Examples\bin\ dsptrace_tietb_core0.tci6484.out

C667x

Note – All supported devices are enclosed inside the parentheses.

• DSP Trace with ETB (C6657, C667x and TCI661x) - Examples\C667x\DSPTrace_TIETB_Ex_CorePacN
• Debug file name: Examples\bin\dsptrace_tietb_d_corepacN.c6670.out
• Release file name: Examples\bin\dsptrace_tietb_corepacN.c6670.out
• DSP Trace with ETB and EDMA expansion (C6670 and TCI661x)- Examples\C667x\DSPTrace_TIETB_EDMA_Ex_CorePacN
• Debug file name (little endian): Examples\bin\dsptrace_tietb-edma_d_corepacN.c6670.out
• Release file name (little endian): Examples\bin\dsptrace_tietb-edma_corepacN.c6670.out
• Debug file name (big endian): Examples\bin\dsptrace_tietb-edma_d_corepacN.c6670e.out
• Release file name (big endian): Examples\bin\dsptrace_tietb-edma_corepacN.c6670e.out
• STM Trace (C6657, C667x, TCI661x and C66AK2Hxx) - Examples\C667x\STM_Ex_CorePacN
• Debug file name: Examples\bin\stm_d_corepacN.c6670.out
• Release file name: Examples\bin\stm_corepacN.c6670.out
• STM Trace with ETB (C6657, C667x and TCI6616/18) - Examples\C667x\STM_TIETB_Ex_CorePacN
• Debug file name: Examples\bin\stm_tietb_d_corepacN.c6670.out
• Release file name: Examples\bin\stm_tietb_corepacN.c6670.out
• STM Trace with ETB and EDMA expansion (C6670 and TCI6616/18)- Examples\C667x\STM_TIETB_EDMA_Ex_CorePacN
• Debug file name: Examples\bin\stm_tietb-edma_d_corepacN.c6670.out
• Release file name: Examples\bin\stm_tietb-edma_corepacN.c6670.out
• CP Tracer (C667x and TCI6616/18) - Examples\C667x\CPT_L2_CorePac0
• Debug file name: Examples\bin\cpt_l2_d_corepac0.c6670.out
• Debug with ETB file name: Examples\bin\cpt_l2_tietb_d_corepac0.c6670.out
• Release file name: Examples\bin\cpt_l2_corepac0.c6670.out
• Release with ETB file name: Examples\bin\cpt_l2_tietb_corepac0.c6670.out
• CP Tracer System Profile (C667x and TCI6616/18) - Examples\C667x\CPT_SystemProfile_CorePacN
• Debug file name: Examples\bin\cpt_sp_d_corepacN.c6670.out
• Debug with ETB file name: Examples\bin\cpt_sp_tietb_d_corepacN.c6670.out
• Release file name: Examples\bin\cpt_sp_corepacN.c6670.out
• Release with ETB file name: Examples\bin\cpt_sp_tietb_corepacN.c6670.out

Note: Some projects include ETB and non-ETB Debug and Release versions (non-ETB version requires XDS560v2 System Trace)

C6678

Note – All supported devices are enclosed inside the parentheses.

• DSP Trace with ETB and EDMA expansion (C6671, C6672, C6674 and C6678)- Examples\C6678\DSPTrace_TIETB_EDMA_Ex_CorePacN
• Debug file name (little endian): Examples\bin\dsptrace_tietb-edma_d_corepacN.c6678.out
• Release file name (little endian): Examples\bin\dsptrace_tietb-edma_corepacN.c6678.out
• Debug file name (big endian): Examples\bin\dsptrace_tietb-edma_d_corepacN.c6678e.out
• Release file name (big endian): Examples\bin\dsptrace_tietb-edma_corepacN.c6678e.out
• STM Trace with ETB and EDMA expansion (C6671, C6672, C6674 and C6678)- Examples\C6678\STM_TIETB_EDMA_Ex_CorePacN
• Debug file name: Examples\bin\stm_tietb-edma_d_corepacN.c6670.out
• Release file name: Examples\bin\stm_tietb-edma_corepacN.c6670.out

Note: Some projects include ETB and non-ETB Debug and Release versions (non-ETB version requires XDS560v2 System Trace)

TCI6614

Note – All supported devices are enclosed inside the parentheses.

• CP Tracer (TCI6612/14) - Examples\TCI6614\CPT_L2_CorePac0
• Debug file name: Examples\bin\cpt_l2_d_corepac0.tci6614.out
• Debug with ETB file name: Examples\bin\cpt_l2_tietb_d_corepac0. tci6614.out
• Release file name: Examples\bin\cpt_l2_corepac0. tci6614.out
• Release with ETB file name: Examples\bin\cpt_l2_tietb_corepac0. tci6614.out
• CP Tracer System Profile (TCI6612/14) - Examples\ TCI6614\CPT_SystemProfile_CorePacN
• Debug file name: Examples\bin\cpt_sp_d_corepacN. tci6614.out
• Debug with ETB file name: Examples\bin\cpt_sp_tietb_d_corepacN. tci6614.out
• Release file name: Examples\bin\cpt_sp_corepacN. tci6614.out
• Release with ETB file name: Examples\bin\cpt_sp_tietb_corepacN. tci6614.out
• STM Trace with ETB - Examples\TCI6614\STM_TIETB_Ex_CorePacN (TCI6612/14)
• Debug file name: Examples\bin\stm_tietb_d_corepacN.tci6614.out
• Release file name: Examples\bin\stm_tietb_corepacN.tci6614.out
• STM Trace with ETB and EDMA expansion (TCI6612/14)- Examples\TCI6614\STM_TIETB_EDMA_Ex_CorePacN
• Debug file name: Examples\bin\stm_tietb-edma_corepacN.tci6614.out
• Release file name: Examples\bin\stm_tietb-edma_d_corepacN.tci6614.out
• A8 Core Trace - Examples\TCI6614\ETM_CSETB_Ex_A8 (TCI6612/14)
• Debug with CS-ETB file name: Examples\bin\ etm_csetb_d_A8.tci6614.out
• Release with CS-ETB file name: Examples\bin\ etm_csetb_A8.tci6614.out

C6657

Note – All supported devices are enclosed inside the parentheses.

• CP Tracer (C6657) - Examples\C6657\CPT_L2_CorePac0
• Debug file name: Examples\bin\cpt_l2_d_corepac0.c6657.out
• Debug with ETB file name: Examples\bin\cpt_l2_tietb_d_corepac0.c6657.out
• Release file name: Examples\bin\cpt_l2_corepac0.c6657.out
• Release with ETB file name: Examples\bin\cpt_l2_tietb_corepac0.c6657.out
• CP Tracer System Profile (C6657) - Examples\C6657\CPT_SystemProfile_CorePacN
• Debug file name: Examples\bin\cpt_sp_d_corepacN.c6657.out
• Debug with ETB file name: Examples\bin\cpt_sp_tietb_d_corepacN.c6657.out
• Release file name: Examples\bin\cpt_sp_corepacN.c6657.out
• Release with ETB file name: Examples\bin\cpt_sp_tietb_corepacN.c6657.out
• DSP Trace with ETB and EDMA expansion (C6657)- Examples\C6657\DSPTrace_TIETB_EDMA_Ex_CorePacN
• Debug file name (little endian): Examples\bin\dsptrace_tietb-edma_d_corepacN.c6657.out
• Release file name (little endian): Examples\bin\dsptrace_tietb-edma_corepacN.c6657.out
• Debug file name (big endian): Examples\bin\dsptrace_tietb-edma_d_corepacN.c6657e.out
• Release file name (big endian): Examples\bin\dsptrace_tietb-edma_corepacN.c6657e.out
• STM Trace with ETB and EDMA expansion (C6657)- Examples\C6657\STM_TIETB_EDMA_Ex_CorePacN
• Debug file name: Examples\bin\stm_tietb-edma_d_corepacN.c6657.out
• Release file name: Examples\bin\stm_tietb-edma_corepacN.c6657.out

C66AK2Hxx (Keystone2 family)

Note – All supported devices are enclosed inside the parentheses.

• DSP Trace with ETB (66AK2Hxx, TCI6636K2H, TCI663xK2K, 66AK2Exx and TCI6630K2L) - Examples\C66AK2Hxx\DSPTrace_TIETB_Ex_CorePacN
• Debug file name: Examples\bin\dsptrace_tietb_d_corepacN.c66ak2hxx.out
• Release file name: Examples\bin\dsptrace_tietb_corepacN.c66ak2hxx.out
• DSP Trace with ETB and EDMA expansion (66AK2Hxx, TCI6636K2H, TCI663xK2K, 66AK2Exx and TCI6630K2L)- Examples\C66AK2Hxx\DSPTrace_TIETB_EDMA_Ex_CorePacN
• Debug file name (little endian): Examples\bin\dsptrace_tietb-edma_d_corepacN.c66ak2hxx.out
• Release file name (little endian): Examples\bin\dsptrace_tietb-edma_corepacN.c66ak2hxx.out
• Debug file name (big endian): Examples\bin\dsptrace_tietb-edma_d_corepacN.c66ak2hxxe.out
• Release file name (big endian): Examples\bin\dsptrace_tietb-edma_corepacN.c66ak2hxxe.out
• STM Trace with ETB (66AK2Hxx, TCI6636K2H, TCI663xK2K, 66AK2Exx and TCI6630K2L) - Examples\C66AK2Hxx\STM_TIETB_Ex_CorePacN
• Debug file name: Examples\bin\stm_tietb_d_corepacN.c66ak2hxx.out
• Release file name: Examples\bin\stm_tietb_corepacN.c66ak2hxx.out
• STM Trace with ETB and EDMA expansion (66AK2Hxx, TCI6636K2H, TCI663xK2K, 66AK2Exx and TCI6630K2L)- Examples\C66AK2Hxx\STM_TIETB_EDMA_Ex_CorePacN
• This example is not supported on Rev1.0 and 1.1 of 66AK2Hxx, TCI6636K2H and TCI663xK2K devices. This errata is fixed in Rev2.0. For more information, please refer to "Debug System (DebugSS) Trace Buffer EDMA via System Port Not Functional" in the respective device errata document.

• CP Tracer (66AK2Hxx, TCI6636K2H and TCI663xK2K) - Examples\C66AK2Hxx\CPT_L2_CorePac0
• Debug file name: Examples\bin\cpt_l2_d_corepac0.c66ak2hxx.out
• Debug with ETB file name: Examples\bin\cpt_l2_tietb_d_corepac0.c66ak2hxx.out
• Release file name: Examples\bin\cpt_l2_corepac0.c66ak2hxx.out
• Release with ETB file name: Examples\bin\cpt_l2_tietb_corepac0.c66ak2hxx.out
• CP Tracer System Profile (66AK2Hxx, TCI6636K2H and TCI663xK2K) - Examples\C66AK2Hxx\CPT_SystemProfile_CorePacN
• Debug file name: Examples\bin\cpt_sp_d_corepacN.c66ak2hxx.out
• Debug with ETB file name: Examples\bin\cpt_sp_tietb_d_corepacN.c66ak2hxx.out
• Release file name: Examples\bin\cpt_sp_corepacN.c66ak2hxx.out
• Release with ETB file name: Examples\bin\cpt_sp_tietb_corepacN.c66ak2hxx.out
• ARM A15 PTM Trace with ETB (66AK2Hxx, TCI6636K2H, TCI663xK2K, 66AK2Exx and TCI6630K2L) - Examples\C66AK2Hxx\PTM_TIETB_Ex_A15
• Debug file name: Examples\bin\ptm_tietb_d_A15.c66ak2hxx.out
• Release file name: Examples\bin\ptm_tietb_A15.c66ak2hxx.out
• ARM A15 PTM Trace with ETB and EDMA expansion (66AK2Hxx, TCI6636K2H, TCI663xK2K, 66AK2Exx and TCI6630K2L) - Examples\C66AK2Hxx\PTM_TIETB_EDMA_Ex_A15
• Debug file name: Examples\bin\ptm_tietb_edma_d_A15.c66ak2hxx.out
• Release file name: Examples\bin\ptm_tietb_edma_A15.c66ak2hxx.out

Note: Before running ARM PTM examples on 66AK2Hxx, TCI6636K2H, TCI663xK2K, 66AK2Exx and TCI6630K2L EVMs, the ARM PLL initialization and switching ON ARM cores needs to be done. Please, follow the below steps to do the same:

o connect to the C66xx_0 core and run it’s startup gel

o Run the GEL script: Scripts --> TCI66x_Functions --> TETRIS_POWERUP_PLL_INIT_100MHZ_to_1000Mhz

Note: Some projects include ETB and non-ETB Debug and Release versions (non-ETB version requires XDS560v2 System Trace)

66AK2Exx

Note – All supported devices are enclosed inside the parentheses.

• CP Tracer (66AK2Exx) - Examples\66AK2Exx\CPT_L2_CorePac0
• Debug file name: Examples\bin\cpt_l2_d_corepac0.66ak2exx.out
• Debug with ETB file name: Examples\bin\cpt_l2_tietb_d_corepac0.66ak2exx.out
• Release file name: Examples\bin\cpt_l2_corepac0.66ak2exx.out
• Release with ETB file name: Examples\bin\cpt_l2_tietb_corepac0.66ak2exx.out
• CP Tracer System Profile (66AK2Exx) - Examples\C66AK2Hxx\CPT_SystemProfile_CorePacN
• Debug file name: Examples\bin\cpt_sp_d_corepacN.66ak2exx.out
• Debug with ETB file name: Examples\bin\cpt_sp_tietb_d_corepacN.66ak2exx.out
• Release file name: Examples\bin\cpt_sp_corepacN.66ak2exx.out
• Release with ETB file name: Examples\bin\cpt_sp_tietb_corepacN.66ak2exx.out

Note: Some projects include ETB and non-ETB Debug and Release versions (non-ETB version requires XDS560v2 System Trace)

TCI6630K2L

Note – All supported devices are enclosed inside the parentheses.

• CP Tracer (TCI6630K2L) - Examples\TCI6630K2L\CPT_L2_CorePac0
• Debug file name: Examples\bin\cpt_l2_d_corepac0.tci6630k2l.out
• Debug with ETB file name: Examples\bin\cpt_l2_tietb_d_corepac0.tci6630k2l.out
• Release file name: Examples\bin\cpt_l2_corepac0.tci6630k2l.out
• Release with ETB file name: Examples\bin\cpt_l2_tietb_corepac0.tci6630k2l.out
• CP Tracer System Profile (TCI6630K2L) - Examples\TCI6630K2L\CPT_SystemProfile_CorePacN
• Debug file name: Examples\bin\cpt_sp_d_corepacN.tci6630k2l.out
• Debug with ETB file name: Examples\bin\cpt_sp_tietb_d_corepacN.tci6630k2l.out
• Release file name: Examples\bin\cpt_sp_corepacN.tci6630k2l.out
• Release with ETB file name: Examples\bin\cpt_sp_tietb_corepacN.tci6630k2l.out

Note: Some projects include ETB and non-ETB Debug and Release versions (non-ETB version requires XDS560v2 System Trace)

66AK2Gxx

Note – All supported devices are enclosed inside the parentheses.

• CP Tracer (66AK2Gxx, D1030) - Examples\66AK2Gxx\CPT_L2_CorePac0
• Debug with ETB file name: Examples\bin\cpt_l2_tietb_d_corepac0.66ak2gxx.out
• Release with ETB file name: Examples\bin\cpt_l2_tietb_corepac0.66ak2gxx.out
• CP Tracer System Profile (66AK2Gxx, D1030) - Examples\C66AK2Gxx\CPT_SystemProfile_CorePacN
• Debug with ETB file name: Examples\bin\cpt_sp_tietb_d_corepacN.66ak2gxx.out
• Release with ETB file name: Examples\bin\cpt_sp_tietb_corepacN.66ak2gxx.out
• DSP Trace with ETB (66AK2Gxx, D1030) - Examples\66AK2Gxx\DSPTrace_TIETB_Ex_C66
• Debug file name: Examples\bin\dsptrace_tietb_d_corepacN.66ak2gxx.out
• Release file name: Examples\bin\dsptrace_tietb_corepacN.66ak2gxx.out
• ARM A15 PTM Trace with ETB (66AK2Gxx, D1030) - Examples\C66AK2Hxx\PTM_TIETB_Ex_A15
• Debug file name: Examples\bin\ptm_tietb_d_A15.66ak2gxx.out
• Release file name: Examples\bin\ptm_tietb_A15.66ak2gxx.out
• ARM A15 STM Trace with ETB (66AK2Gxx, D1030) - Examples\C66AK2Hxx\STM_TIETB_Ex_A15
• Debug file name: Examples\bin\stm_tietb_d_A15.66ak2gxx.out
• Release file name: Examples\bin\stm_tietb_A15.66ak2gxx.out
• DSP STM Trace with ETB (66AK2Gxx, D1030) - Examples\C66AK2Hxx\STM_TIETB_Ex_C66
• Debug file name: Examples\bin\stm_tietb_d_corepacN.66ak2gxx.out
• Release file name: Examples\bin\stm_tietb_corepacN.66ak2gxx.out
• DSP Trace with ETB and EDMA expansion -Examples\66AK2Gxx\DSPTrace_TIETB_EDMA_Ex_CorePacN
• Debug file name (little endian): Examples\bin\dsptrace_tietb-edma_d_corepacN.66ak2gxx.out
• Release file name (little endian): Examples\bin\dsptrace_tietb-edma_corepacN.66ak2gxx.out
• Debug file name (big endian): Examples\bin\dsptrace_tietb-edma_d_corepacN.66ak2gxxe.out
• Release file name (big endian): Examples\bin\dsptrace_tietb-edma_corepacN.66ak2gxxe.out
• STM Trace with ETB and EDMA expansion -Examples\66AK2Gxx\STM_TIETB_EDMA_Ex_CorePacN
• Debug file name (little endian): Examples\bin\stm_tietb-edma_d_corepacN.66ak2gxx.out
• Release file name (little endian): Examples\bin\stm_tietb-edma_corepacN.66ak2gxx.out
• ARM A15 PTM Trace with ETB and EDMA expansion - Examples\C66AK2Hxx\PTM_TIETB_EDMA_Ex_A15
• Debug file name: Examples\bin\ptm_tietb_edma_d_A15.66ak2gxx.out
• Release file name: Examples\bin\ptm_tietb_edma_A15.66ak2gxx.out
• M3 STM Trace with ETB (66AK2Gxx, D1030) - Examples\C66AK2Hxx\STM_TIETB_Ex_M3
• Debug file name: Examples\bin\stm_tietb_d_M3.66ak2gxx.out
• Release file name: Examples\bin\stm_tietb_M3.66ak2gxx.out

Note: All projects are ETB Debug and Release versions.

Note: All example project builds for 66AK2Gxx are compatible with D1030.

Note: Before running ARM PTM examples on 66AK2Gxx EVM, the ARM PLL initialization and switching ON ARM cores needs to be done. Please, follow the below steps to do the same:

o connect to the C66xx_0 core and run it’s startup gel

o Run the GEL script: Scripts --> TCI66x_Functions --> TETRIS_POWERUP_PLL_INIT_100MHZ_to_1000Mhz

C6A816x

• STM Trace (Cortex A8) - Examples\C6A816x\STM_Ex_A8
• Debug file name: Examples\bin\ stm_csetb_d_A8.c6a816x.out
• Release file name: Examples\bin\ stm_csetb_A8.c6a816x.out

OMAP44xx

• STM Trace (Cortex A9) - Examples\OMAP44xx\STM_Ex_A9
• Debug file name: Examples\bin\ stm_d_A9.omap44xx.out
• Release file name: Examples\bin\ stm_A9.omap44xx.out
• Debug_ETB name: Examples\bin\ stm_csetb_d_A9.omap44xx.out
• Release_ETB name: Examples\bin\ stm_csetb_A9.omap44xx.out
• STM Trace (Cortex M3) - Examples\OMAP44xx\STM_Ex_M3
• Debug file name: Examples\bin\ stm_d_M3.omap44xx.out
• Release file name: Examples\bin\ stm_M3.omap44xx.out
• PMI/CMI Trace (Cortex A9) - Examples\OMAP44xx\PMICMI_Ex_A9
• Debug file name: Examples\bin\ pmicmi_d_A9.omap44xx.out
• Release file name: Examples\bin\ pmicmi_A9.omap44xx.out
• Debug_ETB file name: Examples\bin\ pmicmi_csetb_d_A9.omap44xx.out
• Release_ETB file name: Examples\bin\ pmicmi_csetb_A9.omap44xx.out
• PMI/CMI Trace (Cortex A9) LINUX - Examples\OMAP44xx\PMICMI_LinuxApEx_A9
• Debug file name: Examples\OMAP44xx\PMICMI_LinuxApEx_A9\Debug\ pmicmi_d_A9.omap44xx.linux
• Release file name: Examples\OMAP44xx\PMICMI_LinuxApEx_A9\Release\ pmicmi_A9.omap44xx.linux
• Statistic Collector Trace (Cortex A9) - Examples\OMAP44xx\SCI_Ex_A9_omap4430
• Debug file name: Examples\bin\sci_d_A9.omap4430.out
• Release file name: Examples\bin\sci_A9.omap4430.out
• Statistic Collector Trace (Cortex A9) - Examples\OMAP44xx\SCI_Ex_A9_omap4460
• Debug file name: Examples\bin\sci_d_A9.omap4460.out
• Release file name: Examples\bin\sci_A9.omap4460.out

OMAP5430

• Statistic Collector Trace (Cortex A15) - Examples\OMAP5430\SCI_Ex_A15_omap5430
• Debug file name: Examples\bin\sci_d_A15.omap5430.out
• Release file name: Examples\bin\sci_A15.omap5430.out
• PMI/CMI Trace (Cortex A15) - Examples\OMAP54xx\PMICMI_Ex_A15
• Debug file name: Examples\bin\ pmicmi_d_A15.omap54xx.out
• Release file name: Examples\bin\ pmicmi_A15.omap54xx.out
• PTM Trace (Cortex A15) - Examples\OMAP54xx\PTM_TIETB_Ex_A15
• Debug file name: Examples\bin\ptm_tietb_d_A15.omap54xx.out
• Release file name: Examples\bin\ptm_tietb_A15.omap54xx.out
• STM Trace (Cortex A15) - Examples\OMAP54xx\STM_Ex_A15
• Debug file name: Examples\bin\ stm_d_A15.omap54xx.out
• Release file name: Examples\bin\ stm_A15.omap54xx.out
• Debug_ETB file name: Examples\bin\ stm_tietb_d_A15.omap54xx.out
• Release_ETB file name: Examples\bin\ stm_tietb_A15.omap54xx.out

DRA7xx

• DSP Trace (C66xx) - Examples\DRA7xx\DSPTrace_TIETB_Ex_CorePacN
• Debug file name: Examples\bin\dsptrace_tietb_d_corepacN.dra7xx.out
• Release file name: Examples\bin\dsptrace_tietb_corepacN.dra7xx.out
• PMI/CMI Trace (Cortex A15) - Examples\DRA7xx\PMICMI_Ex_A15
• Debug file name: Examples\bin\pmicmi_d_A15.dra7xx.out
• Release file name: Examples\bin\pmicmi_A15.dra7xx.out
• Debug_ETB file name: Examples\bin\pmicmi_tietb_d_A15.dra7xx.out
• Release_ETB file name: Examples\bin\pmicmi_tietb_A15.dra7xx.out
• PTM Trace (Cortex A15) - Examples\DRA7xx\PTM_TIETB_Ex_A15
• Debug file name: Examples\bin\ptm_tietb_d_A15.dra7xx.out
• Release file name: Examples\bin\ptm_tietb_A15.dra7xx.out
• Statistic Collector Trace (Cortex A15) - Examples\DRA7xx\SCI_Ex_A15_dra7xx
• Debug file name: Examples\bin\sci_d_A15.dra7xx.out
• Release file name: Examples\bin\sci_d_A15.dra7xx.out
• STM Trace (Cortex A15) - Examples\DRA7xx\STM_Ex_A15
• Debug file name: Examples\bin\stm_d_A15.dra7xx.out
• Release file name: Examples\bin\stm_A15.dra7xx.out
• Debug_ETB file name: Examples\bin\stm_tietb_d_A15.dra7xx.out
• Release_ETB file name: Examples\bin\stm_tietb_A15.dra7xx.out
• STM Trace (C66xx) - Examples\DRA7xx\STM_Ex_CorePacN
• Debug file name: Examples\bin\stm_d_corepacN.dra7xx.out
• Release file name: Examples\bin\stm_corepacN.dra7xx.out
• Debug_ETB file name: Examples\bin\stm_tietb_d_corepacN.dra7xx.out
• Release_ETB file name: Examples\bin\stm_tietb_corepacN.dra7xx.out

AM437x

• A9 Core Trace w/CS-ETB capture - Examples\AM437x\ETM_CSETB_Ex_A9
• Debug file name: Examples\bin\ etm_csetb_d_A9.am437x.out
• Release file name: Examples\bin\ etm_csetb_A9.am437x.out

• Statistic Collector Trace w/CS-ETB capture - Examples\AM437x\SCI_CSETB_Ex_A9
• Debug file name: Examples\bin\sci_csetb_d_A9.am437x.out
• Release file name: Examples\bin\sci_csetb_A9.am437x.out
• STM Trace w/CS-ETB capture - Examples\AM437x\STM_CSETB_Ex_A9
• Debug file name: Examples\bin\stm_csetb_d_A9.am437x.out
• Release file name: Examples\bin\stm_csetb_A9.am437x.out

TDA3x

• DSP Trace (C66x) - Examples\DRA7xx\DSPTrace_TIETB_Ex_CorePacN
• Debug file name: Examples\bin\dsptrace_tietb_d_corepacN.dra7xx.out
• Release file name: Examples\bin\dsptrace_tietb_corepacN.dra7xx.out
• Statistic Collector Trace (Cortex M4) - Examples\TDA3x\SCI_Ex_M4
• Debug file name: Examples\bin\sci_simple_ex_d_M4.tda3x.out
• Release file name: Examples\bin\ sci_simple_ex_M4.tda3x.out
• STM Trace (Cortex M4) - Examples\DRA7xx\STM_Ex_A15
• Debug file name: Examples\bin\stm_d_M4.tda3x.out
• Release file name: Examples\bin\ stm_M4.tda3x.out
• Debug_ETB file name: Examples\bin\stm_tietb_d_M4.tda3x.out
• Release_ETB file name: Examples\bin\stm_tietb_M4.tda3x.out
• STM Trace (C66) - Examples\DRA7xx\STM_Ex_C66x
• Debug file name: Examples\bin\stm_d_corepacN.tda3x.out
• Release file name: Examples\bin\ stm_corepacN.tda3x.out
• Debug_ETB file name: Examples\bin\stm_tietb_d_corepacN.tda3x.out
• Release_ETB file name: Examples\bin\stm_tietb_corepacN.tda3x.out

Note: Prior to running any example executable, use CCS to connect to M4_1 and run the Scripts->OnTargetConnect_API gel script if it is not executed automatically. Also, prior to running the Statistic Collector example run Script->TDA3xx MULTICORE Initialization->DSP1SSCLKEnable_API. Prior to running any DSP Example (STM or Trace) run the appropriate Script->TDA3xx MULTICORE Initialization->DSPnSSCLKEnable_API.

Prebuilt Example Apps

Examples\bin

Ctools_UCLib_Examples:

Examples showing the usage of Ctools_UCLib are posted as part of Ctools_UCLib_Examples.zip file (CCSv5 projects)

• Examples for the following Ctools use-cases are available:
• Device/UCLib_CPT_Event_Profile: New Request Event Capture
• Device/UCLib_CPT_Master_BW_Profile: Master Bandwidth Profiling
• Device/UCLib_CPT_System_BW_Profile: System Bandwidth Profiling
• Device/UCLib_CPT_System_Latency_Profile: System Latency Profiling
• Device/UCLib_CPT_Total_BW_Profile: Total Bandwidth Profiling
• Device/UCLib_MemWatch_AETINT: Using AETINT raise an exception on the first unintended access to a user defined memory address range
• Device/UCLib_MemWatch_PCTrace: Using store PC trace triggers, captures and displays a list of all unintended accessess to a user defined memory address range
• Device/UCLib_PCT_ETB_BackTrace_From_C66x_AppSWFault: Provides back tracing capability on the occurrence of a C66x AppSW fault (PC Trace - ETB drain via CPU during App SW fault)
• Device/UCLib_PCT_ETB_BackTrace_From_C66x_Exception: Provides back tracing capability on the occurrence of a C66x Exception (PC Trace - ETB drain via CPU during Exception)
• Device/UCLib_PCT_ETB_CPU_Drain: PC Trace - ETB drain via CPU (capture only 4 KB of PC trace)
• Device/UCLib_PCT_ETB_EDMA_Drain: PC Trace - ETB drain via EDMA (ETB extension to capture more than 4KB)
• Device/UCLib_StatProf_ETB_CPU_Drain: Statistical Profiling - ETB drain via CPU (capture only 4 KB of PC trace)
• Device/UCLib_StatProf_ETB_EDMA_Drain: Statistical Profiling - ETB drain via EDMA (ETB extension to capture more than 4KB)

• Supported Keystone Devices:
• C6670
• C6678
• C6657
• TCI6614
• C66AK2Hxx
• C66AK2Exx
• TCI6630K2L
• 66AK2Gxx

• For more information about Ctools use-cases, please refer to Ctools_UCLib doxygen at: Ctools_UCLib/doc/Ctools_UCLib.html/index.html

• Please Note:
• UCLib_MemWatch_AETINT and UCLib_PCT_ETB_BackTrace_From_C66x_Exception projects require SYSBIOS
• Some projects include ETB and non-ETB Debug and Release versions (non-ETB version requires XDS560v2 System Trace)

Instructions to convert and import binary trace data for CC Trace Display:

The BIN2TDF utility converts a binary trace file as exported from the embedded app to the CCS Trace Display readable format (TDF). A TDF file can be imported/loaded in the CCS Trace Display for decode and analysis.

BIN2TDF.exe can be found in the CCS_INSTALL/CCSv5/emulation/analysis/bin directory.

For more details on how to use BIN2TDF.exe see:

https://processors.wiki.ti.com/index.php/BIN2TDF

Examples command line parameters:

DSP Trace

bin2tdf -bin C:/temp/etbdata.bin -app C:/Examples/bin/dsptrace_csetb_d_core0.tci6488.out -procid 64x+ -sirev 3 -rcvr ETB -output C:/Examples/bin/mytrace.tdf -dcmfile C:/temp/dcm.txt'

Note that dcm.txt is an empty file unless you are using event trace.

STM Trace C667x, TCI6616, TCI6614, TCI6612

bin2tdf -bin C:/temp/etbdata.bin -app C66X_0=C:/Examples/bin/stm_d_corepacN.c6670.out -procid stm -sirev 1 -cpuname CSSTM_0 -rcvr ETB -devicekey 0x0009D02F -dcmfile C:/temp/dcm.txt -output C:/Examples/bin/mytrace.tdf

Note that C66x_0 is the name of the CPU running the app. 0x0009D02F is the device ID for C667x and TCI6616. 0x0B96202F is the device ID for TCI6614 and TCI6612. 0xB97A02F is the device id for C6657. ETB examples export etbdata bin and dcm file (using CIO for demonstration). Please see examples for specific bin and dcm filenames.

STM Trace C6A816x A8

bin2tdf -bin C:/temp/etbdata.bin -app CortexA8_0=C:/Examples/bin/stm_csetb_d_A8.c6a816x.out -procid stm -sirev 1 -cpuname CSSTM_0 -rcvr ETB -devicekey 0x0B81E02F -dcmfile C:/temp/dcm.txt -output C:/Examples/bin/mytrace.tdf'

Note that CortexA8_0 is the name of the CPU running the app. 0x0B81E02F is the device ID for C6A816x. etbdata.bin and dcm.txt files are exported by the example application (uses CIO for demonstration)

PTM Trace DRA7xx A15

bin2tdf -bin C:/temp/ETM_etbdata.bin -app C:/Examples/bin/ptm_tietb_A15.dra7xx.out -procid cortexa15 -rcvr ETB -devicekey 0x0B99002F -dcmfile C:/temp/ETM_etbdata.dcm -output C:/Examples/bin/mytrace.tdf

0x0B99002F is the device ID for DRA7xx. ETM_etbdata.bin and ETM_etbdata.dcm files are exported by the PTM Trace example application.

DSP Trace TDA3x C66x

bin2tdf -bin C:/temp/etbdata.bin -app C:\Examples\bin\dsptrace_tietb_d_corepacN.dra7xx.out -procid 66x -rcvr ETB -output C:\Examples\bin\dsptrace_tietb_d_corepac1.tda3x.tdf -dcmfile c:/temp/DSP_etbdata.dcm -cpuname C66XX_

0 -devicekey 0x0B9B202F

Note: If you collect DSP Trace data with TDA3x’s second DSP, change the –cpuname parameter to C66XX_1.

STM Trace TDA3x

bin2tdf -bin c:/temp/STM_etbdata.bin -app CortexM3_0=C:\Examples\bin\sci_simple_ex_d_M4.tda3x.out -procid stm -rcvr ETB -devicekey 0x0B9B202F -dcmfile c:\temp\STM_etbdata.dcm -output C:\Examples\bin\sci_simple_ex_d_M4_0.tda3x.tdf

bin2tdf -bin c:/temp/STM_etbdata.bin -app CortexM3_0=C:\Doug\Trace_STM\Examples\bin\sci_simple_ex_d_M4.tda3x.out -procid stm -rcvr ETB -devicekey 0x0B9B202F -dcmfile c:\temp\STM_etbdata.dcm -output C:\Examples\bin\sci_simple_ex_d_M4_0.tda3x.tdf

bin2tdf -bin c:/temp/STM_etbdata.bin -app C66XX_0=C:\Examples\bin\stm_tietb_d_corepacN.tda3x.out -procid stm -rcvr ETB -devicekey 0x0B9B202F -dcmfile c:\temp\STM_etbdata.dcm -output C:\Examples\bin\stm_tietb_d_corepac2.tda3x.tdf