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

Маркеры Makefile шаблона

make_rtw команда (или другая команда, предоставляемая с некоторыми целями) управляет процессом генерации model_or_sharedutils.mk. make_rtw обрабатывает TMF, указанный на панели «Создание кода» диалогового окна «Параметры конфигурации». make_rtw последовательно копирует TMF, расширяя каждый обнаруженный маркер. В шаблоне Makefile Tokens Expansed by make_rtw перечислены маркеры и их расширения.

Эти маркеры используются несколькими способами в расширенном makefile:

...
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 (на) или 0 (выкл.), в зависимости от способа установки параметров внешнего режима.

rtwoptions(2).makevariable = 'EXT_MODE'

Создать команду

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

makecommand -f model_or_sharedutils.mk

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

Например, указание OPT_OPTS=-O2 в поле Создать причины команды make_rtw для создания следующего make команда.

makecommand -f model_or_sharedutils.mk OPT_OPTS=-O2

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

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

Утилита Make позволяет контролировать практически все аспекты построения программы в реальном времени. Существует несколько различных версий make доступно. Генератор кода предоставляет Free Software Foundation GNU ®make как для платформ UNIX ^{® [}1], так и для ПК в папках для конкретных платформ в

matlabroot/bin

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

makecommand -f model_or_sharedutils.mk

Введение

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

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

Настройка Makefile шаблона

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

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

Чтобы процесс сборки мог найти и выбрать TMF, необходимо предоставить информацию в заголовке целевого файла системы (см. раздел Структура целевого файла системы). Для целевого объекта, реализующего один TMF, стандартным способом определения TMF, используемого в процессе построения, является использование директивы TMF заголовка системного целевого файла.

TMF: mytarget.tmf

Использование макросов и выражений соответствия шаблонов в Makefile шаблона

В этом разделе на примере показано, как использовать макросы и выражения соответствия шаблонам файлов в 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]. В среде ПК расширения файлов и команды компиляции и связывания различаются.

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

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] Make, можно заменить два "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, для использования специального "$@"макро.

Настройка созданных Makefile с помощью rtwmakecfg

TMF предоставляют маркеры, позволяющие добавлять следующие элементы в созданные makefile:

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

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

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

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

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

Изменения Makefile шаблона.  Добавить 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 принимая во внимание следующее:

Рекомендации по ссылкам на модели

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

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

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

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