集成以定点数据类型的形参方式传递输入和输出实参的外部 C 函数
使用代码继承工具,集成通过使用定点数据类型的参数来传递输入和输出的已有 C 函数。
使用代码继承工具,您可以:
提供已有函数设定。
生成在仿真过程中调用现有代码的 C-MEX S-Function。
编译生成的 S-Function 以进行仿真。
生成 TLC 模块文件和可选的 rtwmakecfg.m 文件,该文件指定针对模型生成的代码如何调用现有代码。
提供已有函数设定
代码继承工具函数接受特定的数据结构体或结构体数组作为参数。您可以通过调用函数 legacy_code() 并使用 'initialize' 作为第一个输入来初始化数据结构体。初始化结构体之后,将其属性指定给与要集成的现有代码对应的值。此示例中调用的已有函数的原型为:
myFixpt timesS16(const myFixpt in1, const myFixpt in2, const uint8_T fracLength)
myFixpt 逻辑上是定点数据类型,实际上是 16 位整数的 typedef:
myFixpt = Simulink.NumericType; myFixpt.DataTypeMode = 'Fixed-point: binary point scaling'; myFixpt.Signed = true; myFixpt.WordLength = 16; myFixpt.FractionLength = 10; myFixpt.IsAlias = true; myFixpt.HeaderFile = 'timesFixpt.h';
已有源代码位于文件 timesFixpt.h 和 timesS16.c 中。
% rtwdemo_sfun_gain_fixpt def = legacy_code('initialize'); def.SFunctionName = 'rtwdemo_sfun_gain_fixpt'; def.OutputFcnSpec = 'myFixpt y1 = timesS16(myFixpt u1, myFixpt p1, uint8 p2)'; def.HeaderFiles = {'timesFixpt.h'}; def.SourceFiles = {'timesS16.c'}; def.IncPaths = {'rtwdemo_lct_src'}; def.SrcPaths = {'rtwdemo_lct_src'};
生成 S-Function 进行仿真
要根据输入参数 'def' 提供的描述生成 C-MEX S-Function,请再次调用函数 legacy_code() 并将第一个输入设置为 'sfcn_cmex_generate'。S-Function 将在仿真过程中调用已有函数。S-Function 的源代码位于文件 rtwdemo_sfun_gain_fixpt.c 中。
legacy_code('sfcn_cmex_generate', def);
编译生成的 S-Function 进行仿真
在生成 C-MEX S-Function 源文件之后,要使用 Simulink® 编译 S-Function 进行仿真,请再次调用函数 legacy_code() 并将第一个输入设置为 'compile'。
legacy_code('compile', def);
### Start Compiling rtwdemo_sfun_gain_fixpt mex('-I/mathworks/devel/bat/Bdoc23a/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/Bdoc23a_2181783_2675283/tpf950142d/simulinkcoder-ex05928773', '-c', '-outdir', '/tmp/Bdoc23a_2181783_2675283/tp1a01892f_1fdd_4a66_a978_fbbf72e97d13', '/mathworks/devel/bat/Bdoc23a/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src/timesS16.c') Building with 'gcc'. MEX completed successfully. mex('rtwdemo_sfun_gain_fixpt.c', '-I/mathworks/devel/bat/Bdoc23a/build/matlab/toolbox/rtw/rtwdemos/rtwdemo_lct_src', '-I/tmp/Bdoc23a_2181783_2675283/tpf950142d/simulinkcoder-ex05928773', '/tmp/Bdoc23a_2181783_2675283/tp1a01892f_1fdd_4a66_a978_fbbf72e97d13/timesS16.o') Building with 'gcc'. MEX completed successfully. ### Finish Compiling rtwdemo_sfun_gain_fixpt ### Exit
生成 TLC 模块文件以进行代码生成
编译 S-Function 并将其用于仿真之后,您可以再次调用函数 legacy_code()。将第一个输入设置为 'sfcn_tlc_generate',以生成 TLC 模块文件。该模块文件指定为模型生成的代码如何调用现有代码。如果您不生成 TLC 模块文件,则当您尝试为包含 S-Function 的模型生成代码时,代码生成将失败。S-Function 的 TLC 模块文件为 rtwdemo_sfun_gain_fixpt.tlc。
legacy_code('sfcn_tlc_generate', def);
生成 rtwmakecfg.m 文件以进行代码生成
创建 TLC 模块文件之后,您可以再次调用函数 legacy_code()。将第一个输入设置为 'rtwmakecfg_generate',以生成支持代码生成的 rtwmakecfg.m 文件。如果 S-Function 需要的源文件和头文件与 S-Function 不在同一个文件夹中,而您要将这些相关文件添加到代码生成过程中生成的联编文件中,请生成 rtwmakecfg.m 文件。
legacy_code('rtwmakecfg_generate', def);
生成封装的 S-Function 模块以调用生成的 S-Function
在编译 C-MEX S-Function 源之后,您可以再次调用函数 legacy_code()。将第一个输入设置为 'slblock_generate',以生成封装的 S-Function 模块来调用该 S-Function。软件将此模块放在新模型中。您可以将此模块复制到现有模型中。
legacy_code('slblock_generate', def);
显示生成的与现有代码的集成
模型 rtwdemo_lct_fixpt_params 显示了模型与现有代码的集成。子系统 TestFixpt 的作用相当于通过生成的 S-Function 调用已有 C 函数的工具。
open_system('rtwdemo_lct_fixpt_params') open_system('rtwdemo_lct_fixpt_params/TestFixpt') sim('rtwdemo_lct_fixpt_params')