В этом разделе содержится информация о структуре системного целевого файла, руководствах по настройке системного целевого файла и базовом примере, который помогает вам создать целевой файл скелетной системы.
Системный целевой файл управляет стадией генерации кода процесса сборки. Системный целевой файл также позволяет управлять представлением целевого объекта конечному пользователю. Системный целевой файл обеспечивает
Определения переменных, которые являются основополагающими для процесса сборки, такие как значение для CodeFormat Переменная TLC
Основная точка входа в программу TLC верхнего уровня, которая генерирует код
Целевая информация для отображения в браузере системных целевых файлов
Механизм для определения целевых опций генерации кода (и других параметров, связанных с процессом сборки) и для их отображения в диалоговом окне Параметров конфигурации
Механизм наследования опций от другого целевого объекта (такого как Embedded Real-Time (ERT) целевой объект)
Обратите внимание, что, хотя системный целевой файл является файлом Target Language Compiler (TLC), он содержит встроенный MATLAB® код. Перед созданием или изменением системного целевого файла необходимо получить рабочие знания о TLC и языке MATLAB. Target Language Compiler и Scripts vs. Functions описывают функции и синтаксис как языков TLC, так и MATLAB.
При прочтении этого раздела можно обратиться к системным целевым файлам, поставляемым с генератором кода. Большинство из этих файлов хранятся в папках, относящихся к целевому объекту matlabroot/ rtw/cmatlabroot/ toolbox/rtw/targets
Системный целевой файл должен быть расположен в папке на пути MATLAB, чтобы целевой файл был отображен в System Target File Browser и активирован в процессе сборки. Следуйте соглашениям о местоположении и именовании для системных целевых файлов и связанных с ними целевых файлов, приведенным в соглашениях о именовании папок и файлов.
Этот раздел является руководством по структуре и содержимому системного целевого файла. В следующем списке показана общая структура системного целевого файла. Обратите внимание, что это не полный список кодов системного целевого файла. Список состоит из выдержек из каждого из разделов, составляющих системный целевой файл.
%%----------------------------
%% 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. Они предоставляют необходимую информацию в System Target File Browser и в процесс сборки. Обратите внимание, что перед другими комментариями или операторами TLC необходимо поместить комментарии браузера в заголовок файла.
Наличие комментариев позволяет генератору кода обнаруживать системные целевые файлы. Когда откроется System Target File Browser, генератор кода сканирует путь MATLAB для файлов TLC, которые отформатировали комментарии заголовка. Комментарии содержат следующие директивы:
SYSTLC: дескриптор, который появляется в браузере.
TMF: имя шаблона make-файла (TMF), используемого в процессе сборки. Когда цель выбрана, это имя файла отображается в поле Template make file панели Code Generation диалогового окна Параметры Конфигурации.
MAKE: make команда, используемая в процессе сборки. Когда цель выбрана, эта команда отображается в Make command поле панели Code Generation диалогового окна Параметры конфигурации.
Следующие комментарии заголовка получены от 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 поле в системном целевом файле, файл все еще действителен. Изменение значения для TemplateMakefile параметр, можно вместо этого использовать функцию обратного вызова, заданную rtwgensettings.SelectCallback.
Можно также использовать функцию обратного вызова, заданную rtwgensettings.SelectCallback для изменения значения параметров режима external mode, ExtMode, ExtModeTransport, ExtModeMexFile, или ExtModeIntrfLevel.
В комментариях заголовка можно задать несколько групп директивов. Каждая такая группа отображается как разное целевое строение в Диспетчере системных целевых файлов. В приведенном выше примере первые две строки кода определяют строение по умолчанию целевого устройства ERT. В следующих двух линиях задаётся строение, которая создает и создает Microsoft® Визуальный C++® Решение (.sln) файл. На рисунке ниже показано, как эти строения появляются в браузере системных целевых файлов.
Пример настроенных комментариев заголовка см. в разделе Создание пользовательском целевом строении.
В этом разделе системного целевого файла присваиваются глобальные переменные TLC, которые относятся к общему процессу генерации кода.
Для целевого процессора в большинстве случаев следует просто использовать глобальные настройки переменной TLC, используемые целевым объектом ERT (ert.tlc). Особенно важно, чтобы ваш системный целевой файл использовал 'Embedded-C' значение для CodeFormat TLC переменной и использует соответствующую rtwgensettings.DerivedFrom = 'ert.tlc' в RTW_OPTIONS раздел файла TLC. Проверьте, что значения назначены следующим переменным:
CodeFormat: The CodeFormat Переменная TLC выбирает сгенерированный код функции. The 'Embedded-C' значение для этой переменной используется целевым устройством ERT. Ваш целевой объект на основе ERT должен указать 'Embedded-C' как значение для CodeFormat. Этот выбор предназначен для производственного кода, минимального использования памяти, статического выделения памяти и упрощенного интерфейса к сгенерированному коду.
Для получения информации о других значениях для CodeFormat Переменная TLC, см. «Сравнение поддержки системных целевых файлов между продуктами».
Language: Единственное допустимое значение C, что позволяет поддерживать C или C++ генерация кода, заданная параметром конфигурации TargetLang.
TargetType: Генератор кода определяет символы препроцессора RT и NRT чтобы отличить код симуляции от кода в реальном времени. Эти символы используются в условной компиляции. The TargetType переменная определяет, RT ли или NRT задан.
Большинство целей предназначены для генерации кода в реальном времени. Они присваивают TargetType следующим образом.
%assign TargetType = "RT"
Некоторые цели, такие как цель симуляции модели-ссылки, ускоренная цель симуляции, цель RSim и цель S-функции, генерируют код для использования только за нереальное время. Такие цели присваивают TargetType следующим образом.
%assign TargetType = "NRT"
Процесс генерации кода обычно начинается с codegenentry.tlc. Системный целевой файл вызывает codegenentry.tlc следующим образом.
%include "codegenentry.tlc"
Примечание
codegenentry.tlc и файлы TLC более низкого уровня предполагают, что CodeFormat, TargetType, и Language были назначены. Установите эти переменные перед включением codegenentry.tlc.
Если вам нужно реализовать функции генерации кода, специфичные для цели, вы должны включить файл TLC mytarget_genfiles.tlc в целевом файле системы. Этот файл предоставляет механизм для выполнения пользовательского кода TLC до и после вызова codegenentry.tlc. Для получения информации об этом механизме см.
Использование mytarget_genfiles.tlc для примера пользовательского кода TLC для выполнения после основной точки входа генерации кода.
Целевая разработка и процесс сборки для получения общей информации о процессе сборки и информации о других крюках индивидуальной настройки процесса сборки.
Другой способ настройки процесса генерации кода - это вызов функций более низкого уровня (обычно инициируемых codegenentry.tlc) непосредственно, и включать свои собственные функции TLC на каждом этапе процесса. Такой подход следует применять с осторожностью. Для получения дополнительной информации см. файлы TLC».
Функции нижнего уровня, вызываемые codegenentry.tlc являются
genmap.tlc: сопоставляет имена блоков с соответствующими языковыми целевыми файлами блоков.
commonsetup.tlc: настраивает глобальные переменные.
commonentry.tlc: запускает процесс генерации кода.
The RTW_OPTIONS раздел ограничен директивами:
/% BEGIN_RTW_OPTIONS . . . END_RTW_OPTIONS %/
Первая часть RTW_OPTIONS раздел задает массив rtwoptions структуры. Эта структура обсуждается в разделе Использование rtwoptions для отображения пользовательских опций цели.
Вторая часть RTW_OPTIONS раздел определяет rtwgensettings, структуру, определяющую имя папки сборки и другие настройки для процесса генерации кода. Смотрите rtwgensettings Структура для получения информации о rtwgensettings.
Конечная часть системного целевого файла определяет rtwgensettings структура. Эта структура хранит информацию, которая записывается в model.rtwrtwgensettings области, представляющие наибольший интерес для целевых разработчиков,
rtwgensettings.Version: Используйте это свойство для включения rtwoptions коллбэки и использование коллбэк в rtwgensettings.SelectCallback.
Примечание
Чтобы использовать коллбэки, необходимо задать:
rtwgensettings.Version = '1';
Добавьте оператор выше в Configure RTW code generation settings раздел системного целевого файла.
rtwgensettings.DerivedFrom: Это поле структуры определяет системный целевой файл, из которого должны быть унаследованы опции. См. Раздел «Наследование целевых опций»
rtwgensettings.SelectCallback: Это поле структуры задает SelectCallback функция. Вы должны задать rtwgensettings.Version = '1'; или ваш коллбэк будет проигнорирован. SelectCallback связана с целевым объектом, а не с любым из его отдельных опций. The SelectCallback функция срабатывает, когда вы:
Загрузите модель.
Обновите все настройки строения в диалоговом окне Параметров конфигурации.
Создайте модель.
The SelectCallback функция используется для настройки (или отключения) параметров конфигурации, характерных для целевого объекта.
Следующий код устанавливает SelectCallback функция:
rtwgensettings.SelectCallback = 'my_select_callback_handler(hDlg,hSrc)';
Аргументы в SelectCallback функциональные (hDlg, hSrc) являются указателями на частные данные, используемые функциями API коллбэка.
Примечание
Если вы разработали пользовательский целевой объект и хотите, чтобы он был совместим со ссылками на модель, необходимо реализовать SelectCallback функция для объявления модели-ссылки совместимости. См. «Ссылки на модели поддержки».
rtwgensettings.ActivateCallback: это свойство задает ActivateCallback функция. The ActivateCallback функция запускается, когда изменяется активная конфигурация модели модели. Это может произойти во время загрузки модели, а также когда пользователь меняет активную конфигурацию модели.
Следующий код устанавливает ActivateCallback функция:
rtwgensettings.ActivateCallback = 'my_activate_callback_handler(hDlg,hSrc)';
Аргументы в ActivateCallback функциональные (hDlg,hSrc) являются указателями на частные данные, используемые функциями API коллбэка.
rtwgensettings.PostApplyCallback: это свойство задает PostApplyCallback функция. The PostApplyCallback функция запускается, когда пользователь нажимает кнопку Применить или OK после редактирования опций в диалоговом окне Параметры конфигурации. The PostApplyCallback вызывается функция после применения изменений к конфигурации модели.
Следующий код устанавливает PostApplyCallback функция:
rtwgensettings.PostApplyCallback = 'my_postapply_callback_handler(hDlg,hSrc)';
Аргументы в PostApplyCallback функциональные (hDlg, hSrc) являются указателями на частные данные, используемые функциями API коллбэка.
rtwgensettings.BuildDirSuffix: Большинство целей определяют суффикс имени папки, который идентифицирует папки сборки, созданные конечным объектом. Процесс сборки добавляет суффикс, заданный в rtwgensettings.BuildDirSuffix поле с именем модели для формирования имени папки сборки. Для примера, если вы задаете rtwgensettings.BuildDirSuffix следующим образом
rtwgensettings.BuildDirSuffix = '_mytarget_rtw'
папки сборки имеют имена model_mytarget_rtw
Конфигурирование сгенерированного кода с помощью TLC описывает дополнительные переменные генерации кода TLC. Конечные пользователи целевого объекта могут назначить эти переменные путем ввода команды MATLAB формы
set_param(modelName,'TLCOptions','-aVariable=val');
(Для получения дополнительной информации смотрите Задать TLC для Генерации кода.)
Однако предпочтительным подходом является назначение этих переменных в системном целевом файле с помощью операторов формы:
%assign Variable = val
Для читаемости рекомендуем добавить такие назначения в раздел системного целевого файла после Configure RTW code generation settings комментария.
Смотрите Support Model Referencing для получения важной информации о системном целевом файле и других изменениях, которые вы, возможно, должны сделать, чтобы поддержать функции ссылки на модели генератора кода.
Управление опциями для отображения на панели Code Generation в диалоговом окне Параметры конфигурации путем настройки rtwoptions структура в целевом файле системы.
Поля rtwoptions структура задает переменные и связанные элементы пользовательского интерфейса, которые будут отображаться в диалоговом окне Параметры конфигурации (Configuration Parameters). Использование rtwoptions массив структур, можно задать специфичные для цели опции, отображаемые в диалоговом окне, и организовать опции в категории. Можно также записать функции обратного вызова, чтобы указать, как эти опции обрабатываются.
Когда откроется панель Code Generation, откроется rtwoptions выполняется сканирование массива структур, и отображаются перечисленные опции. Каждая опция представлена назначенным элементом пользовательского интерфейса (флажок, поле редактирования, меню или кнопка), который отображает текущее значение опции.
Элементы пользовательского интерфейса могут быть в включенном или отключенном (похоже, затемненном) состоянии. Если опция включена, пользователь может изменить значение опции. Если опция отключена, опция использует значение по умолчанию, и пользователь не может изменить значение опции.
Можно также использовать rtwoptions массив структур для определения специальных элементов NonUI, которые вызывают выполнение функций обратного вызова, но которые не отображаются на панели Code Generation. См. раздел Элементы NonUI.
Элементы rtwoptions массив структур организован в группы. Каждая группа элементов начинается с элемента заголовка типа Category. Поле по умолчанию Category заголовок должен содержать количество остальных элементов в категории.
The Category за заголовком следуют опции, отображаемые на панели Code Generation. За заголовком в каждой категории следует один или несколько элементов определения опций.
Каждая категория целевых опций соответствует опциям, перечисленным в Code Generation в диалоговом окне Параметры конфигурации (Configuration Parameters).
В таблице rtwoptions Structure Fields Summary результирующие поля rtwoptions структура.
Пример структуры rtwoptions. Следующая rtwoptions структура извлекается из примера системного целевого файла, matlabroot/ toolbox/rtw/rtwdemos/rtwoptions_demo/usertarget.tlcrtwoptions массив структур. Поле по умолчанию первого элемента (header) установлено в 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.tlcmatlabroot/ rtw/c
rtwoptions Structure Fields Summary перечисляет поля rtwoptions структура.
rtwoptions Структура Поля Сводных данных
| Имя поля | Описание |
|---|---|
| Примеры использования коллбэка см. в Примере Системный целевой файл с настраиваемыми rtwoptions. |
| Не используйте
Примеры использования коллбэка см. в Примере Системный целевой файл с настраиваемыми rtwoptions. |
| Значение по умолчанию опции (пустое, если |
| Должен быть |
| Шаблон лексемы make-файла (если он имеется), связанный с опцией. The |
modelReferenceParameterCheck | Определяет, должна ли опция иметь то же значение в модели-ссылке и ее родительской модели. Если это поле не задано или имеет значение 'on' значения опций должны быть одинаковыми. Если поле задано и имеет значение 'off' значения опций могут отличаться. См. Соглашение о значении опции управления строением. |
| Элемент, который не отображается, но используется для вызова закрытого или открытого коллбэка. См. раздел Элементы NonUI. |
| Не используйте Примеры использования коллбэка см. в Примере Системный целевой файл с настраиваемыми rtwoptions. |
| Если 'rt_|_rt|none' |
| Пометьте опцию. |
| Имя переменной TLC, связанной с опцией. |
| Текст справки, отображаемый при наведении указателя мыши на элемент. |
| Тип элемента: |
Элементы NonUI. Элементы rtwoptions массив с типом NonUI существует только для вызова коллбэков. A NonUI элемент не отображается в диалоговом окне Параметры конфигурации (Configuration Parameters). Можно использовать NonUI элемент, если необходимо выполнить коллбэк, который не связан с элементом пользовательского интерфейса, когда диалоговое окно откроется или закроется. См. следующий раздел «Пример системного целевого файла с настраиваемыми rtwoptions» для примера.
Примечание
Значение по умолчанию элемента типа NonUI или Edit определяет множество значений, допустимых для этого элемента.
Если значение по умолчанию '0' или '1':
Для NonUI типаэлемент сохраняет логическое значение.
Для Edit типаэлемент сохраняет значение типа int32.
Если значение по умолчанию содержит целое число, отличное от '0' или '1'элемент сохраняет значение типа int32.
Если значение по умолчанию не содержит целое число, элемент вычисляется как вектор символов.
Рабочий системный целевой файл с функциями обратного вызова файлов MATLAB был предоставлен в качестве примера того, как использовать rtwoptions структура для отображения и обработки пользовательских опций на панели Code Generation. Примеры совместимы с коллбэк.
Примеры целевых файлов находятся в папке (open):
matlabroot/toolbox/rtw/rtwdemos/rtwoptions_demo
Примеры целевых файлов включают:
usertarget.tlc: Пример системного целевого файла. Этот файл иллюстрирует, как задать пользовательские меню, флажки и поля редактирования. Файл также иллюстрирует использование коллбэков.
usertargetcallback.m: Обратный коллбэк файла MATLAB, вызываемый меню.
Обратитесь к файлам примера во время чтения этого раздела. Пример системного целевого файла, usertarget.tlc- иллюстрирует использование rtwoptions чтобы отобразить следующие пользовательские целевые опции:
Меню Режим выполнения.
Флажок Log Execution Time.
Меню Real-Time Interrupt Source. Меню выполняет коллбэк, заданную во внешнем файле, usertargetcallback.m. Переменная TLC, связанная с меню, передается в коллбэк, который отображает текущее значение меню.
Поле edit Signal Logging Buffer Size in Double (Размер буфера регистрации сигналов в двойном порядке).
Попробуйте изучить пример кода во время взаимодействия с примером целевых параметров в диалоговом окне Параметров конфигурации. Для взаимодействия с конечным файлом примера,
Делайте matlabroot/ toolbox/rtw/rtwdemos/rtwoptions_demo
Откройте модель по своему выбору.
Откройте диалоговое окно Параметры конфигурации и выберите панель Code Generation.
Нажмите кнопку Обзор. Откроется браузер системных целевых файлов. Выберите usertarget.tlc. Затем нажмите кнопку ОК.
Обратите внимание, что панель Code Generation содержит пользовательскую подвкладку: userPreferred target options (I).
Когда вы взаимодействуете с опциями этой категории и открываете и закрываете диалоговое окно Параметров конфигурации, наблюдайте за сообщениями, отображаемыми в Командном окне MATLAB. Эти сообщения печатаются из кода в системном целевом файле или из коллбэков, инициируемых из системного целевого файла.
ert.tlc предоставляет базовый набор Embedded Coder® опции генерации кода. Если ваша цель основана на ert.tlc, ваш системный целевой файл обычно должен наследовать опции, заданные в ERT.
Используйте rtwgensettings.DerivedFrom поле в rtwgensettings структура для определения системного целевого файла, из которого будут унаследованы опции. Вы должны преобразовать свой пользовательский целевой объект, чтобы использовать этот механизм следующим образом.
Установите rtwgensettings.DerivedFrom значение поля как в следующем примере:
rtwgensettings.DerivedFrom = 'stf.tlc';
где stf - имя системного целевого файла, из которого должны быть унаследованы опции. Для примера:
rtwgensettings.DerivedFrom = 'ert.tlc';
Когда диалоговое окно Параметров конфигурации выполняет эту строку кода, оно включает опции от stf.tlc автоматически. Если stf.tlc является внутренним системным целевым файлом MathWorks, который был преобразован в новое размещение, диалоговое окно отображает унаследованные опции с помощью нового размещения.
Обработка неподдерживаемых опций. Если ваша цель не поддерживает все опции, унаследованные от ert.tlcнеобходимо обнаружить неподдерживаемые параметры опции и отобразить предупреждение или сообщение об ошибке. В некоторых случаях, если пользователь выбрал опцию, который не поддерживается вашим целевым объектом, может потребоваться прервать процесс сборки. Например, если ваша цель не поддерживает опцию Сгенерировать пример основной программы, процесс сборки не должен продолжаться, если выбрана эта опция.
Даже если целевой объект может не поддерживать все унаследованные опции ERT, необходимо сохранить опции ERT в панели Code Generation диалогового окна Параметры конфигурации. Не просто удаляйте неподдерживаемые опции из rtwoptions структура в системном целевом файле. Опции должны быть в диалоговом окне, чтобы сканироваться генератором кода, когда он выполняет оптимизацию.
Например, можно запретить пользователям отключать опцию Single output/update. Может показаться разумным удалить эту опцию из диалогового окна и просто назначить переменную TLC CombineOutputUpdateFcns на on. Однако, если опция не включена в диалоговое окно, генератор кода принимает, что выходные и обновленные функции не должны объединяться. В результате генерируется менее эффективный код.
В следующих разделах содержится информация о методах настройки целевого системного файла, в том числе:
Как вызвать пользовательский код TLC из вашего системного целевого файла
Подходы к поддержке нескольких сред разработки
Факторы о том, когда вы обновляете свой системный целевой файл
Если вам нужно реализовать функции генерации кода для конкретного целевого объекта, мы рекомендуем, чтобы ваш системный целевой файл включал файл TLC mytarget_genfiles.tlc.
Как только ваш системный целевой файл установил необходимое окружение TLC, вы должны включить codegenentry.tlc чтобы запустить стандартный процесс генерации кода.
mytarget_genfiles.tlc предоставляет механизм для выполнения пользовательского кода TLC после основной точки входа генерации кода. См. Использование mytarget_genfiles.tlc.
Использование mytarget_genfiles.tlc. mytarget_genfiles.tlc (необязательно) используется в качестве файла хранилища, из которого можно вызвать файлы TLC, относящиеся к целевому объекту, которые генерируют дополнительные файлы в рамках целевого процесса сборки. Например, ваш целевой объект может создать вспомогательные файлы make или файлы проекта для среды разработки или командные скрипты для отладчика, чтобы выполнить автоматическую загрузку.
Процесс сборки может затем вызвать эти сгенерированные файлы либо непосредственно из процесса make, либо после создания исполняемого файла. Это делается с помощью STF_make_rtw_hook.m
Следующий код 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)
где type1type2
The RTW.isHWDeviceTypeEq функция возвращает true, если type1type2
RTW.isHWDeviceTypeEq('Specified','Generic->Custom')Описание опции типа целевого устройства ProdHWDeviceType, см. информацию в командной строке для параметров панели Hardware Implementation Device vendor и Device type.
RTW.resolveHWDeviceType. Чтобы вернуть значение типа устройства для аппаратного устройства, учитывая значение, которое может быть псевдонимом или устаревшим значением, активируйте следующую функцию:
result = RTW.resolveHWDeviceType(type)
где type
The RTW.resolveHWDeviceType функция возвращает значение типа устройства. Например, следующие вызовы оба возвращают 'Generic->Custom':
RTW.resolveHWDeviceType('Specified')
RTW.resolveHWDeviceType('Generic->Custom')Описание опции типа целевого устройства ProdHWDeviceType, см. информацию в командной строке для параметров панели Hardware Implementation Device vendor и Device type.
RTW.isTflEq. Чтобы проверить, представляют ли два имени библиотеки замещения кода (CRL) один и тот же CRL, активируйте следующую функцию:
result = RTW.isTflEq(name1,name2)
где name1name2
The RTW.isTflEq функция возвращает true, если name1name2
RTW.isTflEq('GNU','GNU C99 extensions')Описание CodeReplacementLibrary параметр, см. «Библиотека замещения кода».
RTW.resolveTflName. Чтобы вернуть значение CRL для библиотеки замены кода, учитывая значение, которое может быть псевдонимом или устаревшим значением, активируйте следующую функцию:
result = RTW.resolveTflName(name)
где name
The RTW.resolveTflName функция возвращает значение библиотеки замены ссылочного кода. Например, следующие вызовы оба возвращают 'GNU C99 extensions':
RTW.resolveTflName('GNU')
RTW.resolveTflName('GNU C99 extensions')Описание CodeReplacementLibrary параметр, см. «Библиотека замещения кода».
Ваша цель может потребовать поддержки для нескольких сред разработки (для примера, двух или более перекрестных компиляторов) или нескольких режимов генерации кода (для примера, генерация двоичного исполняемого файла против генерации файла проекта для вашего компилятора).
Одним из подходов к этому требованию является реализация нескольких системных целевых файлов. Каждый системный целевой файл вызывает файл make-файла шаблона для среды разработки. Это означает обеспечение двух отдельных целевых показателей.
Обновление вашего пользовательского системного целевого файла может повлиять на значения опций загружаемой модели, которая использует обновленный системный целевой файл. Если параметр отключен, обновленный системный целевой файл использует значение по умолчанию для этой опции. Если модель имеет другое значение для этой опции, когда вы загружаете модель с обновленным системным целевым файлом, значение из модели отбрасывается, и системный целевой файл использует вместо этого значение по умолчанию.
Этот учебник может дополнить примеры целевых руководств, описанных в Sample Custom Targets. Для ввода и примера файлов сначала попробуйте пример цели.
Это руководство провело вас через процесс создания целевого объекта на основе ERT, my_ert_target. Это упражнение иллюстрирует несколько задач, которые типичны для создания пользовательского целевого объекта:
Настройка целевых папок и изменение пути MATLAB.
Внесение изменений в стандартный системный целевой файл и TMF таким образом, чтобы пользовательский целевой объект был виден в System Target File Browser, наследовал опции ERT, отображал специфичные для целевого объекта опции и генерировал код с помощью компилятора на основе хоста по умолчанию.
Проверка процесса сборки с помощью пользовательского целевого объекта с помощью простой модели, которая включает встроенную S-функцию.
Во время этого упражнения вы реализуете оперативную, но скелетную, основанную на ERT цель. Этот целевой объект может быть полезен в качестве начальной точки при полной реализации пользовательского целевого процессора.
В следующих разделах вы создаете каркасную цель, my_ert_target. Целевой объект наследует и поддерживает стандартные опции целевого объекта ERT и отображает дополнительные специфичные для целевого объекта опции в диалоговом окне Параметры конфигурации (см. раздел «Параметры конкретного целевого объекта» для my_ert_target).
Специфичные для цели опции для my_ert_target
my_ert_target поддерживает сборку на основе набора инструментальных средств, генерируя код и исполняемые файлы, которые выполняются в хост-системе. my_ert_target использует lcc компилятор в Microsoft Windows® платформы. Выбранный компилятор легко доступен и распространяется с генератором кода. На платформе Microsoft Windows, если вы используете другой компилятор, можно настроить lcc временно в качестве компилятора по умолчанию с помощью следующей команды MATLAB:
mex -setup
Программа отображает ссылки для поддерживаемых компиляторов, установленных на вашем компьютере. Нажмите на lcc ссылка.
Примечание
На Linux® убедитесь, что у вас есть установленный компилятор C. Если это так, для выполнения этого упражнения можно использовать синтаксис папки Linux.
my_ert_target может также поддерживать сборки на основе шаблонов make-файлов. Дополнительные сведения об использовании этого целевого объекта с подходом make-файла шаблона см. в разделе Создание шаблона на основе ERT MakeFile.
Можно тестировать my_ert_target с моделью, которая совместима с конечным объектом ERT (см. «Настройка системного целевого файла»). Сгенерированные программы работают идентично программам, сгенерированным ERT.
Чтобы упростить проверку вашей цели, тестируйте с targetmodel, очень простая модель с фиксированным шагом (см., Создают Экспериментальную модель и S-Функцию). Блок S-Function в targetmodel использует исходный код из timestwo пример, и генерирует полностью встроенный код. Смотрите примеры S-функций и встроенные S-функции с TLC для дальнейшего обсуждения timestwo пример S-функции.
Создайте папки для хранения целевых файлов и добавьте их в путь MATLAB, следуя рекомендуемым соглашениям (см. Соглашения о именовании папок и файлов). Вы также создаете папку для хранения экспериментальной модели, S-функции и сгенерированного кода.
Этот пример принимает, что ваши целевые папки и папки модели расположены в папке c:/work. Не помещайте свои целевые папки и папки модели в дерево папок MATLAB (то есть в или под matlabroot
Чтобы создать папки и сделать их доступными:
Создайте целевую корневую папку, my_ert_target. В Командном Окне MATLAB на платформе Windows введите:
cd c:/work mkdir my_ert_target
В целевой корневой папке создайте подпапку для хранения ваших целевых файлов.
mkdir my_ert_target/my_ert_target
Добавьте эти папки к пути MATLAB.
addpath c:/work/my_ert_target addpath c:/work/my_ert_target/my_ert_target
Создайте папку, my_targetmodel, для хранения экспериментальной модели, S-функции и сгенерированного кода.
mkdir my_targetmodel
Создайте системный целевой файл для вашего целевого объекта путем копирования и изменения стандартного системного целевого файла для целевого объекта ERT. Затем проверьте системный целевой файл путем просмотра нового целевого объекта в System Target File Browser и в диалоговом окне Параметры Конфигурации.
Изменение системного целевого файла. Чтобы отредактировать системный целевой файл, выполните следующие шаги:
Измените рабочую папку на папку, созданную в разделе Создание целевых папок.
cd c:/work/my_ert_target/my_ert_target
Разместите копию matlabroot/ rtw/c/ert/ert.tlcc:/work/my_ert_target/my_ert_target и переименовать его в my_ert_target.tlc. Файл ert.tlc - системный целевой файл для целевого устройства ERT.
Откройте my_ert_target.tlc в текстовом редакторе по вашему выбору.
Настройте системный целевой файл, заменив строки с комментариями заголовка директивами, которые делают ваш системный целевой файл видимым в System Target File Browser и определяют связанный TMF, make команда и файл интерфейса режима external mode (при наличии). Для получения дополнительной информации об этих директивах смотрите Комментарии заголовка.
Замените комментарии заголовка в my_ert_target.tlc со следующими комментариями заголовка.
%% SYSTLC: My ERT-based Target TMF: my_ert_target_lcc.tmf MAKE: make_rtw
Файл my_ert_target.tlc наследует стандартные опции ERT, используя механизм, описанный в разделе Наследование целевых опций. Поэтому существующая rtwoptions определение структуры излишне. Отредактируйте раздел RTW_OPTIONS так, чтобы он содержал только следующий код.
/% BEGIN_RTW_OPTIONS %----------------------------------------% % Configure RTW code generation settings % %----------------------------------------% rtwgensettings.BuildDirSuffix = '_ert_rtw'; END_RTW_OPTIONS %/
Удалите код после окончания RTW_OPTIONS раздел, который разграничено директивами BEGIN_CONFIGSET_TARGET_COMPONENT and END_CONFIGSET_TARGET_COMPONENT. Этот код предназначен только для использования внутренними разработчиками MathWorks.
Измените суффикс папки сборки в rtwgenSettings структура в соответствии с конвенциями, описанными в rtwgensetings Structure.
Чтобы задать суффикс вектора символов для _my_ert_target пользовательский целевой объект, измените линию
rtwgensettings.BuildDirSuffix = '_ert_rtw'
кому
rtwgensettings.BuildDirSuffix = '_my_ert_target_rtw'
Измените rtwgenSettings структура, чтобы наследовать опции от целевого устройства ERT и объявить совместимость релиза 14 или более поздней, как описано в rtwgensettings Structure. Добавьте следующий код к rtwgenSettings определение:
rtwgensettings.DerivedFrom = 'ert.tlc'; rtwgensettings.Version = '1';
Добавление rtwoptions структура, которая определяет категорию опций, относящихся к целевому объекту, с тремя флажками сразу после BEGIN_RTW_OPTIONS директива. Следующий код показывает полную RTW_OPTIONS раздел, включая предыдущие rtwgenSettings изменения.
/%
BEGIN_RTW_OPTIONS
rtwoptions(1).prompt = 'My Target Options';
rtwoptions(1).type = 'Category';
rtwoptions(1).enable = 'on';
rtwoptions(1).default = 3; % number of items under this category
% excluding this one.
rtwoptions(1).popupstrings = '';
rtwoptions(1).tlcvariable = '';
rtwoptions(1).tooltip = '';
rtwoptions(1).callback = '';
rtwoptions(1).makevariable = '';
rtwoptions(2).prompt = 'Demo option 1';
rtwoptions(2).type = 'Checkbox';
rtwoptions(2).default = 'off';
rtwoptions(2).tlcvariable = 'DummyOpt1';
rtwoptions(2).makevariable = '';
rtwoptions(2).tooltip = ['Demo option1 (non-functional)'];
rtwoptions(2).callback = '';
rtwoptions(3).prompt = 'Demo option 2';
rtwoptions(3).type = 'Checkbox';
rtwoptions(3).default = 'off';
rtwoptions(3).tlcvariable = 'DummyOpt2';
rtwoptions(3).makevariable = '';
rtwoptions(3).tooltip = ['Demo option2 (non-functional)'];
rtwoptions(3).callback = '';
rtwoptions(4).prompt = 'Demo option 3';
rtwoptions(4).type = 'Checkbox';
rtwoptions(4).default = 'off';
rtwoptions(4).tlcvariable = 'DummyOpt3';
rtwoptions(4).makevariable = '';
rtwoptions(4).tooltip = ['Demo option3 (non-functional)'];
rtwoptions(4).callback = '';
%----------------------------------------%
% Configure RTW code generation settings %
%----------------------------------------%
rtwgensettings.BuildDirSuffix = '_my_ert_target_rtw';
rtwgensettings.DerivedFrom = 'ert.tlc';
rtwgensettings.Version = '1';
rtwgensettings.SelectCallback = 'enableToolchainCompliant(hSrc, hDlg)';
%SelectCallback provides toolchain approach support, but requires custom function
%Omit this SelectCallback if using the template makefile approach
END_RTW_OPTIONS
%/Сохраните изменения в my_ert_target.tlc и закройте файл.
Создайте функцию 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
Примечание
Если вы используете подход make-файла шаблона, не вызывайте функцию, разрешающую соответствие набору инструментальных средств из вашего системного целевого файла. Вместо этого используйте информацию в разделе Создание шаблона на основе ERT MakeFile.
Просмотр системного целевого файла. На данной точке можно проверить, что целевой объект наследует и отображает опции ERT следующим образом:
Создайте новую модель.
Откройте браузер Model Explorer или диалоговое окно Параметров конфигурации.
Выберите панель Code Generation.
Нажмите кнопку Обзор, чтобы открыть браузер системных целевых файлов.
В браузере файлов прокрутите список целей, чтобы найти новую цель, my_ert_target.tlc. (Этот шаг принимает, что ваш путь MATLAB содержит c:/work/my_ert_target/my_ert_target, как ранее задано в разделе «Создание целевых папок».)
Выберите My ERT-based Target и нажмите OK.
Панель Code Generation теперь показывает, что модель сконфигурирована для my_ert_target.tlc цель. Поля System target file, Language, Toolchain и Build строения должны появиться:
Выберите панель My Target Options. В целях отображаются три опции флажка, заданные в rtwoptions структура.
Выберите панель Code Generation и снова откройте браузер системных целевых файлов.
Выберите цель Embedded Coder (ert.tlc). В целях отображаются стандартные опции ERT.
Закройте модель. Вам не нужно его сохранять.
Системный целевой файл для целевого скелета завершен. Если вы используете подход набора инструментальных средств, вы готовы вызвать процесс сборки для своей цели.
Если вы предпочитаете использовать подход make-файла шаблона, ссылку на TMF, my_ert_target_lcc.tmf, в системном заголовке целевого файла комментарии препятствуют вызову процесса сборки для целевого файла до тех пор, пока не будет создан файл TMF. Во-первых, вы должны создать my_ert_target_lcc.tmf файл.
Если вы используете подход make-файла набора инструментальных средств с пользовательской целью, соответствующей набору инструментальных средств, опускайте шаги, которые применяются к подходу make-файла шаблона. (Пропустите этот раздел.)
Если вы используете подход make-файла шаблона, следуйте шагам, которые применяются к файлу make-файла шаблона, и опустошите вызов функции, которая включает соответствие набору инструментальных средств из вашего системного целевого файла, который описан в Create ERT-Based, Toolchain System Target File.
Создайте шаблон make-файла для цели путем копирования и изменения предоставленного шаблона ERT-файла make-файла. Выберите шаблон make-файла, который лучше всего подходит для вашего целевого файла. Этот пример использует ert_lcc64.tmf, но можно также использовать ert_vcx64.tmf или ert_unix.tmf.
Убедитесь, что ваша рабочая папка все еще задана в целевой файловой папке, созданной ранее в Creating Target Folders.
c:/work/my_ert_target/my_ert_target
Разместите копию matlabroot/ toolbox/coder/compile/tmf/ert_lcc64.tmfc:/work/my_ert_target/my_ert_target и переименовать его my_ert_target_lcc.tmf. Файл ert_lcc64.tmf является шаблоном make-файла для компилятора ERT для компилятора LCC.
Откройте my_ert_target_lcc.tmf в текстовом редакторе.
Измените SYS_TARGET_FILE параметр так, чтобы ссылка на файл для вашего .tlc файл генерируется в make файл. Измените линию
SYS_TARGET_FILE = any
кому
SYS_TARGET_FILE = my_ert_target.tlc
Сохраните изменения в my_ert_target_lcc.tmf и закройте файл.
Теперь ваша цель может сгенерировать код и создать исполняемый файл на основе хоста. В следующих разделах вы создаете экспериментальную модель и тестируете процесс сборки с помощью my_ert_target.
В этом разделе вы создаете простую экспериментальную модель для дальнейшего использования в генерации кода:
Установите рабочую папку равной c:/work/my_targetmodel.
cd c:/work/my_targetmodel
Для оставшейся части этого руководства, my_targetmodel принимается рабочей папкой. Ваша цель записывает выходные файлы процесса генерации кода в папку сборки в рабочей папке. Когда inlined код генерируется для timestwo S-функция, процесс сборки ищет реализацию TLC S-функции в рабочей папке.
Скопируйте следующие файлы C и TLC для timestwo S-функция в рабочую папку:
Создайте timestwo Файл MEX в c:/work/my_targetmodel.
mex timestwo.c
Создайте следующую модель, используя блок S-Function из Simulink® Библиотека пользовательских функций. Сохраните модель в рабочей папке как targetmodel.
Дважды кликните блок S-Function, чтобы открыть диалоговое окно Параметры Блоков. Введите имя S-функции timestwo. Нажмите OK. Теперь блок привязан к timestwo Файл MEX.
Откройте Model Explorer или диалоговое окно Параметров конфигурации и выберите панель Решателя.
Установите Тип решателя на fixed-step и нажмите Применить.
Сохраните модель.
Откройте возможности и запустите симуляцию. Проверьте, что timestwo S-функция умножает свой вход на 2.0.
Сохраните targetmodel модель открыта для использования в следующем разделе, в котором вы генерируете код с помощью экспериментальной модели.
В этом разделе вы конфигурируете targetmodel для my_ert_target custom target, и использовать target, чтобы сгенерировать код и создать исполняемый файл:
В диалоговом окне Параметры конфигурации выберите панель Code Generation.
Нажмите кнопку Обзор, чтобы открыть браузер системных целевых файлов.
В браузере выберите My ERT-based Target и нажмите OK.
Теперь в диалоговом окне Параметров конфигурации отображается панель Code Generation для my_ert_target.
Выберите панель Code Generation > Report и Create code generation report опцию.
Нажмите Применить (Apply) и сохраните модель. Модель сконфигурирована для my_ert_target.
Создайте модель. Если сборка завершается успешно, в Командном Окне MATLAB появится следующее сообщение.
### Created executable: ../targetmodel.exe ### Successful completion of build procedure for model: targetmodel
Ваша рабочая папка содержит targetmodel.exe файл и папка сборки, targetmodel_my_ert_target_rtw, который содержит сгенерированный код и другие файлы. Рабочая папка также содержит slprj папка, используемая внутри процесса сборки.
Генератор кода также создает отчет генерации кода.
Чтобы просмотреть сгенерированный код, на вкладке C Code, нажмите View Code. На панели «Содержимое» отчета о генерации кода нажмите targetmodel.c ссылка.
В targetmodel.c, найдите функцию шага модели, targetmodel_step. Наблюдайте за следующим кодом.
/* S-Function Block: <Root>/S-Function */ /* Multiply input by two */ targetmodel_B.SFunction = targetmodel_B.SineWave * 2.0;
Наличие этого кода подтверждает, что my_ert_target пользовательский целевой объект сгенерировал встроенные выходные расчеты для блока S-Function в модели.