Embedded Coder生成C代码注释

学习目标

本教程将向您说明如何生成包含以下内容的代码：

• 在函数前注中包含函数签名和函数帮助文本。
• 包含 MATLAB® 源代码，以带有可追溯性标记的注释表示。在代码生成报告中，可追溯性标记链接到对应的 MATLAB 源代码。

前提条件

要完成本教程，您必须拥有以下产品：

• MATLAB
• MATLAB Coder™
• Embedded Coder®
• C 编译器

创建 MATLAB 源文件

在一个可写文件夹中，创建包含以下代码的 MATLAB 源文件 polar2cartesian.m：

function [x y] = polar2cartesian(r,theta)

%#codegen

% Convert polar to Cartesian

x = r * cos(theta);

y = r * sin(theta);

配置编译参数

创建 coder.EmbeddedCodeConfig 代码生成配置对象，并将下列属性设置为 true：

• GenerateComments，允许在生成的代码中包含注释。
• MATLABSourceComments，生成含可追溯性标记的注释，指向 MATLAB 源代码。在代码生成报告中，这些标记链接到对应的 MATLAB 代码。当此属性为 true 时，代码生成器还会在函数前注中生成函数签名。
• MATLABFcnDesc，以在函数前注中生成函数帮助文本。

cfg = coder.config('lib', 'ecoder', true);

cfg.GenerateComments = true;

cfg.MATLABSourceComments = true;

cfg.MATLABFcnDesc = true;

生成 C 代码

要生成 C 代码，请调用 codegen 函数。设置以下选项：

• -config，用于传入代码生成配置对象 cfg。
• -report，用于创建代码生成报告。
• -args，用于指定输入参数的类、大小和复/实性。

codegen -config cfg  -report polar2cartesian -args {0, 0}

codegen 在 /codegen/lib/polar2cartesian 子文件夹中生成 C 静态库 polar2cartesian.lib 和 C 代码。因为您选择了生成报告，所以 codegen 会提供指向该报告的链接。

查看生成的 C 代码

在代码生成报告中查看生成的代码。

1. 要打开代码生成报告，请点击查看报告。
2. 在生成的代码窗格中，点击 polar2cartesion.c。

生成的代码包括：

• • 在函数前注中包含函数签名和函数帮助文本。
  • 包含与生成的 C/C++ 代码对应的 MATLAB 源代码的注释。该注释包含链接到原始 MATLAB 代码的可追溯性标记。

生成的函数前注也取决于代码生成模板 (CGT) 文件。使用默认 CGT 时，代码生成器将有关参数的信息放置在函数前注中。您可以通过修改 CGT 来自定义函数前注。

将生成的代码追溯到 MATLAB 代码

可追溯性标记提供的信息和链接可帮助您将生成的代码追溯回原始 MATLAB 代码。例如，点击代码 x = r * cos(theta); 之前的可追溯性标记。

该报告将打开 polar2cartesian.m 并突出显示第 4 行。

要查看 MATLAB 源代码和生成彼此相邻的 C/C++ 代码并在它们之间交互追溯，请在报告中点击追溯代码。