MATLAB Link for Code Composer Studio Development Tools

open

Open a channel to a target processor or load a file into CCS IDE

Syntax

• open(rx,'channel1','mode1','channel2','mode2',...)
  open(rx,'channel','mode')
  open(cc,filename,filetype,timeout)
  open(cc,filename,filetype)
  open(cc,filename)
  

Description

open(rx,'channel1','mode1','channel2','mode2',...) opens new RTDX channels associated with the link rx. Each new channel uses the string name channel1, channel2, and so on. For each channel, open configures the channel according to the associated mode string. Channel1 uses mode1; channel2 uses mode2, and so forth. Mode strings are either:

• 'r' -- configure the channel to read data from the target processor.
• 'w' -- configure the channel for writing data to the target processor.

open(rx,channel,mode) opens a new channel to the processor associated with the link rx. The new channel uses the channel string and is configured for reading or writing according to the mode string.

open(cc,filename,filetype,timeout) loads filename into CCS IDE. filename can be the full path to the file or, if the file is in the current CCS IDE working directory, you can use a relative path, such as the name of the file. Use cd to determine or change the CCS IDE working directory. You use the filetype option to override the default file extension. Four filetype strings work in this function syntax.

filetype String	Extension	Description
'program'	.out	Executable programs for the target processor
'project'	.c, .a*, .s*, .o*, .lib, .cmd,.mak	CCS IDE project files
'text'	any	All text files
'workspace'	.wks	CCS IDE workspace files

To let you determine how long MATLAB waits for open to load the file into CCS IDE, timeout sets the upper limit, in seconds, for the period MATLAB waits for the load. If MATLAB waits more than timeout seconds, load returns immediately with a timeout error. REturning a timeout error does not suspend the operation; it stops MATLAB from waiting for confirmation for the operation completion.

open(cc,filename,filetype) loads filename into CCS IDE. filename can be the full path to the file or, if the file is in the current CCS IDE working directory, you can use a relative path, such as the name of the file. Use the cd function to determine or change your CCS IDE working directory. You use the filetype option to override the default file extension. Refer to the previous syntax for more information about filetype. When you omit the timeout option in this syntax, MATLAB uses the global timeout set in cc.

open(cc,filename) loads filename into CCS IDE. filename can be the full path to the file or, if the file is in the current CCS IDE working directory, you can use a relative path, such as the name of the file. Use the cd function to determine or change the CCS IDE working directory. You use the filetype option to override the default file extension. Refer to the previous syntax for more information about filetype. When you omit the filetype and timeout options in this syntax, MATLAB uses the global timeout set in cc, and derives the file type from the extension in filename. Refer to the previous syntax descriptions for more information on the input options.

Channels must be opened and enabled before you use them. You cannot write to or read from channels that you opened but did not enable.

Note    program files (.out extension) and project files (.mak extension) get loaded on the target processor referenced by your CCS IDE link. Workspace files are coupled to a specific target processor. As a result, open loads workspace files to the target processor that was active when you created the workspace file. This may not be the processor referred to by the CCS IDE link.

Examples

For RTDX use, open forms part of the function pair you use to open and enable a communications channel between MATLAB and your target processor.

• cc = ccsdsp;
  rx = cc.rtdx;
  open(rx,'ichannel','w');
  enable(rx,'ichannel');
  

When you are working with CCS IDE, open adopts a different operational form based on your input arguments for filename and the optional arguments filetype and timeout. In the CCS IDE variant, open loads the specified file into CCS IDE. For example, to load the tutorial program used in Tutorial 2-1--Using Links and Embedded Objects, use the following syntax

• cc = ccsdsp;
  cc.load(tutorial_6xevm.out);
  

See Also
cd, dir, load

new

profile