概述

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

%%---------------------------- %% 头评论部分  %%---------------------------- %% 实时目标% % TMF SYSTLC:例子:my_target。初始注释包含STF Browser的指令。%%文档、日期、版权和其他信息可以在. ...上找到% selectfile 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语句之前。

注释的存在使代码生成器能够检测系统目标文件。当打开系统目标文件浏览器时，代码生成器扫描MATLAB路径，查找具有格式化头注释的TLC文件。注释包含以下指令:

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

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

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

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

所指定的回调函数rtwgensettings。SelectCallback要更改外部模式参数的值，ExtMode，ExtModeTransport，ExtModeMexFile,或ExtModeIntrfLevel．

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

看到创建自定义目标配置下面是自定义头注释的示例。

薄层色谱配置变量

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

对于嵌入式目标，在大多数情况下，您应该简单地使用ERT目标使用的全局TLC变量设置(ert.tlc)．的系统目标文件使用“Embedded-C”值CodeFormatTLC变量，并使用相应的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．）

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

%分配变量=瓦尔

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

模型参考注意事项

看到支持模型引用对于有关系统目标文件和其他修改的重要信息，您可能需要进行支持代码生成器模型引用特性的修改。

使用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查询自定义目标选项。

尝试研究示例代码，同时与Configuration Parameters对话框中的示例目标选项进行交互。要与示例目标文件交互，

继承目标选择

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

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

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

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

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

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

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

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

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

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

简介

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

要求和建议%包括

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

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

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

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

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

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

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

处理目标选项值的别名

本节描述实用函数，可用于在测试用户指定的目标设备类型(ProdHWDeviceType)和代码替换库(CodeReplacementLibrary)．

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

结果= RTW.isHWDeviceTypeEq (类型1，类型2）

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

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

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

有关目标设备类型选项的说明ProdHWDeviceType的命令行信息硬件实现面板参数设备供应商而且设备类型．

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

结果= RTW.resolveHWDeviceType (类型）

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

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

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

有关目标设备类型选项的说明ProdHWDeviceType的命令行信息硬件实现面板参数设备供应商而且设备类型．

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

结果= RTW.isTflEq (name1，name2）

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

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

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

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

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

结果= RTW.resolveTflName (的名字）

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

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

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

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

支持多种开发环境

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

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

更新自定义系统目标文件

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

简介

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

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

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

my_ert_target概述

在下面的小节中，您将创建一个骨骼目标，my_ert_target．该目标继承并支持ERT目标的标准选项，并在Configuration Parameters对话框中显示附加的特定于目标的选项(参见my_ert_target的目标特定选项)．

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

墨西哥人设置

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

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

为了简化目标的测试，使用targetmodel这是一个非常简单的固定步长模型(参见创建测试模型和s -函数)．S-Function块targetmodel的源代码timestwo示例，并生成完全内联的代码。看到s函数的例子而且使用TLC的内联s -函数为进一步讨论timestwos函数的例子。

创建目标文件夹

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

此示例假设您的目标文件夹和模型文件夹位于该文件夹中c: /工作．不要将您的目标和模型文件夹放在MATLAB文件夹树中(也就是说，在matlabroot文件夹)。

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

创建基于ert的、符合工具链的系统目标文件

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

编辑系统目标文件。要编辑系统目标文件，使用以下步骤:

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

以下参数启用工具链遵从性。slConfigUISetVal(hDlg, hSrc， 'UseToolchainInfoCompliant'， 'on');slConfigUISetVal(处理,hSrc GenerateMakefile ', '对');以下参数对于工具链遵从性来说是不需要的。但是，建议您设置这些默认值并禁用这些参数(如下所示)。slConfigUISetVal(处理,hSrc RTWCompilerOptimization ', '关闭');slConfigUISetVal(处理,hSrc MakeCommand ', ' make_rtw ');slConfigUISetEnabled(处理、hSrc RTWCompilerOptimization,假);slConfigUISetEnabled(处理、hSrc MakeCommand,假);hSrc.refreshDialog; end

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

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

如果您更喜欢使用模板生成文件方法，对TMF的引用，my_ert_target_lcc.tmf，在系统目标文件头注释中，可以阻止您在TMF文件到位之前为目标调用构建过程。首先，您必须创建一个my_ert_target_lcc.tmf文件。

创建基于ert的模板MakeFile

如果您正在使用带有工具链兼容的自定义目标的工具链生成文件方法，请忽略应用于模板生成文件方法的步骤。(跳过这一节。)

如果您正在使用模板生成文件方法，请遵循适用于模板生成文件的步骤，而忽略从系统目标文件调用启用工具链遵从性的函数，该函数在创建基于ert的、符合工具链的系统目标文件．

通过复制和修改提供的ERT模板生成文件，为目标创建模板生成文件。选择最适合您的目标的模板生成文件。这个示例使用ert_lcc64.tmf，但你也可以用ert_vcx64.tmf或ert_unix.tmf．

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

创建测试模型和s -函数

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

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

验证目标操作

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