概述

您可以集成现有的C（或C ++）函数，例如设备驱动程序，查找表和常规功能以及接口，进入Simulink万博1manbetx^®通过使用遗留代码工具建立模型。使用规范，你提供作为MATLAB^®代码时，该工具将现有函数转换为可以包含在Simulink模型中的C MEX s -函数。万博1manbetx如果你使用万博1manbetx仿真软件编码器™为了生成代码，Legacy code Tool可以在生成的代码中插入对C函数的适当调用。有关详细信息,请参见使用遗留代码工具将外部代码调用导入生成的代码中(万博1manbetx仿真软件编码器)。

与使用S-Function Builder或编写S-Function相比，Legacy Code Tool更容易使用和生成嵌入式系统经常需要的优化代码(不生成包装器代码)。但是，考虑混合系统的替代方法，比如包含设备和控制器的系统，或者用C或c++以外的语言编写的系统组件。可选方法更灵活，因为它们支持更多特性和编程语言。万博1manbetx

与遗留代码工具互动，您

下图说明了使用遗留代码工具的一般过程。使用遗留代码工具将C函数集成到Simulink模型中万博1manbetx提供了一个使用遗留代码工具将现有C函数转换为C MEX s函数的示例。

如果你有万博1manbetxSimulink编码器产品许可,请参阅使用遗留代码工具将外部代码调用导入生成的代码中(万博1manbetxSimulink Coder)以获取有关使用遗留代码工具进行代码生成的信息。

将C函数集成到万博1manbetx使用遗留代码工具的模型

此示例演示了如何使用遗留代码工具将现有的C函数集成到Simulink模型中。万博1manbetx

假设您有一个C函数，输出其浮点输入值乘以2。函数定义在一个名为doubleIt.c，它的声明存在于名为doubleIt.h．

集成C函数，其参数是指向结构体的指针

此示例演示如何使用遗留代码工具集成参数为结构指针的C函数。

在Si万博1manbetxmulink®中，创建万博1manbetx仿真软件。公共汽车对象来表示结构类型。在模型中使用总线信号来表示结构化信号和状态。在工作空间或块参数对话框中创建MATLAB结构来表示参数结构。

有关总线信号的基本信息，请参阅虚拟总线．参数结构的基本信息请参见组织结构中的相关块参数定义．要创建总线对象，请参见创建和指定Simulink。万博1manbetx总线对象．

#包括“ex_myTypes_LCT.h”void myFcn（sigStructType*in，paramStructType*params，sigStructType*out）{out->sig1=in->sig1*params->param1；out->sig2=in->sig2*params->param2+params->param3；}

#ifndef _MY_TYPES_H_ #define _MY_TYPES_H_ typedef struct {double sig1;双sig2;} sigStructType;Typedef struct {double param1;双param2;双param3;} paramStructType;# endif

万博1manbetxSimulink.importExternalCTypes (“ex_myTypes_LCT.h”）;

def = legacy_code (“初始化”）;

def.SFunctionName =“sfun_ex_mySrc_LCT”;

def.SourceFiles = {“ex_mySrc_LCT.c”};def.headerfiles = {“ex_myTypes_LCT.h”};

def.outputfcnspec = ['void myFcn(sigStructType u1[1]， '),．..' p1[1]， sigStructType y1[1])'］；

lefacy_code（“generate_for_sim”def);

### Start Compiling sfun_ex_mySrc_LCT mex('-I/tmp/Bdoc20a_1326390_37563/tpf4655909/ex12763634'， '-c'， '/tmp/Bdoc20a_1326390_37563/tp671d9063_cbd5_4336_bb64_60d2089e45fe'， '/tmp/Bdoc20a_1326390_37563/tpf4655909/ex12763634/ex_mySrc_LCT.c') Building with 'gcc'. ### ##启动编译sfun_ex_mySrc_LCT ('-I/tmp/Bdoc20a_1326390_37563/tpf4655909/ex12763634 / ex_mysrc_lct ')墨西哥人成功完成。/tmp/Bdoc20a_1326390_37563/tpf4655909/ex12763634'， '/tmp/Bdoc20a_1326390_37563/tp671d9063_cbd5_4336_bb64_60d2089e45fe/ ex_mysrc_ltc .o')/tmp/Bdoc20a_1326390_37563/tpf4655909/ex12763634/ sfun_ex_mysrc_lcc .c: In function ' mdlOutputs ': /tmp/Bdoc20a_1326390_37563/tpf4655909/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的编译

lefacy_code（“slblock_generate”def);

open_system (“ex_lct_struct”)

structParam =结构;structParam。Param1 = 15; structParam.param2 = 20; structParam.param3 = 5;

structparam = 万博1manbetxsimulink.parameter（structparam）;structparam.datatype =“巴士:paramStructType”;

set_param (“ex_lct_struct / sfun_ex_mySrc_LCT”,“SParameter1”,“structParam”)

open_system (“ex_lct_struct /范围”）Open_System（'ex_lct_struct / scope1')模拟(“ex_lct_struct”)

ans =仿万博1manbetx真软件。SimulationMetadata: [1x1 Simulink. out: out: [51x1 double]万博1manbetxSimulationMetadata]错误信息:[0x0 char]

注册遗留代码工具数据结构

使用遗留代码工具的第一步是注册一个或多个MATLAB结构，其中字段表示现有C代码的属性和正在生成的S函数。注册过程是灵活的。您可以选择设置资源并以各种方式启动注册，包括

要注册遗留代码工具的数据结构:

如果您定义了指定编译资源的字段并指定了相对路径，那么Legacy Code Tool将按照以下顺序搜索与以下目录相关的资源:

声明遗留代码工具功能规范

这个InitializeConditionsFcnSpec,OutputFcnSpec,StartFcnSpec,TerminateFcnSpec字段定义在遗留代码工具数据结构中(请参阅legacy_code函数)要求符合特定语法格式的字符向量值。所需的语法格式使Legacy Code工具能够将现有C函数的返回值和参数映射到工具生成的s函数的返回值、输入、输出、参数和工作向量。

一般的语法

return-spec=函数名(argument-spec)

例如，下面的字符向量指定了一个名为doubleIt与回报规范双y₁和输入参数规范双重U1．

def.outputfcnspec ='double y1 = dubpit（double u1）';

有关声明函数规范的更多细节，请参见

• 退货规格

• 函数名

• 论证规范

• 万博1manbetx支持的数据类型

• 遗留代码工具功能规范规则

• 遗留C函数规则

返回类型返回变量

浮动doubleIt (inVal浮动);

参数类型argument-token

float powerIt(float inVal, int exponent);

'single y1 = powerIt(single u1, int16 p1)'

Void myfunc(double *y2, double u2, double u3, double u1, double *y1);

'无效myfunc（双y2[1]，双u2，双u3，双u1，双y1[1]）'

生成和编译s函数

注册现有C函数的遗留代码工具数据结构后，使用legacy_code函数来生成、编译和链接s函数。

为了方便起见，您可以通过调用legacy_code使用字符向量“generate_for_sim”．该函数还为加速模拟生成TLC文件，如果是Options.useTlcWithAccel旧代码工具数据结构的字段设置为1。

生成可动态加载的可执行文件后，您或其他人可以通过添加指定已编译S函数的S函数块在模型中使用它。

生成用于调用生成的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 ');

如果指定的模型（例如，我的模型）存在，legacy_code打开模型并添加遗留代码工具数据结构描述的屏蔽的S函数块。如果模型不存在，则该函数将创建具有指定名称的新模型，并添加屏蔽的S函数块。

迫使万博1manbetx加速器使用s -函数TLC内联代码的模式

如果你正在使用万博1manbetx仿真软件加速器™模式下，您可以为遗留代码工具生成的s函数生成并强制使用TLC内联代码。要做到这一点:

呼叫遗留C ++函数

要在初始化遗留代码工具数据结构后调用遗留c++函数，将值' c++ '赋给Options.language字段。例如,

def = legacy_code(“初始化”);def.Options.language =“c++”;

要验证新设置，请输入

def.Options.language

处理多个注册文件

您可以在同一个文件夹中有多个注册文件，并使用单个调用为每个文件生成一个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;def = [defs1 (:); defs2 (:); defs3 (:));

然后，您可以使用以下调用序列legacy_code为了基于三个注册文件生成文件：

legacy_code (sfcn_cmex_generate, def);legacy_code(“编译”,def);legacy_code (sfcn_tlc_generate, def);

或者，您可以分别处理每个注册文件。例如:

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-Functions

您可以部署使用遗留代码工具生成的s -函数，以供他人使用。要部署仅供模拟使用的s函数，您只需要共享已编译的可动态加载的可执行文件。

遗留代码工具示例

要查看遗留代码工具的示例，在MATLAB命令窗口中，输入:

演示模型万博1manbetx

遗留代码工具示例列于建模功能>带有S函数、系统对象和遗留代码工具的自定义块．

遗留代码工具的限制

遗留代码的工具