symbol - Program symbol table from IDE

Syntax

IDEs

This function supports the following IDEs:

• Analog Devices VisualDSP++

• Green Hills MULTI

• Texas Instruments Code Composer Studio v3

Description

s = IDE_Obj.symbol returns the symbol table for the program loaded in the processor associated with the IDE handle object, IDE_Obj. The symbol method only applies after you load a processor program file. s is an array of structures where each row in s presents the symbol name and address in the table. Therefore, s has two columns; one is the symbol name, and the other is the symbol address and symbol page.

For CCS IDE, this table shows a few possible elements of s, and their interpretation.

s Structure Field	Contents of the Specified Field
s(1).name	String reflecting the symbol entry name.
s(1).address(1)	Address or value of symbol entry.
s(1).address(2)	Memory page for the symbol entry. For TI C6xxx processors, the page is 0.

For MULTI IDE, this table shows a few possible elements of s and their interpretation.

s Structure Field	Contents of the Specified Field
s(1).name	String reflecting the symbol entry name.
s(1).address	Address or value of symbol entry.
s(1).address	Address or value of symbol entry in hex.

You can use field address in s as the address input argument to read and write.

It you use symbol and the symbol table does not exist, s returns empty and you get a warning message.

Symbol tables are a portion of a COFF object file that contains information about the symbols that are defined and used by the file. When you load a program to the processor, the symbol table resides in the IDE. While the IDE may contain more than one symbol table at a time, symbol accesses the symbol table belonging to the program you last loaded on the processor.

Examples

Build and load a demo program on your processor. Then use symbol to return the entries stored in the symbol table in the processor.

s = IDE_Obj.symbol;

s contains all the symbols and their addresses, in a structure you can display with the following code:

for k=1:length(s),disp(k),disp(s(k)),end;

MATLAB software lists the symbols from the symbol table in a column.

See Also

load | run

© 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS