MATLAB Link for Code Composer Studio Development Tools

Introducing the Tutorial

To get you started using links for CCS IDE software, the MATLAB Link for Code Composer Studio includes an example script ccstutorial.m. As you follow along with this tutorial, you perform five tasks that step you through creating and using links for CCS IDE:

1. Select your target.
2. Create and query links to CCS IDE.
3. Use MATLAB to load files into CCS IDE.
4. Work with your CCS IDE project from MATLAB.
5. Close the links you opened to CCS IDE.

For this tutorial, you load and run a simple digital signal processing application on target processor you select. To help you understand how they work, the tutorial demonstrates both writing to memory and reading from memory in the Working with Links and Data portion of the tutorial.

Using the read and write functions gets a bit complicated. MATLAB supports only double-precision values for calculations, but you can read and write a range of data types to and from your target. Seeing how the read and write functions work can help you when you need to do your work.

The tutorial covers the link functions listed below. The functions listed first apply to CCS IDE independent of the links--you do not need a link to use these functions. The functions listed next require a CCS IDE link in place before you can use the function syntax:

• Global functions for CCS IDE
• ccsboardinfo--return information about the boards that CCS IDE recognizes as installed on your PC.
• boardprocsel--select the board to target. Although you can use this generally, the MATLAB Link for Code Composer Studio provides it as an example of a user interface you can build and as a tool in the tutorial. We do not recommend that you use this to select your target. Use ccsboardinfo and ccsdsp to specify the target for your processing application
• ccsdsp--construct a link to CCS IDE. When you construct the link you specify the target board and processor.
• clear--remove a specific link to CCS IDE or remove all existing links.
• CCS IDE link functions
• address--return the address and page for an entry in the symbol table in CCS IDE
• disp--display the properties of a link to CCS IDE and RTDX
• halt--terminate execution of a process running on the processor
• info--return information about the target processor or information about open RTDX channels
• isrunning--test whether the target processor is executing a process
• isrtdxcapable--test whether your target supports RTDX communications
• read--retrieve data from memory on the target processor
• restart--restore the program counter (PC) to the entry point for the current program
• run--execute the program loaded on the target processor
• visible--set whether CCS IDE window is visible on the desktop while CCS IDE is running
• write--write data to memory on the target processor
• MATLAB Link for Code Composer Studio functions for working with embedded objects
• cast--create a new object with a different datatype (the represent property) from an object in MATLAB Link for Code Composer Studio. Demonstrated with a numeric object.
• convert--change the represent property for an object from one datatype to another. Demonstrated with a numeric object.
• createobj--return an object in MATLAB that accesses embedded data. Demonstrated with structure, string, and numeric objects.
• getmember--return an object that accesses a single field from a structure. Demonstrated with a structure object.
• goto--position the program counter to the specified location in the project code.
• list--return various information listings from Code Composer Studio.
• read--read the information at the location accessed by an object into MATLAB as numeric values. Demonstrated with a numeric, string, structure, and enumerated objects.
• readnumeric--return the numeric equivalent of data at the location. accessed by an object. Demonstrated with an enumerated object.
• write--write to the location referenced by an object. Demonstrated with numeric, string, structure, and enumerated objects.

Running the Interactive Tutorial

You have the option of running this tutorial from the MATLAB command line or entering the functions as described in the following tutorial sections.

To run the tutorial in MATLAB, click run ccstutorial. Running the interactive tutorial in MATLAB puts you in an interactive mode where the tutorial program provides prompts and text descriptions to which you respond to move to the next portion of the lesson. The interactive tutorial covers the same information provided by the following tutorial sections. You can view the tutorial M-file used here by clicking ccstutorial.m.

Tutorial 2-1--Using Links and Embedded Objects

Selecting Your Target