Документация

Генерация файлов кода

Источник (.c или .cpp) и заголовок (.h) файлы создается путем вызова LibCreateSourceFile, как в следующих выборках:

%assign cFile = LibCreateSourceFile("Source", "Custom", "timestwo")
...
%assign hFile = LibCreateSourceFile("Header", "Custom", "timestwo")

Последующий код относится к файлам ссылкой на файл, возвращенной в LibCreateSourceFile.

Разделы файлов и буферы

Шаблон API кода позволяет вам разделить код, сгенерированный к каждому файлу в разделы, помеченные как Definitions, Includes, Functions, Banner, и так далее. Можно добавить код к каждому разделу так же много раз как требуется. Этот метод дает вам большую гибкость в форматировании ваших файлов пользовательского кода.

Подразделы, Заданные для Встроенных Разделов, описывают доступные разделы файлов и их порядок в сгенерированном файле.

Для каждого раздела сгенерированного файла используйте %openfile и %closefile, чтобы сохранить текст для того раздела во временных буферах. Затем чтобы записать (добавляют) содержимое буфера к разделу файла, вызывают LibSetSourceFileSection, передающий в желаемом теге раздела и ссылке на файл. Например, следующий код использует два буфера (typesBuf, и tmpBuf), чтобы сгенерировать два раздела (пометил "Includes" и "Functions") исходного файла timestwo.c или .cpp (ссылаемый как cFile):

%openfile typesBuf

#include "rtwtypes.h"

%closefile typesBuf

%<LibSetSourceFileSection(cFile,"Includes",typesBuf)>

 %openfile tmpBuf

 /* Times two function */
 real_T timestwofcn(real_T input) {
   return (input * 2.0);
}

%closefile tmpBuf

%<LibSetSourceFileSection(cFile,"Functions",tmpBuf)>

Эти два раздела генерируют целый timestwo.c или файл .cpp:

#include "rtwtypes.h"

/* Times two function */
FLOAT64 timestwofcn(FLOAT64 input)
{
  return (input * 2.0);
}

Добавление кода к стандартным сгенерированным файлам

Файл timestwo.c или .cpp, сгенерированный в предыдущем примере, был независим от стандартных файлов кода, сгенерированных из модели (например, model.c или .cpp, model.h, и так далее). Можно использовать подобные методы, чтобы сгенерировать пользовательский код в образцовых файлах. Шаблон API кода включает функции, чтобы получить имена стандартных файлов моделей и другой связанной с моделью информации. Следующая выборка вызывает LibGetMdlPubHdrBaseName, чтобы получить имя для файла model.h. Это затем получает ссылку на файл и генерирует определение в разделе Defines model.h:

%% Add a #define to the model's public header file model.h

%assign pubName = LibGetMdlPubHdrBaseName()
%assign modelH  = LibCreateSourceFile("Header", "Simulink", pubName)

%openfile tmpBuf

 #define ACCELERATION 9.81

 %closefile tmpBuf

%<LibSetSourceFileSection(modelH,"Defines",tmpBuf)>

Исследуйте сгенерированный файл rtwdemo_udt.h, чтобы видеть сгенерированную директиву #define.

Настройка основной генерации программного модуля

Обычно, цель ERT определяет, ли и как сгенерировать ert_main.c или модуль .cpp на основе настроек Того, чтобы генерировать пример основная программа и опции Target operating system на панели Templates диалогового окна Configuration Parameters. Можно использовать шаблон CFP, чтобы заменить нормальное поведение и сгенерировать основной программный модуль, настроенный для целевого окружения.

Чтобы поддержать генерацию основных программных модулей, два файла TLC обеспечиваются:

В файле шаблона CFP в качестве примера matlabroot/toolbox/rtw/targets/ecoder/example_file_process.tlc следующий код генерирует или сингл - или многозадачный ert_main.c или модуль .cpp. Логика зависит от информации, полученной из вызовов API шаблона кода LibIsSingleRateModel и LibIsSingleTasking:

%% Create a simple main.  Files are located in MATLAB/rtw/c/tlc/mw.

 %if LibIsSingleRateModel() || LibIsSingleTasking()
   %include "bareboard_srmain.tlc"
   %<FcnSingleTaskingMain()>
 %else
   %include "bareboard_mrmain.tlc"
   %<FcnMultiTaskingMain()>
 %endif

Обратите внимание на то, что bareboard_srmain.tlc и bareboard_mrmain.tlc используют шаблон API кода, чтобы сгенерировать ert_main.c или .cpp.

При генерации собственного основного программного модуля вы отключаете генерацию по умолчанию ert_main.c или .cpp. Переменная TLC GenerateSampleERTMain управляет генерацией ert_main.c или .cpp. Можно непосредственно обеспечить эту переменную к TLC_FALSE. Примеры bareboard_mrmain.tlc и bareboard_srmain.tlc используют этот метод, как показано в следующей выборке от bareboard_srmain.tlc.

%if GenerateSampleERTMain
    %assign CompiledModel.GenerateSampleERTMain = TLC_FALSE
    %warning Overriding example ert_main.c!
%endif

Также можно реализовать функцию SelectCallback для цели. Функцией SelectCallback является функция MATLAB, которая инициирована когда вы:

slConfigUISetVal(hDlg, hSrc, 'GenerateSampleERTMain', 'off');
slConfigUISetEnabled(hDlg, hSrc, 'GenerateSampleERTMain',0);