Этот пример показывает вам, как сгенерировать код, который включает:
Функциональная подпись и функция помогают тексту в функциональном баннере.
Исходный код MATLAB® как комментарии с тегами трассируемости. В отчете генерации кода теги трассируемости соединяются с соответствующим исходным кодом MATLAB.
Чтобы завершить этот пример, у вас должны быть эти продукты:
MATLAB
MATLAB Coder™
Embedded Coder®
Компилятор C
Для списка поддерживаемых компиляторов см. Поддерживаемые Компиляторы.
В перезаписываемой папке создайте копию учебного файла.
copyfile(fullfile(docroot, 'toolbox', 'ecoder', 'examples', 'polar2cartesian.m'))
Создайте объект настройки генерации кода coder.EmbeddedCodeConfig
и установите эти свойства на true
:
GenerateComments
, чтобы позволить комментарии в сгенерированном коде.
MATLABSourceComments
, чтобы сгенерировать исходный код MATLAB как комментарии с тегами трассируемости. В отчете генерации кода теги соединяются с соответствующим кодом MATLAB. Когда этим свойством является true
, генератор кода также производит функциональную подпись в функциональном баннере.
MATLABFcnDesc
, чтобы сгенерировать функциональный текст справки в функциональном баннере.
cfg = coder.config('lib', 'ecoder', true); cfg.GenerateComments = true; cfg.MATLABSourceComments = true; cfg.MATLABFcnDesc = true;
Чтобы сгенерировать код С, вызовите функцию codegen
. Используйте эти опции:
-config
, чтобы передать в объекте cfg
настройки генерации кода.
-report
, чтобы создать отчет генерации кода.
-args
, чтобы задать класс, размер и сложность входных параметров.
codegen -config cfg -report polar2cartesian -args {0, 0}
codegen
генерирует статическую библиотеку C, polar2cartesian.lib
и код С в подпапке /codegen/lib/polar2cartesian
. Поскольку вы выбрали генерацию отчета, codegen
обеспечивает ссылку на отчет.
Просмотрите сгенерированный код в отчете генерации кода.
Чтобы открыть отчет генерации кода, нажмите View report
.
В панели Generated Code нажмите polar2cartesion.c
.
Сгенерированный код включает:
Функциональная подпись и функция помогают тексту в функциональном баннере.
Комментарии, содержащие исходный код MATLAB, который соответствует сгенерированному коду C/C++. Комментарий включает тег трассируемости, который соединяется с оригинальным кодом MATLAB.
Сгенерированный функциональный баннер также зависит от файла шаблона генерации кода (CGT). С CGT по умолчанию генератор кода помещает информацию об аргументах в функциональном баннере. Можно настроить функциональный баннер путем изменения CGT. Смотрите Генерируют Пользовательский Файл и Функциональные Баннеры для Кода C/C++.
Теги трассируемости предоставляют информацию и ссылки, которые помогают вам проследить сгенерированный код до оригинального кода MATLAB. Например, кликните по тегу трассируемости, который предшествует коду x = r * cos(theta);
.
Отчет открывает polar2cartesian.m
и подсвечивает строку 4.
Просмотреть исходный код MATLAB и сгенерировало код C/C++ друг рядом с другом и в интерактивном режиме прослеживать между ними, в отчете, нажимать Trace Code. Смотрите В интерактивном режиме Трассировку Между кодом MATLAB и Сгенерированным Кодом C/C++.