主要内容

分析生成的数据代码接口

当您生成代码生成报告时，您可以包含一个代码接口报告，它记录生成的代码接口，包括模型入口点函数和接口数据。代码接口信息可以帮助您查看生成的代码并将其与其他代码集成。报告中的信息取决于您使用的代码接口配置的类型。对于使用服务接口代码配置的模型，代码接口报告还包括有关服务的信息，如分析生成的服务代码接口报告。

对于配置了数据接口的代码，代码接口报告包括以下小节:

  • 入口点函数-各型号入口功能的接口信息，包括model_initialize，model_step，及(如适用)model_reset和model_terminate。

  • 港口和外港-各型号进出口接口信息。

  • 接口参数-与模型相关的可调参数的接口信息。

  • 数据存储-全局数据存储和非-类型数据存储的接口信息汽车与模型相关联的存储。

要生成代码接口报告，请选择配置参数创建代码生成报告和代码接口报告，如生成代码生成报告。有关适用于代码接口报告的限制，请参见代码接口报告限制。

为了便于说明，本节使用以下模型:

导航代码接口报告子节

为了帮助您浏览代码接口描述，代码接口报告提供了折叠/展开令牌和超链接。

  • 对于一个很大的小节，报告提供了[,]和(+)允许您折叠或展开该部分的符号。

  • 代码接口报告提供了几种形式的超链接导航。例如:

    • 的目录表位于代码接口报告顶部的链接提供了到每个小节的链接。

    • 您可以单击每个函数名称以进入其定义模型。c。

    • 您可以单击每个函数的头文件名，以转到头文件源清单。

    • 如果您选择了配置参数Code-to-model，要进入模型显示中的相应位置，可以点击这些构造的超链接:

      • 函数参数

      • 函数返回值

      • 表示导入的变量

      • 表示输出的变量

      • 接口参数(如果参数源是块)

      • 变量表示数据存储(如果数据存储源是数据存储内存块)

对于HTML代码生成报告中的向后和向前导航，请使用回来和向前上面的按钮内容部分，位于报告的左上角。

解释入口点函数小节

的入口点函数代码接口报告的子部分提供了以下关于每个模型入口点功能的接口信息，包括model_initialize，model_step，及(如适用)model_reset和model_terminate。

场 描述
函数 函数名。您可以单击函数名以转到它的定义模型。c。
原型 显示函数原型，包括函数返回值、名称和参数。
描述 提供应用程序中函数用途的文本描述。
时机 描述函数的定时特性，例如函数被调用多少次，或者是否定期调用，以及以什么时间间隔调用。有关多速率计时示例，请参见以下内容rtwdemo_mrmtbb报告摘录。
参数 如果函数有参数，则显示数字、名称、数据类型和Simulink金宝app®每个参数的描述。有关参数示例，请参见rtwdemo_fcnprotoctrl报告节选如下。
返回值 如果函数有返回值，该字段显示返回值的数据类型和Simulink描述。金宝app如果你选择了Code-to-model参数，您可以单击描述中的超链接进入模型显示中返回值对应的块。有关返回值的示例，请参见以下内容rtwdemo_fcnprotoctrl报告摘录。
头文件 函数头文件的名称。您可以单击头文件名以转到头文件源列表。

例如，这是入口点函数模型分段rtwdemo_configinterface。

入口点函数部分的代码接口报告。每个初始化、步骤和终止函数都有一个信息表。

为了说明如何为多速率模型列出计时信息，下面是入口点函数和港口模型的子部分rtwdemo_mrmtbb。这个多速率、离散时间、多任务模型包含import块1和2，分别指定1秒和2秒的采样时间。采样时间被约束在指定的时间内周期采样时间约束选项解算器窗格中的“配置参数”对话框。

入口点函数部分的代码接口报告。初始化函数和两个步骤函数各有一个信息表。

为了说明函数参数和返回值是如何在报告中显示的，下面是model的模型步骤函数的入口点函数描述rtwdemo_fcnprotoctrl。

rtwdemo_fcnprotocol_step_custom函数的信息表。

解释进口和出口小节

的港口和外港代码接口报告的子部分提供了关于模型中每个导入和导出的以下接口信息。

场 描述
块名称 显示输入或输出的Simul金宝appink块名称。如果你选择了Code-to-model参数，您可以单击每个导入或输出块名称值转到其在模型显示中的位置。
代码标识符

列出与生成的代码中的导入或输出数据关联的标识符，如下所示:

  • 如果数据是在生成的代码中定义的，则该字段显示标识符文本。

  • 如果在生成的代码中声明了数据但没有定义数据—例如，如果数据是用导入的存储类解析的—该字段将显示带有标签'前缀的标识符文本。进口数据:＇．

  • 如果数据在生成的代码中既没有定义也没有声明——例如，如果模型配置参数代码接口封装设为可重用的功能-该字段显示文本'定义外部＇．
数据类型 列出导入或输出的数据类型。
扩展

对于定点条目，使用Simulink定点数据类型表示法列出数据类型和分数长度。金宝app

请注意

您必须拥有定点设计器™许可证才能在报表中查看定点缩放信息。有关如何在表中表示缩放的详细信息，请参见定点数据类型和缩放表示法(定点设计师)。
维 列出进口或出口的尺寸(例如，1或(4、5)）.

例如，这里有港口和外港模型的子部分rtwdemo_configinterface。

一个表用于输入，一个表用于输出rtwdemo_configinterface模型。表中有用于每个端口的块名称、代码标识符、数据类型和维度的列。

解释接口参数小节

的接口参数代码接口报告的小节提供了以下关于与模型相关联的可调参数的接口信息。

场 描述
参数来源

列出参数值的来源，如下所示:

  • 如果参数值的来源是块，则该字段显示块的名称，如< Root > / Gain2或< S1 > / Lookup1。如果你选择了Code-to-model参数，您可以单击参数来源值转到参数在模型显示中的位置。

  • 如果参数值的来源是工作空间变量，则该字段显示工作空间变量的名称。
代码标识符

列出与生成代码中可调参数数据相关联的标识符，如下所示:

  • 如果数据是在生成的代码中定义的，则该字段显示标识符文本。

  • 如果在生成的代码中声明了数据但没有定义数据—例如，如果数据是用导入的存储类解析的—该字段将显示带有标签'前缀的标识符文本。进口数据:＇．

  • 如果数据在生成的代码中既没有定义也没有声明——例如，如果模型配置参数代码接口封装设为可重用的功能-该字段显示文本'定义外部＇．
数据类型 列出可调参数的数据类型。
扩展

对于定点条目，使用Simulink定点数据类型表示法列出数据类型和分数长度。金宝app

请注意

您必须拥有定点设计器许可证才能在报表中查看定点缩放信息。有关如何在表中表示缩放的详细信息，请参见定点数据类型和缩放表示法(定点设计师)。
维 列出可调参数的维度(例如，1或[4,5,6]）.

例如，这是接口参数模型分段rtwdemo_configinterface。

接口参数表。表中有用于每个接口参数的参数源、代码标识符、数据类型和维度的列。

解释数据存储小节

的数据存储代码接口报告的子部分提供了以下关于全局数据存储和非数据存储的接口信息汽车与模型相关联的存储。

场 描述
数据存储来源

列出数据存储内存的来源，如下所示:

  • 定义数据存储数据存储内存块，该字段显示块名称，例如< Root > /。如果你选择了Code-to-model参数，您可以单击数据存储来源值转到模型显示中数据存储的位置。

  • 定义数据存储金宝app仿真软件。信号对象的名称金宝app仿真软件。信号对象。
代码标识符

列出与生成的代码中的数据存储数据相关联的标识符，如下所示:

  • 如果数据是在生成的代码中定义的，则该字段显示标识符文本。

  • 如果在生成的代码中声明了数据但没有定义数据—例如，如果数据是用导入的存储类解析的—该字段将显示带有标签'前缀的标识符文本。进口数据:＇．

  • 如果数据在生成的代码中既没有定义也没有声明——例如，如果模型配置参数代码接口封装设为可重用的功能-该字段显示文本'定义外部＇．
数据类型 列出数据存储的数据类型。
扩展

对于定点条目，使用Simulink定点数据类型表示法列出数据类型和分数长度。金宝app

请注意

您必须拥有定点设计器许可证才能在报表中查看定点缩放信息。有关如何在表中表示缩放的详细信息，请参见定点数据类型和缩放表示法(定点设计师)。
维 列出数据存储的维度(例如，1或[1,2]）.

例如，这是数据存储模型分段rtwdemo_configinterface。

数据存储表。该表包含用于每个数据存储的数据存储源、代码标识符、数据类型和维度的列。

代码接口报告限制

这些限制适用于HTML代码生成报告的代码接口部分。

  • 代码接口报告支持大多数存储类解析的数据，除非存储类属金宝app性以以下方式之一设置:

    • 存储类属性类型设为FlatStructure。例如，当设置和结构体在Simulink包中的存储类金宝app类型设置为FlatStructure。

    • 存储类属性类型设为其他。例如，当GetSet在Simulink包中的存储类金宝app类型设置为其他。

    • 存储类属性数据访问设为指针，表明代码将导入的符号声明为指针变量，而不是简单变量。此属性仅在存储类属性时可访问数据范围设为进口或特定于。

    在这些情况下，报告显示为空数据类型和维字段。

  • 对于输出，如果优化内存，代码接口报告将无法描述相关的内存(数据类型和维度)。在这些情况下，报告显示为空数据类型和维字段。

  • 代码接口报告不支持使用控件替换数据类型金宝app代码生成>数据类型替换窗格中的“配置参数”对话框。报表中的数据类型链接到内置数据类型，而不是它们指定的替代数据类型。

相关的话题