Übersichtstabelle über alle Konfigurationsparameter

Im Folgenden wird eine Übersicht aller Konfigurationsparameter gegeben. Die Konfigurationsparameter sind je nach gesetztem Konfigurationslevel im UI von Simulink® sichtbar oder unsichtbar. Sollten Sie den Modulgenerator über ein m-File konfigurieren, hat das Konfigurationslevel keinen Einfluss.

Zu jedem Parameter wird eine Kurzbeschreibung gegeben und in einigen Fällen für ausführlichere Informationen in weitere Abschnitte der Dokumentation verwiesen. Die Kategorisierung orientiert sich an der Darstellung im UI. Im UI wird der Displayname verwendet. Wenn Sie den Modulgenerator über ein m-File nutzen, ist die Spalte „Name“ entscheidend.

Category

Name

Displayname

Default

Description

TC General

Generate

Generate TwinCAT C++ Project

TRUE

Generate a TwinCAT C++ project. If unset, only code artifacts will be generated which can get used to generate C++ projects later.

 

FullPath

TwinCAT C++ Project Path

 

Full path to the generated VCXPROJ file (e. g. "C:\Temp\MyGeneratedProject.vcxproj")

 

LowestCompatibleTcBuild

Lowest compatible TwinCAT version (build number)

$<TwinCAT:Version:BUILD>

The lowest TwinCAT build number the generated C++ project and its modules and POUs are to be compatible with.

 

ClassFactoryName

Class factory name

$<Project:Name>

Name of the generated C++-Project, Name of the TcCOM classfactory and tmx-file name

 

ProductName

Product name

$<ModuleGenerator:ProductId> $<ModuleGenerator:Version:MAJOR.MINOR>

Product name, used e.g. for the module driver description and the module TMC description.

 

Copyright

Copyright notice

Copyright $<VendorName> $<LocalDateTime:%Y>

Copyright notice of the generated module driver file

 

Description

Driver description

TwinCAT executable file, generated by TwinCAT $<ModuleGenerator:ProductId>

Driver description

 

VendorName

Vendor name

TE140x Module Vendor

Module vendor name, used as the company name of the generated executables in the repository and the major module group as shown in the TwinCAT XAE module dialog.

 

VersionSrc

Version source file

$<LatestTMFile>

Path to an existing TMC, TML or XML file containing the previous version value.

 

IncrementVersion

Version part for increment

Revision

The part of the version number that is to be incremented.

 

DrvFileVersion

Driver file version

$<VersionFromFile>

Executable file version and library version.

 

DrvProductVersion

Driver product version

$<DrvFileVersion>

Product version

 

CodeGenPlaceholders

Code generation placeholders

 

Define custom placeholders

 

UseDataExchangeModules

Load DataExchangeModules

0

Manually set DataExchangeModule dependency (currently no need to set manually)

 

MaxVisibleArrayElements

Maximum number of visible array elements

200U

Specifies the maximum number of array elements to be displayed in the TwinCAT XAE. In the TwinCAT XAE, larger arrays cannot get expanded and linked to by its individual items

 

CreateUniqueEnumItemNames

Create unique item names for enumeration types

1

Create unique item names for enumeration types.

 

DataTypeTmcFiles

Data type import TMC files

 

TMC file(s) containing additional type definitions for code generation

TC Build

PreferToolArchitectureX64

Prefer X64 build tools

TRUE

Prefer X64 compiler and linker. Useful for complex source files, where X86 tools may run out of heap space.

 

Verbosity

Codegeneration and build verbosity

Normal

Verbosity level of code generation and build output messages. Silent and Detailed are other possible values.

 

Publish

Run the publish step after project generation

TRUE

Start the build procedure after code generation for all selected platforms. The generated module binaries and module descpription files will get copied to the "publish folder". Published modules are automatically located by the XAE and can get instantiated in all TwinCAT 3 projects. If unset, the module generation process will be stopped after code generation. To instantiate in a TwinCAT3 project, the generated C++ project needs to be inserted and built from.

 

PublishPlatformtoolset

Platform Toolset

Auto

Choose Platform Toolset to build binaries.

 

PublishConfiguration

Build configuration

Release

Build configuration to build binaries.

 

PublishTcRTx86

TwinCAT RT (x86)

TRUE

Publish binaries for platform 'TwinCAT RT (x86).'

 

PublishTcRTx64

TwinCAT RT (x64)

TRUE

Publish binaries for platform 'TwinCAT RT (x64).'

 

PublishTcOSx64

TwinCAT OS (x64)

TRUE

Publish binaries for platform 'TwinCAT OS (x64)' (e.g. TwinCAT/BSD)

 

ForceRebuildForPublish

Always rebuild all source files on publish

FALSE

Always rebuild all source files on publish

 

SignTwinCatCertName

Certificate name for TwinCAT signing

 

Certificate name for TwinCAT signing with OEM Certificate level 2.

 

TmxInstall

Install TMX

TRUE

Install all generated TwinCAT Objects on local XAE (fill local Engineering Repository).

 

TmxArchive

TMX Archive

 

Name of an optional archive containing all files required to use the generated TwinCAT Objects on another TwinCAT development system.

 

MsBuildPublishProperties

MsBuild publish properties

 

Set additional MsBuild publish properties.

 

MsBuildProjProperties

MsBuild project properties

 

Set additional MsBuild project properties.

 

PreCodeGenerationCallbackFcn

Pre code generation callback function

 

The defined MATLAB® function is called before code generation.

 

PostCodeGenerationCallbackFcn

Post code generation callback function

 

The defined MATLAB® function is called after code generation.

 

PostPublishCallbackFcn

Post publish callback function

 

The defined MATLAB® function is called after publish.

TC PLC library

LibCatPath

PLC library category description file

$<ProjectDir>\$<Name>.libcat.xml

Path to the PLC library category description file

 

LibraryCategories

PLC library categories

$<VendorName>

Define PLC library category hierarchy. Default only one hierarchy level = vendor. List separated with | possible: <MainCategory>|<SubCategory1>|…

 

GeneratePlcLibrary

Generate a PLC library

FALSE

Generate a PLC library with POUs. Define containing POUs with parameter TcComWrapperFb and PlcFb>General>Generate.

 

InstallPlcLibrary

Install the generated PLC library

FALSE

Install the generated PLC library for use in the local TwinCAT XAE/PLC.

 

PlcTypePrefixes

Type Prefixes

 

Define custom type prefixes

 

PlcVarPrefixes

Variable Prefixes

`PVOID=p \| BOOL=b \| BOOL32=b \| DATE=d \| TIME_OF_DATE=td \| TIME=t \| LTIME=t \| GUID=n`

Define custom variable prefixes.

TC License

OemId

ID of OEM

 

ID of OEM. Required for OEM Licence checks

 

OemLicenses

IDs of OEM Licenses

 

IDs of OEM Licenses. Multiple IDs may be inserted as a comma separated list. "{GUID},{GUID}"

TC TcCom General

Generate

Generate TcCOM Module (TwinCAT Module Class)

TRUE

Generate a TcCOM module class for the model.

 

OnlineChange

Online change support

FALSE

Allow to switch between different TcCOM module versions without switching TwinCAT runtime to config mode.

 

ModuleProperties

TMC Properties

 

Additional properties added to the module description in the TMC file: Name1=Value1|Name2=Value2|...

 

GroupName

GroupName

TE140x\|Simulink Modules

Minor module group name in the TwinCAT XAE module dialog

 

GroupDisplayName

GroupDisplayName

$<GroupName>

Minor module group description in the TwinCAT XAE module dialog

 

GroupIcon

GroupIcon

$<TE140x:Icon>

Optional module group icon in the TwinCAT XAE module dialog

 

ModuleIcon

ModuleIcon

$<TE140x:Icon>

Optional module icon in the TwinCAT XAE module dialog

 

InitExceptionHandling

Floating point exception handling during initialization

CallerExceptions

Configures how to throw, suppress or handle floating point exceptions during initialization.

 

UpdateExceptionHandling

Floating point exception handling during update

CallerExceptions

Configures how to throw, suppress or handle floating point exceptions during cyclic execution.

 

AdditionalIncludeFiles

Additional include files

 

Additional files required to be included after rtwtypes.h

TC TcCom License

OemLicenses

IDs of OEM License

$<Project:OemLicenses>

IDs of OEM Licenses. Multiple IDs may be inserted as a comma separated list. "{GUID},{GUID}"

TC TcCom Wrapper

TcComWrapperFb

TcCom Wrapper FB

FALSE

Generate a PLC Functionblock simplifying the interaction between a PLC and an instance of the generated TcCOM module

 

TcComWrapperFbProperties

TcCom Wrapper FB properties

FALSE

Generate properties for accessible data in the referenced TcCOM object

 

TcComWrapperFbPropertyMonitoring

TcCom Wrapper FB property monitoring

NoMonitoring

NoMonitoring: Online values of properties are not monitored in the PLC online view, CyclicUpdate: Update property values in the PLC online view cyclically, ExecutionUpdate: Update property values in the PLC online view when the property getter or setter is called

TC TcCom Additional settings

ModuleCaller

Default module caller

CyclicTask

CyclicTask: Call module via TwinCAT Task. Module: Cal module from another TwinCAT module (see e.g. TcCOM-Wrapper-FB).

 

CallerVerification

Verify caller

Default

Verify the caller context to prevent concurrent execution of the model code and corresponding DataArea mappings. Skip verification to reduce the execution time.

 

StepSizeAdaptation

Default StepSize adaptation mode

RequireMatchingTaskCycleTime

Configure how to handle differences between the default model step size(s) and the cycle time of the assigned task(s).

 

ExecutionSequence

Default execution sequence

UpdateBeforeOutputMapping

Configure the execution order of input mapping, model code execution and output mapping.

 

ExecuteModelCode

Execute model code after startup

TRUE

Start cyclic execution of the model code after startup by default. If FALSE, Module Parameter Execute needs to be set to TRUE to start execution of code.

 

BlockDiagramExport

Export BlockDiagram

TRUE

Export graphical block diagram information for monitoring and optional debugging on the generated TwinCAT module in TwinCAT XAE

 

ResolveMaskedSubsystems

Resolve Masked Subsystems

FALSE

Resolve masked subsystems in the block diagram

 

ExtendSignalResolution

Extended resolution of signals in block diagram

FALSE

Intensified search for assignments of variables and block diagram signals (blue signals). This option increases the build time.

 

BlockDiagramVariableAccess

Access to VariableGroup not referenced by any block

AssignToParent

Variables from a block within an unresolved subsystem are either assigned to the next higher visible block or hidden in the block diagram.

 

BlockDiagramDebugInfoExport

Export BlockDiagram debug info

TRUE

Export additional information required to debug the module using the block diagram.

TC TcCom Interfaces

ExecutionInfoOutput

Create ExecutionInfo output

FALSE

Create additional output DataAreas containing execution and exception information.

 

MonitorExecutionTime

Monitor execution time

FALSE

Calculate and expose the execution time of the module as an ADS variable for monitoring purposes.

 

InputDataAccess

Input: Data Access

Input Destination DataArea

Defines how the input variables are exposed in TwinCAT.

 

InputCreateSymbols

Input: Create ADS Symbols

TRUE

Create ADS symbol information for the input variables

 

InputInitValues

Input: Initial values

FALSE

Create module parameters for the input variables to allow definition of initial values

 

InputProperties

Input: TMC Properties

 

Additional properties added to the Input symbol description in the TMC file.

 

OutputDataAccess

Output: Data Access

Output Source DataArea

Defines how the output variables are exposed in TwinCAT.

 

OutputCreateSymbols

Output: Create ADS Symbols

TRUE

Create ADS symbol information for the output variables.

 

OutputProperties

Output: TMC Properties

 

Additional properties added to the Output symbol description in the TMC file.

 

ParametersDataAccess

Parameters: Data Access

Internal DataArea

Defines how the model parameter variables are exposed in TwinCAT

 

ParametersCreateSymbols

Parameters: Create ADS Symbols

TRUE

Create ADS symbol information for the model parameter variables.

 

ParametersInitValues

Parameters: Initial values

TRUE

Create module parameters for the model parameter variables to allow definition of initial values.

 

ParametersProperties

Parameters: TMC Properties

 

Additional properties added to the Parameters symbol description in the TMC file.

 

BlockIoDataAccess

BlockIO: Data Access

Internal DataArea

Defines how the BlockIO variables are exposed in TwinCAT

 

BlockIoCreateSymbols

BlockIO: Create ADS Symbols

TRUE

Create ADS symbol information for the BlockIO variables.

 

BlockIoProperties

BlockIO: TMC Properties

 

Additional properties added to the BlockIO symbol description in the TMC file.

 

ContStateDataAccess

ContState: Data Access

Internal DataArea

Defines how the continuous state variables are in TwinCAT

 

ContStateCreateSymbols

ContState: Create ADS Symbols

TRUE

Create ADS symbol information for the continuous state variables.

 

ContStateProperties

ContState: TMC Properties

 

Additional properties added to the ContState symbol description in the TMC file.

 

DWorkDataAccess

DWork: Data Access

Internal DataArea

Defines how the DWork variables are exposed in TwinCAT

 

DWorkCreateSymbols

DWork: Create ADS Symbols

TRUE

Create ADS symbol information for the DWork variables.

 

DWorkProperties

DWork: TMC Properties

 

Additional properties added to the DWork symbol description in the TMC file.

 

DataStoreDataAccess

DataStore: Data Access

None

Defines how the DataStore variables are exposed in TwinCAT

 

DataStoreCreateSymbols

DataStore: Create ADS Symbols

TRUE

Create ADS symbol information for the DataStore variables.

 

DataStoreReadOnly

DataStore: Read Only

FALSE

Restrict ADS access to be read only for the DataStore variables.

 

DataStoreProperties

DataStore: TMC Properties

 

Additional properties added to the DataStore symbol description in the TMC file.

 

SymbolProperties

Additional TMC Symbol Properties

 

Additional properties added to specific symbol descriptions in the TMC file.

 

VariableSymbolMapping

Mapping between variable names and ADS symbol names

Identical

Defines the TwinCAT symbol names for the generated C/C++ variables. 'Identical': Symbol name equals variable name, 'Classic': Use symbol names known from TE1400 Release 1.2.x.x

TC TcCom External Mode

ExtModeRtAllowExecutionCommands

Allow RealTime execution commands via External Mode

FALSE

Allow to start and stop model code execution via External Mode.

 

ExtModeRtWaitForStart

Wait for RealTime execution start command via External Mode

FALSE

Wait for External Mode connection before starting model code execution.

 

ExtModeRtAllowForParameterChange

Allow to change parameters via External Mode

FALSE

Allow to change parameter online values via External Mode.

TC PlcFb General

Generate

Generate TwinCAT PLC Function Block

TRUE

Generate a PLC-FB for the model.

 

InitExceptionHandling

Floating point exception handling during initialization

CallerExceptions

Configures how to throw, suppress, or handle floating point exceptions during initialization.

 

UpdateExceptionHandling

Floating point exception handling during update

CallerExceptions

Configures how to throw, suppress, or handle floating point exceptions during cyclic execution.

TC PlcFb License

OemLicenses

IDs of OEM License

$<Project:OemLicenses>

IDs of OEM Licenses. Multiple IDs may be inserted as a comma seperated list. "{GUID},{GUID}"

TC PlcFb Additional settings

MonitorExecutionTime

Monitor ExecutionTime

FALSE

Calculate and expose the execution times of TwinCAT modules as an ADS variable for monitoring purposes.

PlcFb->Interface

InputAttributes

Input variables: PLC Attributes

 

Additional attributes added to the PLC FB Input variables.

 

OutputAttributes

Output variables: PLC Attributes

 

Additional attributes added to the PLC FB Input variables.

TC PlcFb External Mode

ExtModeRtAllowExecutionCommands

Allow RealTime execution commands via External Mode

FALSE

Allow to start and stop model code execution via External Mode.

 

ExtModeRtWaitForStart

Wait for RealTime execution start command via External Mode

FALSE

Wait for External Mode connection before starting model code execution.

 

ExtModeRtAllowForParameterChange

Allow to change parameters via External Mode

FALSE

Allow to change parameter online values via External Mode.