Documentation

slbuild

Build standalone executable or model reference target for model

Syntax

  • slbuild(model)
    example
  • slbuild(model,'StandaloneRTWTarget')
    example
  • slbuild(model,'StandaloneRTWTarget','ForceTopModelBuild',true)
    example
  • slbuild(model,'CleanTopModel')
  • slbuild(model,mdlreftarget)
  • slbuild(model,mdlreftarget,'UpdateThisModelReferenceTarget',buildcond)

Description

    Note:   Except where noted, this function requires a Simulink® Coder™ license.

example

slbuild(model) builds a standalone Simulink Coder target executable from model, using the current model configuration settings. If the model has not been loaded, slbuild loads it before initiating the build process.

example

slbuild(model,'StandaloneRTWTarget') builds a standalone Simulink Coder target executable from model (same as previous).

example

slbuild(model,'StandaloneRTWTarget','ForceTopModelBuild',true) allows you to additionally force regeneration of code for the top model of a system that includes referenced models. If ForceTopModelBuild is omitted or set to false, the build process determines whether to regenerate top model code based on model and model parameter changes.

slbuild(model,'CleanTopModel') cleans the model build area enough to trigger regeneration of the top model code at the next build.

    Note:   The following function calls for building the model reference target:

    • Honor the setting of the Rebuild parameter on the Model Referencing pane of the Configuration Parameters dialog box.

    • Require a Simulink Coder license only if you build a model reference Simulink Coder target, not if you build only a model reference simulation target.

slbuild(model,mdlreftarget) builds a model reference target, of the type specified by mdlreftarget, from model. The mdlreftarget argument must be one of the following:

  • 'ModelReferenceSimTarget' — Builds a model reference simulation target (does not require a Simulink Coder license)

  • 'ModelReferenceRTWTarget' — Builds a model reference Simulink Coder target and the corresponding model reference simulation target

  • 'ModelReferenceRTWTargetOnly' — Builds only a model reference Simulink Coder target

slbuild(model,mdlreftarget,'UpdateThisModelReferenceTarget',buildcond) allows you to specify a conditional rebuild option for the model reference target build when the Rebuild parameter on the Model Referencing pane of the Configuration Parameters dialog box is set to Never.

    Note:   The 'UpdateThisModelReferenceTarget' setting applies only to model, not to any models referenced by model.

The buildcond argument must be one of the following:

  • 'Force'

    Unconditionally rebuilds the model. This option is equivalent to the Always rebuild option on the Model Referencing pane of the Configuration Parameters dialog box.

  • 'IfOutOfDateOrStructuralChange'

    Rebuilds the model if the build process detects any changes. This option is equivalent to the If any changes detected rebuild option on the Model Referencing pane of the Configuration Parameters dialog box.

  • 'IfOutOfDate'

    Rebuilds the model if the build process detects any changes in known dependencies of this model. This option is equivalent to the If any changes in known dependencies detected rebuild option on the Model Referencing pane of the Configuration Parameters dialog box.

    Note:   You cannot use slbuild to build subsystems.

Examples

collapse all

Generate Code and Build Executable Image for Model

Generate C code for model rtwdemo_rtwintro.

slbuild('rtwdemo_rtwintro')

For the GRT target, the coder generates the following code files and places them in folders rtwdemo_rtwintro_grt_rtw and slprj/grt/_sharedutils.

Model FilesShared FilesInterface FilesOther Files
rtwdemo_rtwintro.c
rtwdemo_rtwintro.h
rtwdemo_rtwintro_private.h
rtwdemo_rtwintrotypes.h
rtwtypes.h
multiword_types.h
builtin_typeid_types.h
rtmodel.hnone

If the following model configuration parameters settings apply, the coder generates additional results.

Parameter SettingResults
Code Generation > Generate code only pane is clearedExecutable image rtwdemo_rtwintro.exe
Code Generation > Report > Create code generation report is selectedReport appears, providing information and links to generated code files, subsystem and code interface reports, entry-point functions, inports, outports, interface parameters, and data stores

Force Top Model Build

Generate code and build an executable image for rtwdemo_mdlreftop, which refers to model rtwdemo_mdlrefbot, regardless of model checksums and parameter settings.

slbuild('rtwdemo_mdlreftop','StandaloneRTWTarget','ForceTopModelBuild',true)

Clean Top Model Build

Clean the model build area enough to trigger regeneration of the top model code at the next build.

slbuild('rtwdemo_rtwintro','CleanTopModel')

Input Arguments

collapse all

model — Model for which to run the build processhandle | name

Model for which to build a standalone executable or model reference target, specified as a handle or a string representing the model name.

Example: gcs

mdlreftarget — Model reference target'ModelReferenceSimTarget' | 'ModelReferenceRTWTarget' | 'ModelReferenceRTWTargetOnly'

Model reference target to use for generating model code

Example: 'ModelReferenceSimTarget'

See Also

|

Introduced before R2006a

Was this topic helpful?