ccsboardinfo (MATLAB Link for Code Composer Studio Development Tools)

MATLAB Link for Code Composer Studio Development Tools

Return information about all boards and simulators known to CCS IDE

Syntax

```
ccsboardinfo
boards = ccsboardinfo
```

Description

ccsboardinfo returns configuration information about each board and processor installed and recognized by CCS. When you issue the function, ccsboardinfo returns the following information about each board or simulator:

Installed Board Configuration Data
Configuration Item Name
Description

Board Number
boardnum
The number that CCS assigns to the board or simulator. Board numbering starts at 0 for the first board. This is also a property used when you create a new link to CCS IDE.

Board Name
boardname
The name assigned to the board or simulator. Usually, the name is the board model name, such as TMS320C67xx evaluation module. If you are using a simulator, the name tells you which processor the simulator matches, such as C67xx simulator. If you renamed the board during setup, your assigned name appears here.

Processor Number
procnum
The number assigned by CCS to the processor on the board or simulator. When the board contains more than one processor, CCS assigns a number to each processor, numbering from 0 for the first processor on the first board. For example, when you have two recognized boards, and the second has two processors, the first processor on the first board is procnum=0, and the first and second processors on the second board are procnum=1 and procnum=2. This is also a property used when you create a new link to CCS IDE.

Processor Name
procname
Provides the name of the processor. Usually the name is CPU, unless you assign a different name.

Processor Type
proctype
Gives the processor model, such as TMS320C6x1x for the C6xxx series processors.

Installed Board Configuration Data	Configuration Item Name	Description
Board Number	`boardnum`	The number that CCS assigns to the board or simulator. Board numbering starts at 0 for the first board. This is also a property used when you create a new link to CCS IDE.
Board Name	`boardname`	The name assigned to the board or simulator. Usually, the name is the board model name, such as TMS320C67xx evaluation module. If you are using a simulator, the name tells you which processor the simulator matches, such as C67xx simulator. If you renamed the board during setup, your assigned name appears here.
Processor Number	`procnum`	The number assigned by CCS to the processor on the board or simulator. When the board contains more than one processor, CCS assigns a number to each processor, numbering from 0 for the first processor on the first board. For example, when you have two recognized boards, and the second has two processors, the first processor on the first board is `procnum`=0, and the first and second processors on the second board are `procnum`=1 and `procnum`=2. This is also a property used when you create a new link to CCS IDE.
Processor Name	`procname`	Provides the name of the processor. Usually the name is CPU, unless you assign a different name.
Processor Type	proctype	Gives the processor model, such as TMS320C6x1x for the C6xxx series processors.

Each row in the table that you see displayed represents one digital signal processor, either on a board or simulator. As a consequence, you use the information in the table in the function ccsdsp to target a selected board in your PC.

boards = ccsboardinfo returns the configuration information about your installed boards in a slightly different manner. Rather than returning the table containing the information, you get a listing of the board names and numbers, where each board has an associated structure named proc that contains the information about each processor on the board. For example

```
boards = ccsboardinfo
```

returns

boards = 

      name: 'C6xxx Simulator (Texas Instruments)'
    number: 0
      proc: [1x1 struct]

where the structure proc contains the processor information for the C6xxx Simulator board:

boards.proc

ans = 

      name: 'CPU'
    number: 0
      type: 'TMS320C6200'

Reviewing the output from both function syntaxes shows that the configuration information is the same.

When you combine this syntax with the dot notation used to access the elements in a structure, the result is a way to determine which board to connect to when you construct a link to CCS IDE. For example, when you are creating a link to a board in your PC, the dot notation provides the means to set the target board by issuing the command with the boardnum and procnum properties set to the entries in the structure boards. For example, when you enter

```
boards = ccsboardinfo;
```

boards(1).name returns the name of your second installed board and boards(1).proc(2).name returns the name of the second processor on the second board. To create a link to the second processor on the second board, use

cc = ccsdsp('boardnum',boards(1).number,'procnum',...
boards(1).proc(2).name);

Examples

On a PC with both a simulator and a DSP Starter Kit (DSK) board installed,

```
ccsboardinfo
```

returns something similar to the following table. Your display may differ slightly based on what you called your boards when you configured them in CCS Setup Utility.

Board Board Proc Processor Processor

Num Name Num Name Type

--- ---------------------------------- --- ---------------------------------- ----

1 C6xxx Simulator (Texas Instrum ... 0 CPU TMS320C6200

0 DSK (Texas Instruments) 0 CPU_3 TMS320C6x1x

When you have one or more boards that have multiple CPUs, ccsboardinfo returns the following table, or one similar to it.

Board Board Proc Processor Processor

Num Name Num Name Type

--- ---------------------------------- --- ---------------------------------- ----

2 C6xxx Simulator (Texas Instrum ... 0 CPU TMS320C6200

1 C6xxx EVM (Texas Instrum ... 1 CPU_Primary TMS320C6200

1 C6xxx EVM (Texas Instrum ... 0 CPU_Secondary TMS320C6200

0 C64xx Simulator (Texas Instru... 0 CPU TMS320C64xx

In this example, board number 1 returns two defined CPUs: CPU_Primary and CPU_Secondary. Note that the C6xxx does not in fact have two CPUs; we defined a second CPU for this example.

To demonstrate the syntax boards = ccsboardinfo, this example assumes a PC with two boards installed, one of which has three CPUs.

Type

```
ccsboardinfo
```

at the MATLAB prompt. You get

Board Board Proc Processor Processor

Num Name Num Name Type

--- ---------------------------------- --- ---------------------------------- ----

1 C6xxx Simulator (Texas Instrum ... 0 CPU TMS320C6211

0 C6211 DSK (Texas Instruments) 2 CPU_3 TMS320C6x1x

0 C6211 DSK (Texas Instruments) 1 CPU_4_1 TMS320C6x1x

0 C6211 DSK (Texas Instruments) 0 CPU_4_2 TMS320C6x1x

Now type

```
boards = ccsboardinfo
```

MATLAB returns

boards=
2x1 struct array with fields
    name
    number
    proc

showing that you have two boards in your PC.

Use the dot notation to determine the names of the boards:

```
boards.name
```

returns

ans=
C6xxx Simulator (Texas Instruments)
ans=
C6211 DSK (Texas Instruments)

To identify the processors on each board, again use the dot notation to access the processor information. You have two boards (numbered 0 and 1). Board 0 has three CPUs defined for it. To determine the type of the second processor on board 0 (the board whose boardnum = 0), enter

```
boards(2).proc(1)
```

which returns

ans=
     name: 'CPU_3'
     number: 1
     type: 'TMS320C6x1x'

Recall that

```
boards(2).proc
```

gives you this information about the board:

ans=
3x1 struct array with fields:
    name
    number
    type

indicating that this board has three processors defined (the 3x1 array).

using the dot notation for accessing the contents of a structure has use when you create a link to CCS IDE. When you use ccsdsp to create your CCS link, you can use the dot notation to tell CCS IDE which processor you are targeting.

```
cc = ccsdsp('boardnum',boards(1).
```

See Also
info, ccsdsp

cast ccsdsp