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

Обзор

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

Компоненты пользовательского целевого объекта включают

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

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

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

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

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

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

Файлы управления

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

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

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

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

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

Подробная структура системного целевого файла описывается в разделе Настройка системных целевых файлов.

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

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

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

Подробная структура TMF описывается в разделе Настройка шаблонов make-файлов.

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

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

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

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

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

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

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

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

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

Чтобы отобразить блоки в стандартном браузере Simulink Library Browser и/или интегрировать ваши примеры в сеанс работы с 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, и т.д.). Обычно ваша цель поддерживает хотя бы одну такую среду разработки и вызывает ее компилятор, linker и другие утилиты в процессе сборки. mytarget/dev_tool1 включает файлы команды linker, код запуска, функции hook и другие файлы, необходимые для поддержки этого процесса.

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

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

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

Введение

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

mytarget.tlc

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

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

Customize System Target Files дает подробную информацию о структуре системного целевого файла, а также дает инструкции о том, как настроить системный целевой файл

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 является необязательным файлом hook, который можно использовать для вызова функций или исполняемых файлов конкретного целевого устройства в заданных точках процесса сборки. STF_make_rtw_hook.m реализует функцию, которая отправляет конкретное действие в зависимости от method переданный в него аргумент.

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

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

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

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

Для обратной совместимости существующие STF_rtw_info_hook файлы все еще доступны. Однако необходимо преобразовать цель и модели в область Аппаратная реализация (Hardware Implementation). См. «Настройка опций окружения во время выполнения».

info.xml

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

mytarget_overview.html

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

The <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.

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

Чтобы разработать целевой процессор, вам нужно глубокое понимание процесса сборки. Ваш целевой процессор использует процесс сборки и может потребовать изменения или настройки процесса. Общий обзор генерации кода и процесса сборки представлен в Code Generation and Build Process.

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

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

Построение фаз процесса и передача информации

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

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

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

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

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

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

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

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

Для получения дополнительной информации смотрите System Target File Structure.

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

Для получения дополнительной информации смотрите System Target File Structure.

Доступ к переменным окружения хоста.  Вы можете получить доступ к переменным окружения интерпретатора хоста в командной строке MATLAB, введя getenv команда. Для примера:

getenv ('MSDEVDIR')

ans =

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

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

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

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

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

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

Следующие примеры кода иллюстрируют использование данных приложения для передачи информации в 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-файлу.  The rtwmakecfg механизм предоставляет метод для встроенных S-функций, таких как блоки драйверов, чтобы добавить информацию к make-файлу. Этот механизм описан в разделе Использование rtwmakecfg.m API для настройки сгенерированных make-файлов.