概述

自定义目标的组件是位于文件夹层次结构中的文件。这个结构中的顶级文件夹称为目标根文件夹．目标根文件夹及其内容根据中描述的约定命名、组织并位于MATLAB路径上文件夹和文件命名约定．

自定义目标的组件包括

接下来的部分将介绍开发每个组件所需了解的关键概念和术语。提供了更详细的信息源的参考。

代码组件

包含从Simulink生成的代码的可执行程序金宝app^®模型由若干代码模块和数据结构组成。它们分为两类:应用程序组件和执行支持文件。金宝app

应用程序组件。应用程序组件是那些特定于特定模型的组件;它们实现由模型中的块表示的功能。应用程序组件不是特定于目标的。应用程序组件包括

执行支持文件。金宝app若干代码模块和数据结构，统称为执行支持文件金宝app，负责管理和支持生成程序的执行。金宝app执行支持文件模块不会自动生成金宝app。根据目标的需求，您必须实现执行支持文件的某些部分。金宝app执行支持文件金宝app总结执行支持文件。金宝app

用户编写的执行支持文件。金宝app代码生成器提供了大部分执行支持文件。金宝app根据目标的需求，您必须实现以下部分或全部元素:

控制文件

代码生成和构建过程由一些TLC和MATLAB文件共同指导控制文件．本节介绍和总结了主要的控制文件。

顶层控制文件(make_rtw)。当您按下按钮时，将启动构建过程Ctrl + B．此时，构建过程将解析使命令字段代码生成窗格中的配置参数对话框，期望找到控制构建过程的MATLAB命令的名称(以及该命令的可选参数)。默认命令为make_rtw，构建过程的默认顶级控制文件为make_rtw.m．

的make_rtw.m文件包含执行特定于目标的控制文件所需的逻辑，包括用于执行自定义代码的许多钩子点。make_rtw做以下事情:

系统目标文件。目标语言编译器(TLC)根据Simulink块图的部分描述(金宝app模型.rtw）.目标语言编译器读取模型.rtw并执行由几个目标文件(.tlc文件。)系统目标文件位于该程序的顶层，控制代码生成过程。这个过程的输出是许多源文件，它们被提供给您的开发系统的make实用程序。

您需要创建一个定制的系统目标文件来为您的目标设置代码生成参数。您应该复制、重命名和修改标准ERT系统目标文件(matlabroot/ rtw / c / ert /ert.tlc）.

中描述了系统目标文件的详细结构自定义系统目标文件．

模板生成文件(TMF)。TMF提供关于您的模型和开发系统的信息。构建过程使用此信息创建makefile (楼上文件)，构建可执行程序。

一些目标实现了多个TMF，以支持多个开发环境(例如，两个或多个交叉编译器)或多种代码生成模式(例如，生成二进金宝app制可执行文件与为编译器生成项目文件)。

嵌入式编码器^®软件提供了大量适合不同类型开发计算机系统的tmf。这些tmf位于matlabroot/ rtw / c / ert（开放）.中描述了标准tmf模板制作文件和制作选项．

TMF的详细结构描述在自定义模板生成文件．

钩的文件。构建过程允许您提供可选的钩的文件在代码生成和制作过程中的指定点执行。可以使用钩子文件将特定于目标的操作添加到构建过程中。

钩子文件必须遵循定义良好的命名和位置要求。文件夹和文件命名约定描述这些需求。

目标目录(mytarget)

此文件夹包含目标的关键子文件夹(请参阅文件夹和文件命名约定）.您还可以定位其他文件(例如自述文件)在目标根文件夹。以下部分描述了必需的和可选的子文件夹及其内容。

目标文件夹:mytarget/mytarget

此文件夹包含目标的中心文件，例如系统目标文件(系统目标文件)和模板makefile (TMF)。目标文件夹中的关键文件(mytarget/mytarget)总结应存储在其中的文件mytarget / mytarget，并提供指向有关这些文件的详细信息的指针。

目标块文件夹(mytarget/blocks)

如果目标包括设备驱动程序或其他块，请在此文件夹中找到块实现文件。mytarget /块包含

您还可以将示例模型和支持文件存储在金宝appmytarget /块．或者，您可以创建一个mytarget / mytargetdemos文件夹，它也应该在MATLAB路径上。

要在标准Simulink Library Browser中显示您的块和/或将示金宝app例模型集成到MATLAB会话环境中，您可以创建下面描述的文件并将它们存储在其中mytarget /块．

mytarget /块/ slblocks.m。该文件允许将一组块集成到Simulink库和Simulink库浏览器中。金宝app

“Blocksets and Toolboxes”子系统blkStruct。Name = sprintf('嵌入式目标\n for MYTARGET');blkStruct。OpenFcn = 'mytargetlib';blkStruct。MaskDisplay = 'disp(" MYTARGET ")';Simulink Library浏览金宝app器浏览器的%信息(1)。库= 'mytargetlib';浏览器(1)。Name = '嵌入式目标MYTARGET';浏览器(1)。这个库是“扁平的”(即没有子系统)吗? blkStruct.Browser = Browser;

mytarget /块/ demos.xml。该文件提供了关于示例模型的组件、组织和位置的信息。MATLAB软件使用这些信息将示例放置在MATLAB会话环境中。

<？XML版本="1.0"编码="utf-8"?> Embedded Target for MYTARGET simulink $toolbox/matlab/icons/boardicon.gif mytarget_overview.html  Multirate model  MYTARGET demo mytarget_overview.html mytarget_model   

开发工具文件夹(mytarget/dev_tool1, mytarget/dev_tool2)

这些文件夹包含与特定开发环境或工具相关的文件(dev_tool1，dev_tool2等)。通常，您的目标至少支持一个这样的开发环境，并金宝app在构建过程中调用其编译器、链接器和其他实用程序。mytarget / dev_tool1包括链接器命令文件、启动代码、钩子函数和支持此过程所需的其他文件。金宝app

对于每个开发环境，您都应该提供一个单独的文件夹。

目标源代码文件夹(mytarget/src)

这个文件夹是可选的。如果目标的复杂性需要它，您可以使用mytarget / src存储公共源代码和配置代码(例如引导和启动代码)。

介绍

目标文件夹mytarget / mytarget包含目标实现中的关键文件。这些文件包括系统目标文件、模板makefile、主程序模块以及可选的M和TLC钩子文件，它们允许您将特定于目标的操作添加到构建过程中。下面几节描述关键目标文件夹文件。

mytarget.tlc

mytarget.tlc是系统目标文件。系统目标文件的功能包括

您应该以系统目标文件为基础ert.tlc，嵌入式编码器软件提供的系统目标文件。

自定义系统目标文件提供关于系统目标文件结构的详细信息，还提供了如何自定义系统目标文件的说明

mytarget.tmf

mytarget.tmf是用于为目标构建可执行文件的模板生成文件。

有关模板makefile的结构和操作的基本信息，请参见自定义模板生成文件．

mytarget_genfiles.tlc

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

mytarget_main.c

你的目标需要一个主程序模块。要提供一个主模块，您可以选择

有关主程序操作的说明，请参见将生成的独立可执行程序部署到目标硬件(嵌入式编码)。本节还包含生成和修改主程序模块的指导方针。

STF_make_rtw_hook.m

月31_make_rtw_hook.m是可选钩子文件，可用于在构建过程中的指定点调用特定于目标的函数或可执行文件。月31_make_rtw_hook.m方法实现一个函数，该函数将调度到特定操作方法参数。

使用STF_make_rtw_hook文件自定义构建过程控件的操作月31_make_rtw_hook.m钩文件的详细说明。

STF_rtw_info_hook。(过时的)

在版本14之前，自定义目标通过钩子文件(称为月31_rtw_info_hook.m）.的月31_rtw_info_hook指定的属性，例如整数数据类型的字长(例如，字符，短，int,长)和自定义目标的特定于C实现的属性。

的月31_rtw_info_hook机制已被硬件实现窗格中的“配置参数”对话框。使用此对话框，您可以指定以前在您的月31_rtw_info_hook文件。

为了向后兼容，存在月31_rtw_info_hook文件仍然可用。但是，您应该转换您的目标和模型来使用硬件实现窗格。看到配置运行时环境选项．

info.xml

此文件向MATLAB软件提供信息，指定在MATLAB会话环境中显示目标工具箱的位置。有关更多信息，请参见显示自定义文档(MATLAB)。

mytarget_overview.html

按照约定，该文件作为目标示例的主页。

的<描述>场demos.xml应该指向mytarget_overview.html(见mytarget /块/ demos.xml）.

使用实例mytarget_overview.html文件

 




 

            
外部开发目标的附加文件
            

             
介绍
             
mytarget / mytarget / mytarget_setup.m
             
mytarget / mytarget /医生
            
            

             
介绍
             
如果您正在开发一个未安装到MATLAB树中的嵌入式目标，则应该在其中提供目标设置脚本和目标文档mytarget / mytarget，以方便用户使用。以下部分描述了所需的材料和放置它们的位置。
            
            

             
mytarget / mytarget / mytarget_setup.m
             
该文件脚本将目标路径添加到MATLAB路径中。您的文档应该指导用户在安装目标时运行该脚本。
             
您应该包含对MATLAB函数的调用savepath在你的mytarget_setup.m脚本。该功能保存已添加的路径，需要用户运行mytarget_setup.m只有一次。
             
下面的代码就是一个例子mytarget_setup.m文件。
             

              
函数mytarget_setup() curpath = pwd;Tgtpath = curpath(1:end-length('\mytarget'));目录fullfile (tgtpath mytarget));目录fullfile (tgtpath dev_tool1));目录fullfile (tgtpath '块'));目录fullfile (tgtpath mytargetdemos));savepath;disp('MYTARGET目标路径设置完成。');
             
            
            

             
mytarget / mytarget /医生
             
你应该把与你的目标相关的文档放在文件夹里mytarget / mytarget /医生．
            
           

目标开发和构建过程

• 关于构建过程

• 构建过程阶段和信息传递

• 附加信息传递技巧

getenv ('MSDEVDIR') ans = D:\ application \Microsoft Visual Studio\Common\MSDev98

%assign eVar = FEVAL("getenv"，"")

function k = tlc2appdata(appDataName,data) disp([mfilename，': '，appDataName，' '， data]);setappdata (0 appDataName数据);K = 0;% TLC期望FEVAL的返回值。

% %测试。tlc %% %assign myApp = "z80" %assign myData = "314159" %assign dummy = FEVAL("tlc2appdata"，myApp,myData)