文档

legacy_code

使用遗留代码工具

语法

Legacy_code('help')
规格= Legacy_Code('初始化')
Legacy_code('sfcn_cmex_generate',规格
Legacy_code('编译',规格编译
legacy_code(“generate_for_sim”,规格型号名称
Legacy_code('slblock_generate',规格型号名称
legacy_code(“sfcn_tlc_generate”,规格
Legacy_code('sfcn_makecfg_generate',规格
Legacy_code('RTWMAKECFG_GENED',规格
legacy_code(“backward_compatibility”)

描述

legacy_code函数创建一个matlab®结构,用于注册现有C或c++代码的规范和生成的s函数。此外,该函数可以生成、编译和链接,并为指定的s -函数创建屏蔽块。其他选项包括生成

  • 一个TLC文件,用于加速模式下的模拟或代码生成

  • 一个rtwmakecfg.m您可以自定义以指定驻留在不同目录中的依赖源和头文件的文件,该文件和标头文件比生成的S函数的依赖于不同的目录

Legacy_code('help')显示使用遗留代码工具的说明。

规格= Legacy_Code('初始化')初始化遗留代码工具的数据结构,规格,它寄存在遗留代码工具生成的S-函数的现有C或C ++代码和属性的特征。

Legacy_code('sfcn_cmex_generate',规格根据遗留代码工具数据结构指定的S函数源文件,规格

Legacy_code('编译',规格编译基于数据结构,编译并链接Legacy Code工具生成的s函数,规格,以及您可能指定的编译器选项。控件必须支持编译器选项金宝app墨西哥人(MATLAB)功能。

legacy_code(“generate_for_sim”,规格型号名称生成,编译和链接S-函数在一步中。如果是options.usetlcwithaccel.遗留代码工具数据结构的字段设置为逻辑1 (真正的),该函数还生成TLC文件,用于加速模拟。

Legacy_code('slblock_generate',规格型号名称基于数据结构生成由传统代码工具生成的S函数的屏蔽的S函数块,规格.该块出现在Simulink中金宝app®指定的模型型号名称.如果您省略型号名称,块显示在空模型编辑器窗口中。

legacy_code(“sfcn_tlc_generate”,规格生成基于数据结构的传统代码工具生成的TLC文件,规格.如果你想:

  • 在Simulink软件中使用Force Accele金宝apprator模式的TLC内联代码生成s函数。见描述的sssetoptions.SimStruct功能和ss_option_use_tlc_with_accelerator.s功能选项,了解更多信息。

  • 金宝app仿真软件编码器™软件从您的Simulink模型生成代码。金宝app有关更多信息,请参阅使用遗留代码工具将外部代码导入外部代码的调用(金宝app仿真软件编码器)。

Legacy_code('sfcn_makecfg_generate',规格生成一个答案_makecfg.m基于数据结构的遗留代码工具生成的S-函数的文件,规格.此选项才相关,仅当您使用时金宝appSimulink编码器软件从您的Simulink模型生成代码。金宝app有关更多信息,请参阅使用makecfg为S-Functions定制生成的makefile(金宝app仿真软件编码器)和使用遗留代码工具将外部代码导入外部代码的调用(金宝app仿真软件编码器)。

Legacy_code('RTWMAKECFG_GENED',规格生成一个rtwmakecfg.m基于数据结构的遗留代码工具生成的S-函数的文件,规格.此选项才相关,仅当您使用时金宝appSimulink编码器软件从您的Simulink模型生成代码。金宝app有关更多信息,请参阅使用rtwmakecfg.m api自定义生成的makefiles(金宝app仿真软件编码器)和使用遗留代码工具将外部代码导入外部代码的调用(金宝app仿真软件编码器)。

legacy_code(“backward_compatibility”)自动更新使用遗留代码工具的语法,以支持本参考页和中所描述的语法金宝app使用遗留代码工具集成C函数

输入参数

规格

具有以下字段的结构:

函数的名字

SFunctionName(必选)-指定由遗留代码工具生成的s函数的名称的字符向量。

定义遗留代码工具功能规范

  • InitializeConditionsFcnSpec- 一个非空字符向量,指定S函数调用初始化和重置状态的函数。您必须使用Simulink软件可以解释的令牌来声明这个函数,如金宝app声明遗留代码工具功能规范

  • outputfcnspec.- 一个非空字符向量,指定每个时间步骤的S函数调用的函数。您必须使用Simulink软件可以解释的令牌来声明这个函数,如金宝app声明遗留代码工具功能规范

  • StartFcnSpec-字符向量,指定s函数开始执行时调用的函数。该函数可以访问s -函数参数参数和工作数据。您必须使用Simulink软件可以解释的令牌来声明这个函数,如金宝app声明遗留代码工具功能规范

  • TerminateFcnSpec- 一个字符向量,指定S函数调用终止执行时的函数。该函数可以访问s -函数参数参数和工作数据。您必须使用Simulink软件可以解释的令牌来声明这个函数,如金宝app声明遗留代码工具功能规范

定义编译资源

  • 头文件- 指定编译所需的头文件的文件名的字符向量阵列。

  • 源文件-指定编译所需的源文件的字符向量单元格数组。可以使用绝对路径名或相对路径名指定源文件。

  • hostlibfiles.- 指定主机编译所需的库文件的字符向量的单元格数组。您可以使用绝对或相对路径名称指定库文件。

  • TargetLibFiles-指定目标(即独立)编译所需的库文件的字符向量单元格数组。您可以使用绝对或相对路径名称指定库文件。

  • IncPaths- 指定包含标题文件的目录的字符向量的单元格数组。可以使用绝对路径名或相对路径名指定目录。

  • SRCPaths.—字符向量单元格数组,指定包含源文件的目录。可以使用绝对路径名或相对路径名指定目录。

  • LibPaths—字符向量单元格数组,指定包含主机和目标库文件的目录。可以使用绝对路径名或相对路径名指定目录。

指定采样时间

SampleTime- 以下之一:

  • “继承”(默认) - 从源块继承采样时间。

  • '参数化'- 采样时间表示为可调参数。生成的代码可以通过调用MEX API函数来访问参数,例如mxGetPrmxGetData

  • 固定-您显式指定的采样时间。有关如何指定示例时间的信息,请参见指定样品时间

如果指定此字段,则必须在最后指定。

定义功能选项

选项- 控制S函数选项的结构。结构的字段包括:

  • isMacro- 指定遗留代码是否为C宏的逻辑值。默认情况下,值为false(0).

  • isVolatile—指定s功能设置的逻辑值SS_OPTION_NONVOLATILE选择。默认值为true (1).

  • canBeCalledConditionally—指定s功能设置的逻辑值ss_option_can_be_called_conditionally选择。默认值为true (1).

  • useTlcWithAccel—指定s功能设置的逻辑值ss_option_use_tlc_with_accelerator.选择。默认值为true (1).

  • 语言—指定任意一种的字符向量“C”“c++”作为遗留代码工具将产生的s函数的目标语言。缺省值是“C”

    请注意

    遗留代码工具可以与C ++函数界面,但不是C ++对象。在周围的工作,看遗留代码工具限制在Simuli金宝appnk文档中。

  • singleCPPMexFile—逻辑值,表示“如果”真正的,指定生成的代码:

    • 要求您生成并管理INLINED的S函数仅为一个文件(. cpp)而不是两个(.c.tlc).

    • 维护由模型配置参数指定的模型代码风格(表达式中括号的使用程度和操作数顺序的保留以及if语句中条件表达式的保留)。

    缺省值是

    限制

    不能设置singleCPPMexFile字段真正的如果

    • Options.language =“c++”

    • 控件中使用下列Simulink对象之一金宝appIsAlias属性设置为真正的

      • 金宝appsimulink.bus.

      • 金宝app仿真软件。AliasType

      • 金宝app仿真软件。NumericType

    • 遗留代码工具功能规范包括空白*void * *表示状态参数的标量工作数据

    • 头文件遗留代码工具结构的字段指定多个头文件

  • 金宝appsupportsmultipleexecinstances.—一个逻辑值,指定是否包含对ss金宝appsupportsmultipleexecinstances.函数。缺省值是0).

  • convertNDArrayToRowMajor—指定矩阵在列主格式和行主格式之间自动转换的逻辑值。在MATLAB、Simulink和生成的代码中使用了列-主格式。金宝appc使用的是row-major格式。默认值为0).如果您当前指定该选项的以前版本,convert2DMatrixToRowMajor,函数自动指定newconvertNDArrayToRowMajor选择。

    请注意

    此选项不支持复杂数据的二维矩阵。金宝app

  • 金宝appsupportCoverage—指定生成的s功能是否必须与Model Coverage兼容的逻辑值。缺省值是0).

  • 金宝appsupportCoverageAndDesignVerifier—指定生成的s -功能是否必须与Model Coverage和兼容的逻辑值金宝app仿真软件设计校验™.缺省值是0).

  • outputsConditionallyWritten—指定遗留代码是否有条件地写入输出端口的逻辑值。如果真正的,生成的s -函数指定与每个输出端口相关联的内存不能被覆盖,并且是全局的(SS_NOT_REUSABLE_AND_GLOBAL).如果,与每个输出端口相关联的内存是可重用的并且是本地的(ss_reusable_and_local.).缺省值是0).有关更多信息,请参阅sssetoutputportimopts.

型号名称

Simulink模型的名称是金宝app哪个传统代码工具在指定时插入屏蔽的S函数块legacy_code与行动字符矢量'slblock_generate'.如果省略此参数,该块将出现在一个空的模型编辑器窗口中。

介绍了R2006b