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

Обзор

Этот раздел является руководством по структуре и содержимому системного конечного файла. Следующий листинг показывает общую структуру системного конечного файла. Обратите внимание на то, что это не полный листинг кода системного конечного файла. Листинг состоит из выборок от каждого из разделов, которые составляют системный конечный файл.

%%----------------------------
%% Header Comments Section
%%----------------------------
%% SYSTLC: Example Real-Time Target
%%    TMF: my_target.tmf MAKE: make_rtw
%% Initial comments contain directives for STF Browser.
%% Documentation, date, copyright, and other info may follow.
          ...
%selectfile NULL_FILE
         ...
%%----------------------------
%% TLC Configuration Variables Section
%%----------------------------
%% Assign code format, language, target type.
%%
%assign CodeFormat = "Embedded-C"
%assign TargetType = "RT"
%assign Language   = "C"
%%
%%----------------------------
%% TLC Program Entry Point
%%----------------------------
%% Call entry point function.
%include "codegenentry.tlc"
%%
%%----------------------------
%% (OPTIONAL) Generate Files for Build Process
%%----------------------------
%include "mytarget_genfiles.tlc"
%%----------------------------
%% RTW_OPTIONS Section
%%----------------------------
/%
  BEGIN_RTW_OPTIONS
  %% Define rtwoptions structure array. This array defines target-specific
  %% code generation variables, and controls how they are displayed.
  rtwoptions(1).prompt = 'example code generation options';
        ...
  rtwoptions(6).prompt = 'Show eliminated blocks';
  rtwoptions(6).type = 'Checkbox';
         ...
  %----------------------------------------%
  % Configure RTW code generation settings %
  %----------------------------------------%
         ...
  %%----------------------------
  %% rtwgensettings Structure
  %%----------------------------
  %% Define suffix text for naming build folder here.
  rtwgensettings.BuildDirSuffix = '_mytarget_rtw'
  %% Callback compatibility declaration
  rtwgensettings.Version = '1';

  %% (OPTIONAL) target inheritance declaration
  rtwgensettings.DerivedFrom = 'ert.tlc';
  %% (OPTIONAL) other rtwGenSettings fields...
         ...
  END_RTW_OPTIONS
%/
%%----------------------------
%% targetComponentClass - MATHWORKS INTERNAL USE ONLY
%% REMOVE NEXT SECTION FROM USER_DEFINED CUSTOM TARGETS
%%----------------------------
/%
  BEGIN_CONFIGSET_TARGET_COMPONENT
  targetComponentClass = 'Simulink.ERTTargetCC';
  END_CONFIGSET_TARGET_COMPONENT
%/

Если вы создаете пользовательскую цель на основе существующего системного конечного файла, необходимо удалить targetComponentClass раздел (ограниченный директивами BEGIN_CONFIGSET_TARGET_COMPONENT и END_CONFIGSET_TARGET_COMPONENT). Этот раздел резервируется для использования целей, разработанных внутренне MathWorks.

Комментарии заголовка

Эти линии во главе файла отформатированы, как комментирует TLC. Они предоставляют запрошенную информацию Системному Браузеру Конечного файла и процессу сборки. Обратите внимание на то, что необходимо поместить комментарии браузера во главе файла перед другими комментариями или операторами TLC.

Присутствие комментариев позволяет генератору кода обнаружить системные конечные файлы. Когда Системный Браузер Конечного файла открыт, генератор кода сканирует путь MATLAB для файлов TLC, которые отформатировали комментарии заголовка. Комментарии содержат следующие директивы:

Следующие комментарии заголовка от matlabroot/rtw/c/ert/ert.tlc.

%% SYSTLC: Embedded Coder TMF: ert_default_tmf MAKE: make_rtw
%% SYSTLC: Create Visual C/C++ Solution File for Embedded Coder\
%%    TMF: RTW.MSVCBuild MAKE: make_rtw
.
.
.

Каждый комментарий может только содержать максимум двух линий.

Если вы не задаете TMF поле в системном конечном файле, файл все еще допустим. Изменить значение для theTemplateMakefile параметр, можно вместо этого использовать функцию обратного вызова, заданную rtwgensettings.SelectCallback.

Можно также использовать функцию обратного вызова, заданную rtwgensettings.SelectCallback изменить значение для параметров режима external mode, ExtMode, ExtModeTransport, ExtModeMexFile, или ExtModeIntrfLevel.

Можно задать больше чем одну группу директив в комментариях заголовка. Каждая такая группа отображена как различная целевая настройка в Системном Браузере Конечного файла. В вышеупомянутом примере первые две строки кода задают настройку по умолчанию цели ERT. Следующие две линии задают настройку, которая создает и создает Microsoft^® Visual C++^® Решение (.sln) файл. Рисунок ниже показывает, как эти настройки появляются в Системном Браузере Конечного файла.

Смотрите Создают Пользовательскую Целевую Настройку для примера индивидуально настраиваемых комментариев заголовка.

Переменные настройки TLC

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

Для целевого процессора в большинстве случаев необходимо просто использовать глобальные настройки переменной TLC, используемые целью ERT (ert.tlc). Особенно важно что ваше системное использование конечного файла 'Embedded-C' значение для CodeFormat Переменная TLC и использование соответствующий rtwgensettings.DerivedFrom = 'ert.tlc' в RTW_OPTIONS раздел файла TLC. Проверьте, что значения присвоены следующим переменным:

Точка входа программы TLC и связанный %includes

Процесс генерации кода обычно начинается с codegenentry.tlc. Системный конечный файл invokes codegenentry.tlc можно следующим образом.

%include "codegenentry.tlc"

Если необходимо реализовать целевые опции генерации кода, необходимо включать файл TLC mytarget_genfiles.tlc в вашем системном конечном файле. Этот файл обеспечивает механизм для выполнения пользовательского кода TLC до и после вызова codegenentry.tlc. Для получения информации об этом механизме смотрите

Другой способ настроить процесс генерации кода состоит в том, чтобы вызвать функции низшего уровня (обычно вызванный codegenentry.tlc) непосредственно, и включайте свои собственные функции TLC в каждый этап процесса. Этот подход должен быть проявлен с осторожностью. См. Файлы TLC для получения дополнительной информации.

Функции низшего уровня вызваны codegenentry.tlc

Раздел RTW_OPTIONS

RTW_OPTIONS раздел ограничен директивами:

/%
  BEGIN_RTW_OPTIONS
.
.
.
  END_RTW_OPTIONS
%/

Первая часть RTW_OPTIONS раздел задает массив rtwoptions структуры. Эта структура обсуждена в Использовании rtwoptions, чтобы Отобразить Пользовательские Целевые Опции.

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

Структура rtwgensettings

Итоговая часть системного конечного файла задает rtwgensettings структура. Эта структура хранит информацию, которая записана в model.rtw файл и используемый процессом сборки. rtwgensettings поля большей части интереса предназначаться для разработчиков

Опции генерации дополнительного кода

Сконфигурируйте Сгенерированный код с TLC, описывает дополнительные переменные генерации кода TLC. Конечные пользователи цели могут присвоить эти переменные путем ввода команды MATLAB формы

set_param(modelName,'TLCOptions','-aVariable=val');

(Для получения дополнительной информации смотрите, Задают TLC для Генерации кода.)

Однако предпочтительный подход должен присвоить эти переменные в системных операторах использования конечного файла формы:

%assign Variable = val

Для удобочитаемости мы рекомендуем, чтобы вы добавили такие присвоения в разделе системного конечного файла после комментария Configure RTW code generation settings.

Факторы модели - ссылки

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

Используя rtwoptions, чтобы Отобразить Пользовательские Целевые Опции

Вы управляете опциями, чтобы отобразиться в панели Code Generation в диалоговом окне Configuration Parameters путем настройки rtwoptions структура в вашем системном конечном файле.

Поля rtwoptions структура задает переменные и сопоставленные элементы пользовательского интерфейса, которые будут отображены в диалоговом окне Configuration Parameters. Используя rtwoptions массив структур, можно задать целевые опции, отображенные в диалоговом окне, и организовать опции в категории. Можно также записать функции обратного вызова, чтобы задать, как эти опции обрабатываются.

Когда панель Code Generation открывается, rtwoptions массив структур сканируется, и перечисленные опции отображены. Каждая опция представлена элементом интерфейса назначенного пользователя (флажок, поле редактирования, меню или кнопка), который отображает текущее значение опции.

Элементы пользовательского интерфейса могут быть в активированном, или отключенное (появляется, потускнел), состояние. Если опция включена, пользователь может изменить значение опции. Если опция отключена, опция использует значение по умолчанию, и пользователь не может изменить значение опции.

Можно также использовать rtwoptions массив структур, чтобы задать специальные элементы NonUI, которые заставляют функции обратного вызова выполняться, но которые не отображены в панели Code Generation. Смотрите Элементы NonUI.

Элементы rtwoptions массив структур организован в группы. Каждая группа элементов начинается с элемента заголовка типа Category. Поле по умолчанию Category заголовок должен содержать количество остающихся элементов в категории.

Category заголовок сопровождается опциями, которые будут отображены на панели Code Generation. Заголовок в каждой категории сопровождается одним или несколькими элементами определения опции.

Каждая категория целевых опций соответствует опциям, перечисленным под Code Generation в диалоговом окне Configuration Parameters.

Таблица rtwoptions Полевые Сводные данные Структуры суммирует поля rtwoptions структура.

Пример rtwoptions Структура.  Следующий rtwoptions структура выбирается от системного конечного файла в качестве примера, matlabroot/toolbox/rtw/rtwdemos/rtwoptions_demo/usertarget.tlc. Код задает rtwoptions массив структур. Поле по умолчанию первого (заголовок) элемент установлено в 4, указание на число элементов, которые следуют за заголовком.

  rtwoptions(1).prompt        = 'userPreferred target options (I)';
  rtwoptions(1).type          = 'Category';
  rtwoptions(1).enable        = 'on';
  rtwoptions(1).default       = 4;   % number of items under this category
                                     % excluding this one.
  rtwoptions(1).popupstrings  = '';  % At the first item, user has to 
  rtwoptions(1).tlcvariable   = '';  % initialize all supported fields
  rtwoptions(1).tooltip       = '';
  rtwoptions(1).callback      = '';
  rtwoptions(1).makevariable  = '';

  rtwoptions(2).prompt        = 'Execution Mode';
  rtwoptions(2).type          = 'Popup';
  rtwoptions(2).default       = 'Real-Time';
  rtwoptions(2).popupstrings  = 'Real-Time|UserDefined';
  rtwoptions(2).tlcvariable   = 'tlcvariable1';
  rtwoptions(2).tooltip       = ['See this text as tooltip'];

  rtwoptions(3).prompt        = 'Log Execution Time';
  rtwoptions(3).type          = 'Checkbox';
  rtwoptions(3).default       = 'on';
  rtwoptions(3).tlcvariable   = 'RL32LogTETModifier';
  rtwoptions(3).tooltip       = ['']; % no tooltip

  rtwoptions(4).prompt        = 'Real-Time Interrupt Source';
  rtwoptions(4).type          = 'Popup';
  rtwoptions(4).default       = 'Timer';
  rtwoptions(4).popupstrings  = 'Timer|5|6|7|8|9|10|11|12|13|14|15';
  rtwoptions(4).tlcvariable   = 'tlcvariable3';
  rtwoptions(4).callback      = 'usertargetcallback(hDlg, hSrc, ''tlcvariable3'')';
  rtwoptions(4).tooltip       = [''];
  rtwoptions(4).tooltip       = ['See TLC file for how to use reserved '...
    ' keyword ''hDlg'', and ''hSrc''.'];
...
  rtwoptions(5).prompt        = 'Signal Logging Buffer Size in Doubles';
  rtwoptions(5).type          = 'Edit';
  rtwoptions(5).default       = '100000';
  rtwoptions(5).tlcvariable   = 'tlcvariable2';
  rtwoptions(5).tooltip       = [''];

Первый элемент добавляет панель userPreferred target options (I) под Code Generation в диалоговом окне Configuration Parameters. Панель отображает опции, заданные в rtwoptions(2), rtwoptions(3), rtwoptions(4), и rtwoptions(5).

Если вы хотите задать большое количество опций, можно задать несколько Category группы в конечном файле единой системы.

Отметьте rtwoptions структура и коллбэки написаны в коде MATLAB, несмотря на то, что они встраиваются в файл TLC. Проверять синтаксис вашего rtwoptions определения структуры и код, можно выполнить команды в подсказке MATLAB путем копирования и вставки их к командному окну MATLAB.

Узнать больше о usertarget.tlc и файлы коллбэка в качестве примера, которым предоставляют его, смотрите Системный Конечный файл В качестве примера С Индивидуально настраиваемым rtwoptions. Для большего количества примеров целевого rtwoptions определения, смотрите target.tlc файлы под matlabroot/rtw/c открытый.

Полевые Сводные данные Структуры rtwoptions перечисляют поля rtwoptions структура.

'rt_|_rt|none'

Элементы NonUI.  Элементы rtwoptions массив, которые имеют, вводит NonUI существуйте только, чтобы вызвать коллбэки. NonUI элемент не отображен в диалоговом окне Configuration Parameters. Можно использовать NonUI элемент, если вы хотите выполнить коллбэк, который не сопоставлен с элементом пользовательского интерфейса, когда диалоговое окно открывается или закрывается. Смотрите следующий раздел, Системный Конечный файл В качестве примера С Индивидуально настраиваемым rtwoptions для примера.

Системный Конечный файл в качестве примера С Индивидуально настраиваемым rtwoptions

Рабочий системный конечный файл, с функциями обратного вызова файла MATLAB, был обеспечен как пример того, как использовать rtwoptions структура, чтобы отобразиться и обработать пользовательские опции на панели Code Generation. Примеры совместимы с API коллбэка.

Конечные файлы в качестве примера находятся в (открытой) папке:

matlabroot/toolbox/rtw/rtwdemos/rtwoptions_demo

Конечные файлы в качестве примера включают:

Обратитесь к файлам в качестве примера при чтении этого раздела. Системный конечный файл в качестве примера, usertarget.tlc: иллюстрирует использование rtwoptions отобразить следующие пользовательские целевые опции:

Попытайтесь изучить пример кода при взаимодействии с целевыми опциями в качестве примера в диалоговом окне Configuration Parameters. Взаимодействовать с конечным файлом в качестве примера,

Наследование целевых опций

ert.tlc обеспечивает основной набор Embedded Coder^® опции генерации кода. Если ваша цель основана на ert.tlc, ваш системный конечный файл должен обычно наследовать опции, заданные в ERT.

Используйте rtwgensettings.DerivedFrom поле в rtwgensettings структура, чтобы задать системный конечный файл, от которого должны быть наследованы опции. Необходимо преобразовать пользовательскую цель, чтобы использовать этот механизм можно следующим образом.

Установите rtwgensettings.DerivedFrom значение поля как в следующем примере:

rtwgensettings.DerivedFrom = 'stf.tlc';

где stf имя системного конечного файла, от которого должны быть наследованы опции. Например:

rtwgensettings.DerivedFrom = 'ert.tlc';

Когда диалоговое окно Configuration Parameters выполняет эту строку кода, оно включает опции от stf.tlc автоматически. Если stf.tlc MathWorks внутренний системный конечный файл, который был преобразован в новое размещение, диалоговое окно отображается наследованные опции с помощью нового размещения.

Обработка Неподдерживаемых Опций.  Если ваша цель не поддерживает все опции, наследованные от ert.tlc, необходимо обнаружить неподдерживаемые настройки опции и отобразить предупреждающее сообщение или сообщение об ошибке. В некоторых случаях, если пользователь выбрал опцию, ваша цель не поддерживает, вы, возможно, должны прервать процесс сборки. Например, если ваша цель не поддерживает Генерировать пример основная опция программы, процессу сборки нельзя позволить продолжить, если та опция выбрана.

Даже при том, что ваша цель не может поддержать, все наследовали опции ERT, требуется, что опции ERT сохраняются в панели Code Generation диалогового окна Configuration Parameters. Просто не удаляйте неподдерживаемые опции из rtwoptions структура в системном конечном файле. Опции должны быть в диалоговом окне, которое будет отсканировано генератором кода, когда это выполняет оптимизацию.

Например, можно хотеть препятствовать тому, чтобы пользователи выключили опцию функции выхода/обновления Single. Может казаться разумным удалить эту опцию из диалогового окна и просто присвоить переменную TLC CombineOutputUpdateFcns к on. Однако, если опция не включена в диалоговое окно, генератор кода принимает, что выводит и обновляются, функции не должны быть объединены. Менее эффективный код сгенерирован в результате.

Введение

Следующие разделы включают информацию о методах для настройки вашего системного конечного файла, включая:

Требуемый и рекомендуемый %includes

Если необходимо реализовать целевые опции генерации кода, мы рекомендуем, чтобы системный конечный файл включал файл TLC mytarget_genfiles.tlc.

Если ваш системный конечный файл настроил необходимую среду TLC, необходимо включать codegenentry.tlc запустить стандартный процесс генерации кода.

mytarget_genfiles.tlc обеспечивает механизм для выполнения пользовательского кода TLC после основной точки входа генерации кода. Смотрите Используя mytarget_genfiles.tlc.

Используя mytarget_genfiles.tlc.  mytarget_genfiles.tlc (дополнительный) полезно как центральный файл, из которого можно вызвать целевые файлы TLC, которые генерируют дополнительные файлы как часть вашего целевого процесса сборки. Например, ваша цель может создать подmake-файлы или файлы проекта для среды разработки или командные сценарии для отладчика, чтобы сделать автоматические загрузки.

Процесс сборки может затем вызвать эти сгенерированные файлы или непосредственно от сделать процесса или после того, как исполняемый файл будет создан. Это сделано с STF_make_rtw_hook.m механизм, как описано в Настраивают Процесс сборки с Файлом STF_make_rtw_hook.

Следующий код TLC показывает примеру mytarget_genfiles.tlc файл.

%selectfile NULL_FILE

%assign ModelName = CompiledModel.Name

%% Create Debugger script
%assign model_script_file = "%<ModelName>.cfg"
%assign script_file = "debugger_script_template.tlc"

%if RTWVerbose
   %selectfile STDOUT
   ### Creating %<model_script_file>
   %selectfile NULL_FILE
%endif

%include "%<script_file>"
%openfile bld_file = "%<model_script_file>"
%<CreateDebuggerScript()>
%closefile bld_file

Обработка псевдонимов для целевых значений опции

В этом разделе описываются служебные функции, которые могут использоваться, чтобы обнаружить и разрешить значения псевдонима или устаревшие значения при тестировании пользовательских заданных значений на тип целевого устройства (ProdHWDeviceType) и заменяющая библиотека кода (CodeReplacementLibrary).

RTW.isHWDeviceTypeEq.  Чтобы протестировать, если два значения типа целевого устройства представляют то же аппаратное устройство, вызовите следующую функцию:

result = RTW.isHWDeviceTypeEq(type1,type2)

где type1 и type2 векторы символов, содержащие значения типа целевого устройства или псевдонимы.

RTW.isHWDeviceTypeEq функция возвращает true если type1 и type2 векторы символов, представляющие то же аппаратное устройство. Например, следующий вызов возвращает true:

RTW.isHWDeviceTypeEq('Specified','Generic->Custom')

Поскольку описание целевого устройства вводит опцию ProdHWDeviceType, смотрите информацию о командной строке для поставщика Устройства параметров панели Hardware Implementation и Типа устройства.

RTW.resolveHWDeviceType.  Чтобы возвратить значение типа устройства для аппаратного устройства, учитывая значение, которое может быть псевдонимом или устаревшим значением, вызывают следующую функцию:

result = RTW.resolveHWDeviceType(type)

где type вектор символов, содержащий значение типа целевого устройства или псевдоним.

RTW.resolveHWDeviceType функция возвращает значение типа устройства устройства. Например, следующие вызовы оба возвращают 'Generic->Custom':

RTW.resolveHWDeviceType('Specified')
RTW.resolveHWDeviceType('Generic->Custom')

Поскольку описание целевого устройства вводит опцию ProdHWDeviceType, смотрите информацию о командной строке для поставщика Устройства параметров панели Hardware Implementation и Типа устройства.

RTW.isTflEq.  Чтобы протестировать, если два имени заменяющей библиотеки кода (CRL) представляют тот же CRL, вызовите следующую функцию:

result = RTW.isTflEq(name1,name2)

где name1 и name2 векторы символов, содержащие значения CRL или псевдонимы.

RTW.isTflEq функция возвращает true если name1 и name2 векторы символов, представляющие ту же заменяющую библиотеку кода. Например, следующий вызов возвращает true:

RTW.isTflEq('GNU','GNU C99 extensions')

Для описания CodeReplacementLibrary параметр, смотрите заменяющую библиотеку Кода.

RTW.resolveTflName.  Чтобы возвратить значение CRL для заменяющей библиотеки кода, учитывая значение, которое может быть псевдонимом или устаревшим значением, вызывают следующую функцию:

result = RTW.resolveTflName(name)

где name вектор символов, содержащий значение CRL или псевдоним.

RTW.resolveTflName функция возвращает значение заменяющей библиотеки кода, на которую ссылаются. Например, следующие вызовы оба возвращают 'GNU C99 extensions':

RTW.resolveTflName('GNU')
RTW.resolveTflName('GNU C99 extensions')

Для описания CodeReplacementLibrary параметр, смотрите заменяющую библиотеку Кода.

Поддержка нескольких сред разработки

Ваша цель может потребовать поддержки нескольких сред разработки (например, двух или больше кросс-компиляторов) или нескольких режимов генерации кода (например, генерируя бинарный исполняемый файл по сравнению с генерацией файла проекта для вашего компилятора).

Один подход к этому требованию должен реализовать несколько системных конечных файлов. Каждый системный конечный файл вызывает make-файл шаблона для среды разработки. Это составляет обеспечение двух отдельных целей.

Обновление пользовательского системного конечного файла

Обновление вашего пользовательского системного конечного файла может повлиять на значения опции модели, которую вы загружаете, который использует обновленный системный конечный файл. Если вы отключаете опцию, обновленный системный конечный файл использует значение по умолчанию для той опции. Если модель имеет различное значение для той опции, когда вы загружаете модель с обновленным системным конечным файлом, значение из модели отбрасывается, и системный конечный файл использует значение по умолчанию вместо этого.

Введение

Этот пример может добавить целевые руководства в качестве примера, описанные в Демонстрационных Пользовательских Целях. Для введения и файлов в качестве примера, попробуйте цели в качестве примера сначала.

Этот пример провел вас по процессу создания основанной на ERT цели, my_ert_target. Это осуществление иллюстрирует несколько задач, которые типичны для создания пользовательской цели:

Во время этого осуществления вы реализуете операционную, но скелетную, основанную на ERT цель. Эта цель может быть полезной как начальная точка в полноценном внедрении пользовательского целевого процессора.

Обзор my_ert_target

В следующих разделах вы создаете скелетную цель, my_ert_target. Цель наследовала и поддерживает стандартные опции цели ERT и отображает дополнительные целевые опции в диалоговом окне Configuration Parameters (см. Целевые Опции для my_ert_target).

my_ert_target поддерживает основанную на наборе инструментальных средств сборку, генерируя код и исполняемые файлы, которые работают на хост-системе. my_ert_target использует lcc компилятор на Microsoft Windows^® платформа. Выбранный компилятор легко доступен и распределяется с генератором кода. На платформе Microsoft Windows, если вы используете различный компилятор, можно настроить lcc временно как ваш компилятор по умолчанию через следующую команду MATLAB:

mex -setup

Программное обеспечение отображает ссылки для поддерживаемых компиляторов, которые установлены на вашем компьютере. Нажмите lcc ссылка.

Можно протестировать my_ert_target с моделью, которая совместима с целью ERT (см., Конфигурируют Системный Конечный файл (Embedded Coder)). Сгенерированные программы действуют тождественно к сгенерированным программам ERT.

Чтобы упростить тестирование вашей цели, протестируйте с targetmodel, очень простая модель фиксированного шага (см., Создает Тестовую модель и S-функцию). Блок s-function в targetmodel использует исходный код от timestwo пример, и генерирует полностью встроенный код. Смотрите Примеры S-функции и Встройте S-функции с TLC для дальнейшего обсуждения timestwo S-функция в качестве примера.

Создание целевых папок

Создайте папки, чтобы хранить конечные файлы и добавить их в путь MATLAB, в соответствии с рекомендуемыми соглашениями (см. Соглашения о присвоении имен Папки и Файла). Вы также создаете папку, чтобы сохранить тестовую модель, S-функцию и сгенерированный код.

Этот пример принимает, что ваши целевые и папки модели расположены в папке c:/work. Не помещайте свои целевые и папки модели в дереве папки MATLAB (то есть, в или под matlabroot папка).

Создать папки и сделать их доступными:

Создайте основанный на ERT, набор инструментальных средств совместимый системный конечный файл

Создайте системный конечный файл для своей цели путем копирования и изменения стандартного системного конечного файла для цели ERT. Затем подтвердите системный конечный файл путем просмотра новой цели в Системном Браузере Конечного файла и в диалоговом окне Configuration Parameters.

Редактирование Системного Конечного файла.  Чтобы отредактировать системный конечный файл, используйте эти шаги:

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

function enableToolchainCompliant(hSrc, hDlg)
  % The following parameters enable toolchain compliance.
  slConfigUISetVal(hDlg, hSrc, 'UseToolchainInfoCompliant', 'on');
  slConfigUISetVal(hDlg, hSrc, 'GenerateMakefile','on');
  
  % The following parameters are not required for toolchain compliance.
  % But, it is recommended practice to set these default values and 
  % disable the parameters (as shown).
  slConfigUISetVal(hDlg, hSrc, 'RTWCompilerOptimization','off');
  slConfigUISetVal(hDlg, hSrc, 'MakeCommand','make_rtw');
  slConfigUISetEnabled(hDlg, hSrc, 'RTWCompilerOptimization',false);
  slConfigUISetEnabled(hDlg, hSrc, 'MakeCommand',false);
  hSrc.refreshDialog;
end

Просмотр Системного Конечного файла.  На данном этапе можно проверить, что цель наследовала и отображает опции ERT можно следующим образом:

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

Если вы предпочитаете использовать подход make-файла шаблона, ссылку на TMF, my_ert_target_lcc.tmf, в системе комментарии заголовка конечного файла препятствуют тому, чтобы вы вызвали процесс сборки для своей цели, пока файл TMF не существует. Во-первых, необходимо создать my_ert_target_lcc.tmf файл.

Создайте основанный на ERT шаблон MakeFile

Если вы используете подход make-файла набора инструментальных средств с набором инструментальных средств совместимая пользовательская цель, не используете шаги, которые применяются к подходу make-файла шаблона. (Пропустите этот раздел.)

Если вы используете подход make-файла шаблона, выполняете шаги, которые применяются к make-файлу шаблона и не используют вызывание функции, которая включает податливость набора инструментальных средств из вашего системного конечного файла, который описан в, Создают Основанный на ERT, Набор инструментальных средств Совместимый Системный Конечный файл.

Создайте make-файл шаблона для своей цели путем копирования и изменения предоставленного make-файла шаблона ERT. Выберите make-файл шаблона, который соответствует вашей цели лучше всего. Этот пример использует ert_lcc64.tmf, но можно также использовать ert_vcx64.tmf или ert_unix.tmf.

Ваша цель может теперь сгенерировать код и создать основанный на хосте исполняемый файл. В следующих разделах вы создаете тестовую модель и тестируете процесс сборки с помощью my_ert_target.

Создайте тестовую модель и S-функцию

В этом разделе вы создаете простую тестовую модель для дальнейшего использования в генерации кода:

Сохраните targetmodel модель, открытая для использования в следующем разделе, в котором вы генерируете код с помощью тестовой модели.

Проверьте целевую операцию

В этом разделе вы конфигурируете targetmodel для my_ert_target пользовательская цель и использование цель, чтобы сгенерировать код и создать исполняемый файл: