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

Обработайте лексемы make-файла по шаблону

make_rtw команда (или различная команда, которой предоставляют некоторые цели), направляют процесс генерации model_or_sharedutils.mk. make_rtw команда обрабатывает TMF, заданный на панели Code Generation диалогового окна Configuration Parameters. make_rtw копирует TMF, линию за линией, расширяя каждую лексему, с которой сталкиваются. Обработайте по шаблону Лексемы Make-файла, Расширенные списками 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 (на) или 0 (прочь), в зависимости от того, как вы устанавливаете опции режима 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 при помощи параметра конфигурации модели Делают команду. (См., что разделы Задают Сделать Make-файлы Команды и Шаблона и Делают Опции.)

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

makecommand -f model_or_sharedutils.mk OPT_OPTS=-O2

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

сделайте Версии программы

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

matlabroot/bin

Возможно использовать другие версии make с генератором кода, несмотря на то, что GNU Делают, рекомендуется. Чтобы быть совместимыми с генератором кода, проверьте что ваша версия 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, необходимо предоставить информацию в системном заголовке файла конечного файла (см. Системную Структуру Конечного файла). Для цели, которая реализует один 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] среда принята. В среде PC расширения файла и компиляция и команды ссылки отличаются.

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

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.

Формат TMFs следует вышеупомянутому примеру. Наши TMFs используют дополнительные функции 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

TMFs обеспечивают лексемы, которые позволяют вам добавить следующие элементы в сгенерированные 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 верно, сгенерированный код имеет односкоростной интерфейс вызова.

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

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

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

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

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

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