| Embedded IDE Link™ CC | ![]() |
ccsboardinfo
boards = ccsboardinfo
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. |
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 ticcs 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 = ticcs('boardnum',boards(1).number,'procnum',...
boards(1).proc(2).name);
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.
Enter
ccsboardinfo
at the MATLAB® desktop 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 enter
boards = ccsboardinfo
MATLAB software 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 (the 3x1 array).
The dot notation is useful for accessing the contents of a structure when you create a link to CCS IDE. When you use ticcs to create your CCS link, you can use the dot notation to tell CCS IDE which processor you are targeting.
cc = ticcs('boardnum',boards(1).proc(1))
![]() | cast | cd | ![]() |
| © 1984-2008- The MathWorks, Inc. - Site Help - Patents - Trademarks - Privacy Policy - Preventing Piracy - RSS |
| © 1984-2008- The MathWorks, Inc. - Site Help - Patents - Trademarks - Privacy Policy - Preventing Piracy - RSS |