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

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

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

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

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

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

Шаблон API кода позволяет вам разделить код, сгенерированный к каждому файлу в разделы, помеченные как Definitions, IncludesФункции, 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 файл, сгенерированный в предыдущем примере, был независим от стандартных файлов кода, сгенерированных из модели (например, modelC или .cpp, modelH, и так далее). Можно использовать подобные методы, чтобы сгенерировать пользовательский код в файлах модели. Шаблон API кода включает функции, чтобы получить имена стандартных файлов моделей и другой связанной с моделью информации. Следующая выборка вызывает LibGetMdlPubHdrBaseName получить имя для modelH файл. Это затем получает ссылку на файл и генерирует определение в Defines раздел modelH:

%% 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, которая инициирована когда вы:

Ваш SelectCallback функция должна отменить выбор и отключить Генерировать пример основная опция программы. Это предотвращает переменную TLC GenerateSampleERTMain от того, чтобы быть установленным до TLC_TRUE.

Смотрите раздел Structure rtwgensettings для получения информации о создании SelectCallback функция.

Следующий код иллюстрирует, как отменить выбор и отключить Генерировать пример основная опция программы в контексте SelectCallback функция.

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