主要内容

分析生成的数据代码接口

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

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

  • 入口点函数-各模型入口点功能的接口信息，包括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．这个多速率、离散时间、多任务模型包含导入块1和2，分别指定1秒和2秒采样时间。方法将采样时间限制为指定的时间周期采样时间约束选项解算器窗格中的“配置参数”对话框。

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

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

rtwdemo_fcnprotocol_step_custom函数的信息表。

解释输入和输出子节

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

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

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

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

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

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

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

请注意

您必须拥有Fixed-Point Designer™许可证才能在报告中查看定点伸缩信息。有关如何在表中表示缩放的详细信息，请参见定点数据类型和缩放符号(定点设计师)．
维 列出导入或输出端口的维度(例如，1或(4、5)）.

例如，这里是港口而且外港模型的子部分rtwdemo_configinterface．

一个信息表用于模型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代码生成>数据类型替换窗格中的“配置参数”对话框。报告中列出的数据类型链接到内置数据类型，而不是它们指定的替换数据类型。

相关的话题