集成实现 N 维表查找的外部 C 函数

通过使用代码继承工具，集成实现 N 维表查找的已有 C 函数。

使用代码继承工具，您可以：

提供已有函数设定。
生成在仿真过程中调用现有代码的 C-MEX S-Function。
编译生成的 S-Function 以进行仿真。
生成 TLC 模块文件和可选的 rtwmakecfg.m 文件，该文件指定针对模型生成的代码如何调用现有代码。

提供已有函数设定

代码继承工具函数接受特定的数据结构体或结构体数组作为参数。您可以通过调用函数 legacy_code() 并使用 'initialize' 作为第一个输入来初始化数据结构体。初始化结构体之后，将其属性指定给与要集成的现有代码对应的值。此示例中调用的已有函数的原型为：

FLT directLookupTableND(const FLT *tableND, const UINT32 nbDims, const UINT32 *tableDims, const UINT32 *tableIdx)

FLT 是浮点类型的 typedef，UINT32 是无符号 int32 类型的 typedef。已有源代码位于文件 your_types.h、lookupTable.h 和 directLookupTableND.c 中。

defs = [];
evalin('base','load rtwdemo_lct_data.mat')

% rtwdemo_sfun_dlut3D
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_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      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};
defs = [defs; def];

% rtwdemo_sfun_dlut4D
def = legacy_code('initialize');
def.SFunctionName = 'rtwdemo_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      = {'rtwdemo_lct_src'};
def.SrcPaths      = {'rtwdemo_lct_src'};
defs = [defs; def];

生成 S-Function 以进行仿真

要根据输入参数 'defs' 提供的描述生成 C-MEX S-Function，请再次调用函数 legacy_code()。将第一个输入设置为 'sfcn_cmex_generate'。S-Function 将在仿真过程中调用已有函数。S-Function 的源代码位于文件 rtwdemo_sfun_dlut3D.c 和 rtwdemo_sfun_dlut4D.c 中。

legacy_code('sfcn_cmex_generate', defs);

编译生成的 S-Function 以进行仿真

在生成 C-MEX S-Function 源文件之后，要使用 Simulink® 编译 S-Function 进行仿真，请再次调用函数 legacy_code()。将第一个输入设置为 'compile'。

legacy_code('compile', defs);

### Start Compiling rtwdemo_sfun_dlut3D
    mex('-I/mathworks/devel/bat/Bdoc23a/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/Bdoc23a_2181783_2675014/tp23db1089/simulinkcoder-ex19426386', '-c', '-outdir', '/tmp/Bdoc23a_2181783_2675014/tpabb6eb8f_a4b2_4ca1_ab89_e5ba688b5ad0', '/mathworks/devel/bat/Bdoc23a/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/directLookupTableND.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_dlut3D.c', '-I/mathworks/devel/bat/Bdoc23a/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/Bdoc23a_2181783_2675014/tp23db1089/simulinkcoder-ex19426386', '/tmp/Bdoc23a_2181783_2675014/tpabb6eb8f_a4b2_4ca1_ab89_e5ba688b5ad0/directLookupTableND.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_dlut3D
### Exit

### Start Compiling rtwdemo_sfun_dlut4D
    mex('-I/mathworks/devel/bat/Bdoc23a/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/Bdoc23a_2181783_2675014/tp23db1089/simulinkcoder-ex19426386', '-c', '-outdir', '/tmp/Bdoc23a_2181783_2675014/tp5eb18f08_81e2_4e1f_953b_35c0492caf5a', '/mathworks/devel/bat/Bdoc23a/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/directLookupTableND.c')
Building with 'gcc'.
MEX completed successfully.
    mex('rtwdemo_sfun_dlut4D.c', '-I/mathworks/devel/bat/Bdoc23a/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/Bdoc23a_2181783_2675014/tp23db1089/simulinkcoder-ex19426386', '/tmp/Bdoc23a_2181783_2675014/tp5eb18f08_81e2_4e1f_953b_35c0492caf5a/directLookupTableND.o')
Building with 'gcc'.
MEX completed successfully.
### Finish Compiling rtwdemo_sfun_dlut4D
### Exit

生成 TLC 模块文件以进行代码生成

编译 S-Function 并将其用于仿真之后，您可以再次调用函数 legacy_code()。将第一个输入设置为 'sfcn_tlc_generate' 以生成 TLC 模块文件。模块文件指定为模型生成的代码如何调用现有代码。如果您不生成 TLC 模块文件，则当您尝试为包含 S-Function 的模型生成代码时，代码生成将失败。S-Function 的 TLC 模块文件为 rtwdemo_sfun_dlut3D.tlc 和 rtwdemo_sfun_dlut4D.tlc。

legacy_code('sfcn_tlc_generate', defs);

生成 rtwmakecfg.m 文件以进行代码生成

创建 TLC 模块文件之后，您可以再次调用函数 legacy_code()。将第一个输入设置为 'rtwmakecfg_generate'，以生成支持代码生成的 rtwmakecfg.m 文件。如果 S-Function 需要的源文件和头文件与 S-Function 不在同一个文件夹中，而您要将这些相关文件添加到代码生成过程中生成的联编文件中，请生成 rtwmakecfg.m 文件。

legacy_code('rtwmakecfg_generate', defs);

生成封装的 S-Function 模块以调用生成的 S-Function

在编译 C-MEX S-Function 源之后，您可以再次调用函数 legacy_code()。将第一个输入设置为 'slblock_generate'，以生成封装的 S-Function 模块来调用 S-Function。软件将模块放在新模型中。您可以将模块复制到现有模型中。

legacy_code('slblock_generate', defs);

显示生成的与现有代码的集成

模型 rtwdemo_lct_lut 显示了模型与现有代码的集成。子系统 TestFixpt 的作用相当于调用已有 C 函数的工具，Display 模块将函数输出与内置 Simulink® 查找模块的输出进行比较。结果相同。

open_system('rtwdemo_lct_lut')
open_system('rtwdemo_lct_lut/TestLut1')
sim('rtwdemo_lct_lut')

另请参阅

legacy_code