symbol (MATLAB Link for Code Composer Studio Development Tools)

MATLAB Link for Code Composer Studio Development Tools

Return the most recent program symbol table from CCS IDE

Syntax

```
s = symbol(cc)
```

Description

s = symbol(cc) returns the symbol table for the program loaded in CCS IDE. symbol only applies after you load a target 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, the other is the symbol address and symbol page. For example, 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.

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.

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 target, the symbol table resides in CCS IDE. While CCS 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 target.

Examples

Demonstrating this function requires that you load a program file to your target. In this example, build and load theMATLAB Link for Code Composer Studio demo program c6701evmafxr. Start by entering c6701evmafxr at the MATLAB prompt.

```
c6701evmafxr;
```

Now set the simulation parameters for the model and build the model to your target. With the model loaded on your target, use symbol to return the entries stored in the symbol table in CCS IDE.

```
cc = ccsdsp;
s = symbol(cc);
```

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 lists the symbols from the symbol table in a column.

See Also
load, run

set visible