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

Создание файлов кода

Источник (.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 на основе настроек параметров Создать основную программу (Generate a example main program) и Целевая операционная система (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 функция для цели. A SelectCallback функция - это функция MATLAB, запускаемая при выполнении следующих действий:

Ваш SelectCallback функция должна отменить выбор и отключить параметр Generate a example main program. Это предотвращает использование переменной TLC GenerateSampleERTMain от установлено до TLC_TRUE.

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

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

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