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

Шаблон лексем make-файла

The make_rtw команда (или другая команда, обеспечиваемая некоторыми целями) направляет процесс генерации model_or_sharedutils.mk. The make_rtw команда обрабатывает TMF, заданный на панели Code Generation диалогового окна Параметров конфигурации. make_rtw копирует TMF, линию за линией, расширяя каждый встречающуюся лексему. Шаблон Make Лексем Expanded by make_rtw приводит список лексем и их расширений.

Эти лексемы используются несколькими способами расширенным make-файлом:

...
NUMST = |>NUMST<|
...
CPP_REQ_DEFINES1 = ... -DNUMST=$(NUMST) ...

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

NUMST = |>NUMST<|

расширяется до:

NUMST = 2

В дополнение к вышесказанному make_rtw расширяет лексемы из других источников:

Следующий пример извлечен из matlabroot/ rtw/c/grt/grt.tlc. Раздел, начинающийся с BEGIN_RTW_OPTIONS содержит код MATLAB, который настраивает rtwoptions. Следующая директива вызывает |>EXT_MODE<| лексема, который будет расширен до 1 (on) или 0 (off), в зависимости от того, как вы устанавливаете опции режима external mode.

rtwoptions(2).makevariable = 'EXT_MODE'

Сделать команду

После создания model_or_sharedutils.mk из вашего TMF процесс сборки вызывает make команда. Для вызова makeпроцесс сборки выдает эту команду.

makecommand -f model_or_sharedutils.mk

makecommand определяется MAKECMD макрос в целевом файле системы TMF (см. «Структура шаблона make-файла»). Можно задать дополнительные опции для make при помощи команды model параметра конфигурации Make. (См. разделы «Задание Команда и шаблонов MakeFiles и Make Options».)

Для примера укажите OPT_OPTS=-O2 в командном поле Make приводит к make_rtw чтобы сгенерировать следующую make команда.

makecommand -f model_or_sharedutils.mk OPT_OPTS=-O2

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

Сделать версии утилиты

Утилита make позволяет управлять почти каждым аспектом создания программы в реальном времени. Существует несколько различных версий make доступно. Генератор кода обеспечивает Фонд свободного программного обеспечения GNU^® make для обоих UNIX^®[1] и платформы ПК в подпапках для конкретной платформы в

matlabroot/bin

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

makecommand -f model_or_sharedutils.mk

Введение

В этом разделе описывается механика настройки пользовательского шаблона make-файла (TMF) и включения его в процесс сборки. В нем также рассматриваются методы модификации TMF и ФАЙЛА MATLAB механизмов, связанных с TMF.

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

Настройка шаблона make-файла

Чтобы настроить или создать новый TMF, скопируйте существующий GRT или ERT TMF из matlabroot/toolbox/coder/compile/tmf.

Поместите копию в ту же папку, что и связанный системный целевой файл. Обычно это mytarget/mytarget папка в структуре целевой папки. Затем переименуйте свой TMF (для примера, mytarget.tmf) и измените его.

Чтобы позволить процессу сборки найти и выбрать ваш TMF, вы должны предоставить информацию в системном заголовке файла целевого файла (см. System Target File Structure). Для цели, которая реализует один TMF, стандартным способом определения TMF, который будет использоваться в процессе сборки, является использование директивы TMF заголовка файла целевого системного файла.

TMF: mytarget.tmf

Использование макросов и шаблонов, соответствующих выражениям в шаблоне make-файла

В этом разделе показан, на примере, как использовать макросы и выражения, соответствующие файловому шаблону, в TMF, чтобы сгенерировать команды в model_or_sharedutils.mk.

Делайте служебные процессы model_or_sharedutils.mk и генерирует набор команд на основе правил зависимостей, определенных в model_or_sharedutils.mk. После make генерирует набор команд для создания или перестроения test, make выполняет их.

Например, чтобы создать программу под названием test, make необходимо связать файлы объектов. Однако, если файлы объектов не существуют или устарели, make необходимо скомпилировать исходный код. Таким образом, существует зависимость между исходным и объектным файлами.

Каждая версия make немного отличается своими функциями и тем, как заданы правила. Например, рассмотрим программу, называемую test который создается из двух источников, file1.c и file2.c. Использование большинства версий make, правила зависимости были бы

test: file1.o file2.o
        cc -o test file1.o file2.o

file1.o: file1.c
        cc -c file1.c

file2.o: file2.c
        cc -c file2.c

В этом примере UNIX^[2] окружение принято. В среде ПК расширения файлов и команды compile и link отличаются.

При обработке первого правила

test: file1.o file2.o

make видит, что строить test, он должен построить file1.o и file2.o. Как создать file1.o, make обрабатывает правило

file1.o: file1.c

Если file1.o не существует, или если file1.o старше file1.c, make компилирует file1.c.

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

MACRO_NAME = value

Ссылки на макросы делаются с помощью $(MACRO_NAME). Когда make видит эту форму выражения, она заменяет value для $(MACRO_NAME).

Можно использовать выражения соответствия шаблона, чтобы сделать правила зависимостей более общими. Для примера использование GNU^[3] Сделайте, вы можете заменить два "file1.o: file1.c«и» file2.o: file2.c"правила с одним правилом

%.o : %.c
        cc -c $<

Обратите внимание, что $< в предыдущем примере является специальным макросом, который приравнивается к файлу зависимостей (то есть file1.c или file2.c). Таким образом, используя макросы и "%"символ соответствия шаблона, предыдущий пример может быть сокращен до

SRCS = file1.c file2.c
OBJS = $(SRCS:.c=.o)

test: $(OBJS)
        cc -o $@ $(OBJS)

%.o : %.c
        cc -c $<

Обратите внимание, что $@ макрос выше является другим специальным макросом, который приравнивается к имени текущего целевого объекта зависимостей, в этом случае test.

Этот пример генерирует список объектов (OBJS) из списка источников (SRCS) с помощью функции подстановки текста для макро-расширения. Он заменяет расширение исходного файла (для примера, .c) с расширением файла объекта (.o). Этот пример также обобщил правило сборки для программы, test, для использования специального "$@"макрос.

Настройка сгенерированных make-файлов с rtwmakecfg

TMF обеспечивают лексемы, которые позволяют добавлять следующие элементы к сгенерированным make-файлам:

S-функции могут добавить эту информацию в make-файл при помощи rtwmakecfg.m Файл функция. Эта функция особенно полезна при построении модели, которая содержит один или несколько ваших блоков S-Function, таких как блоки драйверов устройств.

Чтобы добавить информацию, относящуюся к S-функции, в make-файл,

После фазы TLC процесса сборки, при генерации make-файла из TMF, процесс сборки ищет rtwmakecfg.m файл в папке, содержащей компонент S-функции. Если он находит файл, процесс сборки вызывает rtwmakecfg функция. Для получения дополнительной информации смотрите Использовать rtwmakecfg.m API для настройки сгенерированных make-файлов.

Поддержка непрерывного времени в пользовательских целях

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

Изменения шаблона make-файла.  Добавьте NCSTATES расширение токена после NUMST расширение токена следующим образом:

NUMST = |>NUMST<|
NCSTATES = |>NCSTATES<|

В сложение добавить NCSTATES на CPP_REQ_DEFINES макрос, как в следующем примере:

CPP_REQ_DEFINES = -DMODEL=$(MODEL) -DNUMST=$(NUMST) -DNCSTATES=$(NCSTATES) \
-DMAT_FILE=$(MAT_FILE)
-DINTEGER_CODE=$(INTEGER_CODE) \
-DONESTEPFCN=$(ONESTEPFCN) -DTERMFCN=$(TERMFCN) \
-DHAVESTDIO
-DMULTI_INSTANCE_CODE=$(MULTI_INSTANCE_CODE) \

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

Когда у модели есть непрерывное время и флаг TID01EQ верно, и непрерывное время, и самое быстрое дискретное время рассматриваются как одна скорость в сгенерированном коде. Код, сопоставленный с самой быстрой дискретной скоростью, охраняется основной проверкой временного шага. Когда модель имеет только две скорости, и TID01EQ true, сгенерированный код имеет односкоростной интерфейс вызова.

Чтобы поддержать модели, которые имеют непрерывное время, обновите статический основной модуль, чтобы взять TID01EQ принять во внимание следующее:

Модель-ссылка Факторов

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

Ошибка тайм-аута при создании общего служебного кода с пользовательским шаблоном make-файла

Если процесс сборки использует пользовательский файл make-файла шаблона для создания файла make-файла для общего кода утилиты, процесс сборки создает ошибку timeout, когда применяются все эти условия:

Чтобы избежать ошибки, обновите пользовательский шаблон make-файла так, чтобы make вызов генерирует BUILD_SUCCESS сообщение только, когда конечный продукт сгенерирован (как идентифицировано make переменная PRODUCT). Кроме того, если процесс сборки не использует сгенерированный make-файл, отключите генерацию make-файла, установив параметр конфигурации GenerateMakefile на 'off'.