Embedded IDE Link™ CC

build - Build active project in CCS IDE

Syntax

build(cc,timeout) build(cc) build(cc,'all',timeout) build(cc,'all') [result,numwarns]=build(...)

Description

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

Files that you have changed because your last project build process get rebuilt or recompiled.
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 box when the requested project build overwrites any files in the project. You must respond to the dialog box before CCS IDE continues the build. The dialog box may not be visible when it opens and CCS IDE, MATLAB^® software, and other applications can appear to be frozen until you respond to the dialog box. 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 time-out period, build returns an error in MATLAB software. 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 time-out period passed. If you omit the timeout option in the syntax, build defaults to the global time-out defined in cc.

build(cc) is the same as build(cc,timeout) except that when you omit the timeout option, build defaults to the time-out for build, 1000 s. This time-out value overrides the default time-out setting 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 menu bar. 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 time-out period, build returns an error in MATLAB software. 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 time-out period passed. If you omit the timeout option in the syntax, build defaults to the global time-out 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 time-out set for build only, 1000 s.

[result,numwarns]=build(...) returns two output values that report the results of the build operation. For a successful build, the output arguments are the following:

result equal to 1 for the build
numwarns reports the number of build warnings that occurred during the build.

When the build is not successful, build displays an error and a message that contains the build string in the MATLAB software Command Window.

Examples

To demonstrate building a project from MATLAB software, use CCS IDE to load a project from the Texas Instruments™ software 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=ticcs

TICCS 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.

build - Build active project in CCS IDE

Syntax

Description

Examples

See Also