MATLAB Link for Code Composer Studio Development Tools

Properties and Property Values

Links (or objects) in this MATLAB Link for Code Composer Studio have properties associated with them. Each property is assigned a value. You can set the values of most properties, either when you create the link or by changing the property value later. However, some properties have read-only values. And a few property values, such as the board number and the target processor to which the link attaches, become read-only after you create the object. You cannot change those after you create your link.

Setting and Retrieving Property Values

You can set MATLAB Link for Code Composer Studio for Texas Instruments DSP link property values either:

• Directly when you create the link
• By using the set function with an existing link

Retrieve CCS IDE link property values with the get function.

In addition, direct property referencing lets you either set or retrieve property values for links.

Setting Property Values Directly at Construction

To set property values directly when you construct a link, include the following pair of entries in the input argument list for the link construction function ccsdsp:

• A string for the property name to set followed by a comma. Enclose the string in single quotation marks as you do any string in MATLAB.
• The associated property value. Sometimes this value is also a string.

Include as many property names in the argument list for the object construction command as there are properties to set directly.

Example--Setting Link Property Values at Construction

Suppose you want to set the following link characteristics when you create a link to a DSP on a board in your computer:

• Link to the second DSP board installed on your computer.
• Connect to the first processor on the target board.
• Set the global timeout to 5 s. The default is 10 s.

Do this by typing

• cc = ccsdsp('boardname',1,'procnum',0,'timeout',5);
  

boardname, procnum, and timeout properties are described in Link Properties, as are the other properties for links.

Note    When you set link property values, the strings for property names and their values are not sensitive to the case of the string. In addition, you only need to type the shortest uniquely identifying string in each case. For example, you could have typed the above code as   cc = ccsdsp('board',1,'proc',0,'tim',5);

Constructing Link Objects

Setting Property Values with set