主要内容

legacy_code

使用遗留代码的工具

语法

legacy_code(“帮助”)
规格= legacy_code(初始化)
legacy_code (“sfcn_cmex_generate”,规格)
legacy_code(“编译”,规格,compilerOptions)
legacy_code (“generate_for_sim”,规格,modelname)
legacy_code (“slblock_generate”,规格,modelname)
legacy_code (“sfcn_tlc_generate”,规格)
legacy_code (“sfcn_makecfg_generate”,规格)
legacy_code (“rtwmakecfg_generate”,规格)
legacy_code (“backward_compatibility”)

描述

legacy_code函数创建一个MATLAB®结构注册规范现有的C或c++代码和生成功能。此外,该函数可以生成、编译和链接,并创建一个蒙面的指定功能块。其他选项包括生成

  • 薄层色谱文件在加速器模拟模式或代码生成

  • 一个rtwmakecfg.m依赖文件,您可以自定义指定源和头文件驻留在一个不同的目录的生成的功能

legacy_code(“帮助”)显示指令使用遗留代码的工具。

规格= legacy_code(初始化)遗留代码工具初始化数据结构,规格,寄存器的特点,现有的C或c++代码的功能和属性的遗留代码生成工具。

legacy_code (“sfcn_cmex_generate”,规格)生成一个函数中指定源文件遗留代码工具数据结构,规格

legacy_code(“编译”,规格,compilerOptions)编译和链接功能由遗留代码生成工具的数据结构的基础上,规格,您可以指定编译器选项。必须支持的编译器选项金宝app墨西哥人函数。

legacy_code (“generate_for_sim”,规格,modelname)生成、编译和链接的功能在一个单一的步骤。如果Options.useTlcWithAccel现场遗留代码工具的数据结构设置为逻辑1 (真正的),该函数也为加速模拟生成一个薄层色谱文件。

legacy_code (“slblock_generate”,规格,modelname)生成一个蒙面的功能块的功能由遗留代码生成工具的数据结构的基础上,规格。块出现在模型中金宝app®指定的模型modelname。如果您省略modelname块出现在一个空模型编辑器窗口。

legacy_code (“sfcn_tlc_generate”,规格)s函数生成一个薄层色谱文件遗留代码工具生成的数据结构的基础上,规格。这个选项是相关的,如果你想:

  • 力加速器模式在软件使用仿真软件TLC内联代码生成的功金宝app能。看到的描述ssSetOptionsSimStruct功能和SS_OPTION_USE_TLC_WITH_ACCELERATOR功能选项的更多信息。

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

legacy_code (“sfcn_makecfg_generate”,规格)生成一个sFunction_makecfg.m遗留代码工具生成的文件功能的数据结构的基础上,规格。如果你使用金宝app仿真软件编码器从仿真软件模型生成代码,您可以使用这个选项来指定额外的金宝app项目源文件夹等功能的构建过程,预处理器宏,和链接对象。例如,您可以指定源文件的功能取决于文件夹包含s函数生成的可执行文件的文件夹。有关更多信息,请参见使用makecfg S-Functions定制生成的makefile(金宝app仿真软件编码器)调用外部代码导入生成的代码与遗留代码的工具(金宝app仿真软件编码器)

legacy_code (“rtwmakecfg_generate”,规格)生成一个rtwmakecfg.m遗留代码工具生成的文件功能的数据结构的基础上,规格。如果你使用金宝app仿真软件编码器从仿真软件模型生成代码,您可以使用这个选项来指定额外的金宝app项目源文件夹等功能的构建过程,预处理器宏,和链接对象。例如,您可以指定源文件的功能取决于文件夹包含s函数生成的可执行文件的文件夹。有关更多信息,请参见使用rtwmakecfg。m API来定制生成的makefile(金宝app仿真软件编码器)调用外部代码导入生成的代码与遗留代码的工具(金宝app仿真软件编码器)

legacy_code (“backward_compatibility”)自动更新的语法使用遗留代码工具支持的语法描述在这个参考页面金宝appC函数使用遗留代码工具集成

输入参数

规格

一个结构有以下字段:

函数的名字

SFunctionName(需要)——一个特征向量指定函数的名称是由遗留代码生成工具。

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

  • InitializeConditionsFcnSpec——一个非空的特征向量指定一个函数,函数调用初始化和复位状态。必须声明这个函数通过使用令牌,仿真软件软件可以解释解释金宝app宣布遗留代码工具功能规范

  • OutputFcnSpec——一个非空的特征向量指定函数调用的函数在每个时间步。必须声明这个函数通过使用令牌,仿真软件软件可以解释解释金宝app宣布遗留代码工具功能规范

  • StartFcnSpec——一个特征向量指定函数开始执行时调用它的函数。这个函数可以访问功能参数参数和工作数据。必须声明这个函数通过使用令牌,仿真软件软件可以解释解释金宝app宣布遗留代码工具功能规范

  • TerminateFcnSpec——一个特征向量指定函数,函数调用时终止执行。这个函数可以访问功能参数参数和工作数据。必须声明这个函数通过使用令牌,仿真软件软件可以解释解释金宝app宣布遗留代码工具功能规范

定义编译资源

  • HeaderFiles——一个单元阵列特征向量指定编译所需头文件的文件名称。

  • 源文件——一个单元阵列所需的特征向量指定源文件编译。您可以指定源文件使用绝对或相对路径名。

  • HostLibFiles——一个单元阵列特征向量指定主机编译所需的库文件。您可以指定库文件使用绝对或相对路径名。

  • TargetLibFiles——一个单元阵列特征向量的指定目标所需的库文件(即独立)编译。您可以指定库文件使用绝对或相对路径名。

  • IncPaths——一个单元阵列特征向量指定包含头文件目录。你可以使用绝对或相对路径名指定的目录。

  • SrcPaths——一个单元阵列特征向量指定包含源文件目录。你可以使用绝对或相对路径名指定的目录。

  • LibPaths——一个单元阵列特征向量指定目录包含主机和目标库文件。你可以使用绝对或相对路径名指定的目录。

指定一个样品时间

SampleTime——以下之一:

  • “继承”(默认),样品时间是继承了从源块。

  • “参数化”——样品时间表示为可调参数。生成的代码可以访问通过调用墨西哥人API函数的参数,如mxGetPrmxGetData

  • 固定样本时间您显式地指定。有关如何指定样本的信息,明白了指定样品时间

如果指定这个领域,你必须指定它。

定义功能选项

选项——结构控制功能选项。结构的字段包括:

  • canBeCalledConditionally——一个逻辑值指定功能的设置SS_OPTION_CAN_BE_CALLED_CONDITIONALLY选择。默认情况下,这个值是正确的(1)。

  • convertNDArrayToRowMajor——一个逻辑值指定自动转换矩阵的列为主的格式和存储格式。列为主的格式使用MATLAB仿真软件,生成的代码。金宝app行格式使用c。默认情况下,该值(0)。如果你目前指定之前版本的选项,convert2DMatrixToRowMajor,函数自动指定了新的convertNDArrayToRowMajor选择。

    请注意

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

  • isMacro——一个逻辑值指定是否遗留代码是一个C宏。默认情况下,这个值是false (0)。

  • isVolatile——一个逻辑值指定功能的设置SS_OPTION_NONVOLATILE选择。默认情况下,这个值是正确的(1)。

  • 语言——一个特征向量指定“C”“c++”目标语言的遗留代码工具将生成的功能。默认情况下,这个值是“C”

    请注意

    遗留代码工具可以用c++函数接口,而不是c++对象。工作,明白了遗留代码工具的局限性在仿真软件文档金宝app。

  • outputsConditionallyWritten——一个逻辑值指定是否遗留代码有条件地写到输出端口。如果真正的,生成的s函数指定相关的内存不能覆盖,是全球每个输出端口(SS_NOT_REUSABLE_AND_GLOBAL)。如果与每个输出端口相关联,内存是可重用的,本地(SS_REUSABLE_AND_LOCAL)。默认情况下,这个值是(0)。有关更多信息,请参见ssSetOutputPortOptimOpts

  • singleCPPMexFile——一个逻辑值,如果真正的指定生成的代码:

    • 需要生成和管理一个内联函数只有一个文件(. cpp)而不是两个(。c.tlc)。

    • 维护模型代码风格(括号的使用和保存操作数的顺序在if语句表达式和条件表达式)所指定的模型配置参数。

    默认情况下,这个值是

    限制

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

    • Options.language =“c++”

    • 您使用以下模型对象之一金宝appIsAlias属性设置为真正的:

      • 金宝appSimulink.Bus

      • 金宝appSimulink.AliasType

      • 金宝appSimulink.NumericType

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

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

  • 金宝appsupportsMultipleExecInstances——一个逻辑值指定是否要包括一个调用ss金宝appSupportsMultipleExecInstances函数。默认情况下,这个值是(0)。

  • 金宝appsupportCodeReuseAcrossModels——一个逻辑值指定生成的功能是否可以重用整个层次结构模型参考。如果真正的,生成的功能包括ssSet金宝appSupportedForCodeReuseAcrossModels函数调用。代码生成器生成的代码S-functionsslprj \ ert \ _sharedutils文件夹中。

  • 金宝appsupportCoverage——一个逻辑值指定是否生成的功能必须兼容模型覆盖。默认情况下,这个值是(0)。

  • 金宝appsupportCoverageAndDesignVerifier——一个逻辑值指定是否生成的功能必须覆盖和兼容模式金宝app仿真软件设计校验™。默认情况下,这个值是(0)。

  • useTlcWithAccel——一个逻辑值指定功能的设置SS_OPTION_USE_TLC_WITH_ACCELERATOR选择。默认情况下,这个值是正确的(1)。

modelname

仿真软件模型的名称,遗留代码金宝app工具插入时指定生成的蒙面的功能块legacy_code行动的特征向量“slblock_generate”。如果你忽略这个论点,块出现在一个空模型编辑器窗口。

介绍了R2006b