 Использование менеджера библиотек

Библиотеки ISaGRAF обеспечивают стандартный интерфейс между автоматической разработкой и возможностями программного обеспечения или оборудования целевой системы ISaGRAF. Существует по одной библиотеке для каждого типа интерфейса. Менеджер Библиотек ISaGRAF Workbench предназначен для разработчика оборудования или программного обеспечения. Разработчик использует менеджер библиотек для описания интерфейса программирования ISaGRAF с объектами, которые он создает.

Управление элементами библиотеки

Конфигурация В/В

Сложное оборудование В/В

Плата В/В

Функции и блоки, написанные на языке IEC

Функции и функциональные блоки на C

Функции преобразования

Архивирование элементов библиотеки

Менеджер Библиотек ISaGRAF Workbench показывает элементы одной из библиотек ISaGRAF. В левой области окна находится список элементов выбранной библиотеки. В правой области находятся технические замечания (руководство пользователя) по элементу, в настоящий момент выбранному в списке элементов. Меню менеджера библиотек содержат команды для создания, определения или изменения элементов активной библиотеки. Команда Файл / Другая библиотека разрешает выбор одной из библиотек ISaGRAF. Окно с левой стороны от меню средств тоже может быть использовано для выбора библиотеки:


Управление элементами библиотеки

Используйте команды меню Файл для создания элементов и работайте с существующими элементами в открытой библиотеке.

Создание нового элемента

Работа с существующими элементами

Установка парольной защиты

Компилирование функций и функциональных блоков

Технические замечания

Параметры

Исходные коды С


Создание нового элемента

Команда Новый из меню Файл создает новый элемент в выбранной библиотеке. Имя нового элемента вводится на основе следующих правил:

•	Длина имени не должна превышать 8 символов

•	Первый символ должен быть буквой

•	Следующие должны быть буквами, цифрами или символом подчеркивания

•	Верхний и нижний регистры в наименовании не различаются.

Текстовые комментарии связываются с каждым элементом библиотеки. Этот комментарий вводится во время создания элемента. Когда создается новый элемент, то должно быть введено следующее:

•	его определение для конфигурации В/В,

•	его параметры для платы В/В,

•	его пользовательский интерфейс для функции или функционального блока.

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


Работа с существующими элементами

Команда Файл / Переименовать позволяет пользователю изменить имя или комментарий элемента, выбранного из списка элементов. Команда Файл / Копировать позволяет пользователю копировать элемент, высвеченный в активной библиотеке, на другой элемент в той же самой библиотеке. Если элемент назначения уже существует, то все его содержание будет перезаписано. Если элемент назначения не существует, то он будет автоматически создан. Команда Файл / Удалить удаляет текущий выбранный элемент из активной библиотеки. Следующие компоненты элемента управляются командами Переименовать, Копировать и Удалить:

•	техническое примечание

•	полное определение для конфигурации В/В

•	параметры для платы В/В или сложного оборудования

•	определение интерфейса для функции или функционального блока

•	исходные коды для функции и функционального блока, написанного на языке IEC

•	исходные коды для преобразования С, функции или функционального блока

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

Если элемент - это функция, написанная на языке IEC, то имя возвращаемого параметра не изменяется командами Переименовать или Копировать.


Установка парольной защиты

Команда Файл / Установить пароль позволяет пользователю определить парольную защиту для выбранного элемента в открытой библиотеке. Обратитесь к разделу Парольная защита, в конце первой части этого руководства для получения дальнейшей информации об уровнях паролей и защите данных. Пароли относятся только к выбранному элементу. Они не имеют никакого влияния на другие элементы в библиотеке ISaGRAF.


Компилирование функций и функциональных блоков

Когда выбрана библиотека функций или функциональных блоков, написанная на языке IEC, команда Проверить (Компилировать) меню Файл используется для проверки синтаксиса выбранного элемента и создания его объектного кода. Функции и блоки, написанные на языке IEC, должны быть скомпилированы без ошибок, прежде чем они могут быть использованы в проектах ISaGRAF. Эта команда не эффективна, если выбрана другая библиотека.


Технические замечания

Команда Редактор/ Технические замечания позволяет пользователю определить стандартный текстовый формат для всех элементов текущей выбранной библиотеки. Во время редактирования технического замечания нового элемента, этот формат используется как основной скелет. Это позволяет пользователю оптимизировать редактирование технического замечания.

Команда "Инструменты / Стандартный формат замечания " позволяет пользователю определить стандартный текстовый формат для всех элементов текущей выбранной библиотеки. Во время редактирования технического замечания нового элемента, этот формат используется как основной скелет. Это позволяет пользователю оптимизировать редактирование технического замечания.


Параметры

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

Параметры конфигурации В/В определяют полный набор плат В/В конфигурации, и имена переменных по умолчанию, используемых для каналов В/В. Параметры платы В/В или сложного оборудования определяют физическую или логическую конфигурацию платы. Параметры функции или функционального блока определяют интерфейс элемента, в соответствии с соглашениями вызова функций ST языка. Для функции преобразования не существует параметров, так как она использует стандартный предопределенный интерфейс.


Исходные коды С

ISaGRAF Workbench позволяет программисту управлять исходным кодом библиотечного преобразования, функции или функционального блока. Исходный код функции или блока, написанный на языке IEC, - это текст или диаграмма, описанная языком, прикрепленным к функции. Исходные коды С компонентов (С функции, функциональные блоки С и функции преобразования) разделяются на два раздельных файла: исходный код С заголовка, который содержит именно определение интерфейса, в соответствии с определением параметров элемента, и файл исходного кода С, который содержит реализацию работы элемента.

ISaGRAF Workbench генерирует файл исходного кода, когда создается новый библиотечный элемент. Он также создает и обновляет исходный заголовок, основанный на определении параметров. Программист может использовать текстовый редактор ISaGRAF для завершения файла исходного кода.


Конфигурация В/В

Библиотека конфигурации В/В ISaGRAF обеспечивает легкий путь для инициализации новых проектов ISaGRAF с предопределенной конфигурацией В/В. Конфигурация В/В определяет:

•	набор плат В/В

•	значения по умолчанию для параметров плат В/В

•	имена по умолчанию для каналов В/В

Когда создается новый проект ISaGRAF с библиотечной конфигурацией В/В, соответствующее соединение В/В автоматически устанавливается, и переменные В/В, соответствующие именам каналов, автоматически объявляются в словаре проекта.

Определение конфигурации В/В делается при помощи средств Соединения В/В ISaGRAF (то же самое средство используется внутри проекта). Обратитесь к разделу Соединение В/В в руководстве для получения дальнейшей информации по тому, как использовать это средство. Когда вставляется новая плата В/В в конфигурацию, все каналы новой платы объявляются со стандартными именами по умолчанию. Стандартное имя по умолчанию канала В/В имеет следующий формат:

<направление><тип><номер_разъема>_<номер_канала>

Первый символ обозначает направление канала В/В:

I …………………. канал ввода

O ………………… канал вывода

Второй символ обозначает тип канал В/В:

X …………………. логический

D …………………. аналоговый

M ………………… сообщение

Ниже даны примеры стандартных имен каналов В/В:

IX0_7 ……………….. логический вход - плата №0 - канал №7

QD2 _4 ……………… целочисленный выход - плата №2 - канал №4

Команда Соединить каналы В/В  Редактора Соединений В/В используется для изменения имени по умолчанию, присоединенного к каналу В/В.


Сложное оборудование В/В

Все каналы одиночной платы имеют тот же самый тип (логический, аналоговый или сообщение) и направление (ввод или вывод). Сложное оборудование В/В представляет устройство В/В с каналами различных типов или направлений. Сложное оборудование В/В представляется как список одиночных плат В/В. Оно использует только один разъем в списке шасси соединений В/В.

Для определения сложного оборудования В/В пользователь должен определить список одиночных плат, которые определят оборудование В/В. Он также должен ввести детальные параметры каждой одиночной платы. Список одиночных плат В/В вводится при помощи окна диалога.

Нажатие кнопки Добавить позволяет пользователю добавить одиночную плату в конец текущего списка. Кнопка Вставить используется для вставки новой одиночной платы перед текущей выбранной платой в списке. Кнопка Удалить удаляет выбранную одиночную плату из списка. Кнопки Переименовать и Параметры используются для изменения имени и параметров выбранной одиночной платы. Обратитесь к соответствующему разделу для полного объяснения параметров одиночной платы. Сложное оборудование В/В может группировать до 16 одиночных плат В/В. Имя одиночной платы (внутри оборудования В/В) не может превышать 8 символов.


Плата В/В

Библиотека плат В/В ISaGRAF определяет стандартный интерфейс между переменными приложения и целевым оборудованием. Во время описания приложения все переменные В/В подключаются к каналам целевой платы В/В. Плата В/В ISaGRAF определяется по имени и по ключевому коду OEM (OEM key code), который определяет его поставщика. Другие параметры платы В/В описывают топологию платы В/В (количество каналов, направление канала и тип), и конфигурацию, оборудования или программную.

Параметры платы В/В

Параметры OEM


Параметры платы В/В

Существует два различных типа параметров для платы В/В: общие параметры, которые определяются для любой платы библиотеки ISaGRAF, и OEM параметры, которые специфичны для реализации платы, обеспечиваемые поставщиком оборудования. Общие параметры вводятся в верхней части окна определения параметров платы В/В. Эти параметры (плюс имя платы В/В) идентифицируют стандартный интерфейс платы В/В ISaGRAF.

Ключевой код OEM - простое число, которое определяет поставщика оборудования. Все платы, определенные одним поставщиком, должны иметь один и тот же ключевой код OEM. Ключевой код OEM - это 16 битное беззнаковое слово, введенное в шестнадцатеричном формате. Зарезервированный ключевой код OEM для CJ International равен 1.

Главные параметры определяют топологию платы В/В. Число каналов определяют число доступных каналов на плате. Тип платы - это тип переменных, которые могут быть подключены к каналам платы. Направление определяет какие переменные подключены к плате - входные или выходные.

Замечание: Переменные В/В различных типов или направлений не могут быть сгруппированы на одной и той же плате В/В ISaGRAF. Это свойство требует сложного оборудования В/В.


Параметры OEM

Параметры OEM вводятся в нижней части окна определения параметров платы В/В. Эти параметры определяются поставщиками плат В/В и являются специфичными для платы. Существует максимум 16 OEM параметров для платы. Плата может не иметь OEM параметры. Менеджер библиотек ISaGRAF позволяет поставщику оборудования определить идентификацию и формат каждого параметра, и метод их ввода.

Квадрат слева содержит список OEM параметров. Каждый параметр идентифицируется именем и логическим номером, с 0 до 15. Площадь справа содержит детальное описание параметра, выбранного слева. Параметр выбирается в списке для доступа к его полному описанию. Нажатие кнопки Очистить сбрасывает описание параметра и удаляет его из списка параметров. Предупреждение: отмена этой команды невозможна.

Имя параметра используется для идентификации соответствующего входного поля во время соединения платы В/В, если поле должно быть определено автоматическим оператором. Имя параметра должно удовлетворять следующим правилам:

•	максимальная длина имени 16 символов

•	первый символ должен быть буквой

•	следующие символы должны быть буквами, цифрами или символом _.

Тип параметра определяет внутренний формат параметра и его входной параметр во время соединения В/В приложения. Ниже дан список возможных внутренних форматов:

word ………….. беззнаковое 16 битное слово

long …………… беззнаковое 32 битное слово

word hexa …….. беззнаковое 16 битное слово

long hexa …….. беззнаковое 32 битное слово

boolean ………. беззнаковое 16 битное слово (только младший бит используется)

character …….. беззнаковое 16 битное слово (только младший байт используется

string ………… массив из 16 байт, содержащий строку, оканчивающуюся нулем

float …………. простой точности 32 битное плавающее значение

Ниже даны возможные входные форматы:

word …………. беззнаковое десятичное слово

long ………….. беззнаковое длинное слово

word hexa …… беззнаковое шестнадцатеричное слово

long hexa ……. беззнаковое шестнадцатеричное длинное слово

boolean ……… true или false

character ……. один символ

string ………… строка в кодах ascii (максимум 15 символов)

float …………. простой точности плавающее значение

Окно доступ используется для определения того, как конечный пользователь может получить доступ к параметру. Если установлена опция Пользователь, то параметр показывается как входное поле во время соединения платы В/В. Значение по умолчанию OEM параметра используется как начальное для редактирования параметра. Если установлена опция Скрытый, то параметр является константой и не появляется в окне соединения платы В/В. Значение по умолчанию OEM параметра определяет значение параметра константы. Опция Только на чтение  индицирует, что параметр видим для пользователя, но не может быть изменен. Его значение по умолчанию используется как константа.


Функции и блоки, написанные на языке IEC

ISaGRAF управляет библиотекой функций и функциональных блоков, написанных на языке IEC. Доступные языки для описания таких функций или блоков - это FBD (Function Block Diagram), LD (Ladder Diagram), ST (Structured Text), IL (Instruction List). Заметьте, что языки LD и FBD могут быть смешаны в одной и той же диаграмме. Язык SFC (Sequential Function Chart) не может быть использован для описания функции или блока в библиотеке. Язык, прикрепленный к элементу библиотеки, выбирается когда создается функция, и не может быть изменен позже.

Компиляция

Ввод исходных кодов

Словарь локальных переменных

Определение интерфейса


Компиляция

Функции и блоки, определенные в библиотеке, должны быть скомпилированы (проверены) перед тем, как они могут быть использованы в проекте ISaGRAF. Более ничего не должно быть изменено со стороны Библиотеки, касающееся функций и блоков. Элементы библиотеки автоматически появляются в окне меню выбора, когда используется графический редактор LD/FBD внутри проекта.

Функция, определенная в библиотеке, может вызывать другую библиотечную функцию. Однако система ISaGRAF не поддерживает рекурсивность в вызове функций. Функциональный блок, написанный на языке IEC, не может вызывать другие функциональные блоки (ни на IEC, ни на языке С).


Ввод исходных кодов

Исходный код библиотечной функции или функционального блока вводится, используя стандартные средства ISaGRAF: графический редактор для LD или FBD программ, текстовый редактор для ST или IL программ. Обратитесь к соответствующему разделу в этом руководстве для получения дальнейшей информации об этих средствах. Генератор Кодов ISaGRAF может быть напрямую вызван из графического или текстового окна редактирования для завершения исходного кода библиотечной функции или блока.


Словарь локальных переменных

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

Библиотечная функция или функциональный блок не имеют доступа к глобальной переменной или экземпляру функционального блока. Локальные переменные функции должны быть инициализированы в теле функции.

Локальные переменные функционального блока, написанные на языке IEC, копируются (экземпляр) каждый раз, когда блок используется в проекте. Локальные переменные экземпляра сохраняют свои значения от вызова к вызову.


Определение интерфейса

Функции или функциональные блоки могут иметь до 32 параметров (входов или выходов). Функция всегда имеет один (и только один) возвращаемый параметр, который должен иметь то же самое имя, что и функция, для соответствия соглашениям языка ST. Следующее окно диалога используется для описания параметров функции или блока:

Список в верхней левой части окна показывает параметры, в порядке вызывающей модели: сначала параметры вызова, потом параметры возврата. Нижняя часть окна показывает детальное описание параметра, в данный момент выбранного в списке. Любой из типов данных ISaGRAF может быть использован для параметра. Параметры возврата должны быть расположены в списке после параметров вызова. Наименование параметров должно соответствовать следующим правилам:

•	длина имени не должна превышать 16 символов

•	первый символ должен быть буквой

•	следующие должны быть буквами, цифрами или символом подчеркивания

•	верхний и нижний регистры в наименовании не различаются

Команда Вставить используется для вставки нового параметра перед выбранным параметром. Команда Удалить используется для удаления выбранного параметра. Команда Упорядочить автоматически переставляет (сортирует) параметры так, что параметр возврата ставится в конец списка.


С функции и функциональные блоки

С функции и функциональные блоки - это компьютерные функции, вызываемые из приложения автоматизации, в соответствии с интерфейсом вызова функций языка ST.

Функции являются синхронными процессами. Целевое приложение ISaGRAF приостанавливается во время выполнения функции. Функциональные блоки объединяют операции и статические скрытые данные. Например, функция счетчик представляет операцию счета, а также результат счета. Функции и функциональные блоки могут быть использованы для пополнения возможностей стандартного языка автоматизации, или для доступа к системным ресурсам.

Окно определения параметров используется для определения имени и типа каждого вызываемого или возвращаемого параметра функции или функционального блока. Меню команд Редактировать используется для определения параметров выбранной функции или функционального блока. Функция может иметь до 31 вызываемого параметра и всегда один возвращаемый параметр. Функциональный блок может иметь до 32 параметров с любым соотношением вызываемых и возвращаемых параметров. Ниже дано соответствие между типами ISaGRAF и типами С:

BOOLEAN	unsigned long	беззнаковое 32 битное слово: 1=true / 0=false

ANALOG	long	знаковое целое 32 битное слово

REAL	float	простой точности плавающее значение

TIMER	unsigned long	беззнаковое целое 32 битное слово (блок - 1 ms)

MESSAGE	char *	строка символов

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

Обратитесь к ISaGRAF Target Users Guide для получения дальнейшей информации по тому, как управлять исходным кодом С функции или функционального блока, и как интегрировать новый элемент в целевую систему ISaGRAF.


Функции преобразования

Функция преобразования - это С функция, вызываемая менеджером В/В ISaGRAF каждый раз, когда аналоговая переменная, использующая это преобразование, является входом или выходом проекта.

Функция создает отношение между электрическим значением переменной (считанное на входном датчике или посланное на выходное устройство) и его физическим значением (используемое в выражениях приложения). Следовательно, функция делится на две части: входное преобразование и выходное преобразование. Менеджер библиотек ISaGRAF позволяет пользователю управлять исходным кодом С функции преобразования.

Преобразование может быть использовано для целочисленных и вещественных аналоговых переменных. Это значит, что интерфейс функции преобразования всегда определяется плавающими значениями. Интерфейс одинаков для любой функции преобразования. Определение С этого интерфейса сделано в файле определения TACN0DEF.H.

Обратитесь к ISaGRAF Target Users Guide для получения дальнейшей информации по тому, как управлять исходным кодом С функции преобразования, и как интегрировать новый элемент в целевую систему ISaGRAF.


Архивация элементов библиотеки

Команда "Инструменты / Архив" запускает менеджер архивов ISaGRAF чтобы сохранить или восстановить элементы библиотеки. Вы должны выбрать библиотеку перед запуском "Команды архив ". Менеджер архивов показывает элементы только одной библиотеки за раз.