Определение включаемого текста (оператор Include)

Оператор Include позволяет импортировать текст из файла с расширением.inc в текущий файл. Следующий пример демонстрирует использование оператора Include:

INCLUDE "const.inc";

Оператор Include имеет следующие характеристики:

¨ Оператор Include начинается с ключевого слова INCLUDE, за которым следует имя подключаемого.inc-файла, заключенного в двойные кавычки.

¨ Если явно не указывать расширение подключаемого файла, то компилятор по умолчанию предполагает, что файл имеет расширение.inc.

¨ Оператор Include заканчивается символом (;).

¨ На этапе компиляции осуществляется замена оператора Include содержимым.inc-файла. В примере, показанном выше, файл const.inc заменяет текст INCLUDE “const.inc”;

Оператор Include часто используется для подключения прототипов функций для файлов более низкого уровня иерархии по отношению к данному текстовому файлу проекта (TDF). Для использования мега- и макрофункций необходимо сначала определить их логику функционирования в соответствующем файле проекта. Затем необходимо использовать оператор Function Prototype для определения портов функции. В качестве альтернативного варианта, можно использовать оператор Include для подключения прототипа функции, хранящегося в соответствующем файле с расширением.inc. Затем можно осуществить объявление объекта (Instance Declaration) или подставляемую ссылку (in-line reference) дляэкземпляра логической функции.

Можно автоматически создать файл с расширением.inc, содержащий прототип функции для текущего файла проекта, с помощью команды Create Default Include File меню File.

На этапе компиляции текстового файла проекта, компилятор осуществляет поиск файлов с расширением.inc в следующей последовательности:

1. Сначала осуществляется поиск в директории данного проекта

2. Просматриваются пользовательские библиотеки указанные командой User Libraries меню Options.

3. Просматриваютсядиректории \maxplus2\max2lib\mega_lpm и \maxplus2\max2inc, созданные во время инсталляции.

После изменений, внесенных в текстовый файл проекта (TDF), в котором осуществляется подключение файлов с расширением.inc, можно использовать команду Project Save&Check меню File или осуществить полную перекомпиляцию проекта для обновления дерева иерархии проекта, выводимого в окне отображения иерархии проекта.

При использовании оператора Include необходимо соблюдать следующие правила:

¨ Имя файла, приведенного в операторе Include, не должно содержать пути.

¨ В программном обеспечении рабочих станций имена файлов контекстно-зависимы. В документации MAX+PLUSII имена файлов могут приводиться как с использованием прописных, так и строчных букв. Однако в случае использования оператора Include имена файлов должны в точности повторять их оригинальные имена. Названия макро- и мегафункций поставляемых фирмой Altera целиком состоят из строчных букв.

¨ Oператор Include должен быть расположен за пределами других разделов языка AHDL.

¨ Оператор Include может использоваться произвольное количество раз в рамках одного текстового файла проекта (TDF).

Файлы с расширением.inc должны удовлетворять следующим соглашениям:

¨ Полные имена этих файлов должны иметь расширение.inc.

¨ Файлы с расширением.inc могут содержать лишь следующие операторы:

· Function Prototype

· Define

· Parameters

· Constant

Вложенность при использовании файлов с расширением.inc недопустима.

Файлы с расширением.inc не должны содержать секцию Subdesign.

Дата добавления: 2015-08-21