Руководство пользователя

Скачать инсталлятор среды Полигон для ОС Windows можно по ссылке.

Рекомендуемые системные требования:

• ОС: Windows 7/8/10/11 64 Bit;

• Оперативная память: 4 Гб и выше;

• Память на диске: 2 Гб и выше.

Для установки среды следует:

1. Распаковать скачанный архив и запустить Polygon2Installer_LinuxOwen3.exe.

   

   

2. Выбрать путь для установки среды Полигон. По умолчанию среда устанавливается на диск C.

   Примечание

   Путь установки среды не должен содержать кириллицу и пробелы.

   

3. Выбрать компоненты для установки.

   По умолчанию инсталлятор устанавливает саму среду Полигон и пакет сборки под текущую заводскую прошивку ПЛК210. Для выборочной установки можно отметить требуемый компонент флажком.

   

4. Ознакомиться с лицензионным соглашением и принять его.

   

5. ЕЕсли необходимо, создать папку для ярлыков в меню Пуск.

   

6. Нажать Установить.

   

Когда установка завершится, на рабочем столе появится ярлык программы Полигон. Инсталлятор предложит открыть краткое описание демонстрационного проекта.

Инсталлятор также предложит установить или обновить драйверы Guardant.

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

Скачать скрипт установки среды Полигон для ОС Linux можно по ссылке.

Рекомендуемые системные требования:

• ОС: Astra Linux Special Edition 1.7, Ubuntu (версия ядра Linux 5.10 и выше);

• Оперативная память: 4 Гб и выше;

• Память на диске: 2 Гб и выше.

Для установки среды следует:

1. Распаковать архив со скриптом установки.

2. Дать права на исполнение скрипта установки Polygon2Installer_LinuxOwen3.sh.

   

3. Запустить скрипт установки.

4. Следовать инструкциям инсталлятора.

   

5. Указать директорию для установки среды Полигон.

   Примечание

   Путь установки среды не должен содержать кириллицу и пробелы.

   

6. Выбрать компоненты среды для установки. По умолчанию инсталлятор устанавливает саму среду Полигон и пакет сборки под текущую заводскую прошивку ПЛК210.

   

7. Ознакомиться с лицензионным соглашением и принять его.

   

8. Нажать Установить.

   

Когда установка завершится, на рабочем столе появится ярлык программы Полигон (только для ПК с ОС Astra Linux). Инсталлятор предложит открыть краткое описание демонстрационного проекта.

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

Полигон рекомендуется запускать через ярлык на рабочем столе или из папки Polygon2 (для ОС Windows исполняемый файл polygon2.exe, для ОС Linux –startPolygon2.sh).

При первом запуске среды откроется демонстрационный проект mnu_demo.pl2. Краткое описание демонстрационного проекта приведено в документе Описание.pdf в папке Polygon2.

Если необходимо, демонстрационный проект можно запустить на виртуальном контроллере через Панель отладки.

Для этого следует:

1. Добавить Панель отладки через меню Окна/Панели инструментов/Панель отладки.

2. Нажать на Панели отладки кнопку Запустить на виртуальном контроллере.

3. В отдельном окне запустится приложение виртуального контроллера.

4. Среда попросит ввести пароль для через отладчик среды. Пароль демонстрационного проекта – 123.

5. Среда подключится отладчиком среды к запущенному контроллеру.

   

ПЛК ОВЕН, которые работают с исполнительной средой Полигон, представлены в таблице ниже.

Примечание

* Версия лицензии runtime. Описание версий лицензий приведено в разделе.

Описание лицензионных пакетов

Описание лицензионных пакетов

Тип лицензии	Назначение	Состав библиотек*
BASE	Базовая лицензия	paCore paOwenIO paOpcUA paControls paModbus profiLogger profiLoggerLight
BASE104	Лицензия с поддержкой протоколов МЭК 60870-5-101 и МЭК 60870-5-104	Библиотеки базовой лицензии + paIEC104
BASE850	Лицензия с поддержкой протокола МЭК 61850	Библиотеки базовой лицензии + paIEC850
BASE-R	Лицензия с поддержкой программного резервирования ПЛК	Библиотеки базовой лицензии + paSync
BASE104-R	Лицензия с поддержкой протоколов МЭК 60870-5-101 и МЭК 60870-5-104 и программного резервирования ПЛК	Библиотеки базовой лицензии + paIEC104, paSync
BASE850-R	Лицензия с поддержкой протокола МЭК 61850 и программного резервирования ПЛК	Библиотеки базовой лицензии + paIEC850, paSync

Примечание

Описание библиотек приведено в разделе

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

Внимание

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

Опции лицензионных пакетов

При необходимости можно приобрести опции для работы с блоками библиотек paSync, paIEC104, paIEC850 отдельно:

Опции лицензий runtime

Опция	Описание	Состав доступных библиотек*
REDU	Опция поддержки программного резервирования ПЛК	paSync
IEC104	Опция поддержки протоколов МЭК 60870-5-101 и МЭК 60870-5-104	paIEC104
IEC850	Опция поддержки протокола МЭК 61850	paIEC850

Примечание

* Описание библиотек приведено в разделах и.

Загрузка файлов лицензии в контроллер описана в разделах,  , и.

Загрузка файлов лицензий в ПЛК в среде Полигон

Пакет лицензий можно загрузить из среды Полигон.

Для этого следует настроить свойства модуля для подключения к контроллеру. Подключаться к контроллеру можно через USB Device (IP адрес ПЛК при подключении через USB Device – 172.16.0.1) или через Ethernet.

Подробно подключение к контроллеру описано в разделе.

Для загрузки лицензий следует:

1. Нажать правой кнопкой мыши (ПКМ) на модуль и выбрать команду Записать лицензии.

   

2. В появившемся окне ввести серийный номер контроллера. Серийный номер выгравирован на корпусе прибора и приведен в паспорте на прибор (входит в комплект поставки прибора).

   

3. Нажать ОК. Начнется процесс скачивания лицензий с сервера pa.ru и загрузка их в контроллер. После окончания загрузки лицензий появится окно:

   

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

Если данное свойство прописано в модуле, то среда при записи лицензий не будет требовать ввести серийный номер контроллера.

Свойство Серийный номер также добавляется средой автоматически при вводе номера в окне Введите серийный номер при вызове команды Записать лицензии.

Внимание

Для загрузки лицензий в контроллер через среду Полигон требуется доступ к сети Интернет.

Загрузка файлов лицензии через утилиту WinSCP (для ОС Windows) описана в разделе. Загрузка файлов лицензии через консоль Linux описана в разделе.

Внимание

После загрузки дополнительных файлов лицензий для обновления списка доступных библиотек на странице web-конфигуратора Состояние/Обзор следует загрузить в контроллер проект с блоком OwenHWInfo из библиотеки paOwenIO.

Загрузка файлов лицензий в ПЛК через WinSCP

При отсутствии возможности подключения к серверу pa.ru пакет лицензий можно загрузить через утилиту WinSCP (или через любой менеджер файлов). Утилиту можно загрузить бесплатно на сайте https://winscp.net/eng/download.php

Подключаться к контроллеру можно как через USB Device (IP адрес ПЛК при подключении через USB Device – 172.16.0.1), так и через Ethernet.

После запуска утилиты следует настроить соединение по протоколу SFTP, указав IP-адрес контроллера, имя пользователя – root и пароль (по умолчанию – owen, можно изменить в web-конфигураторе). Чтобы подключиться к контроллеру, следует нажать Войти.

Файлы лицензии необходимо загрузить в рабочую директорию контроллера /home/root.

Внимание

После загрузки дополнительных файлов лицензий нужно обновить список доступных библиотек на странице web-конфигуратора Состояние/Обзор. Для этого следует загрузить в контроллер проект с блоком OwenHWInfo из библиотеки paOwenIO.

Загрузка файлов лицензий в ПЛК через терминал Linux

Если нет возможности подключиться к серверу pa.ru, то пакет лицензий можно загрузить через терминал Linux по протоколу SSH с помощью команды scp.

Подключаться к контроллеру можно как через USB Device (IP адрес ПЛК при подключении через USB Device – 172.16.0.1), так и через Ethernet.

Синтаксис команды scp:

$ scp опции пользователь1@хост1:файл пользователь2@хост2:файл

Пример

Команда для загрузки файла лицензии paSync при подключении ПЛК через USB Device:

$ scp /home/user/Documents/paSync root@172.16.0.1:/home/root

Для подключения к SSH-серверу контроллера необходимо указать пароль (по умолчанию – owen, можно изменить в web-конфигураторе).

Для проверки файлов лицензии можно подключиться к SSH-серверу контроллера и ввести команду ls.

Внимание

После загрузки дополнительных файлов лицензий нужно обновить список доступных библиотек на странице web-конфигуратора Состояние/Обзор. Для этого следует загрузить в контроллер проект с блоком OwenHWInfo из библиотеки paOwenIO.

Стандартные библиотеки

Установка библиотек

Примечание

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

При установке среды загружаются библиотеки базовой лицензии, при необходимости дополнительные библиотеки можно загрузить на странице среды Полигон или в web-конфигураторе контроллера во вкладке ПЛК/Загрузки.

Внимание

Путь к файлам библиотек не должен содержать кириллицу и пробелы.

Для добавления библиотеки в проект следует:

1. Перейти в меню Окна/Проекты. В появившемся окне отобразится текущий проект и добавленные библиотеки.

   

   Внимание

   Чтобы устанавливать обновления для среды и библиотек, необходимо иметь доступ к сети Интернет.

2. Нажать кнопку Открыть и перейти в папку с файлами библиотеки, которую необходимо добавить. Затем в выпадающем списке выбрать тип файла Библиотека Полигон 2 (*.ll2).

   

3. В окне появится файл библиотеки с расширением .ll2. Следует выбрать его и нажать Открыть.

   

Если необходимо, можно сразу открыть библиотеку в отдельном окне типа Дерево с помощью всплывающего окна.

Добавленная библиотека отобразится в окне Проекты.

В системном окне Окна/О программе отображаются установленные версии среды Полигон и библиотек.

Во вкладке Обновления есть возможность проверить и скачать обновления.

Также при запуске среды, если на сервере есть обновления для Полигон или библиотек, будет выведено сообщение об этом.

Внимание

Чтобы устанавливать обновления для среды и библиотек, необходимо иметь доступ к сети Интернет.

Для установки последних версий среды и библиотек следует:

1. Убедиться, что соединение с сервером pa.ru установлено, нажав кнопку Подключить.

   Примечание

2. Нажать на кнопку Проверить. В окне появятся версии среды и библиотек, доступные для установки.

3. Кнопками снизу выбрать распаковщик unzip или 7zip и нажать Сохранить.

4. Нажать Установить.

Для установки обновлений среда будет перезапущена. Появится окно предупреждения о закрытии программы.

После завершения установки среда снова откроется. В окне О программе отобразятся последние установленные версии среды и библиотек.

Внимание

Если установка обновлений версий среды и библиотек не произошла, следует прописать полный путь к файлу распаковщика в окне Команда для распаковки (например, "C:\Program Files (x86)\7-Zip\7z.exe").

Примечание

При возникновении других проблем с установкой обновлений среды и библиотек следует обратиться на почту технической поддержки support@owen.ru

Текущую версию запущенного проекта можно посмотреть во всплывающем тултипе при наведении мышью на модуль.

Также текущую версию запущенного проекта можно посмотреть в web-конфигураторе контроллера в разделе ПЛК/Информация.

Внимание

Для того, чтобы в web-конфигураторе контроллера (раздел ПЛК/Информация) обновлялась информация о запущенном проекте, следует добавить в проект блок OwenHWInfo из библиотеки paOwenIO.

В файле versions.txt в папке, куда транслируется проект, можно получить информацию о версии проекта и используемых в нем библиотек.

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

Для просмотра данных по версиям библиотек, используемых в проекте, нужно нажать ПКМ на запущенный модуль в дереве и выбрать в открывшемся меню Показать все. Откроется окно трансляции (системное окно Прогресс).

Если во время работы в среде Полигон или при трансляции проекта появляется ошибка, то программа выведет предупреждающее сообщение и предложит отправить сообщение об ошибке.

При выборе Отправить лог ошибки и сам проект будут подготовлены в выбранной папке на диске для отправки разработчикам. Данные файлы следует направить на почту support@owen.ru в виде архива с подробным описанием проблемы.

При выборе Отмена окно будет закрыто. Информацию по ошибкам можно самостоятельно посмотреть в окне Прогресс. Ошибки в тексте выделены красным шрифтом.

Перемещение по ошибкам можно осуществлять с помощью кнопок Вверх и Вниз.

Однопользовательский проект в среде Полигон представляет собой файл с расширением .pl2. В нем хранится все содержимое проекта за исключением дополнительных файлов, которые могут использоваться, например, при создании пользовательского составного блока на C++. Файлы проектов можно копировать и таким образом передавать другим разработчикам. Каждый проект рекомендуется размещать в отдельной папке, поскольку внутри нее среда разработки создает временные файлы при трансляции и копии проекта (бэкапы).

При редактировании проекта все изменения происходят только в кратковременной памяти. Для записи изменений в файл нужно использовать команду Сохранить  в панели инструментов или комбинацию клавиш Ctrl + s. Последние 10 действий можно отменить командой Отменить  или комбинацией клавиш Ctrl + z независимо от того, был ли сохранен проект на диск или нет.

Автоматическое сохранение проекта по умолчанию производится каждые 5 минут. Период сохранения проекта можно изменить в меню Экран/Настройки (при установке 0 автосохранения производиться не будут). При каждом сохранении на диск создается копия проекта (бэкап) с таким же именем плюс суффикс с датой и временем сохранения.

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

Проект в среде разработки Полигон имеет иерархическую структуру, которую можно увидеть в представлении Дерево. Узлы дерева могут быть разных типов. Основной узел с точки зрения создания программы для контроллера – Модуль.

В свойствах модуля задаются параметры подключения к контроллеру. Внутри модуля располагаются графическая структура алгоритмов и настройки для контроллера, из модуля транслируется исполняемый файл.

Проект может содержать несколько модулей.

Внутренняя структура модуля жестко определена: Модуль > Место работы > Программа > Страница > Функциональный блок.

Место работы задает способ выполнения находящихся в нем программ, т.е. поток, в котором программы будут выполняться.

ПО контроллера формируется таким образом, что каждый функциональный блок можно выполнять в одном из четырех потоков:

• место работы Таймер (таймерное прерывание);

• место работы Ввод-вывод (таймерное прерывание);

• место работы Фон (фоновый поток);

• место работы Поток (фоновый поток).

Часть алгоритма, помещенная в таймерном прерывании, всегда выполняется в режиме реального времени с заданной периодичностью (периодичность задается свойством места работы Таймерный промежуток) – это поток с самым высоким приоритетом.

Необходимо соизмерять размер программ (количество функциональных блоков), находящихся в таймере, со временем таймерного цикла. При недостаточном интервале таймерного цикла может появиться ошибка времени исполнения – Time Out. Данная ошибка повлечет за собой остановку программы (отслеживать реальное время выполнения можно с помощью функционального блока SysInfo).

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

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

Примечание

По умолчанию в проекте добавлено два места работы: Таймер и Фон. О создании дополнительных потоков см. раздел.

Программа – это относительно независимая алгоритмическая задача или группа однотипных задач.

Ради простоты дальнейшей поддержки проекта следует избегать двух крайностей: малого числа слишком длинных программ (т.е. с большим числом страниц) и слишком большого числа коротких программ.

Имя программы должно состоять только из символов латинского алфавита и нижнего подчеркивания «_», поскольку это имя при трансляции определяет имя файла исходных текстов и объектного файла. Важно давать программам осмысленные имена, чтобы впоследствии было проще понять их назначение. Желательно всегда присваивать разные порядковые номера выполнения программам одного потока.

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

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

Программа, получаемая после трансляции, имеет двухпоточную структуру и сторожевой таймер.

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

Порядок выполнения алгоритма внутри потока определяется следующим образом:

1. Порядок выполнения программы (свойство Номер);

2. Номер страницы (свойство Номер);

3. Порядок выполнения блока на странице (свойство Порядок).

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

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

Для удобства представления Программа делится на Страницы.

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

Страницы можно копировать, переносить в другую программу и удалять (соответствующие команды выбираются в контекстном меню при перетаскивании страницы в дереве). При удалении страницы все блоки, находящиеся на ней, также удаляются.

В дереве проекта страница отображается со своим номером и названием, которое задается в свойстве Комментарии.

Графически страница выглядит как две области:

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

2. Поля – область, содержащая информацию о входах и выходах блоков, которые находятся на других страницах и связаны с входами и выходами блоков данной страницы.

Вход или выход на поле обозначается следующим образом:

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

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

Масштаб каждой открытой страницы можно менять при помощи колеса мыши при нажатом Ctrl. Масштаб открытых страниц меняется относительно общего масштаба всего приложения, который задается комбинациями Ctrl + и Ctrl -.

Для перемещения по странице можно использовать ползунки справа – перемещение вверх-вниз и снизу – влево-вправо. Также можно использовать колесо мыши – перемещение вверх-вниз и Shift + колесо мыши – перемещение влево-вправо.

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

Типы функциональных блоков описаны в библиотеках (файлы с расширением .ll2) и реализованы как классы C++. Информацию о работе блока можно получить из справки библиотеки, выделив блок и нажав F1.

Графическое отображение функционального блока на странице несет информацию об его свойствах и свойствах его входов и выходов.

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

Входы

Выходы

Выходы функционального блока могут быть двух типов:

1. Циклические – выходы, количество которых может изменяться. Выходы добавляются командой Создать в контекстном меню блока. Количество циклических выходов может зависеть от количества входов: при изменении количества входов меняется и количество выходов, и наоборот.

2. Нециклические – обычные выходы, количество которых нельзя изменить.

Связи

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

Подробно о создании составного блока см. в разделе.

В среде Полигон существует два вида окон – Окна представления и Системные окна.

Окна представления предназначены для редактирования и отладки проекта и их нельзя вынести поверх других окон в среде.

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

Окна представления

Типы окон представления

Тип окна представления	Пиктограмма	Функция
Дерево		Навигация по проектам и библиотекам
Страница		Отображение страницы с функциональными блоками
Составной блок		Отображение содержания составного блока
Функциональный блок		Графическое отображение функционального блока
Редактор		Отображение файлов-ссылок для редактирования
Таблица		Отображение информации о функциональных блоках и их входах/выходах в табличном виде
График		Отображение значений входов/выходов в виде графиков
Экран отладчика		Отображение значений входов/выходов в виде графических элементов

Новое окно представления можно добавить следующими способами:

1. Открыть меню Окна/Новое окно. Выбрать расположение нового окна относительно открытых окон – в окне Выберите место для нового окна отображается прямоугольниками серого цвета. Выбрать тип нового окна из списка.

   

   

   

2. Выбрать тип нового окна на панели Представления. Выбрать положение нового окна относительно открытых окон. Панель Представления добавляется через меню Окна/Панели инструментов/Представления.

   

Дерево

С помощью окна представления Дерево можно перемещаться по проектам и библиотекам. Переключение между проектами и библиотеками происходит в выпадающем списке в верхнем меню окна.

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

В окне Дерево можно редактировать проект – создавать, удалять, копировать части проекта и библиотек (см. раздел).

Страница

Окно представления Страница предназначено для отображения страницы с функциональными блоками.

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

В режиме отладки на странице отображаются онлайн значения входов/выходов.

Основные свойства страницы:

• Комментарии – название страницы в дереве;

• Номер – номер в дереве, данное свойство определяет порядок выполнения программы (поток данных);

• Размер листа – от А4 до А0 (по умолчанию установлен А4).

При нажатии Shift над страницей у курсора мыши появляется крест из линий.

Окно Составной блок

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

Входы и выходы внутренних блоков, которые входят в составной блок, отображаются на полях страницы. Внешние входы и выходы составного блока выделены желтым цветом. Подробно о создании составного блока см. в разделе

Функциональный блок

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

Подробнее о функциональном блоке см. в разделе.

Редактор

Для отображения и редактирования файлов-ссылок в проекте предназначено окно представления Редактор.

Окно Редактор открывается автоматически при двойном щелчке на файле в дереве проекта.

В окне Редактор пишется программный код при создании составного функционального блока. Подробнее о создании составного ФБ см. в разделе.

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

Таблица

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

Нажатием правой кнопки мыши по верхнему меню таблицы можно настроить отображение нужных столбцов. Также по каждому столбцу можно установить фильтр, нажав на стрелку вниз на интересующем столбце.

График

Окно представления График позволяет просматривать значения на входах и выходах функциональных блоков в графическом представлении во время отладки (подробнее см. в разделе).

Для того, чтобы вход или выход отображался на графике, следует перетащить его ЛКМ со страницы с зажатым Ctrl в верхнюю часть окна График. Модуль добавленного входа или выхода автоматически станет текущим для графика. Для текущего Модуля можно добавлять входы/выходы на график из дерева с помощью перетаскивания по одному.

Для того, чтобы на графике отображалась группа входов или выходов, следует добавить их в Раздел.

Для создания Раздела нужно нажать на модуль ПКМ и нажать Создать. В появившемся окне необходимо выбрать пункт раздел и ввести имя нового раздела. Входы и выходы проекта добавляются в Раздел путем перетаскивания из дерева или со страницы (с зажатым Ctrl). В выпадающем меню при перетаскивании входа или выхода в раздел следует выбрать Добавить.

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

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

Свойства для отображения в таблице графика

Свойство	Описание
Значение онлайн	Текущее значение входа/выхода
Маркер	Значение входа/выхода в момент, отмеченный маркером
График: минимум шкалы	Минимум индивидуальной шкалы входа/выхода
График: максимум шкалы	Максимум индивидуальной шкалы входа/выхода
Цвет	Цвет графика сигнала и его индивидуальной шкалы
Получено	Количество полученных значений
Ошибок	Количество ошибок
Зона нечувствительности	Если модуль разницы между значениями сигналов меньше данной величины, то будет считаться, что значение не изменилось
Период опроса (мс)	Количество миллисекунд между опросами
Размер очереди	Количество значений, которые могут быть накоплены перед отправкой (при недостаточном размере очереди можно наблюдать появление ошибок)

Свойства Получено и Ошибок отображают количество полученных значений данного сигнала и количество ошибок, которые сигнализируют о переполнении очереди.

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

Если нажать ПКМ на строке таблицы, соответствующей входу/выходу, то вызывается контекстное меню, которое позволяет:

• Скрыть или Показать вход или выход на графике;

• Скрыть ось или Показать ось для входа или выхода;

• Удалить вход или выход из таблицы.

Настройки графика

Свойство	Описание
Длительность данных (сек)	Количество данных, которое нужно хранить
Показывать (сек)	Количество данных, которое нужно показывать на окне
Период отправки шкалы	Частота отправки значений сигналов контроллером на график (отправка происходит не чаще этого времени)
Очищать данные	Удалять старые данные с графика при запуске
Общая ось (Y)	Используется для отображения данных на общей оси
Маркеры 1, 2	Вертикальные прямые, с помощью которых можно просмотреть значение на графике в нужный момент времени
Делать отсчеты	· в фоне – по окончании периода отсчета будет посылаться одно текущее значение с каждого входа/выхода, · в таймере – по окончании периода отсчета для каждого входа/выхода будут посылаться значения, накопленные с заданным таймерным промежутком, · произвольно – значения накапливаются с заданным периодом, Период и Размер очереди устанавливается справа. Эти значения применяются для всех входов/выходов, у которых не установлены свои значения.

Для просмотра текущих значений входов/выходов на графике следует нажать кнопку Запустить (запуск проекта на контроллере описан в разделе). Для остановки отрисовки графика следует нажать Остановить.

Примечание

Для корректной работы графика необходимо синхронизировать системное время контроллера с браузером через web-конфигуратор (Система/Время/Системное время – Синхронизировать с браузером).

График подключается к запущенному проекту как клиент по протоколу OPC UA. По умолчанию график оформляет подписку на данные проекта с дискретностью фонового цикла.

Для получения данных из таймера в проекте должен быть создан функциональный блок OpcUAServerTimer из библиотеки paOpcUA. Блок следует создать в Таймере для работы подписок с точностью таймерного цикла (период отображения данных задается свойством модуля Таймерный промежуток в мс).

Подробнее см. в документе Обмен с верхним уровнем. Библиотека paOpcUA.

Масштабировать график можно с помощью колеса мыши с зажатым Ctrl на области оси. При выделении ЛКМ области слева направо и сверху вниз график увеличивается.

Перемещаться по графику влево/вправо и вверх/вниз можно с помощью мыши с зажатой ЛКМ на соответствующей оси графика.

Нажав правой кнопкой мыши в окне тренда, можно сбросить масштаб, либо выбрать следующий, предыдущий или исходный масштаб.

Также можно выбрать режим Отображение на разных полотнах.

Нажатие правой кнопкой мыши по оси Х или У открывает их свойства. Также кнопки свойств осей можно отобразить, нажав на кнопку с ползунками в левой нижней части графика.

В свойствах оси Х можно выбрать тип тренда, временное ограничение буфера данных, параметры оси.

В свойствах оси Y можно выбрать границы отображаемого интервала данных.

С помощью кнопки Экспорт можно выгрузить график на диск в форматах .txt, .pdf или .png.

Внимание

Путь сохранения не должен содержать кириллицу и пробелы.

Экран отладчика

Окно представления Экран отладчика позволяет просматривать и изменять значения на входах и выходах функциональных блоков во время отладки (подробнее об отладке см. в разделе).

Экран отладчика соответствует определенному Разделу. Входы и выходы, которые нужно отобразить на экране, следует добавить в этот раздел.

Для создания Раздела нужно нажать на модуль ПКМ и нажать Создать. В появившемся окне необходимо выбрать пункт раздел и ввести имя нового раздела.

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

Для открытия экрана отладчика необходимо в окнах представления в верхнем меню выбрать Экран отладчика, сделать окно активным и дважды нажать на необходимый раздел в дереве, либо перетащить раздел на активную страницу.

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

Типы графических элементов

Свойство	Класс отображения	Описание
Кнопка импульсная	pushbutton	При нажатии, если на входе не 0, сначала посылает 0, затем 1, затем 0
Кнопка	togglebutton	При нажатии посылает 1, при отжатии – 0
Слайдер	slider	Отображает значения в диапазоне от минимума до максимума, для входа – позволяет редактировать значение
Шкала	dial	Аналогично слайдеру отображает значения в диапазоне от минимума до максимума, для входа - позволяет редактировать значение
Значение	value	Отображает значение целым или вещественным числом
Лампа	lamp	При нулевом или отрицательном значении светится красным цветом, при положительном – светится зеленым (цвета лампы можно поменять в окне свойств)

Один вход или выход в проекте может соответствовать только одному графическому элементу на экране.

При добавлении входа или выхода в раздел экрана ему по умолчанию присваивается класс отображения в соответствии с правилом:

• если это логический вход – кнопка, иначе – слайдер

• если это логический выход – лампа, иначе – значение.

Класс отображения можно поменять в окне свойств. Для этого следует:

1. Открыть свойства интересующего графического элемента.

2. Добавить свойство Экран: класс отображения из нижнего выпадающего списка.

3. Установить в свойстве нужное значение класса отображения.

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

Для удаления графического элемента нужно нажать на него ПКМ, открыть контекстное меню и выбрать команду Удалить. Эта команда также удаляет вход или выход из раздела, открытого в качестве экрана.

На экран отладчика также можно добавить элементы панели Редактирование: стрелку, фон, текст.

Масштабирование экрана отладчика выполняется с помощью колеса мыши с зажатым Ctrl.

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

Свойства графических элементов экрана отладчика

Свойство	Описание
Комментарии	Отображается в качестве комментария около входа/выхода, в дереве, над графическим элементом
Номер	Определяет порядок отображения в дереве, начиная с 0
Экран: класс отображения	Выбор типа графического элемента
Экран: разрешить изменения	Разрешает редактировать значение во время отладки для графических элементов значение, слайдер, шкала
Экран: x и Экран: y	Координаты элемента
Экран: min и Экран: max	Задают диапазон изменения (минимальное и максимальное значения) для графических элементов слайдер, шкала
Экран: шаг	Задает шаг шкалы для слайдера и шкалы
Экран: радиус скругления	Задает радиус скругления для лампы
Экран: цвет_1 и Экран: цвет_2	Задают цвет графического элемента лампа во «включенном» и «выключенном» состояниях
Экран: ширина элемента и Экран: высота элемента	Задают ширину и высоту графического элемента
Экран: отключить надписи	Убирает отображение свойства Комментарии над графическим элементом

Системные окна

Типы системных окон

Тип окна представления	Пиктограмма	Функция
Контроллер		Подключение к контроллеру и загрузка проекта
Прогресс		Отслеживание процессов исполнения
Проекты		Управление проектами и библиотеками
Настройки сборки		Пути к установленным сборкам
Поиск		Поиск по проекту
Справка или F1		Информация по среде разработки и добавленным библиотекам
О программе		Сведения о программе, библиотеках, загрузка обновлений
Печать		Печать страниц проекта

Системные окна добавляются из меню Окна или с помощью панели Окна, которую можно открыть из меню Окна/Панели инструментов/Окна.

Системные окна можно размещать на экране несколькими способами:

• как отдельные окна представления;

• выносить поверх открытых окон представления;

• в виде вкладок.

Контроллер

Инструменты для загрузки и запуска программ на контроллере находятся в окне Контроллер.

Подробно о способах загрузки проекта на контроллер см. в разделе.

Подключение к контроллеру для загрузки и запуска проекта осуществляется по протоколу SSH.

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

При успешном подключении к контроллеру в консольном окне будут отображаться результаты выполнения команд.

Кнопкой Загрузить выполняется загрузка проекта в контроллер.

Кнопками Запустить модуль и Остановить модуль выполняется, соответственно, запуск и останов работы загруженного приложения на контроллере.

Кнопкой Закрыть сессию выполняется отключение от ПЛК.

Прогресс

Для отслеживания процесса выполнения используется окно Прогресс.

При трансляции в окне Прогресс отображается ход выполнения, при наличии ошибок они указываются с описанием.

По итогу трансляции можно видеть результат – сообщение об успешности выполнения и время выполнения.

Подробно о трансляции проекта см. в разделе.

Проекты

Для добавления в среду ссылок на проекты и библиотеки используется окно Проекты.

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

В списке указывается путь до добавленных проекта и/или библиотеки на диске.

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

Через окно Проекты можно сохранить копию проекта под другим названием с помощью кнопки Сохранить как…, а также создать зашифрованную версию проекта (подробнее о защите проекта см. в разделе).

Настройки сборки

Для настроек сборок используется окно Настройки сборки.

В окне Настройки сборки указаны пути к установленным сборкам. Настройки сборки устанавливаются инсталлятором, пользователю остается убедиться в их наличии.

Поиск

Для поиска по проекту используется окно Поиск.

В окне Поиск выбирается проект и задаются критерии поиска. Для быстрого поиска можно добавлять условия.

Справка

Для получения информации по среде разработки или по работе и назначению входов/выходов функционального блока из библиотеки используется окно Справка (горячая клавиша F1).

В верхнем выпадающем списке окна Справка можно выбрать интересующий раздел справки – среду разработки или конкретную библиотеку.

В нижнем выпадающем списке можно выбрать отображение: содержание раздела, поиск по разделу или указатель на ключевые слова раздела.

Открыть справку на конкретный функциональный блок в проекте можно, выбрав его в дереве (в проекте или в библиотеке) или непосредственно на странице проекта и нажав F1. Еще можно выбрать Справка в выпадающем контекстном меню при нажатии ПКМ на блоке.

При создании составных функциональных блоков и/или пользовательских библиотек можно создавать для них справку. Подробнее см. в разделе.

О программе

Для получения сведений о программе, версиях библиотек и наличии обновлений предназначено системное окно О программе.

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

При нажатии кнопки Лицензионная информация открывается окно со сведениями о системных лицензиях, которые используются в среде разработки библиотек.

Во вкладке окна Обновления при нажатии Проверить проверяется наличие обновлений. Требуется подключение к серверу pa.ru.

После нажатия кнопки Установить программа установит найденные обновления и выполнит перезагрузку среды.

При установке флага Показывать тестовые версии в списке обновлений также будут доступны тестовые релизы среды и библиотек.

При установке флага Показывать старые версии будут показаны доступные для установки прошлые версии релизов среды и библиотек.

В нижней части окна выбирается распаковщик – unzip или 7zip.

Подробно обновление среды и/или библиотек описано в разделе.

В левом нижнем углу окна расположена кнопка Удалить бэкапы. В новом окне можно выбрать бэкапы (резервные копии проекта) для удаления. При превышении общего объема бэкапов в 500 Мб в окне выводится предупреждающее сообщение.

При запуске среды также выводится окно с предложением удалить бэкапы.

Печать

Для печати страниц проекта используется окно Печать.

В окне выбирается нужный проект.

При нажатии на кнопку Сведения добавляются данные для титульного листа и штампов.

В Настройках можно выбрать печати и вариант печати – на бумажном носителе или в файл.

При выборе печати в файл, результат сохраняется в рабочую папку проекта.

Окно Свойства элемента можно открыть, вызвав контекстное меню правой кнопкой мыши и выбрав Свойства. Или можно нажать соответствующую пиктограмму на панели Инструменты.

Окно свойств можно как разместить среди окон представления, так и вынести над ними.

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

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

Нажатием кнопки Сохранить новые свойства вступают в силу. Нажатием кнопки Отмена можно отменить последние действия – добавление, удаление или изменение свойства.

Для удаления свойства нужно нажать на него ПКМ и выбрать Удалить свойство.

Включенный флаг Привязать к родителю позволяет задать свойство текущего узла только внутри текущего родителя.

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

Этим способом можно добавить вход в несколько OPC UA-клиентов и в каждом задать свое свойство Зона нечувствительности.

В свойства можно добавить пользовательские свойства Пользовательское свойство 00,..., 20. Их использование полезно, например, в свойствах модуля для сохранения дополнительных IP адресов и обращения к ним по SQL-запросам.

Пример запроса пользовательского свойства Пользовательское свойство 00 (prop_0):

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

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

Новый проект можно создать двумя способами:

1. Выбрать пункт меню Проект/Создать.

   

2. Перейти в Окно/Проекты и нажать кнопку Создать.

   

   В открывшемся окне следует выбрать место для сохранения и ввести имя нового проекта. В имени можно использовать только латинские буквы, символ «_» и цифры. Каждый новый проект рекомендуется размещать в отдельной папке, поскольку внутри нее среда разработки создает временные файлы при трансляции и копии проекта (бэкапы).

   Внимание

   Путь к файлам проекта не должен содержать кириллицу и пробелы.

Далее следует выбрать шаблон создаваемого проекта – Пустой проект или Модуль с отладчиком для контроллера. Рекомендуется всегда создавать проект с отладчиком для контроллера, чтобы не настраивать его подключение вручную.

Внимание

Для создания модуля с отладчиком для контроллера обязательно наличие в среде ссылок на библиотеки paCore и paOpcUA. Подробнее о добавлении библиотек в среде см. в разделе.

Отладчик среды Полигон подключается к запущенному проекту как клиент OPC UA. При выборе шаблона модуля с отладчиком в новом проекте в месте работы Фон автоматически создается программа Debug, на странице которой добавлен блок OPC UA-сервера (OpcUAServer) из библиотеки paOpcUA. На входы блока ip – IP адрес и prt – локальный порт контроллера прописываются соответствующие свойства модуля в виде SQL-запросов.

Запрос IP адреса:

Запрос номера порта:

Подробнее об отладчике среды Полигон см. в разделе.

Реализация протокола OPC UA в среде Полигон подробнее описана в документе Обмен с верхним уровнем. Библиотека paOpcUA.

После выбора шаблона для модуля следует задать пароль для доступа отладчика к запущенному проекту. Если необходимо, пароль можно поменять в свойстве модуля Пароль admin. Изменение вступит в силу после трансляции проекта.

После задания пароля среда выведет сообщение об успешном создании проекта и предложит открыть его в окне представления типа Дерево.

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

Создать компоненты проекта внутри существующих можно в представлении Дерево. Структура компонентов проекта описана в разделе.

Таким образом, внутри проекта создаются Модули. Внутри Модуля –Места работы и Разделы. Внутри Мест работы создаются Программы и т. д.

Для создания нового компонента в проекте следует:

1. Нажать ПКМ на модуле, месте работы (таймере или фоне), программе и т. д.

2. В контекстном меню выбрать команду Создать.

3. Выбрать тип нового компонента и, если необходимо, ввести имя, номер, количество.

   

   

   

Создание таймерного потока Ввод-вывод

По умолчанию в проекте добавлено два места работы – Таймер и Фон. Если необходимо, в проект можно добавить второй таймерный поток – Ввод-вывод.

Ввод-вывод – таймерный поток, полностью аналогичный месту работы Таймер, но с более высоким приоритетом выполнения.

Внимание

Таймерный поток Ввод-вывод прерывает поток Таймер на время своего выполнения, поэтому время выполнения Таймера увеличивается.

Для добавления места работы Ввод-вывод следует в контекстном меню модуля нажать Создать и выбрать ввод-вывод.

Основное свойство Таймера и Ввода-вывода – Таймерный промежуток – время, через которое повторно вызывается программа.

Необходимо соизмерять размер программ (количество функциональных блоков), которые находятся в месте работы ввод-вывод, со временем таймерного цикла. При недостаточном интервале таймерного цикла может возникнуть ошибка времени исполнения – Time Out. Данная ошибка повлечет за собой остановку программы (отслеживать реальное время выполнения можно с помощью функционального блока SysInfo).

Создание места работы Поток

По умолчанию в проекте добавлено два места работы – Таймер и Фон. В проект также можно добавить несколько мест работы, которые выполняются в фоновых потоках – Потоки.

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

Для добавления Потока следует в контекстном меню модуля нажать Создать и выбрать поток.

Свойства мест работы Фон и Поток:

• Приоритет фонового потока - число, задающее приоритет потока в системе. Чем выше это значение, тем более приоритетным является поток. Место работы приостанавливает выполнение менее приоритетных потоков, пока наиболее приоритетный поток не завершит свой цикл. Максимальное значение приоритета определяется операционной системой (например, для ОС Linux на ПЛК Овен –47). Актуальное значение максимально возможного приоритета можно посмотреть в отладчике на выходе блока ThreadMan из библиотеки paCore, раздел Системные;

• Периодичность работы фонового потока (мс) – время в мс, задающее периодичность выполнения программ потока (только для места работы Поток). Время выполнения потока не контролируется. Если поток не успевает получить управление в соответствии с заданной периодичностью, то выполнение программы не прерывается (в этом отличие от места работы Таймер и Входы). Если свойство не задано, то поток переходит к следующему циклу сразу после завершения предыдущего (после обязательного простоя);

• Привязка фонового потока к ядру – для многоядерных процессоров задает номер ядра (от 0), к которому системе следует привязать поток. Если свойство не задано, то ядро выбирается системой автоматически.

Функциональные блоки создаются внутри страниц. Для создания функционального блока есть несколько способов:

1. Открыть нужную страницу в активном окне, нажать ПКМ на свободном месте и выбрать Создать.

   

2. Нажать на пиктограмму Создать на панели Инструменты открытой страницы.

   

3. Открыть контекстное меню страницы в представлении Дерево и нажать Создать.

После выбора команды Создать откроется окно создания функционального блока.

Вверху окна в поле Имя можно ввести имя нового функционального блока, которое будет отображаться сверху над блоком и в дереве проекта как комментарий. Если оставить данное поле пустым, то имя блока будет задано автоматически по шаблону b<индекс блока>.

В поле Количество можно указать необходимое количество блоков выбранного типа для создания. По умолчанию создается один блок выбранного типа.

Для создания блока следует:

1. В левом поле окна выбрать библиотеку, функциональный блок из которой планируется создать.

2. В поле посередине появится список разделов выбранной библиотеки, внутри разделов – списки функциональных блоков. Следует выбрать нужный блок.

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

4. После выделения нужного блока нажать ОК – новый блок появится на странице.

В поле снизу списка функциональных блоков можно ввести имя нужного функционального блока для поиска по разделам библиотеки.

Также можно создать ФБ на странице путем перетаскивания его из дерева библиотеки. Для этого следует:

1. Открыть в представлении Дерево нужную библиотеку.

2. Выбрать функциональный блок.

3. Перетащить блок на открытую страницу.

4. При отпускании мыши появится контекстное меню, в котором следует выбрать Создать.

Некоторые ФБ можно разместить только в таймерном потоке или в фоне (определяется свойством Может работать только в…), при попытке разместить такой блок не в указанном месте работы появится окно соответствующей ошибки.

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

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

Для удаления лишних входов/выходов можно выделить их с зажатым Shift и выполнить: ПКМ – Удалить.

Около входов/выходов ФБ можно оставлять комментарии. Добавить комментарий входу/выходу можно двумя способами:

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

   

   

2. Дважды нажать ЛКМ около интересующего входа/выхода – появится строка ввода комментария, следует ввести комментарий, он отобразится зеленым цветом.

   

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

Чтобы провести связь между блоками, которые находятся на разных страницах, необходимо открыть эти страницы в рабочих окнах и провести связь, как указано выше. На каждой странице появятся связи, уходящие в соседнее поле. На полях страницы будет указан адрес, куда идет связь.

При создании связи учитываются типы данных входа и выхода. Если типы оказываются несовместимы, выдается сообщение об ошибке и связь не проводится. Нельзя создать связь с Константным входом.

Цвет связей отображает тип данных входа:

• черный – булевое;

• красный – целое;

• синий – вещественное;

• серый – строковое.

Для удаления связи нужно выделить правой кнопкой мыши вход, куда приходит связь. Откроется меню, в котором нужно выбрать Удалить связь.

Связь можно переносить с одного входа на другой. Для этого нужно «схватить» связь на входе и, не отпуская, перенести ее на новый вход.

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

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

Из «дерева в дерево» также можно провести связь: захватить нужный вход/выход, перетащить его на выход/вход, к которому необходимо провести связь – выбрать в меню Провести связь.

Примечание

При проведении связей следует помнить: если провести связь от выхода к входу – комментарий выхода дублируется на вход. Если проводить связь от входа к выходу – комментарий не дублируется. Подробно о комментариях см. в разделе.

Для установления скрытой связи можно использовать Глобальные константы. Для выхода, с которого будет идти связь, нужно добавить свойства Полный алиас и Глобальная константа.

На входе, на который должна идти связь, следует щелкнуть ПКМ и выбрать Задать константу. В открывшемся списке выбрать нужную константу и нажать Установить.

Вид связи можно менять с помощью контекстного меню, которое вызывается щелчком ПКМ на связи. При установке Ручное на связи появляются точки, потянув за которые, можно придать связи любой вид. При установке Авто связь приобретает автоматически определяемый вид.

При редактировании в проекте двух и более модулей можно проводить связи между ними.

Обмен данными при проведении связей между модулями обеспечивается по протоколу OPC UA.

Подробно реализация протокола OPC UA в среде Полигон описана в документе Обмен с верхним уровнем. Библиотека paOpcUA.

Для проведения связи между модулями необходимо открыть страницы модулей в рабочих окнах и провести связь.

В появившемся окне необходимо настроить связь между модулями. В одном из модулей выбирается блок OPC UA-сервера, во втором – блок OPC UA-клиента. После настройки связи необходимо нажать Провести связь между модулями.

В раздел Данные выбранного блока OPC UA-клиента добавится вход с прописанным свойством ID источника/приемника, равным индексу входа или выхода в модуле, который был выбран как OPC UA-сервер.

Для задания очередности выполнения блоков на странице следует нажать на свободном месте страницы ПКМ и выбрать Порядки.

В открывшемся окне можно выбрать следующие порядки:

• Одинаковый порядок;

• Порядок по возрастанию;

• Порядок по потоку данных.

При выборе пункта Одинаковый порядок всем блокам на странице будет присвоен порядок выполнения, указанный в поле справа.

При выборе пункта Порядок по возрастанию блокам будут присвоены порядки от 5, начиная с верхнего левого угла, кратно 5. Чем левее и выше находится блок, тем меньший порядок выполнения у него будет. Чем правее и ниже – тем больший порядок выполнения.

При выборе пункта По потоку данных очередность блоков будет определена их связями друг с другом на текущей странице – если с выхода блока идет связь на вход другого блока, то первый получит меньший порядок исполнения.

Для добавления комментариев и заметок на страницы проекта и экраны отладчика предусмотрены элементы стрелка, фон и текст. Добавить их на страницу можно с панели инструментов Редактирование.

Для добавления панели следует в меню Окнв/Панели инструментов поставить флаг Редактирование.

Вверху активной страницы появится панель, на которой можно выбрать элементы для редактирования: стрелка, фон, текст. В свойствах созданных элементов можно менять их координаты, задавать размеры и цвет.

В компонент проекта Раздел можно добавлять входы/выходы со страниц программ для отображения на экране отладчика, для вывода на график, для передачи сигналов OPC UA-клиенту и др.

Для добавления входа или выхода в раздел следует выделить нужный вход или выход и, зажав клавишу Ctrl и левую кнопку мыши, перетащить его на нужный раздел в дереве проекта и выбрать Добавить в контекстном меню.

Можно добавить сразу несколько входов/выходов одного блока в раздел. Для этого следует выделять их с зажатой клавишей Shift.

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

При двойном щелчке ЛКМ по строке списка откроется расположение входа или выхода в дереве.

Для навигации по проекту можно воспользоваться панелью Навигация, которая добавляется установкой флага Навигация в меню Окна/Панели инструментов.

Подробно панели инструментов окон представления описаны в разделе.

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

С помощью кнопок Назад и Вперед можно перемещаться между ранее открытыми страницами. Кнопки Предыдущая страница и Следующая страница производят переключение в той последовательности, как страницы расположены в проекте (сверху-вниз).

Еще можно перемещаться по полям страниц – если щелкнуть ЛКМ на адрес связи, то в активное окно отобразится соответствующая страница.

Для того, чтобы открыть нужную страницу в активном окне, нужно либо два раза нажать ЛКМ на страницу в дереве, либо перетащить страницу из дерева в это окно и нажать Показать.

Для копирования части проекта следует выделить нужную часть при помощи мыши (для выделения нескольких частей – зажав Shift) и нажать Копировать на панели инструментов. Также можно воспользоваться комбинацией Ctrl + c.

Далее перейти в нужное место проекта и нажать на панели инструментов Вставить. Также выполнить вставку можно через контекстное меню, которое открывается при нажатии ПКМ на компоненте дерева, или сочетанием клавиш Ctrl + v.

Расположение компонентов и связи, которые были внутри вставляемой части, сохранятся.

Также копировать части проекта можно перетаскиванием. Для этого нужно «схватить» мышью требуемую часть проекта и перетащить в новое место. В открывшемся меню выбрать команду Копировать (если выбрать Перенести, то часть проекта удалится из начального места).

Копировать компоненты возможно не только внутри одного проекта, но и в разных.

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

1. Имя вида b<индекс блока> присваивается при создании блоков, для которых не задано пользовательское имя. При копировании в имени нового блока отобразится его индекс.

   

2. Кастомные имена могут быть заданы пользователем или сформированы при генерации блоков из MS Excel. Переименование таких блоков зависит от наличия порядкового номера в имени.

Если имя без цифр в конце, то добавится суффикс «_» и номер вида 01 (дополнение до двух цифр).

Если в имени есть номер в конце, то при копировании блока номер меняется, определяя формат по количеству «лишних» нулей в начале числа. Для генерации порядкового номера производится поиск всех нумерованных имен, которые начинаются так же, как исходное, и добавляется номер на 1 больше максимального из них. Если при копировании необходимо сохранять номер в имени, то рекомендуется обеспечить окончание имени нечисловым символом, например, знаком «_».

Автоматическое изменение имен блоков при копировании можно отключить в окне Настройки приложения во вкладке Копирование.

Для переноса блоков, страниц или программ нужно «схватить» их мышью и перетащить в требуемое место. При отпускании выбрать Перенести.

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

Перенос компонентов возможен только в рамках одного проекта. Для переноса блоков, страниц и программ из одного проекта в другой можно использовать команды Копировать и Удалить.

Свойства модуля, используемые при трансляции

Проект в ПЛК210 загружается через протокол SSH.

Недостающие в окне свойства можно добавить из выпадающего списка снизу. Работа с окном Свойства подробно описана в разделе.

При трансляции проекта под ПЛК210 файлы трансляции записываются в папку build_имя модуля_LinuxOwen3. Исполняемый файл программы для контроллера – имя модуля.o.

Для трансляции, загрузки и запуска проекта на контроллере в среде Полигон предназначена Панель отладки. Панель отладки добавляется через меню Окна/Панели инструментов – Панель отладки.

Элементы панели отладки

Элемент	Пиктограмма	Функция
Модуль		Выбор модуля для запуска
Индикатор статуса		Отображает статус запущенного проекта
Перезапустить во временной сессии		Трансляция модуля, загрузка исполняемого файла на контроллер и запуск на «переднем плане» Внимание При закрытии среды разработки выполнение программы на контроллере будет остановлено
Перезапустить для постоянной работы		Трансляция модуля, загрузка исполняемого файла на контроллер и запуск со свойством Автозапуск Внимание Для запуска программы со свойством Автозапуск контроллер будет перезагружен
Запустить на виртуальном контроллере		Трансляция модуля и запуск локально на ПК. Отладчик подключается к запущенному модулю, независимо от того, какие выбраны IP адрес и OC для трансляции. Подробнее см. в разделе

Для запуска проекта на контроллере через панель отладки следует:

1. Задать свойства модуля в соответствии с таблицей.

2. В выпадающем списке на панели отладки выбрать Модуль (среди модулей проектов, открытых в данный момент в среде разработки).

3. Выполнить запуск модуля одним из способов:

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

     Внимание

     При запуске программы во временной сессии ее выполнение на контроллере будет прекращено при закрытии среды разработки.

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

     Внимание

     При загрузке нового проекта на контроллер перезапишется проект только с таким же названием. Ненужные файлы проектов можно удалить через web-конфигуратор контроллера (вкладка ПЛК/Приложение – Удаление…), через любой файловый менеджер или через консоль.

После запуска программы станет активной кнопка остановки программы.

Если на контроллере уже была запущена программа, то при попытке подключения к контроллеру появится предупреждающее окно с вопросом об ее остановке.

Информацию о запущенной программе на контроллере можно посмотреть в web-конфигураторе в разделе ПЛК/Информация.

Внимание

Для обновления информации в разделе ПЛК/Информация в запущенном проекте должен быть добавлен блок OwenHWInfo из библиотеки paOwenIO.

Инструменты для загрузки и запуска программы на контроллере через web-интерфейс конфигурации находятся во вкладке ПЛК/Приложение. Для запуска программы следует:

1. Задать свойства модуля в соответствии с таблицей и транслировать модуль – в папке build_имя модуля_LinuxOwen3 на диске появится исполняемый файл программы для контроллера – имя модуля.o.

2. Зайти в web-конфигуратор контроллера и перейти во вкладку ПЛК/Приложение.

3. Нажать Загрузка приложения… и выбрать файл имя модуля.o.

   Внимание

   При загрузке нового проекта на контроллер перезапишется проект только с таким же названием. Ненужные файлы проектов можно удалить через web-конфигуратор контроллера (вкладка ПЛК/Приложение – Удаление…), через любой файловый менеджер или через консоль.

4. Нажать кнопку Запуск… напротив имя модуля.o.

   Внимание

   Для автоматического запуска приложения при перезагрузке контроллера следует установить для него Автозапуск (кнопка Установить Автозапуск…). Для корректного останова приложения из web-конфигуратора следует снять для него Автозапуск.

   

После запуска программы станет активной кнопка остановки программы.

Внимание

Для корректной остановки программы через web-конфигуратор следует снять Автозапуск.

Информацию о запущенной программе на контроллере можно посмотреть в web-конфигураторе в разделе ПЛК/Информация.

Внимание

Для обновления информации в разделе ПЛК/Информация в запущенном проекте должен быть добавлен блок OwenHWInfo из библиотеки paOwenIO.

Для загрузки и запуска проекта на контроллере через системное окно Контроллер следует:

1. Задать свойства модуля в соответствии с таблицей и транслировать модуль.

2. Открыть окно Контроллер через меню Окна/Контроллер.

3. В выпадающем списке выбрать модуль, который будет загружен в контроллер.

4. Кнопкой Соединить выполнить подключение к контроллеру по SSH.

   

5. Кнопкой Загрузить выполнить загрузку проекта в контроллер.

   Внимание

   При загрузке нового проекта на контроллер перезапишется проект только с таким же названием. Ненужные файлы проектов можно удалить через web-конфигуратор контроллера (вкладка ПЛК/Приложение – Удаление…), через любой файловый менеджер или через консоль.

6. Кнопкой Запустить модуль выполнить запуск загруженного проекта.

7. Подключится к запущенному проекту отладчиком среды через панель Инструменты.

После запуска программы станет активной кнопка остановки программы – Остановить модуль.

Внимание

Через окно Контроллер проект запускается в foreground, поэтому при закрытии сессии проект на контроллере перестанет выполняться. Для старта проекта в background следует установить Автозапуск, повторно транслировать модуль, загрузить в ПЛК, выполнить перезагрузку ПЛК по питанию или команду reboot из терминала. Проект запустится автоматически после загрузки ПЛК. Аналогично можно запустить проект для постоянной работы через Панель отладки или web-конфигуратор ПЛК.

Информацию о запущенной программе на контроллере можно посмотреть в web-конфигураторе в разделе ПЛК/Информация.

Внимание

Для обновления информации в разделе ПЛК/Информация в запущенном проекте должен быть добавлен блок OwenHWInfo из библиотеки paOwenIO.

Запустить проект на виртуальном контроллере можно с помощью Панели отладки (см. раздел). Для этого следует:

1. Добавить панель отладки через меню Окна/Панели инструментов – Панель отладки.

2. В выпадающем списке на панели отладки выбрать Модуль (среди модулей проектов, открытых в данный момент в среде разработки).

3. Выполнить запуск модуля на виртуальном контроллере кнопкой Запустить на виртуальном контроллере – в новом окне запустится приложение виртуального контроллера, к нему подключится отладчик среды.

После запуска программы станет активной кнопка остановки программы.

Запустить виртуальный контроллер можно вручную. Для этого следует:

1. Установить свойства модуля в соответствии с таблицей:

   Свойства модуля, используемые при трансляции на ПК

   Свойство	Описание	Значение для ОС Windows		Значение для ОС Linux
   IP-адрес	Локальный IP-адрес	127.0.0.1
   Подключаться через	Протокол для подключения к контроллеру	Не используется		SSH
   ОС	Тип операционной системы для трансляции	Windows		Astra Linux SE1.7
   Тип процессорной платы	Тип процессорной платы	ПК
   Порт отладчика	Порт OPC UA-сервера для доступа отладчика Полигон	По умолчанию 4840		По умолчанию 4850
   Запускать с ключами	Используется для игнорирования блоков из библиотеки paOwenIO	-I

2. Недостающие свойства можно добавить из выпадающего списка добавления новых свойств внизу окна. Работа с окном Свойства подробно описана в разделе.

   

   

3. Транслировать модуль:

   • для ПК с ОС Windows – запустить исполняемый файл имя модуля.exe из папки build_имя модуля_WINmingw;

   • для ПК с ОС Linux – запустить исполняемый файл имя модуля.o из папки build_имя модуля_LinuxAstra17.

4. Подключиться к запущенному приложению отладчиком среды через панель Инструменты.

Внимание

Ограничение на работу виртуального контроллера составляет 1 час. Виртуальный контроллер работает неограниченное время, если у пользователя есть USB-ключ. По вопросу приобретения USB-ключа обращаться на почту polygon@pa.ru.

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

Текущие значения на входах блоков можно подменить. Для этого необходимо дважды нажать ЛКМ на текущем значении входа и задать новое значение. Подмененные значения отображаются красным цветом.

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

Подмена значения на входе игнорирует константы и связи.

При подмене значения на выходе возможны следующие варианты:

1. Подмена выключает блок. По умолчанию при двойном нажатии на текущем значении, срабатывает этот вариант.

2. Подмена не выключает блок, а подменяет значения на входах, с которыми связан данный выход.

   

Для подмены значения выхода без выключения блока следует:

1. Нажать на выходе ПКМ.

2. Выбрать Установить значение.

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

Для сброса значения нужно нажать на выходе ПКМ и выбрать Сбросить.

Во время отладки можно получить список всех подмененных значений командой Показать все, а также отменить все подмены командой Сбросить все. Эти команды появляются при щелчке правой кнопкой мыши в дереве проекта на узле модуля.

При нажатии Показать все отображается таблица подмененных значений, о работе с представлением Таблица подробнее см. в разделе.

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

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

Если текущим будет Раздел, то в таблицу автоматически добавятся входы/выходы из раздела. Если добавить новый вход или выход в таблицу, он автоматически добавится в Раздел.

Подробнее об элементах графика см. в разделе.

Для просмотра значений входов/выходов нужно загрузить исполняемый файл на контроллер и нажать кнопку Запустить. Для остановки – Остановить.

График подключается к OPC UA-серверу контроллера в качестве клиента (аналогично отладчику) с добавленными в него данными.

Примечание

Для корректной работы графика необходимо синхронизировать системное время контроллера с браузером через web-конфигуратор (Система/Время/Системное время – Синхронизировать с браузером).

В режиме отладки текущие значения можно просматривать и изменять на Экране отладчика.

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

• если это логический вход – кнопка, иначе – слайдер;

• если это логический выход – лампа, иначе – значение.

Класс отображения можно поменять в окне свойств.

Подробнее о работе с экраном отладчика и свойствах элементов см. в разделе.

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

В режиме отладки можно получить различную информацию о запущенной программе.

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

Информацию о запущенном приложении на контроллере также можно посмотреть в web-конфигураторе в разделе ПЛК/Информация.

Внимание

Для обновления информации в разделе ПЛК/Информация в запущенном проекте должен быть добавлен блок OwenHWInfo из библиотеки paOwenIO.

При нажатии правой кнопкой мышки на запущенном модуле в дереве и выборе в открывшемся меню Показать все в окне трансляции (системное окно Прогресс) можно увидеть данные по версиям библиотек.

Также при трансляции в папке build_имя модуля_ОС создается файл versions.txt, в котором показаны идентификатор проекта, название модуля, дата и время трансляции, версии библиотек.

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

Получить время выполнения мест работы в программе также можно с помощью ФБ SysInfo.

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

О защите пользовательского составного блока подробнее можно прочитать в разделе.

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

Внимание

Имя Группы типов должно содержать только латинские буквы, цифры и «_». Если оставить поле ввода имени пустым, то оно будет назначено автоматически по шаблону b<индекс>.

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

О создании пользовательской библиотеки подробнее можно прочитать в разделе.

Теперь в новой группе типов следует создать Тип. При создании типа указывается Имя типа – имя класса, который будет создан при трансляции.

Внимание

Имя типа должно быть уникально в проекте и может содержать только латинские буквы, цифры и «_». Если оставить поле ввода имени пустым, то оно будет назначено автоматически по шаблону b<индекс>.

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

Создание составного блока из функциональных блоков

В проекте можно создать составной функциональный блок с алгоритмом, составленным из функциональных блоков. Пример – блок, возвращающий значение линейной функции y = kx + b. Для создания составного блока следует:

1. Создать Тип.

2. Создать Страницу в Типе.

   

   

   На страницах Типа реализуется алгоритм блока.

   Страницы в Тип можно скопировать из проекта. Если необходимо, чтобы связи между блоками на разных страницах сохранились, копировать страницы следует вместе, выделив их в дереве с зажатым Shift.

3. Создать на новой странице блоки Mul и Add из библиотеки paCore и соединить их, как показано на рисунке ниже.

   

4. Назначить внутренние входы/выходы блоков как внешние входы/выходы составного блока.

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

   Примечание

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

   

   

5. Транслировать проект для проверки корректности созданного типа. После сообщения об успешной трансляции (Трансляция завершена) экземпляры нового типа можно создавать на страницах проекта.

Создать экземпляр составного блока в проекте можно двумя способами:

1. Перетащить блок из Дерева проекта или библиотеки на Страницу проекта и выбрать Создать в контекстном меню.

   

2. На пустом месте Страницы щелкнуть ПКМ – Создать и выбрать необходимый блок в разделе Библиотека проекта, нажать ОК.

   

На графическом отображении составных блоков на страницах проекта изображается знак #, что означает, что данный блок – составной.

В дереве проекта или библиотеки Тип, экземпляр которого был создан на странице проекта, подсветится желтым.

Создание составного блока на C++

В проекте можно создать составной функциональный блок с алгоритмом, написанным на C++. Пример – блок RS-триггера с приоритетом по сбросу. Для создания составного блока с алгоритмом на C++ следует:

1. Создать Тип.

2. Создать внешние входы/выходы типа через контекстное меню Типа командой Создать. В появившемся окне следует выбрать вход типа или выход типа и ввести Имя входа/выхода.

   Внимание

   Имя входа или выхода должно содержать только латинские буквы, цифры и «_». Если оставить поле ввода имени пустым, то оно будет назначено автоматически по шаблону b<индекс>.

   

   

   

3. Задать свойства добавленным входам/выходам.

   Свойства входов/выходов типа

   Свойство	Описание
   Имя	Отображается как имя входа/выхода блока
   Имя переменной	Переменная класса, соответствующая этому входу/выходу. Имя должно быть уникальным в пределах класса
   Номер	Определяет положение входа/выхода в дереве и в составном блоке
   Комментарии	Отображается у входа/выхода в дереве и у составного блока
   Индекс типа данных	Индекс типа данных входа/выхода из раздела Библиотеки/Типы данных
   Тип связей	Для входов определяет правила, по которым разрешается проводить связи на данный вход: 0 – можно провести связь или задать константу (переменная – указатель); 1 – связь проводить нельзя, вход константный (переменная – не указатель); 2 – нельзя задать константу, можно провести связь, но она не обязательна (при отсутствии связи на вход будет передан 0, переменная – указатель); 3 – нельзя задать константу, можно провести связь, и она обязательна (при отсутствии связи при трансляции будет выдана ошибка, переменная – указатель)
   Указатель	Для выходов: Установлен флаг – признак того, что переменная является указателем; Не установлен флаг – обычный выход Примечание По умолчанию добавляемые выходы не являются указателями, если необходимо соответствующее свойство можно добавить в разделе Свойства.

4. Для того, чтобы задать тип данных входа/выхода, следует:

   1. Найти нужный тип данных в разделе Библиотеки/Типы данных. В данном примере – тип данных b (bool).

   2. Открыть свойства b.

   3. Скопировать значение свойства Индекс.

   Примечание

   Свойство Индекс типов данных в разделе Библиотеки/Типы данных может различаться в разных проектах.

   

5. Подставить скопированное значение в свойство Индекс типа данных нужного входа или выхода.

   При правильной подстановке индекса типа данных в свойствах входа или выхода появится Имя типа, соответствующее указанному типу. Если в разделе Библиотеки/Типы данных нет подходящего типа данных, его можно скопировать из основной библиотеки.

6. Задать таким же способом Индекс типа данных для всех созданных входов/выходов типа.

7. Установить свойство входов Тип связей = 0.

   

   

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

   Для того, чтобы написать блок на C++, следует добавить в Тип текстовые файлы. Для создания алгоритмов на C++ используются следующие расширения файлов:

   • .work – вызывается из функции Work каждый цикл выполнения программы;

   • .init – вызывается из функции InitInp один раз при инициализации;

   • .hpp – включается внутрь описания класса, это могут быть объявления дополнительных переменных и функций;

   • .cpp – включается в .cpp-файл класса – реализация дополнительных функций, добавление библиотек.

   Для создания блока необходимо добавить как минимум один файл с расширением .work.

   Для реализации RS-триггера понадобится создать файлы с расширениями .work для написания логики работы триггера и .hpp для того, чтобы хранить значение выхода во внутренней памяти блока. Нужно добавить текстовый файл в Тип.

8. Выполнить команду Создать в контекстном меню типа.

9. Выбрать файл и задать ему имя и расширение.

   

   

   

   

   Для редактирования текстовых файлов в Полигон предназначено окно типа Редактор, которое открывается автоматически при двойном щелчке на текстовом файле в дереве проекта.

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

10. Прописать в файле logic_rs.work логику работы RS-триггера.

11. Нажать Сохранить.

    

12. В файле store.hpp объявить переменную для хранения значения триггера.

13. Нажать Сохранить.

    

14. Транслировать проект для проверки корректности созданного типа. После сообщения об успешной трансляции (Трансляция завершена) экземпляры нового типа можно создавать на страницах проекта.

Создать экземпляр составного блока в проекте можно двумя способами:

1. Перетащить блок из Дерева проекта или библиотеки на Страницу проекта и выбрать Создать в контекстном меню.

   

2. На пустом месте Страницы щелкнуть ПКМ – Создать и выбрать необходимый блок в разделе Библиотека проекта, нажать ОК.

   

   На графическом отображении составных блоков на страницах проекта изображается знак #, что означает, что данный блок – составной.

В дереве проекта или библиотеки Тип, экземпляр которого был создан на странице проекта, подсветится желтым.

Свойства типов составных блоков и их входов/выходов

Для удобства отображения в дереве проекта или библиотеки Типу можно задать свойство Имя – это имя, которое отображается в дереве проекта или библиотеки.

Еще одно полезное свойство Типа – Может работать только в…. Его можно добавить из нижнего выпадающего списка в окне Свойства. Данное свойство определяет, в каком Месте работы можно создать экземпляр блока данного типа. При попытке создать блок в другом Месте работы появится окно ошибки.

Основные свойства внешних входов/выходов составного блока:

• Имя – отображается как имя входа/выхода блока;

• Номер – определяет положение входа/выхода в дереве и в составном блоке;

• Комментарии – отображается у входа/выхода в дереве и у составного блока.

При изменении свойства Номер внешнего входа или выхода Типа появится сообщение Обновить блоки типа…– применить изменение ко всем экземплярам блока данного типа в проекте.

Если необходимо изменить свойства Имя и/или Комментарии внешних входов/выходов, то для применения изменений следует пересоздать блок на странице проекта.

Создание справки для составных блоков

Для составных блоков пользователь может добавлять собственное описание.

Для создания справки следует:

1. В контекстном меню Типа выбрать команду Описание.

   

2. В текущем окне отобразится окно Редактора. В папке проекта (если тип создан в проекте, иначе в папке библиотеки) автоматически создастся папка userHelp и в ней файл с расширением .html и именем типа.

3. Добавить в файл описание блока.

   

   В папке userHelp следует размещать все файлы, которые используются для создания описаний для Типов данной Группы типов.

4. Если необходимо добавить картинки в описание, следует подготовить изображения с расширением .png, имена которых начинаются с имени соответствующего файла справки, и поместить их в папку userHelp.

Например, для описания my_block2.html следует добавить файлы изображений с названиями my_block2_1.png, my_block2_2.png и т.д.

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

Пользователь может создать библиотеку самостоятельно.

Для каждой новой библиотеки рекомендуется заводить отдельную папку.

Внимание

Путь к файлам библиотек не должен содержать кириллицу и пробелы.

Для создания библиотеки следует:

1. Перейти в окно Проекты и нажать Создать.

   

2. В открывшемся окне перейти в папку, где будет создана библиотека, ввести имя новой библиотеки, в выпадающем списке выбрать тип Библиотека Полигон 2 (*.ll2) и нажать Создать.

   

3. Для работы с библиотекой следует открыть ее в представлении Дерево. Среда при создании библиотеки сразу предложит открыть ее в дереве – следует нажать Да.

   

4. Созданная библиотека отобразится в окне Проекты.

   

   Для создания блоков в библиотеки следует добавить в нее типы данных. По умолчанию раздел Типы данных в библиотеке пустой. Его следует скопировать из основной библиотеки paCore. Для добавления в библиотеку типов данных следует:

5. Открыть библиотеку paCore в соседнем окне типа Дерево.

   

6. Открыть раздел Типы данных в paCore, выделить первый тип данных раздела и с зажатым Shift выделить последний тип данных раздела.

7. С помощью команд Ctrl + c и Ctrl + v выполнить копирование типов данных в раздел Типы данных новой библиотеки.

   Теперь в библиотеке можно создавать пользовательские составные блоки, копируя индексы типов данных для входов и выходов из раздела Типы данных библиотеки.

   После создания необходимого числа блоков библиотеку следует транслировать:

8. В окне Экран/Настройки выбрать ОС для трансляции библиотек.

   Внимание

   Библиотеку следует транслировать для всех ОС, в которых ее планируется использовать.

   

9. Выполнить Транслировать все на панели Инструменты окна библиотеки.

10. В папке библиотеки создастся папка build и в ней папка с файлами трансляции для выбранной ОС:

    • Windows для Windows;

    • Astra Linux SE 1.7 для Astra Linux SE 1.7;

    • Linux Овен прошивка 3.х для ОС ПЛК210.

Теперь новую библиотеку можно использовать в проектах.

Создание справки для библиотек

Примечание

Возможность создания полноценной справки для библиотеки есть только при работе на ПК с ОС Windows. При работе на ПК с ОС Linux см. создание справки для отдельных блоков в разделе.

Чтобы создать справку для библиотеки, следует:

1. Скопировать папку help с шаблонами (из папки Polygon2) в папку библиотеки, для которой будет создаваться справка.

2. В папке help переименовать файлы в соответствии с именами библиотеки и функциональных блоков, например, my_lib и my_block:

   • paControls.qhp в my_lib.qhp – список индивидуальных описаний блоков в справке библиотеки;

   • paControls.qhcp в my_lib.qhcp – указания для генератора справки;

   • paControls.bat в my_lib.bat – исполняемый .bat-файл создания бинарных файлов библиотеки для Полигон;

   • mode.html в my_block.html – описание блока.

3. Отредактировать переименованные файлы. Рекомендуется пользоваться редактором Notepad++ для удобства.

4. Редактирование файла my_lib.qhp на примере части содержимого из paControls.qhp:

   • paControls заменить на имя библиотеки, например, my_lib;

   • Редактировать/удалить и создать нужное количество разделов. Например, Функциональные блоки вместо Регуляторы;

   • Редактировать описания блоков и ссылки на их файлы описания. Например, вместо Выдача данных с задержкой вставить Вычисление линейной функции k*x + b, вместо delayv.html вставить my_block.html;

   • В ключевых словах указать my_block вместо delayv, другие строки удалить.

   Примечание

   При редактировании следует сохранить строку, где в ключевом слове указано точное имя типа (в примере указаны my_block и C_ my_block). Это требуется для вызова справки на конкретный блок по клавише F1.

5. В результате должно получиться следующее содержание my_lib.qhp:

   

6. Редактирование файла my_lib.qhcp: заменить paControls на my_lib.

   

7. Редактирование файла my_lib.bat:

   • Заменить paControls на my_lib;

   • Убедиться, что указан правильный путь к qhelpgenerator.exe. Например, E:\Polygon2\qhelpgenerator.exe.

     

8. Редактирование файла my_lib.html:

   • В файле описывается работа блока с форматированием текста с помощью HTML-кода;

   • Можно задать используемые стили (шрифт, тип, размер) в контейнерах, в которых в дальнейшем заключается текст;

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

9. В папку images следует поместить картинки .png, .gif к описанию блока. Стандартно имена задаются именем блока и цифрой. В примере используется my_block.png.

10. Запустить файл my_block.bat. Будут созданы файлы .qch и .qhc.

11. В папке библиотеки будут созданы файлы справки: my_lib.qch и my_lib.qhc.

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

Пример получившейся справки приведен на рисунке ниже.

Внимание

Возможные ошибки при запуске .bat-файла:

• Указан неверный путь к файлу генератора – в файле .bat следует указать прямой путь к qhelpgenerator.exe или создать переменную среды %DirQtInstall%;

• Библиотека qminimal.dll неверной версии – следует обратиться к разработчику за верным файлом;

• Если название проекта в <namespace> задано кириллицей то поменять на латинские символы;

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

• Справка создалась, можно самостоятельно в дереве справки выбрать описание блока, но оно не вызывается на блоке командой F1 – в разделе ключевых слов файла .qhp не указано точное имя типа блока. Следует добавить эту строчку со ссылкой на описание блока.

Полигон поддерживает выгрузку и загрузку свойств компонентов проекта в виде таблицы MS Excel с помощью команд Экспорт/Импорт на панели Инструменты. Это может быть полезно для быстрого массового редактирования свойств функциональных блоков и их входов/выходов.

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

Сначала следует выделить экспортируемый компонент проекта, затем выбрать команду Экспорт на панели Инструменты в дереве проекта.

Также можно выбрать команду Экспорт в контекстном меню нужного компонента (нажать на компонент ПКМ).

Аналогично можно экспортировать и импортировать свойства функциональных блоков и входов/выходов на открытой странице. Для этого следует нажать кнопку Эскпорт на панели Инструменты.

После выполнения команды Экспорт откроется окно, в котором следует:

1. Установить в графе тип файла MS Excel (*.xlsx) – справа в окне отобразится предпросмотр таблицы свойств страницы, блоков и входов/выходов на этой странице.

2. Нажатием ПКМ на заголовке таблицы открыть контекстное меню, в котором следует установить флаги на необходимых для экспорта свойствах блоков и входов/выходов.

   

3. Ввести имя файла.

4. Выбрать его расположение на диске.

5. Нажать Сохранить.

Сохраненный файл следует открыть в программе MS Excel.

Примечание

При работе на ПК с ОС Linux для редактирования таблицы можно использовать редактор ONLYOFFICE.

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

Отредактированный файл следует сохранить на диске в формате MS Excel (*.xlsx).

Чтобы импортировать новые свойства, следует нажать кнопку Импорт на панели Инструменты и выбрать в открывшемся окне сохраненный файл.

Новые свойства применятся к странице, блокам и входам/выходам на этой странице.

Внимание

Место свойств в проекте определяется однозначно уникальными свойствами Индекс (index) входов/выходов, блоков и т.д., поэтому импорт можно произвести в любом месте проекта. Изменения применятся только к свойствам тех элементов, которые были экспортированы.

Полигон поддерживает генерацию программ из MS Excel с помощью команды Импорт.

Генерация из MS Excel в Полигон позволяет:

• Добавлять программы, составные блоки и блоки из библиотек;

• Изменять значения и свойства входов и выходов блоков;

• Устанавливать связи между входами и выходами блоков.

Примечание

При работе на ПК с ОС Linux для редактирования таблиц можно использовать редактор ONLYOFFICE.

Для генерации требуется .xlsx-файл определенного формата.

На модуле следует нажать Импорт, указать файл и в качестве типа файла выбрать Генерация из MS Excel (*.xlsx). Полигон проверяет начало названия листа и выполняет соответствующий алгоритм импорта.

Листы файла .xlsx:

• create – листы данного типа предназначены для добавления программ и блоков;

• io – предназначен для изменения значений, комментариев и прочих свойств входов и выходов;

• ii – предназначен для изменения значений на группах входов;

• links – предназначен для проведения связей.

Если при импорте будет обнаружена ошибка, то изменения не применяются и происходит откат версии до начала импорта. Генерация оперирует с именами блоков, поэтому они должны быть уникальны. Листы считываются слева направо, поэтому вначале необходимо разместить листы типа create. Процесс импорта сопровождается сообщениями в окне Прогресс и завершается выдачей информации о количестве добавляемых блоков, программ и т.п. Алгоритм импорта не выполняет удаление блоков, программ, свойств и связей.

В итоговом файле для импорта не должны содержаться формулы, все значения должны быть посчитаны.

Заголовок таблицы задается по определенным правилам. При несоответствии импорт прекратится с выдачей предупреждения на указанный лист.

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

Для программы: при наличии указанной программы в проекте (независимо от места работы) программа не добавляется. В противном случае проверяется наличие указанного места работы и добавляется программа.

Для блока: при наличии указанного количества блоков (независимо от типа блоков и программы) блоки не добавляются. В противном случае проверяется наличие указанной программы,и добавляются блоки, начиная с 0 номера. Если в программе присутствует часть блоков, новые блоки добавляются, начиная с последнего номера +1. Блоки вставляются друг за другом. Если у блока много входов/выходов, используется формат А3.

Заголовок таблицы io предопределен частично (первые три столбца), при несоответствии импорт прекратится с выдачей предупреждения на указанный лист.

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

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

Можно организовывать циклы и повторения в таком же формате, как и links.

В данном примере строка 204 приведет к тому, что у всех блоков prm4_00, prm4_01, … на всех выходах типа «o» выставятся одинаковые комментарии comment1 и алиас alias1.

Строки 206…214 будут использовать имя блока с предыдущей строки.

Заголовок таблицы ii предопределен частично (первые два столбца), при несоответствии импорт прекратится с выдачей предупреждения на указанный лист.

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

• bsup_00.adr1 = 150, bsup_00.ini1 = -25, bsup_00.min1 = -50, bsup_00.max1 = 50, bsup_00.typ1 = II;

• bsup_01.adr3 = 151, bsup_01.ini3 = -26, bsup_01.min3 = -51, bsup_01.max3 = 49, bsup_01.typ3 = AI.

Алгоритм работает не только на циклических входах, но нужно, чтобы <имя заголовка + номер входа> присутствовал у блока.

Если оставить ячейку пустой, соответствующее значение не будет изменено.

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

Заголовок таблицы links предопределен, при несоответствии импорт прекратится с выдачей предупреждения на указанный лист.

Для проведения простой единичной связи нужно указать блоки и входы/выходы.

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

Внимание

Обязательным условием использования циклических связей является непрерывность имен блоков. Например, если существуют bsup_00 и bsup_03, обязаны существовать bsup_01, bsup_02, иначе импорт завершится ошибкой. Также обязательна нумерация с 0, т.е. если имеется три блока bsup_01, bsup_02, bsup_03, к ним не сможет обратиться bsup_##.

Для задания циклических связей используются символы «#», «,», «[-]». Возможные типы циклов перечислены в таблице ниже.

Примеры задания циклических связей можно посмотреть в разделе Генерация из MS Excel в справке среды.

Многопользовательский проект может редактироваться несколькими разработчиками одновременно. В этом случае проект представляет собой базу данных PostgreSQL. Клиентом к серверной базе данных выступает среда разработки Полигон.

Для создания нового многопользовательского проекта в среде разработки следует:

1. Выполнить команду Создать в окне Проекты.

2. В списке типа проекта выбрать Полигон 2 многопользовательский (*.pg2).

   

3. Определить местоположение файла проекта на диске. Рекомендуется каждый проект размещать в отдельной папке.

   Внимание

   Полный путь к файлу проекта не должен содержать символов кириллицы и пробелов.

4. Задать имя проекта. Имя проекта также определяет имя базы данных на сервере PostgreSQL.

   Внимание

   Имя проекта должно содержать только символы латинского алфавита, цифры и «_», начинаться с буквы.

5. В открывшемся окне ввести IP-адрес или имя компьютера и порт, на котором работает сервер PostgreSQL.

   

6. Ввести имя пользователя и пароль.

   

Если база данных с таким именем уже существует, то будет установлено соединение, если нет, то будет предложено ее создать.

Файл проекта с расширением .pg2 можно скопировать к другим пользователям и открыть в среде разработки. Для этого следует:

1. Выполнить команду Открыть в меню Проекты.

2. В списке типа проекта выбрать Полигон2 многопользовательский (*.pg2).

3. Найти на диске файл типа .pg2 и нажать Открыть.

4. Ввести имя пользователя и пароль.

   

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

Рекомендуется организовать работу над проектом таким образом, чтобы пользователи редактировали разные Программы проекта. Для этого следует создать структуру проекта, состоящую из Мест работы и Программ, одним пользователем и затем привлечь к работе остальных.

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

Среда разработки не сохраняет изменения проекта на сервер автоматически, однако если несохраненные изменения есть, то каждые 5 минут выдается предложение сохранить проект. Время сохранения можно изменить/отключить в меню Экран/Настройки.

Кнопка Сохранить  в панели инструментов показывает, что есть необходимость сохранить изменения. Последние 60 действий можно отменить командой Отмена  или комбинацией клавиш Ctrl + z, пока проект не сохранен на сервер. Если очередь изменений переполнена, будет предложено ее очистить или не выполнять последнюю операцию. После сохранения отмена изменений невозможна, и они становятся видны остальным пользователям.

После каждого сохранения проекта на локальной машине также создается копия проекта в виде sql dump для того, чтобы иметь возможность при необходимости восстановить определенную версию проекта. Файл с копией имеет такое же имя, как основной проект, плюс суффикс, обозначающий версию проекта на момент создания (например, файл mnu_demo_27.pg2 содержит копию проекта mnu_demo версии 27). Для восстановления копии необходимо открыть соответствующий файл проекта в среде разработки, тогда проект будет развернут на сервер в новую базу данных (например, mnu_demo_27_pg2).

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

Массовые операции, такие как импорт, генерация из MS Excel и копирование больших частей проекта рекомендуется проводить в момент минимальной активности остальных пользователей.

Проект в среде разработки Полигон – это база данных Sqlite. Защитить проект можно с помощью создания зашифрованной версии. Для этого следует:

1. В системном окне Проекты выделить интересующий проект и нажать кнопку Сохранить как….

2. В появившемся окне выбрать расширение Полигон 2 с защитой(*.pp2).

3. Нажать Сохранить.

В окне Проекты отобразится защищенная копия проекта.

В среде можно установить пароль на составной блок для защиты его содержимого.

Для установки пароля следует:

1. Выбрать составной блок в дереве проекта.

2. Нажать ПКМ и выбрать в контекстном меню Установить пароль.

   Примечание

   Защита содержимого составного блока при помощи пароля эффективна только тогда, когда файл проекта хранится в защищенном формате.

   

3. Задать пароль в открывшемся окне – на иконке блока в дереве отобразится знак «замка».

   

Если на составном блоке установлен пароль, то у данного блока не удастся открыть его внутреннее содержание.

Для снятия пароля необходимо оставить пустым поле ввода.

Для ограничения возможности доступа к проекту в свойствах модуля следует задать свойство Пароль admin.

Чтобы изменение Пароль admin вступило в силу, следует перетранслировать проект.

Если установлен Пароль admin, то при первом запуске модуля будет выводиться окно с запросом пароля.

Окно с запросом пароля отладчика появляется только 1 раз. Если пароль введен неверно, то запуск отладчика будет выдавать ошибку, а окно ввода пароля уже не появится.

Чтобы ввести корректный пароль, следует щелкнуть по модулю в дереве ПКМ и выбрать команду Задать пароль, ввести пароль в появившемся окне.

Также в среде есть возможность установить пароли для пользователей user1…user7. Итого 8 прав доступа – 1 admin и 7 user. Их можно использовать для ограничения доступа к данным проекта клиентам по протоколу OPC UA. См. подробнее в документе Обмен с верхним уровнем. Библиотека paOpcUA.

Типы данных

Типы данных paCore

Обозначение в среде	Название типа	Описание	Размер в памяти	Диапазон значений	Аналоги названий
chr, i8	Байт	Целое значение со знаком. Signed 8-bit integer	1 байт	-128…127	sint, int8, TINYINT, INT1
uch, ui8, reg	Байт без знака	Целое значение без знака. Unsigned 8-bit integer	1 байт	0…255	Byte
int, i16	Целое	Целое значение со знаком. Signed 16-bit integer	2 байта	-32768…32767	INT, SMALLINT, INT2
uns, u16, rg2	Целое без знака	Целое значение без знака. Unsigned 16-bit integer	2 байта	0…65535	WORD
lng, i32, l32	Длинное целое	Целое значение со знаком. Signed 32-bit integer	4 байта	-2147483648…2147483647	DINT, INT4
ulg, u32, rg4, ul32	Длинное целое без знака	Целое значение без знака. Unsigned 32-bit integer	4 байта	0… 4294967295	UDINT
i64	Двойное длинное целое	Двойное целое значение со знаком. Signed 64-bit integer	8 байт	-9223372036854775808…9223372036854775807	-
u64	Двойное длинное целое без знака	Двойное целое значение без знака. Unsigned 64-bit integer	8 байт	0…18446744073709551615	-
flt	Вещественное	Вещественное значение со знаком. Данные в формате с плавающей запятой	4 байта	-3.4E+38… 1.18E-38 и 1.18E-38… 3.4E+38	Float, Real
double	Вещественное двойное	Вещественное значение со знаком. Данные в формате с плавающей запятой	8 байта	-1.7E+308… 1.18E-308 и 1.18E-308… 1.7E+308	Double
b, bool, boolean, bit	Логический	Принимает значение 0 или 1	1 бит	0,1	Bit
s40, s50, s100, str	Строковый	Cтроки символов	-*	-	String

Примечание

* Максимальный размер строки определяет количество резервируемой памяти, размер задан в квадратных скобках, тип str ограничений на размер не имеет.

Кроме представленных в таблице типов данных используются массивы и перечисления.

Массив – массив данных определенного типа:

• i32a - массив типа int32;

• fa - массив данных типа float.

Перечисление – список констант, определяемый конкретным входом. Для входа с типом Перечисление невозможно задать значение, отличное от заданных в выпадающем списке. Обозначение: enm.

Очередь битов – позволяет накапливать очередь битовых значений в таймерном потоке. Обозначение: qb. Подробнее в разделе.

Другие типы в разделе Типы данных, кроме вышеперечисленных, являются системными.

При проведении связей между входами и выходами блоков среда разработки автоматически проверяет соответствие типов данных.

Цвет связей отображает тип данных входа:

• черный – булевое;

• красный – целое;

• синий – вещественное;

• серый – строковое.

Преобразование типов также можно осуществить вручную, используя блоки раздела Преобразователи типов.

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

Если вход/выход блока имеет системный тип данных, то создать связь можно только с выходом/входом того же типа.

Преобразователи типов

Преобразование типов можно осуществить вручную, используя блоки Flt_Un, Flt_Ul, Uc_flt, Us_Flt и др. из раздела Преобразователи типов.

Блок преобразует значение одного типа данных в другой.

В большинстве случаев преобразование типов осуществляется на этапе трансляции, подходящий блок добавляется средой разработки автоматически.

Алгоритм:

out = in

Константы

Блоки Константа повторяют на выходе значение входа – Real, Integer, Reg2 и др. из раздела Преобразователи типов. Блок инициализируется константой на входе, не нулем.

Инициализация:

y = fi

Алгоритм:

y = fi

Терминальные блоки

Терминальные блоки повторяют на выходе значение входа – TransFlt, TransInt, TransBit и др. Данные блоки удобно использовать в качестве сбора входных и выходных параметров на одной странице программы. Блок инициализируется константой на входе, не нулем.

Назначение входов и выходов:

• l0, l1, …,ln – входные значения;

• o0, o1, …,on – выходные значения.

Инициализация:

oi = li, где I = 0…n

Алгоритм:

oi = li, где I = 0…n

Для передачи массивов используются терминальные блоки Transi32A, TransFA, TransStor и др. Блок повторяет на выходе массив соответствующего входа. Данные блоки удобно использовать в качестве сбора входных и выходных параметров на одной странице программы. Блок инициализируется массивом на входе, не нулем.

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

Назначение входов и выходов:

• in0, in1, …,inn – входные массивы;

• o0, o1, …,on – выходные массивы.

Инициализация:

oi = ini, где I = 0…n

Алгоритм:

oi = ini, где I = 0…n

Сложение (Add)

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

Назначение входов и выходов:

• f0, f1, …,fn – слагаемые;

• sum – сумма.

Инициализация:

sum = 0

Алгоритм:

sum = f0 + f1 + … + fn

Целочисленное сложение (Addl)

Функциональный блок Addl производит целочисленное сложение. Аргументы являются целыми числами. Если на вход подается связь с выхода другого типа, то при выполнении программы происходит преобразование типов. Раздел библиотеки: Арифметические. Выход инициализируется 0.

Назначение входов и выходов:

• in0, in1, …,inn – слагаемые;

• sum – сумма.

Инициализация:

sum = 0

Алгоритм:

sum = in0 + in1 + … + inn

Вычитание (Sub)

Функция Sub вычисляет разность двух аргументов. Аргументы являются вещественными числами. Раздел библиотеки: Арифметические. Выход инициализируется 0.

Назначение входов и выходов:

• f1 – уменьшаемое;

• f2 – вычитаемое;

• out – разность.

Инициализация:

out = 0

Алгоритм:

out = f1 - f2

Умножение (Mul)

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

Назначение входов и выходов:

• f0, f1, …,fn – множитель;

• out – произведение множителей.

Инициализация:

out = 0

Алгоритм:

out = f1 ∙ f2 ∙…∙ fn

Деление (Div)

Функция Div вычисляет частное своих аргументов. Если делитель равен нулю, то выставляется флаг ошибки, на выходе устанавливается 1. Аргументы являются вещественными числами. Раздел библиотеки: Арифметические. Выход инициализируется 1.

Назначение входов и выходов:

• f1 – делимое;

• f2 – делитель;

• out – частное от деления;

• zf – флаг ошибки.

Инициализация:

out = 1; zf = 0

Алгоритм:

Если f2 = 0 → zf = 1, out = 1, иначе out = f1/f2, zf = 0

Целочисленное деление (Divl)

Функция Divl производит целочисленное деление. Вычисляет неполное частное и остаток. Если делитель равен нулю, то выставляется флаг ошибки, на выходе остается прежнее значение. Аргументы являются целыми числами. Если на вход подается связь с выхода другого типа, то при выполнении программы происходит преобразование типов. Раздел библиотеки: Арифметические. Выход инициализируется 1.

Назначение входов и выходов:

• i1 – делимое;

• i2 – делитель;

• out – частное от деления;

• rem – остаток от деления;

• zf – флаг ошибки.

Инициализация:

out = 1; rem = 0; zf = 0

Алгоритм:

Если i2 = 0 → zf = 1, out = out_old, иначе out = i1/i2, rem = i1 - (out ∙ i2), zf = 0, где out_old – значение выхода в предыдущем цикле выполнения программы

Корень квадратный (Sqrt)