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

Обзор

Компоненты пользовательской цели являются файлами, расположенными в иерархии папок. Папка верхнего уровня в этой структуре называется целевой корневой папкой. Целевую корневую папку и ее содержимое называют, организуют и располагают на пути MATLAB согласно соглашениям, описанным в Соглашениях о присвоении имен Папки и Файла.

Компоненты пользовательской цели включают

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

Компоненты кода

Исполняемая программа, содержащая код, сгенерирована от Simulink^® модель состоит из многих модулей кода и структур данных. Они попадают в две категории: компоненты приложения и файлы поддержки выполнения.

Компоненты приложения.  Компоненты приложения - те, которые характерны для конкретной модели; они реализуют функции, представленные блоками в модели. Компоненты приложения не характерны для цели. Компоненты приложения включают

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

Написанные пользователем Файлы поддержки Выполнения.  Генератор кода обеспечивает большинство файлов поддержки выполнения. В зависимости от требований вашей цели необходимо реализовать некоторых или все следующие элементы:

Управляйте файлами

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

Файл Управления верхнего уровня (make_rtw).  Процесс сборки инициируется, когда вы нажимаете Ctrl+B. На данном этапе процесс сборки анализирует Сделать поле команды панели Code Generation диалогового окна Configuration Parameters, ожидая находить имя команды MATLAB, которая управляет процессом сборки (а также дополнительные аргументы к той команде). Командой по умолчанию является make_rtw, и файлом управления верхнего уровня по умолчанию для процесса сборки является make_rtw.m.

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

Системный Конечный файл.  Компилятор выходного языка (TLC) генерирует целевой код C or C++ из частичного описания вашей Диаграммы Simulink (model.rtw). Компилятор Выходного языка читает model.rtw и выполняет программу, состоящую из нескольких конечных файлов (.tlc файлы.) Системный конечный файл, в верхнем уровне этой программы, управляет процессом генерации кода. Выход этого процесса является многими исходными файлами, которые питаются вашу систему разработки, делают утилиту.

Необходимо создать индивидуально настраиваемый системный конечный файл, чтобы установить параметры генерации кода для цели. Необходимо скопировать, переименовать и изменить стандартный системный конечный файл ERT (matlabroot/rtw/c/ert/ert.tlc).

Подробная структура системного конечного файла описана в, Настраивают Системные Конечные файлы.

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

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

Embedded Coder^® программное обеспечение предлагает большое количество TMFs, подходящего для различных типов систем компьютера разработчика. Эти TMFs расположены в matlabroot/toolbox/coder/compile/tmf. Стандартные TMFs описаны в Make-файлах Шаблона и Делают Опции.

Подробная структура TMF описана в, Настраивают Make-файлы Шаблона.

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

Файлы рычага должны следовать за четко определенным именованием и требованиями местоположения. Соглашения о присвоении имен папки и Файла описывают эти требования.

Целевая корневая папка (mytarget)

Эта папка содержит ключевые подпапки для цели (см. Соглашения о присвоении имен Папки и Файла). Можно также определить местоположение разных файлов (таких как readme файл) в целевой корневой папке. Следующие разделы описывают требуемые и дополнительные подпапки и их содержимое.

Целевая Папка (mytarget/mytarget)

Эта папка содержит файлы, которые являются центральными к цели, такими как системный конечный файл (STF) и обрабатывают make-файл по шаблону (TMF). Файлы ключей в Целевой Папке (mytarget/mytarget) обобщают файлы, которые должны храниться в mytarget/mytarget, и обеспечивает указатели на подробную информацию об этих файлах.

Целевая папка блока (mytarget/blocks)

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

Можно также сохранить модели в качестве примера и вспомогательные файлы в mytarget/blocks. В качестве альтернативы можно создать mytarget/mytargetdemos папка, которая должна также быть на пути MATLAB.

Чтобы отобразить ваши блоки в стандартном Браузере Библиотеки Simulink и/или интегрировать ваши модели в качестве примера в среду сеанса работы с MATLAB, можно создать файлы, описанные ниже, и сохранить их в mytarget/blocks.

mytarget/blocks/slblocks.m.  Этот файл позволяет группе блоков быть интегрированной в Браузер Библиотеки Simulink и Библиотеки Simulink.

function blkStruct = slblocks
% Information for "Blocksets and Toolboxes" subsystem
blkStruct.Name = sprintf('Embedded Target\n for MYTARGET');
blkStruct.OpenFcn = 'mytargetlib';
blkStruct.MaskDisplay = 'disp(''MYTARGET'')';

% Information for Simulink Library Browser
Browser(1).Library = 'mytargetlib';
Browser(1).Name    = 'Embedded Target for MYTARGET';
Browser(1).IsFlat  = 1;% Is this library "flat" (i.e. no subsystems)?

blkStruct.Browser = Browser;

mytarget/blocks/demos.xml.  Этот файл предоставляет информацию о компонентах, организации и местоположении моделей в качестве примера. Программное обеспечение MATLAB использует эту информацию, чтобы поместить пример в среду сеанса работы с MATLAB.

<?xml version="1.0" encoding="utf-8"?>
<demos>
   <name>Embedded Target for MYTARGET</name>
   <type>simulink</type>
   <icon>$toolbox/matlab/icons/boardicon.gif</icon>
   <description source = "file">mytarget_overview.html</description>

   <demosection>
      <label>Multirate model</label>
      <demoitem>
         <label>MYTARGET demo</label>
         <file>mytarget_overview.html</file>
         <callback>mytarget_model</callback>
      </demoitem>
   </demosection>

</demos>

Папка Средств разработки (mytarget/dev_tool1, mytarget/dev_tool2)

Эти папки содержат файлы, сопоставленные с определенными средами разработки или инструментами (dev_tool1, dev_tool2, и т.д.). Обычно, ваша цель поддерживает по крайней мере одну такую среду разработки и вызывает ее компилятор, компоновщика и другие утилиты во время процесса сборки. mytarget/dev_tool1 включает командные файлы компоновщика, код запуска, функции рычага и другие файлы, требуемые поддерживать этот процесс.

Для каждой среды разработки необходимо обеспечить отдельную папку.

Целевая папка исходного кода (mytarget/src)

Эта папка является дополнительной. Если сложность вашей цели требует его, можно использовать mytarget/src сохранить код общего источника и код настройки (такой как начальная загрузка и код запуска).

Введение

Целевая папка mytarget/mytarget содержит файлы ключей в вашей целевой реализации. Они включают системный конечный файл, обрабатывают по шаблону make-файл, основной программный модуль, и дополнительный M и файлы рычага TLC, которые позволяют вам добавить целевые действия в процесс сборки. Следующие разделы описывают файлы папки главной цели.

mytarget.tlc

mytarget.tlc системный конечный файл. Функции системного конечного файла включают

Необходимо основывать системный конечный файл на ert.tlc, системный конечный файл обеспечивается программным обеспечением Embedded Coder.

Настройте Системные Конечные файлы, дает подробную информацию о структуре системного конечного файла, и также дает инструкции относительно того, как настроить системный конечный файл к

mytarget.tmf

mytarget.tmf make-файл шаблона для создания исполняемого файла для вашей цели.

Для основной информации о структуре и операции make-файлов шаблона, смотрите, Настраивают Make-файлы Шаблона.

mytarget_genfiles.tlc

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

mytarget_main.c

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

Для описания операции основных программ смотрите, Развертывают Сгенерированные Программы Независимого исполняемого файла В Целевой компьютер (Embedded Coder). Раздел также содержит инструкции для генерации и изменения основного программного модуля.

STF_make_rtw_hook.m

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

Настройте Процесс сборки с Файлом STF_make_rtw_hook, описывает операцию STF_make_rtw_hook.m сцепите файл подробно.

(Устаревший) STF_rtw_info_hook.m

До Релиза 14 пользовательские цели предоставили целевую информацию с файлом рычага (называемый STF_rtw_info_hook.m). STF_rtw_info_hook заданные свойства, такие как размеры слова для целочисленных типов данных (например, char, short, int, и long), и специфичные для реализации свойства C пользовательской цели.

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

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

info.xml

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

mytarget_overview.html

Условно, этот файл служит домашней страницей для целевых примеров.

<description> поле в demos.xml должен указать на mytarget_overview.html (см. mytarget/blocks/demos.xml).

Пример mytarget_overview.html Файл

<html>
<head><title>Embedded Target for MYTARGET</title></head><body>
<p style="color:#990000; font-weight:bold; font-size:x-large">Embedded Target
for MYTARGET Example Model</p>

<p>This example provides a simple model that allows you to generate an executable
for a supported target board. You can then download and run the executable and
set breakpoints to study and monitor the execution behavior.</p>

</body>
</html>

Введение

Если вы разрабатываете целевой процессор, который не установлен в дерево MATLAB, необходимо предоставить целевой скрипт настройки и целевую документацию в mytarget/mytarget, для удобства ваших пользователей. Следующие разделы описывают необходимые материалы и куда разместить их.

mytarget/mytarget/mytarget_setup.m

Этот скрипт файла добавляет пути для вашей цели к пути MATLAB. Ваша документация должна дать пользователям команду запускать скрипт при установке цели.

Необходимо включать вызов функции MATLAB savepath в вашем mytarget_setup.m скрипт. Эта функция сохраняет добавленные пути, таким образом, пользователи должны запустить mytarget_setup.m только однажды.

Следующий код является примером mytarget_setup.m файл.

function mytarget_setup()
curpath = pwd;
tgtpath = curpath(1:end-length('\mytarget'));
addpath(fullfile(tgtpath, 'mytarget'));
addpath(fullfile(tgtpath, 'dev_tool1'));
addpath(fullfile(tgtpath, 'blocks'));
addpath(fullfile(tgtpath, 'mytargetdemos'));
savepath;
disp('MYTARGET Target Path Setup Complete.');

mytarget/mytarget/doc

Необходимо поместить документацию, связанную с целью в папке mytarget/mytarget/doc.

О процессе сборки

Чтобы разработать целевой процессор, вам нужно полное понимание процесса сборки. Ваш целевой процессор использует процесс сборки и может потребовать, чтобы вы изменили или настроили процесс. Общий обзор генерации кода и процесса сборки дан в Генерации кода и Процессе сборки.

Этот раздел дополнения, что обзор с описанием процесса сборки, как настроено программным обеспечением Embedded Coder. Акцент находится на точках в процессе, где рычаги индивидуальной настройки доступны и на передающей информации между различными фазами процесса.

Этот раздел завершает Методами Передачи Дополнительной информации, описывая различные советы и приемы для передающей информации во время процесса сборки.

Фазы процесса сборки и информационная передача

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

Также важно изучить несколько фаз процесса сборки и как передать информацию между фазами. Процесс сборки включает несколько высокоуровневых фаз:

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

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

Смотрите Файлы ключей в Целевой Папке (mytarget/mytarget) для получения дополнительной информации о доступном файле MATLAB и рычагах TLC для информационной передачи с примерами кода.

Методы передачи дополнительной информации

В этом разделе описываются много полезных методов для передающей информации среди различных фаз процесса сборки.

tlcvariable Поле в rtwoptions Структуре.  Параметры на панелях генерации кода диалогового окна Configuration Parameters могут быть сопоставлены с переменной TLC и заданы в tlcvariable поле записи опции в rtwoptions структура. Значение переменных передается командной строке, когда TLC вызывается. Это обеспечивает способ сделать параметры генерации кода и их значения доступными в фазе TLC.

Смотрите Системную Структуру Конечного файла для получения дополнительной информации.

makevariable Поле в rtwoptions Структуре.  Можно сопоставить параметры генерации кода с лексемой make-файла шаблона, которую вы задаете в makevariable поле записи опции в rtwoptions структура. Если лексема того же имени как makevariable имя существует в TMF, лексема обновляется со значением опции, когда итоговый make-файл создается. Если лексема не существует в TMF, makevariable передается в на командной строке, когда делают, вызывается. Таким образом, в любом случае, makevariable доступно для make-файла.

Смотрите Системную Структуру Конечного файла для получения дополнительной информации.

Доступ к Переменным Серверной среды.  Можно получить доступ к переменным среды оболочки хоста в командной строке MATLAB путем ввода getenv команда. Например:

getenv ('MSDEVDIR')

ans =

D:\Applications\Microsoft Visual Studio\Common\MSDev98

Чтобы получить доступ к той же информации от TLC, используйте FEVAL директива, чтобы вызвать getenv.

%assign eVar = FEVAL("getenv","<varname>")

Предоставление информации Среды разработки к Make-файлу Шаблона.  Целевой процессор должен связать процесс сборки с целевыми средствами разработки, установленными на хосте - компьютере. Для сделать процесса, чтобы запустить эти инструменты, TMF должен смочь определить имя инструментов, пути к компилятору, компоновщику, и другим утилитам, и возможно настройкам переменной окружения хостовой операционной системы.

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

Используя Данные о приложении MATLAB.  Данные приложения обеспечивают путь к приложениям, чтобы сохранить и получить данные, хранимые с графический интерфейсом пользователя. Этот метод позволяет вам создать то, что является по существу пользовательским свойством для объекта, и используйте это свойство хранить данные для использования в процессе сборки. Для получения дополнительной информации смотрите setappdata и getappdata.

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

Этот файл, tlc2appdata.m, хранит data переданный в как данные приложения под именем переданный в (appDataName).

function k = tlc2appdata(appDataName,data)
  disp([mfilename,': ',appDataName,' ', data]);
  setappdata(0,appDataName,data);
  k = 0;  % TLC expects a return value for FEVAL.

Следующий демонстрационный файл TLC использует FEVAL директива, чтобы вызвать tlc2appdata.m сохранить произвольные данные приложения, под именем z80.

%% test.tlc
%%
%assign myApp = "z80"
%assign myData = "314159"
%assign dummy = FEVAL("tlc2appdata",myApp,myData)

Протестировать этот метод:

Реальное использование данных приложения может быть должно собрать информацию от model.rtw файл и хранилище это для использования позже в процессе сборки.

Добавление специфичной для блока информации к make-файлу.  rtwmakecfg механизм предоставляет метод для встроенных S-функций, таких как блоки драйверов, чтобы добавить информацию в make-файл. Этот механизм описан в Использовании rtwmakecfg.m API, чтобы Настроить Сгенерированные Make-файлы.