您可以将现有的C(或c++)函数,如设备驱动程序、查找表、通用函数和接口集成到Simulink中金宝app®模型使用传统代码工具。使用您作为MATLAB提供的规格®代码,该工具将现有功能转换为C MEX S函数,以便在Simulink模型中包含。金宝app如果你使用金宝appSimulink Coder™生成的代码,修改代码工具可以插入到你的C函数一个合适的呼叫到生成的代码。有关详细信息,请参阅导入调用外部代码到生成的代码修改代码工具(金宝app仿真软件编码器).
与使用S函数构建器或编写S函数相比,遗留代码工具更易于使用,并生成嵌入式系统通常需要的优化代码(不生成包装代码)。然而,考虑混合系统的替代方法,例如包括工厂和控制器的系统,或者用除C或C ++之外的语言编写的系统组件。替代方法更灵活,因为它们支持更多特征和编程语言。金宝app
要与遗留代码工具交互,您需要
使用遗留代码工具数据结构来指定
一种在S-函数名
现有C函数的规范
文件名和路径所需的编译
生成的S函数的选项
使用legacy_code
功能
初始化给定C函数的遗留代码工具数据结构
生成仿真过程中使用的S-功能
编译并将生成的S函数链接到动态可加载的可执行文件中
生成一个掩码s函数块用于调用生成的s函数
生成一个TLC块的文件,如果有必要,一个sFunction
_makecfg.m.
或RTWMAKECFG.M.
代码生成文件(金宝app仿真软件编码器产品许可证要求)
笔记
在你使用之前legacy_code
,确保为您的MATLAB安装设置了一个C编译器。
下图说明了使用遗留代码工具的一般过程。将C功能集成到具有遗留代码工具的Simulink模型中金宝app提供了一个使用传统代码工具来将现有的C函数为C MEX S函数的例子。
如果你有一个金宝app仿真软件编码器产品许可,请参阅导入调用外部代码到生成的代码修改代码工具(金宝app仿真软件编码器)有关使用用于代码生成的传统代码工具的信息。
这个例子演示了如何使用遗留代码工具将现有的C函数集成到Simulink模型中。金宝app
假设您有一个C函数,输出其浮点输入值乘以2。函数定义在一个名为doubleIt.c
,它的声明存在于名为doubleIt.h
.
初始化MATLAB结构def
属性的字段表示遗留代码工具属性legacy_code
函数。
DEF = legacy_code( '初始化')
遗留代码工具的数据结构命名为def
显示其在MATLAB命令窗口字段,如下所示:
DEF = SFunctionName: '' InitializeConditionsFcnSpec: '' OutputFcnSpec: '' StartFcnSpec: '' TerminateFcnSpec: '' HeaderFiles:{} SourceFiles:{} HostLibFiles:{} TargetLibFiles:{} IncPaths:{} SrcPaths:{} LibPaths:{}SampleTime: '继承' 选项:[1x1的结构]
为Legacy Code Tool数据结构中的字段指定适当的值,以标识现有C函数的属性。例如,通过在MATLAB命令提示符中输入以下命令来指定C函数源和头文件名:
def.sourcefiles = {'doubleit.c'};def.headerfiles = {'doubleit.h'};
您还必须指定关于遗留代码工具从C代码生成的s -函数的信息。例如,为s -函数及其输出函数声明指定一个名称,输入:
def.SFunctionName =“ex_sfun_doubleit”;def.OutputFcnSpec = 'double y1 = doubleIt(double u1)';
有关各种数据结构字段的信息,请参阅legacy_code
参考页面。
通过使用从所述现有的C功能的S-函数源文件legacy_code
函数。在MATLAB命令提示符处,输入:
legacy_code( 'sfcn_cmex_generate',DEF);
遗留代码工具使用def
来创建名为ex_sfun_doubleit.c.
在当前MATLAB文件夹中。
编译和S-函数源文件链接到一个动态可加载的可执行用于使用Simulink中金宝applegacy_code
函数。在MATLAB命令提示符处,输入:
Legacy_code('编译',def);
在MATLAB命令窗口中出现以下消息:
###开始编译ex_sfun_doubleit MEX( 'ex_sfun_doubleit.c', 'd:\工作\ lct_demos \ doubleIt.c', '-Id:\工作\ LCT \ lct_demos')###完成编译ex_sfun_doubleit ###退出
在32位的Microsoft上®窗户®系统,生成的s函数可执行文件被命名ex_sfun_doubleit.mexw32.
.
插入一个蒙面功能块进入Simulink模型金宝app。
legacy_code (slblock_generate, def);
遗留代码工具配置块以使用上一步中创建的C MEX S函数。此外,该工具掩盖了块,使其显示其值OutputFcnSpec
财产(见图的描述legacy_code
功能)。
在C-MEX s -函数块的输入处添加一个振幅为1的正弦波块,在输出处添加一个Scope块。
运行模拟。C-MEX S函数块返回其浮点输入的值乘以两个。它表现得像c函数doubleIt
.
此示例显示如何使用遗留代码工具集成C函数,其参数指向结构的指针。
在Si金宝appmulink®中,创建金宝appsimulink.bus.
对象来表示的结构类型。使用模型中的总线信号,以表示结构化的信号和状态。在工作空间中或在块参数创建对话框MATLAB结构来表示参数的结构。
有关总线信号的基本信息,请参阅虚拟总线.有关参数结构的基本信息,请参阅组织结构中的相关块参数定义.要创建总线对象,见创建和指定Simulink.Bus对象金宝app.
探索外部代码
将此自定义源代码复制到名为的文件中ex_mySrc_LCT.c
在当前文件夹中。
的#include “ex_myTypes_LCT.h” 空隙myFcn(sigStructType *在,paramStructType *参数,可以sigStructType *出){OUT-> SIG1 = IN-> SIG1 * params->参数1;out-> sig2 = in-> sig2 * params-> param2 + params-> param3;}
该函数的参数myfcn.
是指向结构的指针。该函数接受的输入信号的参数,参数的参数,并且输出信号的参数。
将此自定义头代码复制到名为的文件中ex_myTypes_LCT.h
在当前文件夹中。
#ifndef _my_types_h_ #define _my_types_h_ typedef struct {double sig1;双sig2;sigtracttype;typedef struct {double param1;Double Param2;Double Param3;paramstructype;#万一
文件定义了信号和参数结构类型的myfcn.
用途。
在Simulink中创建表示结构类型的总线对象金宝app
在命令提示符处,使用该函数金宝appSimulink.importExternalCTypes
在基础工作区中生成总线对象。
金宝appSimulink.importExternalCTypes ('ex_myTypes_LCT.h');
总线对象对应于塑造
类型ex_myTypes_LCT.h
定义。
创建块执行外部代码
创建一个结构变量,def
,存储调用外部代码的S函数的规范。使用的函数legacy_code
创建结构并设置默认值。
DEF = legacy_code(“初始化”);
设置s函数的名称为sfun_ex_mySrc_LCT
.
def.sfunctionname =.“sfun_ex_mySrc_LCT”;
通过文件名识别外部源文件和头文件。
def.SourceFiles = {'ex_mysrc_lct.c'};def.HeaderFiles = {'ex_myTypes_LCT.h'};
通过复制外部函数的原型,指定输出函数的原型,模型在每个模拟步骤中都会调用该原型myfcn.
.将参数的名称设置为u1
那p1
,日元
表示输入参数、参数参数和输出参数。使用语法[1]
指定每个实参是一个指针。
def.OutputFcnSpec = ['void myFcn(sigStructType u1[1], ')那...'paramStructType P1 [1],sigStructType Y1 [1])'];
使用的函数legacy_code
从规范中创建s函数和相应的C MEX可执行文件,def
.指定的选项“generate_for_sim”
准备正常和加速模拟的S函数。
legacy_code (“generate_for_sim”,def);
###开始编译sfun_ex_mySrc_LCT mex('-I/tmp/Bdoc20b_1595526_213019/tp491bb7d3/ex12763634', '-c', '-outdir', '/tmp/Bdoc20b_1595526_213019/tp575edfea_64ad_49c1_957e_5cf75b11aec7', '/tmp/Bdoc20b_1595526_213019/tp491bb7d3/ex12763634/ex_mySrc_LCT.c')墨西哥人成功完成。/tmp/Bdoc20b_1595526_213019/tp491bb7d3/ex12763634', '/tmp/Bdoc20b_1595526_213019/tp575edfea_64ad_49c1_957e_5cf75b11aec7/ ex_mysrc_ltc .o')/tmp/Bdoc20b_1595526_213019/tp491bb7d3/ex12763634/ sfun_ex_mysrc_lcc .c: In function ' mdlOutputs ': /tmp/Bdoc20b_1595526_213019/tp491bb7d3/ex12763634/ sfun_ex_mysrc_lcc .c:417:9: warning: implicit declaration of function ' myFcn ' [- wimplit -function-declaration] myFcn(__u1BUS, __p1BUS, __y1BUS);^~~~~ MEX成功完成。###完成sfun_ex_mySrc_LCT的编译
创建一个屏蔽的S函数块,可在仿真期间调用S函数。
legacy_code ('slblock_generate',DEF);
该块出现在一个新的模式。
要在模型中使用S-Function块,请创建一个类型为的总线信号sigStructType
用作块输入。块输出也是总线信号。块掩码接受一个参数,P1.要设置参数的值,使用MATLAB结构,其字段与结构类型的字段相匹配paramStructType
.
验证外部代码的执行
创建一个线束模型,用于在仿真期间验证外部代码的执行。
举一个例子,查看模型ex_lct_struct
.
Open_System(“ex_lct_struct”)
在常量块对话框中,恒定值参数设置为其字段与结构类型匹配的结构sigStructType
.在信号属性选项卡,输出数据类型设置为总线对象sigStructType
.
S函数块调用S函数sfun_ex_mySrc_LCT
你创造的。块的输出进入总线选择块,其提取信号元素sig1
和sig2
.
S函数块通过蒙版对话框接受参数。创建MATLAB结构structParam
用作参数的值。
structParam =结构;structParam。P.aram1 = 15; structParam.param2 = 20; structParam.param3 = 5;
或者,使用金宝appSimulink.Parameter.
对象包含的结构。如果使用一个参数对象,则可以通过使用总线对象设置的结构的数据类型paramStructType
.
structParam = 金宝appSimulink.Parameter (structParam);structParam。数据类型=“巴士:paramStructType”;
在“掩码”对话框中设置P1来structParam
.
set_param('ex_lct_struct / sfun_ex_mysrc_lct'那“SParameter1”那'structparam')
模拟模型。Scope块表明S-Function块调用外部函数myfcn.
.
Open_System(“ex_lct_struct /范围”) open_system (“ex_lct_struct / Scope1”)sim(“ex_lct_struct”)
ans =仿金宝app真软件。SimulationMetadata: [1x1 Simulink. out: out: [51x1 double]金宝appSimulationMetadata]错误信息:[0x0 char]
使用遗留代码工具的第一步是用表示现有C代码属性和生成的s函数的字段注册一个或多个MATLAB结构。注册过程是灵活的。您可以选择以多种方式设置资源和启动注册,包括
将所有需要的头文件和源文件在当前工作文件夹或在分层文件夹结构
生成一个或多个s函数并将其放置到当前工作文件夹中
在同一个文件夹中有一个或多个注册文件
要注册遗留代码工具数据结构:
使用legacy_code
功能,指定“初始化”
作为第一个论点。
lct_spec = legacy_code( '初始化')
遗留代码工具的数据结构命名为lct_spec.
在MATLAB命令窗口中显示其字段,如下所示:
lct_spec = SFunctionName: '' InitializeConditionsFcnSpec: '' OutputFcnSpec: '' StartFcnSpec: '' TerminateFcnSpec: '' HeaderFiles:{} SourceFiles:{} HostLibFiles:{} TargetLibFiles:{} IncPaths:{} SrcPaths:{} LibPaths:{}SampleTime: '继承' 选项:[1x1的结构]
为应用于现有C函数和打算生成的s函数的数据结构字段(属性)定义值。至少,您必须指定
现有C函数的源文件和头文件(源文件
和头文件
)
一种在S-函数名(sfunctionname.
)
S函数的至少一个功能规范(InitializeConditionsFcnSpec
那OutputFcnSpec
那startfcnspec.
那TerminateFcnSpec
)
有关完整列表,并在结构中的字段的说明,请参见legacy_code
功能参考页面。
如果定义字段指定编译资源并指定相对路径,遗留代码工具搜索相对于以下目录中的资源,按以下顺序:
当前工作文件夹
C-MEX S-function文件夹,如果与当前工作文件夹不同
您指定的目录
进入
的头文件
SrcPaths
的源文件
libpaths.
用于目标库和主机库
在MATLAB搜索路径上的目录,不包括工具箱目录
这InitializeConditionsFcnSpec
那OutputFcnSpec
那startfcnspec.
,TerminateFcnSpec
在传统代码工具数据结构字段定义(参见的描述legacy_code
功能)要求人物矢量值即坚持一个特定的语法格式。所需的句法格式使遗留代码工具到一个现有的C函数的返回值和参数映射到的返回值,输入,输出,参数和工作在S-功能,该工具产生的向量。
一般的语法
return-spec=函数名(argument-spec)
例如,下面的字符向量指定了一个名为doubleIt
与回报规范双y₁
和输入参数规范双u1
.
def.OutputFcnSpec = 'double y1 = doubleIt(double u1)';
有关声明函数规范的更多细节,请参见
返回规范定义了现有C函数的返回值的数据类型和变量名称。
返回式返回变量
|
列出的数据类型金宝app支持的数据类型. |
|
形式标记日元 那y2 那... 那y N,在那里N是输出参数的总数。 |
如果函数不返回一个值,你可以省略返回规范或将其指定为无效
.
下表显示了整数返回值的有效功能规范语法。使用表格标识您应该为C函数原型使用的语法。
返回类型 | C函数原型 | 遗留代码工具功能规范 |
---|---|---|
没有返回值 | 无效myfunction的(...) |
无效myfunction的(...) |
标值 | int = myfunction(…) |
y1 = myfunction(…) |
指定的函数名必须与现有的C函数名相同。
例如,考虑以下C函数原型:
浮doubleIt(浮动inVal);
在这种情况下,在遗留代码的工具功能规格功能名称必须是doubleIt
.
您不应该指定C宏的名称。如果必须,请设置该字段Options.isMacro
来真正的
在case表达式折叠是启用的。
实参规范定义了一个或多个数据类型和令牌对,它们表示现有C函数的输入、输出、参数和工作向量实参。函数的输入和输出参数映射到阻塞的输入和输出端口,参数映射到工作区参数。
参数类型参数令牌
|
列出的数据类型金宝app支持的数据类型. |
|
下列形式之一的令牌:
|
如果函数没有参数,则可以省略该参数指定或指定为无效
.
考虑以下C函数原型:
浮POWERIT(浮点inVal,INT指数);
要生成调用在每次步骤的S函数,请设置遗留代码工具数据结构字段OutputFcnSpec
如下:
'single y1 = powerIt(single u1, int16 p1)'
使用此功能规范,遗留代码工具映射以下信息。
返回值或参数 | C类型的 | 令牌 | 的数据类型 |
---|---|---|---|
返回值 | 漂浮 |
日元 |
单 |
inVal |
漂浮 |
u1 |
单 |
指数 |
㈡ |
p1 |
int16 |
如果您的函数需要具有多个输入和输出端口的Simulink金宝app S函数块,请使用唯一编号的映射到输入端口的函数参数你
令牌。对于输出端口,使用唯一编号y
令牌。这些标记在前面的参数说明表中进行了描述。例如,考虑以下C函数原型:
Void myfunc(double *y2, double u2, double u3, double u1, double *y1);
一个OutputFcnSpec
将参数映射到输入和输出端口的字符向量如下所示:
'void myfunc(双Y2 [1],双U2,双U3,双U1,双Y1 [1])'
得到的S函数块包括三个输入端口和两个输出端口。第一个输入映射到函数参数u1
,第二个输入u2
,第三个输入u3
.对于输出端口,函数参数Y1 [1]
地图到第一个输出和参数Y2 [1]
映射到第二个输出。有关将函数原型映射到多个输入和输出端口的另一个示例,请参见使用公交传统功能具有结构参数.
下表显示了Integer类型参数的有效功能规范语法。使用表识别,然后调整您应该为您的C函数原型使用的语法。
参数类型 | C函数原型 | 遗留代码工具功能规范 |
---|---|---|
输入参数 | ||
没有参数 | 函数(空白) |
函数(空白) |
标量通过值 | 函数(int三机一体) |
函数(int16 u1) |
标量指针传递 | 函数(INT * IN1) |
功能(Int16 U1 [1]) |
固定向量 | 函数(int in1 [10]) 或函数(INT * IN1) |
功能(Int16 U1 [10]) |
可变矢量 | 函数(int in1 []) 或函数(INT * IN1) |
函数(INT16 U1 []) |
固定矩阵 | 函数(int in1 [15]) 或函数(int in1 []) 或函数(INT * IN1) |
函数(INT16 U1 [3] [5]) |
变量矩阵 | 函数(int in1 []) 或函数(INT * IN1) |
函数(int16 u1 [] []) |
输出参数 | ||
标量指针 | 功能(int * y1) |
函数(int16 y1 [1]) |
固定向量 | 功能(int y1 [10]) 或功能(int * y1) |
函数(int16 y1 [10]) |
固定矩阵 | 函数(int y₁[15]) 或函数(int y₁[]) 或功能(int * y1) |
功能(Int16 Y1 [3] [5]) |
参数的参数 | ||
标量通过值 | 函数(int p1) |
函数(INT16 P1) |
标量指针传递 | 函数(int * p1) |
函数(INT16 P1 [1]) |
固定向量 | 函数(中间体P1 [10]) 或函数(int * p1) |
功能(INT16 P1 [10]) |
可变矢量 | 函数(int p1 []) 或函数(int * p1) |
功能(INT16 P1 []) |
固定矩阵 | 函数(int p1 [15]) 或函数(int p1 []) 或函数(int * p1) |
函数(int16 p1 [3] [5]) |
变量矩阵 | 函数(int p1 []) 或函数(int * p1) |
函数(int16 p1 [] []) |
工作参数向量 | ||
标量由价值传递 | 函数(int work1) |
函数(INT16 WORK1) |
标量指针 | 功能(int * work1) 功能(Void * Work1) 函数(void * * work1) |
函数(int16 work1 [1]) 无效的函数(void * work1) void函数(void * * work1) |
固定向量 | 功能(int work1 [10]) 或功能(int * work1) |
函数(int16 work1 [10]) |
固定矩阵 | 函数(int work1 [15]) 或函数(int work1 []) 或功能(int * work1) |
函数(int16 work1 [3] [5]) |
数据类型 | 金宝app支持输入和输出? | 金宝app支持的参数? | 金宝app支持工作导向? |
---|---|---|---|
Simulink支持的金宝app数据类型金宝app(除了字符串 ) |
是的 | 是的 | 是的 |
金宝appsimulink.bus. 1 |
是的 | 是的 | 是的 |
数组金宝appsimulink.bus. 2 |
是的 | 没有 | 是的 |
金宝app仿真软件。NumericType 3. |
是的 | 是的 | 是的 |
金宝app仿真软件。AliasType 1 |
是的 | 是的 | 是的 |
枚举 1 |
是的 | 是的 | 是的 |
固定点4. | 是的 | 是的 | 是的 |
网络对象 | N/A | 是的 | N/A |
复数5. | 是的 | 是的 | 是的 |
1-d阵列 | 是的 | 是的 | 是的 |
二维数组6. | 是的 | 是的 | 是的 |
N-D阵列7. | 是的 | 是的 | 是的 |
空白 * | 没有 | 没有 | 是的 |
void * * | 没有 | 没有 | 是的 |
您必须提供定义总线结构的头文件,定义枚举
型,或具有相同名称的别名定义的数据类型。在头文件中声明的总线的结构必须总线对象的结构相匹配(例如,数量和元素,数据类型和元素的宽度的顺序,等等)。例如,看到sldemo_lct_bus.
.
为了生成数据类型的对象和枚举类,对应于自定义数据类型的C代码定义中,使用金宝appSimulink.importExternalCTypes
函数。
总线元素可以复杂,但仅使用Simulink内置数据类型。金宝app还支持阵列到任何级别。金宝app
如果数值数据类型也是别名,则必须提供仅定义数据类型的头文件。
您必须将数据声明为金宝app仿真软件。NumericType
对象(不支持未指定的缩放)。金宝app对于例子,见sldemo_lct_fixpt_signals.
和sldemo_lct_fixpt_params
.
仅限于与Simulink内置数据类型一起金宝app使用。要指定复杂的数据类型,请在角括号(<>)中括内置数据类型并将其添加复杂的
(例如,复杂的双> <
)。例如,看到sldemo_lct_cplxgain
.
matlab,simul金宝appink,和金宝app仿真软件编码器下载188bet金宝搏产品以列主格式将多维数组数据存储为向量。如果您的外部函数代码是为行主数据编写的,请使用convertNDArrayToRowMajor
功能选项legacy_code
.
对于多维信号,可以使用尺寸
函数来确定信号中元素的数量。对于例子,见sldemo_lct_lut
和sldemo_lct_ndarray
.
有关更多信息,请参阅Simulink支持的金宝app数据类型金宝app.
规范的legacy_code
必须遵守以下规则:
如果参数不是标量,则必须通过引用传递参数。
输入,输出,参数,以及工作参数矢量令牌的编号必须从1开始,单调增加。
对于给定的Legacy Code Tool数据结构,其输入、输出、参数和工作矢量参数的数据类型和大小必须在不同的功能规范中相同startfcnspec.
那InitializeConditionsFcnSpec
那OutputFcnSpec
,TerminateFcnSpec
.
你可以使用以下表达式指定参数维度:
功能:numel.
那尺寸
参数值
运营商:+
那-
那*
,/
整数和浮点文字
括号分组子表达式
例如:
def.OutputFcnSpec = foo4(INT8 P1 [],INT8 U1 [],双Y1 [numel(U1)2] [numel(U1)3],... INT32(numel(P1)+ numel(U1))* 2 +大小(y1,2))';
要使用遗留代码工具集成C函数,该函数必须遵守以下规则:
函数不能改变输入参数的值。如果输入信号是通过引用传递给函数的参数,则函数不能修改参数所指向的数据。
该函数的返回值不能是一个指针。
功能规格,可以定义startfcnspec.
那InitializeConditionsFcnSpec
,或TerminateFcnSpec
不能访问的输入或输出参数。为了startfcnspec.
和InitializeConditionsFcnSpec
,如果使用S-Function选项,则可以访问输出端口outputsConditionallyWritten
被设定为真正的
.使用此选项设置,生成的S函数指定无法覆盖与每个输出端口关联的内存并是全局的(ss_not_reusable_and_global.
)。
为现有C函数注册遗留代码工具数据结构后,使用legacy_code
以下功能所解释的,以产生,编译和链接S-功能。
基于结构中定义的信息生成C MEX S函数。称呼legacy_code
和“sfcn_cmex_generate”
作为第一个参数和数据结构作为第二个参数的名称。
legacy_code (sfcn_cmex_generate, lct_spec);
编译和链接S-功能。此步骤假设一个C编译器为您的MATLAB安装。称呼legacy_code
和'编译'
作为第一个参数和数据结构作为第二个参数的名称。
legacy_code(“编译”,lct_spec);
类似于下面的信息消息出现在MATLAB命令窗口和一个动态可加载的可执行结果。在32位Windows系统上,Simulink软件为该文件命名金宝appex_sfun_doubleit.mexw32.
.
###开始编译EX_SFUN_DOUBLITIT MEX EX_SFUN_DOUBYIT.C -ID:\ WORK \ LCT \ LCT_DEMOS ###完成编译EX_SFUN_DOUBLITIT ###退出
作为方便,您可以通过调用在一步中生成,编译和链接S函数legacy_code
与字符矢量“generate_for_sim”
.该函数还生成一个TLC文件用于加速模拟,如果Options.useTlcWithAccel
遗留代码工具数据结构的字段设置为1。
生成动态可加载的可执行文件后,您或其他人可以通过添加指定编译的S函数的S函数块来在模型中使用它。
您可以选择使用Legacy Code Tool生成一个屏蔽的s -函数块(图形表示),该块被配置为调用生成的C MEX s -函数。要生成这样的块,调用legacy_code
和'slblock_generate'
作为第一个参数,遗留代码工具数据结构的名称作为第二个参数。
legacy_code( 'slblock_generate',lct_spec);
该工具掩盖了块,使其显示它的值OutputFcnSpec
场地。然后,您可以手动块添加到模型中。
如果你喜欢的遗留代码工具块自动添加到模型,指定模型作为第三个参数的名称。例如:
lct_spec legacy_code (' slblock_generate ', ' myModel ');
如果指定的模型(例如,mymodel.
)存在,legacy_code
打开模型,并增加了由传统代码工具的数据结构所描述的掩蔽S-功能块。如果模型不存在,该函数创建一个具有指定名称的新模式,并增加了屏蔽S-功能块。
如果您正在使用金宝app仿真软件加速器™模式下,可以生成并强制使用TLC内嵌代码通过遗留代码工具生成的S-功能。去做这个:
产生TLC块文件的s函数legacy_code
函数与'sfcn_tlc_generate'
作为第一个参数,遗留代码工具数据结构的名称作为第二个参数。
Legacy_code('sfcn_tlc_generate',lct_spec);
考虑一个例子将C功能集成到具有遗留代码工具的Simulink模型中金宝app.为了产生用于在该实施例的端部所示的模型中的TLC文件,输入以下命令:
legacy_code (sfcn_tlc_generate, def);
强制加速模式使用TLC文件ssSetOptions
酝酿
功能设置S-功能选项SS_OPTION_USE_TLC_WITH_ACCELERATOR
.
到初始化传统代码工具数据结构后调用一个旧的C ++函数,值“C ++”分配给Options.language
场地。例如,
DEF = legacy_code( '初始化');def.Options.language = 'C ++';
要验证新设置,请输入
def.Options.language
笔记
遗留代码工具可以用C ++函数接口,而不是C ++对象。对于周围的工作,看遗留代码工具的限制在Simuli金宝appnk文档。
您可以在同一个文件夹中有多个注册文件,并使用单个调用为每个文件生成一个S-functionlegacy_code
.同样,您可以使用单个调用legacy_code
为了编译和链接S函数,另一个是合适的,可以生成相应的TLC块文件。
看看下面的例子,其中lct_register_1
那lct_register_2
,lct_register_3
每个都创建和初始化遗留代码工具结构的字段。
defs1 = lct_register_1;defs2 = lct_register_2;defs3 = lct_register_3;DEFS = [defs1(:); defs2(:); defs3(:)];
然后,您可以使用以下调用序列legacy_code
为了基于三个注册文件生成文件:
Legacy_code('sfcn_cmex_generate',defs);Legacy_code('编译',defs);Legacy_code('sfcn_tlc_generate',defs);
或者,你可以分别处理每个注册文件。例如:
defs1 = lct_register1;legacy_code( 'sfcn_cmex_generate',defs1);legacy_code( '编译',defs1);legacy_code( 'sfcn_tlc_generate',defs1);...defs2 = lct_register2;legacy_code( 'sfcn_cmex_generate',defs2);legacy_code( '编译',defs2); legacy_code('sfcn_tlc_generate', defs2); . . . defs3 = lct_register3; legacy_code('sfcn_cmex_generate', defs3); legacy_code('compile', defs3); legacy_code('sfcn_tlc_generate', defs3);
您可以部署S-功能,您使用的遗留代码生成工具供他人使用。要部署用于模拟使用S-功能而已,你需要共享只编译动态加载的可执行文件。
要查看遗留代码工具的例子,在MATLAB命令窗口中,键入:
遗留代码工具的例子中列出建模功能>具有S函数,系统对象和遗留代码工具的自定义块.
遗留代码的工具
为用C或c++编写的现有函数生成C MEX s -函数。该工具不支持MATLAB或Fortr金宝appan函数的转换。
可以与c++函数接口,但不能与c++对象接口。解决这个限制的一种方法是使用S-Function Builder生成s -函数的外壳,然后从s -函数调用遗留c++代码mdlOutputs
回调函数。
不支持模拟连续或不金宝app连续的状态。这可以防止使用mdlUpdate
和mdlDerivatives
回调函数。如果您的应用程序需要这种支持,请参见金宝app使用S-Function Builder结合遗留代码.
始终设置S函数标志直接馈通(尺寸.DirfeedThrough.
)真正的
.由于这个设置和前面的限制,生成的s函数不能被打破代数循环.
金宝app只支持连续的,而是固定在较小的时间步长,采样时间和偏移量选项。
金宝app支持复数,但仅限于Simulink金宝app内置数据类型.
不支持使用函数指针金宝app作为传统功能的输出被调用。
不支持下面的S-功金宝app能特点:
功向量,除了一般的功向量
基于帧的输入和输出信号
基于端口的样本时间
多个基于块的样本时间
不支持使用范围(:金宝app:)操作符访问c++类数据和方法。对于静态方法,你可以编写简单的预处理器宏,类似如下:
#定义CCommon_computeVectorDotProduct CCommon :: computeVectorDotProduct
可以生成终止功能,当你没有指定一个如果函数规范包括具有属性的Simulink数据类型金宝appHeaderFile
.对于导出函数模型,terminate函数会使生成的s函数与代码生成不兼容。