Оператор 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.