主要内容

lefacy_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')

描述

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

  • Accelerator模式或代码生成中的用于模拟的TLC文件

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

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

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

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

Legacy_code('编译',眼镜编译编译并链接基于数据结构的遗留代码工具生成的S函数,眼镜,以及您可能指定的编译器选项。必须支持编译器选项金宝app墨西哥人功能。

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有关更多信息,请参阅使用遗留代码工具将外部代码导入外部代码的调用(金宝appSimulink编码器)

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

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

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

输入参数

眼镜

具有以下字段的结构:

命名S函数

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

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

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

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

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

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

定义编译资源

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

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

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

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

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

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

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

指定采样时间

采样时间- 以下之一:

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

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

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

如果指定此字段,则必须持续指定它。

定义S函数选项

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

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

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

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

  • USETLCWithacel.—指定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.

      • 金宝appsimulink.aliaStype.

      • 金宝appsimulink.numerictype.

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

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

  • 金宝appsupportsmultipleexecinstances.- 指定是否包含对其的呼叫的逻辑值ss金宝appsupportsmultipleexecinstances.功能。默认情况下,该值是错误的0.).

  • convertndarraytorowmajor.- 一个逻辑值,指定列 - 主要格式和行主要格式之间矩阵的自动转换。matlab,simulink和生成的代码使用列 - 主要格式。金宝appC的行主要格式由C.默认情况下,该值是错误的0.).如果您目前指定选项的先前版本,convert2dmatrixtorowmajor.,该函数自动指定新的convertndarraytorowmajor.选择。

    笔记

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

  • 金宝app支持员长- 指定生成的S函数是否必须与模型覆盖范围兼容的逻辑值。默认情况下,该值是错误的0.).

  • 金宝appsupportCoverageanDdesignifier- 指定生成的S函数是否必须与模型覆盖范围兼容的逻辑值金宝appSimulink Design Verifier™。默认情况下,该值是错误的0.).

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

型号名称

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

介绍在R2006B.