概述

本节介绍系统目标文件的结构和内容。下面的清单显示了系统目标文件的一般结构。注意，这不是系统目标文件的完整代码清单。该清单由组成系统目标文件的每个部分的摘录组成。

%%---------------------------- %% 头评论部分  %%---------------------------- %% 实时目标% % TMF SYSTLC:例子:my_target。初始注释包含用于STF浏览器的指令。%%文档、日期、版权和其他信息可以在. ...后面找到%选择文件NULL_FILE…%%---------------------------- %% 薄层色谱配置变量部分  %%---------------------------- %% 分配代码格式,语言,目标类型。% % %分配CodeFormat = " Embedded-C " %分配TargetType =“RT”%分配语言= " C " %% %%---------------------------- %% 薄层色谱程序入口点  %%---------------------------- %% 调用入口点函数。%包括“codegenentry.tlc”%% %%---------------------------- %% (OPTIONAL) Generate Files for Build Process %%---------------------------- %include "mytarget_genfiles.tlc" %%---------------------------- %% RTW_OPTIONS Section %%---------------------------- /% BEGIN_RTW_OPTIONS %% Define rtwoptions structure array. This array defines target-specific %% code generation variables, and controls how they are displayed. rtwoptions(1).prompt = 'example code generation options'; ... rtwoptions(6).prompt = 'Show eliminated blocks'; rtwoptions(6).type = 'Checkbox'; ... %----------------------------------------% % Configure RTW code generation settings % %----------------------------------------% ... %%---------------------------- %% rtwgensettings Structure %%---------------------------- %% Define suffix text for naming build folder here. rtwgensettings.BuildDirSuffix = '_mytarget_rtw' %% Callback compatibility declaration rtwgensettings.Version = '1'; %% (OPTIONAL) target inheritance declaration rtwgensettings.DerivedFrom = 'ert.tlc'; %% (OPTIONAL) other rtwGenSettings fields... ... END_RTW_OPTIONS %/ %%---------------------------- %% targetComponentClass - MATHWORKS INTERNAL USE ONLY %% REMOVE NEXT SECTION FROM USER_DEFINED CUSTOM TARGETS %%---------------------------- /% BEGIN_CONFIGSET_TARGET_COMPONENT targetComponentClass = 'Simulink.ERTTargetCC'; END_CONFIGSET_TARGET_COMPONENT %/

如果您正在基于现有系统目标文件创建自定义目标，则必须删除targetComponentClass节(由指令限定)BEGIN_CONFIGSET_TARGET_COMPONENT和END_CONFIGSET_TARGET_COMPONENT）.本节保留给MathWorks内部开发的目标使用。

头的评论

文件开头的这些行被格式化为TLC注释。它们向系统目标文件浏览器和构建过程提供所需的信息。注意，必须将浏览器注释放在文件的头部，在其他注释或TLC语句之前。

注释的存在使代码生成器能够检测系统目标文件。当打开System Target File Browser时，代码生成器会扫描MATLAB路径中带有格式化头注释的TLC文件。注释包含以下指令:

下面的标题注释来自matlabroot/ rtw / c / ert /ert.tlc．

%% SYSTLC:嵌入式编码器TMF: ert_default_tmf MAKE: make_rtw %% SYSTLC:为嵌入式编码器创建可视化C/ c++解决方案文件%% TMF: RTW。MAKE: make_rtw…

每个注释最多只能包含两行。

如果没有指定TMF字段中的系统目标文件，该文件仍然有效。的值TemplateMakefile参数指定的回调函数rtwgensettings。SelectCallback．

指定的回调函数也可以使用rtwgensettings。SelectCallback要更改外部模式参数的值，请使用ExtMode，ExtModeTransport，ExtModeMexFile,或ExtModeIntrfLevel．

你可以在头文件注释中指定多组指令。每个这样的组在System target File Browser中显示为不同的目标配置。在上面的示例中，前两行代码指定了ERT目标的默认配置。接下来的两行指定创建和构建一个微软^®Visual c++^®解决方案(. sln)文件。下图显示了这些配置如何出现在系统目标文件浏览器中。

看到创建自定义目标器配置查看自定义头注释的示例。

TLC配置变量

系统目标文件的这一部分分配与整个代码生成过程相关的全局TLC变量。

对于嵌入式目标，在大多数情况下，您应该简单地使用ERT目标使用的全局TLC变量设置(ert.tlc）.特别重要的是，您的系统目标文件使用“Embedded-C”的值CodeFormat并使用相应的TLC变量rtwgensettings。本文建立= 'ert.tlc'在RTW_OPTIONSTLC文件的部分。验证值是否分配给以下变量:

TLC程序入口点和相关%包括

代码生成过程通常以codegenentry.tlc．系统目标文件调用codegenentry.tlc如下。

%包括“codegenentry.tlc”

如果需要实现特定于目标的代码生成特性，则应该包含TLC文件mytarget_genfiles.tlc在系统目标文件中。该文件提供了一种机制，用于在调用之前和之后执行自定义TLC代码codegenentry.tlc．有关此机制的信息，请参见

自定义代码生成过程的另一种方法是调用较低级别的函数(通常由codegenentry.tlc)，并在流程的每个阶段包含您自己的TLC功能。这种做法应该谨慎对待。看到薄层色谱文件了解更多信息。

调用的低级函数codegenentry.tlc是

RTW_OPTIONS节

的RTW_OPTIONSSection由以下指令限定:

/% begin_rtw_options…END_RTW_OPTIONS % /

第一部分RTW_OPTIONS节定义了一个数组rtwoptions结构。这个结构在使用rtwoptions显示自定义目标选项．

第二部分RTW_OPTIONS部分定义rtwgensettings，为代码生成过程定义生成文件夹名称和其他设置的结构。看到rtwgensettings结构欲知有关rtwgensettings．

rtwgensettings结构

系统目标文件的最后一部分定义了rtwgensettings结构。对象中写入的信息模型.rtw文件并由构建过程使用。的rtwgensettings目标开发人员最感兴趣的领域是

其他代码生成选项

使用TLC配置生成代码描述了额外的TLC代码生成变量。目标的最终用户可以通过输入窗体的MATLAB命令来分配这些变量

set_param (modelName TLCOptions, -aVariable =瓦尔”);

(有关更多信息，请参见为代码生成指定TLC．）

然而，首选的方法是在系统目标文件中使用下面的语句来分配这些变量:

%assign变量=瓦尔

为了便于阅读，我们建议您在系统目标文件的注释之后的部分中添加这样的赋值配置RTW代码生成设置．

模型参考注意事项

看到金宝app支持模型参考有关系统目标文件的重要信息，以及为支持代码生成器模型引用特性可能需要进行的其他修改。金宝app

使用rtwoptions显示自定义目标选项

控件中显示的选项代码生成窗格中的配置参数rtwoptions结构在系统目标文件中。

田野里的rtwoptions结构定义变量和相关的用户界面元素，以显示在配置参数对话框中。使用rtwoptions，则可以定义在对话框中显示的特定于目标的选项，并将选项组织到类别中。您还可以编写回调函数来指定如何处理这些选项。

当代码生成窗格打开时，rtwoptions扫描结构数组并显示列出的选项。每个选项都由指定的用户界面元素(复选框、编辑字段、菜单或按钮)表示，该元素显示当前选项值。

用户界面元素可以处于启用或禁用(显示为暗化)状态。如果某个选项已启用，用户可以更改该选项的值。如果某个选项被禁用，则该选项使用默认值，用户无法更改该选项的值。

你也可以用rtwoptions结构数组来定义特殊的NonUI元素，这些元素会导致回调函数被执行，但不会显示在代码生成窗格。看到NonUI元素．

的元素rtwoptions结构数组被组织成组。每一组项都以类型的标题元素开始类别．的默认字段类别头必须包含类别中剩余元素的计数。

的类别标头后面跟着要显示在代码生成窗格。每个类别的标题后面跟着一个或多个选项定义元素。

每一类目标选项对应于下面列出的选项代码生成在“配置参数”对话框中。

表rtwoptions结构字段汇总总结了的字段rtwoptions结构。

使用实例rtwoptions结构。以下rtwoptions结构摘自示例系统目标文件，matlabroot/工具箱/ rtw / rtwdemos / rtwoptions_demo /usertarget.tlc．代码定义了rtwoptions结构数组。第一个(头部)元素的默认字段设置为4，指示标头后面的元素数。

rtwoptions(1)。提示= 'userPreferred target options (I)'; rtwoptions(1).type = 'Category'; rtwoptions(1).enable = 'on'; rtwoptions(1).default = 4; % number of items under this category % excluding this one. rtwoptions(1).popupstrings = ''; % At the first item, user has to rtwoptions(1).tlcvariable = ''; % initialize all supported fields rtwoptions(1).tooltip = ''; rtwoptions(1).callback = ''; rtwoptions(1).makevariable = ''; rtwoptions(2).prompt = 'Execution Mode'; rtwoptions(2).type = 'Popup'; rtwoptions(2).default = 'Real-Time'; rtwoptions(2).popupstrings = 'Real-Time|UserDefined'; rtwoptions(2).tlcvariable = 'tlcvariable1'; rtwoptions(2).tooltip = ['See this text as tooltip']; rtwoptions(3).prompt = 'Log Execution Time'; rtwoptions(3).type = 'Checkbox'; rtwoptions(3).default = 'on'; rtwoptions(3).tlcvariable = 'RL32LogTETModifier'; rtwoptions(3).tooltip = ['']; % no tooltip rtwoptions(4).prompt = 'Real-Time Interrupt Source'; rtwoptions(4).type = 'Popup'; rtwoptions(4).default = 'Timer'; rtwoptions(4).popupstrings = 'Timer|5|6|7|8|9|10|11|12|13|14|15'; rtwoptions(4).tlcvariable = 'tlcvariable3'; rtwoptions(4).callback = 'usertargetcallback(hDlg, hSrc, ''tlcvariable3'')'; rtwoptions(4).tooltip = ['']; rtwoptions(4).tooltip = ['See TLC file for how to use reserved '... ' keyword ''hDlg'', and ''hSrc''.']; ... rtwoptions(5).prompt = 'Signal Logging Buffer Size in Doubles'; rtwoptions(5).type = 'Edit'; rtwoptions(5).default = '100000'; rtwoptions(5).tlcvariable = 'tlcvariable2'; rtwoptions(5).tooltip = [''];

第一个元素加a用户首选目标选项(I)窗格下代码生成在“配置参数”对话框中。中定义的选项rtwoptions (2)，rtwoptions (3)，rtwoptions (4),rtwoptions (5)．

如果您想定义大量的选项，您可以定义多个类别组在单个系统目标文件中。

注意rtwoptions结构和回调是用MATLAB代码编写的，尽管它们嵌入在TLC文件中。的语法rtwoptions结构定义和代码，您可以通过将它们复制并粘贴到MATLAB命令窗口来执行MATLAB提示符下的命令。

要了解更多关于usertarget.tlc和它一起提供的示例回调文件，请参见带有自定义rtwoptions的系统目标文件示例．有关特定于目标的更多示例rtwoptions定义，请参见目标.tlc下的文件matlabroot/ rtw / c（开放）.

rtwoptions结构字段汇总控件的字段列表rtwoptions结构。

“rt_ | _rt |没有的

NonUI元素。的要素rtwoptions具有类型的数组NonUI仅为调用回调而存在。一个NonUI元素在“配置参数”对话框中没有显示。你可以使用NonUI元素(如果要在对话框打开或关闭时执行与用户界面元素不关联的回调)。参见下一节，带有自定义rtwoptions的系统目标文件示例举个例子。

带有自定义rtwoptions的系统目标文件示例

一个工作系统目标文件，带有MATLAB文件回调函数，已经提供了如何使用的例子rtwoptions控件上显示和处理自定义选项代码生成窗格。这些示例与回调API兼容。

示例目标文件位于文件夹(开放)：

matlabroot/工具箱/ rtw / rtwdemos / rtwoptions_demo

示例目标文件包括:

阅读本节时请参考示例文件。示例系统目标文件，usertarget.tlc举例说明…的用法rtwoptions显示以下自定义目标器选项:

尝试在与“配置参数”对话框中的示例目标选项交互时学习示例代码。要与示例目标文件交互，

继承目标选项

ert.tlc提供了一套基本的嵌入式编码器^®代码生成选项。如果你的目标是基于ert.tlc，您的系统目标文件通常应该继承在ERT中定义的选项。

使用rtwgensettings。本文建立字段中rtwgensettings结构来定义要从中继承选项的系统目标文件。您应该将自定义目标转换为使用这种机制，如下所示。

设置rtwgensettings。本文建立字段值，如下例所示:

rtwgensettings。本文建立= 'stf.tlc';

在哪里月31要从中继承选项的系统目标文件的名称。例如:

rtwgensettings。本文建立= 'ert.tlc';

当“配置参数”对话框执行这行代码时，它包含来自的选项stf.tlc自动。如果stf.tlc是已转换为新布局的MathWorks内部系统目标文件，则对话框使用新布局显示继承的选项。

处理不支持的选项。金宝app如果目标不支持从继承的所有选项金宝appert.tlc，您应该检测不支持的选项设置，并显示警告或错金宝app误消息。在某些情况下，如果用户选择了目标不支持的选项，则可能需要中止构建过程。金宝app例如，如果您的目标不支持金宝app生成一个示例主程序选项，如果选择了该选项，则不应允许构建过程继续进行。

即使您的目标可能不支持所有继承的ERT选项，也需要将ERT选项保金宝app留在代码生成窗格中的“配置参数”对话框。不要简单地从金宝apprtwoptions结构中的系统目标文件。选项必须在对话框中，以便代码生成器在执行优化时扫描。

例如，您可能希望阻止用户关闭单个输出/更新功能选择。从对话框中删除此选项并简单地分配TLC变量似乎是合理的CombineOutputUpdateFcns来在．但是，如果该选项未包含在对话框中，则代码生成器将假设输出和更新函数包含在对话框中不被合并。其结果是生成效率较低的代码。

介绍

以下部分包括有关自定义系统目标文件的技术的信息，包括:

所需和推荐%包括

如果您需要实现特定于目标的代码生成特性，我们建议您的系统目标文件包含TLC文件mytarget_genfiles.tlc．

一旦您的系统目标文件设置了所需的TLC环境，您必须包含codegenentry.tlc以启动标准代码生成过程。

mytarget_genfiles.tlc提供了在主代码生成入口点之后执行自定义TLC代码的机制。看到使用mytarget_genfiles.tlc．

使用mytarget_genfiles.tlc。mytarget_genfiles.tlc(可选)作为中心文件非常有用，可以从中调用特定于目标的TLC文件，这些文件可以在目标构建过程中生成额外的文件。例如，您的目标可以为开发环境创建子生成文件或项目文件，或者为调试器创建命令脚本来进行自动下载。

然后，构建过程可以直接从make过程调用这些生成的文件，也可以在可执行文件创建之后调用。这是用月31_make_rtw_hook.m机制，如使用STF_make_rtw_hook文件自定义构建过程．

下面的TLC代码显示了一个示例mytarget_genfiles.tlc文件。

%selectfile NULL_FILE %assign ModelName = CompiledModel。%%创建调试器脚本%assign model_script_file = "%.cfg" %assign script_file = "debugger_script_template. cfg"%if RTWVerbose %selectfile STDOUT ### create % %selectfile NULL_FILE %endif %include "%" %openfile bld_file = "%" % %closefile bld_file

处理目标选项值的别名

本节描述在测试目标设备类型的用户指定值时可用于检测和解析别名值或遗留值(ProdHWDeviceType)和代码替换库(CodeReplacementLibrary）.

RTW.isHWDeviceTypeEq。要测试两个目标设备类型值是否代表相同的硬件设备，调用以下函数:

result = RTW.isHWDeviceTypeEq(类型1，类型2）

在哪里类型1和类型2是包含目标设备类型值或别名的字符向量。

的RTW.isHWDeviceTypeEq函数返回true类型1和类型2是表示相同硬件设备的字符向量。例如，下面的调用返回true:

RTW.isHWDeviceTypeEq(“指定”、“通用- >自定义”)

有关目标设备类型选项的说明ProdHWDeviceType的命令行信息硬件实现面板参数设备供应商(金宝app模型)和设备类型(金宝app模型)。

RTW.resolveHWDeviceType。要返回硬件设备的设备类型值，给定一个可能是别名或遗留值的值，调用以下函数:

result = RTW.resolveHWDeviceType()类型）

在哪里类型是包含目标设备类型值或别名的字符向量。

的RTW.resolveHWDeviceType函数返回设备的设备类型值。例如，下面两个调用都返回“通用- >自定义”：

RTW.resolveHWDeviceType(“指定”)RTW.resolveHWDeviceType(通用- >自定义)

有关目标设备类型选项的说明ProdHWDeviceType的命令行信息硬件实现面板参数设备供应商(金宝app模型)和设备类型(金宝app模型)。

RTW.isTflEq。要测试两个代码替换库(CRL)名称是否表示相同的CRL，请调用以下函数:

result = RTW.isTflEq(name1，name2）

在哪里name1和name2是包含CRL值或别名的字符向量。

的RTW.isTflEq函数返回truename1和name2是表示相同代码替换库的字符向量。例如，下面的调用返回true:

RTW.isTflEq（'GNU','GNU C99 extensions')

的描述CodeReplacementLibrary参数,看到代码替换库．

RTW.resolveTflName。要返回代码替换库的CRL值，给定一个可能是别名或遗留值的值，请调用以下函数:

result = RTW.resolveTflName(名字）

在哪里名字是包含CRL值或别名的字符向量。

的RTW.resolveTflName函数返回引用的代码替换库的值。例如，下面两个调用都返回GNU C99扩展：

RTW.resolveTflName环球套票(GNU的)。resolveTflName('GNU C99 extensions')

的描述CodeReplacementLibrary参数,看到代码替换库．

金宝app支持多种开发环境

您的目标可能需要支持多种开发环境(例如，两个或多金宝app个交叉编译器)或多种代码生成模式(例如，生成二进制可执行文件与为编译器生成项目文件)。

满足此需求的一种方法是实现多个系统目标文件。每个系统目标文件为开发环境调用一个模板生成文件。这相当于提供了两个独立的目标。

更新您的自定义系统目标文件

更新自定义系统目标文件可能会影响使用更新的系统目标文件加载的模型的选项值。如果禁用某个选项，更新后的系统目标文件将使用该选项的默认值。如果模型对该选项具有不同的值，那么当您使用更新的系统目标文件加载模型时，模型中的值将被丢弃，而系统目标文件将使用默认值。

介绍

本教程可以补充中描述的示例目标指南示例自定义目标．对于介绍和示例文件，请先尝试示例目标。

本教程指导您完成创建基于ert的目标的过程，my_ert_target．这个练习演示了几个任务，这是创建自定义目标的典型任务:

在此练习中，您将实现一个可操作的、但骨架的、基于ert的目标。这个目标可以作为自定义嵌入式目标完整实现的起点。

my_ert_target概述

在接下来的部分中，您将创建一个骨架目标，my_ert_target．目标继承并支持ERT目标的标准选项，并在Conf金宝appiguration Parameters对话框中显示其他特定于目标的选项(参见my_ert_target的目标特定选项）.

my_ert_target金宝app支持基于工具链的构建，生成在主机系统上运行的代码和可执行文件。my_ert_target使用低成本航空编译器^®平台。所选择的编译器随时可用，并随代码生成器一起分发。在Microsoft Windows平台上，如果使用不同的编译器，则可以设置低成本航空通过以下MATLAB命令暂时作为默认编译器:

墨西哥人设置

该软件显示安装在计算机上的受支持编译器的链接。金宝app单击低成本航空链接。

你可以测试my_ert_target使用与ERT目标兼容的模型(参见配置系统目标文件(嵌入式编码器))。生成的程序与ERT生成的程序操作相同。

为了简化目标的测试，请使用targetmodel，一个非常简单的固定步骤模型(参见创建测试模型和s -函数）.中的S-Function块targetmodel的源代码timestwo示例，并生成完全内联的代码。看到s函数的例子(金宝app模型)和带TLC的内联s函数的进一步讨论timestwos函数的例子。

创建目标文件夹

创建文件夹来存储目标文件，并将它们添加到MATLAB路径中，遵循推荐的约定(参见文件夹和文件命名约定）.您还创建了一个文件夹来存储测试模型、s函数和生成的代码。

这个例子假设您的目标和模型文件夹位于文件夹中c: /工作．不要将您的目标和模型文件夹放在MATLAB文件夹树中(即，在matlabroot文件夹)。

创建文件夹并使其可访问:

创建基于ert的工具链兼容的系统目标文件

通过复制和修改ERT目标的标准系统目标文件，为目标创建系统目标文件。然后，通过在“系统目标文件浏览器”和“配置参数”对话框中查看新创建的目标器来验证系统目标器文件。

编辑系统目标文件。要编辑系统目标文件，请执行以下步骤:

创建ToolchainCompliant函数。要使用工具链方法启用构建，您需要创建一个对应于SelectCallback在自定义系统目标文件末尾附近。该函数设置工具链遵从性的属性。

function enableToolchainCompliant(hSrc, hDlg) %以下参数使能toolchain合规。slConfigUISetVal(hDlg, hSrc， 'UseToolchainInfoCompliant'， 'on');slConfigUISetVal(hDlg, hSrc， 'GenerateMakefile'，'on');%以下参数不需要符合工具链。但是，建议您设置这些默认值并禁用这些参数(如下所示)。slConfigUISetVal(hDlg, hSrc， 'RTWCompilerOptimization'，'off');slConfigUISetVal(hDlg, hSrc， 'MakeCommand'，'make_rtw');slconfiguistenabled (hDlg, hSrc， 'RTWCompilerOptimization'，false);slconfiguisenabled (hDlg, hSrc， 'MakeCommand'，false);结束

查看系统目标文件。此时，您可以验证目标是否继承并显示ERT选项，如下所示:

骨架目标的系统目标文件已经完成。如果您正在使用工具链方法，您就可以为您的目标调用构建过程了。

如果你喜欢使用模板制作文件的方法，对TMF的引用，my_ert_target_lcc.tmf，在系统目标文件头中的注释阻止您调用目标的构建过程，直到TMF文件到位。首先，您必须创建一个my_ert_target_lcc.tmf文件。

创建基于ert的TMF

如果您将工具链生成文件方法与工具链兼容的自定义目标一起使用，则省略应用于模板生成文件方法的步骤。(跳过本节。)

如果您正在使用模板化的makefile方法，请遵循应用于TMF的步骤，并省略从系统目标文件文件调用启用工具链遵从性的函数，该函数在创建基于ert的工具链兼容的系统目标文件．

通过复制和修改LCC编译器的标准ERT TMF，为您的目标创建一个TMF:

您的目标现在可以生成代码并构建基于主机的可执行文件。在接下来的部分中，您将创建一个测试模型，并使用my_ert_target．

创建测试模型和s -函数

在本节中，您将构建一个简单的测试模型，以便稍后在代码生成中使用:

保持targetmodel打开模型以在下一节中使用，在这一节中，您将使用测试模型生成代码。

验证目标操作

在本节中，您将配置targetmodel为my_ert_target自定义目标，并使用目标来生成代码并构建可执行文件: