概述

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

% % - - - - - - - - - - - - - - - - - - - - - - - - - - - - - % %头评论部分% % - - - - - - - - - - - - - - - - - - - - - - - - - - - - - % % SYSTLC:实时目标% % TMF例子:my_target。tmf: make_rtw % %初始评论包含指令算法浏览器。% %文档、日期、版权和其它信息可能会效仿……% selectfile NULL_FILE……% % - - - - - - - - - - - - - - - - - - - - - - - - - - - - - % % % % TLC配置变量部分- - - - - - - - - - - - - - - - - - - - - - - - - - - - - % %分配代码格式,语言,目标类型。% % %分配CodeFormat = " Embedded-C " %分配TargetType =“RT”%分配语言= " C " % % % % - - - - - - - - - - - - - - - - - - - - - - - - - - - - - % % TLC程序入口点% % - - - - - - - - - - - - - - - - - - - - - - - - - - - - - % %调用入口点函数。%包括“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路径文件格式化标题评论。评论中包含以下指令:

以下标题评论matlabroot/ rtw / c / ert /ert.tlc。

% % SYSTLC:嵌入式编码器TMF: ert_default_tmf: make_rtw % % SYSTLC:创建Visual C / c++解决方案文件为嵌入式编码\ % % TMF:环球套票。MSVCBuild: make_rtw。

每个评论最多只能包含两行。

如果你不指定TMF场系统中目标文件,文件仍然是有效的。改变的值TemplateMakefile参数,您可以使用指定的回调函数rtwgensettings.SelectCallback。

您还可以使用指定的回调函数rtwgensettings.SelectCallback改变外部模式参数的值,ExtMode,ExtModeTransport,ExtModeMexFile,或ExtModeIntrfLevel。

您可以指定超过一组的指令在评论标题。每一个这样的组织系统中显示为一个不同的目标配置目标文件浏览器。在上面的示例中,第一个两行代码指定的默认配置ERT目标。下两行指定一个配置,创建和构建微软^®Visual c++^®解决方案(. sln)文件。下图显示了这些配置系统中出现目标文件浏览器。

看到创建一个自定义目标配置对于一个定制的头注释的例子。

薄层色谱配置变量

这部分的系统目标文件分配全球TLC变量与整体代码生成过程。

对于嵌入式目标,在大多数情况下,您应该使用全局TLC变量设置使用的ERT目标(ert.tlc)。尤为重要,系统目标文件使用“Embedded-C”值CodeFormatTLC变量,并使用相应的rtwgensettings.DerivedFrom= 'ert.tlc'在RTW_OPTIONS薄层色谱的文件。验证的值分配给以下变量:

薄层色谱程序入口点和相关%包括

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

%包括“codegenentry.tlc”

如果你需要实现有针对性的代码生成功能,您应该包括薄层色谱文件mytarget_genfiles.tlc目标文件在你的系统。这个文件提供了一种机制执行定制TLC代码调用之前和之后codegenentry.tlc。这种机制的信息,请参阅

自定义代码生成过程的另一种方法是调用底层函数(通常调用codegenentry.tlc直接),包括自己的TLC函数在每个阶段的过程。这种方法应该谨慎对待。看到薄层色谱文件为更多的信息。

低级函数调用codegenentry.tlc是

RTW_OPTIONS节

的RTW_OPTIONS部分是有界的指令:

/ % BEGIN_RTW_OPTIONS。。。END_RTW_OPTIONS % /

的第一部分RTW_OPTIONS部分定义了一个数组rtwoptions结构。讨论了这种结构使用rtwoptions显示定制的目标选择。

的第二部分RTW_OPTIONS部分定义rtwgensettings,一个结构定义建立文件夹名称和代码生成过程的其他设置。看到rtwgensettings结构和有关信息。rtwgensettings。

rtwgensettings结构

最后一部分定义了系统的目标文件rtwgensettings结构。该结构存储信息写入模型.rtw所使用的文件和构建过程。的rtwgensettings开发人员最感兴趣的目标

额外的代码生成选项

配置生成的代码与薄层色谱代码生成变量描述了额外的关爱。最终用户的目标可以分配这些变量通过输入MATLAB命令的形式

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

(有关更多信息,请参见为代码生成指定TLC。)

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

%分配变量=瓦尔

为了可读性,我们建议您添加这样的作业系统的部分目标文件后发表评论环球套票代码生成配置设置。

模型参考注意事项

看到金宝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 = [''];

第一个元素添加一个userPreferred目标选项(我)窗格下代码生成在配置参数对话框。中定义的窗格显示选项rtwoptions (2),rtwoptions (3),rtwoptions (4),rtwoptions (5)。

如果你想定义一个大量的选项,您可以定义多个类别组织在一个系统目标文件。

注意rtwoptions结构和回调是用MATLAB编写的代码,虽然他们是嵌入在一个薄层色谱文件。来验证你的语法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.DerivedFrom字段rtwgensettings结构定义的系统目标文件选项被继承。你应该定制目标转换为使用该机制如下。

设置rtwgensettings.DerivedFrom字段值在下面的例子:

rtwgensettings.DerivedFrom= 'stf.tlc';

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

rtwgensettings.DerivedFrom= 'ert.tlc';

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

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

即使你的目标可能不支持所有继承ERT选项,要求保留的ERT选项金宝app代码生成面板的配置参数对话框。不要简单地移除不支持的选项金宝apprtwoptions结构系统中的目标文件。对话框中的选项必须扫描的代码生成器,它执行优化。

例如,您可能想要阻止用户关掉单输出/更新功能选择。似乎合理的从对话框中删除这个选项,只是分配TLC变量CombineOutputUpdateFcns来在。然而,如果选择是不包括在对话框中,代码生成器假定输出和更新功能不结合。生成更高效的代码。

介绍

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

要求和建议%包括

如果你需要实现有针对性的代码生成功能,我们建议您的系统目标文件包括薄层色谱文件mytarget_genfiles.tlc。

一旦你的系统目标文件设置所需的TLC环境,你必须包括codegenentry.tlc开始标准代码生成过程。

mytarget_genfiles.tlc提供了一种机制来执行定制的TLC代码后,主要生成代码入口点。看到使用mytarget_genfiles.tlc。

使用mytarget_genfiles.tlc。mytarget_genfiles.tlc(可选)是有用的作为一个中央文件的调用有针对性的TLC文件生成额外的文件作为你的目标构建过程的一部分。例如,你的目标可能为开发环境,创建sub-makefiles或项目文件或命令脚本调试器自动下载。

构建过程可以调用这些生成的文件直接从制造过程或之后创建可执行。这是完成了月31_make_rtw_hook.m机制,如中描述自定义构建过程与STF_make_rtw_hook文件。

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

% selectfile NULL_FILE %分配ModelName = CompiledModel。名称% %创建脚本调试器%分配model_script_file = " % < ModelName >。cfg " %分配script_file = " debugger_script_template。tlc“%如果RTWVerbose % selectfile STDOUT # # #创建% < model_script_file > % selectfile NULL_FILE % endif %包括“% < script_file >“% openfile bld_file = " % < model_script_file >”% < CreateDebuggerScript () > % closefile bld_file

处理目标选项值的别名

本节描述效用函数,可用于检测并解决别名值或遗留值测试目标设备类型(用户指定的值时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)名称表示相同的CRL,调用以下函数:

结果= RTW.isTflEq (name1,name2)

在哪里name1和name2是特征向量包含CRL值或别名。

的RTW.isTflEq函数返回true,如果name1和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参数,看到代码替换库。

金宝app支持多种开发环境

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

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

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

更新您的自定义系统目标文件可以加载选项值的影响模型,使用更新后的系统目标文件。如果禁用一个选项,更新系统目标文件使用该选项的默认值。如果一个模型有不同的价值选择,当你与更新的系统目标文件加载模型,从模型的价值被丢弃和系统目标文件使用默认值。

介绍

本教程可以补充例子目标指南中描述示例自定义目标。介绍和示例文件,先试着目标的例子。

本教程引导您通过创建一个ERT-based目标的过程,my_ert_target。这个练习了几个任务,这是典型的用于创建一个定制的目标:

在这个练习中,你执行一个操作,但骨骼,ERT-based目标。这个目标可能是有用的作为起点的完整实现一个定制的嵌入式目标。

my_ert_target概述

在下面几节中,您创建一个骨架的目标,my_ert_target。目标继承和支持的标准选项ERT目标并显示额外的有金宝app针对性的选项(请参见配置参数对话框有针对性的选择my_ert_target)。

my_ert_target金宝app支持toolchain-based构建、生成代码和可执行文件,在主机系统上运行。my_ert_target使用低成本航空编译器在Microsoft Windows^®平台。选择编译器是现成的,分布式的代码生成器。在Microsoft Windows平台上,如果你使用不同的编译器,您可以设置低成本航空暂时作为默认编译器通过MATLAB命令如下:

墨西哥人设置

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

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

简化你的测试目标、测试targetmodel,一个非常简单的固定步模型(见创建测试模型和功能)。中的功能块targetmodel使用的源代码timestwo例子中,并生成完全内联代码。看到s函数的例子和内联S-Functions与薄层色谱进行进一步的讨论timestwos函数的例子。

创建目标文件夹

创建文件夹来存储目标文件并将它们添加到MATLAB路径,建议约定(见后文件夹和文件命名约定)。您还创建一个文件夹来存储测试模型,功能,生成的代码。

这个示例假设您的目标和模型文件夹位于文件夹c: /工作。不要把你的目标和模型文件夹内的MATLAB文件夹树(也就是说,在还是下matlabroot文件夹)。

创建文件夹,让他们访问:

创建ERT-Based工具链的系统目标文件

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

编辑系统目标文件。编辑系统目标文件,使用这些步骤:

创建ToolchainCompliant函数。使用工具链,使构建的方法,您将创建一个对应的函数SelectCallback附近的自定义系统目标文件。这个函数设置属性工具链。

处理函数enableToolchainCompliant (hSrc) %以下参数启用工具链合规。slConfigUISetVal(处理,hSrc UseToolchainInfoCompliant ', '对');slConfigUISetVal(处理,hSrc GenerateMakefile ', '对');%以下参数不需要工具链合规。%,但建议实践设置这些参数和%禁用默认值(如图所示)。slConfigUISetVal(处理,hSrc RTWCompilerOptimization ', '关闭');slConfigUISetVal(处理,hSrc MakeCommand ', ' make_rtw ');slConfigUISetEnabled(处理、hSrc RTWCompilerOptimization,假);slConfigUISetEnabled(处理、hSrc MakeCommand,假);hSrc.refreshDialog; end

查看系统目标文件。在这一点上,您可以验证目标继承并显示ERT选项如下:

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

如果你喜欢使用makefile的模板方法,参考TMF,my_ert_target_lcc.tmf系统中,目标文件头评论阻止你调用你的目标,直到TMF文件的构建过程。首先,您必须创建一个my_ert_target_lcc.tmf文件。

创建ERT-Based模板MakeFile

如果您正在使用的工具链makefile的方法工具链的自定义目标,忽略的步骤适用于模板makefile的方法。(跳过这一节。)

如果您使用的是模板makefile的方法,按以下步骤,适用于一个模板makefile和省略从您的系统调用函数,使toolchain-compliance目标文件,这是中描述创建ERT-Based工具链的系统目标文件。

创建一个模板makefile为目标通过复制和修改提供ERT模板makefile。选择最适合你的目标模板makefile。这个示例使用ert_lcc64.tmf,但您还可以使用ert_vcx64.tmf或ert_unix.tmf。

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

创建测试模型和功能

在本部分中,您构建一个简单的测试模型,供以后使用代码生成:

保持targetmodel模型打开使用在下一节中,你使用测试模型生成代码。

验证目标操作

在本节中,您配置targetmodel为my_ert_target定制目标,用目标来生成代码并构建一个可执行: