Main Content

Source files

Custom name for source files

Model Configuration Pane: Code Generation / Code Placement

Description

Specify customized name for generated source files.

Dependencies

This parameter:

  • Appears only for ERT-based targets.

  • Requires Embedded Coder® when generating code.

Settings

$R$E (default) | macro text

Default: $R$E

Enter a macro that specifies whether, and in what order, certain text is to be included in the generated identifier. The macro can include a combination of custom user text and these format tokens:

TokenDescription
$E

Insert the file type. $E represents these instances of file types:

  • capi

  • capi_host

  • dt

  • testinterface

  • private

  • types

Required. In files of other types, $E does not generate text.

$R

Insert root model name into identifier, replacing unsupported characters with the underscore (_) character.

Required for model referencing.

$U

Insert text that you specify for the $U token. To specify this text, use the Custom token text parameter.

In the generated file name, adjacent tokens are separated by the underscore (_) character, even if a token does not generate text.

Custom naming is supported only for .c and .cpp files. When you have model hierarchy, custom naming is applicable to only the root model.

Recommended Settings

ApplicationSetting
DebuggingNo impact
TraceabilityUse default
EfficiencyNo impact
Safety precautionNo recommendation

Programmatic Use

Parameter: ERTSourceFileRootName
Type: character vector
Value: Valid combination of tokens and custom text
Default: $R$E

Version History

Introduced in R2018a