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

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

Команда make_rtw (или различная команда, которой предоставляют некоторые цели), направляют процесс генерации model_or_sharedutils.mk. Команда make_rtw обрабатывает TMF, заданный на панели Code Generation диалогового окна Configuration Parameters. make_rtw копирует TMF, линию за линией, расширяя каждую лексему, с которой сталкиваются. Обработайте по шаблону Лексемы Make-файла, Расширенные списками make_rtw лексемы и их расширения.

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

Эти лексемы расширены заменой значений параметров, известных процессу сборки. Например, если исходная модель содержит блоки с двумя различными шагами расчета, оператором 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 в Сделать поле команды панели Code Generation. (См., что разделы Задают Сделать Команду (Simulink Coder) и Make-файлы Шаблона и Делают Опции (Simulink Coder).)

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

makecommand -f model_or_sharedutils.mk OPT_OPTS=-O2

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

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

Сделать утилита позволяет вам управлять почти каждым аспектом создания вашей программы в реальном времени. Существует несколько различных версий доступного make. Генератор кода обеспечивает Free Software Foundation 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/rtw/c/grt (open)
matlabroot/rtw/c/ert (open)

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

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

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-файлы (Simulink Coder).

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

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