Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

导出函数模型概述

导出函数模型是 Simulink® 模型,它们可以生成可与外部环境和调度器集成的独立函数的代码。函数是使用 Function-Call Subsystem、函数调用 ModelSimulink FunctionS-Function 模块定义的。

以下导出函数模型包含使用 Function-Call Subsystem 模块定义的两个函数。有关创建此模型的分步过程,请参阅Create an Export-Function Model

从此模型生成的代码具有两个独立函数:一个时滞函数,一个平方函数。

      /*
       * File: export_function_model.c    
       * Code generated for Simulink model 'export_function_model'.
       */
		
	void function_call_100ms(void)         /* Sample time: [0.1s, 0.0s] */
	{
	  export_function_model_Y.output_100ms =
	    export_function_model_DW.UnitDelay_DSTATE;
	
	  export_function_model_DW.UnitDelay_DSTATE =
	    export_function_model_Y.output_100ms + 1.0;	
	}

      void function_call_10ms(void)          /* Sample time: [0.01s, 0.0s] */
	{
	    export_function_model_Y.output_10ms = export_function_model_U.input_10ms *
	    export_function_model_U.input_10ms;
	}

导出函数模型的工作流

用于创建导出函数模型的四种常见流程在生成函数代码之前进行模型仿真和测试的方式有所不同。

当函数调用顺序足够简单而可指定为模型输入时,使用输入矩阵的仿真是测试导出函数模型的首选方法。请参阅Test Export-Function Model Simulation Using Input Matrix

当函数调用顺序过于复杂而无法使用输入矩阵指定时,请创建测试模型(框架)以模拟目标环境行为。使用此测试模型为导出函数模型提供函数调用输入。请参阅Test Export-Function Model Simulation Using Function-Call GeneratorsTest Export-Function Model Simulation Using Schedule EditorTest Export-Function Model Simulation Using Stateflow Chart

允许的模块

在顶层,导出函数模型仅允许使用虚拟模块、具有常量 (inf) 采样时间的模块以及以下模块:

  • Inport

  • Outport

  • Bus Creator

  • Bus Selector

  • In Bus Element

  • Out Bus Element

  • Function-Call Subsystem

  • 带函数调用输入端口的 Model

  • Simulink Function

  • Initialize Function

  • Reset Function

  • Terminate Function

  • Data Store Memory

  • Merge

  • 带函数调用输入端口的 S-Function

  • Function-Call Split

  • Display

  • Scope

请参阅非虚拟和虚拟模块

导出函数模型的要求

要使导出函数模型成功生成函数代码,必须满足以下要求。

模型配置参数:

  • 求解器 Type 设置为 “Fixed-step”。

  • Solver 设置为 “auto” 或 “discrete”。

  • 将 Code Generation 部分的 System target file 设置为 “ert.tlc”。选择 ert.tlc 需要 Embedded Coder® 许可证。

  • 对于函数调用 Model 模块,引用模型的 Periodic sample time constraint 设置为 “Ensure sample time independent”。

根级函数调用模块 Inport

  • 选中 Output function call 复选框。

  • 不能从 Asynchronous Task Specification 模块接收信号。

根级数据 InportOutport 模块不能连接到虚拟总线数据信号。

根级 Function-Call Subsystem 模块和函数调用 Model 模块:

  • 模块内的所有内部模块都必须支持代码生成。

  • 如果 Trigger 模块的 Sample time type 设置为:

    • triggered”,则内部模块必须将 Sample time 设置为 -1

    • periodic”,则根级函数调用 Inport 模块必须将其 Sample time 设置为指定的离散时间,并且所有内部模块必须将 Sample time 设置为 -1 或指定的离散时间。

函数调用子系统的采样时间

在导出函数模型中,您可以为根级函数调用 Inport 模块以及根级 Function-Call Subsystem 模块或函数调用 Model 模块内的 Trigger 模块指定采样时间。下表显示了如何指定这些采样时间。

Trigger 模块的 Sample time typeTrigger block Sample timeInport block Sample time仿真期间的函数调用速率

Triggered

未指定,参数处于非活动状态。

-1(继承)

在仿真时,由连接到 Inport 模块的函数调用发起方设置仿真速率。

指定的离散时间

在测试模型中连接到 Inport 模块的函数调用发起方的采样时间必须等于 Inport 模块的指定离散时间。

在仿真时,组件以指定的离散速率执行。如果函数调用源使用不同的采样时间,Simulink 将显示错误消息。

Periodic

如果从 Model 模块引用导出函数模型,则应用周期性函数调用运行时检查。

-1(继承)或 Inport 模块的指定离散时间。

-1(继承)

不允许此配置。Simulink 显示错误消息。

指定的离散时间。

在仿真时,组件按指定的离散采样时间执行。如果函数调用源使用不同的采样时间,Simulink 将显示错误消息。

根级函数调用 Inport 模块的执行顺序

通过为函数调用的 Inport 模块指定采样时间和优先级,可以控制 Function-Call Subsystems 和函数调用 Models during simulation 的执行顺序。您也可以使用调度编辑器或 Stateflow® 图来测试调度。请参阅 Test Export-Function Model Simulation Using Schedule EditorTest Export-Function Model Simulation Using Stateflow Chart

  1. 指定仿真执行的采样时间。右键点击函数调用 Inport 模块,然后选择 Block parameters

  2. 选择 Signal Attributes 选项卡。在 Sample time 框中,输入离散时间。

  3. 指定仿真的模块优先级。右键点击函数调用 Inport 模块,然后选择 Properties

  4. Priority 框中,输入优先级值。

  5. 显示仿真的模块执行顺序。在 Debug 选项卡上,选择 Information Overlays ,然后从下拉对话框中选择 Execution Order。这一显示内容对生成的代码没有任何影响。

在以下导出函数模型中,先运行 Function-Call Subsystem 2InportSample time 设置为 0.01 (10 ms)),然后运行 Function-Call Subsystem 1Inport 模块的 Sample time 设置为 0.1 (100 ms))。

确定相对执行顺序

Simulink 使用以下规则比较函数调用 Inport 模块属性以确定其相对执行顺序:

  1. 优先级 - 较高优先级(较低的数字)先执行

  2. 采样时间(采样时间较小的先执行)

  3. 端口号(端口号较小的先执行)

如果两个模块的 Priority 参数具有不同的值,具有较高优先级的模块将先执行。如果 Priority 参数相等,则速率更快(采样时间较小)的模块将先执行。如果两个模块的 Priority 和采样时间都相同,则具有较小端口号的模块将先执行。

注意

如果顶层模型的仿真模式是 Accelerator 或 Rapid Accelerator,Simulink 不会对引用的导出函数模型内根级函数调用 Inport 模块的执行顺序进行运行时仿真检查。

假设一个导出函数模型有五个根级函数调用 Inport 模块,分别是模块 A 到 E,模块属性如下表所示。为了确定它们的相对执行顺序,Simulink 会比较它们的 Priority 参数、采样时间(如果采样时间不同并且不是继承的)和端口号。

根级函数调用模块 InportABCDE
优先级1030404030
采样时间-10.20.10.1-1
端口号54321
  • 模块 A 在所有五个模块中的优先级最高。A 先执行。

  • B 和 E 在 A 之后但在 C 和 D 之前执行。由于 B 和 E 有相同的优先级,Simulink 将比较其采样时间,以确定执行顺序。E 的采样时间为 -1(继承),该值小于 B 的采样时间 0.2,因此 E 在 B 之前执行。

  • C 和 D 具有相同的优先级和同样的非继承唯一采样时间。D 的端口号 (2) 小于 C (3),因此 D 在 C 之前执行。

这些函数调用 Inport 模块的相对执行顺序是 A、E、B、D 和 C。

函数调用子系统的锁存输入数据

您可以锁存 Function-Call Subsystem 模块中 Inport 模块的输入数据,以确保数据完整性。要锁存输入数据,请在 Inport 模块参数中,选择 Latch input for feedback signals of function-call subsystem outputs

在以下模型中,函数调用子系统 ReadDSAndCal1Inport 模块的输入数据被锁存(由 <Li> 表示)且在子系统执行期间不能更改。在每个函数调用子系统中调用 Data Store ReadData Store Write 模块。第一个和第二个函数调用写入数据,最后一个函数调用将数据读取到 Data Store Memory 模块。

注意

默认情况下,数据传输信号在生成的代码中不受保护。使用自定义存储类,以防止由于目标环境中当前任务的抢占而导致这些信号中的数据损坏。

嵌套的导出函数模型

嵌套的导出函数模型提供了额外的组织层。以下模型包含两个通过 Model 模块引用的导出函数模型。

注意

导出函数模型不能包含使用异步函数调用输入的引用模型,但可以包含函数调用子系统和函数调用模型。使用异步函数调用输入的模型可以包含导出函数模型、函数调用子系统或函数调用模型。

包含多实例函数调用模型的导出函数模型

您可以在导出函数模型中使用 Function-Call Subsystem 模块或函数调用 Model 模块。如果使用函数调用 Model 模块,则还可以创建模型的多个实例。

  1. 使用包含 Trigger 模块的模型定义您的算法。将 Trigger type 设置为 “function-call”。

  2. Model 模块引用模型。结果是一个函数调用模型。

  3. 连接一个函数调用 Inport 模块并选中 Output function call 复选框。添加信号 InportOutport 模块。更新模型 (Ctrl-D)。结果是一个包含函数调用模型的导出函数模型。

  4. 复制引用模型和端口模块以创建模型的第二个实例。这两个实例由不同任务中的不同根级函数调用 Inport 模块调用。

导出函数模型和使用异步函数调用输入的模型

导出函数模型功能可供采用异步函数调用输入端口的模型使用。这些模型主要用在通过 Simulink 调度器调用函数的 Simulink 环境中。

比较特性导出函数模型使用异步函数调用输入的模型
定义这些模型具有未连接到 Asynchronous Task Specification 模块的根级函数调用 Inport 模块。这些 Inport 模块触发函数调用子系统或函数调用模型(包含 Trigger 模块的 Model 模块)。这些模型包含连接到 Asynchronous Task Specification 模块的根级函数调用 Inport 模块。这些 Inport 模块会触发函数调用子系统或函数调用模型。
根级模块只有在函数调用上下文中执行的模块才允许位于根级。在非函数调用上下文中执行的模块也允许位于根级。
数据传输使用数据传输指示符解释仿真结果。默认情况下,导出函数模型中的数据传输在生成的代码中不受保护。有关详细信息,请参阅函数调用子系统的锁存输入数据可使用 Rate Transition 模块保护以不同速率运行的函数调用子系统之间的数据传输。有关详细信息,请参阅 Rate Transition
仿真支持这些模型支持所有仿真模式下的独立仿真和测试模型仿真。这些模型支持所有仿真模式下的测试模型仿真,以及 Normal、Accelerator 和 Rapid Accelerator 模式下的独立仿真。
代码生成支持支持顶层模型和独立代码生成。支持顶层模型和独立代码生成。

另请参阅

模块

相关主题