MATLAB Link for Code Composer Studio Development Tools

build

Build the active project in CCS IDE

Syntax

• build(cc,timeout)
  build(cc)
  build(cc,'all',timeout)
  build(cc,'all')
  

Description

build(cc,timeout) incrementally rebuilds your active project in CCS IDE. In an incremental build:

• Files that you have changed since your last project build process get rebuilt or recomplied.
• Source files rebuild when the time stamp on the source file is later than the time stamp on the object file created by the last build.
• Files whose time stamps have not changed do not rebuild or recompile.

This incremental build is identical to the incremental build in CCS IDE, available from the CCS IDE toolbar.

After building the files, CCS IDE relinks the files to create the program file with the .out extension. To determine whether to relink the output file, CCS IDE compares the time stamp on the output file to the time stamp on each object file. It relinks the output when an object file time stamp is later than the output file time stamp.

To reduce the compile and build time, CCS IDE keeps a build information file for each project. CCS IDE uses this file to determine which file needs to be rebuilt or relinked during the incremental build. After each build, CCS IDE updates the build information file.

Note    CCS IDE opens a Save As dialog when the requested project build overwrites any files in the project. You must respond to the dialog before CCS IDE continues the build. The dialog may not be visible when it opens and CCS IDE, MATLAB, and other applications can appear to be frozen until you respond to the dialog. It may be hidden by open windows on your desktop.

To limit the time that build spends performing the build, the optional argument timeout stops the process after timeout seconds. timeout defines the number of seconds allowed to complete the required compile, build, and link operation. If the build process exceeds the timeout period, build returns an error in MATLAB. Generally, build causes the processor to initiate a restart even when the period specified by timeout passes. Exceeding the allotted time for the operation usually indicates that confirmation that the build was finished was not received before the timeout period passed. If you omit the timeout option in the syntax, build defaults to the global timeout defined in cc.

build(cc) is the same as build(cc,timeout) except that when you omit the timeout option, build defaults to the timeout set for cc.

build(cc,'all',timeout) completely rebuilds all of the files in the active project. This full build is identical to selecting Project->Rebuild All from the CCS menubar. After rebuilding all files in the project, build performs the link operation to create a new program file.

To limit the time that build spends performing the build, optional argument timeout stops the process after timeout seconds. timeout defines the number of seconds allowed to complete the required compile, build, and link operation.

If the build process exceeds the timeout period, build returns an error in MATLAB. Generally, build causes the processor to initiate a restart even when the period specified by timeout passes. Exceeding the allotted time for the operation usually indicates that confirmation that the build was finished was not received before the timeout period passed. If you omit the timeout option in the syntax, build defaults to the global timeout defined in cc.

build(cc,'all') is the same as build(cc,'all',timeout) except that when you omit the timeout option, build defaults to the timeout set for cc.

Examples

To demonstrate building a project from MATLAB, use CCS IDE to load a project from the TI tutorials. For this example, open the project file volume.pjt from the tutorial folder where you installed CCS IDE. (You can open any project you have for this example.)

Now use build to build the project.

• cc=ccsdsp
  
  CCSDSP Object:
    API version      : 1.2
    Processor type   : TMS320C64127
    Processor name   : CPU_1
    Running?         : No
    Board number     : 0
    Processor number : 0
    Default timeout  : 10.00 secs
  
    RTDX channels    : 0
  
  build(cc,'all',20)
  

You just completed a full build of the project in CCS IDE. On the Build pane in CCS IDE you see the record of the build process and the results. Now, make a change to a file in the project in CCS IDE and save the file. Then rebuild the project with an incremental build.

• build(cc,20)
  

When you look at the Build pane in CCS IDE, the log shows that the build only occurred on the file or files that you changed and saved.

See Also

activate, isrunning, open

assignreturnstorage

cast