Embedded IDE Link™ CC

Embedded IDE Link CC Pane

Embedded IDE Link CC Overview

Options on this pane configure the generated projects and code for Texas Instruments processors. They also enable PIL block generation and provide real-time task execution and stack use profiling.

Back to Top

Export IDE link handle to base workspace

Directs the software to export the ticcs object to your MATLAB workspace.

Settings

Default: On

On

Directs the build process to export the ticcs object created to your MATLAB workspace. The new object appears in the workspace browser. Selecting this option enables the IDE link handle name option.

Off

prevents the build process from exporting the ticcs object to your MATLAB software workspace.

Dependency

This parameter enables IDE link handle name.

Command-Line Information

Recommended Settings

See Also

For more information, refer to Embedded IDE Link CC Pane Parameters.

Back to Top

IDE link handle name

specifies the name of the ticcs object that the build process creates.

Settings

Default: CCS_Obj

• Enter any valid C variable name, without spaces.

• The name you use here appears in the MATLAB workspace browser to identify the ticcs object.

• The handle name is case sensitive.

Dependency

This parameter is enabled by Export IDE link handle to base workspace.

Command-Line Information

Recommended Settings

See Also

For more information, refer to Embedded IDE Link CC Pane Parameters.

Back to Top

Profile real-time execution

enables real-time execution profiling in the generated code by adding instrumentation for task functions or atomic subsystems.

Settings

Default: Off

On

Adds instrumentation to the generated code to support execution profiling and generate the profiling report.

Off

Does not instrument the generated code to produce the profile report.

Dependencies

This parameter adds Number of profiling samples to collect and Profile by.

Selecting this parameter disables Export ID link handle to base workspace.

Setting Build action to Archive_library or Create_processor_in_the_loop project removes this parameter.

Command-Line Information

Recommended Settings

See Also

For more information, refer to Embedded IDE Link CC Pane Parameters.

For more information about using profiling, refer to profile, and Real-Time Execution Profiling.

Back to Top

Profile by

Defines which execution profiling technique to use.

Settings

Default: Task

Task

Profiles model execution by the tasks in the model.

Atomic subsystem

Profiles model execution by the atomic subsystems in the model.

Dependencies

Selecting Real-time execution profiling enables this parameter.

Command-Line Information

Recommended Settings

See Also

For more information, refer to Embedded IDE Link CC Pane Parameters.

For more information about PIL, refer to Using Processor in the Loop.

For more information about enabling profiling, refer to profile, and Real-Time Execution Profiling

Back to Top

Number of profiling samples to collect

Specifies the number of profiling samples to collect. Collection stops when the buffer for profiling data is full.

Settings

Default: 100

Minimum: 1

Maximum: Buffer capacity in samples

Tips

• Collecting profiling data on a simulator may take a very long time.

• Data collection stops after collecting the specified number of samples. The application and processor continue to run.

Dependencies

This parameter is enabled by Profile real-time task execution.

Command-Line Information

Recommended Settings

See Also

For more information, refer to Embedded IDE Link CC Pane Parameters.

Back to Top

Inline run-time library functions

Marks run-time library functions generated by the Signal Processing Toolbox and Video and Image Processing Blockset™ block algorithms. These functions as marked with the inline keyword.

Settings

Default: On

On

Adds the keyword inline to each instance of an algorithm generated from blocks in the Signal Processing Blockset software and Video and Image Processing Blockset software.

Off

Does not mark the algorithms with the keyword.

Tips

The following list shows cases where inlining run-time library functions may not be appropriate:

• Few or no numerical parameters in the function

• One algorithm that is already fixed in capability, such as it has no optional modes or alternate algorithms

• Function supports only one data type

• Significant or large code size in the mdlOutputs() function

• Your models use multiple instances of this library function

Command-Line Information

Recommended Settings

See Also

For more information, refer to Embedded IDE Link CC Pane Parameters.

Back to Top

Project options

Sets the project options for building your project from the model.

Settings

Default: Custom

Custom

Applies a custom project configuration that provides a specialized combination of build and optimization settings.

The default settings are the same as the Release project configuration in CCS, except for the compiler and memory options. For the compiler options, Custom uses the Function(-o2) compiler setting. For memory configuration, Custom specifies the -ml1 memory model that uses near functions and data.

Debug

Applies the Debug project options defined by Code Composer Studio software to the generated project and code.

Release

Applies the Release project configuration defined by Code Composer Studio software to the generated project and code.

Dependencies

Selecting Custom disables the reset options for Compiler options string and Linker options string.

Command-Line Information

Recommended Settings

See Also

For more information, refer to Embedded IDE Link CC Pane Parameters.

Back to Top

Compiler options string

Lets you enter a string of compiler options to define your project configuration.

Settings

Default: No default

Tips

• To import compiler string options from the current project in CCS, click Get from IDE.

• To reset the compiler options to the default values, click Reset.

• Use spaces between options.

• Verify that the options are valid. The software does not validate the option string.

• Setting Project options to Custom applies -g as the default compiler options string.

• Setting Project options to Debug applies -g -d "_Debug" as the default compiler options string.

• Setting Project options to Release applies -o2 as the default compiler options string.

Command-Line Information

Recommended Settings

See Also

For more information, refer to Embedded IDE Link CC Pane Parameters.

Back to Top

Linker options string

Enables you to specify linker command options that determine how to link your project when you build your project.

Settings

Default: No default

Tips

• Use spaces between options.

• Verify that the options are valid. The software does not validate the options string.

• To import linker string options from the current project in CCS, click Get from IDE.

• To reset the linker command options to the default values, click Reset.

Dependencies

Setting Build action to Archive_library removes this parameter.

Command-Line Information

Recommended Settings

See Also

For more information, refer to Embedded IDE Link CC Pane Parameters.

Back to Top

System stack size (MAUs)

Allocates memory for the system stack on the processor.

Settings

Default: 8192

Minimum: 0

Maximum: Available memory

• Enter the stack size in minimum addressable units (MAUs)..

• The software does not verify that your size is valid. Be sure that you enter an acceptable value.

Dependencies

Setting Build action to Archive_library removes this parameter.

Command-Line Information

Recommended Settings

See Also

For more information, refer to Embedded IDE Link CC Pane Parameters.

Back to Top

Build action

Defines how Real-Time Workshop software responds when you press Ctrl+B to build your model.

Settings

Default: Build_and_execute

Build_and_execute

Builds your model, generates code from the model, and then compiles and links the code. After the software links your compiled code, the build process downloads and runs the executable on the processor.

Create_project

Directs Real-Time Workshop software to create a new project in the IDE.

Archive_library

Invokes the CCS Archiver to build and compile your project, but It does not run the linker to create an executable project. Instead, the result is a library project.

Build

Builds a project from your model. Compiles and links the code. Does not download and run the executable on the processor.

Create_processor_in_the_loop_project

Directs the Real-Time Workshop code generation process to create PIL algorithm object code as part of the project build.

Dependencies

Selecting Archive_library removes the following parameters:

• Interrupt overrun notification method

• Interrupt overrun notification function

• Profile real-time task execution

• Number of profiling samples to collect

• Linker options string

• Get from IDE

• Reset

• Export IDE link handle to base workspace

Selecting Create_processor_in_the_loop_project removes the following parameters:

• Interrupt overrun notification method

• Interrupt overrun notification function

• Profile real-time task execution

• Number of profiling samples to collect

• Linker options string

• Get from IDE

• Reset

• Export IDE link handle to base workspace with the option set to export the handle

Command-Line Information

Recommended Settings

See Also

For more information, refer to Embedded IDE Link CC Pane Parameters.

For more information about PIL, refer to Using Processor in the Loop.

Back to Top

Interrupt overrun notification method

Specifies how your program responds to overrun conditions during execution.

Settings

Default: None

None

Your program does not notify you when it encounters an overrun condition.

Print_message

Your program prints a message to standard output when it encounters an overrun condition.

Call_custom_function

When your program encounters an overrun condition, it executes a function that you specify in Interrupt overrun notification function.

Tips

• The definition of the standard output depends on your configuration.

• The custom function must exist in the current working directory.

Dependencies

Selecting Call_custom_function enables the Interrupt overrun notification function parameter.

Setting this parameter to Call_custom_function enables the Interrupt overrun notification function parameter.

Command-Line Information

Recommended Settings

See Also

For more information, refer to Embedded IDE Link CC Pane Parameters.

Back to Top

Interrupt overrun notification function

Specifies the name of a custom function your code runs when it encounters an overrun condition during execution.

Settings

No Default

Tips

Specify a function that exists in your current working directory.

Dependencies

This parameter is enabled by setting Interrupt overrun notification method to Call_custom_function.

Command-Line Information

Recommended Settings

See Also

For more information, refer to Embedded IDE Link CC Pane Parameters.

Back to Top

PIL block action

Specifies whether Real-Time Workshop software builds the PIL block and downloads the block to the processor

Settings

Default: Create_PIL_block_and_download

Create_PIL_block_build_and_download

Builds and downloads the PIL application to the processor after creating the PIL block. Adds PIL interface code that exchanges data with Simulink.

Create_PIL_block

Creates a PIL block, places the block in a new model, and then stops without building or downloading the block. The resulting project will not compile in the IDE.

None

Configures model to generate a CCS project that contains the PIL algorithm code. Does not build the PIL object code or block. The new project will not compile in the IDE.

Tips

• When you click Build on the PIL dialog box, the build process adds the PIL interface code to the project and compiles the project in the IDE.

• If you select Create PIL block, you can build manually from the block right-click context menu

• After you select Create PIL Block, copy the PIL block into your model to replace the original subsystem. Save the original subsystem in a different model so you can restore it in the future. Click Build to build your model with the PIL block in place.

• Add the PIL block to your model to use cosimulation to compare PIL results with the original subsystem results. Refer to the demo "Comparing Simulation and processor Implementation with Processor-in-the-Loop (PIL)" in the product demos Embedded IDE Link CC

• When you select None or Create_PIL_block, the generated project will not compile in the IDE. To use the PIL block in this project, click Build followed by Download in the PIL block dialog box.

Dependency

Enable this parameter by setting Build action to Create_processor_in_the_loop_project.

Command-Line Information

Recommended Settings

See Also

For more information, refer to Using Processor in the Loop.

Back to Top

Maximum time allowed to build project (s)

Specifies how long, in seconds, the software waits for the project build process to return a completion message.

Settings

Default: 1000

Minimum: 1

Maximum: No limit

Tips

• The build process continues even if MATLAB does not receive the completion message in the allotted time.

• This timeout value does not depend on the global timeout value in a ticcs object or the Maximum time to complete IDE operations timeout value.

Dependency

This parameter is disabled when you set Build action to Create_project.

Command-Line Information

Recommended Settings

See Also

For more information, refer to Embedded IDE Link CC Pane Parameters.

Back to Top

Maximum time to complete IDE operations (s)

specifies how long the software waits for IDE functions, such as read or write, to return completion messages.

Settings

Default: 10

Minimum: 1

Maximum: No limit

Tips

• The IDE operation continues even if MATLAB does not receive the message in the allotted time. Click here to see a list of the functions and methods.

• This timeout value does not depend on the global timeout value in a ticcs object or the Maximum time allowed to build project (s) timeout value

Command-Line Information

Recommended Settings

See Also

For more information, refer to Embedded IDE Link CC Pane Parameters.

Back to Top

Embedded IDE Link CC Configuration Parameters

Supported Hardware