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

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

Источник (.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);
}

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

The 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 модуль на основе настроек Generate a example main program и опций Target operating system на панели Templates диалогового окна Параметры Конфигурации. Можно использовать шаблон 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 функция для вашей цели. A SelectCallback функция является функцией MATLAB, которая запускается при:

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

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

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

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