MATLAB Link for Code Composer Studio Development Tools

ccsdsp

Create a link to Code Composer Studio IDE

Syntax

• cc = ccsdsp
  cc = ccsdsp('propertyname','propertyvalue',...)
  

Description

cc = ccsdsp returns a handle (or object or link) in cc that MATLAB uses to communicate with the default processor. In the case of no input arguments, ccsdsp constructs the object with default values for all properties. CCS IDE handles the communications between MATLAB and the target CPU. When you use the function, ccsdsp launches CCS IDE if it is not running. If ccsdsp opened an instance of the CCS IDE when you issued the ccsdsp function, CCS IDE becomes invisible after the MATLAB Link for Code Composer Studio creates the new object.

Note    When ccsdsp creates the link cc, it sets the working directory for CCS IDE to be the same as your MATLAB working directory. This can have consequences when you create files or projects in CCS IDE, or save files and projects.

Each link to CCS IDE you create comprises two objects--a CCSDSP object and an RTDX object--that include the following properties:

Object	Property Name	Property	Default	Description
CCSDSP object	'apiversion'	API version	N/A	Defines the API version used to create the link.
	'proctype'	Processor Type	N/A	Specifies the kind of processor on the target board.
	'procname'	Processor Name	CPU	Name given to the processor on the board to which this object links.
	'status'	Running	No	Status of the program currently loaded on the processor
	'boardnum'	Board Number	0	Number that CCS assigns to the board. Used to identify the board.
	'procnum'	Processor number	0	Number the CCS assigns to a processor on a board.
	'timeout'	Default timeout	10.0s	Specifies how long MATLAB waits for a response from CCS after issuing a request.
RTDX Object	'timeout'	Timeout	10.0s	Specifies how long CCS waits for a response from the processor after requesting data.
	'numchannels'	Number of open channels	0	The number of open channels using this link.

cc = ccsdsp('propertyname','propertyvalue',...) returns a handle in cc that MATLAB uses to communicate with the specified processor. CCS handles the communications between MATLAB and the target CPU.

MATLAB treats input parameters to ccsdsp as property definitions. Each property definition consists of a property name/property value pair.

Two properties of the ccsdsp handle are read-only after you create the handle

• 'boardnum' -- the identifier for the installed board selected from the active boards recognized by CCS. If you have one board, use the default property value 0 to access the board.
• 'procnum' -- the identifier for the processor on the board defined by boardnum. On boards with more than one processor, use this value to specify the target processor on the board. On boards with one processor, use the default property value 0 to specify the processor.

You do not need to specify the boardnum and procnum properties when you have one board with one processor installed. The default property values refer to the processor on the board.

Note    Simulators count as boards. If you defined both boards and simulators in CCS IDE, specify the boardnum and procnum properties to connect to specific boards or simulators. Use ccsboardinfo to determine the values for the boardnum and procnum properties of your boards and simulators.

Because these properties are read-only after you create the handle, you must set these property values as input arguments when you use ccsdsp. You cannot change these values after the handle exists. After you create the handle, use the get function to retrieve the boardnum and procnum property values.

Examples

On a system with three boards, where the third board has one processor and the first and second boards have two processors each, the function

• cc = ccsdsp('boardnum',1,'procnum',0);
  

returns a handle to the first processor on the second board. Similarly, the function

• cc = ccsdsp('boardnum',0,'procnum',1);
  

returns a handle to the second processor on the first board.

To access the processor on the third board, use

• cc = ccsdsp('boardnum',2);
  

which sets the default property value procnum=0 to connect to the processor on the third board.

See Also
get, ccsboardinfo, set

ccsboardinfo

cd