主要内容

遗留函数中的定点参数

此示例向您展示如何使用遗留代码工具集成遗留C函数,这些函数使用定点数据类型的参数传递输入和输出。

遗留代码工具允许您:

  • 提供遗留功能规范,

  • 生成在模拟期间用于调用遗留代码的C-MEX s函数,以及

  • 编译并构建生成的s函数进行仿真。

提供遗留功能规范

遗留代码工具提供的函数以特定的数据结构或结构数组作为参数。通过使用'initialize'作为第一个输入调用函数legacy_code()来初始化数据结构。在初始化结构之后,必须将其属性分配给与正在集成的遗留代码相对应的值。在这个例子中被调用的遗留函数的原型是:

(const myFixpt in1, const myFixpt in2, const uint8_T fracLength)

其中myFixpt逻辑上是一个定点数据类型,物理上是一个16位整数的类型定义:

myFixpt = 金宝appSimulink.NumericType;myFixpt。DataTypeMode =“定点:二进制点缩放”;myFixpt。Signed = true;myFixpt。WordLength = 16;myFixpt。FractionLength = 10;myFixpt。IsAlias = true;myFixpt。HeaderFile =“timesFixpt.h”

遗留源代码可以在文件中找到timesFixpt.h,timesS16.c

% sldemo_sfun_gain_fixptDef = legacy_code(“初始化”);def.SFunctionName =“sldemo_sfun_gain_fixpt”;def.OutputFcnSpec ='myFixpt y1 = timesS16(myFixpt u1, myFixpt p1, uint8 p2)';def.HeaderFiles = {“timesFixpt.h”};def.SourceFiles = {“timesS16.c”};def.IncPaths = {“sldemo_lct_src”};def.SrcPaths = {“sldemo_lct_src”};

生成和编译用于仿真的s函数

函数legacy_code()在第一个输入设置为'generate_for_sim'时再次被调用,以便根据输入参数'def'提供的描述自动生成和编译C-MEX s -函数。这个s函数用于在模拟中调用遗留函数。s函数的源代码可以在文件中找到sldemo_sfun_gain_fixpt.c

legacy_code (“generate_for_sim”def);
开始编译sldemo_sfun_gain_fixpt mex('-I/tmp/Bdoc22b_2134332_1863673/tpaaa09c79/simulink_feature金宝apps-ex52665162/sldemo_lct_src', '-I/tmp/Bdoc22b_2134332_1863673/tpaaa09c79/simulink_features-ex52665162', '-c', '-outdir', '/tmp/Bdoc22b_2134332_1863673/tp7f79b671_7090_458d_b8b8_858a82fda9f2', '/tmp/Bdoc22b_2134332_1863673/tpaaa09c79/simulink_features-ex52665162/sldemo_lct_src/timesS16.c')使用'gcc'构建。MEX完成成功。mex('sldemo_sfun_gain_fixpt.c', '-I/tmp/Bdoc22b_2134332_1863673/tpaaa09c79/金宝app simulink_featus52665162 /sldemo_lct_src', '-I/tmp/Bdoc22b_2134332_1863673/tpaaa09c79/ simulink_featusex52665162 ', '/tmp/Bdoc22b_2134332_1863673/tp7f79b671_7090_458d_b8b8_858a82fda9f2/timesS16.o')使用'gcc'构建。MEX完成成功。结束编译sldemo_sfun_gain_fixpt

生成rtwmakecfg。m文件代码生成

TLC块文件创建后,函数legacy_code()可以再次调用,第一个输入设置为'rtwmakecfg_generate',以生成rtwmakecfg。m文件通过Simul金宝appink®Coder™支持代码生成。金宝app生成rtwmakecfg。如果s -函数所需的源文件和头文件与s -函数不在同一个目录中,并且您希望在代码生成期间生成的makefile中添加这些依赖项,则使用m文件。

注意:仅当您打算在加速模式下模拟模型时,才需要完成此步骤。

legacy_code (“rtwmakecfg_generate”def);

生成屏蔽s函数块,用于调用生成的s函数

编译C-MEX s -函数源后,可以再次调用函数legacy_code(),并将第一个输入设置为'slblock_generate',以生成一个被配置为调用该s -函数的屏蔽s -函数块。块被放置在一个新的模型中,并且可以复制到一个现有的模型中。

% legacy_code('slblock_generate', def);

与遗留代码集成

该模型sldemo_lct_fixpt_params显示与遗留代码的集成。子系统TestFixpt充当了通过生成的s函数调用遗留C函数的工具。

open_system (“sldemo_lct_fixpt_params”) open_system (“sldemo_lct_fixpt_params / TestFixpt”) sim卡(“sldemo_lct_fixpt_params”
ans = 金宝appSimulink。SimulationOutput: yout: [101x4 double] SimulationMetadata: [1x1 金宝appSimulink。SimulationMetadata] ErrorMessage: [0x0 char]

另请参阅