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

Обзор

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

%%----------------------------
%% 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
%/

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

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

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

Присутствие комментариев позволяет генератору кода обнаружить STFs. Когда Системный Браузер Конечного файла открыт, генератор кода сканирует путь 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

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

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

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

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

%include "codegenentry.tlc"

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

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

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

Раздел RTW_OPTIONS

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

/%
  BEGIN_RTW_OPTIONS
.
.
.
  END_RTW_OPTIONS
%/

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

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

Структура rtwgensettings

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

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

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

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

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

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

%assign Variable = val

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

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

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

Введение

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

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

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

Если ваш STF настроил необходимую среду 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 (Simulink Coder).

Следующий код 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 (Simulink) и Тип устройства (Simulink).

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

result = RTW.resolveHWDeviceType(type)

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

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

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

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

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 смотрите заменяющую библиотеку Кода (Simulink Coder).

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

result = RTW.resolveTflName(name)

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

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

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

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

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

Обновление пользовательского STF

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

Введение

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

Этот пример провел вас по процессу создания основанной на 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 (см., Конфигурируют Системный Конечный файл). Сгенерированные программы действуют тождественно к сгенерированным программам ERT.

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

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

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

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

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

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

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

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

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

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);
end

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

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

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

Создайте основанный на ERT TMF

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

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

Создайте TMF для своей цели путем копирования и изменения стандартного ERT TMF для компилятора LCC:

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

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

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

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

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

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