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