Code Compilation Customization

Customize compilation stage of build process

If you install supported build tools, you can configure a build process that produces executable code after code generation. You can customize the compilation stage of the build process.

For the toolchain approach:

Using the target package, create custom CMake toolchain definitions.
Using a ToolchainInfo object, register and use a custom toolchain.

For the template makefile approach:

Customize a shipped template makefile.
Create and run a post-code-generation command.
Create and apply hook methods at specific points of the build process.
Customize generated makefiles for S-functions.

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

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 for 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

Build Generated Code

codebuild Compile and link generated code

Topics

Compiler

Select and Configure C or C++ Compiler
Consider programming language compliance for generated code and select a compiler for the build process.
Control Compiler Optimizations
Control compiler optimizations for your makefile at the Simulink^® UI level.
Troubleshoot Compiler Issues
Identify and fix issues that prevent compiler operation in the build process.
Control Build Process Compiling and Linking
Select whether build process ends after code generation and (for template makefile approach) select template makefile options.

Library Names and Locations

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.

CMake Toolchain Approach

Create Custom CMake Toolchain Definition
Capture high-level information about CMake-based toolchain and the target hardware it supports.

`ToolchainInfo` Approach

Custom Toolchain Registration
Register third-party software build tools for creating executables and libraries.
Register Custom Toolchain and Build Executable
Register and use a toolchain to build an executable program.
Troubleshooting Custom Toolchain Validation
Troubleshoot validation errors.

Template Makefile Approach

Template Makefiles and Make Options
Template makefiles that are built into the code generator.
Customize Template Makefiles
Develop a custom template makefile to control the 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.
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.
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.
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.

S-Function Build

Use makecfg to Customize Generated Makefiles for S-Functions
Configure makefile generation for the S-function build process.

Code Compilation 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 for Build Information Objects

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

Build Generated Code

Topics

Compiler

Library Names and Locations

CMake Toolchain Approach

ToolchainInfo Approach

Template Makefile Approach

S-Function Build

Toolchain Definition – `target` API

`ToolchainInfo` Approach