PDATS to Text Converter

From Texas Instruments Embedded Processors Wiki

PDATS to Text Converter

PDATS to Text Converter (pdats2text.exe) is a stand-alone utility that converts a compressed PDATS trace file into a text file. The pdats2text utility has to be invoked to get a textual representation of the trace file. Download the utility - pdats_to_txt

Usage

The PDATS trace is a binary format and hence need a script to convert it to the textual format. The pdats2text.exe utility available with the Code Compose Studio at <CCS installation path>bin\utilities\trace_pdats_64bit> helps you to convert the PDATS format to textual format. The pdats2text utility has the following mode of invocation

pdats2text.exe <pdats_file> <text_file>
pdats2text.exe -with_access_width <pdats_file> <text_file>

Output File Format

The address trace (compressed using the PDATS format) is generated in the same folder as the program file, with the extension .pdat. For example, if the program file is c:\test\mp3decoded.out, the address trace will be generated in the c:\test\mp3decoded.pdat file. The output text file is a simple, user readable ASCII format. The listing below shows a sample output:

#address:address_type(0=DATA_READ,1=DATA_WRITE,2=INSTR_FETCH):time_stamp
0x000015f4:2:21
0x000015f8:2:22
0x000015fc:2:23
0x00001600:2:24

The first line of the file is the header. This specifies the format in which the trace record is stored. Each record is stored in the following format: <address>:<address type>:<time stamp>

• <address> - Address to which the access occurred
• <address_type> - The type of address. It could be one of the following:
  • 0 – The access is a DATA READ
  • 1 – The access is a DATA WRITE
  • 2 – The access is an INSTRUCTION FETCH
• <time stamp>: The cycle at which the access occurred.

For more details on PDATS Converter and PDATS reader API refer the user guide - link.

Leave a Comment