Build Process Customization

Cross-compilation, post-code-generation processing, target build process customization

Customize the build process and the build process infrastructure for your application development environment and run-time requirements. Control the files and flags for compiling and linking your code.

Packages

target Manage target hardware and build tool information

Classes

expand all

Toolchain Definition – `target` API

`target.Toolchain`	Capture high-level information about toolchain
`target.CMake`	Specify CMake installation for building generated code
`target.CMakeBuildType`	Describe CMake build type or build configuration
`target.CMakeBuilder`	Configure how CMake builds generated code
`target.CMakeCacheEntry`	Configure a CMake cache entry
`target.EnvironmentConfiguration`	Configure system environment for toolchain
`target.HardwareComponentSupport`	Describe support for a hardware component

Objects

expand all

Build Information

RTW.BuildInfo Provide information for compiling and linking generated code

Functions

expand all

Add Flags, Defines, Files, and Paths to Build Information Objects

`addCompileFlags`	Add compiler options to build information
`addDefines`	Add preprocessor macro definitions to build information
`addIncludeFiles`	Add include files to build information
`addIncludePaths`	Add include paths to build information
`addLinkFlags`	Add link options to build information
`addLinkObjects`	Add link objects to build information
`addNonBuildFiles`	Add nonbuild-related files to build information
`addSourceFiles`	Add source files to build information
`addSourcePaths`	Add source paths to build information
`addTMFTokens`	Add template makefile (TMF) tokens to build information
`removeSourceFiles`	Remove source files from build information object

Find Arguments and Files in Build Information Objects

`findBuildArg`	Find a specific build argument in build information
`findIncludeFiles`	Find and add include (header) files to build information

Get Flags, Defines, Files, and Paths from Build Information Objects

`getBuildArgs`	Get build arguments from build information
`getCompileFlags`	Get compiler options from build information
`getDefines`	Get preprocessor macro definitions from build information
`getFullFileList`	Get list of files from build information
`getIncludeFiles`	Get include files from build information
`getIncludePaths`	Get include paths from build information
`getLinkFlags`	Get link options from build information
`getNonBuildFiles`	Get nonbuild-related files from build information
`getSourceFiles`	Get source files from build information
`getSourcePaths`	Get source paths from build information

Set Output Options in Build Information Objects

setTargetProvidesMain Disable inclusion of code generator provided (generated or static) main.c source file during build

Update File Paths, Extensions, and Separators in Build Information Objects

`updateFilePathsAndExtensions`	Update files in build information with missing paths and file extensions
`updateFileSeparator`	Update file separator character for file lists in build information

Configure Custom Target

`slConfigUIGetVal`	Return current value for any model configuration parameter
`slConfigUISetEnabled`	Enable or disable any model configuration parameter
`slConfigUISetVal`	Set value for any model configuration parameter

Build Generated Code

codebuild Compile and link generated code

Topics

Customize Build Process

Approaches for Building Code Generated from Simulink Models
Choose CMake, toolchain, or template makefile approach for building generated code.
Create Custom CMake Toolchain Definition
Capture high-level information about CMake-based toolchain and the target hardware it supports.
Template Makefiles and Make Options
Template makefiles that are built into the code generator.
Control Build Process Compiling and Linking
Select whether build process ends after code generation and (for template makefile approach) select template makefile options.
Control Compiler Optimizations
Control compiler optimizations for your makefile at the Simulink^® UI level.
Control Library Location and Naming During Build
Choose the location for precompiled, non-precompiled, and model reference libraries and select the file extension that the build process applies to libraries.
Control Regeneration of Top Model Code
Choose options for regenerating code for the top-level model.
Reduce Build Time for Referenced Models by Using Parallel Builds
Apply parallel builds to reduce build time for large model reference hierarchies.
Use makecfg to Customize Generated Makefiles for S-Functions
Configure makefile generation for the S-function build process.
Customize Post-Code-Generation Build Processing
Modify the build process with a post-code-generation command and (optionally) use build information objects to augment this process.
Relocate or Share Generated Code
Package and relocate generated code and artifacts to another development environment.
Compile Code in Another Development Environment
Relocate generated code and compile in another environment.

Customize Build Process Infrastructure

Register Custom Toolchain and Build Executable
Register and use a toolchain to build an executable program.
Customize Build Process with STF_make_rtw_hook File
Modify the build process with the build process hook mechanism in a custom STF_make_rtw_hook.m hook file.
Customize Build Process with sl_customization.m
Modify the build process with the build process hook mechanism in a custom sl_customization.m hook file.
Replace STF_rtw_info_hook Supplied Target Data
For custom targets created prior to MATLAB^® Release 14, update use of custom STF_make_rtw_hook hook for specifying target-specific characteristics.

Develop Custom Target

Custom Targets
Create software to deploy MATLAB and Simulink designs to hardware platforms.
Customize System Target Files
Develop a custom system target file to meet development goals and to control code generation.
Custom Target Optional Features
Add optional feature support to a custom system target file for compliance with code generation features, such as toolchain compliance and model reference compliance.
Support Toolchain Approach with Custom Target
Add toolchain approach support to a custom system target file for more user-interface controls of the build process.
Support C Function Prototype Control
Add C function prototype control support to a custom system target file for more build process control.
Support Model Referencing
Add model reference support to a custom system target file for model reference builds.
Support Compiler Optimization Level Control
Add compiler optimization level control support to a custom system target file for more build process control.
Support Concurrent Execution of Multiple Tasks
Add multitasking execution support to a custom system target file for multicore target models.
Device Drivers
Use device drivers as part of a real-time development project.

Build Process Customization

Packages

Classes

Toolchain Definition – target API

Objects

Build Information

Functions

Add Flags, Defines, Files, and Paths to Build Information Objects

Find Arguments and Files in Build Information Objects

Get Flags, Defines, Files, and Paths from Build Information Objects

Set Output Options in Build Information Objects

Update File Paths, Extensions, and Separators in Build Information Objects

Configure Custom Target

Build Generated Code

Topics

Customize Build Process

Customize Build Process Infrastructure

Develop Custom Target

Toolchain Definition – `target` API