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

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

Источник (.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 или ert_main.cpp) на основе настроек параметров конфигурации модели Генерируют пример основная программа и Target operating system. Можно заменить поведение по умолчанию и сгенерировать a main программа настраивается для вашего целевого окружения.

Два файла TLC поддерживают генерацию примера main программный модуль:

В файле шаблона CFP в качестве примера matlabroot/toolbox/rtw/targets/ecoder/example_file_process.tlc, этот код генерирует сингл - или многозадачный пример main программный модуль. Логика зависит от информации, полученной от вызовов шаблона кода до 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 используйте интерфейс шаблонного программирования кода, чтобы сгенерировать пример main программные модули ert_main.c или ert_main.cpp.

По умолчанию генератор кода производит пример main программный модуль. Чтобы отключить генерацию того модуля, установите переменную TLC OverrideSampleERTMain к TLC_TRUE.

Например:

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

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

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

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

Этот код показывает, как очистить Генерировать пример основной параметр программы в контексте SelectCallback функция.

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

Создание a main программа для вашего целевого окружения требует индивидуальной настройки. Например, в среде несмонтированной платы, необходимо присоединить rt_OneStep к прерыванию по таймеру и настраивают сгенерированный код, генерация код TLC или оба. Для получения дополнительной информации см. Инструкции для Изменения Основной Программы и Инструкций для Изменения rt_OneStep.