Introducing Links and Embedded Objects (MATLAB Link for Code Composer Studio Development Tools)

MATLAB Link for Code Composer Studio Development Tools

Constructing Link Objects

When you create a link to CCS IDE using the ccsdsp command, you are creating a "link to CCS IDE and RTDX Interface" object (called a link object for brevity from here on). The link object implementation relies on MATLAB object-oriented programming capabilities similar to the objects you find in the Filter Design and Control Systems Toolboxes.

The discussions in this section apply to the link objects in the MATLAB Link for Code Composer Studio. For a discussion of the embedded objects that are also part of this product, refer to About Objects for MATLAB Link Software. Since both object types use the MATLAB programming techniques, the information about working with the links, such as how you get or set properties, or use methods, apply equally to the link objects and the embedded objects. Only their constructors, properties, and methods are different.

Like other MATLAB structures, objects (also called links; we use the terms interchangeably here) in the MATLAB Link for Code Composer Studio Development Tools have predefined fields called object properties.

If you are new to objects, you might find the glossary section, Some Object-Oriented Programming Terms, helpful to explain the terms used in this User's Guide.

You specify object property values by either:

Specifying the property values when you create the object
Creating an object with default property values, and changing some or all of these property values later

For examples of setting link properties, refer to Setting Property Values with set.

Example-- Constructor for Links

The easiest way to create a link object is to use the function ccsdsp to create a link with the default properties. Create a link named cc to CCS IDE by typing

```
cc = ccsdsp
```

MATLAB responds with a list of the properties of the link cc you created along with the associated default property values.

CCSDSP Object:
  API version      : 1.0
  Processor type   : C67
  Processor name   : CPU
  Running?         : No
  Board number     : 0
  Processor number : 0
  Default timeout  : 10.00 secs

  RTDX channels    : 0

Inspecting the output reveals two objects listed--a CCS IDE object and an CCS IDE and RTDX objects cannot be created separately. By design they maintain a member class relationship; the RTDX object is a class, a member of the CCS object class. In this example, cc is an instance of the class CCS. If you type

```
rx = cc.rtdx
```

rx is a handle to the RTDX portion of the CCS object. As an alias, rx replaces cc.rtdx in functions such as readmat or writemsg that use the RTDX communications features of the CCS link. Typing rx at the command line now produces

```
rx

RTDX channels    : 0
```

The link properties are described in Tables of Link Software Functions, and in more detail in Link Properties. These properties are set to default values when you construct links.

Requirements for MATLAB Link for Code Composer Studio Properties and Property Values