概述

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

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

与遗留代码工具互动，您

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

如果你有金宝appSimulink编码器产品许可证，见使用遗留代码工具将外部代码调用导入生成的代码中（金宝appSimulink编码器）有关使用用于代码生成的传统代码工具的信息。

将C函数集成到金宝app具有遗留代码工具的模型

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

假设您有一个C函数，输出其浮点输入的值乘以两个。该函数在命名的源文件中定义DoubleIt.c.，其声明存在于名为的标题文件中普通的．

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

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

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

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

#include“ex_mytypes_lct.h”void myfcn（sigtracttype * in，paramstrugtype * params，sigutructrype * 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;void myFcn(sigStructType *in, paramStructType *params, sigStructType *out);# endif

金宝appsimulink.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（sigutrytype u1 [1]，'那......' p1[1]， sigStructType y1[1])']；

Legacy_code（'generate_for_sim'def);

###开始编译sfun_ex_mySrc_LCT MEX（ ' - 我的/ tmp / Bdoc21a_1606923_4327 / tp74b21f37 / ex12763634'， '-c'， '-outdir'， '/ tmp目录/ Bdoc21a_1606923_4327 / tpe42d0b74_ef8c_4935_abf7_acb59a328c05'，“/ tmp目录/ Bdoc21a_1606923_4327 / tp74b21f37 / ex12763634 /ex_mysrc_lct.c'）建立'gcc'。MEX成功完成。Mex（'sfun_ex_mysrc_lct.c'，'-i / tmp / bdoc21a_1606923_4327 / tp74b21f37 / ex12763634'，'/ tmp/bdoc21a_1606923_4327/tpe42d0b74_ef8c_4935_abf7_acb59a328c05/ex_mysrc_lct.o'）建立'gcc'。MEX成功完成。###完成编译sfun_ex_mysrc_lct ###退出

Legacy_code（“slblock_generate”def);

open_system ('ex_lct_struct'）

structparam = struct;structparam.param1 = 15;structparam.param2 = 20;structparam.param3 = 5;

structparam = 金宝appsimulink.parameter（structparam）;structparam.datatype ='总线：Paramstructtype';

set_param (“ex_lct_struct / sfun_ex_mySrc_LCT”那'sparameter1'那'structparam'）

open_system ('ex_lct_struct / scope'）Open_System（'ex_lct_struct / scope1'）sim（'ex_lct_struct'）％

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

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

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

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

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

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

一般语法

返回规范=函数名（论证规范）

例如，以下字符向量指定命名的函数挖与回报规范双Y1和输入参数规范双重U1．

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

有关声明功能规范的更多详细信息，请参阅

• 返回规格

• 函数名

• 论证规范

• 金宝app支持的数据类型

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

• 遗留C函数规则

返回类型返回变量

浮动doubleIt (inVal浮动);

参数类型参数令牌

float powerIt(float inVal, int exponent);

'单个Y1 = PowerIt（单个U1，INT16 P1）'

void myfunc（双* y2，双U2，双U3，双U1，双* Y1）;

'void myfunc（双Y2 [1]，双U2，双U3，双U1，双Y1 [1]）'

生成和编译s函数

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

作为方便，您可以通过调用在一步中生成，编译和链接S函数lefacy_code.与字符矢量'generate_for_sim'．该函数还为加速模拟生成TLC文件，如果是options.usetlcwithaccel.遗留代码工具数据结构的字段设置为1。

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

生成屏蔽的S函数块，用于调用生成的S函数

您可以选择使用遗留代码工具生成被配置为调用生成的C MEX S函数的屏蔽的S函数块（图形表示）。生成这样的块，呼叫lefacy_code.与“slblock_generate”作为第一个参数和遗留代码工具数据结构的名称作为第二个参数。

legacy_code (slblock_generate, lct_spec);

该工具掩盖了块，使其显示它的值OutputFcnSpec字段。然后您可以手动将块添加到模型中。

如果您希望遗留代码工具自动将块添加到模型中，请指定模型的名称作为第三个参数。例如:

Legacy_code（'slblock_generate'，lct_spec，'mymodel'）;

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

强迫金宝app加速器模式使用S函数TLC内联代码

如果你正在使用金宝appSimulink Accelerator™模式下，您可以为遗留代码工具生成的s函数生成并强制使用TLC内联代码。要做到这一点:

呼叫遗留C ++函数

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

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

要验证新设置，请输入

def.options.language.

处理多个注册文件

您可以在同一文件夹中具有多个注册文件，并为每个文件生成一个单个文件的S函数lefacy_code.．同样，您可以使用单个呼叫lefacy_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 (:));

然后，您可以使用以下调用序列lefacy_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函数以供其他工具使用。要部署用于模拟使用的S函数，您只需要仅共享编译的动态可加载的可执行文件。

遗留代码工具示例

有关遗留代码工具的示例，请参阅使用遗留代码工具实现算法．

遗留代码工具限制

遗留代码工具