legacy_code

使用传统的代码的工具

句法

legacy_code( '帮助')
眼镜= legacy_code( '初始化')
legacy_code( 'sfcn_cmex_generate',眼镜
legacy_code( '编译',眼镜compilerOptions
legacy_code( 'generate_for_sim',眼镜型号名称
legacy_code( 'slblock_generate',眼镜型号名称
legacy_code (“sfcn_tlc_generate”,眼镜
legacy_code( 'sfcn_makecfg_generate',眼镜
legacy_code( 'rtwmakecfg_generate',眼镜
legacy_code( 'backward_compatibility')

描述

legacy_code函数创建一个MATLAB®产生结构用于登记用于现有的C或C ++代码和S-功能的规范。此外,该功能可以生成,编译和链接,以及创建用于指定S-功能的掩蔽块。其他选项包括发电

  • 用于模拟在加速器模式或代码生成甲TLC文件

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

legacy_code( '帮助')使用旧代码的工具显示的说明。

眼镜= legacy_code( '初始化')初始化遗留代码工具的数据结构,眼镜,哪些寄存器现存的C或C ++代码和S-功能,该传统代码工具产生的特性的特性。

legacy_code( 'sfcn_cmex_generate',眼镜如由传统代码工具数据结构中指定生成S-函数源文件,眼镜

legacy_code( '编译',眼镜compilerOptions编译以及基于所述数据结构由传统代码工具生成的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”,眼镜基于该数据结构用于由传统代码工具生成的S-功能的TLC文件,眼镜。如果你想此选项是相关的:

  • 力加速器模式在Simulink软件中使用TLC内联代金宝app码生成的s函数。参见。的描述ssSetOptionsSimStruct功能SS_OPTION_USE_TLC_WITH_ACCELERATOR有关更多信息,S-功能选项。

  • 金宝app仿真软件编码器™从Simulink模型生成代码的软件。金宝app欲了解更多信息,请参阅导入调用外部代码到生成的代码修改代码工具(金宝app编码器的Simulink)。

legacy_code( 'sfcn_makecfg_generate',眼镜生成sFunction_makecfg.m基于该数据结构用于由传统代码工具生成的S-功能文件,眼镜。这个选项只如果你使用金宝appSimulink的编码器从Simulink模型生成代码的软件。金宝app欲了解更多信息,请参阅使用makecfg到自定义生成的makefile的S-功能(金宝app编码器的Simulink)和导入调用外部代码到生成的代码修改代码工具(金宝app编码器的Simulink)。

legacy_code( 'rtwmakecfg_generate',眼镜生成rtwmakecfg.m基于该数据结构用于由传统代码工具生成的S-功能文件,眼镜。这个选项只如果你使用金宝appSimulink的编码器从Simulink模型生成代码的软件。金宝app欲了解更多信息,请参阅使用rtwmakecfg.m API来定制生成的makefile(金宝app编码器的Simulink)和导入调用外部代码到生成的代码修改代码工具(金宝app编码器的Simulink)。

legacy_code( 'backward_compatibility')自动将使用遗留代码工具的语法更新为本参考页面和in中描述的受支持的语法金宝app使用集成遗留代码工具C函数

输入参数

眼镜

具有以下字段的结构:

命名S-功能

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

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

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

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

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

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

定义编译资源

  • HeaderFiles- 特征向量指定的编译需要的头文件中的文件名的单元阵列。

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

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

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

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

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

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

指定采样时间

采样时间- 以下情况之一:

  • '遗传'(默认) - 样品时间是从源块继承。

  • “参数”- 样品时间被表示为可调参数。生成的代码可以通过调用MEX API函数访问参数,诸如mxGetPrmxGetData

  • 固定 - 采样时间明确指定。有关如何指定采样时间的信息,请参阅指定采样时间

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

定义S-功能选项

选项- 一种结构,即控制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- 一个逻辑值,如果为真正的时,指定生成的代码:

    • 要求您生成和管理的内联S-功能只有一个文件(的.cpp),而不是两个(. c.tlc)。

    • 维护由模型配置参数指定的模型代码样式(表达式中的圆括号使用级别和操作数顺序的保存以及if语句中的条件表达式)。

    默认情况下,该值是

    限制

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

    • Options.language = 'C ++'

    • 您可以使用下面的Simulink中的一个与对象金宝appIsAlias属性设置为真正的

      • 金宝appSimulink.Bus

      • 金宝appSimulink.AliasType

      • 金宝appSimulink.NumericType

    • 遗留代码工具功能规范包括无效*无效**代表标工作数据的状态参数

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

  • 金宝appsupportsMultipleExecInstances- 一个逻辑值指定是否包括到一个呼叫ss金宝appSupportsMultipleExecInstances功能。默认情况下,该值是0)。

  • convertNDArrayToRowMajor- 一个逻辑值,指定一列优先格式和行优先格式之间以矩阵的自动转换。列主要格式由MATLAB,Simulink和所生成的代码中使用。金宝app该行的主要格式使用C.默认情况下,该值是0)。如果您目前指定的选项以前的版本,convert2DMatrixToRowMajor,该功能会自动指定新convertNDArrayToRowMajor选择。

    注意

    此选项不支持复杂的数据的2-d矩阵。金宝app

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

  • 金宝appsupportCoverageAndDesignVerifier- 指定是否将所生成的S-功能的逻辑值必须与模型覆盖和兼容金宝appSimulink设计验证器™。默认情况下,该值是0)。

  • outputsConditionallyWritten-指定遗留代码是否有条件地写入输出端口的逻辑值。如果真正的时,生成的s -函数指定与每个输出端口关联的内存不能被覆盖,并且是全局的(SS_NOT_REUSABLE_AND_GLOBAL)。如果,与每个输出端口相关联的内存是可重用的,并且是本地的(SS_REUSABLE_AND_LOCAL)。默认情况下,该值是0)。欲了解更多信息,请参阅ssSetOutputPortOptimOpts

型号名称

Simulink模型的名称入金宝app遗产代码的工具是插入,当你指定产生的遮蔽S-功能块legacy_code与动作字符向量'slblock_generate'。如果忽略此参数,该块出现在一个空模型编辑器窗口。

介绍了在R2006b