在遗留函数中实现的查找表
此示例向您展示如何使用遗留代码工具集成实现n维表查找的遗留C函数。
遗留代码工具允许您:
提供遗留功能规范,
生成在模拟期间用于调用遗留代码的C-MEX s函数,以及
编译并构建生成的s函数进行仿真。
提供遗留功能规范
遗留代码工具提供的函数以特定的数据结构或结构数组作为参数。通过使用'initialize'作为第一个输入调用函数legacy_code()来初始化数据结构。在初始化结构之后,必须将其属性分配给与正在集成的遗留代码相对应的值。在这个例子中被调用的遗留函数的原型是:
FLT directLookupTableND(const FLT *tableND, const UINT32 nbDims, const UINT32 *tableDims, const UINT32 *tableIdx)
FLT是float的类型定义,UINT32是unsigned int32的类型定义。遗留源代码可以在文件中找到your_types.h
,lookupTable.h
,directLookupTableND.c
.
Defs = [];evalin (“基地”,“负载sldemo_lct_data.mat”)% sldemo_sfun_dlut3DDef = legacy_code(“初始化”);def.SFunctionName =“sldemo_sfun_dlut3D”;def.OutputFcnSpec ='single y1 = DirectLookupTable3D(single p1[][][], uint32 p2[3], uint32 u1[3])';def.HeaderFiles = {“lookupTable.h”};def.SourceFiles = {“directLookupTableND.c”};def.IncPaths = {“sldemo_lct_src”};def.SrcPaths = {“sldemo_lct_src”};Defs = [Defs;def);% sldemo_sfun_dlut4DDef = legacy_code(“初始化”);def.SFunctionName =“sldemo_sfun_dlut4D”;def.OutputFcnSpec ='single y1 = DirectLookupTable4D(single p1[][][][], uint32 p2[4], uint32 u1[4])';def.HeaderFiles = {“lookupTable.h”};def.SourceFiles = {“directLookupTableND.c”};def.IncPaths = {“sldemo_lct_src”};def.SrcPaths = {“sldemo_lct_src”};Defs = [Defs;def);
生成和编译用于仿真的s函数
函数legacy_code()在第一个输入设置为'generate_for_sim'时再次被调用,以便根据输入参数'defs'提供的描述自动生成和编译C-MEX s -函数。这个s函数用于在模拟中调用遗留函数。s函数的源代码可以在文件中找到sldemo_sfun_dlut3D.c
和sldemo_sfun_dlut4D.c
.
legacy_code (“generate_for_sim”def);
开始编译sldemo_sfun_dlut3D mex('-I/tmp/Bdoc22a_1891349_109701/tpd478fb9a/ex11439596/sldemo_lct_src', '-I/tmp/Bdoc22a_1891349_109701/tpd478fb9a/ex11439596/ ex11439596/sldemo_lct_src', '-c', '-outdir', '/tmp/Bdoc22a_1891349_109701/tp6fd98ce3_f0ac_4a6e_a29e_888beabfc46a', '/tmp/Bdoc22a_1891349_109701/tpd478fb9a/ex11439596/sldemo_lct_src/directLookupTableND.c')使用'gcc'构建。MEX完成成功。mex(' sldemo_sfun_dlut3dc ', '-I/tmp/Bdoc22a_1891349_109701/tpd478fb9a/ex11439596/sldemo_lct_src', '-I/tmp/Bdoc22a_1891349_109701/tpd478fb9a/ex11439596', '/tmp/Bdoc22a_1891349_109701/tp6fd98ce3_f0ac_4a6e_a29e_888beabfc46a/directLookupTableND.o')使用'gcc'构建。MEX完成成功。开始编译sldemo_sfun_dlut4D mex('-I/tmp/Bdoc22a_1891349_109701/tpd478fb9a/ex11439596/sldemo_lct_src', '-I/tmp/Bdoc22a_1891349_109701/tpd478fb9a/ex11439596/ ex11439596/sldemo_lct_src', '-c', '-outdir', '/tmp/Bdoc22a_1891349_109701/tp58d05e30_b176_4ae0_aaa7_9279f626a622', '/tmp/Bdoc22a_1891349_109701/tpd478fb9a/ex11439596/sldemo_lct_src/directLookupTableND.c')使用'gcc'构建。MEX完成成功。(' sldemo_sfun_dlut4dc ', '-I/tmp/Bdoc22a_1891349_109701/tpd478fb9a/ex11439596/sldemo_lct_src', '-I/tmp/Bdoc22a_1891349_109701/tpd478fb9a/ex11439596', '/tmp/Bdoc22a_1891349_109701/tp58d05e30_b176_4ae0_aaa7_9279f626a622/directLookupTableND.o')使用'gcc'构建。MEX完成成功。完成sldemo_sfun_dlut4D的编译
生成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', defs);
集成遗留代码
该模型sldemo_lct_lut
显示与遗留代码的集成。子系统TestFixpt充当了对遗留C函数的调用的控制,并且Display块将函数的输出与内置Simulink®查找块的输出进行比较;金宝app结果是相同的。
open_system (“sldemo_lct_lut”) open_system (“sldemo_lct_lut / TestLut1”) sim卡(“sldemo_lct_lut”);