docs.kb-agava.ru - Вклад участника [ru]

Перечень изменений AgavaSCADA/AgavaPLC 1.6

2026-05-07T05:45:26Z

TaushkanovKV:

Основные изменения в сравнении с версией 1.2:

# Добавлена возможность создания программ на языке C++ в соответствии с подходом, описанным в стандарте МЭК 61131-3.
# Продолжение развития объектной модели и возможности разработки программ, начатых в версии <code>AS 1.5</code>. [[Объектная модель AgavaSCADA/AgavaPLC]].
# Добавлена поддержка локального и онлайн (удаленного) отладчика.
# Для редактирования текстов программ, функций и классов внедрен новый, удобный и функциональный текстовый редактор, подобный распространенному VSCode.
# Транспорты MQTT, SNMP, МЭК 60870-5-101, МЭК 60870-5-104 портированы на ПК с ОС Linux x64 и контроллеры АГАВА.
# Реализован новый архиватор в БД PostgreSQL.
# Добавлена поддержка ресурсов и библиотек ресурсов.
# Добавлена Web-визуализация. См. пример <code>Visualization/MultiImageLabel</code>.
# Разработан ряд примеров, демонстрирующих новые возможности: <code>AIParameter</code>, <code>PIDRegulator</code>, <code>Leds</code>, <code>Wdt</code>, <code>AgavaAnalogInput</code>, <code>WidgetAgavaInput</code>, <code>Pump</code>, <code>MultiImageLabel</code> и другие.
Также запланировано добавление новых возможностей:
# Поддержка языка ST МЭК 61131-3 (Structured text).
# Поддержка распределенных проектов.
# Поддержка сохранения в проекте информации о целевой системе.
# Конфигурирование целевых устройств из проекта.
# Создание расширений для среды разработки с помощью SDK.
Перевод разработанных ранее проектов на актуальную версию описан в документе [[Миграция проектов AgavaSCADA/AgavaPLC]].

== 1.6.34-r1005c4072459 от 2026-04-24 ==

=== Узлы ===
# Восстановлена работа узла <code>Транспорт OPC UA</code>. Восстановлена обработка операций после чтения и перед записью.
# Дополнена валидация узла <code>Тег OPC UA</code>. '''В связи с обширной переделкой транспорта и тега изменены настройки свойства <code>Тип значения</code>, для ранее созданных проектов требуется ревизия значений данного свойства тегов.'''
# Исправлены ошибки в работе узла <code>Сигнал комплексный</code>. Также реализована выдача сигнала обновления значения при изменении значений свойств во время исполнения.
# Исправлен запуск и валидация узла <code>Монитор событий комплексный</code>.
# Реализована работа архиваторов, графика исторического и отчетов со свойствами узлов. Теперь архивация значений свойств работает корректно.
# Доработана объектная модель: для класса <code>NodeProperty</code> добавлены перегрузки <code>SetValue(ResourceLink)</code> и <code>SetValue(Color)</code>.
# Доработаны архиваторы <code>PostgreSQL</code> и <code>SQLite</code> - отключена запись изменений свойств всех узлов коллекции (ошибочно введенная ранее функция).
# Доработан <code>Виджет "Условное изображение"</code> - исправлена работа свойства <code>Видимость</code>.
# Узел типа <code>Система сигнализации</code> внесен в объектную модель. Зарегистрирован метод <code>void SystemAlarming::AcknowledgeAll()</code>.
# Исправлены ошибки в методах <code>BasicNode::GetPath()</code>, <code>BasicNode::GetName()</code>, <code>BasicNode::SetName()</code>, <code>BasicNode::GetDescription()</code>, <code>BasicNode::SetDescription()</code>.
# Исправлена ошибка некорректной остановки <code>Modbus-TCP</code> и <code>Modbus-RTU</code> серверов.

=== Среда разработки ===

# Исправлена критическая ошибка, возникавшая при закрытии проекта.
# Исправлена ошибка копирования экземпляров классов.
# Исправлена ошибка, возникавшая при вставке узлов экземпляров из другого проекта.
# Устранена критическая ошибка в системе проверки прав, возникавшая при проверке проекта.
# Исправлена критическая ошибка создания узла типа <code>Логгер PostgreSQL</code>.
# При валидации проекта добавлены предупреждения о кириллических символах в именах узлов.
# Доработана компиляция проекта - изменено отображение замечаний об исключениях. Теперь исключение, возникающее при компиляции такого проекта, отображается как ошибка для большей заметности. Устранены неинформативные замечания этапа компиляции.

=== Примеры ===

# Добавлен пример <code>Visualization/DynamicWidgets</code>.
# Доработан пример <code>Visualization/WidgetAgavaInput</code> - добавлена демонстрация вызова метода виджета из кнопки на форме.
# Пример <code>Transports/ModbusMasterSlave</code> дополнен демонстрацией работы TCP Master/Slave.

=== Разное ===

# Доработан <code>ASLauncher</code> - доработана утилита конфигурирования - настройки сети и времени для ОС Windows.

== 1.6.33-rc335f5d9dacf от 2026-04-01 ==

=== Узлы ===
# Доработан выполнение алгоритмов C++:
#* Возвращён вызов виртуальных методов BasicSource.
#* Реализована защита от рекурсии в методах BasicSource.
# Доработан класс <code>SignalValue</code> - зарегистрированы конструкторы и методы работы с типами uint64, uint32.
# Доработан узел <code>Транспорт Modbus-TCP</code>:
#* Функция записи по умолчанию установлена на 0.
#* Отключена возможность множественных подключений к транспорту в режиме <code>Сервер</code>.
# Доработан узел <code>Транспорт Modbus-RTU</code> :
#* Функция записи по умолчанию установлена на 0.
#* Восстановлена работа в режиме <code>Сервер</code>.
# Доработан узел <code>Транспорт УПД</code>:
## Исправлена работа со свойством <code>Идентификаторы ведущих</code>.
## Добавлено отслеживание активного подключения в режиме <code>Slave</code>.
# Зарегистрирован класс [[Класс any|any]].
# Доработан узел <code>Retain накопитель</code> - реализована возможность сохранения через задержку.
# Добавлена возможность связывания свойств экземпляров с свойствами других узлов.
# Добавлены типы (u)int64 для связи со свойствами экземпляров.

=== Среда разработки ===

# Исправлена критическая ошибка в команде "Показать в графическом представлении".
# Доработано контекстное меню дерева проекта:
#* Исправлена критическая ошибка в команде "Выделить" для виджетов.
#* Пункт "Выделить" перемещен на уровень выше.
#* Добавлено действие "Выделить" на двойной клик по виджетам.
# Исправлена критическая ошибка, возникавшая при открытии диалога "Настройки" для графиков.
# Устранены назойливые сообщения загрузки плагинов и регистрации узлов при проверке проекта.
# Добавлена возможность восстановления связей между узлами при вставке фрагментов из других проектов.
# Исправлена ошибка многократной установки ошибок в редактор кода, приводившая к сильному замедлению работы при большом количестве открытых окон редактора.
# Реализовано отображение содержимого массивов и указателей (хэндлов) в режиме отладки.
# Добавлены файловые ассоциации на файл проекта для быстрого открытия проекта в среде разработки с помощью двойного клика по .asp файлу.
# '''Отключен вызов сеттеров свойств при установке значений свойств в среде разработки.'''
# Отключено кеширование композиций в среде разработки.
# Исправлена критическая ошибка, возникавшая при установке значения свойства типа <code>string</code> у экземпляра после сборки проекта.
# Доработано контекстное меню дерева проекта и контекстное меню графического предаставления - добавлены иконки элементов контекстного меню <code>Добавить узел</code>, изменен порядок команд для более удобного их использования.
# Изменена горячая клавиша создания проекта на <code>Ctrl+Shift+N</code>.

=== Среда исполнения ===

# Добавлено логгирование для системного и межстанционного транспортов.
# Убрана поддержка IPv6 в системном транспорте и межстанционном транспорте для работы на встраиваемых системах без IPv6.
# Исправлена критическая ошибка в BasicNode, иногда приводившая к крахам при одновременном доступе к объекту из разных задач.

== 1.6.32-r79b12a16bbd7 от 2026-03-05 ==

=== Узлы ===
# Класс <code>WindowForm</code> добавлен в объектную модель.
# Отключена возможность добавления узлов типа <code>Задача ПЛК</code> как устаревшего функционала. Вместо него будет добавлена возможность создавать программы на языках FBD, CFC, SFC.
# Реализовано автоматическое создание конструкторов по умолчанию для классов из ОМ при отсутствии пользовательского.
# Исправлен запуск сигналов.
# Устранены утечки памяти при сохранении проекта в .bin.
# Внутренняя реорганизация обработчиков событий OperationsInput, OperationsOutput в узле <code>Сигнал простой</code>.
# Добавлен TransportModbusRtuIdr2.
# В действии <code>Создание события</code> исправлена работа форматтера <code>$$pd</code>.

=== Среда разработки ===

# Доработан редактор графического представления: добавлена сетка, [[Универсальная среда разработки Agava#.D0.98.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5 .D1.8F.D0.BA.D0.BE.D1.80.D0.B5.D0.B9|линейки, якоря]], функции выравнивания виджетов.
# Исправлена ошибка, вызывавшая двойной вызов обработчиков событий мыши для окон.
# Устранена ошибка, связанная с утечкой памяти при удалении виджетов.
# Добавлено приветственное окно со списком последних открытых проектов и таблицей примеров.
# Исправлена некритическая ошибка, возникавшая при закрытии фрейма.

=== Среда исполнения ===

# Устранена ошибка, связанная с утечкой памяти при закрытии окна с кешированными композициями.

== 1.6.31-rac6da98668fb от 2025-12-26 ==

=== Примеры ===
# Добавлен пример <code>Controllers/PLC70_Submodules</code>.

== 1.6.31-r9e81e0333260 от 2025-12-25 ==

=== Узлы ===

# Добавлена возможность создания конструкторов вида Classname(const string &in path) в дереве.
# Исправлена ошибка в вызове обработчика <code>OnWheel</code> у виджетов.
# Доработан узел <code>Корзина субмодулей</code>:
#* Уменьшено время ожидания ответа субмодуля с 1000 мс до 25 мс.
#* Реализована поддержка слотов G/H/I/K для ПЛК-70.
#* Реализовано создание узлов для каналов субмодулей в дереве проекта. '''Обратите внимание, проекты, использующие прежнюю структуру субмодулей, не совместимы с версией AgavaSCADA/AgavaPLC 1.6.31!'''
#* Исправлена валидация слотов на уровне субмодуля. Добавлена проверка на занятость одного слота несколькими субмодулями с формированием сообщения об ошибке.
# Доработаны узлы <code>Станция ПК-40</code>, <code>Станция ПК-50</code>, <code>Станция ПК-60</code>, <code>Станция ПК-70</code>:
#* Добавлено ограничение значений подсветки экрана и индикаторов, добавлена валидация соответствующих свойств узлов.
#* Реализована установка яркости подсветки экрана и состояния светодиодов согласно настроек в проекте.
# Доработан транспорт OPC UA:
#* Добавлена поддержка типа double.
#* Устранены критические ошибки при повторном запуске транспорта и при записи в read-only тэги.
#* Добавлено уведомление пользователя о некорректных тэгах.
# Доработан виджет <code>Ввод значения</code>: исправлено форматирование значений типа double - число знаков после запятой теперь зависит от шага значения.

=== Среда разработки ===

# Устранена потенциальная ошибка сохранения проекта при открытии в проводнике папки с проектом.
# Изменен мастер создания проектов: для проектов для <code>ПЛК-70.А</code>, создаваемых с помощью мастера, используется узел <code>Станция ПК-70</code> вместо <code>Станция ПК-40</code> в предыдущей версии.

=== Среда исполнения ===

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

== 1.6.30-rb3d3b577ed29 от 2025-12-05 ==

=== Ядро ===

# Исправлена работа системного транспорта: устранена ошибка взаимодействия с другими станциями.

=== Узлы ===

# Исправлена ошибка с обработкой вложенных групп в узле типа <code>Приложение</code>.
# Доработан класс <code>NodeProperty</code>: изменена регистрация класса, устранены критические ошибки.

=== Среда разработки ===

# Доработано редактирование свойств типа <code>ValueLink</code>: добавлен сброс значения, позволяющий удалить ранее установленное значение.
# Доработан редактирование свойств типа <code>NodeLink</code>: исправлена ошибка при работе с узлами с одними цифрами в имени.
# Доработано окно свойств: свойства типа <code>ValueLink</code> принимают перетаскивание узлов.
# Доработано окно <code>Стек вызовов</code>: при двойном клике по элементам таблицы открывается редактор кода.
# Доработан редактор кода: добавлены маркеры ошибок компиляции.
# Доработано окно <code>Ошибки</code>: при двойном клике на ошибке выполняется открытие редактора кода.
# '''Добавлена возможность поиска по проекту. Панель поиска вызывается комбинацией клавиш <code>Ctrl+Shift+F</code>.'''

=== Среда исполнения ===

# Доработано окно тревог: добавлено сообщение "Активных тревог нет" в центре таблицы при отсутствии активных тревог.

== 1.6.29-rf17ce9e25c7a от 2025-11-18 ==

=== Узлы ===

# Добавлена функция <code>SetNodeValueAsUInt(string strNodePath, uint32_t uiValue)</code>.
# Доработано действие <code>Создание события</code>: добавлено свойство <code>Требовать квитирование</code>.
# Доработана система тревог: добавлены обработчики событий <code>OnActiveEventsCleared</code> и <code>OnActiveEventsAcknowledged</code>.
# Доработан архиватор SQLite: изменен алгоритм прореживания в режиме <code>Процент от среднего значения</code> — теперь среднее вычисляется по последним N значениям. Добавлено свойство <code>Размер окна среднего (N)</code> для настройки ширины окна. Также добавлена опция <code>Процент от среднего (окно по времени)</code>, в которой среднее рассчитывается по значениям за временной интервал, равный параметру <code>Интервал архивирования</code>. Исправлено отсутствие таблицы <code>SignalInfo</code> при ротации БД.
# Доработана система тревог: добавлено свойство <code>Использовать цвет группы</code> для отображения элементов в окне тревог. Добавлено сохранение событий квитирования.
# Доработано окно смены пароля: добавлена поддержка свойства <code>Запретить смену пароля</code> у узла пользователя.
# Добавлена функция <code>void sleep(ms)</code>.
# Изменена логика работы функции <code>LaunchProcess</code>, которая теперь выполняет запуск в блокирующем режиме, то есть функция завершится после завершения запущенного процесса.
# Исправлена ошибка в узле <code>Операция Таймер</code>. Теперь выключенные действия в обработчике <code>OnTimerFinished</code> не исполняются.

=== Среда разработки ===

# Упорядочен вывод сообщений в окно Сообщения. Устранен вывод служебных сообщений.

=== Примеры ===

# Исправлены примеры <code>DistributedDemoServer</code>, <code>DistributedDemoClient</code>.

== 1.6.28-r7aa0d6dc2386 от 2025-11-01 ==

=== Узлы ===

# Доработано действие Смена пароля пользователя - пользователи с запретом смены пароля блокируются в списке выбора.
# Исправлена критическая ошибка в системе проверки прав, возникающая при некорректной конфигурации системы. Дополнена валидация системы для уведомления о некорректной конфигурации.
# Доработана стандартная библиотека: реализованы функции <code>array<string> GetInterfaceAddresses(string)</code>, <code>array<string> GetNetworkInterfaces()</code>.
# Доработан узел <code>Пользователь</code> - добавлено свойство <code>Запретить изменение пароля</code>.
# Оптимизирована работа со значениями типа SignalValue.
# Доработаны приложения - реализована выдача значений типа SignalValue для свойств экземпляров.

=== Среда разработки ===

# Исправлена критическая ошибка в виджетах <code>Кнопка</code> и <code>Гистограмма</code>, возникавшая при удалении источника из списка.
# Добавлено сохранение типа узла в его тег в XML проекте.
# Изменено редактирование узлов <code>Операция скрипт С++</code>, размещенных в обработчиках. Теперь это работает почти как в версии 1.2, но переход к редактору возможен только по нажатию ОК. При закрытии диалога контейнера добавлено закрытие окна редактора кода для вложенного узла.

=== Примеры ===

# Добавлен пример <code>AIParameter</code>, демонстрирующий применение ООП в проекте.
# Добавлены примеры <code>DistributedDemoServer</code>, <code>DistributedDemoClient</code>, демонстрирующие принцип построения распределенных проектов.

== 1.6.27-r8573369cf034 от 2025-10-29 ==

=== Узлы ===
# Доработана [[Узлы проекта AgavaSCADA/AgavaPLC#Композиция|композиция многослойная]]: добавлено свойство <code>ActionsOnLoad</code>.
# В стандартную библиотеку добавлена поддержка класса <code>filesystem</code>.
# Добавлено чтение свойств типа <code>NColor</code> [[Свойства узлов в AgavaSCADA/AgavaPLC#NColor|через преобразование в int]].
# Устранены критические ошибки в системных функциях поиска файлов, возникавшие при работе с разрушенными файловыми системами.
# Добавлены функции <code>bool isnan(float value)</code>, <code>void LaunchProcess(string strFilePath)</code>.

== 1.6.26-rfd1b5cbbf1fc от 2025-10-23 ==

=== Узлы ===
# Для узлов <code>RetainStorage</code> и <code>StorageDrive</code> реализовано онлайн создание свойств.
# Доработаны методы <code>BasicSignal::SetValue</code>, <code>BasicSignal::UpdateValue</code>, <code>BasicSource::SetValue</code>, <code>BasicSource::UpdateValue</code> - реализована выдача кодов [[Коды ошибок и предупреждений AgavaSCADA/AgavaPLC|ошибок]].
# Доработаны архиваторы <code>SQLite</code>, <code>PostreSQL</code> - добавлена возможность прореживания записи в БД.
# Выполнен рестайлинг окон проверки подлинности пользователя и смены пароля пользователя.
# Доработаны библиотеки ресурсов - исправлена работа с русскими символами.
# Доработано действие <code>Смена пароля пользователя</code>: добавлено свойство <code>Текущий</code>.
# Доработана логика работы операторов <code>SignalValue operator&&</code>, <code>SignalValue operator||</code> - реализована генерация соответствующих событий при ошибках исполнения. Реализовано более простое и корректное сравнение значений. Изменен режим сравнения аргументов типа <code>string</code>, <code>Result</code>.
# Доработано окно с композицией: исправлена работа с свойством <code>CurrentCompositionDesc</code>.
# Доработаны транспорты <code>Modbus</code>: устранена ошибка "Illegal Data Address" в режиме "Сервер" при создании нескольких блоков регистров.
# Доработано действие <code>Запуск метода экземпляра</code>: добавлена возможность передачи аргументов.
# Доработано действие <code>Создание события</code>: добавлен форматтер <code>$$ns</code> - шифр узла.
# Доработан виджет <code>Кнопка</code>: для вложенных действий типа <code>Создание события</code> передается ссылка на себя для работы с форматтерами.

=== Среда разработки ===

# Устранена критическая ошибка, возникавшая при кликах по свойствам только для чтения типа bool узлов в дереве проекта.

== 1.6.25-r97ac006e3905 от 2025-10-15 ==

=== Узлы ===
# Добавлена функция <code>bool isnan(double)</code>.
# Добавлена функция <code>int LoadComposition(string, string, int)</code>.
# Добавлено действие <code>Смена пароля пользователя</code>.
# Доработано окно тревог: добавлена возможность размещения пользовательских виджетов.
# Доработан узел <code>Пользователь</code>: добавлено свойство <code>Не показывать в списке</code>.
# Исправлена ошибка в действии <code>Закрытие окна</code>, возникавшая при закрытии нескольких окон подряд на активном экране.
# Доработан узел <code>Тренд</code> графика исторического: в свойство <code>Использовать описание и шифр</code> добавлен вариант <code>Вышестоящий узел сигнала</code>.
# Доработано окно тревог: добавлена отдельная иконка для аварий. Исправлена работа свойства <code>Включить воспроизведение звуков</code> на контроллерах.
# Доработано действие <code>Создание события</code>: исправлена ошибка, при возникновении которой при деактивации события выводился текст активации.

=== Среда разработки ===

# Исправлена ошибка при редактировании свойств типа <code>Узел</code>, <code>Список узлов</code>.
# Устранено "зависание" среды разработки при онлайн отладке и просмотре значений переменных из отлаживаемой программы.
# Доработано окно редактирования свойств типа <code>Список узлов</code>: добавлена возможность перемещения элементов.
# Доработано окно редактирования списка привилегий у роли: добавлена поддержка клавиши Del, реализовано сохранение и восстановление геометрии окна, реализовано удаление множества элементов.
# Доработано окно ошибок: двойной клик по ошибке выделяет в дереве проекта узел, вызвавший ошибку.
# Исправлено повторное открытие окна настройки привилегий.
# Доработана библиотека ресурсов: сохранение теперь выполняется только при наличии изменений.

== 1.6.24-r93067f2c1dd1 от 2025-10-06 ==

=== Узлы ===
# Добавлена функция <code>double rand(double, double)</code>.
# Добавлена поддержка команды <code>Сброс</code> для действия <code>Команда узлу</code>.
# Узел <code>Контроллер событий</code> переименован в <code>Монитор событий</code>.
# Для монитора событий добавлено свойство <code>Блокировка работы</code>, добавлен обработчик <code>OnActiveEventsCleared</code>, вызывающийся после удаления всех активных тревог.
# Доработан узел <code>Регистр Modbus</code> - добавлена поддержка онлайн создания свойств.
# Доработан <code>Транспорт Modbus</code>: в режиме работы Slave устранена критическая ошибка, если не было указано свойство "Узел для чтения/записи". Добавлено соответствующее предупреждение при сборке проекта.
# Добавлена поддержка связывания свойств экземпляров через аргументы типа <code>SignalValue</code>.
# Доработан <code>Монитор событий</code>: добавлено свойство <code>Поведение при блокировании</code>. Добавлена проверка значений контролируемых узлов при старте проекта.

=== Среда разработки ===

# Доработан текстовый редактор кода: добавлена обработка нажатия клавиши <code>F9</code> для добавления/удаления точек останова. Значительно ускорено открытие текстов программ в редакторе.
# Доработан отладчик: добавлено человеко-читаемое представление значений типа <code>SignalValue</code>.

=== Примеры ===

# Дополнен пример <code>TestEventsAlarms</code>.

== 1.6.23-ra13bff0d25ce от 2025-09-29 ==

=== Узлы ===
# Добавлено восстановление свойств экземпляров объектов из retain.
# Доработаны транспорты <code>Modbus</code> - реализован арбитраж чтения/записи с помощью приоритетов.
# Исправлено некорректное позиционирование окон авторизации пользователя, выбора интервала графика или журнала и др. в проектах с составными фреймами, содержащими множество окон.
# Реализована запись во все источники узла <code>Сигнал простой</code>.

=== Среда разработки ===

# Исправлена ошибка в редактировании свойств типа <code>Цвет</code>, из-за которой иногда некорректно сохранялось значение альфа канала.
# Исправлена ошибка использования одной библиотеки ресурсов в разных проектах.

== 1.6.22-r2d092373a7c2 от 2025-09-24 ==

=== Узлы ===
# Исправлены критические ошибки обращения к свойствам экземпляров объектов при выполнении программ.
# Исправлена ошибка первичного отображения окна тревог.
# Устранены ошибки в работе субмодулей.

=== Среда разработки ===

# Устранены ошибки компиляции проектов, использующих субмодули.

== 1 1.6.21-rb7d9d1301bf0 от 2025-09-18 ==

=== 1.1 Узлы ===

# Исправлена ошибка "онлайн" создания свойств для виджета <code>Ввод значения</code>.
# Реализована проверка свойства <code>Отключен</code> у действий перед выполнением.
# Исправлена ошибка "онлайн" создания свойств экземпляров объектов и связывания их с методами и инициализации значениями.
# AS/PLC 2.38.
# Реализована возможность игнорирования ошибок связи при работе транспорта <code>Modbus-TCP</code> (свойство <code>Действие при превышении порога ошибок 2</code>).
# Реализована инициализация значения сигнала простого значением связанного источника при запуске.
# Реализован кэш методов экземпляров объектов.
# Изменен механизм определения IP-адресов станции.

=== 1.2 Среда разработки ===

# Восстановлена возможность выбора свойств узлов как источников для операций.
# Реализовано отображение признака <code>Отключен</code> узлов в окне выбора узлов.
# Дополнена валидация виджета <code>Ввод значения</code>.

== 1.6.20-r0ad724e1e636 от 2025-08-08 ==

=== Узлы ===

# Добавлена функция <code>int StoreMessage(int iMessageLevel, string strMessage, string strGroup).</code>
# Добавлена возможность вызова методов экземпляров объектов из действий.
# Исправлено выполнение действия <code>Создание события</code>, теперь возможно создание событий из обработчиков.
# В тренды графиков добавлено свойство <code>Единицы измерения</code>.
# Добавлен межстанционный транспорт. Для станций добавлено свойство <code>Роль</code>. Станция с ролью <code>Клиент</code> производит подключение к удаленным станциям с ролью <code>Сервер</code> и уведомляет об изменениях источников и сигналов.
# Устранена ошибочная генерация нескольких дублирующихся событий при работе контроллеров событий.
# В окне <code>Фильтр</code> виджета <code>Список событий</code> размер элементов теперь зависит от свойства системы тревог <code>Размер кнопки</code>.
# Доработаны транспорты <code>Modbus</code>:
#* добавлена [[Транспорты AgavaSCADA/AgavaPLC#Этап 2. Объединение команд записи (функции 15 и 16)|группировка команд записи]] для функций 15 и 16;
#* реализована [[Транспорты AgavaSCADA/AgavaPLC#Этап 1. Дедупликация при постановке в очередь|дедупликация команд записи]].
# Доработан транспорт OPC-UA:
#* исправлены типы свойств;
#* сервер теперь привязывается к порту, указанному в свойстве <code>Адрес</code> (ранее всегда использовался 4840).

=== Среда разработки ===

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

== 1.6.19-r89b594033f4d от 2025-09-02 ==

=== Узлы ===

# Реализовано определение локальной станции для запуска проекта.
# Исправлен запуск узла типа <code>Сигнал простой</code>.

=== Среда разработки ===

# В мастер создания проектов добавлена поддержка АГАВА ПЛК-70.А.
# Исправлена конвертация виджетов <code>Ввод значения</code> при обновлении проекта с версии 1.2.
# Исправлена ошибка в окне настройки исторического графика, связанная с одновременным удалением нескольких трендов.
# Доработана проверка проекта перед сохранением конфигурации. При обнаружении критических ошибок - отказ сохранения.
# Добавлена проверки станций на использование адреса 127.0.0.1, на дублирующиеся IP-адреса.

== 1.6.18-r4a325427448b от 2025-08-06 ==

=== Узлы ===

# Доработана установка аргументов в вызываемые методы экземпляров (добавлен тип <code>string</code> для некоторых сценариев).
# Доработаны узлы <code>Транспорт Modbus-TCP</code>, <code>Транспорт Modbus-RTU</code>:
#* Добавлен узел типа <code>Счетчик</code>, хранящий признак активного подключения к устройству с заданным Modbus адресом.
# Доработан узел <code>Транспорт Modbus-TCP</code>:
#* Реализовано множественное подключение клиентов в режиме работы <code>Сервер</code>.
#* Доработан режим <code>Сервер</code>: добавлена возможность настройки таймаута активности клиента и максимального количества подключений к серверу.
# Узел <code>Шаблонная композиция</code> убран из списка доступных типов для группы "Композиции".
# Исправлена критическая ошибка, изредка возникавшая при переключении окон.
# Исправлена ошибка выполнения действия Закрытие окна.

=== Среда разработки ===

# Исправлена функция просмотра и редактирования списка источников формы.

#

== 1.6.17-r1f70359a00b4 от 2025-08-01 ==

=== Узлы ===

# Исправлена ошибка передачи аргументов типов <code>float</code>, <code>double</code> в методы классов.
# Исправлено связывание свойств экземпляров базовых типов с узлами проекта.
# Доработан вызов методов типа <code>void</code> классов для исключения критических ошибок.
# Для кривых графиков изменена толщина линии по умолчанию на <code>1</code>.
# Исправлена ошибка в команде <code>Сохранить архив проекта</code> - устранено ошибочное создание дубликатов некоторых используемых проектом файлов.
# Доработано восстановление <code>retain</code> - добавлена возможность восстановления в свойства экземпляров классов.
# Изменена конвертация <code>Result</code> в другие типы.

=== Среда разработки ===

# Исправлены ошибки работы отладчика с точками останова в методах и свойствах классов.
# Изменен уровень ошибок компиляции при поиске путей в проекте (Get/SetNodeValueAs... и др.) с <code>Ошибка</code> на <code>Предупреждение</code>.
# Реализовано связывание виджетов со свойствами узлов путем перетаскивания.
# Добавлено местное (inplace) редактирование свойств типа <code>SignalValue</code> в диалоге редактирования сопоставлений, например в окне редактирования сопоставлений виджета <code>Выпадающий список</code>.
# Уточнено сообщение об ошибочном открытии проекта из папки <code>.autosave</code>.
# Доработано окно выбора узлов - кнопка <code>ОК</code> теперь является кнопкой по умолчанию.

=== Примеры ===

# Добавлен пример SQLiteDecimation, демонстрирующий возможности прореживания при записи архива SQLite.
# Доработан пример TestEventsAlarms.

== 1.6.16-r4dc07fc875a4 от 2025-07-18 ==

=== Узлы ===

# Доработан системный транспорт <code>TransportSystem2</code> - изменена процедура остановка сервера для устранения незавершенных соединений.
# Доработаны виджеты <code>Гистограмма</code> и <code>Кнопка</code> - исправлена работа с источником.
# Доработано действие <code>Запуск процесса</code> - исправлен запуск процесса.

=== Среда разработки ===

# Восстановлено обновление BuildNo и даты сборки проекта.

=== ASLauncher ===

# Убрано диалоговое окно с сообщением о частых попытках перезапуска при выходе.
# При запуске приложений из `.desktop` файлов добавлена проверка, что логирование в указанные файлы возможно.
# В файлы логов добавлена информация о версии приложения.

== 1.6.15-r710146e4389e от 2025-07-09 ==

=== Узлы ===

# Узел Система тревог - добавлены настройки окна тревог (ширина, высота, перенос строк в сообщениях).
# Исправлена ошибка в проверке прав на закрытие фрейма, из-за чего в некоторых проектах без системы проверки прав закрытие фрейма не работало.
# Виджет <code>Список событий</code> - исправлена ошибка при работе с диалогом ожидания.
# Действие <code>Авторизация пользователя</code> - добавлено свойство <code>Запрашивать пароль</code>. Действие с включенным свойством <code>Запрашивать пароль</code> будет отображать окно авторизации без возможности смены пользователя.
# Реализована возможность инициализации свойств экземпляров объектов постоянными значениями, задаваемыми в среде разработки (доступны типы bool, int, uint, long, ulong, double, string).
# Для транспортов <code>Modbus-RTU</code>, <code>Modbus-TCP</code> добавлена очистка очереди команд при (ре)старте обмена.

=== Среда разработки ===

# Добавлена поддержка нового системного транспорта. Для подключения к панелям оператора и контроллерам из среды разработки необходимо обновить среду исполнения до версии 1.6.15 или более новой.
# Добавлена иконка для приложения [[Универсальная среда разработки Agava]] (впервые с версии 1.0!).
# Исправлены критические ошибки в webvisu из-за отсутствия qml модулей.

=== Среда исполнения ===

# Откорректировано оформление окна авторизации с целью улучшения привлекательности.

=== Примеры ===

# Добавлены примеры <code>MultiImageLabel</code>, <code>LayersDemo</code>. Пример <code>MultiImageLabel</code> дополнен демонстрацией webvisu.
# Добавлены примеры <code>OpcUaDemo</code>, <code>OpcUaClientDemo</code>.

'''Версия переведена в стабильную стадию.'''

== 1.6.14-r1c61c35c3da4 от 2025-06-20 ==

=== Среда разработки ===

# Добавлена возможность регулирования частоты обновления форм и экранов с композициями. Добавлено свойство "Интервал обновления" для экранов и композиций.
# У виджета "График" изменен форматтер оси времени по умолчанию с "dd.MM.yy hh:mm:ss" на "dd.MM.yyyy hh:mm:ss".

=== Среда исполнения ===

# Оптимизирован вывод информации на экран - исключена повторная отрисовка виджетов, при записи значений в их свойства из скриптов и программ.
# Реализовано профилирование вызова базовых методов и работы с контекстами.
# Реализован вывод информации о перерисовке виджетов в консоль с настройкой через файл as.ini.

=== Примеры ===

# Добавлен пример <code>WindowUpdateRate</code>, демонстрирующий возможность ограничения частоты обновления окон.

== 1.6.13-r13248581de39 от 2025-06-17 ==

=== Среда разработки ===

# Исправлена ошибка функции "Просмотр событий", из-за которой некорректно выдавались события в проектах без логгеров.
# Реализовано копирование станций ПК-40, ПК-50, ПК-60.
# Устранено сохранение в архив проекта файлов .bi?, хранящихся в подпапках, начинающихся с точки. Например .autosave, .backup
# Разрешено добавление приложений к станциям ПО-40, ПО-50, ПО-60.
# Убрана зависимость от библиотеки libclang.

=== Среда исполнения ===

# Реализован вывод информации о регионах перерисовки окон в консоль с настройкой через файл as.ini.
# Доработаны методы BasicSignal::GetValue, BasicSignal::SetValue для корректного обращения к узлам проекта.
# Исправлена ошибка в работе со светодиодами станции ПК-40.
# Исправлено создание BasicSource("path"), BasicSignal("path"), BasicWidget("path") в программах. Теперь появилась возможность доступа ко всем свойствам узла проекта, а не только к свойствам, определенным в BasicNode.
# Добавлена проверка типа при создании экземпляра BasicSource (ОМ).

=== Примеры ===

# Разработан пример <code>Leds</code>, демонстрирующий работу со светодиодами ПО-50 из программы с использованием объектной модели.

=== ASLauncher ===

# Добавлен скрипт для восстановления <code>explorer.exe</code> в качестве оболочки рабочего стола после установки ASLauncher.

== 1.6.12-r17b244111a8c от 2025-05-30 ==

=== Среда разработки ===

# Исправлена ошибка, возникавшая при перемещении узлов в дереве проекта, из-за которой перемещаемые узлы пропадали.
# Добавлено текстовое описание при появлении окна с ошибками, например при сохранении проекта.
# Узел <code>Операция Пара условий</code> - исправлены имена свойств. В проектах версии 1.2 операция не работала в режиме проверки двух условий. '''Необходимо проверить корректность настроек при переходе с версии 1.2.'''
# Исправлена ошибка определения уровня логгеров при вызове команды <code>Просмотр событий</code>, из-за которой при наличии в проекте логгеров с уровнями логгирования <code>INFO</code> в окно событий не попадали события ниже уровнем.

=== Среда исполнения ===

# Оптимизация узла <code>Транспорт TCP</code>.
# Оптимизирована система журналирования.

== 1.6.8-r915d8d477fa4 от 2025-05-14 ==

=== Среда разработки ===
# Исправлено несоответствие настроек узла <code>Действие "Команда узлу"</code> и фактически исполняемых команд. '''При обновлении на эту версию необходимо проверить корректность настроек всех улов типа <code>Действие "Команда узлу"</code>.'''

[[Категория:AgavaSCADA/AgavaPLC]]
__NOTOC__

Класс filesystem

2026-04-28T04:55:12Z

TaushkanovKV: /* Методы */

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

Класс доступен начиная с версии <code>AS 1.6+</code>.
==Методы==
'''bool changeCurrentPath(const string &in path)'''
'''Назначение:''' Изменяет текущую рабочую директорию.

'''Аргументы:'''
*<code>path</code> – путь к новой директории (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>true</code> – если путь существует и текущая директория успешно изменена.
*<code>false</code> – если указанный путь не существует или не является директорией.
'''Примечания:'''
*Если путь задан относительно, он объединяется с текущей директорией.
*Путь не должен содержать обратные слеши <code>\</code> – они автоматически заменяются на <code>/</code>.
*Завершающие слеши автоматически удаляются из пути.
*Не поддерживает разрешение внутренних ссылок <code>/./</code> и <code>/../</code>.
'''string getCurrentPath() const'''
'''Назначение:''' Возвращает текущую рабочую директорию.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''
*Строка с абсолютным путём текущей директории, использующая разделители <code>/</code>.
'''Примечания:'''
*При создании объекта <code>filesystem</code> текущая директория инициализируется рабочим каталогом приложения.
*Все обратные слеши <code>\</code> заменяются на <code>/</code> для единообразия.
'''array<string> @getDirs() const'''
'''Назначение:''' Получает список всех поддиректорий внутри текущей директории.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''
*Массив строк с именами поддиректорий.
'''Примечания:'''
*Специальные записи <code>.</code> (текущая директория) и <code>..</code> (родительская директория) исключаются из результата.
*Возвращает пустой массив, если директорий нет или произошла ошибка чтения.
'''array<string> @getFiles() const'''
'''Назначение:''' Получает список всех файлов внутри текущей директории.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''
*Массив строк с именами файлов.
'''Примечания:'''
*В результат включаются только файлы, директории исключаются.
*Возвращает пустой массив, если файлов нет или произошла ошибка чтения.
'''bool isDir(const string &in path) const'''
'''Назначение:''' Проверяет, является ли указанный путь директорией.

'''Аргументы:'''
*<code>path</code> – путь к объекту файловой системы (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>true</code> – если объект существует и является директорией.
*<code>false</code> – если объект не существует, не является директорией или произошла ошибка.
'''Примечания:'''
*Относительные пути разрешаются относительно текущей директории.
*Абсолютные пути определяются наличием двоеточия <code>:</code> (например, <code>C:</code>) или начального слеша <code>/</code> или <code>\</code>.
'''bool isLink(const string &in path) const'''
'''Назначение:''' Проверяет, является ли указанный путь символической ссылкой (symlink).

'''Аргументы:'''
*<code>path</code> – путь к объекту файловой системы (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>true</code> – если объект существует и является символической ссылкой (на Windows – репарс-точкой).
*<code>false</code> – если объект не является ссылкой, не существует или произошла ошибка.
'''Примечания:'''
*Кроссплатформенная поддержка: Windows (атрибут <code>FILE_ATTRIBUTE_REPARSE_POINT</code>) и POSIX (флаг <code>S_IFLNK</code>).
*Относительные пути разрешаются относительно текущей директории.
'''int64 getSize(const string &in path) const'''
'''Назначение:''' Возвращает размер файла в байтах.

'''Аргументы:'''
*<code>path</code> – путь к файлу (относительный или абсолютный).
'''Возвращаемое значение:'''
*Размер файла в байтах (тип <code>int64</code>).
*<code>-1</code> – если файл не существует, указан путь к директории или произошла ошибка.
'''Примечания:'''
*На Windows используется API-функция <code>GetFileSizeEx</code>.
*На POSIX-системах используется <code>stat</code>.
*Для директорий возвращает <code>-1</code>.
'''int makeDir(const string &in path)'''
'''Назначение:''' Создаёт новую директорию.

'''Аргументы:'''
*<code>path</code> – путь к создаваемой директории (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>0</code> – директория успешно создана.
*<code>-1</code> – ошибка создания (например, недостаточно прав, путь не существует).
'''Примечания:'''
*'''Важно:''' Не поддерживает рекурсивное создание промежуточных директорий.
*На Windows создаёт директорию с правами по умолчанию.
*На POSIX создаёт с правами <code>S_IRWXU | S_IRWXG | S_IROTH | S_IXOTH</code> (755: чтение/запись/исполнение для владельца, чтение/исполнение для группы и остальных).
'''int removeDir(const string &in path)'''
'''Назначение:''' Удаляет пустую директорию.

'''Аргументы:'''
*<code>path</code> – путь к удаляемой директории (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>0</code> – директория успешно удалена.
*<code>-1</code> – ошибка удаления (директория не пуста, не существует, недостаточно прав).
'''Примечания:'''
*Удаляет только '''пустые''' директории.
*Не поддерживает рекурсивное удаление с содержимым.
*На Windows используется <code>RemoveDirectoryW</code>, на POSIX – <code>rmdir</code>.
'''int deleteFile(const string &in path)'''
'''Назначение:''' Удаляет файл.

'''Аргументы:'''
*<code>path</code> – путь к удаляемому файлу (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>0</code> – файл успешно удалён.
*<code>-1</code> – ошибка удаления (файл не существует, недостаточно прав, указана директория).
'''Примечания:'''
*На Windows используется <code>DeleteFileW</code>, на POSIX – <code>unlink</code>.
*Для удаления директорий используйте <code>removeDir</code>.
'''int copyFile(const string &in source, const string &in target)'''
'''Назначение:''' Копирует файл из одного местоположения в другое.

'''Аргументы:'''
*<code>source</code> – путь к исходному файлу.
*<code>target</code> – путь к целевому файлу (не директории).
'''Возвращаемое значение:'''
*<code>0</code> – файл успешно скопирован.
*<code>-1</code> – ошибка копирования (исходный файл не существует, недостаточно прав, целевой файл уже существует).
'''Примечания:'''
*На Windows используется API-функция <code>CopyFileW</code> с параметром <code>TRUE</code> (не перезаписывать существующий файл).
*На POSIX-системах копирование выполняется '''вручную''' побайтово через <code>fopen/fread/fwrite</code>, так как стандартной функции копирования нет.
*Целевой файл не должен существовать (флаг <code>TRUE</code> на Windows).
'''int move(const string &in source, const string &in target)'''
'''Назначение:''' Перемещает или переименовывает файл или директорию.

'''Аргументы:'''
*<code>source</code> – текущий путь к объекту.
*<code>target</code> – новый путь или имя объекта.
'''Возвращаемое значение:'''
*<code>0</code> – объект успешно перемещён/переименован.
*<code>-1</code> – ошибка операции (объект не существует, недостаточно прав).
'''Примечания:'''
*Может использоваться как для файлов, так и для директорий.
*На Windows используется <code>MoveFileW</code>, на POSIX – <code>rename</code>.
*Операция может выполняться в пределах одного тома/файловой системы.
'''datetime getCreateDateTime(const string &in path) const'''
'''Назначение:''' Возвращает дату и время создания файла или директории.

'''Аргументы:'''
*<code>path</code> – путь к объекту файловой системы.
'''Возвращаемое значение:'''
*Объект <code>datetime</code>, содержащий дату и время создания.
'''Примечания:'''
*'''Выбрасывает исключение''' в скриптовом контексте через <code>SetException</code>, если не удаётся получить дату создания.
*На Windows используется <code>GetFileTime</code> с полем <code>createTm</code>.
*На POSIX-системах используется поле <code>st_ctime</code> (change time) – может отличаться от реального времени создания на некоторых файловых системах.
'''datetime getModifyDateTime(const string &in path) const'''
'''Назначение:''' Возвращает дату и время последнего изменения файла или директории.

'''Аргументы:'''
*<code>path</code> – путь к объекту файловой системы.
'''Возвращаемое значение:'''
*Объект <code>datetime</code>, содержащий дату и время последней модификации.
'''Примечания:'''
*Выбрасывает исключение, если не удаётся получить дату изменения.
*На Windows используется <code>GetFileTime</code> с полем <code>modifyTm</code>.
*На POSIX-системах используется поле <code>st_mtime</code> (modify time).

[[Категория:AgavaSCADA/AgavaPLC]]

Описание языка С++ в AgavaSCADA/AgavaPLC

2026-04-27T06:48:28Z

TaushkanovKV: /* Классы */

Описание языка С++ в AgavaSCADA/AgavaPLC

2026-04-27T06:45:01Z

TaushkanovKV: /* Классы */

Описание языка С++ в AgavaSCADA/AgavaPLC

2026-04-27T06:44:26Z

TaushkanovKV: /* Классы */

Описание языка С++ в AgavaSCADA/AgavaPLC

2026-04-27T06:43:33Z

TaushkanovKV: /* Преобразование IEEE битов */

Описание языка С++ в AgavaSCADA/AgavaPLC

2026-04-27T06:40:20Z

TaushkanovKV: /* Класс file */

Класс datetime

2026-04-27T06:37:57Z

TaushkanovKV:

Класс доступен начиная с версии <code>AS 1.6+</code>.
==Конструкторы==
===Конструктор по умолчанию===
datetime dt();
Создает объект с текущей датой и временем.
===Конструктор копирования===
datetime dt(other);
Создает копию существующего объекта datetime.
===Конструктор с параметрами===
datetime dt(year, month, day, hour = 0, minute = 0, second = 0);
Создает объект с указанной датой и временем.

=== Пример ===
// Только дата
datetime newYear = datetime(2024, 1, 1);

// Дата и время
datetime meeting = datetime(2024, 12, 25, 14, 30, 0);

// Полная спецификация
datetime exact = datetime(2024, 6, 15, 9, 45, 30);
==Методы==
<code>uint get_year() const</code>

Возвращает год (4 цифры).

<code>uint get_month() const</code>

Возвращает месяц (1-12).

<code>uint get_day() const</code>

Возвращает день месяца (1-31).

<code>uint get_hour() const</code>

Возвращает часы (0-23).

<code>uint get_minute() const</code>

Возвращает минуты (0-59).

<code>uint get_second() const</code>

Возвращает секунды (0-59).

'''Пример:'''
datetime dt = datetime(2024, 12, 25, 14, 30, 45);

uint year = dt.year; // 2024
uint month = dt.month; // 12
uint day = dt.day; // 25
uint hour = dt.hour; // 14
uint minute = dt.minute; // 30
uint second = dt.second; // 45
<code>bool setDate(year, month, day)</code>

Устанавливает дату. Возвращает <code>true</code> при успехе, <code>false</code> при неверной дате.

'''Пример:'''
datetime dt;
bool success = dt.setDate(2024, 2, 29); // true (високосный год)
bool invalid = dt.setDate(2023, 2, 29); // false (не високосный)
<code>bool setTime(hour, minute, second)</code>

Устанавливает время. Возвращает <code>true</code> при успехе, <code>false</code> при неверном времени.

'''Пример:'''

cpp
datetime dt;
bool success = dt.setTime(23, 59, 59); // true
bool invalid = dt.setTime(25, 0, 0); // false (часы > 23)
==Арифметические операции==
Вычитание дат
int64 difference = dt1 - dt2;
Возвращает разницу в секундах.
datetime start = datetime(2024, 1, 1, 0, 0, 0);
datetime end = datetime(2024, 1, 2, 0, 0, 0);
int64 diff = end - start; // 86400 секунд (1 день)
Сложение с секундами
datetime result = dt + seconds;
datetime result = seconds + dt; // обратный порядок
dt += seconds;
'''Пример:'''
datetime dt = datetime(2024, 1, 1, 10, 0, 0);

// Добавить 2 часа
datetime later = dt + 7200;
dt += 7200;

// Обратный порядок
datetime same = 7200 + dt;
Вычитание секунд
datetime result = dt - seconds;
datetime result = seconds - dt; // обратный порядок
dt -= seconds;
'''Пример:'''
datetime dt = datetime(2024, 1, 1, 10, 0, 0);

// Вычесть 30 минут
datetime earlier = dt - 1800;
dt -= 1800;
===Операции сравнения===
<code>bool opEquals(other)</code>

Проверка равенства дат.

<code>bool opLess(other)</code>

Проверка что дата раньше.

<code>int opCmp(other)</code>

Сравнение с возвратом -1 (меньше), 0 (равно), 1 (больше).

'''Пример:'''
datetime dt1 = datetime(2024, 1, 1);
datetime dt2 = datetime(2024, 1, 2);

if (dt1 < dt2) {
// dt1 раньше dt2
}

if (dt1 == dt2) {
// даты равны
}

int result = dt1.opCmp(dt2); // -1
==Практические примеры==
Пример 1: Таймер выполнения
datetime startTime;

// Выполняем некоторую операцию
for (int i = 0; i < 1000000; i++)
{
// какая-то работа
}

datetime endTime;
int64 elapsed = endTime - startTime;
print("Операция заняла: " + elapsed + " секунд");
Пример 2: Расчет дат событий
// Дата начала проекта
datetime projectStart = datetime(2024, 1, 15);

// Напоминание за 3 дня до дедлайна
datetime deadline = datetime(2024, 3, 1);
datetime reminder = deadline - 3 * 86400; // 3 дня в секундах

// Продление срока на 2 недели
datetime extendedDeadline = deadline + 14 * 86400;
Пример 3: Проверка рабочего времени
datetime currentTime;

// Создаем время начала и конца рабочего дня
datetime workStart = datetime(currentTime.year, currentTime.month,
currentTime.day, 9, 0, 0);
datetime workEnd = workStart + 8 * 3600; // 8 часов

if (currentTime >= workStart && currentTime <= workEnd)
{
print("Рабочее время");
}
else
{
print("Вне рабочего времени");
}
Пример 4: Валидация даты
bool createAppointment(uint year, uint month, uint day, uint hour)
{
datetime appointment;

// Проверяем корректность даты
if (!appointment.setDate(year, month, day)) {
print("Неверная дата!");
return false;
}

// Проверяем корректность времени
if (!appointment.setTime(hour, 0, 0)) {
print("Неверное время!");
return false;
}

// Проверяем что дата не в прошлом
datetime now;
if (appointment < now) {
print("Дата не может быть в прошлом!");
return false;
}

print("Встреча создана: " + appointment.year + "-" + appointment.month + "-" + appointment.day);
return true;
}
Пример 5: Разбивка интервала времени
datetime start = datetime(2024, 1, 1, 0, 0, 0);
datetime end = start + 365 * 86400; // +1 год

int64 totalSeconds = end - start;
int64 days = totalSeconds / 86400;
int64 hours = (totalSeconds % 86400) / 3600;
int64 minutes = (totalSeconds % 3600) / 60;
int64 seconds = totalSeconds % 60;

print("Интервал: " + days + " дней, " + hours + " часов, " + minutes + " минут, " + seconds + " секунд");

[[Категория:AgavaSCADA/AgavaPLC]]

Класс filesystem

2026-04-27T06:37:40Z

TaushkanovKV:

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

Класс доступен начиная с версии <code>AS 1.6+</code>.
==Методы==
'''bool changeCurrentPath(const string &in path)'''
'''Назначение:''' Изменяет текущую рабочую директорию.

'''Аргументы:'''
*<code>path</code> – путь к новой директории (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>true</code> – если путь существует и текущая директория успешно изменена.
*<code>false</code> – если указанный путь не существует или не является директорией.
'''Примечания:'''
*Если путь задан относительно, он объединяется с текущей директорией.
*Путь не должен содержать обратные слеши <code>\</code> – они автоматически заменяются на <code>/</code>.
*Завершающие слеши автоматически удаляются из пути.
*Не поддерживает разрешение внутренних ссылок <code>/./</code> и <code>/../</code>.
'''string getCurrentPath() const'''
'''Назначение:''' Возвращает текущую рабочую директорию.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''
*Строка с абсолютным путём текущей директории, использующая разделители <code>/</code>.
'''Примечания:'''
*При создании объекта <code>filesystem</code> текущая директория инициализируется рабочим каталогом приложения.
*Все обратные слеши <code>\</code> заменяются на <code>/</code> для единообразия.
'''array<string> @getDirs() const'''
'''Назначение:''' Получает список всех поддиректорий внутри текущей директории.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''
*Массив строк с именами поддиректорий.
'''Примечания:'''
*Специальные записи <code>.</code> (текущая директория) и <code>..</code> (родительская директория) исключаются из результата.
*Возвращает пустой массив, если директорий нет или произошла ошибка чтения.
'''array<string> @getFiles() const'''
'''Назначение:''' Получает список всех файлов внутри текущей директории.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''
*Массив строк с именами файлов.
'''Примечания:'''
*В результат включаются только файлы, директории исключаются.
*Возвращает пустой массив, если файлов нет или произошла ошибка чтения.
'''bool isDir(const string &in path) const'''
'''Назначение:''' Проверяет, является ли указанный путь директорией.

'''Аргументы:'''
*<code>path</code> – путь к объекту файловой системы (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>true</code> – если объект существует и является директорией.
*<code>false</code> – если объект не существует, не является директорией или произошла ошибка.
'''Примечания:'''
*Относительные пути разрешаются относительно текущей директории.
*Абсолютные пути определяются наличием двоеточия <code>:</code> (например, <code>C:</code>) или начального слеша <code>/</code> или <code>\</code>.
'''bool isLink(const string &in path) const'''
'''Назначение:''' Проверяет, является ли указанный путь символической ссылкой (symlink).

'''Аргументы:'''
*<code>path</code> – путь к объекту файловой системы (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>true</code> – если объект существует и является символической ссылкой (на Windows – репарс-точкой).
*<code>false</code> – если объект не является ссылкой, не существует или произошла ошибка.
'''Примечания:'''
*Кроссплатформенная поддержка: Windows (атрибут <code>FILE_ATTRIBUTE_REPARSE_POINT</code>) и POSIX (флаг <code>S_IFLNK</code>).
*Относительные пути разрешаются относительно текущей директории.
'''int64 getSize(const string &in path) const'''
'''Назначение:''' Возвращает размер файла в байтах.

'''Аргументы:'''
*<code>path</code> – путь к файлу (относительный или абсолютный).
'''Возвращаемое значение:'''
*Размер файла в байтах (тип <code>int64</code>).
*<code>-1</code> – если файл не существует, указан путь к директории или произошла ошибка.
'''Примечания:'''
*На Windows используется API-функция <code>GetFileSizeEx</code>.
*На POSIX-системах используется <code>stat</code>.
*Для директорий возвращает <code>-1</code>.
'''int makeDir(const string &in path)'''
'''Назначение:''' Создаёт новую директорию.

'''Аргументы:'''
*<code>path</code> – путь к создаваемой директории (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>0</code> – директория успешно создана.
*<code>-1</code> – ошибка создания (например, недостаточно прав, путь не существует).
'''Примечания:'''
*'''Важно:''' Не поддерживает рекурсивное создание промежуточных директорий (отмечено в TODO).
*На Windows создаёт директорию с правами по умолчанию.
*На POSIX создаёт с правами <code>S_IRWXU | S_IRWXG | S_IROTH | S_IXOTH</code> (755: чтение/запись/исполнение для владельца, чтение/исполнение для группы и остальных).
'''int removeDir(const string &in path)'''
'''Назначение:''' Удаляет пустую директорию.

'''Аргументы:'''
*<code>path</code> – путь к удаляемой директории (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>0</code> – директория успешно удалена.
*<code>-1</code> – ошибка удаления (директория не пуста, не существует, недостаточно прав).
'''Примечания:'''
*Удаляет только '''пустые''' директории.
*Не поддерживает рекурсивное удаление с содержимым.
*На Windows используется <code>RemoveDirectoryW</code>, на POSIX – <code>rmdir</code>.
'''int deleteFile(const string &in path)'''
'''Назначение:''' Удаляет файл.

'''Аргументы:'''
*<code>path</code> – путь к удаляемому файлу (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>0</code> – файл успешно удалён.
*<code>-1</code> – ошибка удаления (файл не существует, недостаточно прав, указана директория).
'''Примечания:'''
*На Windows используется <code>DeleteFileW</code>, на POSIX – <code>unlink</code>.
*Для удаления директорий используйте <code>removeDir</code>.
'''int copyFile(const string &in source, const string &in target)'''
'''Назначение:''' Копирует файл из одного местоположения в другое.

'''Аргументы:'''
*<code>source</code> – путь к исходному файлу.
*<code>target</code> – путь к целевому файлу (не директории).
'''Возвращаемое значение:'''
*<code>0</code> – файл успешно скопирован.
*<code>-1</code> – ошибка копирования (исходный файл не существует, недостаточно прав, целевой файл уже существует).
'''Примечания:'''
*На Windows используется API-функция <code>CopyFileW</code> с параметром <code>TRUE</code> (не перезаписывать существующий файл).
*На POSIX-системах копирование выполняется '''вручную''' побайтово через <code>fopen/fread/fwrite</code>, так как стандартной функции копирования нет.
*Целевой файл не должен существовать (флаг <code>TRUE</code> на Windows).
'''int move(const string &in source, const string &in target)'''
'''Назначение:''' Перемещает или переименовывает файл или директорию.

'''Аргументы:'''
*<code>source</code> – текущий путь к объекту.
*<code>target</code> – новый путь или имя объекта.
'''Возвращаемое значение:'''
*<code>0</code> – объект успешно перемещён/переименован.
*<code>-1</code> – ошибка операции (объект не существует, недостаточно прав).
'''Примечания:'''
*Может использоваться как для файлов, так и для директорий.
*На Windows используется <code>MoveFileW</code>, на POSIX – <code>rename</code>.
*Операция может выполняться в пределах одного тома/файловой системы.
'''datetime getCreateDateTime(const string &in path) const'''
'''Назначение:''' Возвращает дату и время создания файла или директории.

'''Аргументы:'''
*<code>path</code> – путь к объекту файловой системы.
'''Возвращаемое значение:'''
*Объект <code>datetime</code>, содержащий дату и время создания.
'''Примечания:'''
*'''Выбрасывает исключение''' в скриптовом контексте через <code>SetException</code>, если не удаётся получить дату создания.
*На Windows используется <code>GetFileTime</code> с полем <code>createTm</code>.
*На POSIX-системах используется поле <code>st_ctime</code> (change time) – может отличаться от реального времени создания на некоторых файловых системах.
'''datetime getModifyDateTime(const string &in path) const'''
'''Назначение:''' Возвращает дату и время последнего изменения файла или директории.

'''Аргументы:'''
*<code>path</code> – путь к объекту файловой системы.
'''Возвращаемое значение:'''
*Объект <code>datetime</code>, содержащий дату и время последней модификации.
'''Примечания:'''
*Выбрасывает исключение, если не удаётся получить дату изменения.
*На Windows используется <code>GetFileTime</code> с полем <code>modifyTm</code>.
*На POSIX-системах используется поле <code>st_mtime</code> (modify time).

[[Категория:AgavaSCADA/AgavaPLC]]

Класс datetime

2026-04-27T06:37:04Z

TaushkanovKV: Новая страница: «Класс доступен начиная с версии <code>AS 1.6+</code>. ==Конструкторы== ===Конструктор по умолчанию===...»

Класс file

2026-04-27T06:35:00Z

TaushkanovKV:

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

Класс доступен начиная с версии <code>AS 1.4.5</code>.

== Свойства ==
'''bool mostSignificantByteFirst'''
'''Назначение:''' Определяет порядок байтов (endianness) при чтении и записи числовых значений.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:''' Отсутствует (свойство).

'''Примечания:'''

* <code>true</code> – используется порядок '''Big-endian''' (старший байт первый).
* <code>false</code> (по умолчанию) – используется порядок '''Little-endian''' (младший байт первый).
* Влияет на методы <code>readInt</code>, <code>readUInt</code>, <code>readFloat</code>, <code>readDouble</code> и соответствующие методы записи.
* Может изменяться в любой момент до выполнения операций чтения/записи.

== Методы ==
'''int open(const string &in filename, const string &in mode)'''
'''Назначение:''' Открывает файл для чтения и/или записи.

'''Аргументы:'''

* <code>filename</code> – путь к файлу (относительный или абсолютный).
* <code>mode</code> – режим открытия файла:
** <code>"r"</code> – открыть для чтения (только чтение).
** <code>"w"</code> – открыть для записи (создаёт новый или перезаписывает существующий).
** <code>"a"</code> – открыть для добавления (запись в конец файла).

'''Возвращаемое значение:'''

* <code>0</code> – файл успешно открыт.
* <code>-1</code> – ошибка открытия (файл не существует, недостаточно прав, неверный режим).

'''Примечания:'''

* Перед открытием нового файла автоматически закрывает ранее открытый.
* На Windows автоматически добавляет флаг <code>"b"</code> (бинарный режим) для предотвращения преобразования <code>\r\n</code> в <code>\n</code>.
* На Windows CE пути преобразуются в абсолютные относительно директории приложения.
* Если режим не поддерживается (например, запись при <code>AS_WRITE_OPS == 0</code>), возвращает <code>-1</code>.

'''int close()'''
'''Назначение:''' Закрывает открытый файл.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* <code>0</code> – файл успешно закрыт.
* <code>-1</code> – файл уже был закрыт или не открыт.

'''Примечания:'''

* Автоматически вызывается в деструкторе объекта.
* После закрытия файла дальнейшие операции чтения/записи будут возвращать ошибки.

'''int getSize() const'''
'''Назначение:''' Возвращает размер файла в байтах.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Размер файла в байтах (тип <code>int</code>).
* <code>-1</code> – файл не открыт или произошла ошибка.

'''Примечания:'''

* Для определения размера сохраняет текущую позицию, перемещается в конец файла и возвращается обратно.

'''bool isEndOfFile() const'''
'''Назначение:''' Проверяет, достигнут ли конец файла.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* <code>true</code> – достигнут конец файла или файл не открыт.
* <code>false</code> – не достигнут конец файла.

'''Примечания:'''

* Использует стандартную функцию <code>feof()</code>.
* Возвращает <code>true</code>, если файл не открыт.

'''int getPos() const'''
'''Назначение:''' Возвращает текущую позицию в файле.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Текущая позиция в байтах от начала файла.
* <code>-1</code> – файл не открыт или произошла ошибка.

'''Примечания:'''

* Использует функцию <code>ftell()</code>.

'''int setPos(int pos)'''
'''Назначение:''' Устанавливает текущую позицию в файле от начала.

'''Аргументы:'''

* <code>pos</code> – абсолютная позиция в байтах от начала файла.

'''Возвращаемое значение:'''

* <code>0</code> – позиция успешно установлена.
* <code>-1</code> – файл не открыт или позиция вне допустимого диапазона.

'''Примечания:'''

* Использует функцию <code>fseek(SEEK_SET)</code>.

'''int movePos(int delta)'''
'''Назначение:''' Смещает текущую позицию в файле относительно текущего положения.

'''Аргументы:'''

* <code>delta</code> – смещение в байтах (положительное – вперёд, отрицательное – назад).

'''Возвращаемое значение:'''

* <code>0</code> – позиция успешно изменена.
* <code>-1</code> – файл не открыт или смещение выходит за границы.

'''Примечания:'''

* Использует функцию <code>fseek(SEEK_CUR)</code>.

'''string readString(uint length)'''
'''Назначение:''' Читает указанное количество символов из файла.

'''Аргументы:'''

* <code>length</code> – количество символов (байт) для чтения.

'''Возвращаемое значение:'''

* Строка с прочитанными данными (реальная длина может быть меньше <code>length</code>, если достигнут конец файла).
* Пустая строка – если файл не открыт.

'''Примечания:'''

* Возвращает все прочитанные байты как есть (включая нулевые символы).
* Размер результирующей строки соответствует количеству реально прочитанных байт.

'''string readLine()'''
'''Назначение:''' Читает одну строку из файла.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Строка, содержащая прочитанную строку (без символа <code>\n</code>).
* Пустая строка – если достигнут конец файла или файл не открыт.

'''Примечания:'''

* Читает до символа перевода строки (<code>\n</code>) или до заполнения внутреннего буфера (255 символов).
* Поддерживает чтение длинных строк – операция повторяется до обнаружения <code>\n</code> или конца файла.
* Символ <code>\n</code> не включается в результат.

'''int64 readInt(uint bytes)'''
'''Назначение:''' Читает знаковое целое число из файла.

'''Аргументы:'''

* <code>bytes</code> – количество байт для чтения (1–8). Если <code>bytes > 8</code>, используется 8.

'''Возвращаемое значение:'''

* Прочитанное целое число (тип <code>int64</code>).
* <code>0</code> – если файл не открыт или достигнут конец файла.

'''Примечания:'''

* Поддерживает автоматическое расширение знака (sign extension) для отрицательных чисел.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Младшие байты заполняются нулями, если <code>bytes < 8</code>.
* Для отрицательных чисел старшие байты заполняются <code>0xFF</code>.

'''uint64 readUInt(uint bytes)'''
'''Назначение:''' Читает беззнаковое целое число из файла.

'''Аргументы:'''

* <code>bytes</code> – количество байт для чтения (1–8). Если <code>bytes > 8</code>, используется 8.

'''Возвращаемое значение:'''

* Прочитанное беззнаковое целое число (тип <code>uint64</code>).
* <code>0</code> – если файл не открыт или достигнут конец файла.

'''Примечания:'''

* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Не выполняет расширение знака.
* Младшие байты заполняются нулями, если <code>bytes < 8</code>.

'''float readFloat()'''
'''Назначение:''' Читает число с плавающей точкой (32 бита) из файла.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Прочитанное число типа <code>float</code>.
* <code>0.0f</code> – если файл не открыт или достигнут конец файла.

'''Примечания:'''

* Читает ровно 4 байта.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Использует объединение (union) для битового преобразования.

'''double readDouble()'''
'''Назначение:''' Читает число с плавающей точкой двойной точности (64 бита) из файла.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Прочитанное число типа <code>double</code>.
* <code>0.0</code> – если файл не открыт или достигнут конец файла.

'''Примечания:'''

* Читает ровно 8 байт.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Использует объединение (union) для битового преобразования.

== Методы записи ==
'''int writeString(const string &in str)'''
'''Назначение:''' Записывает строку в файл.

'''Аргументы:'''

* <code>str</code> – строка для записи.

'''Возвращаемое значение:'''

* Количество записанных байт.
* <code>-1</code> – если файл не открыт.

'''Примечания:'''

* Записывает строку целиком, включая все символы (без завершающего нуля).

'''int writeInt(int64 val, uint bytes)'''
'''Назначение:''' Записывает знаковое целое число в файл.

'''Аргументы:'''

* <code>val</code> – значение для записи.
* <code>bytes</code> – количество байт для записи (1–8). Если <code>bytes > 8</code>, используется 8.

'''Возвращаемое значение:'''

* Количество записанных байт (0 или 1 в терминах <code>fwrite</code>).
* <code>0</code> – если файл не открыт.

'''Примечания:'''

* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Записываются только младшие <code>bytes</code> байт числа.

'''int writeUInt(uint64 val, uint bytes)'''
'''Назначение:''' Записывает беззнаковое целое число в файл.

'''Аргументы:'''

* <code>val</code> – значение для записи.
* <code>bytes</code> – количество байт для записи (1–8). Если <code>bytes > 8</code>, используется 8.

'''Возвращаемое значение:'''

* Количество записанных байт (0 или 1 в терминах <code>fwrite</code>).
* <code>0</code> – если файл не открыт.

'''Примечания:'''

* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Записываются только младшие <code>bytes</code> байт числа.

'''int writeFloat(float val)'''
'''Назначение:''' Записывает число с плавающей точкой (32 бита) в файл.

'''Аргументы:'''

* <code>val</code> – значение для записи.

'''Возвращаемое значение:'''

* Количество записанных байт (0 или 1 в терминах <code>fwrite</code>).
* <code>0</code> – если файл не открыт.

'''Примечания:'''

* Записывает ровно 4 байта.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.

'''int writeDouble(double val)'''
'''Назначение:''' Записывает число с плавающей точкой двойной точности (64 бита) в файл.

'''Аргументы:'''

* <code>val</code> – значение для записи.

'''Возвращаемое значение:'''

* Количество записанных байт (0 или 1 в терминах <code>fwrite</code>).
* <code>0</code> – если файл не открыт.

'''Примечания:'''

* Записывает ровно 8 байт.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.

== Пример использования ==
// Создание и открытие файла для записи
file f;
f.mostSignificantByteFirst = false; // Little-endian

int result = f.open("data.bin", "w");

if (result == 0)
{
f.writeString("Hello, World!");
f.writeInt(12345, 4);
f.writeFloat(3.14159f);
f.close();
}

// Открытие файла для чтения
file f2;
f2.mostSignificantByteFirst = false;
f2.open("data.bin", "r");

if (!f2.isEndOfFile())
{
string str = f2.readLine();
int64 num = f2.readInt(4);
float pi = f2.readFloat();
}

f2.close();

// Чтение бинарных данных с Big-endian порядком
file f3;
f3.mostSignificantByteFirst = true; // Network byte order
f3.open("network_data.bin", "r");
uint64 value = f3.readUInt(4); // Читает 4 байта как Big-endian

[[Категория:AgavaSCADA/AgavaPLC]]

Класс filesystem

2026-04-27T06:34:16Z

TaushkanovKV: Новая страница: «Класс предоставляет интерфейс для взаимодействия с файловой системой операционной сис...»

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

Класс доступен начиная с версии <code>AS 1.6+</code>.
==Методы==
'''bool changeCurrentPath(const string &in path)'''
'''Назначение:''' Изменяет текущую рабочую директорию.

'''Аргументы:'''
*<code>path</code> – путь к новой директории (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>true</code> – если путь существует и текущая директория успешно изменена.
*<code>false</code> – если указанный путь не существует или не является директорией.
'''Примечания:'''
*Если путь задан относительно, он объединяется с текущей директорией.
*Путь не должен содержать обратные слеши <code>\</code> – они автоматически заменяются на <code>/</code>.
*Завершающие слеши автоматически удаляются из пути.
*Не поддерживает разрешение внутренних ссылок <code>/./</code> и <code>/../</code>.
'''string getCurrentPath() const'''
'''Назначение:''' Возвращает текущую рабочую директорию.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''
*Строка с абсолютным путём текущей директории, использующая разделители <code>/</code>.
'''Примечания:'''
*При создании объекта <code>filesystem</code> текущая директория инициализируется рабочим каталогом приложения.
*Все обратные слеши <code>\</code> заменяются на <code>/</code> для единообразия.
'''array<string> @getDirs() const'''
'''Назначение:''' Получает список всех поддиректорий внутри текущей директории.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''
*Массив строк с именами поддиректорий.
'''Примечания:'''
*Специальные записи <code>.</code> (текущая директория) и <code>..</code> (родительская директория) исключаются из результата.
*Возвращает пустой массив, если директорий нет или произошла ошибка чтения.
'''array<string> @getFiles() const'''
'''Назначение:''' Получает список всех файлов внутри текущей директории.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''
*Массив строк с именами файлов.
'''Примечания:'''
*В результат включаются только файлы, директории исключаются.
*Возвращает пустой массив, если файлов нет или произошла ошибка чтения.
'''bool isDir(const string &in path) const'''
'''Назначение:''' Проверяет, является ли указанный путь директорией.

'''Аргументы:'''
*<code>path</code> – путь к объекту файловой системы (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>true</code> – если объект существует и является директорией.
*<code>false</code> – если объект не существует, не является директорией или произошла ошибка.
'''Примечания:'''
*Относительные пути разрешаются относительно текущей директории.
*Абсолютные пути определяются наличием двоеточия <code>:</code> (например, <code>C:</code>) или начального слеша <code>/</code> или <code>\</code>.
'''bool isLink(const string &in path) const'''
'''Назначение:''' Проверяет, является ли указанный путь символической ссылкой (symlink).

'''Аргументы:'''
*<code>path</code> – путь к объекту файловой системы (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>true</code> – если объект существует и является символической ссылкой (на Windows – репарс-точкой).
*<code>false</code> – если объект не является ссылкой, не существует или произошла ошибка.
'''Примечания:'''
*Кроссплатформенная поддержка: Windows (атрибут <code>FILE_ATTRIBUTE_REPARSE_POINT</code>) и POSIX (флаг <code>S_IFLNK</code>).
*Относительные пути разрешаются относительно текущей директории.
'''int64 getSize(const string &in path) const'''
'''Назначение:''' Возвращает размер файла в байтах.

'''Аргументы:'''
*<code>path</code> – путь к файлу (относительный или абсолютный).
'''Возвращаемое значение:'''
*Размер файла в байтах (тип <code>int64</code>).
*<code>-1</code> – если файл не существует, указан путь к директории или произошла ошибка.
'''Примечания:'''
*На Windows используется API-функция <code>GetFileSizeEx</code>.
*На POSIX-системах используется <code>stat</code>.
*Для директорий возвращает <code>-1</code>.
'''int makeDir(const string &in path)'''
'''Назначение:''' Создаёт новую директорию.

'''Аргументы:'''
*<code>path</code> – путь к создаваемой директории (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>0</code> – директория успешно создана.
*<code>-1</code> – ошибка создания (например, недостаточно прав, путь не существует).
'''Примечания:'''
*'''Важно:''' Не поддерживает рекурсивное создание промежуточных директорий (отмечено в TODO).
*На Windows создаёт директорию с правами по умолчанию.
*На POSIX создаёт с правами <code>S_IRWXU | S_IRWXG | S_IROTH | S_IXOTH</code> (755: чтение/запись/исполнение для владельца, чтение/исполнение для группы и остальных).
'''int removeDir(const string &in path)'''
'''Назначение:''' Удаляет пустую директорию.

'''Аргументы:'''
*<code>path</code> – путь к удаляемой директории (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>0</code> – директория успешно удалена.
*<code>-1</code> – ошибка удаления (директория не пуста, не существует, недостаточно прав).
'''Примечания:'''
*Удаляет только '''пустые''' директории.
*Не поддерживает рекурсивное удаление с содержимым.
*На Windows используется <code>RemoveDirectoryW</code>, на POSIX – <code>rmdir</code>.
'''int deleteFile(const string &in path)'''
'''Назначение:''' Удаляет файл.

'''Аргументы:'''
*<code>path</code> – путь к удаляемому файлу (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>0</code> – файл успешно удалён.
*<code>-1</code> – ошибка удаления (файл не существует, недостаточно прав, указана директория).
'''Примечания:'''
*На Windows используется <code>DeleteFileW</code>, на POSIX – <code>unlink</code>.
*Для удаления директорий используйте <code>removeDir</code>.
'''int copyFile(const string &in source, const string &in target)'''
'''Назначение:''' Копирует файл из одного местоположения в другое.

'''Аргументы:'''
*<code>source</code> – путь к исходному файлу.
*<code>target</code> – путь к целевому файлу (не директории).
'''Возвращаемое значение:'''
*<code>0</code> – файл успешно скопирован.
*<code>-1</code> – ошибка копирования (исходный файл не существует, недостаточно прав, целевой файл уже существует).
'''Примечания:'''
*На Windows используется API-функция <code>CopyFileW</code> с параметром <code>TRUE</code> (не перезаписывать существующий файл).
*На POSIX-системах копирование выполняется '''вручную''' побайтово через <code>fopen/fread/fwrite</code>, так как стандартной функции копирования нет.
*Целевой файл не должен существовать (флаг <code>TRUE</code> на Windows).
'''int move(const string &in source, const string &in target)'''
'''Назначение:''' Перемещает или переименовывает файл или директорию.

'''Аргументы:'''
*<code>source</code> – текущий путь к объекту.
*<code>target</code> – новый путь или имя объекта.
'''Возвращаемое значение:'''
*<code>0</code> – объект успешно перемещён/переименован.
*<code>-1</code> – ошибка операции (объект не существует, недостаточно прав).
'''Примечания:'''
*Может использоваться как для файлов, так и для директорий.
*На Windows используется <code>MoveFileW</code>, на POSIX – <code>rename</code>.
*Операция может выполняться в пределах одного тома/файловой системы.
'''datetime getCreateDateTime(const string &in path) const'''
'''Назначение:''' Возвращает дату и время создания файла или директории.

'''Аргументы:'''
*<code>path</code> – путь к объекту файловой системы.
'''Возвращаемое значение:'''
*Объект <code>datetime</code>, содержащий дату и время создания.
'''Примечания:'''
*'''Выбрасывает исключение''' в скриптовом контексте через <code>SetException</code>, если не удаётся получить дату создания.
*На Windows используется <code>GetFileTime</code> с полем <code>createTm</code>.
*На POSIX-системах используется поле <code>st_ctime</code> (change time) – может отличаться от реального времени создания на некоторых файловых системах.
'''datetime getModifyDateTime(const string &in path) const'''
'''Назначение:''' Возвращает дату и время последнего изменения файла или директории.

'''Аргументы:'''
*<code>path</code> – путь к объекту файловой системы.
'''Возвращаемое значение:'''
*Объект <code>datetime</code>, содержащий дату и время последней модификации.
'''Примечания:'''
*Выбрасывает исключение, если не удаётся получить дату изменения.
*На Windows используется <code>GetFileTime</code> с полем <code>modifyTm</code>.
*На POSIX-системах используется поле <code>st_mtime</code> (modify time).

Класс file

2026-04-27T06:29:43Z

TaushkanovKV:

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

== Свойства ==
'''bool mostSignificantByteFirst'''
'''Назначение:''' Определяет порядок байтов (endianness) при чтении и записи числовых значений.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:''' Отсутствует (свойство).

'''Примечания:'''

* <code>true</code> – используется порядок '''Big-endian''' (старший байт первый).
* <code>false</code> (по умолчанию) – используется порядок '''Little-endian''' (младший байт первый).
* Влияет на методы <code>readInt</code>, <code>readUInt</code>, <code>readFloat</code>, <code>readDouble</code> и соответствующие методы записи.
* Может изменяться в любой момент до выполнения операций чтения/записи.

== Методы ==
'''int open(const string &in filename, const string &in mode)'''
'''Назначение:''' Открывает файл для чтения и/или записи.

'''Аргументы:'''

* <code>filename</code> – путь к файлу (относительный или абсолютный).
* <code>mode</code> – режим открытия файла:
** <code>"r"</code> – открыть для чтения (только чтение).
** <code>"w"</code> – открыть для записи (создаёт новый или перезаписывает существующий).
** <code>"a"</code> – открыть для добавления (запись в конец файла).

'''Возвращаемое значение:'''

* <code>0</code> – файл успешно открыт.
* <code>-1</code> – ошибка открытия (файл не существует, недостаточно прав, неверный режим).

'''Примечания:'''

* Перед открытием нового файла автоматически закрывает ранее открытый.
* На Windows автоматически добавляет флаг <code>"b"</code> (бинарный режим) для предотвращения преобразования <code>\r\n</code> в <code>\n</code>.
* На Windows CE пути преобразуются в абсолютные относительно директории приложения.
* Если режим не поддерживается (например, запись при <code>AS_WRITE_OPS == 0</code>), возвращает <code>-1</code>.

'''int close()'''
'''Назначение:''' Закрывает открытый файл.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* <code>0</code> – файл успешно закрыт.
* <code>-1</code> – файл уже был закрыт или не открыт.

'''Примечания:'''

* Автоматически вызывается в деструкторе объекта.
* После закрытия файла дальнейшие операции чтения/записи будут возвращать ошибки.

'''int getSize() const'''
'''Назначение:''' Возвращает размер файла в байтах.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Размер файла в байтах (тип <code>int</code>).
* <code>-1</code> – файл не открыт или произошла ошибка.

'''Примечания:'''

* Для определения размера сохраняет текущую позицию, перемещается в конец файла и возвращается обратно.

'''bool isEndOfFile() const'''
'''Назначение:''' Проверяет, достигнут ли конец файла.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* <code>true</code> – достигнут конец файла или файл не открыт.
* <code>false</code> – не достигнут конец файла.

'''Примечания:'''

* Использует стандартную функцию <code>feof()</code>.
* Возвращает <code>true</code>, если файл не открыт.

'''int getPos() const'''
'''Назначение:''' Возвращает текущую позицию в файле.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Текущая позиция в байтах от начала файла.
* <code>-1</code> – файл не открыт или произошла ошибка.

'''Примечания:'''

* Использует функцию <code>ftell()</code>.

'''int setPos(int pos)'''
'''Назначение:''' Устанавливает текущую позицию в файле от начала.

'''Аргументы:'''

* <code>pos</code> – абсолютная позиция в байтах от начала файла.

'''Возвращаемое значение:'''

* <code>0</code> – позиция успешно установлена.
* <code>-1</code> – файл не открыт или позиция вне допустимого диапазона.

'''Примечания:'''

* Использует функцию <code>fseek(SEEK_SET)</code>.

'''int movePos(int delta)'''
'''Назначение:''' Смещает текущую позицию в файле относительно текущего положения.

'''Аргументы:'''

* <code>delta</code> – смещение в байтах (положительное – вперёд, отрицательное – назад).

'''Возвращаемое значение:'''

* <code>0</code> – позиция успешно изменена.
* <code>-1</code> – файл не открыт или смещение выходит за границы.

'''Примечания:'''

* Использует функцию <code>fseek(SEEK_CUR)</code>.

'''string readString(uint length)'''
'''Назначение:''' Читает указанное количество символов из файла.

'''Аргументы:'''

* <code>length</code> – количество символов (байт) для чтения.

'''Возвращаемое значение:'''

* Строка с прочитанными данными (реальная длина может быть меньше <code>length</code>, если достигнут конец файла).
* Пустая строка – если файл не открыт.

'''Примечания:'''

* Возвращает все прочитанные байты как есть (включая нулевые символы).
* Размер результирующей строки соответствует количеству реально прочитанных байт.

'''string readLine()'''
'''Назначение:''' Читает одну строку из файла.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Строка, содержащая прочитанную строку (без символа <code>\n</code>).
* Пустая строка – если достигнут конец файла или файл не открыт.

'''Примечания:'''

* Читает до символа перевода строки (<code>\n</code>) или до заполнения внутреннего буфера (255 символов).
* Поддерживает чтение длинных строк – операция повторяется до обнаружения <code>\n</code> или конца файла.
* Символ <code>\n</code> не включается в результат.

'''int64 readInt(uint bytes)'''
'''Назначение:''' Читает знаковое целое число из файла.

'''Аргументы:'''

* <code>bytes</code> – количество байт для чтения (1–8). Если <code>bytes > 8</code>, используется 8.

'''Возвращаемое значение:'''

* Прочитанное целое число (тип <code>int64</code>).
* <code>0</code> – если файл не открыт или достигнут конец файла.

'''Примечания:'''

* Поддерживает автоматическое расширение знака (sign extension) для отрицательных чисел.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Младшие байты заполняются нулями, если <code>bytes < 8</code>.
* Для отрицательных чисел старшие байты заполняются <code>0xFF</code>.

'''uint64 readUInt(uint bytes)'''
'''Назначение:''' Читает беззнаковое целое число из файла.

'''Аргументы:'''

* <code>bytes</code> – количество байт для чтения (1–8). Если <code>bytes > 8</code>, используется 8.

'''Возвращаемое значение:'''

* Прочитанное беззнаковое целое число (тип <code>uint64</code>).
* <code>0</code> – если файл не открыт или достигнут конец файла.

'''Примечания:'''

* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Не выполняет расширение знака.
* Младшие байты заполняются нулями, если <code>bytes < 8</code>.

'''float readFloat()'''
'''Назначение:''' Читает число с плавающей точкой (32 бита) из файла.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Прочитанное число типа <code>float</code>.
* <code>0.0f</code> – если файл не открыт или достигнут конец файла.

'''Примечания:'''

* Читает ровно 4 байта.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Использует объединение (union) для битового преобразования.

'''double readDouble()'''
'''Назначение:''' Читает число с плавающей точкой двойной точности (64 бита) из файла.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Прочитанное число типа <code>double</code>.
* <code>0.0</code> – если файл не открыт или достигнут конец файла.

'''Примечания:'''

* Читает ровно 8 байт.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Использует объединение (union) для битового преобразования.

== Методы записи ==
'''int writeString(const string &in str)'''
'''Назначение:''' Записывает строку в файл.

'''Аргументы:'''

* <code>str</code> – строка для записи.

'''Возвращаемое значение:'''

* Количество записанных байт.
* <code>-1</code> – если файл не открыт.

'''Примечания:'''

* Записывает строку целиком, включая все символы (без завершающего нуля).

'''int writeInt(int64 val, uint bytes)'''
'''Назначение:''' Записывает знаковое целое число в файл.

'''Аргументы:'''

* <code>val</code> – значение для записи.
* <code>bytes</code> – количество байт для записи (1–8). Если <code>bytes > 8</code>, используется 8.

'''Возвращаемое значение:'''

* Количество записанных байт (0 или 1 в терминах <code>fwrite</code>).
* <code>0</code> – если файл не открыт.

'''Примечания:'''

* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Записываются только младшие <code>bytes</code> байт числа.

'''int writeUInt(uint64 val, uint bytes)'''
'''Назначение:''' Записывает беззнаковое целое число в файл.

'''Аргументы:'''

* <code>val</code> – значение для записи.
* <code>bytes</code> – количество байт для записи (1–8). Если <code>bytes > 8</code>, используется 8.

'''Возвращаемое значение:'''

* Количество записанных байт (0 или 1 в терминах <code>fwrite</code>).
* <code>0</code> – если файл не открыт.

'''Примечания:'''

* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Записываются только младшие <code>bytes</code> байт числа.

'''int writeFloat(float val)'''
'''Назначение:''' Записывает число с плавающей точкой (32 бита) в файл.

'''Аргументы:'''

* <code>val</code> – значение для записи.

'''Возвращаемое значение:'''

* Количество записанных байт (0 или 1 в терминах <code>fwrite</code>).
* <code>0</code> – если файл не открыт.

'''Примечания:'''

* Записывает ровно 4 байта.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.

'''int writeDouble(double val)'''
'''Назначение:''' Записывает число с плавающей точкой двойной точности (64 бита) в файл.

'''Аргументы:'''

* <code>val</code> – значение для записи.

'''Возвращаемое значение:'''

* Количество записанных байт (0 или 1 в терминах <code>fwrite</code>).
* <code>0</code> – если файл не открыт.

'''Примечания:'''

* Записывает ровно 8 байт.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.

== Пример использования ==
// Создание и открытие файла для записи
file f;
f.mostSignificantByteFirst = false; // Little-endian

int result = f.open("data.bin", "w");

if (result == 0)
{
f.writeString("Hello, World!");
f.writeInt(12345, 4);
f.writeFloat(3.14159f);
f.close();
}

// Открытие файла для чтения
file f2;
f2.mostSignificantByteFirst = false;
f2.open("data.bin", "r");

if (!f2.isEndOfFile())
{
string str = f2.readLine();
int64 num = f2.readInt(4);
float pi = f2.readFloat();
}

f2.close();

// Чтение бинарных данных с Big-endian порядком
file f3;
f3.mostSignificantByteFirst = true; // Network byte order
f3.open("network_data.bin", "r");
uint64 value = f3.readUInt(4); // Читает 4 байта как Big-endian

[[Категория:AgavaSCADA/AgavaPLC]]

Класс file

2026-04-27T06:29:01Z

TaushkanovKV: Новая страница: «Класс предоставляет интерфейс для работы с файлами: открытие, закрытие, чтение и запись...»

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

== Свойства ==
'''bool mostSignificantByteFirst'''
'''Назначение:''' Определяет порядок байтов (endianness) при чтении и записи числовых значений.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:''' Отсутствует (свойство).

'''Примечания:'''

* <code>true</code> – используется порядок '''Big-endian''' (старший байт первый).
* <code>false</code> (по умолчанию) – используется порядок '''Little-endian''' (младший байт первый).
* Влияет на методы <code>readInt</code>, <code>readUInt</code>, <code>readFloat</code>, <code>readDouble</code> и соответствующие методы записи.
* Может изменяться в любой момент до выполнения операций чтения/записи.

== Методы ==
'''int open(const string &in filename, const string &in mode)'''
'''Назначение:''' Открывает файл для чтения и/или записи.

'''Аргументы:'''

* <code>filename</code> – путь к файлу (относительный или абсолютный).
* <code>mode</code> – режим открытия файла:
** <code>"r"</code> – открыть для чтения (только чтение).
** <code>"w"</code> – открыть для записи (создаёт новый или перезаписывает существующий).
** <code>"a"</code> – открыть для добавления (запись в конец файла).

'''Возвращаемое значение:'''

* <code>0</code> – файл успешно открыт.
* <code>-1</code> – ошибка открытия (файл не существует, недостаточно прав, неверный режим).

'''Примечания:'''

* Перед открытием нового файла автоматически закрывает ранее открытый.
* На Windows автоматически добавляет флаг <code>"b"</code> (бинарный режим) для предотвращения преобразования <code>\r\n</code> в <code>\n</code>.
* На Windows CE пути преобразуются в абсолютные относительно директории приложения.
* Если режим не поддерживается (например, запись при <code>AS_WRITE_OPS == 0</code>), возвращает <code>-1</code>.

'''int close()'''
'''Назначение:''' Закрывает открытый файл.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* <code>0</code> – файл успешно закрыт.
* <code>-1</code> – файл уже был закрыт или не открыт.

'''Примечания:'''

* Автоматически вызывается в деструкторе объекта.
* После закрытия файла дальнейшие операции чтения/записи будут возвращать ошибки.

'''int getSize() const'''
'''Назначение:''' Возвращает размер файла в байтах.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Размер файла в байтах (тип <code>int</code>).
* <code>-1</code> – файл не открыт или произошла ошибка.

'''Примечания:'''

* Для определения размера сохраняет текущую позицию, перемещается в конец файла и возвращается обратно.

'''bool isEndOfFile() const'''
'''Назначение:''' Проверяет, достигнут ли конец файла.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* <code>true</code> – достигнут конец файла или файл не открыт.
* <code>false</code> – не достигнут конец файла.

'''Примечания:'''

* Использует стандартную функцию <code>feof()</code>.
* Возвращает <code>true</code>, если файл не открыт.

'''int getPos() const'''
'''Назначение:''' Возвращает текущую позицию в файле.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Текущая позиция в байтах от начала файла.
* <code>-1</code> – файл не открыт или произошла ошибка.

'''Примечания:'''

* Использует функцию <code>ftell()</code>.

'''int setPos(int pos)'''
'''Назначение:''' Устанавливает текущую позицию в файле от начала.

'''Аргументы:'''

* <code>pos</code> – абсолютная позиция в байтах от начала файла.

'''Возвращаемое значение:'''

* <code>0</code> – позиция успешно установлена.
* <code>-1</code> – файл не открыт или позиция вне допустимого диапазона.

'''Примечания:'''

* Использует функцию <code>fseek(SEEK_SET)</code>.

'''int movePos(int delta)'''
'''Назначение:''' Смещает текущую позицию в файле относительно текущего положения.

'''Аргументы:'''

* <code>delta</code> – смещение в байтах (положительное – вперёд, отрицательное – назад).

'''Возвращаемое значение:'''

* <code>0</code> – позиция успешно изменена.
* <code>-1</code> – файл не открыт или смещение выходит за границы.

'''Примечания:'''

* Использует функцию <code>fseek(SEEK_CUR)</code>.

'''string readString(uint length)'''
'''Назначение:''' Читает указанное количество символов из файла.

'''Аргументы:'''

* <code>length</code> – количество символов (байт) для чтения.

'''Возвращаемое значение:'''

* Строка с прочитанными данными (реальная длина может быть меньше <code>length</code>, если достигнут конец файла).
* Пустая строка – если файл не открыт.

'''Примечания:'''

* Возвращает все прочитанные байты как есть (включая нулевые символы).
* Размер результирующей строки соответствует количеству реально прочитанных байт.

'''string readLine()'''
'''Назначение:''' Читает одну строку из файла.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Строка, содержащая прочитанную строку (без символа <code>\n</code>).
* Пустая строка – если достигнут конец файла или файл не открыт.

'''Примечания:'''

* Читает до символа перевода строки (<code>\n</code>) или до заполнения внутреннего буфера (255 символов).
* Поддерживает чтение длинных строк – операция повторяется до обнаружения <code>\n</code> или конца файла.
* Символ <code>\n</code> не включается в результат.

'''int64 readInt(uint bytes)'''
'''Назначение:''' Читает знаковое целое число из файла.

'''Аргументы:'''

* <code>bytes</code> – количество байт для чтения (1–8). Если <code>bytes > 8</code>, используется 8.

'''Возвращаемое значение:'''

* Прочитанное целое число (тип <code>int64</code>).
* <code>0</code> – если файл не открыт или достигнут конец файла.

'''Примечания:'''

* Поддерживает автоматическое расширение знака (sign extension) для отрицательных чисел.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Младшие байты заполняются нулями, если <code>bytes < 8</code>.
* Для отрицательных чисел старшие байты заполняются <code>0xFF</code>.

'''uint64 readUInt(uint bytes)'''
'''Назначение:''' Читает беззнаковое целое число из файла.

'''Аргументы:'''

* <code>bytes</code> – количество байт для чтения (1–8). Если <code>bytes > 8</code>, используется 8.

'''Возвращаемое значение:'''

* Прочитанное беззнаковое целое число (тип <code>uint64</code>).
* <code>0</code> – если файл не открыт или достигнут конец файла.

'''Примечания:'''

* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Не выполняет расширение знака.
* Младшие байты заполняются нулями, если <code>bytes < 8</code>.

'''float readFloat()'''
'''Назначение:''' Читает число с плавающей точкой (32 бита) из файла.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Прочитанное число типа <code>float</code>.
* <code>0.0f</code> – если файл не открыт или достигнут конец файла.

'''Примечания:'''

* Читает ровно 4 байта.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Использует объединение (union) для битового преобразования.

'''double readDouble()'''
'''Назначение:''' Читает число с плавающей точкой двойной точности (64 бита) из файла.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Прочитанное число типа <code>double</code>.
* <code>0.0</code> – если файл не открыт или достигнут конец файла.

'''Примечания:'''

* Читает ровно 8 байт.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Использует объединение (union) для битового преобразования.

== Методы записи ==
'''int writeString(const string &in str)'''
'''Назначение:''' Записывает строку в файл.

'''Аргументы:'''

* <code>str</code> – строка для записи.

'''Возвращаемое значение:'''

* Количество записанных байт.
* <code>-1</code> – если файл не открыт.

'''Примечания:'''

* Записывает строку целиком, включая все символы (без завершающего нуля).

'''int writeInt(int64 val, uint bytes)'''
'''Назначение:''' Записывает знаковое целое число в файл.

'''Аргументы:'''

* <code>val</code> – значение для записи.
* <code>bytes</code> – количество байт для записи (1–8). Если <code>bytes > 8</code>, используется 8.

'''Возвращаемое значение:'''

* Количество записанных байт (0 или 1 в терминах <code>fwrite</code>).
* <code>0</code> – если файл не открыт.

'''Примечания:'''

* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Записываются только младшие <code>bytes</code> байт числа.

'''int writeUInt(uint64 val, uint bytes)'''
'''Назначение:''' Записывает беззнаковое целое число в файл.

'''Аргументы:'''

* <code>val</code> – значение для записи.
* <code>bytes</code> – количество байт для записи (1–8). Если <code>bytes > 8</code>, используется 8.

'''Возвращаемое значение:'''

* Количество записанных байт (0 или 1 в терминах <code>fwrite</code>).
* <code>0</code> – если файл не открыт.

'''Примечания:'''

* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Записываются только младшие <code>bytes</code> байт числа.

'''int writeFloat(float val)'''
'''Назначение:''' Записывает число с плавающей точкой (32 бита) в файл.

'''Аргументы:'''

* <code>val</code> – значение для записи.

'''Возвращаемое значение:'''

* Количество записанных байт (0 или 1 в терминах <code>fwrite</code>).
* <code>0</code> – если файл не открыт.

'''Примечания:'''

* Записывает ровно 4 байта.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.

'''int writeDouble(double val)'''
'''Назначение:''' Записывает число с плавающей точкой двойной точности (64 бита) в файл.

'''Аргументы:'''

* <code>val</code> – значение для записи.

'''Возвращаемое значение:'''

* Количество записанных байт (0 или 1 в терминах <code>fwrite</code>).
* <code>0</code> – если файл не открыт.

'''Примечания:'''

* Записывает ровно 8 байт.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.

== Пример использования ==
// Создание и открытие файла для записи
file f;
f.mostSignificantByteFirst = false; // Little-endian

int result = f.open("data.bin", "w");

if (result == 0)
{
f.writeString("Hello, World!");
f.writeInt(12345, 4);
f.writeFloat(3.14159f);
f.close();
}

// Открытие файла для чтения
file f2;
f2.mostSignificantByteFirst = false;
f2.open("data.bin", "r");

if (!f2.isEndOfFile())
{
string str = f2.readLine();
int64 num = f2.readInt(4);
float pi = f2.readFloat();
}

f2.close();

// Чтение бинарных данных с Big-endian порядком
file f3;
f3.mostSignificantByteFirst = true; // Network byte order
f3.open("network_data.bin", "r");
uint64 value = f3.readUInt(4); // Читает 4 байта как Big-endian

Описание языка С++ в AgavaSCADA/AgavaPLC

2026-04-27T06:19:12Z

TaushkanovKV: /* Класс filesystem */

Данное описание содержит базовое руководство по созданию программ на языке С++ и их использовании в [[Универсальная среда разработки|среде разработки Agava]].

== Дополнительные документы ==

* [[Описание базовых классов AgavaSCADA/AgavaPLC]].
* [[Объектная модель AgavaSCADA/AgavaPLC]].

== Основы синтаксиса ==
Все программы на языке С++ состоят из отдельных действий. Каждое действие заканчивается точкой с запятой:
int x;
x = 1;
int y = x + 2;
Для повышения удобства работы с кодом можно оставлять в нем комментарии, которые не используются при работе программы и предназначены для улучшения читаемости кода. Перед комментариями ставится «//»:
bool x = true;
// bool x = false;
// вторая строка не будет выполняться в программе

== Переменные ==
Переменные – объекты, хранящиеся в памяти, над которыми и производятся действия в программе.

Для начала работы с переменной необходимо инициализировать ее, указав тип и имя, а затем, при необходимости, присвоить ей значение:
bool a = true;
int b = 1;
double c = 1.1;
string d = “строка”;

int f; // переменная инициализирована, значение не присвоено
f = 1; // присвоение значения
Ключевое слово auto при инициализации переменной может использоваться вместо типа переменной, для автоматического присвоения типа переменной исходя из инициализируемого значения.
auto a = true;
auto b = 1;

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

При работе со строками доступны следующие функции:
{| class="wikitable"
!Функция
!Действие
|-
|uint length()
|Возвращает длину строки
|-
|void resize(uint)
|Устанавливает длину строки
|-
|bool isEmpty()
|Возвращает истину, если строка пуста, т. е. длина равна нулю
|-
|string substr(uint start = 0, int count = -1)
|Возвращает строку с содержимым, начинающимся с start, и количеством байтов, заданным параметром count. Аргументы по умолчанию вернут всю строку как новую строку
|-
|void insert(uint pos, const string &in other)
|Вставляет другую строку string на позиции pos в исходной строке
|-
|void erase(uint pos, int count = -1)
|Удаляет количество символов count из строки, начиная с позиции pos
|-
|int findFirst(const string &in str, uint start = 0)
|Находит первое вхождение значения str в строке, начиная с символа под номером start. Если вхождения не найдено, будет возвращено отрицательное значение
|-
|int findFirstOf(const string &in str, uint start = 0)
|Находит первое вхождение одного из символов в str в строке, начиная с символа под номером start. Если вхождения не найдено, будет возвращено отрицательное значение
|-
|int findLast(const string &in str, int start = -1)
|Находит последнее вхождение значения str в строке
|-
|int findLastOf(const string &in str, int start = -1)
|Находит последнее вхождение одного из символов в str в строке, начиная с символа под номером start. Если вхождения не найдено, будет возвращено отрицательное значение
|-
|string formatInt(int64 val, const string &in options = "", uint width=0)
|Преобразование int в строку
|-
|string formatUInt(uint64 val, const string &in options = "", uint width=0)
|Преобразование uint в строку
|-
|string formatFloat(double val, const string &in options="", uint width=0, uint precision=0)
|Преобразование float и double в строку
|-
|int64 parseInt(const string &in str, uint base=10, uint &out byteCount=0)
|Преобразование строки в int64
|-
|uint64 parseUInt(const string &in str, uint base=10, uint &out byteCount=0)
|Преобразование строки в uint64
|-
|double parseFloat(const string &in str, uint &out byteCount=0)
|Преобразование строки в double
|}
Пример работы с функциями для строк:
string str = “ABCDEF”; // инициализирована строка str

int a = str.length(); // a равно 6
int b = str.findFirst(“CD”, 0); // b равно 2

str.erase(1, 3); // str равно “AEF”

string str = "НАСОС1";
string substrToRemove = "НАСОС";

int pos = str.findFirst(substrToRemove);

if (pos >= 0)
{
str.erase(pos, substrToRemove.length()); // Теперь str содержит "1"
}

=== Массивы ===
Массив — многоэлементный тип данных, который позволяет получить доступ ко всем переменным одного и того же типа данных через использование одного идентификатора. Используется в том случае, если вам необходимо сгруппировать несколько элементов одного типа:
array <int> a = {2, 5, 10, 15, 20}; // инициализирован массив a с пятью элементами
int x = a [0]; // x становится равен элементу массива а под номером 0 (2)
int y = a [4]; // y становится равен элементу массива а под номером 4 (20)
arr [3] = 11; // элемент массива а под номером 3 становится равен 11
int z = arr [3]; // z становится равен элементу массива а под номером 3 (11)
Важно помнить, что нумерация членов массива начинается с 0.

При работе с массивами доступны следующие функции:
{| class="wikitable"
!Функция
!Действие
|-
|length()
|Возвращает длину массива
|-
|resize(uint)
|Устанавливает новую длину массива
|-
|reverse()
|Меняет порядок элементов в массиве на обратный
|-
|insertAt(uint index, const T& in value)
|Вставляет новый элемент в массив по указанному индексу
|-
|insertLast(const T& in)
|Добавляет элемент в конец массива
|-
|removeAt(uint index)
|Удаляет элемент по указанному индексу
|-
|removeLast()
|Удаляет последний элемент массива
|-
|removeRange(uint start, uint count)
|Удаляет количество элементов count, начиная с элемента номер start
|-
|sortAsc ()
|Сортирует элементы в массиве в порядке возрастания
|-
|sortDesc ()
|Сортирует элементы в массиве в порядке убывания
|-
|find (const T &in)
|Возвращает индекс первого элемента, который имеет то же значение, что и желаемое. Если совпадений не найдено, возвращает отрицательное значение
|}
Пример работы с функциями для массивов:
int main()
{
array<int> arr = {1,2,3}; // 1,2,3
arr.insertLast(0); // 1,2,3,0
arr.insertAt(2,4); // 1,2,4,3,0
arr.removeAt(1); // 1,4,3,0
arr.sortAsc(); // 0,1,3,4
int sum = 0;

for( uint n = 0; n < arr.length(); n++ )
sum += arr[n];

return sum;
}

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

Значения перечислений объявляются путем их объявления в операторе перечисления. Если для константы перечисления не указано конкретное значение, она будет принимать значение предыдущей константы плюс 1. Первая константа получит значение 0, если не указано иное.
enum Errors
{
 NoError, // = 0
 ReadError = 2, // = 2
 WriteError, // = 3
}

// теперь к константам перечисления можно обращаться через текстовое значение, например
// int a = NoError;

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

Логические переменные
{| class="wikitable"
!Тип
!Мин. значение
!Макс. значение
|-
|bool
|false (0)
|true (1)
|}
Целочисленные переменные
{| class="wikitable"
!Тип
!Мин. значение
!Макс. значение
|-
|int8
|<nowiki>- 128</nowiki>
|127
|-
|int16
|<nowiki>- 32 768</nowiki>
|32 767
|-
|int
|<nowiki>- 2 147 483 648</nowiki>
|2 147 483 647
|-
|int64
|<nowiki>- 9 223 372 036 854 775 808</nowiki>
|9 223 372 036 854 775 807
|-
|uint8
|0
|255
|-
|uint16
|0
|65 535
|-
|uint
|0
|4 294 967 295
|-
|uint64
|0
|18 446 744 073 709 551 615
|}
Переменные с плавающей запятой
{| class="wikitable"
!Тип
!Диапазон значений
!Наименьшее значение
|-
|float
|± 3.402823466 e+38
|1.175494351 e-38
|-
|double
|± 1.79769313486231 e+308
|2.22507385850720 e-308
|}

== Операторы ==
Доступны операторы сравнения, логические, побитовые, арифметические, приращений и индексации.

=== Операторы сравнения ===
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Равно
|==
|x == y
|true, если x равно y
|-
|Не равно
|!=
|x != y
|true, если x не равно y
|-
|Меньше
|<
|x < y
|true, если x меньше y
|-
|Больше
|>
|x > y
|true, если x больше y
|-
|Меньше или равно
|<=
|x <= y
|true, если x меньше или равно y
|-
|Больше или равно
|>=
|x >= y
|true, если x больше или равно y
|}

=== Логические операторы ===
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Логическое НЕ
|!
|!x
|true, если x – false и false, если x – true
|-
|Логическое И
|&&
|x && y
|true, если x и y – true, в противном случае – false
|-
|Логическое ИЛИ
|<nowiki>||</nowiki>
|<nowiki>x || y</nowiki>
|true, если x или y – true, в противном случае – false
|-
|Логическое ИСКЛЮЧАЮЩЕЕ ИЛИ (XOR)
|^
|x ^ y
|true, если x или y – true (но не одновременно), в противном случае – false
|}

=== Побитовые операторы ===
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Побитовое И
|&
|x & y
|Каждый бит в x И каждый соответствующий ему бит в y
|-
|Побитовое ИЛИ
|<nowiki>|</nowiki>
|<nowiki>x | y</nowiki>
|Каждый бит в x ИЛИ каждый соответствующий ему бит в y
|-
|Побитовое ИСКЛЮЧАЮЩЕЕ ИЛИ (XOR)
|^
|x ^ y
|Каждый бит в x XOR с каждым соответствующим ему битом в y
|-
|Побитовый сдвиг влево
|<<
|x << y
|Все биты в x смещаются влево на y бит
|-
|Побитовый сдвиг вправо
|>>
|x >> y
|Все биты в x смещаются вправо на y бит
|}
'''Пример'''
float RegistersToFloat(uint16 r0, uint16 r1)
{
// Создаем массив байтов в little-endian порядке
array<uint8> bytes(4);

// Little-endian (наиболее распространенный)
bytes[0] = r0 & 0xFF;
bytes[1] = (r0 >> 8) & 0xFF;
bytes[2] = r1 & 0xFF;
bytes[3] = (r1 >> 8) & 0xFF;

 // Преобразуем байты в uint32, затем в float
uint32 resultBits = 0;

for (uint i = 0; i < 4; i++)
{
resultBits |= uint32(bytes[i]) << (i * 8);
}

return fpFromIEEE(resultBits);
}

=== Арифметические операторы ===
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Сложение
|<nowiki>+</nowiki>
|x + y
|Складываем x и y
|-
|Вычитание
|<nowiki>-</nowiki>
|x – y
|Вычитаем y из x
|-
|Умножение
|*
|x * y
|Умножаем x на y
|-
|Деление
|/
|x / y
|Делим x на y
|-
|Присваивание
|=
|x = y
|Присваиваем значение y переменной x
|-
|Сложение с присваиванием
|<nowiki>+=</nowiki>
|x += y
|Добавляем y к x
|-
|Вычитание с присваиванием
|<nowiki>-=</nowiki>
|x -= y
|Вычитаем y из x
|-
|Умножение с присваиванием
|*=
|x *= y
|Умножаем x на y
|-
|Деление с присваиванием
|/=
|x /= y
|Делим x на y
|}

=== Операторы приращений ===
Операция инкремента увеличивает значение на 1, декремента – уменьшает на 1.
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Преинкремент
|<nowiki>++</nowiki>
|<nowiki>++х</nowiki>
|Инкремент х, затем вычисление х
|-
|Предекремент
|<nowiki>--</nowiki>
|<nowiki>--х</nowiki>
|Декремент х, затем вычисление х
|-
|Постинкремент
|<nowiki>++</nowiki>
|х++
|Вычисление х, затем инкремент х
|-
|Постдекремент
|<nowiki>--</nowiki>
|х--
|Вычисление х, затем декремент х
|}

=== Оператор индексации ===
Используется для доступа к элементу.
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Индексация
|[ ]
|arr [0]
|Обращение к нулевому элементу массива arr
|}

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

Внешние блоки не имеют доступа к переменным внутренних блоков.
{
 int a;
 float b;
 {
 float a = 1.0; // Отменить объявление внешней переменной
// но только в пределах внутреннего блока
 b = a; // переменные из внешних блоков все еще доступны
 int c;
 }

 // a снова становится целочисленной переменной, b теперь равна 1.0, c здесь недоступна
}

== Условия ==

=== Операторы if/else ===
Позволяют выбрать выполнение нужных действий, в зависимости от выбранного условия, указанного в скобках:
if (x == 1)
{
// эти действия выполнятся, если х равно 1
}
else
{
// эти действия выполнятся, если х не равно 1
}

=== Условное выражение (тернарный оператор) ===
Более короткая запись оператора выбора if/else:
x = 1 ? y = true : y = false; // если х равно 1, тогда y равен true, иначе y равен false

=== Оператор switch ===
Является альтернативой if/else для тех случаев, когда необходимо сделать множественный выбор:
switch(x)
{
case 0:
 // эти действия выполнятся, если х равно 0
 break; // каждый case всегда должен заканчивать оператором break
case 1:
 // эти действия выполнятся, если х равно 1
 break;
case 2:
 // эти действия выполнятся, если х равно 2
 break;
default:
 // Эти действия выполнятся, если x не равен ни одному из предыдущих значений case
}

== Циклы ==

=== Цикл while ===
Цикл выполняется, пока условие в скобках истинно:
x = 0;

while (x < 5)
{
// это действие будет выполняться, пока х меньше 5
x++; // при каждом выполнении цикла увеличиваем х на 1
}

=== Цикл do while ===
Цикл похож на while, но, в отличии от него, цикл в любом случае выполнится хотя бы один раз (или больше, если при последующих проверках условие будет истинно):
x = 10;

do
{
// это действие выполнится один раз, так как условие изначально ложно
}
while (x < 5);

=== Цикл for ===
Цикл for обычно используется как счетчик и хорошо подходит, когда известно необходимое количество итераций. В скобках через точку с запятой указывается переменная, условие, инкремент / декремент для переменной:
for ( int x = 0; x < 5; x ++ )
{
// при каждом выполнении этих действий переменная х будет увеличивать на 1
// действия будут выполняться пока х меньше 5
}

== Функции ==
Функция — это последовательность действия для выполнения определенного задания. Объявление функции похоже на объявление переменной: необходимо указать тип возвращаемого значения (либо void, если функция ничего не возвращает) и название функции. После этого ставятся двойные скобки, в которых находятся аргументы функции (либо пустые скобки, если аргументы отсутствуют). Действия, выполняемые функцией, заключаются в фигурные скобки.

Любой код в операции «Скрипт С++» должен находиться в функции. При использовании нескольких функций в скрипте будет выполняться только первая, остальные должны быть вызваны из нее:
void main ()
{
int x = 1;
function (); // вызов функции, программа переходит в void function()
SetNodeValueAsInt(“/Конфигурация/Станция/Сигналы/Constant2”, x);
}

void function ()
{
SetNodeValueAsInt(“/Конфигурация/Станция/Сигналы/Constant2”, 5);
// теперь программа возвращается обратно в void main()
}
После выполнения данного скрипта значение сигнала Constant1 станет равно 5, а Constant2 равно 1.

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

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

Параметры указываются при объявлении функции в круглых скобках:
void summ (int x, int y) // в функцию передаются параметры х = 1 и y = 2
{
int z = x + y; // z равно 3
}

=== Возврат значения ===
Для передачи значения из скрипта можно указать необходимое значение в действии return, указав тип функции такой же, как у возвращаемого значения:
bool R_Output (bool x, bool y)
{
bool z = false;
z = x && y;

return z; // z передается на выход скрипта
}

== Математические и тригонометрические функции ==

===Преобразование IEEE битов===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float fpFromIEEE(uint bits)</code>
|Преобразует 32-битное IEEE-754 представление в число float
|<code>bits</code> (uint) - битовое представление
|-
|<code>uint fpToIEEE(float value)</code>
|Преобразует число float в 32-битное IEEE-754 представление
|<code>value</code> (float) - исходное число
|-
|<code>double fpFromIEEE(uint64 bits)</code>
|Преобразует 64-битное IEEE-754 представление в число double
|<code>bits</code> (uint64) - битовое представление
|-
|<code>uint64 fpToIEEE(double value)</code>
|Преобразует число double в 64-битное IEEE-754 представление
|<code>value</code> (double) - исходное число
|}

=== Сравнение с допуском===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>bool closeTo(float a, float b, float epsilon = 0.00001f)</code>
|Сравнивает два числа float с заданной погрешностью
|<code>a</code> (float) - первое число
<code>b</code> (float) - второе число
<code>epsilon</code> (float, опционально) - погрешность (по умолчанию 0.00001)
|-
|<code>bool closeTo(double a, double b, double epsilon = 0.0000000001)</code>
|Сравнивает два числа double с заданной погрешностью
|<code>a</code> (double) - первое число
<code>b</code> (double) - второе число
<code>epsilon</code> (double, опционально) - погрешность (по умолчанию 1e-10)
|}

=== Тригонометрические функции ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float cos(float angle)</code>
|Вычисляет косинус угла
|<code>angle</code> (float) - угол в радианах
|-
|<code>float sin(float angle)</code>
|Вычисляет синус угла
|<code>angle</code> (float) - угол в радианах
|-
|<code>float tan(float angle)</code>
|Вычисляет тангенс угла
|<code>angle</code> (float) - угол в радианах
|-
|<code>float acos(float value)</code>
|Вычисляет арккосинус (обратный косинус)
|<code>value</code> (float) - значение в диапазоне [-1, 1]
|-
|<code>float asin(float value)</code>
|Вычисляет арксинус (обратный синус)
|<code>value</code> (float) - значение в диапазоне [-1, 1]
|-
|<code>float atan(float value)</code>
|Вычисляет арктангенс (обратный тангенс)
|<code>value</code> (float) - значение
|-
|<code>float atan2(float y, float x)</code>
|Вычисляет арктангенс двух переменных
|<code>y</code> (float) - координата Y
<code>x</code> (float) - координата X
|}

=== Гиперболические функции ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float cosh(float x)</code>
|Вычисляет гиперболический косинус
|<code>x</code> (float) - значение
|-
|<code>float sinh(float x)</code>
|Вычисляет гиперболический синус
|<code>x</code> (float) - значение
|-
|<code>float tanh(float x)</code>
|Вычисляет гиперболический тангенс
|<code>x</code> (float) - значение
|}

=== Экспоненциальные и логарифмические функции ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float log(float x)</code>
|Вычисляет натуральный логарифм (по основанию e)
|<code>x</code> (float) - значение > 0
|-
|<code>float log10(float x)</code>
|Вычисляет десятичный логарифм (по основанию 10)
|<code>x</code> (float) - значение > 0
|}

=== Степенные функции ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float pow(float base, float exponent)</code>
|Возводит число в степень
|<code>base</code> (float) - основание
<code>exponent</code> (float) - показатель степени
|-
|<code>float sqrt(float x)</code>
|Вычисляет квадратный корень
|<code>x</code> (float) - неотрицательное значение
|}

=== Функции округления и остатка ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float ceil(float x)</code>
|Округляет вверх до ближайшего целого
|<code>x</code> (float) - значение
|-
|<code>float abs(float x)</code>
|Вычисляет абсолютное значение (модуль)
|<code>x</code> (float) - значение
|-
|<code>float floor(float x)</code>
|Округляет вниз до ближайшего целого
|<code>x</code> (float) - значение
|-
|<code>float fraction(float x)</code>
|Выделяет дробную часть числа
|<code>x</code> (float) - значение
|}

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

===Функции для работы с узлами===
{| class="wikitable"
!Определение функции
!Описание
|-
|float GetNodeValueAsFloat(string strNodePath)
|Получить значение узла в виде float по заданному пути
|-
|void SetNodeValueAsFloat(string strNodePath, float fValue)
|Установить значение узла в float по заданному пути
|-
|int GetNodeValueAsInt(string strNodePath)
|Получить значение узла в виде int по заданному пути
|-
|void SetNodeValueAsInt(string strNodePath, int iValue)
|Установить значение узла в int по заданному пути
|-
|string GetNodeValueAsString(string strNodePath)
|Получить значение узла в виде string по заданному пути
|-
| void SetNodeValueAsString(string strNodePath, string strValue)
|Установить значение узла в виде string по заданному пути
|-
|bool GetNodeValueAsBool(string strNodePath)
|Получить значение узла в виде bool по заданному пути
|-
|void SetNodeValueAsBool(string strNodePath, bool bValue)
|Установить значение узла в виде bool по заданному пути
|-
|bool NodeValueIsError(string strNodePath)
|Проверка значения узла на ошибку
|-
|void StartNode(string strNodePath)
|Запуск узла по заданному пути
|-
|void StopNode(string strNodePath)
|Остановка узла по заданному пути
|}

===Функции для работы с окнами ===
{| class="wikitable"
!Определение функции
!Описание
|-
| <code>void CloseWindow(string strNodePath, int iDisplay)</code>
|Закрыть окно по заданному пути на дисплее с номером iDisplay
|-
|<code>void ShowWindow(string strNodePath, int iDisplay)</code>
|Отобразить окно по заданному пути на дисплее с номером iDisplay.
Координаты - абсолютные, установленные в свойствах окна.
|-
|<code>int LoadComposition(string strWindowPath, string strCompositionPath, int iDisplay)</code>
|Загрузить композицию strCompositionPath в окно strWindowPath на дисплее с номером iDisplay.
<code>AS 1.6.25+</code>
|}

===Функции для работы с временем===
{| class="wikitable"
!Определение функции
!Описание
|-
|int GetCurrentTime()
|Получение текущего времени в UNIX формате (количество секунд с 01 января 1970 года)
|-
|uint64 GetCurrentTimeMs()
|Получение текущего времени в UNIX формате (количество миллисекунд с 01 января 1970 года) (<code>AS 1.2.55+</code>, <code>AS 1.6.1+</code>)
|-
|int GetLocalTime()
| Получение текущего времени в UNIX формате (количество секунд с 01 января 1970 года) с учетом часового пояса
|-
|int GetHours(int iTime)
| Получение текущего часа из времени в формате UNIX
|-
|int GetMinutes(int iTime)
|Получение текущих минут из времени в формате UNIX
|-
|int GetSeconds(int iTime)
|Получение текущих секунд из времени в формате UNIX
|}

===Функции для работы с событиями===
'''int StoreMessage(int iMessageLevel, string strMessage)'''
{| class="wikitable"
|-
|'''Назначение'''
|Генерация информационного события (типа "сообщение"). Событие помещается в группу "Системные".
|-
|'''Возвращаемое значение'''
|0 - успешно, иначе код ошибки
|-
| rowspan="2" |'''Аргументы'''
|int iMessageLevel - уровень сообщения (1-наивысший): 1=FATAL, 2=ERROR, 3=WARNING, 4=NOTICE, 5=INFO, 6=TRACE, 7=DEBUG
|-
|string strMessage - текст сообщения
|-
|'''Примечания'''
|функция доступна с версии <code>AS 1.2.34+</code>
|}
'''int StoreMessage(int iMessageLevel, string strMessage, string strGroup)'''
{| class="wikitable"
|-
|'''Назначение'''
|Генерация информационного события (типа "сообщение"). Событие помещается в указанную при вызове группу.
|-
|'''Возвращаемое значение'''
|0 - успешно, иначе код ошибки
|-
| rowspan="3" |'''Аргументы'''
|int iMessageLevel - уровень сообщения (1-наивысший): 1=FATAL, 2=ERROR, 3=WARNING, 4=NOTICE, 5=INFO, 6=TRACE, 7=DEBUG
|-
|string strMessage - текст сообщения
|-
|string strGroup - имя группы, в которую должно помещаться событие.
|-
|'''Примечания'''
|функция доступна с версии <code>AS 1.6.20+</code>
|}

===Функции для работы со строками===
'''string EncodeMD5(string strText)'''
{| class="wikitable"
|-
|'''Назначение'''
|Кодирование строки в MD5 хэш
|-
|'''Возвращаемое значение'''
|MD5 хэш параметра
|-
|'''Аргументы'''
|string strText - исходная строка
|-
|'''Примечания'''
| функция доступна с версии <code>AS 1.2.34+</code>
|}

===Другие функции===
Проверка на nan.
'''bool isnan(double)'''

Запуск процесса в операционной системе.
'''int LaunchProcess(string process)'''
Запуск производится в блокирующем режиме, то есть возврат из функции осуществляется по завершению процесса.

==Класс file==
Класс доступен начиная с версии 1.4.5 AgavaSCADA/AgavaPLC.

===Методы===
'''int open(const string& filename, const string& mode)'''
{| class="wikitable"
|-
|'''Назначение'''
|Открытие файла
|-
|'''Возвращаемое значение'''
|Результат выполнения операции: 0 - успешно, -1 - ошибка.
|-
| rowspan="2" |'''Аргументы'''
|const string& filename - путь до файла
|-
|const string& mode - режим открытия файла.
|}
'''int close()'''
{| class="wikitable"
|-
|'''Назначение'''
|Закрытие файла
|-
|'''Возвращаемое значение'''
|Результат выполнения операции. 0 - успешно, -1 - ошибка.
|-
|'''Аргументы'''
| -
|}
'''int getSize() const'''
{| class="wikitable"
|-
|'''Назначение'''
|Получение размера файла
|-
|'''Возвращаемое значение'''
|Размер файла в байтах
|-
|'''Аргументы'''
| -
|}
'''bool isEndOfFile() const'''
{| class="wikitable"
|-
|'''Назначение'''
| Получение признака конца файла
|-
|'''Возвращаемое значение'''
|true - обнаружен конец файла.
|-
|'''Аргументы'''
| -
|}
'''string readString(uint length)'''
{| class="wikitable"
|-
|'''Назначение'''
|Чтение строки
|-
|'''Возвращаемое значение'''
|Считанная строка
|-
|'''Аргументы'''
|uint length - длина считываемой строки
|}
'''string readLine()'''
{| class="wikitable"
|-
|'''Назначение'''
|Чтение строки
|-
|'''Возвращаемое значение'''
|Считанная строка
|-
|'''Аргументы'''
| -
|-
|'''Примечания'''
| Считывание производится до тех пор, пока не будет обнаружен символ '\n' или конец файла
|}
'''int64 readInt(uint)'''
'''Назначение:''' чтение целого числа со знаком.

'''Возвращаемое значение''': считанное значение.

'''Аргументы''': отсутствуют.

'''Примечания''': отсутствуют.
'''uint64 readUInt(uint)'''
'''Назначение:''' чтение целого беззнакового числа.

'''Возвращаемое значение''': считанное значение.

'''Аргументы''': отсутствуют.

'''Примечания''': отсутствуют.
'''float readFloat()'''
'''Назначение:''' чтение целого вещественного числа одинарной точности.

'''Возвращаемое значение''': считанное значение.

'''Аргументы''': отсутствуют.

'''Примечания''': отсутствуют.

double readDouble()

int writeString(const string &in)

int writeInt(int64, uint)

int writeUInt(uint64, uint)

int writeFloat(float)

int writeDouble(double)

int getPos() const

int setPos(int)

int movePos(int)

===Поля===
bool mostSignificantByteFirst.

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

Класс доступен начиная с версии <code>AS 1.6+</code>.

=== Методы ===
'''bool changeCurrentPath(const string &in path)'''
'''Назначение:''' Изменяет текущую рабочую директорию.

'''Аргументы:'''

* <code>path</code> – путь к новой директории (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>true</code> – если путь существует и текущая директория успешно изменена.
* <code>false</code> – если указанный путь не существует или не является директорией.

'''Примечания:'''

* Если путь задан относительно, он объединяется с текущей директорией.
* Путь не должен содержать обратные слеши <code>\</code> – они автоматически заменяются на <code>/</code>.
* Завершающие слеши автоматически удаляются из пути.
* Не поддерживает разрешение внутренних ссылок <code>/./</code> и <code>/../</code>.
'''string getCurrentPath() const'''
'''Назначение:''' Возвращает текущую рабочую директорию.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Строка с абсолютным путём текущей директории, использующая разделители <code>/</code>.

'''Примечания:'''

* При создании объекта <code>filesystem</code> текущая директория инициализируется рабочим каталогом приложения.
* Все обратные слеши <code>\</code> заменяются на <code>/</code> для единообразия.
'''array<string> @getDirs() const'''
'''Назначение:''' Получает список всех поддиректорий внутри текущей директории.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Массив строк с именами поддиректорий.

'''Примечания:'''

* Специальные записи <code>.</code> (текущая директория) и <code>..</code> (родительская директория) исключаются из результата.
* Возвращает пустой массив, если директорий нет или произошла ошибка чтения.
'''array<string> @getFiles() const'''
'''Назначение:''' Получает список всех файлов внутри текущей директории.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Массив строк с именами файлов.

'''Примечания:'''

* В результат включаются только файлы, директории исключаются.
* Возвращает пустой массив, если файлов нет или произошла ошибка чтения.
'''bool isDir(const string &in path) const'''
'''Назначение:''' Проверяет, является ли указанный путь директорией.

'''Аргументы:'''

* <code>path</code> – путь к объекту файловой системы (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>true</code> – если объект существует и является директорией.
* <code>false</code> – если объект не существует, не является директорией или произошла ошибка.

'''Примечания:'''

* Относительные пути разрешаются относительно текущей директории.
* Абсолютные пути определяются наличием двоеточия <code>:</code> (например, <code>C:</code>) или начального слеша <code>/</code> или <code>\</code>.
'''bool isLink(const string &in path) const'''
'''Назначение:''' Проверяет, является ли указанный путь символической ссылкой (symlink).

'''Аргументы:'''

* <code>path</code> – путь к объекту файловой системы (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>true</code> – если объект существует и является символической ссылкой (на Windows – репарс-точкой).
* <code>false</code> – если объект не является ссылкой, не существует или произошла ошибка.

'''Примечания:'''

* Кроссплатформенная поддержка: Windows (атрибут <code>FILE_ATTRIBUTE_REPARSE_POINT</code>) и POSIX (флаг <code>S_IFLNK</code>).
* Относительные пути разрешаются относительно текущей директории.
'''int64 getSize(const string &in path) const'''
'''Назначение:''' Возвращает размер файла в байтах.

'''Аргументы:'''

* <code>path</code> – путь к файлу (относительный или абсолютный).

'''Возвращаемое значение:'''

* Размер файла в байтах (тип <code>int64</code>).
* <code>-1</code> – если файл не существует, указан путь к директории или произошла ошибка.

'''Примечания:'''

* На Windows используется API-функция <code>GetFileSizeEx</code>.
* На POSIX-системах используется <code>stat</code>.
* Для директорий возвращает <code>-1</code>.
'''int makeDir(const string &in path)'''
'''Назначение:''' Создаёт новую директорию.

'''Аргументы:'''

* <code>path</code> – путь к создаваемой директории (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>0</code> – директория успешно создана.
* <code>-1</code> – ошибка создания (например, недостаточно прав, путь не существует).

'''Примечания:'''

* '''Важно:''' Не поддерживает рекурсивное создание промежуточных директорий (отмечено в TODO).
* На Windows создаёт директорию с правами по умолчанию.
* На POSIX создаёт с правами <code>S_IRWXU | S_IRWXG | S_IROTH | S_IXOTH</code> (755: чтение/запись/исполнение для владельца, чтение/исполнение для группы и остальных).
'''int removeDir(const string &in path)'''
'''Назначение:''' Удаляет пустую директорию.

'''Аргументы:'''

* <code>path</code> – путь к удаляемой директории (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>0</code> – директория успешно удалена.
* <code>-1</code> – ошибка удаления (директория не пуста, не существует, недостаточно прав).

'''Примечания:'''

* Удаляет только '''пустые''' директории.
* Не поддерживает рекурсивное удаление с содержимым.
* На Windows используется <code>RemoveDirectoryW</code>, на POSIX – <code>rmdir</code>.
'''int deleteFile(const string &in path)'''
'''Назначение:''' Удаляет файл.

'''Аргументы:'''

* <code>path</code> – путь к удаляемому файлу (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>0</code> – файл успешно удалён.
* <code>-1</code> – ошибка удаления (файл не существует, недостаточно прав, указана директория).

'''Примечания:'''

* На Windows используется <code>DeleteFileW</code>, на POSIX – <code>unlink</code>.
* Для удаления директорий используйте <code>removeDir</code>.
'''int copyFile(const string &in source, const string &in target)'''
'''Назначение:''' Копирует файл из одного местоположения в другое.

'''Аргументы:'''

* <code>source</code> – путь к исходному файлу.
* <code>target</code> – путь к целевому файлу (не директории).

'''Возвращаемое значение:'''

* <code>0</code> – файл успешно скопирован.
* <code>-1</code> – ошибка копирования (исходный файл не существует, недостаточно прав, целевой файл уже существует).

'''Примечания:'''

* На Windows используется API-функция <code>CopyFileW</code> с параметром <code>TRUE</code> (не перезаписывать существующий файл).
* На POSIX-системах копирование выполняется '''вручную''' побайтово через <code>fopen/fread/fwrite</code>, так как стандартной функции копирования нет.
* Целевой файл не должен существовать (флаг <code>TRUE</code> на Windows).
'''int move(const string &in source, const string &in target)'''
'''Назначение:''' Перемещает или переименовывает файл или директорию.

'''Аргументы:'''

* <code>source</code> – текущий путь к объекту.
* <code>target</code> – новый путь или имя объекта.

'''Возвращаемое значение:'''

* <code>0</code> – объект успешно перемещён/переименован.
* <code>-1</code> – ошибка операции (объект не существует, недостаточно прав).

'''Примечания:'''

* Может использоваться как для файлов, так и для директорий.
* На Windows используется <code>MoveFileW</code>, на POSIX – <code>rename</code>.
* Операция может выполняться в пределах одного тома/файловой системы.
'''datetime getCreateDateTime(const string &in path) const'''
'''Назначение:''' Возвращает дату и время создания файла или директории.

'''Аргументы:'''

* <code>path</code> – путь к объекту файловой системы.

'''Возвращаемое значение:'''

* Объект <code>datetime</code>, содержащий дату и время создания.

'''Примечания:'''

* '''Выбрасывает исключение''' в скриптовом контексте через <code>SetException</code>, если не удаётся получить дату создания.
* На Windows используется <code>GetFileTime</code> с полем <code>createTm</code>.
* На POSIX-системах используется поле <code>st_ctime</code> (change time) – может отличаться от реального времени создания на некоторых файловых системах.
'''datetime getModifyDateTime(const string &in path) const'''
'''Назначение:''' Возвращает дату и время последнего изменения файла или директории.

'''Аргументы:'''

* <code>path</code> – путь к объекту файловой системы.

'''Возвращаемое значение:'''

* Объект <code>datetime</code>, содержащий дату и время последней модификации.

'''Примечания:'''

* '''Выбрасывает исключение''' в скриптовом контексте через <code>SetException</code>, если не удаётся получить дату изменения.
* На Windows используется <code>GetFileTime</code> с полем <code>modifyTm</code>.
* На POSIX-системах используется поле <code>st_mtime</code> (modify time).

==Класс datetime==
Класс доступен начиная с версии <code>AS 1.6+</code>.

===Конструкторы===

====Конструктор по умолчанию====
datetime dt();
Создает объект с текущей датой и временем.

====Конструктор копирования====
datetime dt(other);
Создает копию существующего объекта datetime.

====Конструктор с параметрами====
datetime dt(year, month, day, hour = 0, minute = 0, second = 0);
Создает объект с указанной датой и временем.
'''Примеры:'''
// Только дата
datetime newYear = datetime(2024, 1, 1);

// Дата и время
datetime meeting = datetime(2024, 12, 25, 14, 30, 0);

// Полная спецификация
datetime exact = datetime(2024, 6, 15, 9, 45, 30);

===Методы===
<code>uint get_year() const</code>

Возвращает год (4 цифры).

<code>uint get_month() const</code>

Возвращает месяц (1-12).

<code>uint get_day() const</code>

Возвращает день месяца (1-31).

<code>uint get_hour() const</code>

Возвращает часы (0-23).

<code>uint get_minute() const</code>

Возвращает минуты (0-59).

<code>uint get_second() const</code>

Возвращает секунды (0-59).

'''Пример:'''
datetime dt = datetime(2024, 12, 25, 14, 30, 45);

uint year = dt.year; // 2024
uint month = dt.month; // 12
uint day = dt.day; // 25
uint hour = dt.hour; // 14
uint minute = dt.minute; // 30
uint second = dt.second; // 45
<code>bool setDate(year, month, day)</code>

Устанавливает дату. Возвращает <code>true</code> при успехе, <code>false</code> при неверной дате.

'''Пример:'''
datetime dt;
bool success = dt.setDate(2024, 2, 29); // true (високосный год)
bool invalid = dt.setDate(2023, 2, 29); // false (не високосный)
<code>bool setTime(hour, minute, second)</code>

Устанавливает время. Возвращает <code>true</code> при успехе, <code>false</code> при неверном времени.

'''Пример:'''

cpp
datetime dt;
bool success = dt.setTime(23, 59, 59); // true
bool invalid = dt.setTime(25, 0, 0); // false (часы > 23)

===Арифметические операции===
Вычитание дат
int64 difference = dt1 - dt2;
Возвращает разницу в секундах.
datetime start = datetime(2024, 1, 1, 0, 0, 0);
datetime end = datetime(2024, 1, 2, 0, 0, 0);
int64 diff = end - start; // 86400 секунд (1 день)
Сложение с секундами
datetime result = dt + seconds;
datetime result = seconds + dt; // обратный порядок
dt += seconds;
'''Пример:'''
datetime dt = datetime(2024, 1, 1, 10, 0, 0);

// Добавить 2 часа
datetime later = dt + 7200;
dt += 7200;

// Обратный порядок
datetime same = 7200 + dt;
Вычитание секунд
datetime result = dt - seconds;
datetime result = seconds - dt; // обратный порядок
dt -= seconds;
'''Пример:'''
datetime dt = datetime(2024, 1, 1, 10, 0, 0);

// Вычесть 30 минут
datetime earlier = dt - 1800;
dt -= 1800;

===Операции сравнения ===
<code>bool opEquals(other)</code>

Проверка равенства дат.

<code>bool opLess(other)</code>

Проверка что дата раньше.

<code>int opCmp(other)</code>

Сравнение с возвратом -1 (меньше), 0 (равно), 1 (больше).

'''Пример:'''
datetime dt1 = datetime(2024, 1, 1);
datetime dt2 = datetime(2024, 1, 2);

if (dt1 < dt2) {
// dt1 раньше dt2
}

if (dt1 == dt2) {
// даты равны
}

int result = dt1.opCmp(dt2); // -1

===Практические примеры ===
Пример 1: Таймер выполнения
datetime startTime;

// Выполняем некоторую операцию
for (int i = 0; i < 1000000; i++)
{
// какая-то работа
}

datetime endTime;
int64 elapsed = endTime - startTime;
print("Операция заняла: " + elapsed + " секунд");
Пример 2: Расчет дат событий
// Дата начала проекта
datetime projectStart = datetime(2024, 1, 15);

// Напоминание за 3 дня до дедлайна
datetime deadline = datetime(2024, 3, 1);
datetime reminder = deadline - 3 * 86400; // 3 дня в секундах

// Продление срока на 2 недели
datetime extendedDeadline = deadline + 14 * 86400;
Пример 3: Проверка рабочего времени
datetime currentTime;

// Создаем время начала и конца рабочего дня
datetime workStart = datetime(currentTime.year, currentTime.month,
currentTime.day, 9, 0, 0);
datetime workEnd = workStart + 8 * 3600; // 8 часов

if (currentTime >= workStart && currentTime <= workEnd)
{
print("Рабочее время");
}
else
{
print("Вне рабочего времени");
}
Пример 4: Валидация даты
bool createAppointment(uint year, uint month, uint day, uint hour)
{
datetime appointment;

// Проверяем корректность даты
if (!appointment.setDate(year, month, day)) {
print("Неверная дата!");
return false;
}

// Проверяем корректность времени
if (!appointment.setTime(hour, 0, 0)) {
print("Неверное время!");
return false;
}

// Проверяем что дата не в прошлом
datetime now;
if (appointment < now) {
print("Дата не может быть в прошлом!");
return false;
}

print("Встреча создана: " + appointment.year + "-" + appointment.month + "-" + appointment.day);
return true;
}
Пример 5: Разбивка интервала времени
datetime start = datetime(2024, 1, 1, 0, 0, 0);
datetime end = start + 365 * 86400; // +1 год

int64 totalSeconds = end - start;
int64 days = totalSeconds / 86400;
int64 hours = (totalSeconds % 86400) / 3600;
int64 minutes = (totalSeconds % 3600) / 60;
int64 seconds = totalSeconds % 60;

print("Интервал: " + days + " дней, " + hours + " часов, " + minutes + " минут, " + seconds + " секунд");

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

На вход скрипта подаются значения некоего сигнала (Signal) и уставки (Constant). В том случае, если сигнал больше уставки, замыкается релейный выход (out0). Соотношение между сигналом и уставкой переводится в проценты и записывается в переменную Percent. Если это соотношение становится меньше определенного значения, то соответствующее сообщение записывается в переменную Alert.

Текст скрипта:
 bool main (float signal_val, float constant_val) // функция получает значения сигнала и уставки
{
float ratio; // переменная, в которой будет храниться соотношение сигнала и уставки
ratio = signal_val / constant_val; // вычисление соотношения
 percent_write(ratio); // вызов функции записи в узлы, с передачей в нее соотношения
 if ( signal_val > constant_val)
{
 return true; // если сигнал больше уставки, на выход скрипта приходит true
}
else
{
 return false; // если сигнал не больше уставки, на выход скрипта приходит false
}
}
 void percent_write (double ratio) // функция записи в узлы
{
string message = "Значение в пределах нормы"; // текстовое сообщение по умолчанию
double percent = ratio * 100; // вычисляется процентное соотношение

if ( percent < 50 )
{
 message = "Значение ниже нормы!"; // если процентное соотношение меньше 50
 // то текст сообщения меняется
}

// запись текстового сообщения в нужный узел
SetNodeValueAsString("/Конфигурация/Станция/Сигналы/Alert", message);

// запись процентного соотношения в нужный узел
SetNodeValueAsFloat("/Конфигурация/Станция/Сигналы/Percent", percent);
}

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

В этой таблице показаны доступные унарные операторы, в порядке убывания приоритета.
{| class="wikitable"
! Символ
!Операция
|-
|<code>::</code>
|Оператор разрешения области видимости
|-
|<code>[]</code>
| Оператор индексации
|-
|<code>++ --</code>
|Постинкремент и декремент
|-
|<code>.</code>
|Доступ
|-
|<code>++ --</code>
|Преинкремент и декремент
|-
|<code>!</code>
|Логическое НЕ
|-
|<code>+ -</code>
|Унарный положительный и отрицательный
|-
|<code>~</code>
|Побитовое дополнение
|-
|<code>@</code>
|Ссылка
|}
Эта таблица показывает приоритет бинарных и тернарных операторов в порядке убывания.
{| class="wikitable"
!Символ
!Операция
|-
|<code>**</code>
|Экспонента
|-
|<code>* / %</code>
|Умножить, разделить, по модулю
|-
|<code>+ -</code>
|Сложить и вычесть
|-
|<code><< >> >>></code>
|Сдвиг влево, сдвиг вправо и арифметический сдвиг вправо
|-
|<code>&</code>
|Битовое И
|-
|<code>^</code>
|Битовый XOR
|-
|<code><nowiki>|</nowiki></code>
|Битовое ИЛИ
|-
|<code><= < >= ></code>
|Сравнение
|-
|<code>== != is !is xor ^^</code>
|Равенство, идентичность и логическое исключающее ИЛИ
|-
|<code>and &&</code>
|Логическое И
|-
|<code><nowiki>or ||</nowiki></code>
|Логическое ИЛИ
|-
|<code>?:</code>
|Условие
|-
|<code>= += -= *= /= %= **= &=</code>

<code>|= ^= <<= >>= >>>=</code>
|Присваивание и составные присваивания
|}

==Зарезервированные ключевые слова==
Это ключевые слова, которые зарезервированы языком. Они не могут использоваться какими-либо идентификаторами, определенными скриптом.
{| class="wikitable"
|and

abstract

auto

bool

break

case

cast

catch

class

const

continue

default

do
|double

else

enum

explicit

external

false

final

float

for

from

funcdef

function

get
|if

import

in

inout

int

interface

int8

int16

int32

int64

is

mixin

namespace
|not

null

or

out

override

private

property

protected

return

set

shared

super

switch
|this

true

try

typedef

uint

uint8

uint16

uint32

uint64

void

while

xor
|}

==Ссылки==
<references />

[[Категория:AgavaSCADA/AgavaPLC]]

Перечень изменений AgavaSCADA/AgavaPLC 1.6

2026-04-27T05:39:51Z

TaushkanovKV: /* 1.6.33-rc335f5d9dacf от 2026-04-01 */

Основные изменения в сравнении с версией 1.2:

# Добавлена возможность создания программ на языке C++ в соответствии с подходом, описанным в стандарте МЭК 61131-3.
# Продолжение развития объектной модели и возможности разработки программ, начатых в версии <code>AS 1.5</code>. [[Объектная модель AgavaSCADA/AgavaPLC]].
# Добавлена поддержка локального и онлайн (удаленного) отладчика.
# Для редактирования текстов программ, функций и классов внедрен новый, удобный и функциональный текстовый редактор, подобный распространенному VSCode.
# Транспорты MQTT, SNMP, МЭК 60870-5-101, МЭК 60870-5-104 портированы на ПК с ОС Linux x64 и контроллеры АГАВА.
# Реализован новый архиватор в БД PostgreSQL.
# Добавлена поддержка ресурсов и библиотек ресурсов.
# Добавлена Web-визуализация. См. пример <code>MultiImageLabel</code>.
# Разработан ряд примеров, демонстрирующих новые возможности: <code>AIParameter</code>, <code>PIDRegulator</code>, <code>Leds</code>, <code>Wdt</code>, <code>AgavaAnalogInput</code>, <code>WidgetAgavaInput</code>, <code>Pump</code>, <code>MultiImageLabel</code> и другие.
Также запланировано добавление новых возможностей:
# Поддержка языка ST МЭК 61131-3 (Structured text).
# Поддержка распределенных проектов.
# Поддержка сохранения в проекте информации о целевой системе.
# Конфигурирование целевых устройств из проекта.
# Создание расширений для среды разработки с помощью SDK.
Перевод разработанных ранее проектов на актуальную версию описан в документе [[Миграция проектов AgavaSCADA/AgavaPLC]].

== 1.6.34-r1005c4072459 от 2026-04-24 ==

=== Узлы ===
# Восстановлена работа узла <code>Транспорт OPC UA</code>. Восстановлена обработка операций после чтения и перед записью.
# Дополнена валидация узла <code>Тег OPC UA</code>. '''В связи с обширной переделкой транспорта и тега изменены настройки свойства <code>Тип значения</code>, для ранее созданных проектов требуется ревизия значений данного свойства тегов.'''
# Исправлены ошибки в работе узла <code>Сигнал комплексный</code>. Также реализована выдача сигнала обновления значения при изменении значений свойств во время исполнения.
# Исправлен запуск и валидация узла <code>Монитор событий комплексный</code>.
# Реализована работа архиваторов, графика исторического и отчетов со свойствами узлов. Теперь архивация значений свойств работает корректно.
# Доработана объектная модель: для класса <code>NodeProperty</code> добавлены перегрузки <code>SetValue(ResourceLink)</code> и <code>SetValue(Color)</code>.
# Доработаны архиваторы <code>PostgreSQL</code> и <code>SQLite</code> - отключена запись изменений свойств всех узлов коллекции (ошибочно введенная ранее функция).
# Доработан <code>Виджет "Условное изображение"</code> - исправлена работа свойства <code>Видимость</code>.
# Узел типа <code>Система сигнализации</code> внесен в объектную модель. Зарегистрирован метод <code>void SystemAlarming::AcknowledgeAll()</code>.
# Исправлены ошибки в методах <code>BasicNode::GetPath()</code>, <code>BasicNode::GetName()</code>, <code>BasicNode::SetName()</code>, <code>BasicNode::GetDescription()</code>, <code>BasicNode::SetDescription()</code>.
# Исправлена ошибка некорректной остановки <code>Modbus-TCP</code> и <code>Modbus-RTU</code> серверов.

=== Среда разработки ===

# Исправлена критическая ошибка, возникавшая при закрытии проекта.
# Исправлена ошибка копирования экземпляров классов.
# Исправлена ошибка, возникавшая при вставке узлов экземпляров из другого проекта.
# Устранена критическая ошибка в системе проверки прав, возникавшая при проверке проекта.
# Исправлена критическая ошибка создания узла типа <code>Логгер PostgreSQL</code>.
# При валидации проекта добавлены предупреждения о кириллических символах в именах узлов.
# Доработана компиляция проекта - изменено отображение замечаний об исключениях. Теперь исключение, возникающее при компиляции такого проекта, отображается как ошибка для большей заметности. Устранены неинформативные замечания этапа компиляции.

=== Примеры ===

# Добавлен пример <code>Visualization/DynamicWidgets</code>.
# Доработан пример <code>Visualization/WidgetAgavaInput</code> - добавлена демонстрация вызова метода виджета из кнопки на форме.
# Пример <code>Transports/ModbusMasterSlave</code> дополнен демонстрацией работы TCP Master/Slave.

=== Разное ===

# Доработан <code>ASLauncher</code> - доработана утилита конфигурирования - настройки сети и времени для ОС Windows.

== 1.6.33-rc335f5d9dacf от 2026-04-01 ==

=== Узлы ===
# Доработан выполнение алгоритмов C++:
#* Возвращён вызов виртуальных методов BasicSource.
#* Реализована защита от рекурсии в методах BasicSource.
# Доработан класс <code>SignalValue</code> - зарегистрированы конструкторы и методы работы с типами uint64, uint32.
# Доработан узел <code>Транспорт Modbus-TCP</code>:
#* Функция записи по умолчанию установлена на 0.
#* Отключена возможность множественных подключений к транспорту в режиме <code>Сервер</code>.
# Доработан узел <code>Транспорт Modbus-RTU</code> :
#* Функция записи по умолчанию установлена на 0.
#* Восстановлена работа в режиме <code>Сервер</code>.
# Доработан узел <code>Транспорт УПД</code>:
## Исправлена работа со свойством <code>Идентификаторы ведущих</code>.
## Добавлено отслеживание активного подключения в режиме <code>Slave</code>.
# Зарегистрирован класс [[Класс any|any]].
# Доработан узел <code>Retain накопитель</code> - реализована возможность сохранения через задержку.
# Добавлена возможность связывания свойств экземпляров с свойствами других узлов.
# Добавлены типы (u)int64 для связи со свойствами экземпляров.

=== Среда разработки ===

# Исправлена критическая ошибка в команде "Показать в графическом представлении".
# Доработано контекстное меню дерева проекта:
#* Исправлена критическая ошибка в команде "Выделить" для виджетов.
#* Пункт "Выделить" перемещен на уровень выше.
#* Добавлено действие "Выделить" на двойной клик по виджетам.
# Исправлена критическая ошибка, возникавшая при открытии диалога "Настройки" для графиков.
# Устранены назойливые сообщения загрузки плагинов и регистрации узлов при проверке проекта.
# Добавлена возможность восстановления связей между узлами при вставке фрагментов из других проектов.
# Исправлена ошибка многократной установки ошибок в редактор кода, приводившая к сильному замедлению работы при большом количестве открытых окон редактора.
# Реализовано отображение содержимого массивов и указателей (хэндлов) в режиме отладки.
# Добавлены файловые ассоциации на файл проекта для быстрого открытия проекта в среде разработки с помощью двойного клика по .asp файлу.
# '''Отключен вызов сеттеров свойств при установке значений свойств в среде разработки.'''
# Отключено кеширование композиций в среде разработки.
# Исправлена критическая ошибка, возникавшая при установке значения свойства типа <code>string</code> у экземпляра после сборки проекта.
# Доработано контекстное меню дерева проекта и контекстное меню графического предаставления - добавлены иконки элементов контекстного меню <code>Добавить узел</code>, изменен порядок команд для более удобного их использования.
# Изменена горячая клавиша создания проекта на <code>Ctrl+Shift+N</code>.

=== Среда исполнения ===

# Добавлено логгирование для системного и межстанционного транспортов.
# Убрана поддержка IPv6 в системном транспорте и межстанционном транспорте для работы на встраиваемых системах без IPv6.
# Исправлена критическая ошибка в BasicNode, иногда приводившая к крахам при одновременном доступе к объекту из разных задач.

== 1.6.32-r79b12a16bbd7 от 2026-03-05 ==

=== Узлы ===
# Класс <code>WindowForm</code> добавлен в объектную модель.
# Отключена возможность добавления узлов типа <code>Задача ПЛК</code> как устаревшего функционала. Вместо него будет добавлена возможность создавать программы на языках FBD, CFC, SFC.
# Реализовано автоматическое создание конструкторов по умолчанию для классов из ОМ при отсутствии пользовательского.
# Исправлен запуск сигналов.
# Устранены утечки памяти при сохранении проекта в .bin.
# Внутренняя реорганизация обработчиков событий OperationsInput, OperationsOutput в узле <code>Сигнал простой</code>.
# Добавлен TransportModbusRtuIdr2.
# В действии <code>Создание события</code> исправлена работа форматтера <code>$$pd</code>.

=== Среда разработки ===

# Доработан редактор графического представления: добавлена сетка, [[Универсальная среда разработки Agava#.D0.98.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5 .D1.8F.D0.BA.D0.BE.D1.80.D0.B5.D0.B9|линейки, якоря]], функции выравнивания виджетов.
# Исправлена ошибка, вызывавшая двойной вызов обработчиков событий мыши для окон.
# Устранена ошибка, связанная с утечкой памяти при удалении виджетов.
# Добавлено приветственное окно со списком последних открытых проектов и таблицей примеров.
# Исправлена некритическая ошибка, возникавшая при закрытии фрейма.

=== Среда исполнения ===

# Устранена ошибка, связанная с утечкой памяти при закрытии окна с кешированными композициями.

== 1.6.31-rac6da98668fb от 2025-12-26 ==

=== Примеры ===
# Добавлен пример <code>Controllers/PLC70_Submodules</code>.

== 1.6.31-r9e81e0333260 от 2025-12-25 ==

=== Узлы ===

# Добавлена возможность создания конструкторов вида Classname(const string &in path) в дереве.
# Исправлена ошибка в вызове обработчика <code>OnWheel</code> у виджетов.
# Доработан узел <code>Корзина субмодулей</code>:
#* Уменьшено время ожидания ответа субмодуля с 1000 мс до 25 мс.
#* Реализована поддержка слотов G/H/I/K для ПЛК-70.
#* Реализовано создание узлов для каналов субмодулей в дереве проекта. '''Обратите внимание, проекты, использующие прежнюю структуру субмодулей, не совместимы с версией AgavaSCADA/AgavaPLC 1.6.31!'''
#* Исправлена валидация слотов на уровне субмодуля. Добавлена проверка на занятость одного слота несколькими субмодулями с формированием сообщения об ошибке.
# Доработаны узлы <code>Станция ПК-40</code>, <code>Станция ПК-50</code>, <code>Станция ПК-60</code>, <code>Станция ПК-70</code>:
#* Добавлено ограничение значений подсветки экрана и индикаторов, добавлена валидация соответствующих свойств узлов.
#* Реализована установка яркости подсветки экрана и состояния светодиодов согласно настроек в проекте.
# Доработан транспорт OPC UA:
#* Добавлена поддержка типа double.
#* Устранены критические ошибки при повторном запуске транспорта и при записи в read-only тэги.
#* Добавлено уведомление пользователя о некорректных тэгах.
# Доработан виджет <code>Ввод значения</code>: исправлено форматирование значений типа double - число знаков после запятой теперь зависит от шага значения.

=== Среда разработки ===

# Устранена потенциальная ошибка сохранения проекта при открытии в проводнике папки с проектом.
# Изменен мастер создания проектов: для проектов для <code>ПЛК-70.А</code>, создаваемых с помощью мастера, используется узел <code>Станция ПК-70</code> вместо <code>Станция ПК-40</code> в предыдущей версии.

=== Среда исполнения ===

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

== 1.6.30-rb3d3b577ed29 от 2025-12-05 ==

=== Ядро ===

# Исправлена работа системного транспорта: устранена ошибка взаимодействия с другими станциями.

=== Узлы ===

# Исправлена ошибка с обработкой вложенных групп в узле типа <code>Приложение</code>.
# Доработан класс <code>NodeProperty</code>: изменена регистрация класса, устранены критические ошибки.

=== Среда разработки ===

# Доработано редактирование свойств типа <code>ValueLink</code>: добавлен сброс значения, позволяющий удалить ранее установленное значение.
# Доработан редактирование свойств типа <code>NodeLink</code>: исправлена ошибка при работе с узлами с одними цифрами в имени.
# Доработано окно свойств: свойства типа <code>ValueLink</code> принимают перетаскивание узлов.
# Доработано окно <code>Стек вызовов</code>: при двойном клике по элементам таблицы открывается редактор кода.
# Доработан редактор кода: добавлены маркеры ошибок компиляции.
# Доработано окно <code>Ошибки</code>: при двойном клике на ошибке выполняется открытие редактора кода.
# '''Добавлена возможность поиска по проекту. Панель поиска вызывается комбинацией клавиш <code>Ctrl+Shift+F</code>.'''

=== Среда исполнения ===

# Доработано окно тревог: добавлено сообщение "Активных тревог нет" в центре таблицы при отсутствии активных тревог.

== 1.6.29-rf17ce9e25c7a от 2025-11-18 ==

=== Узлы ===

# Добавлена функция <code>SetNodeValueAsUInt(string strNodePath, uint32_t uiValue)</code>.
# Доработано действие <code>Создание события</code>: добавлено свойство <code>Требовать квитирование</code>.
# Доработана система тревог: добавлены обработчики событий <code>OnActiveEventsCleared</code> и <code>OnActiveEventsAcknowledged</code>.
# Доработан архиватор SQLite: изменен алгоритм прореживания в режиме <code>Процент от среднего значения</code> — теперь среднее вычисляется по последним N значениям. Добавлено свойство <code>Размер окна среднего (N)</code> для настройки ширины окна. Также добавлена опция <code>Процент от среднего (окно по времени)</code>, в которой среднее рассчитывается по значениям за временной интервал, равный параметру <code>Интервал архивирования</code>. Исправлено отсутствие таблицы <code>SignalInfo</code> при ротации БД.
# Доработана система тревог: добавлено свойство <code>Использовать цвет группы</code> для отображения элементов в окне тревог. Добавлено сохранение событий квитирования.
# Доработано окно смены пароля: добавлена поддержка свойства <code>Запретить смену пароля</code> у узла пользователя.
# Добавлена функция <code>void sleep(ms)</code>.
# Изменена логика работы функции <code>LaunchProcess</code>, которая теперь выполняет запуск в блокирующем режиме, то есть функция завершится после завершения запущенного процесса.
# Исправлена ошибка в узле <code>Операция Таймер</code>. Теперь выключенные действия в обработчике <code>OnTimerFinished</code> не исполняются.

=== Среда разработки ===

# Упорядочен вывод сообщений в окно Сообщения. Устранен вывод служебных сообщений.

=== Примеры ===

# Исправлены примеры <code>DistributedDemoServer</code>, <code>DistributedDemoClient</code>.

== 1.6.28-r7aa0d6dc2386 от 2025-11-01 ==

=== Узлы ===

# Доработано действие Смена пароля пользователя - пользователи с запретом смены пароля блокируются в списке выбора.
# Исправлена критическая ошибка в системе проверки прав, возникающая при некорректной конфигурации системы. Дополнена валидация системы для уведомления о некорректной конфигурации.
# Доработана стандартная библиотека: реализованы функции <code>array<string> GetInterfaceAddresses(string)</code>, <code>array<string> GetNetworkInterfaces()</code>.
# Доработан узел <code>Пользователь</code> - добавлено свойство <code>Запретить изменение пароля</code>.
# Оптимизирована работа со значениями типа SignalValue.
# Доработаны приложения - реализована выдача значений типа SignalValue для свойств экземпляров.

=== Среда разработки ===

# Исправлена критическая ошибка в виджетах <code>Кнопка</code> и <code>Гистограмма</code>, возникавшая при удалении источника из списка.
# Добавлено сохранение типа узла в его тег в XML проекте.
# Изменено редактирование узлов <code>Операция скрипт С++</code>, размещенных в обработчиках. Теперь это работает почти как в версии 1.2, но переход к редактору возможен только по нажатию ОК. При закрытии диалога контейнера добавлено закрытие окна редактора кода для вложенного узла.

=== Примеры ===

# Добавлен пример <code>AIParameter</code>, демонстрирующий применение ООП в проекте.
# Добавлены примеры <code>DistributedDemoServer</code>, <code>DistributedDemoClient</code>, демонстрирующие принцип построения распределенных проектов.

== 1.6.27-r8573369cf034 от 2025-10-29 ==

=== Узлы ===
# Доработана [[Узлы проекта AgavaSCADA/AgavaPLC#Композиция|композиция многослойная]]: добавлено свойство <code>ActionsOnLoad</code>.
# В стандартную библиотеку добавлена поддержка класса <code>filesystem</code>.
# Добавлено чтение свойств типа <code>NColor</code> [[Свойства узлов в AgavaSCADA/AgavaPLC#NColor|через преобразование в int]].
# Устранены критические ошибки в системных функциях поиска файлов, возникавшие при работе с разрушенными файловыми системами.
# Добавлены функции <code>bool isnan(float value)</code>, <code>void LaunchProcess(string strFilePath)</code>.

== 1.6.26-rfd1b5cbbf1fc от 2025-10-23 ==

=== Узлы ===
# Для узлов <code>RetainStorage</code> и <code>StorageDrive</code> реализовано онлайн создание свойств.
# Доработаны методы <code>BasicSignal::SetValue</code>, <code>BasicSignal::UpdateValue</code>, <code>BasicSource::SetValue</code>, <code>BasicSource::UpdateValue</code> - реализована выдача кодов [[Коды ошибок и предупреждений AgavaSCADA/AgavaPLC|ошибок]].
# Доработаны архиваторы <code>SQLite</code>, <code>PostreSQL</code> - добавлена возможность прореживания записи в БД.
# Выполнен рестайлинг окон проверки подлинности пользователя и смены пароля пользователя.
# Доработаны библиотеки ресурсов - исправлена работа с русскими символами.
# Доработано действие <code>Смена пароля пользователя</code>: добавлено свойство <code>Текущий</code>.
# Доработана логика работы операторов <code>SignalValue operator&&</code>, <code>SignalValue operator||</code> - реализована генерация соответствующих событий при ошибках исполнения. Реализовано более простое и корректное сравнение значений. Изменен режим сравнения аргументов типа <code>string</code>, <code>Result</code>.
# Доработано окно с композицией: исправлена работа с свойством <code>CurrentCompositionDesc</code>.
# Доработаны транспорты <code>Modbus</code>: устранена ошибка "Illegal Data Address" в режиме "Сервер" при создании нескольких блоков регистров.
# Доработано действие <code>Запуск метода экземпляра</code>: добавлена возможность передачи аргументов.
# Доработано действие <code>Создание события</code>: добавлен форматтер <code>$$ns</code> - шифр узла.
# Доработан виджет <code>Кнопка</code>: для вложенных действий типа <code>Создание события</code> передается ссылка на себя для работы с форматтерами.

=== Среда разработки ===

# Устранена критическая ошибка, возникавшая при кликах по свойствам только для чтения типа bool узлов в дереве проекта.

== 1.6.25-r97ac006e3905 от 2025-10-15 ==

=== Узлы ===
# Добавлена функция <code>bool isnan(double)</code>.
# Добавлена функция <code>int LoadComposition(string, string, int)</code>.
# Добавлено действие <code>Смена пароля пользователя</code>.
# Доработано окно тревог: добавлена возможность размещения пользовательских виджетов.
# Доработан узел <code>Пользователь</code>: добавлено свойство <code>Не показывать в списке</code>.
# Исправлена ошибка в действии <code>Закрытие окна</code>, возникавшая при закрытии нескольких окон подряд на активном экране.
# Доработан узел <code>Тренд</code> графика исторического: в свойство <code>Использовать описание и шифр</code> добавлен вариант <code>Вышестоящий узел сигнала</code>.
# Доработано окно тревог: добавлена отдельная иконка для аварий. Исправлена работа свойства <code>Включить воспроизведение звуков</code> на контроллерах.
# Доработано действие <code>Создание события</code>: исправлена ошибка, при возникновении которой при деактивации события выводился текст активации.

=== Среда разработки ===

# Исправлена ошибка при редактировании свойств типа <code>Узел</code>, <code>Список узлов</code>.
# Устранено "зависание" среды разработки при онлайн отладке и просмотре значений переменных из отлаживаемой программы.
# Доработано окно редактирования свойств типа <code>Список узлов</code>: добавлена возможность перемещения элементов.
# Доработано окно редактирования списка привилегий у роли: добавлена поддержка клавиши Del, реализовано сохранение и восстановление геометрии окна, реализовано удаление множества элементов.
# Доработано окно ошибок: двойной клик по ошибке выделяет в дереве проекта узел, вызвавший ошибку.
# Исправлено повторное открытие окна настройки привилегий.
# Доработана библиотека ресурсов: сохранение теперь выполняется только при наличии изменений.

== 1.6.24-r93067f2c1dd1 от 2025-10-06 ==

=== Узлы ===
# Добавлена функция <code>double rand(double, double)</code>.
# Добавлена поддержка команды <code>Сброс</code> для действия <code>Команда узлу</code>.
# Узел <code>Контроллер событий</code> переименован в <code>Монитор событий</code>.
# Для монитора событий добавлено свойство <code>Блокировка работы</code>, добавлен обработчик <code>OnActiveEventsCleared</code>, вызывающийся после удаления всех активных тревог.
# Доработан узел <code>Регистр Modbus</code> - добавлена поддержка онлайн создания свойств.
# Доработан <code>Транспорт Modbus</code>: в режиме работы Slave устранена критическая ошибка, если не было указано свойство "Узел для чтения/записи". Добавлено соответствующее предупреждение при сборке проекта.
# Добавлена поддержка связывания свойств экземпляров через аргументы типа <code>SignalValue</code>.
# Доработан <code>Монитор событий</code>: добавлено свойство <code>Поведение при блокировании</code>. Добавлена проверка значений контролируемых узлов при старте проекта.

=== Среда разработки ===

# Доработан текстовый редактор кода: добавлена обработка нажатия клавиши <code>F9</code> для добавления/удаления точек останова. Значительно ускорено открытие текстов программ в редакторе.
# Доработан отладчик: добавлено человеко-читаемое представление значений типа <code>SignalValue</code>.

=== Примеры ===

# Дополнен пример <code>TestEventsAlarms</code>.

== 1.6.23-ra13bff0d25ce от 2025-09-29 ==

=== Узлы ===
# Добавлено восстановление свойств экземпляров объектов из retain.
# Доработаны транспорты <code>Modbus</code> - реализован арбитраж чтения/записи с помощью приоритетов.
# Исправлено некорректное позиционирование окон авторизации пользователя, выбора интервала графика или журнала и др. в проектах с составными фреймами, содержащими множество окон.
# Реализована запись во все источники узла <code>Сигнал простой</code>.

=== Среда разработки ===

# Исправлена ошибка в редактировании свойств типа <code>Цвет</code>, из-за которой иногда некорректно сохранялось значение альфа канала.
# Исправлена ошибка использования одной библиотеки ресурсов в разных проектах.

== 1.6.22-r2d092373a7c2 от 2025-09-24 ==

=== Узлы ===
# Исправлены критические ошибки обращения к свойствам экземпляров объектов при выполнении программ.
# Исправлена ошибка первичного отображения окна тревог.
# Устранены ошибки в работе субмодулей.

=== Среда разработки ===

# Устранены ошибки компиляции проектов, использующих субмодули.

== 1 1.6.21-rb7d9d1301bf0 от 2025-09-18 ==

=== 1.1 Узлы ===

# Исправлена ошибка "онлайн" создания свойств для виджета <code>Ввод значения</code>.
# Реализована проверка свойства <code>Отключен</code> у действий перед выполнением.
# Исправлена ошибка "онлайн" создания свойств экземпляров объектов и связывания их с методами и инициализации значениями.
# AS/PLC 2.38.
# Реализована возможность игнорирования ошибок связи при работе транспорта <code>Modbus-TCP</code> (свойство <code>Действие при превышении порога ошибок 2</code>).
# Реализована инициализация значения сигнала простого значением связанного источника при запуске.
# Реализован кэш методов экземпляров объектов.
# Изменен механизм определения IP-адресов станции.

=== 1.2 Среда разработки ===

# Восстановлена возможность выбора свойств узлов как источников для операций.
# Реализовано отображение признака <code>Отключен</code> узлов в окне выбора узлов.
# Дополнена валидация виджета <code>Ввод значения</code>.

== 1.6.20-r0ad724e1e636 от 2025-08-08 ==

=== Узлы ===

# Добавлена функция <code>int StoreMessage(int iMessageLevel, string strMessage, string strGroup).</code>
# Добавлена возможность вызова методов экземпляров объектов из действий.
# Исправлено выполнение действия <code>Создание события</code>, теперь возможно создание событий из обработчиков.
# В тренды графиков добавлено свойство <code>Единицы измерения</code>.
# Добавлен межстанционный транспорт. Для станций добавлено свойство <code>Роль</code>. Станция с ролью <code>Клиент</code> производит подключение к удаленным станциям с ролью <code>Сервер</code> и уведомляет об изменениях источников и сигналов.
# Устранена ошибочная генерация нескольких дублирующихся событий при работе контроллеров событий.
# В окне <code>Фильтр</code> виджета <code>Список событий</code> размер элементов теперь зависит от свойства системы тревог <code>Размер кнопки</code>.
# Доработаны транспорты <code>Modbus</code>:
#* добавлена [[Транспорты AgavaSCADA/AgavaPLC#Этап 2. Объединение команд записи (функции 15 и 16)|группировка команд записи]] для функций 15 и 16;
#* реализована [[Транспорты AgavaSCADA/AgavaPLC#Этап 1. Дедупликация при постановке в очередь|дедупликация команд записи]].
# Доработан транспорт OPC-UA:
#* исправлены типы свойств;
#* сервер теперь привязывается к порту, указанному в свойстве <code>Адрес</code> (ранее всегда использовался 4840).

=== Среда разработки ===

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

== 1.6.19-r89b594033f4d от 2025-09-02 ==

=== Узлы ===

# Реализовано определение локальной станции для запуска проекта.
# Исправлен запуск узла типа <code>Сигнал простой</code>.

=== Среда разработки ===

# В мастер создания проектов добавлена поддержка АГАВА ПЛК-70.А.
# Исправлена конвертация виджетов <code>Ввод значения</code> при обновлении проекта с версии 1.2.
# Исправлена ошибка в окне настройки исторического графика, связанная с одновременным удалением нескольких трендов.
# Доработана проверка проекта перед сохранением конфигурации. При обнаружении критических ошибок - отказ сохранения.
# Добавлена проверки станций на использование адреса 127.0.0.1, на дублирующиеся IP-адреса.

== 1.6.18-r4a325427448b от 2025-08-06 ==

=== Узлы ===

# Доработана установка аргументов в вызываемые методы экземпляров (добавлен тип <code>string</code> для некоторых сценариев).
# Доработаны узлы <code>Транспорт Modbus-TCP</code>, <code>Транспорт Modbus-RTU</code>:
#* Добавлен узел типа <code>Счетчик</code>, хранящий признак активного подключения к устройству с заданным Modbus адресом.
# Доработан узел <code>Транспорт Modbus-TCP</code>:
#* Реализовано множественное подключение клиентов в режиме работы <code>Сервер</code>.
#* Доработан режим <code>Сервер</code>: добавлена возможность настройки таймаута активности клиента и максимального количества подключений к серверу.
# Узел <code>Шаблонная композиция</code> убран из списка доступных типов для группы "Композиции".
# Исправлена критическая ошибка, изредка возникавшая при переключении окон.
# Исправлена ошибка выполнения действия Закрытие окна.

=== Среда разработки ===

# Исправлена функция просмотра и редактирования списка источников формы.

#

== 1.6.17-r1f70359a00b4 от 2025-08-01 ==

=== Узлы ===

# Исправлена ошибка передачи аргументов типов <code>float</code>, <code>double</code> в методы классов.
# Исправлено связывание свойств экземпляров базовых типов с узлами проекта.
# Доработан вызов методов типа <code>void</code> классов для исключения критических ошибок.
# Для кривых графиков изменена толщина линии по умолчанию на <code>1</code>.
# Исправлена ошибка в команде <code>Сохранить архив проекта</code> - устранено ошибочное создание дубликатов некоторых используемых проектом файлов.
# Доработано восстановление <code>retain</code> - добавлена возможность восстановления в свойства экземпляров классов.
# Изменена конвертация <code>Result</code> в другие типы.

=== Среда разработки ===

# Исправлены ошибки работы отладчика с точками останова в методах и свойствах классов.
# Изменен уровень ошибок компиляции при поиске путей в проекте (Get/SetNodeValueAs... и др.) с <code>Ошибка</code> на <code>Предупреждение</code>.
# Реализовано связывание виджетов со свойствами узлов путем перетаскивания.
# Добавлено местное (inplace) редактирование свойств типа <code>SignalValue</code> в диалоге редактирования сопоставлений, например в окне редактирования сопоставлений виджета <code>Выпадающий список</code>.
# Уточнено сообщение об ошибочном открытии проекта из папки <code>.autosave</code>.
# Доработано окно выбора узлов - кнопка <code>ОК</code> теперь является кнопкой по умолчанию.

=== Примеры ===

# Добавлен пример SQLiteDecimation, демонстрирующий возможности прореживания при записи архива SQLite.
# Доработан пример TestEventsAlarms.

== 1.6.16-r4dc07fc875a4 от 2025-07-18 ==

=== Узлы ===

# Доработан системный транспорт <code>TransportSystem2</code> - изменена процедура остановка сервера для устранения незавершенных соединений.
# Доработаны виджеты <code>Гистограмма</code> и <code>Кнопка</code> - исправлена работа с источником.
# Доработано действие <code>Запуск процесса</code> - исправлен запуск процесса.

=== Среда разработки ===

# Восстановлено обновление BuildNo и даты сборки проекта.

=== ASLauncher ===

# Убрано диалоговое окно с сообщением о частых попытках перезапуска при выходе.
# При запуске приложений из `.desktop` файлов добавлена проверка, что логирование в указанные файлы возможно.
# В файлы логов добавлена информация о версии приложения.

== 1.6.15-r710146e4389e от 2025-07-09 ==

=== Узлы ===

# Узел Система тревог - добавлены настройки окна тревог (ширина, высота, перенос строк в сообщениях).
# Исправлена ошибка в проверке прав на закрытие фрейма, из-за чего в некоторых проектах без системы проверки прав закрытие фрейма не работало.
# Виджет <code>Список событий</code> - исправлена ошибка при работе с диалогом ожидания.
# Действие <code>Авторизация пользователя</code> - добавлено свойство <code>Запрашивать пароль</code>. Действие с включенным свойством <code>Запрашивать пароль</code> будет отображать окно авторизации без возможности смены пользователя.
# Реализована возможность инициализации свойств экземпляров объектов постоянными значениями, задаваемыми в среде разработки (доступны типы bool, int, uint, long, ulong, double, string).
# Для транспортов <code>Modbus-RTU</code>, <code>Modbus-TCP</code> добавлена очистка очереди команд при (ре)старте обмена.

=== Среда разработки ===

# Добавлена поддержка нового системного транспорта. Для подключения к панелям оператора и контроллерам из среды разработки необходимо обновить среду исполнения до версии 1.6.15 или более новой.
# Добавлена иконка для приложения [[Универсальная среда разработки Agava]] (впервые с версии 1.0!).
# Исправлены критические ошибки в webvisu из-за отсутствия qml модулей.

=== Среда исполнения ===

# Откорректировано оформление окна авторизации с целью улучшения привлекательности.

=== Примеры ===

# Добавлены примеры <code>MultiImageLabel</code>, <code>LayersDemo</code>. Пример <code>MultiImageLabel</code> дополнен демонстрацией webvisu.
# Добавлены примеры <code>OpcUaDemo</code>, <code>OpcUaClientDemo</code>.

'''Версия переведена в стабильную стадию.'''

== 1.6.14-r1c61c35c3da4 от 2025-06-20 ==

=== Среда разработки ===

# Добавлена возможность регулирования частоты обновления форм и экранов с композициями. Добавлено свойство "Интервал обновления" для экранов и композиций.
# У виджета "График" изменен форматтер оси времени по умолчанию с "dd.MM.yy hh:mm:ss" на "dd.MM.yyyy hh:mm:ss".

=== Среда исполнения ===

# Оптимизирован вывод информации на экран - исключена повторная отрисовка виджетов, при записи значений в их свойства из скриптов и программ.
# Реализовано профилирование вызова базовых методов и работы с контекстами.
# Реализован вывод информации о перерисовке виджетов в консоль с настройкой через файл as.ini.

=== Примеры ===

# Добавлен пример <code>WindowUpdateRate</code>, демонстрирующий возможность ограничения частоты обновления окон.

== 1.6.13-r13248581de39 от 2025-06-17 ==

=== Среда разработки ===

# Исправлена ошибка функции "Просмотр событий", из-за которой некорректно выдавались события в проектах без логгеров.
# Реализовано копирование станций ПК-40, ПК-50, ПК-60.
# Устранено сохранение в архив проекта файлов .bi?, хранящихся в подпапках, начинающихся с точки. Например .autosave, .backup
# Разрешено добавление приложений к станциям ПО-40, ПО-50, ПО-60.
# Убрана зависимость от библиотеки libclang.

=== Среда исполнения ===

# Реализован вывод информации о регионах перерисовки окон в консоль с настройкой через файл as.ini.
# Доработаны методы BasicSignal::GetValue, BasicSignal::SetValue для корректного обращения к узлам проекта.
# Исправлена ошибка в работе со светодиодами станции ПК-40.
# Исправлено создание BasicSource("path"), BasicSignal("path"), BasicWidget("path") в программах. Теперь появилась возможность доступа ко всем свойствам узла проекта, а не только к свойствам, определенным в BasicNode.
# Добавлена проверка типа при создании экземпляра BasicSource (ОМ).

=== Примеры ===

# Разработан пример <code>Leds</code>, демонстрирующий работу со светодиодами ПО-50 из программы с использованием объектной модели.

=== ASLauncher ===

# Добавлен скрипт для восстановления <code>explorer.exe</code> в качестве оболочки рабочего стола после установки ASLauncher.

== 1.6.12-r17b244111a8c от 2025-05-30 ==

=== Среда разработки ===

# Исправлена ошибка, возникавшая при перемещении узлов в дереве проекта, из-за которой перемещаемые узлы пропадали.
# Добавлено текстовое описание при появлении окна с ошибками, например при сохранении проекта.
# Узел <code>Операция Пара условий</code> - исправлены имена свойств. В проектах версии 1.2 операция не работала в режиме проверки двух условий. '''Необходимо проверить корректность настроек при переходе с версии 1.2.'''
# Исправлена ошибка определения уровня логгеров при вызове команды <code>Просмотр событий</code>, из-за которой при наличии в проекте логгеров с уровнями логгирования <code>INFO</code> в окно событий не попадали события ниже уровнем.

=== Среда исполнения ===

# Оптимизация узла <code>Транспорт TCP</code>.
# Оптимизирована система журналирования.

== 1.6.8-r915d8d477fa4 от 2025-05-14 ==

=== Среда разработки ===
# Исправлено несоответствие настроек узла <code>Действие "Команда узлу"</code> и фактически исполняемых команд. '''При обновлении на эту версию необходимо проверить корректность настроек всех улов типа <code>Действие "Команда узлу"</code>.'''

[[Категория:AgavaSCADA/AgavaPLC]]
__NOTOC__

Описание языка С++ в AgavaSCADA/AgavaPLC

2026-04-24T12:25:08Z

TaushkanovKV: /* Класс filesystem */

Данное описание содержит базовое руководство по созданию программ на языке С++ и их использовании в [[Универсальная среда разработки|среде разработки Agava]].

== Дополнительные документы ==

* [[Описание базовых классов AgavaSCADA/AgavaPLC]].
* [[Объектная модель AgavaSCADA/AgavaPLC]].

== Основы синтаксиса ==
Все программы на языке С++ состоят из отдельных действий. Каждое действие заканчивается точкой с запятой:
int x;
x = 1;
int y = x + 2;
Для повышения удобства работы с кодом можно оставлять в нем комментарии, которые не используются при работе программы и предназначены для улучшения читаемости кода. Перед комментариями ставится «//»:
bool x = true;
// bool x = false;
// вторая строка не будет выполняться в программе

== Переменные ==
Переменные – объекты, хранящиеся в памяти, над которыми и производятся действия в программе.

Для начала работы с переменной необходимо инициализировать ее, указав тип и имя, а затем, при необходимости, присвоить ей значение:
bool a = true;
int b = 1;
double c = 1.1;
string d = “строка”;

int f; // переменная инициализирована, значение не присвоено
f = 1; // присвоение значения
Ключевое слово auto при инициализации переменной может использоваться вместо типа переменной, для автоматического присвоения типа переменной исходя из инициализируемого значения.
auto a = true;
auto b = 1;

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

При работе со строками доступны следующие функции:
{| class="wikitable"
!Функция
!Действие
|-
|uint length()
|Возвращает длину строки
|-
|void resize(uint)
|Устанавливает длину строки
|-
|bool isEmpty()
|Возвращает истину, если строка пуста, т. е. длина равна нулю
|-
|string substr(uint start = 0, int count = -1)
|Возвращает строку с содержимым, начинающимся с start, и количеством байтов, заданным параметром count. Аргументы по умолчанию вернут всю строку как новую строку
|-
|void insert(uint pos, const string &in other)
|Вставляет другую строку string на позиции pos в исходной строке
|-
|void erase(uint pos, int count = -1)
|Удаляет количество символов count из строки, начиная с позиции pos
|-
|int findFirst(const string &in str, uint start = 0)
|Находит первое вхождение значения str в строке, начиная с символа под номером start. Если вхождения не найдено, будет возвращено отрицательное значение
|-
|int findFirstOf(const string &in str, uint start = 0)
|Находит первое вхождение одного из символов в str в строке, начиная с символа под номером start. Если вхождения не найдено, будет возвращено отрицательное значение
|-
|int findLast(const string &in str, int start = -1)
|Находит последнее вхождение значения str в строке
|-
|int findLastOf(const string &in str, int start = -1)
|Находит последнее вхождение одного из символов в str в строке, начиная с символа под номером start. Если вхождения не найдено, будет возвращено отрицательное значение
|-
|string formatInt(int64 val, const string &in options = "", uint width=0)
|Преобразование int в строку
|-
|string formatUInt(uint64 val, const string &in options = "", uint width=0)
|Преобразование uint в строку
|-
|string formatFloat(double val, const string &in options="", uint width=0, uint precision=0)
|Преобразование float и double в строку
|-
|int64 parseInt(const string &in str, uint base=10, uint &out byteCount=0)
|Преобразование строки в int64
|-
|uint64 parseUInt(const string &in str, uint base=10, uint &out byteCount=0)
|Преобразование строки в uint64
|-
|double parseFloat(const string &in str, uint &out byteCount=0)
|Преобразование строки в double
|}
Пример работы с функциями для строк:
string str = “ABCDEF”; // инициализирована строка str

int a = str.length(); // a равно 6
int b = str.findFirst(“CD”, 0); // b равно 2

str.erase(1, 3); // str равно “AEF”

string str = "НАСОС1";
string substrToRemove = "НАСОС";

int pos = str.findFirst(substrToRemove);

if (pos >= 0)
{
str.erase(pos, substrToRemove.length()); // Теперь str содержит "1"
}

=== Массивы ===
Массив — многоэлементный тип данных, который позволяет получить доступ ко всем переменным одного и того же типа данных через использование одного идентификатора. Используется в том случае, если вам необходимо сгруппировать несколько элементов одного типа:
array <int> a = {2, 5, 10, 15, 20}; // инициализирован массив a с пятью элементами
int x = a [0]; // x становится равен элементу массива а под номером 0 (2)
int y = a [4]; // y становится равен элементу массива а под номером 4 (20)
arr [3] = 11; // элемент массива а под номером 3 становится равен 11
int z = arr [3]; // z становится равен элементу массива а под номером 3 (11)
Важно помнить, что нумерация членов массива начинается с 0.

При работе с массивами доступны следующие функции:
{| class="wikitable"
!Функция
!Действие
|-
|length()
|Возвращает длину массива
|-
|resize(uint)
|Устанавливает новую длину массива
|-
|reverse()
|Меняет порядок элементов в массиве на обратный
|-
|insertAt(uint index, const T& in value)
|Вставляет новый элемент в массив по указанному индексу
|-
|insertLast(const T& in)
|Добавляет элемент в конец массива
|-
|removeAt(uint index)
|Удаляет элемент по указанному индексу
|-
|removeLast()
|Удаляет последний элемент массива
|-
|removeRange(uint start, uint count)
|Удаляет количество элементов count, начиная с элемента номер start
|-
|sortAsc ()
|Сортирует элементы в массиве в порядке возрастания
|-
|sortDesc ()
|Сортирует элементы в массиве в порядке убывания
|-
|find (const T &in)
|Возвращает индекс первого элемента, который имеет то же значение, что и желаемое. Если совпадений не найдено, возвращает отрицательное значение
|}
Пример работы с функциями для массивов:
int main()
{
array<int> arr = {1,2,3}; // 1,2,3
arr.insertLast(0); // 1,2,3,0
arr.insertAt(2,4); // 1,2,4,3,0
arr.removeAt(1); // 1,4,3,0
arr.sortAsc(); // 0,1,3,4
int sum = 0;

for( uint n = 0; n < arr.length(); n++ )
sum += arr[n];

return sum;
}

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

Значения перечислений объявляются путем их объявления в операторе перечисления. Если для константы перечисления не указано конкретное значение, она будет принимать значение предыдущей константы плюс 1. Первая константа получит значение 0, если не указано иное.
enum Errors
{
 NoError, // = 0
 ReadError = 2, // = 2
 WriteError, // = 3
}

// теперь к константам перечисления можно обращаться через текстовое значение, например
// int a = NoError;

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

Логические переменные
{| class="wikitable"
!Тип
!Мин. значение
!Макс. значение
|-
|bool
|false (0)
|true (1)
|}
Целочисленные переменные
{| class="wikitable"
!Тип
!Мин. значение
!Макс. значение
|-
|int8
|<nowiki>- 128</nowiki>
|127
|-
|int16
|<nowiki>- 32 768</nowiki>
|32 767
|-
|int
|<nowiki>- 2 147 483 648</nowiki>
|2 147 483 647
|-
|int64
|<nowiki>- 9 223 372 036 854 775 808</nowiki>
|9 223 372 036 854 775 807
|-
|uint8
|0
|255
|-
|uint16
|0
|65 535
|-
|uint
|0
|4 294 967 295
|-
|uint64
|0
|18 446 744 073 709 551 615
|}
Переменные с плавающей запятой
{| class="wikitable"
!Тип
!Диапазон значений
!Наименьшее значение
|-
|float
|± 3.402823466 e+38
|1.175494351 e-38
|-
|double
|± 1.79769313486231 e+308
|2.22507385850720 e-308
|}

== Операторы ==
Доступны операторы сравнения, логические, побитовые, арифметические, приращений и индексации.

=== Операторы сравнения ===
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Равно
|==
|x == y
|true, если x равно y
|-
|Не равно
|!=
|x != y
|true, если x не равно y
|-
|Меньше
|<
|x < y
|true, если x меньше y
|-
|Больше
|>
|x > y
|true, если x больше y
|-
|Меньше или равно
|<=
|x <= y
|true, если x меньше или равно y
|-
|Больше или равно
|>=
|x >= y
|true, если x больше или равно y
|}

=== Логические операторы ===
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Логическое НЕ
|!
|!x
|true, если x – false и false, если x – true
|-
|Логическое И
|&&
|x && y
|true, если x и y – true, в противном случае – false
|-
|Логическое ИЛИ
|<nowiki>||</nowiki>
|<nowiki>x || y</nowiki>
|true, если x или y – true, в противном случае – false
|-
|Логическое ИСКЛЮЧАЮЩЕЕ ИЛИ (XOR)
|^
|x ^ y
|true, если x или y – true (но не одновременно), в противном случае – false
|}

=== Побитовые операторы ===
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Побитовое И
|&
|x & y
|Каждый бит в x И каждый соответствующий ему бит в y
|-
|Побитовое ИЛИ
|<nowiki>|</nowiki>
|<nowiki>x | y</nowiki>
|Каждый бит в x ИЛИ каждый соответствующий ему бит в y
|-
|Побитовое ИСКЛЮЧАЮЩЕЕ ИЛИ (XOR)
|^
|x ^ y
|Каждый бит в x XOR с каждым соответствующим ему битом в y
|-
|Побитовый сдвиг влево
|<<
|x << y
|Все биты в x смещаются влево на y бит
|-
|Побитовый сдвиг вправо
|>>
|x >> y
|Все биты в x смещаются вправо на y бит
|}
'''Пример'''
float RegistersToFloat(uint16 r0, uint16 r1)
{
// Создаем массив байтов в little-endian порядке
array<uint8> bytes(4);

// Little-endian (наиболее распространенный)
bytes[0] = r0 & 0xFF;
bytes[1] = (r0 >> 8) & 0xFF;
bytes[2] = r1 & 0xFF;
bytes[3] = (r1 >> 8) & 0xFF;

 // Преобразуем байты в uint32, затем в float
uint32 resultBits = 0;

for (uint i = 0; i < 4; i++)
{
resultBits |= uint32(bytes[i]) << (i * 8);
}

return fpFromIEEE(resultBits);
}

=== Арифметические операторы ===
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Сложение
|<nowiki>+</nowiki>
|x + y
|Складываем x и y
|-
|Вычитание
|<nowiki>-</nowiki>
|x – y
|Вычитаем y из x
|-
|Умножение
|*
|x * y
|Умножаем x на y
|-
|Деление
|/
|x / y
|Делим x на y
|-
|Присваивание
|=
|x = y
|Присваиваем значение y переменной x
|-
|Сложение с присваиванием
|<nowiki>+=</nowiki>
|x += y
|Добавляем y к x
|-
|Вычитание с присваиванием
|<nowiki>-=</nowiki>
|x -= y
|Вычитаем y из x
|-
|Умножение с присваиванием
|*=
|x *= y
|Умножаем x на y
|-
|Деление с присваиванием
|/=
|x /= y
|Делим x на y
|}

=== Операторы приращений ===
Операция инкремента увеличивает значение на 1, декремента – уменьшает на 1.
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Преинкремент
|<nowiki>++</nowiki>
|<nowiki>++х</nowiki>
|Инкремент х, затем вычисление х
|-
|Предекремент
|<nowiki>--</nowiki>
|<nowiki>--х</nowiki>
|Декремент х, затем вычисление х
|-
|Постинкремент
|<nowiki>++</nowiki>
|х++
|Вычисление х, затем инкремент х
|-
|Постдекремент
|<nowiki>--</nowiki>
|х--
|Вычисление х, затем декремент х
|}

=== Оператор индексации ===
Используется для доступа к элементу.
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Индексация
|[ ]
|arr [0]
|Обращение к нулевому элементу массива arr
|}

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

Внешние блоки не имеют доступа к переменным внутренних блоков.
{
 int a;
 float b;
 {
 float a = 1.0; // Отменить объявление внешней переменной
// но только в пределах внутреннего блока
 b = a; // переменные из внешних блоков все еще доступны
 int c;
 }

 // a снова становится целочисленной переменной, b теперь равна 1.0, c здесь недоступна
}

== Условия ==

=== Операторы if/else ===
Позволяют выбрать выполнение нужных действий, в зависимости от выбранного условия, указанного в скобках:
if (x == 1)
{
// эти действия выполнятся, если х равно 1
}
else
{
// эти действия выполнятся, если х не равно 1
}

=== Условное выражение (тернарный оператор) ===
Более короткая запись оператора выбора if/else:
x = 1 ? y = true : y = false; // если х равно 1, тогда y равен true, иначе y равен false

=== Оператор switch ===
Является альтернативой if/else для тех случаев, когда необходимо сделать множественный выбор:
switch(x)
{
case 0:
 // эти действия выполнятся, если х равно 0
 break; // каждый case всегда должен заканчивать оператором break
case 1:
 // эти действия выполнятся, если х равно 1
 break;
case 2:
 // эти действия выполнятся, если х равно 2
 break;
default:
 // Эти действия выполнятся, если x не равен ни одному из предыдущих значений case
}

== Циклы ==

=== Цикл while ===
Цикл выполняется, пока условие в скобках истинно:
x = 0;

while (x < 5)
{
// это действие будет выполняться, пока х меньше 5
x++; // при каждом выполнении цикла увеличиваем х на 1
}

=== Цикл do while ===
Цикл похож на while, но, в отличии от него, цикл в любом случае выполнится хотя бы один раз (или больше, если при последующих проверках условие будет истинно):
x = 10;

do
{
// это действие выполнится один раз, так как условие изначально ложно
}
while (x < 5);

=== Цикл for ===
Цикл for обычно используется как счетчик и хорошо подходит, когда известно необходимое количество итераций. В скобках через точку с запятой указывается переменная, условие, инкремент / декремент для переменной:
for ( int x = 0; x < 5; x ++ )
{
// при каждом выполнении этих действий переменная х будет увеличивать на 1
// действия будут выполняться пока х меньше 5
}

== Функции ==
Функция — это последовательность действия для выполнения определенного задания. Объявление функции похоже на объявление переменной: необходимо указать тип возвращаемого значения (либо void, если функция ничего не возвращает) и название функции. После этого ставятся двойные скобки, в которых находятся аргументы функции (либо пустые скобки, если аргументы отсутствуют). Действия, выполняемые функцией, заключаются в фигурные скобки.

Любой код в операции «Скрипт С++» должен находиться в функции. При использовании нескольких функций в скрипте будет выполняться только первая, остальные должны быть вызваны из нее:
void main ()
{
int x = 1;
function (); // вызов функции, программа переходит в void function()
SetNodeValueAsInt(“/Конфигурация/Станция/Сигналы/Constant2”, x);
}

void function ()
{
SetNodeValueAsInt(“/Конфигурация/Станция/Сигналы/Constant2”, 5);
// теперь программа возвращается обратно в void main()
}
После выполнения данного скрипта значение сигнала Constant1 станет равно 5, а Constant2 равно 1.

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

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

Параметры указываются при объявлении функции в круглых скобках:
void summ (int x, int y) // в функцию передаются параметры х = 1 и y = 2
{
int z = x + y; // z равно 3
}

=== Возврат значения ===
Для передачи значения из скрипта можно указать необходимое значение в действии return, указав тип функции такой же, как у возвращаемого значения:
bool R_Output (bool x, bool y)
{
bool z = false;
z = x && y;

return z; // z передается на выход скрипта
}

== Математические и тригонометрические функции ==

===Преобразование IEEE битов===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float fpFromIEEE(uint bits)</code>
|Преобразует 32-битное IEEE-754 представление в число float
|<code>bits</code> (uint) - битовое представление
|-
|<code>uint fpToIEEE(float value)</code>
|Преобразует число float в 32-битное IEEE-754 представление
|<code>value</code> (float) - исходное число
|-
|<code>double fpFromIEEE(uint64 bits)</code>
|Преобразует 64-битное IEEE-754 представление в число double
|<code>bits</code> (uint64) - битовое представление
|-
|<code>uint64 fpToIEEE(double value)</code>
|Преобразует число double в 64-битное IEEE-754 представление
|<code>value</code> (double) - исходное число
|}

=== Сравнение с допуском===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>bool closeTo(float a, float b, float epsilon = 0.00001f)</code>
|Сравнивает два числа float с заданной погрешностью
|<code>a</code> (float) - первое число
<code>b</code> (float) - второе число
<code>epsilon</code> (float, опционально) - погрешность (по умолчанию 0.00001)
|-
|<code>bool closeTo(double a, double b, double epsilon = 0.0000000001)</code>
|Сравнивает два числа double с заданной погрешностью
|<code>a</code> (double) - первое число
<code>b</code> (double) - второе число
<code>epsilon</code> (double, опционально) - погрешность (по умолчанию 1e-10)
|}

=== Тригонометрические функции ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float cos(float angle)</code>
|Вычисляет косинус угла
|<code>angle</code> (float) - угол в радианах
|-
|<code>float sin(float angle)</code>
|Вычисляет синус угла
|<code>angle</code> (float) - угол в радианах
|-
|<code>float tan(float angle)</code>
|Вычисляет тангенс угла
|<code>angle</code> (float) - угол в радианах
|-
|<code>float acos(float value)</code>
|Вычисляет арккосинус (обратный косинус)
|<code>value</code> (float) - значение в диапазоне [-1, 1]
|-
|<code>float asin(float value)</code>
|Вычисляет арксинус (обратный синус)
|<code>value</code> (float) - значение в диапазоне [-1, 1]
|-
|<code>float atan(float value)</code>
|Вычисляет арктангенс (обратный тангенс)
|<code>value</code> (float) - значение
|-
|<code>float atan2(float y, float x)</code>
|Вычисляет арктангенс двух переменных
|<code>y</code> (float) - координата Y
<code>x</code> (float) - координата X
|}

=== Гиперболические функции ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float cosh(float x)</code>
|Вычисляет гиперболический косинус
|<code>x</code> (float) - значение
|-
|<code>float sinh(float x)</code>
|Вычисляет гиперболический синус
|<code>x</code> (float) - значение
|-
|<code>float tanh(float x)</code>
|Вычисляет гиперболический тангенс
|<code>x</code> (float) - значение
|}

=== Экспоненциальные и логарифмические функции ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float log(float x)</code>
|Вычисляет натуральный логарифм (по основанию e)
|<code>x</code> (float) - значение > 0
|-
|<code>float log10(float x)</code>
|Вычисляет десятичный логарифм (по основанию 10)
|<code>x</code> (float) - значение > 0
|}

=== Степенные функции ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float pow(float base, float exponent)</code>
|Возводит число в степень
|<code>base</code> (float) - основание
<code>exponent</code> (float) - показатель степени
|-
|<code>float sqrt(float x)</code>
|Вычисляет квадратный корень
|<code>x</code> (float) - неотрицательное значение
|}

=== Функции округления и остатка ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float ceil(float x)</code>
|Округляет вверх до ближайшего целого
|<code>x</code> (float) - значение
|-
|<code>float abs(float x)</code>
|Вычисляет абсолютное значение (модуль)
|<code>x</code> (float) - значение
|-
|<code>float floor(float x)</code>
|Округляет вниз до ближайшего целого
|<code>x</code> (float) - значение
|-
|<code>float fraction(float x)</code>
|Выделяет дробную часть числа
|<code>x</code> (float) - значение
|}

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

===Функции для работы с узлами===
{| class="wikitable"
!Определение функции
!Описание
|-
|float GetNodeValueAsFloat(string strNodePath)
|Получить значение узла в виде float по заданному пути
|-
|void SetNodeValueAsFloat(string strNodePath, float fValue)
|Установить значение узла в float по заданному пути
|-
|int GetNodeValueAsInt(string strNodePath)
|Получить значение узла в виде int по заданному пути
|-
|void SetNodeValueAsInt(string strNodePath, int iValue)
|Установить значение узла в int по заданному пути
|-
|string GetNodeValueAsString(string strNodePath)
|Получить значение узла в виде string по заданному пути
|-
| void SetNodeValueAsString(string strNodePath, string strValue)
|Установить значение узла в виде string по заданному пути
|-
|bool GetNodeValueAsBool(string strNodePath)
|Получить значение узла в виде bool по заданному пути
|-
|void SetNodeValueAsBool(string strNodePath, bool bValue)
|Установить значение узла в виде bool по заданному пути
|-
|bool NodeValueIsError(string strNodePath)
|Проверка значения узла на ошибку
|-
|void StartNode(string strNodePath)
|Запуск узла по заданному пути
|-
|void StopNode(string strNodePath)
|Остановка узла по заданному пути
|}

===Функции для работы с окнами ===
{| class="wikitable"
!Определение функции
!Описание
|-
| <code>void CloseWindow(string strNodePath, int iDisplay)</code>
|Закрыть окно по заданному пути на дисплее с номером iDisplay
|-
|<code>void ShowWindow(string strNodePath, int iDisplay)</code>
|Отобразить окно по заданному пути на дисплее с номером iDisplay.
Координаты - абсолютные, установленные в свойствах окна.
|-
|<code>int LoadComposition(string strWindowPath, string strCompositionPath, int iDisplay)</code>
|Загрузить композицию strCompositionPath в окно strWindowPath на дисплее с номером iDisplay.
<code>AS 1.6.25+</code>
|}

===Функции для работы с временем===
{| class="wikitable"
!Определение функции
!Описание
|-
|int GetCurrentTime()
|Получение текущего времени в UNIX формате (количество секунд с 01 января 1970 года)
|-
|uint64 GetCurrentTimeMs()
|Получение текущего времени в UNIX формате (количество миллисекунд с 01 января 1970 года) (<code>AS 1.2.55+</code>, <code>AS 1.6.1+</code>)
|-
|int GetLocalTime()
| Получение текущего времени в UNIX формате (количество секунд с 01 января 1970 года) с учетом часового пояса
|-
|int GetHours(int iTime)
| Получение текущего часа из времени в формате UNIX
|-
|int GetMinutes(int iTime)
|Получение текущих минут из времени в формате UNIX
|-
|int GetSeconds(int iTime)
|Получение текущих секунд из времени в формате UNIX
|}

===Функции для работы с событиями===
'''int StoreMessage(int iMessageLevel, string strMessage)'''
{| class="wikitable"
|-
|'''Назначение'''
|Генерация информационного события (типа "сообщение"). Событие помещается в группу "Системные".
|-
|'''Возвращаемое значение'''
|0 - успешно, иначе код ошибки
|-
| rowspan="2" |'''Аргументы'''
|int iMessageLevel - уровень сообщения (1-наивысший): 1=FATAL, 2=ERROR, 3=WARNING, 4=NOTICE, 5=INFO, 6=TRACE, 7=DEBUG
|-
|string strMessage - текст сообщения
|-
|'''Примечания'''
|функция доступна с версии <code>AS 1.2.34+</code>
|}
'''int StoreMessage(int iMessageLevel, string strMessage, string strGroup)'''
{| class="wikitable"
|-
|'''Назначение'''
|Генерация информационного события (типа "сообщение"). Событие помещается в указанную при вызове группу.
|-
|'''Возвращаемое значение'''
|0 - успешно, иначе код ошибки
|-
| rowspan="3" |'''Аргументы'''
|int iMessageLevel - уровень сообщения (1-наивысший): 1=FATAL, 2=ERROR, 3=WARNING, 4=NOTICE, 5=INFO, 6=TRACE, 7=DEBUG
|-
|string strMessage - текст сообщения
|-
|string strGroup - имя группы, в которую должно помещаться событие.
|-
|'''Примечания'''
|функция доступна с версии <code>AS 1.6.20+</code>
|}

===Функции для работы со строками===
'''string EncodeMD5(string strText)'''
{| class="wikitable"
|-
|'''Назначение'''
|Кодирование строки в MD5 хэш
|-
|'''Возвращаемое значение'''
|MD5 хэш параметра
|-
|'''Аргументы'''
|string strText - исходная строка
|-
|'''Примечания'''
| функция доступна с версии <code>AS 1.2.34+</code>
|}

===Другие функции===
Проверка на nan.
'''bool isnan(double)'''

Запуск процесса в операционной системе.
'''int LaunchProcess(string process)'''
Запуск производится в блокирующем режиме, то есть возврат из функции осуществляется по завершению процесса.

==Класс file==
Класс доступен начиная с версии 1.4.5 AgavaSCADA/AgavaPLC.

===Методы===
'''int open(const string& filename, const string& mode)'''
{| class="wikitable"
|-
|'''Назначение'''
|Открытие файла
|-
|'''Возвращаемое значение'''
|Результат выполнения операции: 0 - успешно, -1 - ошибка.
|-
| rowspan="2" |'''Аргументы'''
|const string& filename - путь до файла
|-
|const string& mode - режим открытия файла.
|}
'''int close()'''
{| class="wikitable"
|-
|'''Назначение'''
|Закрытие файла
|-
|'''Возвращаемое значение'''
|Результат выполнения операции. 0 - успешно, -1 - ошибка.
|-
|'''Аргументы'''
| -
|}
'''int getSize() const'''
{| class="wikitable"
|-
|'''Назначение'''
|Получение размера файла
|-
|'''Возвращаемое значение'''
|Размер файла в байтах
|-
|'''Аргументы'''
| -
|}
'''bool isEndOfFile() const'''
{| class="wikitable"
|-
|'''Назначение'''
| Получение признака конца файла
|-
|'''Возвращаемое значение'''
|true - обнаружен конец файла.
|-
|'''Аргументы'''
| -
|}
'''string readString(uint length)'''
{| class="wikitable"
|-
|'''Назначение'''
|Чтение строки
|-
|'''Возвращаемое значение'''
|Считанная строка
|-
|'''Аргументы'''
|uint length - длина считываемой строки
|}
'''string readLine()'''
{| class="wikitable"
|-
|'''Назначение'''
|Чтение строки
|-
|'''Возвращаемое значение'''
|Считанная строка
|-
|'''Аргументы'''
| -
|-
|'''Примечания'''
| Считывание производится до тех пор, пока не будет обнаружен символ '\n' или конец файла
|}
'''int64 readInt(uint)'''
'''Назначение:''' чтение целого числа со знаком.

'''Возвращаемое значение''': считанное значение.

'''Аргументы''': отсутствуют.

'''Примечания''': отсутствуют.
'''uint64 readUInt(uint)'''
'''Назначение:''' чтение целого беззнакового числа.

'''Возвращаемое значение''': считанное значение.

'''Аргументы''': отсутствуют.

'''Примечания''': отсутствуют.
'''float readFloat()'''
'''Назначение:''' чтение целого вещественного числа одинарной точности.

'''Возвращаемое значение''': считанное значение.

'''Аргументы''': отсутствуют.

'''Примечания''': отсутствуют.

double readDouble()

int writeString(const string &in)

int writeInt(int64, uint)

int writeUInt(uint64, uint)

int writeFloat(float)

int writeDouble(double)

int getPos() const

int setPos(int)

int movePos(int)

===Поля===
bool mostSignificantByteFirst.

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

Класс доступен начиная с версии <code>AS 1.6+</code>.

=== Методы ===
'''bool changeCurrentPath(const string &in path)'''
'''Назначение:''' Изменяет текущую рабочую директорию.

'''Аргументы:'''

* <code>path</code> – путь к новой директории (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>true</code> – если путь существует и текущая директория успешно изменена.
* <code>false</code> – если указанный путь не существует или не является директорией.

'''Примечания:'''

* Если путь задан относительно, он объединяется с текущей директорией.
* Путь не должен содержать обратные слеши <code>\</code> – они автоматически заменяются на <code>/</code>.
* Завершающие слеши автоматически удаляются из пути.
* Не поддерживает разрешение внутренних ссылок <code>/./</code> и <code>/../</code> (отмечено в TODO).
'''string getCurrentPath() const'''
'''Назначение:''' Возвращает текущую рабочую директорию.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Строка с абсолютным путём текущей директории, использующая разделители <code>/</code>.

'''Примечания:'''

* При создании объекта <code>filesystem</code> текущая директория инициализируется рабочим каталогом приложения.
* Все обратные слеши <code>\</code> заменяются на <code>/</code> для единообразия.
'''array<string> @getDirs() const'''
'''Назначение:''' Получает список всех поддиректорий внутри текущей директории.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Массив строк с именами поддиректорий.

'''Примечания:'''

* Специальные записи <code>.</code> (текущая директория) и <code>..</code> (родительская директория) исключаются из результата.
* Возвращает пустой массив, если директорий нет или произошла ошибка чтения.
'''array<string> @getFiles() const'''
'''Назначение:''' Получает список всех файлов внутри текущей директории.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Массив строк с именами файлов.

'''Примечания:'''

* В результат включаются только файлы, директории исключаются.
* Возвращает пустой массив, если файлов нет или произошла ошибка чтения.
'''bool isDir(const string &in path) const'''
'''Назначение:''' Проверяет, является ли указанный путь директорией.

'''Аргументы:'''

* <code>path</code> – путь к объекту файловой системы (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>true</code> – если объект существует и является директорией.
* <code>false</code> – если объект не существует, не является директорией или произошла ошибка.

'''Примечания:'''

* Относительные пути разрешаются относительно текущей директории.
* Абсолютные пути определяются наличием двоеточия <code>:</code> (например, <code>C:</code>) или начального слеша <code>/</code> или <code>\</code>.
'''bool isLink(const string &in path) const'''
'''Назначение:''' Проверяет, является ли указанный путь символической ссылкой (symlink).

'''Аргументы:'''

* <code>path</code> – путь к объекту файловой системы (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>true</code> – если объект существует и является символической ссылкой (на Windows – репарс-точкой).
* <code>false</code> – если объект не является ссылкой, не существует или произошла ошибка.

'''Примечания:'''

* Кроссплатформенная поддержка: Windows (атрибут <code>FILE_ATTRIBUTE_REPARSE_POINT</code>) и POSIX (флаг <code>S_IFLNK</code>).
* Относительные пути разрешаются относительно текущей директории.
'''int64 getSize(const string &in path) const'''
'''Назначение:''' Возвращает размер файла в байтах.

'''Аргументы:'''

* <code>path</code> – путь к файлу (относительный или абсолютный).

'''Возвращаемое значение:'''

* Размер файла в байтах (тип <code>int64</code>).
* <code>-1</code> – если файл не существует, указан путь к директории или произошла ошибка.

'''Примечания:'''

* На Windows используется API-функция <code>GetFileSizeEx</code>.
* На POSIX-системах используется <code>stat</code>.
* Для директорий возвращает <code>-1</code>.
'''int makeDir(const string &in path)'''
'''Назначение:''' Создаёт новую директорию.

'''Аргументы:'''

* <code>path</code> – путь к создаваемой директории (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>0</code> – директория успешно создана.
* <code>-1</code> – ошибка создания (например, недостаточно прав, путь не существует).

'''Примечания:'''

* '''Важно:''' Не поддерживает рекурсивное создание промежуточных директорий (отмечено в TODO).
* На Windows создаёт директорию с правами по умолчанию.
* На POSIX создаёт с правами <code>S_IRWXU | S_IRWXG | S_IROTH | S_IXOTH</code> (755: чтение/запись/исполнение для владельца, чтение/исполнение для группы и остальных).
'''int removeDir(const string &in path)'''
'''Назначение:''' Удаляет пустую директорию.

'''Аргументы:'''

* <code>path</code> – путь к удаляемой директории (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>0</code> – директория успешно удалена.
* <code>-1</code> – ошибка удаления (директория не пуста, не существует, недостаточно прав).

'''Примечания:'''

* Удаляет только '''пустые''' директории.
* Не поддерживает рекурсивное удаление с содержимым (отмечено в TODO).
* На Windows используется <code>RemoveDirectoryW</code>, на POSIX – <code>rmdir</code>.
'''int deleteFile(const string &in path)'''
'''Назначение:''' Удаляет файл.

'''Аргументы:'''

* <code>path</code> – путь к удаляемому файлу (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>0</code> – файл успешно удалён.
* <code>-1</code> – ошибка удаления (файл не существует, недостаточно прав, указана директория).

'''Примечания:'''

* На Windows используется <code>DeleteFileW</code>, на POSIX – <code>unlink</code>.
* Для удаления директорий используйте <code>removeDir</code>.
'''int copyFile(const string &in source, const string &in target)'''
'''Назначение:''' Копирует файл из одного местоположения в другое.

'''Аргументы:'''

* <code>source</code> – путь к исходному файлу.
* <code>target</code> – путь к целевому файлу (не директории).

'''Возвращаемое значение:'''

* <code>0</code> – файл успешно скопирован.
* <code>-1</code> – ошибка копирования (исходный файл не существует, недостаточно прав, целевой файл уже существует).

'''Примечания:'''

* На Windows используется API-функция <code>CopyFileW</code> с параметром <code>TRUE</code> (не перезаписывать существующий файл).
* На POSIX-системах копирование выполняется '''вручную''' побайтово через <code>fopen/fread/fwrite</code>, так как стандартной функции копирования нет.
* Целевой файл не должен существовать (флаг <code>TRUE</code> на Windows).
'''int move(const string &in source, const string &in target)'''
'''Назначение:''' Перемещает или переименовывает файл или директорию.

'''Аргументы:'''

* <code>source</code> – текущий путь к объекту.
* <code>target</code> – новый путь или имя объекта.

'''Возвращаемое значение:'''

* <code>0</code> – объект успешно перемещён/переименован.
* <code>-1</code> – ошибка операции (объект не существует, недостаточно прав).

'''Примечания:'''

* Может использоваться как для файлов, так и для директорий.
* На Windows используется <code>MoveFileW</code>, на POSIX – <code>rename</code>.
* Операция может выполняться в пределах одного тома/файловой системы.
'''datetime getCreateDateTime(const string &in path) const'''
'''Назначение:''' Возвращает дату и время создания файла или директории.

'''Аргументы:'''

* <code>path</code> – путь к объекту файловой системы.

'''Возвращаемое значение:'''

* Объект <code>datetime</code>, содержащий дату и время создания.

'''Примечания:'''

* '''Выбрасывает исключение''' в скриптовом контексте через <code>SetException</code>, если не удаётся получить дату создания.
* На Windows используется <code>GetFileTime</code> с полем <code>createTm</code>.
* На POSIX-системах используется поле <code>st_ctime</code> (change time) – может отличаться от реального времени создания на некоторых файловых системах.
'''datetime getModifyDateTime(const string &in path) const'''
'''Назначение:''' Возвращает дату и время последнего изменения файла или директории.

'''Аргументы:'''

* <code>path</code> – путь к объекту файловой системы.

'''Возвращаемое значение:'''

* Объект <code>datetime</code>, содержащий дату и время последней модификации.

'''Примечания:'''

* '''Выбрасывает исключение''' в скриптовом контексте через <code>SetException</code>, если не удаётся получить дату изменения.
* На Windows используется <code>GetFileTime</code> с полем <code>modifyTm</code>.
* На POSIX-системах используется поле <code>st_mtime</code> (modify time).

==Класс datetime==
Класс доступен начиная с версии <code>AS 1.6+</code>.

===Конструкторы===

====Конструктор по умолчанию====
datetime dt();
Создает объект с текущей датой и временем.

====Конструктор копирования====
datetime dt(other);
Создает копию существующего объекта datetime.

====Конструктор с параметрами====
datetime dt(year, month, day, hour = 0, minute = 0, second = 0);
Создает объект с указанной датой и временем.
'''Примеры:'''
// Только дата
datetime newYear = datetime(2024, 1, 1);

// Дата и время
datetime meeting = datetime(2024, 12, 25, 14, 30, 0);

// Полная спецификация
datetime exact = datetime(2024, 6, 15, 9, 45, 30);

===Методы===
<code>uint get_year() const</code>

Возвращает год (4 цифры).

<code>uint get_month() const</code>

Возвращает месяц (1-12).

<code>uint get_day() const</code>

Возвращает день месяца (1-31).

<code>uint get_hour() const</code>

Возвращает часы (0-23).

<code>uint get_minute() const</code>

Возвращает минуты (0-59).

<code>uint get_second() const</code>

Возвращает секунды (0-59).

'''Пример:'''
datetime dt = datetime(2024, 12, 25, 14, 30, 45);

uint year = dt.year; // 2024
uint month = dt.month; // 12
uint day = dt.day; // 25
uint hour = dt.hour; // 14
uint minute = dt.minute; // 30
uint second = dt.second; // 45
<code>bool setDate(year, month, day)</code>

Устанавливает дату. Возвращает <code>true</code> при успехе, <code>false</code> при неверной дате.

'''Пример:'''
datetime dt;
bool success = dt.setDate(2024, 2, 29); // true (високосный год)
bool invalid = dt.setDate(2023, 2, 29); // false (не високосный)
<code>bool setTime(hour, minute, second)</code>

Устанавливает время. Возвращает <code>true</code> при успехе, <code>false</code> при неверном времени.

'''Пример:'''

cpp
datetime dt;
bool success = dt.setTime(23, 59, 59); // true
bool invalid = dt.setTime(25, 0, 0); // false (часы > 23)

===Арифметические операции===
Вычитание дат
int64 difference = dt1 - dt2;
Возвращает разницу в секундах.
datetime start = datetime(2024, 1, 1, 0, 0, 0);
datetime end = datetime(2024, 1, 2, 0, 0, 0);
int64 diff = end - start; // 86400 секунд (1 день)
Сложение с секундами
datetime result = dt + seconds;
datetime result = seconds + dt; // обратный порядок
dt += seconds;
'''Пример:'''
datetime dt = datetime(2024, 1, 1, 10, 0, 0);

// Добавить 2 часа
datetime later = dt + 7200;
dt += 7200;

// Обратный порядок
datetime same = 7200 + dt;
Вычитание секунд
datetime result = dt - seconds;
datetime result = seconds - dt; // обратный порядок
dt -= seconds;
'''Пример:'''
datetime dt = datetime(2024, 1, 1, 10, 0, 0);

// Вычесть 30 минут
datetime earlier = dt - 1800;
dt -= 1800;

===Операции сравнения ===
<code>bool opEquals(other)</code>

Проверка равенства дат.

<code>bool opLess(other)</code>

Проверка что дата раньше.

<code>int opCmp(other)</code>

Сравнение с возвратом -1 (меньше), 0 (равно), 1 (больше).

'''Пример:'''
datetime dt1 = datetime(2024, 1, 1);
datetime dt2 = datetime(2024, 1, 2);

if (dt1 < dt2) {
// dt1 раньше dt2
}

if (dt1 == dt2) {
// даты равны
}

int result = dt1.opCmp(dt2); // -1

===Практические примеры ===
Пример 1: Таймер выполнения
datetime startTime;

// Выполняем некоторую операцию
for (int i = 0; i < 1000000; i++)
{
// какая-то работа
}

datetime endTime;
int64 elapsed = endTime - startTime;
print("Операция заняла: " + elapsed + " секунд");
Пример 2: Расчет дат событий
// Дата начала проекта
datetime projectStart = datetime(2024, 1, 15);

// Напоминание за 3 дня до дедлайна
datetime deadline = datetime(2024, 3, 1);
datetime reminder = deadline - 3 * 86400; // 3 дня в секундах

// Продление срока на 2 недели
datetime extendedDeadline = deadline + 14 * 86400;
Пример 3: Проверка рабочего времени
datetime currentTime;

// Создаем время начала и конца рабочего дня
datetime workStart = datetime(currentTime.year, currentTime.month,
currentTime.day, 9, 0, 0);
datetime workEnd = workStart + 8 * 3600; // 8 часов

if (currentTime >= workStart && currentTime <= workEnd)
{
print("Рабочее время");
}
else
{
print("Вне рабочего времени");
}
Пример 4: Валидация даты
bool createAppointment(uint year, uint month, uint day, uint hour)
{
datetime appointment;

// Проверяем корректность даты
if (!appointment.setDate(year, month, day)) {
print("Неверная дата!");
return false;
}

// Проверяем корректность времени
if (!appointment.setTime(hour, 0, 0)) {
print("Неверное время!");
return false;
}

// Проверяем что дата не в прошлом
datetime now;
if (appointment < now) {
print("Дата не может быть в прошлом!");
return false;
}

print("Встреча создана: " + appointment.year + "-" + appointment.month + "-" + appointment.day);
return true;
}
Пример 5: Разбивка интервала времени
datetime start = datetime(2024, 1, 1, 0, 0, 0);
datetime end = start + 365 * 86400; // +1 год

int64 totalSeconds = end - start;
int64 days = totalSeconds / 86400;
int64 hours = (totalSeconds % 86400) / 3600;
int64 minutes = (totalSeconds % 3600) / 60;
int64 seconds = totalSeconds % 60;

print("Интервал: " + days + " дней, " + hours + " часов, " + minutes + " минут, " + seconds + " секунд");

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

На вход скрипта подаются значения некоего сигнала (Signal) и уставки (Constant). В том случае, если сигнал больше уставки, замыкается релейный выход (out0). Соотношение между сигналом и уставкой переводится в проценты и записывается в переменную Percent. Если это соотношение становится меньше определенного значения, то соответствующее сообщение записывается в переменную Alert.

Текст скрипта:
 bool main (float signal_val, float constant_val) // функция получает значения сигнала и уставки
{
float ratio; // переменная, в которой будет храниться соотношение сигнала и уставки
ratio = signal_val / constant_val; // вычисление соотношения
 percent_write(ratio); // вызов функции записи в узлы, с передачей в нее соотношения
 if ( signal_val > constant_val)
{
 return true; // если сигнал больше уставки, на выход скрипта приходит true
}
else
{
 return false; // если сигнал не больше уставки, на выход скрипта приходит false
}
}
 void percent_write (double ratio) // функция записи в узлы
{
string message = "Значение в пределах нормы"; // текстовое сообщение по умолчанию
double percent = ratio * 100; // вычисляется процентное соотношение

if ( percent < 50 )
{
 message = "Значение ниже нормы!"; // если процентное соотношение меньше 50
 // то текст сообщения меняется
}

// запись текстового сообщения в нужный узел
SetNodeValueAsString("/Конфигурация/Станция/Сигналы/Alert", message);

// запись процентного соотношения в нужный узел
SetNodeValueAsFloat("/Конфигурация/Станция/Сигналы/Percent", percent);
}

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

В этой таблице показаны доступные унарные операторы, в порядке убывания приоритета.
{| class="wikitable"
! Символ
!Операция
|-
|<code>::</code>
|Оператор разрешения области видимости
|-
|<code>[]</code>
| Оператор индексации
|-
|<code>++ --</code>
|Постинкремент и декремент
|-
|<code>.</code>
|Доступ
|-
|<code>++ --</code>
|Преинкремент и декремент
|-
|<code>!</code>
|Логическое НЕ
|-
|<code>+ -</code>
|Унарный положительный и отрицательный
|-
|<code>~</code>
|Побитовое дополнение
|-
|<code>@</code>
|Ссылка
|}
Эта таблица показывает приоритет бинарных и тернарных операторов в порядке убывания.
{| class="wikitable"
!Символ
!Операция
|-
|<code>**</code>
|Экспонента
|-
|<code>* / %</code>
|Умножить, разделить, по модулю
|-
|<code>+ -</code>
|Сложить и вычесть
|-
|<code><< >> >>></code>
|Сдвиг влево, сдвиг вправо и арифметический сдвиг вправо
|-
|<code>&</code>
|Битовое И
|-
|<code>^</code>
|Битовый XOR
|-
|<code><nowiki>|</nowiki></code>
|Битовое ИЛИ
|-
|<code><= < >= ></code>
|Сравнение
|-
|<code>== != is !is xor ^^</code>
|Равенство, идентичность и логическое исключающее ИЛИ
|-
|<code>and &&</code>
|Логическое И
|-
|<code><nowiki>or ||</nowiki></code>
|Логическое ИЛИ
|-
|<code>?:</code>
|Условие
|-
|<code>= += -= *= /= %= **= &=</code>

<code>|= ^= <<= >>= >>>=</code>
|Присваивание и составные присваивания
|}

==Зарезервированные ключевые слова==
Это ключевые слова, которые зарезервированы языком. Они не могут использоваться какими-либо идентификаторами, определенными скриптом.
{| class="wikitable"
|and

abstract

auto

bool

break

case

cast

catch

class

const

continue

default

do
|double

else

enum

explicit

external

false

final

float

for

from

funcdef

function

get
|if

import

in

inout

int

interface

int8

int16

int32

int64

is

mixin

namespace
|not

null

or

out

override

private

property

protected

return

set

shared

super

switch
|this

true

try

typedef

uint

uint8

uint16

uint32

uint64

void

while

xor
|}

==Ссылки==
<references />

[[Категория:AgavaSCADA/AgavaPLC]]

Описание языка С++ в AgavaSCADA/AgavaPLC

2026-04-24T12:24:04Z

TaushkanovKV: /* Класс filesystem */

Данное описание содержит базовое руководство по созданию программ на языке С++ и их использовании в [[Универсальная среда разработки|среде разработки Agava]].

== Дополнительные документы ==

* [[Описание базовых классов AgavaSCADA/AgavaPLC]].
* [[Объектная модель AgavaSCADA/AgavaPLC]].

== Основы синтаксиса ==
Все программы на языке С++ состоят из отдельных действий. Каждое действие заканчивается точкой с запятой:
int x;
x = 1;
int y = x + 2;
Для повышения удобства работы с кодом можно оставлять в нем комментарии, которые не используются при работе программы и предназначены для улучшения читаемости кода. Перед комментариями ставится «//»:
bool x = true;
// bool x = false;
// вторая строка не будет выполняться в программе

== Переменные ==
Переменные – объекты, хранящиеся в памяти, над которыми и производятся действия в программе.

Для начала работы с переменной необходимо инициализировать ее, указав тип и имя, а затем, при необходимости, присвоить ей значение:
bool a = true;
int b = 1;
double c = 1.1;
string d = “строка”;

int f; // переменная инициализирована, значение не присвоено
f = 1; // присвоение значения
Ключевое слово auto при инициализации переменной может использоваться вместо типа переменной, для автоматического присвоения типа переменной исходя из инициализируемого значения.
auto a = true;
auto b = 1;

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

При работе со строками доступны следующие функции:
{| class="wikitable"
!Функция
!Действие
|-
|uint length()
|Возвращает длину строки
|-
|void resize(uint)
|Устанавливает длину строки
|-
|bool isEmpty()
|Возвращает истину, если строка пуста, т. е. длина равна нулю
|-
|string substr(uint start = 0, int count = -1)
|Возвращает строку с содержимым, начинающимся с start, и количеством байтов, заданным параметром count. Аргументы по умолчанию вернут всю строку как новую строку
|-
|void insert(uint pos, const string &in other)
|Вставляет другую строку string на позиции pos в исходной строке
|-
|void erase(uint pos, int count = -1)
|Удаляет количество символов count из строки, начиная с позиции pos
|-
|int findFirst(const string &in str, uint start = 0)
|Находит первое вхождение значения str в строке, начиная с символа под номером start. Если вхождения не найдено, будет возвращено отрицательное значение
|-
|int findFirstOf(const string &in str, uint start = 0)
|Находит первое вхождение одного из символов в str в строке, начиная с символа под номером start. Если вхождения не найдено, будет возвращено отрицательное значение
|-
|int findLast(const string &in str, int start = -1)
|Находит последнее вхождение значения str в строке
|-
|int findLastOf(const string &in str, int start = -1)
|Находит последнее вхождение одного из символов в str в строке, начиная с символа под номером start. Если вхождения не найдено, будет возвращено отрицательное значение
|-
|string formatInt(int64 val, const string &in options = "", uint width=0)
|Преобразование int в строку
|-
|string formatUInt(uint64 val, const string &in options = "", uint width=0)
|Преобразование uint в строку
|-
|string formatFloat(double val, const string &in options="", uint width=0, uint precision=0)
|Преобразование float и double в строку
|-
|int64 parseInt(const string &in str, uint base=10, uint &out byteCount=0)
|Преобразование строки в int64
|-
|uint64 parseUInt(const string &in str, uint base=10, uint &out byteCount=0)
|Преобразование строки в uint64
|-
|double parseFloat(const string &in str, uint &out byteCount=0)
|Преобразование строки в double
|}
Пример работы с функциями для строк:
string str = “ABCDEF”; // инициализирована строка str

int a = str.length(); // a равно 6
int b = str.findFirst(“CD”, 0); // b равно 2

str.erase(1, 3); // str равно “AEF”

string str = "НАСОС1";
string substrToRemove = "НАСОС";

int pos = str.findFirst(substrToRemove);

if (pos >= 0)
{
str.erase(pos, substrToRemove.length()); // Теперь str содержит "1"
}

=== Массивы ===
Массив — многоэлементный тип данных, который позволяет получить доступ ко всем переменным одного и того же типа данных через использование одного идентификатора. Используется в том случае, если вам необходимо сгруппировать несколько элементов одного типа:
array <int> a = {2, 5, 10, 15, 20}; // инициализирован массив a с пятью элементами
int x = a [0]; // x становится равен элементу массива а под номером 0 (2)
int y = a [4]; // y становится равен элементу массива а под номером 4 (20)
arr [3] = 11; // элемент массива а под номером 3 становится равен 11
int z = arr [3]; // z становится равен элементу массива а под номером 3 (11)
Важно помнить, что нумерация членов массива начинается с 0.

При работе с массивами доступны следующие функции:
{| class="wikitable"
!Функция
!Действие
|-
|length()
|Возвращает длину массива
|-
|resize(uint)
|Устанавливает новую длину массива
|-
|reverse()
|Меняет порядок элементов в массиве на обратный
|-
|insertAt(uint index, const T& in value)
|Вставляет новый элемент в массив по указанному индексу
|-
|insertLast(const T& in)
|Добавляет элемент в конец массива
|-
|removeAt(uint index)
|Удаляет элемент по указанному индексу
|-
|removeLast()
|Удаляет последний элемент массива
|-
|removeRange(uint start, uint count)
|Удаляет количество элементов count, начиная с элемента номер start
|-
|sortAsc ()
|Сортирует элементы в массиве в порядке возрастания
|-
|sortDesc ()
|Сортирует элементы в массиве в порядке убывания
|-
|find (const T &in)
|Возвращает индекс первого элемента, который имеет то же значение, что и желаемое. Если совпадений не найдено, возвращает отрицательное значение
|}
Пример работы с функциями для массивов:
int main()
{
array<int> arr = {1,2,3}; // 1,2,3
arr.insertLast(0); // 1,2,3,0
arr.insertAt(2,4); // 1,2,4,3,0
arr.removeAt(1); // 1,4,3,0
arr.sortAsc(); // 0,1,3,4
int sum = 0;

for( uint n = 0; n < arr.length(); n++ )
sum += arr[n];

return sum;
}

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

Значения перечислений объявляются путем их объявления в операторе перечисления. Если для константы перечисления не указано конкретное значение, она будет принимать значение предыдущей константы плюс 1. Первая константа получит значение 0, если не указано иное.
enum Errors
{
 NoError, // = 0
 ReadError = 2, // = 2
 WriteError, // = 3
}

// теперь к константам перечисления можно обращаться через текстовое значение, например
// int a = NoError;

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

Логические переменные
{| class="wikitable"
!Тип
!Мин. значение
!Макс. значение
|-
|bool
|false (0)
|true (1)
|}
Целочисленные переменные
{| class="wikitable"
!Тип
!Мин. значение
!Макс. значение
|-
|int8
|<nowiki>- 128</nowiki>
|127
|-
|int16
|<nowiki>- 32 768</nowiki>
|32 767
|-
|int
|<nowiki>- 2 147 483 648</nowiki>
|2 147 483 647
|-
|int64
|<nowiki>- 9 223 372 036 854 775 808</nowiki>
|9 223 372 036 854 775 807
|-
|uint8
|0
|255
|-
|uint16
|0
|65 535
|-
|uint
|0
|4 294 967 295
|-
|uint64
|0
|18 446 744 073 709 551 615
|}
Переменные с плавающей запятой
{| class="wikitable"
!Тип
!Диапазон значений
!Наименьшее значение
|-
|float
|± 3.402823466 e+38
|1.175494351 e-38
|-
|double
|± 1.79769313486231 e+308
|2.22507385850720 e-308
|}

== Операторы ==
Доступны операторы сравнения, логические, побитовые, арифметические, приращений и индексации.

=== Операторы сравнения ===
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Равно
|==
|x == y
|true, если x равно y
|-
|Не равно
|!=
|x != y
|true, если x не равно y
|-
|Меньше
|<
|x < y
|true, если x меньше y
|-
|Больше
|>
|x > y
|true, если x больше y
|-
|Меньше или равно
|<=
|x <= y
|true, если x меньше или равно y
|-
|Больше или равно
|>=
|x >= y
|true, если x больше или равно y
|}

=== Логические операторы ===
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Логическое НЕ
|!
|!x
|true, если x – false и false, если x – true
|-
|Логическое И
|&&
|x && y
|true, если x и y – true, в противном случае – false
|-
|Логическое ИЛИ
|<nowiki>||</nowiki>
|<nowiki>x || y</nowiki>
|true, если x или y – true, в противном случае – false
|-
|Логическое ИСКЛЮЧАЮЩЕЕ ИЛИ (XOR)
|^
|x ^ y
|true, если x или y – true (но не одновременно), в противном случае – false
|}

=== Побитовые операторы ===
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Побитовое И
|&
|x & y
|Каждый бит в x И каждый соответствующий ему бит в y
|-
|Побитовое ИЛИ
|<nowiki>|</nowiki>
|<nowiki>x | y</nowiki>
|Каждый бит в x ИЛИ каждый соответствующий ему бит в y
|-
|Побитовое ИСКЛЮЧАЮЩЕЕ ИЛИ (XOR)
|^
|x ^ y
|Каждый бит в x XOR с каждым соответствующим ему битом в y
|-
|Побитовый сдвиг влево
|<<
|x << y
|Все биты в x смещаются влево на y бит
|-
|Побитовый сдвиг вправо
|>>
|x >> y
|Все биты в x смещаются вправо на y бит
|}
'''Пример'''
float RegistersToFloat(uint16 r0, uint16 r1)
{
// Создаем массив байтов в little-endian порядке
array<uint8> bytes(4);

// Little-endian (наиболее распространенный)
bytes[0] = r0 & 0xFF;
bytes[1] = (r0 >> 8) & 0xFF;
bytes[2] = r1 & 0xFF;
bytes[3] = (r1 >> 8) & 0xFF;

 // Преобразуем байты в uint32, затем в float
uint32 resultBits = 0;

for (uint i = 0; i < 4; i++)
{
resultBits |= uint32(bytes[i]) << (i * 8);
}

return fpFromIEEE(resultBits);
}

=== Арифметические операторы ===
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Сложение
|<nowiki>+</nowiki>
|x + y
|Складываем x и y
|-
|Вычитание
|<nowiki>-</nowiki>
|x – y
|Вычитаем y из x
|-
|Умножение
|*
|x * y
|Умножаем x на y
|-
|Деление
|/
|x / y
|Делим x на y
|-
|Присваивание
|=
|x = y
|Присваиваем значение y переменной x
|-
|Сложение с присваиванием
|<nowiki>+=</nowiki>
|x += y
|Добавляем y к x
|-
|Вычитание с присваиванием
|<nowiki>-=</nowiki>
|x -= y
|Вычитаем y из x
|-
|Умножение с присваиванием
|*=
|x *= y
|Умножаем x на y
|-
|Деление с присваиванием
|/=
|x /= y
|Делим x на y
|}

=== Операторы приращений ===
Операция инкремента увеличивает значение на 1, декремента – уменьшает на 1.
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Преинкремент
|<nowiki>++</nowiki>
|<nowiki>++х</nowiki>
|Инкремент х, затем вычисление х
|-
|Предекремент
|<nowiki>--</nowiki>
|<nowiki>--х</nowiki>
|Декремент х, затем вычисление х
|-
|Постинкремент
|<nowiki>++</nowiki>
|х++
|Вычисление х, затем инкремент х
|-
|Постдекремент
|<nowiki>--</nowiki>
|х--
|Вычисление х, затем декремент х
|}

=== Оператор индексации ===
Используется для доступа к элементу.
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Индексация
|[ ]
|arr [0]
|Обращение к нулевому элементу массива arr
|}

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

Внешние блоки не имеют доступа к переменным внутренних блоков.
{
 int a;
 float b;
 {
 float a = 1.0; // Отменить объявление внешней переменной
// но только в пределах внутреннего блока
 b = a; // переменные из внешних блоков все еще доступны
 int c;
 }

 // a снова становится целочисленной переменной, b теперь равна 1.0, c здесь недоступна
}

== Условия ==

=== Операторы if/else ===
Позволяют выбрать выполнение нужных действий, в зависимости от выбранного условия, указанного в скобках:
if (x == 1)
{
// эти действия выполнятся, если х равно 1
}
else
{
// эти действия выполнятся, если х не равно 1
}

=== Условное выражение (тернарный оператор) ===
Более короткая запись оператора выбора if/else:
x = 1 ? y = true : y = false; // если х равно 1, тогда y равен true, иначе y равен false

=== Оператор switch ===
Является альтернативой if/else для тех случаев, когда необходимо сделать множественный выбор:
switch(x)
{
case 0:
 // эти действия выполнятся, если х равно 0
 break; // каждый case всегда должен заканчивать оператором break
case 1:
 // эти действия выполнятся, если х равно 1
 break;
case 2:
 // эти действия выполнятся, если х равно 2
 break;
default:
 // Эти действия выполнятся, если x не равен ни одному из предыдущих значений case
}

== Циклы ==

=== Цикл while ===
Цикл выполняется, пока условие в скобках истинно:
x = 0;

while (x < 5)
{
// это действие будет выполняться, пока х меньше 5
x++; // при каждом выполнении цикла увеличиваем х на 1
}

=== Цикл do while ===
Цикл похож на while, но, в отличии от него, цикл в любом случае выполнится хотя бы один раз (или больше, если при последующих проверках условие будет истинно):
x = 10;

do
{
// это действие выполнится один раз, так как условие изначально ложно
}
while (x < 5);

=== Цикл for ===
Цикл for обычно используется как счетчик и хорошо подходит, когда известно необходимое количество итераций. В скобках через точку с запятой указывается переменная, условие, инкремент / декремент для переменной:
for ( int x = 0; x < 5; x ++ )
{
// при каждом выполнении этих действий переменная х будет увеличивать на 1
// действия будут выполняться пока х меньше 5
}

== Функции ==
Функция — это последовательность действия для выполнения определенного задания. Объявление функции похоже на объявление переменной: необходимо указать тип возвращаемого значения (либо void, если функция ничего не возвращает) и название функции. После этого ставятся двойные скобки, в которых находятся аргументы функции (либо пустые скобки, если аргументы отсутствуют). Действия, выполняемые функцией, заключаются в фигурные скобки.

Любой код в операции «Скрипт С++» должен находиться в функции. При использовании нескольких функций в скрипте будет выполняться только первая, остальные должны быть вызваны из нее:
void main ()
{
int x = 1;
function (); // вызов функции, программа переходит в void function()
SetNodeValueAsInt(“/Конфигурация/Станция/Сигналы/Constant2”, x);
}

void function ()
{
SetNodeValueAsInt(“/Конфигурация/Станция/Сигналы/Constant2”, 5);
// теперь программа возвращается обратно в void main()
}
После выполнения данного скрипта значение сигнала Constant1 станет равно 5, а Constant2 равно 1.

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

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

Параметры указываются при объявлении функции в круглых скобках:
void summ (int x, int y) // в функцию передаются параметры х = 1 и y = 2
{
int z = x + y; // z равно 3
}

=== Возврат значения ===
Для передачи значения из скрипта можно указать необходимое значение в действии return, указав тип функции такой же, как у возвращаемого значения:
bool R_Output (bool x, bool y)
{
bool z = false;
z = x && y;

return z; // z передается на выход скрипта
}

== Математические и тригонометрические функции ==

===Преобразование IEEE битов===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float fpFromIEEE(uint bits)</code>
|Преобразует 32-битное IEEE-754 представление в число float
|<code>bits</code> (uint) - битовое представление
|-
|<code>uint fpToIEEE(float value)</code>
|Преобразует число float в 32-битное IEEE-754 представление
|<code>value</code> (float) - исходное число
|-
|<code>double fpFromIEEE(uint64 bits)</code>
|Преобразует 64-битное IEEE-754 представление в число double
|<code>bits</code> (uint64) - битовое представление
|-
|<code>uint64 fpToIEEE(double value)</code>
|Преобразует число double в 64-битное IEEE-754 представление
|<code>value</code> (double) - исходное число
|}

=== Сравнение с допуском===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>bool closeTo(float a, float b, float epsilon = 0.00001f)</code>
|Сравнивает два числа float с заданной погрешностью
|<code>a</code> (float) - первое число
<code>b</code> (float) - второе число
<code>epsilon</code> (float, опционально) - погрешность (по умолчанию 0.00001)
|-
|<code>bool closeTo(double a, double b, double epsilon = 0.0000000001)</code>
|Сравнивает два числа double с заданной погрешностью
|<code>a</code> (double) - первое число
<code>b</code> (double) - второе число
<code>epsilon</code> (double, опционально) - погрешность (по умолчанию 1e-10)
|}

=== Тригонометрические функции ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float cos(float angle)</code>
|Вычисляет косинус угла
|<code>angle</code> (float) - угол в радианах
|-
|<code>float sin(float angle)</code>
|Вычисляет синус угла
|<code>angle</code> (float) - угол в радианах
|-
|<code>float tan(float angle)</code>
|Вычисляет тангенс угла
|<code>angle</code> (float) - угол в радианах
|-
|<code>float acos(float value)</code>
|Вычисляет арккосинус (обратный косинус)
|<code>value</code> (float) - значение в диапазоне [-1, 1]
|-
|<code>float asin(float value)</code>
|Вычисляет арксинус (обратный синус)
|<code>value</code> (float) - значение в диапазоне [-1, 1]
|-
|<code>float atan(float value)</code>
|Вычисляет арктангенс (обратный тангенс)
|<code>value</code> (float) - значение
|-
|<code>float atan2(float y, float x)</code>
|Вычисляет арктангенс двух переменных
|<code>y</code> (float) - координата Y
<code>x</code> (float) - координата X
|}

=== Гиперболические функции ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float cosh(float x)</code>
|Вычисляет гиперболический косинус
|<code>x</code> (float) - значение
|-
|<code>float sinh(float x)</code>
|Вычисляет гиперболический синус
|<code>x</code> (float) - значение
|-
|<code>float tanh(float x)</code>
|Вычисляет гиперболический тангенс
|<code>x</code> (float) - значение
|}

=== Экспоненциальные и логарифмические функции ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float log(float x)</code>
|Вычисляет натуральный логарифм (по основанию e)
|<code>x</code> (float) - значение > 0
|-
|<code>float log10(float x)</code>
|Вычисляет десятичный логарифм (по основанию 10)
|<code>x</code> (float) - значение > 0
|}

=== Степенные функции ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float pow(float base, float exponent)</code>
|Возводит число в степень
|<code>base</code> (float) - основание
<code>exponent</code> (float) - показатель степени
|-
|<code>float sqrt(float x)</code>
|Вычисляет квадратный корень
|<code>x</code> (float) - неотрицательное значение
|}

=== Функции округления и остатка ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float ceil(float x)</code>
|Округляет вверх до ближайшего целого
|<code>x</code> (float) - значение
|-
|<code>float abs(float x)</code>
|Вычисляет абсолютное значение (модуль)
|<code>x</code> (float) - значение
|-
|<code>float floor(float x)</code>
|Округляет вниз до ближайшего целого
|<code>x</code> (float) - значение
|-
|<code>float fraction(float x)</code>
|Выделяет дробную часть числа
|<code>x</code> (float) - значение
|}

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

===Функции для работы с узлами===
{| class="wikitable"
!Определение функции
!Описание
|-
|float GetNodeValueAsFloat(string strNodePath)
|Получить значение узла в виде float по заданному пути
|-
|void SetNodeValueAsFloat(string strNodePath, float fValue)
|Установить значение узла в float по заданному пути
|-
|int GetNodeValueAsInt(string strNodePath)
|Получить значение узла в виде int по заданному пути
|-
|void SetNodeValueAsInt(string strNodePath, int iValue)
|Установить значение узла в int по заданному пути
|-
|string GetNodeValueAsString(string strNodePath)
|Получить значение узла в виде string по заданному пути
|-
| void SetNodeValueAsString(string strNodePath, string strValue)
|Установить значение узла в виде string по заданному пути
|-
|bool GetNodeValueAsBool(string strNodePath)
|Получить значение узла в виде bool по заданному пути
|-
|void SetNodeValueAsBool(string strNodePath, bool bValue)
|Установить значение узла в виде bool по заданному пути
|-
|bool NodeValueIsError(string strNodePath)
|Проверка значения узла на ошибку
|-
|void StartNode(string strNodePath)
|Запуск узла по заданному пути
|-
|void StopNode(string strNodePath)
|Остановка узла по заданному пути
|}

===Функции для работы с окнами ===
{| class="wikitable"
!Определение функции
!Описание
|-
| <code>void CloseWindow(string strNodePath, int iDisplay)</code>
|Закрыть окно по заданному пути на дисплее с номером iDisplay
|-
|<code>void ShowWindow(string strNodePath, int iDisplay)</code>
|Отобразить окно по заданному пути на дисплее с номером iDisplay.
Координаты - абсолютные, установленные в свойствах окна.
|-
|<code>int LoadComposition(string strWindowPath, string strCompositionPath, int iDisplay)</code>
|Загрузить композицию strCompositionPath в окно strWindowPath на дисплее с номером iDisplay.
<code>AS 1.6.25+</code>
|}

===Функции для работы с временем===
{| class="wikitable"
!Определение функции
!Описание
|-
|int GetCurrentTime()
|Получение текущего времени в UNIX формате (количество секунд с 01 января 1970 года)
|-
|uint64 GetCurrentTimeMs()
|Получение текущего времени в UNIX формате (количество миллисекунд с 01 января 1970 года) (<code>AS 1.2.55+</code>, <code>AS 1.6.1+</code>)
|-
|int GetLocalTime()
| Получение текущего времени в UNIX формате (количество секунд с 01 января 1970 года) с учетом часового пояса
|-
|int GetHours(int iTime)
| Получение текущего часа из времени в формате UNIX
|-
|int GetMinutes(int iTime)
|Получение текущих минут из времени в формате UNIX
|-
|int GetSeconds(int iTime)
|Получение текущих секунд из времени в формате UNIX
|}

===Функции для работы с событиями===
'''int StoreMessage(int iMessageLevel, string strMessage)'''
{| class="wikitable"
|-
|'''Назначение'''
|Генерация информационного события (типа "сообщение"). Событие помещается в группу "Системные".
|-
|'''Возвращаемое значение'''
|0 - успешно, иначе код ошибки
|-
| rowspan="2" |'''Аргументы'''
|int iMessageLevel - уровень сообщения (1-наивысший): 1=FATAL, 2=ERROR, 3=WARNING, 4=NOTICE, 5=INFO, 6=TRACE, 7=DEBUG
|-
|string strMessage - текст сообщения
|-
|'''Примечания'''
|функция доступна с версии <code>AS 1.2.34+</code>
|}
'''int StoreMessage(int iMessageLevel, string strMessage, string strGroup)'''
{| class="wikitable"
|-
|'''Назначение'''
|Генерация информационного события (типа "сообщение"). Событие помещается в указанную при вызове группу.
|-
|'''Возвращаемое значение'''
|0 - успешно, иначе код ошибки
|-
| rowspan="3" |'''Аргументы'''
|int iMessageLevel - уровень сообщения (1-наивысший): 1=FATAL, 2=ERROR, 3=WARNING, 4=NOTICE, 5=INFO, 6=TRACE, 7=DEBUG
|-
|string strMessage - текст сообщения
|-
|string strGroup - имя группы, в которую должно помещаться событие.
|-
|'''Примечания'''
|функция доступна с версии <code>AS 1.6.20+</code>
|}

===Функции для работы со строками===
'''string EncodeMD5(string strText)'''
{| class="wikitable"
|-
|'''Назначение'''
|Кодирование строки в MD5 хэш
|-
|'''Возвращаемое значение'''
|MD5 хэш параметра
|-
|'''Аргументы'''
|string strText - исходная строка
|-
|'''Примечания'''
| функция доступна с версии <code>AS 1.2.34+</code>
|}

===Другие функции===
Проверка на nan.
'''bool isnan(double)'''

Запуск процесса в операционной системе.
'''int LaunchProcess(string process)'''
Запуск производится в блокирующем режиме, то есть возврат из функции осуществляется по завершению процесса.

==Класс file==
Класс доступен начиная с версии 1.4.5 AgavaSCADA/AgavaPLC.

===Методы===
'''int open(const string& filename, const string& mode)'''
{| class="wikitable"
|-
|'''Назначение'''
|Открытие файла
|-
|'''Возвращаемое значение'''
|Результат выполнения операции: 0 - успешно, -1 - ошибка.
|-
| rowspan="2" |'''Аргументы'''
|const string& filename - путь до файла
|-
|const string& mode - режим открытия файла.
|}
'''int close()'''
{| class="wikitable"
|-
|'''Назначение'''
|Закрытие файла
|-
|'''Возвращаемое значение'''
|Результат выполнения операции. 0 - успешно, -1 - ошибка.
|-
|'''Аргументы'''
| -
|}
'''int getSize() const'''
{| class="wikitable"
|-
|'''Назначение'''
|Получение размера файла
|-
|'''Возвращаемое значение'''
|Размер файла в байтах
|-
|'''Аргументы'''
| -
|}
'''bool isEndOfFile() const'''
{| class="wikitable"
|-
|'''Назначение'''
| Получение признака конца файла
|-
|'''Возвращаемое значение'''
|true - обнаружен конец файла.
|-
|'''Аргументы'''
| -
|}
'''string readString(uint length)'''
{| class="wikitable"
|-
|'''Назначение'''
|Чтение строки
|-
|'''Возвращаемое значение'''
|Считанная строка
|-
|'''Аргументы'''
|uint length - длина считываемой строки
|}
'''string readLine()'''
{| class="wikitable"
|-
|'''Назначение'''
|Чтение строки
|-
|'''Возвращаемое значение'''
|Считанная строка
|-
|'''Аргументы'''
| -
|-
|'''Примечания'''
| Считывание производится до тех пор, пока не будет обнаружен символ '\n' или конец файла
|}
'''int64 readInt(uint)'''
'''Назначение:''' чтение целого числа со знаком.

'''Возвращаемое значение''': считанное значение.

'''Аргументы''': отсутствуют.

'''Примечания''': отсутствуют.
'''uint64 readUInt(uint)'''
'''Назначение:''' чтение целого беззнакового числа.

'''Возвращаемое значение''': считанное значение.

'''Аргументы''': отсутствуют.

'''Примечания''': отсутствуют.
'''float readFloat()'''
'''Назначение:''' чтение целого вещественного числа одинарной точности.

'''Возвращаемое значение''': считанное значение.

'''Аргументы''': отсутствуют.

'''Примечания''': отсутствуют.

double readDouble()

int writeString(const string &in)

int writeInt(int64, uint)

int writeUInt(uint64, uint)

int writeFloat(float)

int writeDouble(double)

int getPos() const

int setPos(int)

int movePos(int)

===Поля===
bool mostSignificantByteFirst.

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

Класс доступен начиная с версии <code>AS 1.6+</code>.

=== Методы ===
bool changeCurrentPath(const string &in path)
'''Назначение:''' Изменяет текущую рабочую директорию.

'''Аргументы:'''

* <code>path</code> – путь к новой директории (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>true</code> – если путь существует и текущая директория успешно изменена.
* <code>false</code> – если указанный путь не существует или не является директорией.

'''Примечания:'''

* Если путь задан относительно, он объединяется с текущей директорией.
* Путь не должен содержать обратные слеши <code>\</code> – они автоматически заменяются на <code>/</code>.
* Завершающие слеши автоматически удаляются из пути.
* Не поддерживает разрешение внутренних ссылок <code>/./</code> и <code>/../</code> (отмечено в TODO).
string getCurrentPath() const
'''Назначение:''' Возвращает текущую рабочую директорию.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Строка с абсолютным путём текущей директории, использующая разделители <code>/</code>.

'''Примечания:'''

* При создании объекта <code>filesystem</code> текущая директория инициализируется рабочим каталогом приложения.
* Все обратные слеши <code>\</code> заменяются на <code>/</code> для единообразия.
array<string> @getDirs() const
'''Назначение:''' Получает список всех поддиректорий внутри текущей директории.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Массив строк с именами поддиректорий.

'''Примечания:'''

* Специальные записи <code>.</code> (текущая директория) и <code>..</code> (родительская директория) исключаются из результата.
* Возвращает пустой массив, если директорий нет или произошла ошибка чтения.
array<string> @getFiles() const
'''Назначение:''' Получает список всех файлов внутри текущей директории.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Массив строк с именами файлов.

'''Примечания:'''

* В результат включаются только файлы, директории исключаются.
* Возвращает пустой массив, если файлов нет или произошла ошибка чтения.
bool isDir(const string &in path) const
'''Назначение:''' Проверяет, является ли указанный путь директорией.

'''Аргументы:'''

* <code>path</code> – путь к объекту файловой системы (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>true</code> – если объект существует и является директорией.
* <code>false</code> – если объект не существует, не является директорией или произошла ошибка.

'''Примечания:'''

* Относительные пути разрешаются относительно текущей директории.
* Абсолютные пути определяются наличием двоеточия <code>:</code> (например, <code>C:</code>) или начального слеша <code>/</code> или <code>\</code>.
bool isLink(const string &in path) const
'''Назначение:''' Проверяет, является ли указанный путь символической ссылкой (symlink).

'''Аргументы:'''

* <code>path</code> – путь к объекту файловой системы (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>true</code> – если объект существует и является символической ссылкой (на Windows – репарс-точкой).
* <code>false</code> – если объект не является ссылкой, не существует или произошла ошибка.

'''Примечания:'''

* Кроссплатформенная поддержка: Windows (атрибут <code>FILE_ATTRIBUTE_REPARSE_POINT</code>) и POSIX (флаг <code>S_IFLNK</code>).
* Относительные пути разрешаются относительно текущей директории.
int64 getSize(const string &in path) const
'''Назначение:''' Возвращает размер файла в байтах.

'''Аргументы:'''

* <code>path</code> – путь к файлу (относительный или абсолютный).

'''Возвращаемое значение:'''

* Размер файла в байтах (тип <code>int64</code>).
* <code>-1</code> – если файл не существует, указан путь к директории или произошла ошибка.

'''Примечания:'''

* На Windows используется API-функция <code>GetFileSizeEx</code>.
* На POSIX-системах используется <code>stat</code>.
* Для директорий возвращает <code>-1</code>.
int makeDir(const string &in path)
'''Назначение:''' Создаёт новую директорию.

'''Аргументы:'''

* <code>path</code> – путь к создаваемой директории (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>0</code> – директория успешно создана.
* <code>-1</code> – ошибка создания (например, недостаточно прав, путь не существует).

'''Примечания:'''

* '''Важно:''' Не поддерживает рекурсивное создание промежуточных директорий (отмечено в TODO).
* На Windows создаёт директорию с правами по умолчанию.
* На POSIX создаёт с правами <code>S_IRWXU | S_IRWXG | S_IROTH | S_IXOTH</code> (755: чтение/запись/исполнение для владельца, чтение/исполнение для группы и остальных).
int removeDir(const string &in path)
'''Назначение:''' Удаляет пустую директорию.

'''Аргументы:'''

* <code>path</code> – путь к удаляемой директории (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>0</code> – директория успешно удалена.
* <code>-1</code> – ошибка удаления (директория не пуста, не существует, недостаточно прав).

'''Примечания:'''

* Удаляет только '''пустые''' директории.
* Не поддерживает рекурсивное удаление с содержимым (отмечено в TODO).
* На Windows используется <code>RemoveDirectoryW</code>, на POSIX – <code>rmdir</code>.
int deleteFile(const string &in path)
'''Назначение:''' Удаляет файл.

'''Аргументы:'''

* <code>path</code> – путь к удаляемому файлу (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>0</code> – файл успешно удалён.
* <code>-1</code> – ошибка удаления (файл не существует, недостаточно прав, указана директория).

'''Примечания:'''

* На Windows используется <code>DeleteFileW</code>, на POSIX – <code>unlink</code>.
* Для удаления директорий используйте <code>removeDir</code>.
int copyFile(const string &in source, const string &in target)
'''Назначение:''' Копирует файл из одного местоположения в другое.

'''Аргументы:'''

* <code>source</code> – путь к исходному файлу.
* <code>target</code> – путь к целевому файлу (не директории).

'''Возвращаемое значение:'''

* <code>0</code> – файл успешно скопирован.
* <code>-1</code> – ошибка копирования (исходный файл не существует, недостаточно прав, целевой файл уже существует).

'''Примечания:'''

* На Windows используется API-функция <code>CopyFileW</code> с параметром <code>TRUE</code> (не перезаписывать существующий файл).
* На POSIX-системах копирование выполняется '''вручную''' побайтово через <code>fopen/fread/fwrite</code>, так как стандартной функции копирования нет.
* Целевой файл не должен существовать (флаг <code>TRUE</code> на Windows).
int move(const string &in source, const string &in target)
'''Назначение:''' Перемещает или переименовывает файл или директорию.

'''Аргументы:'''

* <code>source</code> – текущий путь к объекту.
* <code>target</code> – новый путь или имя объекта.

'''Возвращаемое значение:'''

* <code>0</code> – объект успешно перемещён/переименован.
* <code>-1</code> – ошибка операции (объект не существует, недостаточно прав).

'''Примечания:'''

* Может использоваться как для файлов, так и для директорий.
* На Windows используется <code>MoveFileW</code>, на POSIX – <code>rename</code>.
* Операция может выполняться в пределах одного тома/файловой системы.
datetime getCreateDateTime(const string &in path) const
'''Назначение:''' Возвращает дату и время создания файла или директории.

'''Аргументы:'''

* <code>path</code> – путь к объекту файловой системы.

'''Возвращаемое значение:'''

* Объект <code>datetime</code>, содержащий дату и время создания.

'''Примечания:'''

* '''Выбрасывает исключение''' в скриптовом контексте через <code>SetException</code>, если не удаётся получить дату создания.
* На Windows используется <code>GetFileTime</code> с полем <code>createTm</code>.
* На POSIX-системах используется поле <code>st_ctime</code> (change time) – может отличаться от реального времени создания на некоторых файловых системах.
datetime getModifyDateTime(const string &in path) const
'''Назначение:''' Возвращает дату и время последнего изменения файла или директории.

'''Аргументы:'''

* <code>path</code> – путь к объекту файловой системы.

'''Возвращаемое значение:'''

* Объект <code>datetime</code>, содержащий дату и время последней модификации.

'''Примечания:'''

* '''Выбрасывает исключение''' в скриптовом контексте через <code>SetException</code>, если не удаётся получить дату изменения.
* На Windows используется <code>GetFileTime</code> с полем <code>modifyTm</code>.
* На POSIX-системах используется поле <code>st_mtime</code> (modify time).

==Класс datetime==
Класс доступен начиная с версии <code>AS 1.6+</code>.

===Конструкторы===

====Конструктор по умолчанию====
datetime dt();
Создает объект с текущей датой и временем.

====Конструктор копирования====
datetime dt(other);
Создает копию существующего объекта datetime.

====Конструктор с параметрами====
datetime dt(year, month, day, hour = 0, minute = 0, second = 0);
Создает объект с указанной датой и временем.
'''Примеры:'''
// Только дата
datetime newYear = datetime(2024, 1, 1);

// Дата и время
datetime meeting = datetime(2024, 12, 25, 14, 30, 0);

// Полная спецификация
datetime exact = datetime(2024, 6, 15, 9, 45, 30);

===Методы===
<code>uint get_year() const</code>

Возвращает год (4 цифры).

<code>uint get_month() const</code>

Возвращает месяц (1-12).

<code>uint get_day() const</code>

Возвращает день месяца (1-31).

<code>uint get_hour() const</code>

Возвращает часы (0-23).

<code>uint get_minute() const</code>

Возвращает минуты (0-59).

<code>uint get_second() const</code>

Возвращает секунды (0-59).

'''Пример:'''
datetime dt = datetime(2024, 12, 25, 14, 30, 45);

uint year = dt.year; // 2024
uint month = dt.month; // 12
uint day = dt.day; // 25
uint hour = dt.hour; // 14
uint minute = dt.minute; // 30
uint second = dt.second; // 45
<code>bool setDate(year, month, day)</code>

Устанавливает дату. Возвращает <code>true</code> при успехе, <code>false</code> при неверной дате.

'''Пример:'''
datetime dt;
bool success = dt.setDate(2024, 2, 29); // true (високосный год)
bool invalid = dt.setDate(2023, 2, 29); // false (не високосный)
<code>bool setTime(hour, minute, second)</code>

Устанавливает время. Возвращает <code>true</code> при успехе, <code>false</code> при неверном времени.

'''Пример:'''

cpp
datetime dt;
bool success = dt.setTime(23, 59, 59); // true
bool invalid = dt.setTime(25, 0, 0); // false (часы > 23)

===Арифметические операции===
Вычитание дат
int64 difference = dt1 - dt2;
Возвращает разницу в секундах.
datetime start = datetime(2024, 1, 1, 0, 0, 0);
datetime end = datetime(2024, 1, 2, 0, 0, 0);
int64 diff = end - start; // 86400 секунд (1 день)
Сложение с секундами
datetime result = dt + seconds;
datetime result = seconds + dt; // обратный порядок
dt += seconds;
'''Пример:'''
datetime dt = datetime(2024, 1, 1, 10, 0, 0);

// Добавить 2 часа
datetime later = dt + 7200;
dt += 7200;

// Обратный порядок
datetime same = 7200 + dt;
Вычитание секунд
datetime result = dt - seconds;
datetime result = seconds - dt; // обратный порядок
dt -= seconds;
'''Пример:'''
datetime dt = datetime(2024, 1, 1, 10, 0, 0);

// Вычесть 30 минут
datetime earlier = dt - 1800;
dt -= 1800;

===Операции сравнения ===
<code>bool opEquals(other)</code>

Проверка равенства дат.

<code>bool opLess(other)</code>

Проверка что дата раньше.

<code>int opCmp(other)</code>

Сравнение с возвратом -1 (меньше), 0 (равно), 1 (больше).

'''Пример:'''
datetime dt1 = datetime(2024, 1, 1);
datetime dt2 = datetime(2024, 1, 2);

if (dt1 < dt2) {
// dt1 раньше dt2
}

if (dt1 == dt2) {
// даты равны
}

int result = dt1.opCmp(dt2); // -1

===Практические примеры ===
Пример 1: Таймер выполнения
datetime startTime;

// Выполняем некоторую операцию
for (int i = 0; i < 1000000; i++)
{
// какая-то работа
}

datetime endTime;
int64 elapsed = endTime - startTime;
print("Операция заняла: " + elapsed + " секунд");
Пример 2: Расчет дат событий
// Дата начала проекта
datetime projectStart = datetime(2024, 1, 15);

// Напоминание за 3 дня до дедлайна
datetime deadline = datetime(2024, 3, 1);
datetime reminder = deadline - 3 * 86400; // 3 дня в секундах

// Продление срока на 2 недели
datetime extendedDeadline = deadline + 14 * 86400;
Пример 3: Проверка рабочего времени
datetime currentTime;

// Создаем время начала и конца рабочего дня
datetime workStart = datetime(currentTime.year, currentTime.month,
currentTime.day, 9, 0, 0);
datetime workEnd = workStart + 8 * 3600; // 8 часов

if (currentTime >= workStart && currentTime <= workEnd)
{
print("Рабочее время");
}
else
{
print("Вне рабочего времени");
}
Пример 4: Валидация даты
bool createAppointment(uint year, uint month, uint day, uint hour)
{
datetime appointment;

// Проверяем корректность даты
if (!appointment.setDate(year, month, day)) {
print("Неверная дата!");
return false;
}

// Проверяем корректность времени
if (!appointment.setTime(hour, 0, 0)) {
print("Неверное время!");
return false;
}

// Проверяем что дата не в прошлом
datetime now;
if (appointment < now) {
print("Дата не может быть в прошлом!");
return false;
}

print("Встреча создана: " + appointment.year + "-" + appointment.month + "-" + appointment.day);
return true;
}
Пример 5: Разбивка интервала времени
datetime start = datetime(2024, 1, 1, 0, 0, 0);
datetime end = start + 365 * 86400; // +1 год

int64 totalSeconds = end - start;
int64 days = totalSeconds / 86400;
int64 hours = (totalSeconds % 86400) / 3600;
int64 minutes = (totalSeconds % 3600) / 60;
int64 seconds = totalSeconds % 60;

print("Интервал: " + days + " дней, " + hours + " часов, " + minutes + " минут, " + seconds + " секунд");

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

На вход скрипта подаются значения некоего сигнала (Signal) и уставки (Constant). В том случае, если сигнал больше уставки, замыкается релейный выход (out0). Соотношение между сигналом и уставкой переводится в проценты и записывается в переменную Percent. Если это соотношение становится меньше определенного значения, то соответствующее сообщение записывается в переменную Alert.

Текст скрипта:
 bool main (float signal_val, float constant_val) // функция получает значения сигнала и уставки
{
float ratio; // переменная, в которой будет храниться соотношение сигнала и уставки
ratio = signal_val / constant_val; // вычисление соотношения
 percent_write(ratio); // вызов функции записи в узлы, с передачей в нее соотношения
 if ( signal_val > constant_val)
{
 return true; // если сигнал больше уставки, на выход скрипта приходит true
}
else
{
 return false; // если сигнал не больше уставки, на выход скрипта приходит false
}
}
 void percent_write (double ratio) // функция записи в узлы
{
string message = "Значение в пределах нормы"; // текстовое сообщение по умолчанию
double percent = ratio * 100; // вычисляется процентное соотношение

if ( percent < 50 )
{
 message = "Значение ниже нормы!"; // если процентное соотношение меньше 50
 // то текст сообщения меняется
}

// запись текстового сообщения в нужный узел
SetNodeValueAsString("/Конфигурация/Станция/Сигналы/Alert", message);

// запись процентного соотношения в нужный узел
SetNodeValueAsFloat("/Конфигурация/Станция/Сигналы/Percent", percent);
}

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

В этой таблице показаны доступные унарные операторы, в порядке убывания приоритета.
{| class="wikitable"
! Символ
!Операция
|-
|<code>::</code>
|Оператор разрешения области видимости
|-
|<code>[]</code>
| Оператор индексации
|-
|<code>++ --</code>
|Постинкремент и декремент
|-
|<code>.</code>
|Доступ
|-
|<code>++ --</code>
|Преинкремент и декремент
|-
|<code>!</code>
|Логическое НЕ
|-
|<code>+ -</code>
|Унарный положительный и отрицательный
|-
|<code>~</code>
|Побитовое дополнение
|-
|<code>@</code>
|Ссылка
|}
Эта таблица показывает приоритет бинарных и тернарных операторов в порядке убывания.
{| class="wikitable"
!Символ
!Операция
|-
|<code>**</code>
|Экспонента
|-
|<code>* / %</code>
|Умножить, разделить, по модулю
|-
|<code>+ -</code>
|Сложить и вычесть
|-
|<code><< >> >>></code>
|Сдвиг влево, сдвиг вправо и арифметический сдвиг вправо
|-
|<code>&</code>
|Битовое И
|-
|<code>^</code>
|Битовый XOR
|-
|<code><nowiki>|</nowiki></code>
|Битовое ИЛИ
|-
|<code><= < >= ></code>
|Сравнение
|-
|<code>== != is !is xor ^^</code>
|Равенство, идентичность и логическое исключающее ИЛИ
|-
|<code>and &&</code>
|Логическое И
|-
|<code><nowiki>or ||</nowiki></code>
|Логическое ИЛИ
|-
|<code>?:</code>
|Условие
|-
|<code>= += -= *= /= %= **= &=</code>

<code>|= ^= <<= >>= >>>=</code>
|Присваивание и составные присваивания
|}

==Зарезервированные ключевые слова==
Это ключевые слова, которые зарезервированы языком. Они не могут использоваться какими-либо идентификаторами, определенными скриптом.
{| class="wikitable"
|and

abstract

auto

bool

break

case

cast

catch

class

const

continue

default

do
|double

else

enum

explicit

external

false

final

float

for

from

funcdef

function

get
|if

import

in

inout

int

interface

int8

int16

int32

int64

is

mixin

namespace
|not

null

or

out

override

private

property

protected

return

set

shared

super

switch
|this

true

try

typedef

uint

uint8

uint16

uint32

uint64

void

while

xor
|}

==Ссылки==
<references />

[[Категория:AgavaSCADA/AgavaPLC]]

Описание языка С++ в AgavaSCADA/AgavaPLC

2026-04-24T12:19:47Z

TaushkanovKV: /* Поля */

Данное описание содержит базовое руководство по созданию программ на языке С++ и их использовании в [[Универсальная среда разработки|среде разработки Agava]].

== Дополнительные документы ==

* [[Описание базовых классов AgavaSCADA/AgavaPLC]].
* [[Объектная модель AgavaSCADA/AgavaPLC]].

== Основы синтаксиса ==
Все программы на языке С++ состоят из отдельных действий. Каждое действие заканчивается точкой с запятой:
int x;
x = 1;
int y = x + 2;
Для повышения удобства работы с кодом можно оставлять в нем комментарии, которые не используются при работе программы и предназначены для улучшения читаемости кода. Перед комментариями ставится «//»:
bool x = true;
// bool x = false;
// вторая строка не будет выполняться в программе

== Переменные ==
Переменные – объекты, хранящиеся в памяти, над которыми и производятся действия в программе.

Для начала работы с переменной необходимо инициализировать ее, указав тип и имя, а затем, при необходимости, присвоить ей значение:
bool a = true;
int b = 1;
double c = 1.1;
string d = “строка”;

int f; // переменная инициализирована, значение не присвоено
f = 1; // присвоение значения
Ключевое слово auto при инициализации переменной может использоваться вместо типа переменной, для автоматического присвоения типа переменной исходя из инициализируемого значения.
auto a = true;
auto b = 1;

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

При работе со строками доступны следующие функции:
{| class="wikitable"
!Функция
!Действие
|-
|uint length()
|Возвращает длину строки
|-
|void resize(uint)
|Устанавливает длину строки
|-
|bool isEmpty()
|Возвращает истину, если строка пуста, т. е. длина равна нулю
|-
|string substr(uint start = 0, int count = -1)
|Возвращает строку с содержимым, начинающимся с start, и количеством байтов, заданным параметром count. Аргументы по умолчанию вернут всю строку как новую строку
|-
|void insert(uint pos, const string &in other)
|Вставляет другую строку string на позиции pos в исходной строке
|-
|void erase(uint pos, int count = -1)
|Удаляет количество символов count из строки, начиная с позиции pos
|-
|int findFirst(const string &in str, uint start = 0)
|Находит первое вхождение значения str в строке, начиная с символа под номером start. Если вхождения не найдено, будет возвращено отрицательное значение
|-
|int findFirstOf(const string &in str, uint start = 0)
|Находит первое вхождение одного из символов в str в строке, начиная с символа под номером start. Если вхождения не найдено, будет возвращено отрицательное значение
|-
|int findLast(const string &in str, int start = -1)
|Находит последнее вхождение значения str в строке
|-
|int findLastOf(const string &in str, int start = -1)
|Находит последнее вхождение одного из символов в str в строке, начиная с символа под номером start. Если вхождения не найдено, будет возвращено отрицательное значение
|-
|string formatInt(int64 val, const string &in options = "", uint width=0)
|Преобразование int в строку
|-
|string formatUInt(uint64 val, const string &in options = "", uint width=0)
|Преобразование uint в строку
|-
|string formatFloat(double val, const string &in options="", uint width=0, uint precision=0)
|Преобразование float и double в строку
|-
|int64 parseInt(const string &in str, uint base=10, uint &out byteCount=0)
|Преобразование строки в int64
|-
|uint64 parseUInt(const string &in str, uint base=10, uint &out byteCount=0)
|Преобразование строки в uint64
|-
|double parseFloat(const string &in str, uint &out byteCount=0)
|Преобразование строки в double
|}
Пример работы с функциями для строк:
string str = “ABCDEF”; // инициализирована строка str

int a = str.length(); // a равно 6
int b = str.findFirst(“CD”, 0); // b равно 2

str.erase(1, 3); // str равно “AEF”

string str = "НАСОС1";
string substrToRemove = "НАСОС";

int pos = str.findFirst(substrToRemove);

if (pos >= 0)
{
str.erase(pos, substrToRemove.length()); // Теперь str содержит "1"
}

=== Массивы ===
Массив — многоэлементный тип данных, который позволяет получить доступ ко всем переменным одного и того же типа данных через использование одного идентификатора. Используется в том случае, если вам необходимо сгруппировать несколько элементов одного типа:
array <int> a = {2, 5, 10, 15, 20}; // инициализирован массив a с пятью элементами
int x = a [0]; // x становится равен элементу массива а под номером 0 (2)
int y = a [4]; // y становится равен элементу массива а под номером 4 (20)
arr [3] = 11; // элемент массива а под номером 3 становится равен 11
int z = arr [3]; // z становится равен элементу массива а под номером 3 (11)
Важно помнить, что нумерация членов массива начинается с 0.

При работе с массивами доступны следующие функции:
{| class="wikitable"
!Функция
!Действие
|-
|length()
|Возвращает длину массива
|-
|resize(uint)
|Устанавливает новую длину массива
|-
|reverse()
|Меняет порядок элементов в массиве на обратный
|-
|insertAt(uint index, const T& in value)
|Вставляет новый элемент в массив по указанному индексу
|-
|insertLast(const T& in)
|Добавляет элемент в конец массива
|-
|removeAt(uint index)
|Удаляет элемент по указанному индексу
|-
|removeLast()
|Удаляет последний элемент массива
|-
|removeRange(uint start, uint count)
|Удаляет количество элементов count, начиная с элемента номер start
|-
|sortAsc ()
|Сортирует элементы в массиве в порядке возрастания
|-
|sortDesc ()
|Сортирует элементы в массиве в порядке убывания
|-
|find (const T &in)
|Возвращает индекс первого элемента, который имеет то же значение, что и желаемое. Если совпадений не найдено, возвращает отрицательное значение
|}
Пример работы с функциями для массивов:
int main()
{
array<int> arr = {1,2,3}; // 1,2,3
arr.insertLast(0); // 1,2,3,0
arr.insertAt(2,4); // 1,2,4,3,0
arr.removeAt(1); // 1,4,3,0
arr.sortAsc(); // 0,1,3,4
int sum = 0;

for( uint n = 0; n < arr.length(); n++ )
sum += arr[n];

return sum;
}

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

Значения перечислений объявляются путем их объявления в операторе перечисления. Если для константы перечисления не указано конкретное значение, она будет принимать значение предыдущей константы плюс 1. Первая константа получит значение 0, если не указано иное.
enum Errors
{
 NoError, // = 0
 ReadError = 2, // = 2
 WriteError, // = 3
}

// теперь к константам перечисления можно обращаться через текстовое значение, например
// int a = NoError;

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

Логические переменные
{| class="wikitable"
!Тип
!Мин. значение
!Макс. значение
|-
|bool
|false (0)
|true (1)
|}
Целочисленные переменные
{| class="wikitable"
!Тип
!Мин. значение
!Макс. значение
|-
|int8
|<nowiki>- 128</nowiki>
|127
|-
|int16
|<nowiki>- 32 768</nowiki>
|32 767
|-
|int
|<nowiki>- 2 147 483 648</nowiki>
|2 147 483 647
|-
|int64
|<nowiki>- 9 223 372 036 854 775 808</nowiki>
|9 223 372 036 854 775 807
|-
|uint8
|0
|255
|-
|uint16
|0
|65 535
|-
|uint
|0
|4 294 967 295
|-
|uint64
|0
|18 446 744 073 709 551 615
|}
Переменные с плавающей запятой
{| class="wikitable"
!Тип
!Диапазон значений
!Наименьшее значение
|-
|float
|± 3.402823466 e+38
|1.175494351 e-38
|-
|double
|± 1.79769313486231 e+308
|2.22507385850720 e-308
|}

== Операторы ==
Доступны операторы сравнения, логические, побитовые, арифметические, приращений и индексации.

=== Операторы сравнения ===
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Равно
|==
|x == y
|true, если x равно y
|-
|Не равно
|!=
|x != y
|true, если x не равно y
|-
|Меньше
|<
|x < y
|true, если x меньше y
|-
|Больше
|>
|x > y
|true, если x больше y
|-
|Меньше или равно
|<=
|x <= y
|true, если x меньше или равно y
|-
|Больше или равно
|>=
|x >= y
|true, если x больше или равно y
|}

=== Логические операторы ===
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Логическое НЕ
|!
|!x
|true, если x – false и false, если x – true
|-
|Логическое И
|&&
|x && y
|true, если x и y – true, в противном случае – false
|-
|Логическое ИЛИ
|<nowiki>||</nowiki>
|<nowiki>x || y</nowiki>
|true, если x или y – true, в противном случае – false
|-
|Логическое ИСКЛЮЧАЮЩЕЕ ИЛИ (XOR)
|^
|x ^ y
|true, если x или y – true (но не одновременно), в противном случае – false
|}

=== Побитовые операторы ===
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Побитовое И
|&
|x & y
|Каждый бит в x И каждый соответствующий ему бит в y
|-
|Побитовое ИЛИ
|<nowiki>|</nowiki>
|<nowiki>x | y</nowiki>
|Каждый бит в x ИЛИ каждый соответствующий ему бит в y
|-
|Побитовое ИСКЛЮЧАЮЩЕЕ ИЛИ (XOR)
|^
|x ^ y
|Каждый бит в x XOR с каждым соответствующим ему битом в y
|-
|Побитовый сдвиг влево
|<<
|x << y
|Все биты в x смещаются влево на y бит
|-
|Побитовый сдвиг вправо
|>>
|x >> y
|Все биты в x смещаются вправо на y бит
|}
'''Пример'''
float RegistersToFloat(uint16 r0, uint16 r1)
{
// Создаем массив байтов в little-endian порядке
array<uint8> bytes(4);

// Little-endian (наиболее распространенный)
bytes[0] = r0 & 0xFF;
bytes[1] = (r0 >> 8) & 0xFF;
bytes[2] = r1 & 0xFF;
bytes[3] = (r1 >> 8) & 0xFF;

 // Преобразуем байты в uint32, затем в float
uint32 resultBits = 0;

for (uint i = 0; i < 4; i++)
{
resultBits |= uint32(bytes[i]) << (i * 8);
}

return fpFromIEEE(resultBits);
}

=== Арифметические операторы ===
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Сложение
|<nowiki>+</nowiki>
|x + y
|Складываем x и y
|-
|Вычитание
|<nowiki>-</nowiki>
|x – y
|Вычитаем y из x
|-
|Умножение
|*
|x * y
|Умножаем x на y
|-
|Деление
|/
|x / y
|Делим x на y
|-
|Присваивание
|=
|x = y
|Присваиваем значение y переменной x
|-
|Сложение с присваиванием
|<nowiki>+=</nowiki>
|x += y
|Добавляем y к x
|-
|Вычитание с присваиванием
|<nowiki>-=</nowiki>
|x -= y
|Вычитаем y из x
|-
|Умножение с присваиванием
|*=
|x *= y
|Умножаем x на y
|-
|Деление с присваиванием
|/=
|x /= y
|Делим x на y
|}

=== Операторы приращений ===
Операция инкремента увеличивает значение на 1, декремента – уменьшает на 1.
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Преинкремент
|<nowiki>++</nowiki>
|<nowiki>++х</nowiki>
|Инкремент х, затем вычисление х
|-
|Предекремент
|<nowiki>--</nowiki>
|<nowiki>--х</nowiki>
|Декремент х, затем вычисление х
|-
|Постинкремент
|<nowiki>++</nowiki>
|х++
|Вычисление х, затем инкремент х
|-
|Постдекремент
|<nowiki>--</nowiki>
|х--
|Вычисление х, затем декремент х
|}

=== Оператор индексации ===
Используется для доступа к элементу.
{| class="wikitable"
!Оператор
!Символ
!Пример
!Операция
|-
|Индексация
|[ ]
|arr [0]
|Обращение к нулевому элементу массива arr
|}

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

Внешние блоки не имеют доступа к переменным внутренних блоков.
{
 int a;
 float b;
 {
 float a = 1.0; // Отменить объявление внешней переменной
// но только в пределах внутреннего блока
 b = a; // переменные из внешних блоков все еще доступны
 int c;
 }

 // a снова становится целочисленной переменной, b теперь равна 1.0, c здесь недоступна
}

== Условия ==

=== Операторы if/else ===
Позволяют выбрать выполнение нужных действий, в зависимости от выбранного условия, указанного в скобках:
if (x == 1)
{
// эти действия выполнятся, если х равно 1
}
else
{
// эти действия выполнятся, если х не равно 1
}

=== Условное выражение (тернарный оператор) ===
Более короткая запись оператора выбора if/else:
x = 1 ? y = true : y = false; // если х равно 1, тогда y равен true, иначе y равен false

=== Оператор switch ===
Является альтернативой if/else для тех случаев, когда необходимо сделать множественный выбор:
switch(x)
{
case 0:
 // эти действия выполнятся, если х равно 0
 break; // каждый case всегда должен заканчивать оператором break
case 1:
 // эти действия выполнятся, если х равно 1
 break;
case 2:
 // эти действия выполнятся, если х равно 2
 break;
default:
 // Эти действия выполнятся, если x не равен ни одному из предыдущих значений case
}

== Циклы ==

=== Цикл while ===
Цикл выполняется, пока условие в скобках истинно:
x = 0;

while (x < 5)
{
// это действие будет выполняться, пока х меньше 5
x++; // при каждом выполнении цикла увеличиваем х на 1
}

=== Цикл do while ===
Цикл похож на while, но, в отличии от него, цикл в любом случае выполнится хотя бы один раз (или больше, если при последующих проверках условие будет истинно):
x = 10;

do
{
// это действие выполнится один раз, так как условие изначально ложно
}
while (x < 5);

=== Цикл for ===
Цикл for обычно используется как счетчик и хорошо подходит, когда известно необходимое количество итераций. В скобках через точку с запятой указывается переменная, условие, инкремент / декремент для переменной:
for ( int x = 0; x < 5; x ++ )
{
// при каждом выполнении этих действий переменная х будет увеличивать на 1
// действия будут выполняться пока х меньше 5
}

== Функции ==
Функция — это последовательность действия для выполнения определенного задания. Объявление функции похоже на объявление переменной: необходимо указать тип возвращаемого значения (либо void, если функция ничего не возвращает) и название функции. После этого ставятся двойные скобки, в которых находятся аргументы функции (либо пустые скобки, если аргументы отсутствуют). Действия, выполняемые функцией, заключаются в фигурные скобки.

Любой код в операции «Скрипт С++» должен находиться в функции. При использовании нескольких функций в скрипте будет выполняться только первая, остальные должны быть вызваны из нее:
void main ()
{
int x = 1;
function (); // вызов функции, программа переходит в void function()
SetNodeValueAsInt(“/Конфигурация/Станция/Сигналы/Constant2”, x);
}

void function ()
{
SetNodeValueAsInt(“/Конфигурация/Станция/Сигналы/Constant2”, 5);
// теперь программа возвращается обратно в void main()
}
После выполнения данного скрипта значение сигнала Constant1 станет равно 5, а Constant2 равно 1.

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

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

Параметры указываются при объявлении функции в круглых скобках:
void summ (int x, int y) // в функцию передаются параметры х = 1 и y = 2
{
int z = x + y; // z равно 3
}

=== Возврат значения ===
Для передачи значения из скрипта можно указать необходимое значение в действии return, указав тип функции такой же, как у возвращаемого значения:
bool R_Output (bool x, bool y)
{
bool z = false;
z = x && y;

return z; // z передается на выход скрипта
}

== Математические и тригонометрические функции ==

===Преобразование IEEE битов===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float fpFromIEEE(uint bits)</code>
|Преобразует 32-битное IEEE-754 представление в число float
|<code>bits</code> (uint) - битовое представление
|-
|<code>uint fpToIEEE(float value)</code>
|Преобразует число float в 32-битное IEEE-754 представление
|<code>value</code> (float) - исходное число
|-
|<code>double fpFromIEEE(uint64 bits)</code>
|Преобразует 64-битное IEEE-754 представление в число double
|<code>bits</code> (uint64) - битовое представление
|-
|<code>uint64 fpToIEEE(double value)</code>
|Преобразует число double в 64-битное IEEE-754 представление
|<code>value</code> (double) - исходное число
|}

=== Сравнение с допуском===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>bool closeTo(float a, float b, float epsilon = 0.00001f)</code>
|Сравнивает два числа float с заданной погрешностью
|<code>a</code> (float) - первое число
<code>b</code> (float) - второе число
<code>epsilon</code> (float, опционально) - погрешность (по умолчанию 0.00001)
|-
|<code>bool closeTo(double a, double b, double epsilon = 0.0000000001)</code>
|Сравнивает два числа double с заданной погрешностью
|<code>a</code> (double) - первое число
<code>b</code> (double) - второе число
<code>epsilon</code> (double, опционально) - погрешность (по умолчанию 1e-10)
|}

=== Тригонометрические функции ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float cos(float angle)</code>
|Вычисляет косинус угла
|<code>angle</code> (float) - угол в радианах
|-
|<code>float sin(float angle)</code>
|Вычисляет синус угла
|<code>angle</code> (float) - угол в радианах
|-
|<code>float tan(float angle)</code>
|Вычисляет тангенс угла
|<code>angle</code> (float) - угол в радианах
|-
|<code>float acos(float value)</code>
|Вычисляет арккосинус (обратный косинус)
|<code>value</code> (float) - значение в диапазоне [-1, 1]
|-
|<code>float asin(float value)</code>
|Вычисляет арксинус (обратный синус)
|<code>value</code> (float) - значение в диапазоне [-1, 1]
|-
|<code>float atan(float value)</code>
|Вычисляет арктангенс (обратный тангенс)
|<code>value</code> (float) - значение
|-
|<code>float atan2(float y, float x)</code>
|Вычисляет арктангенс двух переменных
|<code>y</code> (float) - координата Y
<code>x</code> (float) - координата X
|}

=== Гиперболические функции ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float cosh(float x)</code>
|Вычисляет гиперболический косинус
|<code>x</code> (float) - значение
|-
|<code>float sinh(float x)</code>
|Вычисляет гиперболический синус
|<code>x</code> (float) - значение
|-
|<code>float tanh(float x)</code>
|Вычисляет гиперболический тангенс
|<code>x</code> (float) - значение
|}

=== Экспоненциальные и логарифмические функции ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float log(float x)</code>
|Вычисляет натуральный логарифм (по основанию e)
|<code>x</code> (float) - значение > 0
|-
|<code>float log10(float x)</code>
|Вычисляет десятичный логарифм (по основанию 10)
|<code>x</code> (float) - значение > 0
|}

=== Степенные функции ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float pow(float base, float exponent)</code>
|Возводит число в степень
|<code>base</code> (float) - основание
<code>exponent</code> (float) - показатель степени
|-
|<code>float sqrt(float x)</code>
|Вычисляет квадратный корень
|<code>x</code> (float) - неотрицательное значение
|}

=== Функции округления и остатка ===
{| class="wikitable"
!Функция
!Действие
!Аргументы
|-
|<code>float ceil(float x)</code>
|Округляет вверх до ближайшего целого
|<code>x</code> (float) - значение
|-
|<code>float abs(float x)</code>
|Вычисляет абсолютное значение (модуль)
|<code>x</code> (float) - значение
|-
|<code>float floor(float x)</code>
|Округляет вниз до ближайшего целого
|<code>x</code> (float) - значение
|-
|<code>float fraction(float x)</code>
|Выделяет дробную часть числа
|<code>x</code> (float) - значение
|}

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

===Функции для работы с узлами===
{| class="wikitable"
!Определение функции
!Описание
|-
|float GetNodeValueAsFloat(string strNodePath)
|Получить значение узла в виде float по заданному пути
|-
|void SetNodeValueAsFloat(string strNodePath, float fValue)
|Установить значение узла в float по заданному пути
|-
|int GetNodeValueAsInt(string strNodePath)
|Получить значение узла в виде int по заданному пути
|-
|void SetNodeValueAsInt(string strNodePath, int iValue)
|Установить значение узла в int по заданному пути
|-
|string GetNodeValueAsString(string strNodePath)
|Получить значение узла в виде string по заданному пути
|-
| void SetNodeValueAsString(string strNodePath, string strValue)
|Установить значение узла в виде string по заданному пути
|-
|bool GetNodeValueAsBool(string strNodePath)
|Получить значение узла в виде bool по заданному пути
|-
|void SetNodeValueAsBool(string strNodePath, bool bValue)
|Установить значение узла в виде bool по заданному пути
|-
|bool NodeValueIsError(string strNodePath)
|Проверка значения узла на ошибку
|-
|void StartNode(string strNodePath)
|Запуск узла по заданному пути
|-
|void StopNode(string strNodePath)
|Остановка узла по заданному пути
|}

===Функции для работы с окнами ===
{| class="wikitable"
!Определение функции
!Описание
|-
| <code>void CloseWindow(string strNodePath, int iDisplay)</code>
|Закрыть окно по заданному пути на дисплее с номером iDisplay
|-
|<code>void ShowWindow(string strNodePath, int iDisplay)</code>
|Отобразить окно по заданному пути на дисплее с номером iDisplay.
Координаты - абсолютные, установленные в свойствах окна.
|-
|<code>int LoadComposition(string strWindowPath, string strCompositionPath, int iDisplay)</code>
|Загрузить композицию strCompositionPath в окно strWindowPath на дисплее с номером iDisplay.
<code>AS 1.6.25+</code>
|}

===Функции для работы с временем===
{| class="wikitable"
!Определение функции
!Описание
|-
|int GetCurrentTime()
|Получение текущего времени в UNIX формате (количество секунд с 01 января 1970 года)
|-
|uint64 GetCurrentTimeMs()
|Получение текущего времени в UNIX формате (количество миллисекунд с 01 января 1970 года) (<code>AS 1.2.55+</code>, <code>AS 1.6.1+</code>)
|-
|int GetLocalTime()
| Получение текущего времени в UNIX формате (количество секунд с 01 января 1970 года) с учетом часового пояса
|-
|int GetHours(int iTime)
| Получение текущего часа из времени в формате UNIX
|-
|int GetMinutes(int iTime)
|Получение текущих минут из времени в формате UNIX
|-
|int GetSeconds(int iTime)
|Получение текущих секунд из времени в формате UNIX
|}

===Функции для работы с событиями===
'''int StoreMessage(int iMessageLevel, string strMessage)'''
{| class="wikitable"
|-
|'''Назначение'''
|Генерация информационного события (типа "сообщение"). Событие помещается в группу "Системные".
|-
|'''Возвращаемое значение'''
|0 - успешно, иначе код ошибки
|-
| rowspan="2" |'''Аргументы'''
|int iMessageLevel - уровень сообщения (1-наивысший): 1=FATAL, 2=ERROR, 3=WARNING, 4=NOTICE, 5=INFO, 6=TRACE, 7=DEBUG
|-
|string strMessage - текст сообщения
|-
|'''Примечания'''
|функция доступна с версии <code>AS 1.2.34+</code>
|}
'''int StoreMessage(int iMessageLevel, string strMessage, string strGroup)'''
{| class="wikitable"
|-
|'''Назначение'''
|Генерация информационного события (типа "сообщение"). Событие помещается в указанную при вызове группу.
|-
|'''Возвращаемое значение'''
|0 - успешно, иначе код ошибки
|-
| rowspan="3" |'''Аргументы'''
|int iMessageLevel - уровень сообщения (1-наивысший): 1=FATAL, 2=ERROR, 3=WARNING, 4=NOTICE, 5=INFO, 6=TRACE, 7=DEBUG
|-
|string strMessage - текст сообщения
|-
|string strGroup - имя группы, в которую должно помещаться событие.
|-
|'''Примечания'''
|функция доступна с версии <code>AS 1.6.20+</code>
|}

===Функции для работы со строками===
'''string EncodeMD5(string strText)'''
{| class="wikitable"
|-
|'''Назначение'''
|Кодирование строки в MD5 хэш
|-
|'''Возвращаемое значение'''
|MD5 хэш параметра
|-
|'''Аргументы'''
|string strText - исходная строка
|-
|'''Примечания'''
| функция доступна с версии <code>AS 1.2.34+</code>
|}

===Другие функции===
Проверка на nan.
'''bool isnan(double)'''

Запуск процесса в операционной системе.
'''int LaunchProcess(string process)'''
Запуск производится в блокирующем режиме, то есть возврат из функции осуществляется по завершению процесса.

==Класс file==
Класс доступен начиная с версии 1.4.5 AgavaSCADA/AgavaPLC.

===Методы===
'''int open(const string& filename, const string& mode)'''
{| class="wikitable"
|-
|'''Назначение'''
|Открытие файла
|-
|'''Возвращаемое значение'''
|Результат выполнения операции: 0 - успешно, -1 - ошибка.
|-
| rowspan="2" |'''Аргументы'''
|const string& filename - путь до файла
|-
|const string& mode - режим открытия файла.
|}
'''int close()'''
{| class="wikitable"
|-
|'''Назначение'''
|Закрытие файла
|-
|'''Возвращаемое значение'''
|Результат выполнения операции. 0 - успешно, -1 - ошибка.
|-
|'''Аргументы'''
| -
|}
'''int getSize() const'''
{| class="wikitable"
|-
|'''Назначение'''
|Получение размера файла
|-
|'''Возвращаемое значение'''
|Размер файла в байтах
|-
|'''Аргументы'''
| -
|}
'''bool isEndOfFile() const'''
{| class="wikitable"
|-
|'''Назначение'''
| Получение признака конца файла
|-
|'''Возвращаемое значение'''
|true - обнаружен конец файла.
|-
|'''Аргументы'''
| -
|}
'''string readString(uint length)'''
{| class="wikitable"
|-
|'''Назначение'''
|Чтение строки
|-
|'''Возвращаемое значение'''
|Считанная строка
|-
|'''Аргументы'''
|uint length - длина считываемой строки
|}
'''string readLine()'''
{| class="wikitable"
|-
|'''Назначение'''
|Чтение строки
|-
|'''Возвращаемое значение'''
|Считанная строка
|-
|'''Аргументы'''
| -
|-
|'''Примечания'''
| Считывание производится до тех пор, пока не будет обнаружен символ '\n' или конец файла
|}
'''int64 readInt(uint)'''
'''Назначение:''' чтение целого числа со знаком.

'''Возвращаемое значение''': считанное значение.

'''Аргументы''': отсутствуют.

'''Примечания''': отсутствуют.
'''uint64 readUInt(uint)'''
'''Назначение:''' чтение целого беззнакового числа.

'''Возвращаемое значение''': считанное значение.

'''Аргументы''': отсутствуют.

'''Примечания''': отсутствуют.
'''float readFloat()'''
'''Назначение:''' чтение целого вещественного числа одинарной точности.

'''Возвращаемое значение''': считанное значение.

'''Аргументы''': отсутствуют.

'''Примечания''': отсутствуют.

double readDouble()

int writeString(const string &in)

int writeInt(int64, uint)

int writeUInt(uint64, uint)

int writeFloat(float)

int writeDouble(double)

int getPos() const

int setPos(int)

int movePos(int)

===Поля===
bool mostSignificantByteFirst.

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

=== Методы ===

==== <code>bool changeCurrentPath(const string &in path)</code> ====
'''Назначение:''' Изменяет текущую рабочую директорию.

'''Аргументы:'''

* <code>path</code> – путь к новой директории (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>true</code> – если путь существует и текущая директория успешно изменена.
* <code>false</code> – если указанный путь не существует или не является директорией.

'''Примечания:'''

* Если путь задан относительно, он объединяется с текущей директорией.
* Путь не должен содержать обратные слеши <code>\</code> – они автоматически заменяются на <code>/</code>.
* Завершающие слеши автоматически удаляются из пути.
* Не поддерживает разрешение внутренних ссылок <code>/./</code> и <code>/../</code> (отмечено в TODO).

==== <code>string getCurrentPath() const</code> ====
'''Назначение:''' Возвращает текущую рабочую директорию.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Строка с абсолютным путём текущей директории, использующая разделители <code>/</code>.

'''Примечания:'''

* При создании объекта <code>filesystem</code> текущая директория инициализируется рабочим каталогом приложения.
* Все обратные слеши <code>\</code> заменяются на <code>/</code> для единообразия.

==== <code>array<string> @getDirs() const</code> ====
'''Назначение:''' Получает список всех поддиректорий внутри текущей директории.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Массив строк с именами поддиректорий.

'''Примечания:'''

* Специальные записи <code>.</code> (текущая директория) и <code>..</code> (родительская директория) исключаются из результата.
* Возвращает пустой массив, если директорий нет или произошла ошибка чтения.

==== <code>array<string> @getFiles() const</code> ====
'''Назначение:''' Получает список всех файлов внутри текущей директории.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Массив строк с именами файлов.

'''Примечания:'''

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

==== <code>bool isDir(const string &in path) const</code> ====
'''Назначение:''' Проверяет, является ли указанный путь директорией.

'''Аргументы:'''

* <code>path</code> – путь к объекту файловой системы (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>true</code> – если объект существует и является директорией.
* <code>false</code> – если объект не существует, не является директорией или произошла ошибка.

'''Примечания:'''

* Относительные пути разрешаются относительно текущей директории.
* Абсолютные пути определяются наличием двоеточия <code>:</code> (например, <code>C:</code>) или начального слеша <code>/</code> или <code>\</code>.

==== <code>bool isLink(const string &in path) const</code> ====
'''Назначение:''' Проверяет, является ли указанный путь символической ссылкой (symlink).

'''Аргументы:'''

* <code>path</code> – путь к объекту файловой системы (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>true</code> – если объект существует и является символической ссылкой (на Windows – репарс-точкой).
* <code>false</code> – если объект не является ссылкой, не существует или произошла ошибка.

'''Примечания:'''

* Кроссплатформенная поддержка: Windows (атрибут <code>FILE_ATTRIBUTE_REPARSE_POINT</code>) и POSIX (флаг <code>S_IFLNK</code>).
* Относительные пути разрешаются относительно текущей директории.

==== <code>int64 getSize(const string &in path) const</code> ====
'''Назначение:''' Возвращает размер файла в байтах.

'''Аргументы:'''

* <code>path</code> – путь к файлу (относительный или абсолютный).

'''Возвращаемое значение:'''

* Размер файла в байтах (тип <code>int64</code>).
* <code>-1</code> – если файл не существует, указан путь к директории или произошла ошибка.

'''Примечания:'''

* На Windows используется API-функция <code>GetFileSizeEx</code>.
* На POSIX-системах используется <code>stat</code>.
* Для директорий возвращает <code>-1</code>.

==== <code>int makeDir(const string &in path)</code> ====
'''Назначение:''' Создаёт новую директорию.

'''Аргументы:'''

* <code>path</code> – путь к создаваемой директории (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>0</code> – директория успешно создана.
* <code>-1</code> – ошибка создания (например, недостаточно прав, путь не существует).

'''Примечания:'''

* '''Важно:''' Не поддерживает рекурсивное создание промежуточных директорий (отмечено в TODO).
* На Windows создаёт директорию с правами по умолчанию.
* На POSIX создаёт с правами <code>S_IRWXU | S_IRWXG | S_IROTH | S_IXOTH</code> (755: чтение/запись/исполнение для владельца, чтение/исполнение для группы и остальных).

==== <code>int removeDir(const string &in path)</code> ====
'''Назначение:''' Удаляет пустую директорию.

'''Аргументы:'''

* <code>path</code> – путь к удаляемой директории (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>0</code> – директория успешно удалена.
* <code>-1</code> – ошибка удаления (директория не пуста, не существует, недостаточно прав).

'''Примечания:'''

* Удаляет только '''пустые''' директории.
* Не поддерживает рекурсивное удаление с содержимым (отмечено в TODO).
* На Windows используется <code>RemoveDirectoryW</code>, на POSIX – <code>rmdir</code>.

==== <code>int deleteFile(const string &in path)</code> ====
'''Назначение:''' Удаляет файл.

'''Аргументы:'''

* <code>path</code> – путь к удаляемому файлу (относительный или абсолютный).

'''Возвращаемое значение:'''

* <code>0</code> – файл успешно удалён.
* <code>-1</code> – ошибка удаления (файл не существует, недостаточно прав, указана директория).

'''Примечания:'''

* На Windows используется <code>DeleteFileW</code>, на POSIX – <code>unlink</code>.
* Для удаления директорий используйте <code>removeDir</code>.

==== <code>int copyFile(const string &in source, const string &in target)</code> ====
'''Назначение:''' Копирует файл из одного местоположения в другое.

'''Аргументы:'''

* <code>source</code> – путь к исходному файлу.
* <code>target</code> – путь к целевому файлу (не директории).

'''Возвращаемое значение:'''

* <code>0</code> – файл успешно скопирован.
* <code>-1</code> – ошибка копирования (исходный файл не существует, недостаточно прав, целевой файл уже существует).

'''Примечания:'''

* На Windows используется API-функция <code>CopyFileW</code> с параметром <code>TRUE</code> (не перезаписывать существующий файл).
* На POSIX-системах копирование выполняется '''вручную''' побайтово через <code>fopen/fread/fwrite</code>, так как стандартной функции копирования нет.
* Целевой файл не должен существовать (флаг <code>TRUE</code> на Windows).

==== <code>int move(const string &in source, const string &in target)</code> ====
'''Назначение:''' Перемещает или переименовывает файл или директорию.

'''Аргументы:'''

* <code>source</code> – текущий путь к объекту.
* <code>target</code> – новый путь или имя объекта.

'''Возвращаемое значение:'''

* <code>0</code> – объект успешно перемещён/переименован.
* <code>-1</code> – ошибка операции (объект не существует, недостаточно прав).

'''Примечания:'''

* Может использоваться как для файлов, так и для директорий.
* На Windows используется <code>MoveFileW</code>, на POSIX – <code>rename</code>.
* Операция может выполняться в пределах одного тома/файловой системы.

==== <code>datetime getCreateDateTime(const string &in path) const</code> ====
'''Назначение:''' Возвращает дату и время создания файла или директории.

'''Аргументы:'''

* <code>path</code> – путь к объекту файловой системы.

'''Возвращаемое значение:'''

* Объект <code>datetime</code>, содержащий дату и время создания.

'''Примечания:'''

* '''Выбрасывает исключение''' в скриптовом контексте через <code>SetException</code>, если не удаётся получить дату создания.
* На Windows используется <code>GetFileTime</code> с полем <code>createTm</code>.
* На POSIX-системах используется поле <code>st_ctime</code> (change time) – может отличаться от реального времени создания на некоторых файловых системах.

==== <code>datetime getModifyDateTime(const string &in path) const</code> ====
'''Назначение:''' Возвращает дату и время последнего изменения файла или директории.

'''Аргументы:'''

* <code>path</code> – путь к объекту файловой системы.

'''Возвращаемое значение:'''

* Объект <code>datetime</code>, содержащий дату и время последней модификации.

'''Примечания:'''

* '''Выбрасывает исключение''' в скриптовом контексте через <code>SetException</code>, если не удаётся получить дату изменения.
* На Windows используется <code>GetFileTime</code> с полем <code>modifyTm</code>.
* На POSIX-системах используется поле <code>st_mtime</code> (modify time).

==Класс datetime==
Класс доступен начиная с версии 1.6+.

===Конструкторы===

====Конструктор по умолчанию====
datetime dt();
Создает объект с текущей датой и временем.

====Конструктор копирования====
datetime dt(other);
Создает копию существующего объекта datetime.

====Конструктор с параметрами====
datetime dt(year, month, day, hour = 0, minute = 0, second = 0);
Создает объект с указанной датой и временем.
'''Примеры:'''
// Только дата
datetime newYear = datetime(2024, 1, 1);

// Дата и время
datetime meeting = datetime(2024, 12, 25, 14, 30, 0);

// Полная спецификация
datetime exact = datetime(2024, 6, 15, 9, 45, 30);

===Методы===
<code>uint get_year() const</code>

Возвращает год (4 цифры).

<code>uint get_month() const</code>

Возвращает месяц (1-12).

<code>uint get_day() const</code>

Возвращает день месяца (1-31).

<code>uint get_hour() const</code>

Возвращает часы (0-23).

<code>uint get_minute() const</code>

Возвращает минуты (0-59).

<code>uint get_second() const</code>

Возвращает секунды (0-59).

'''Пример:'''
datetime dt = datetime(2024, 12, 25, 14, 30, 45);

uint year = dt.year; // 2024
uint month = dt.month; // 12
uint day = dt.day; // 25
uint hour = dt.hour; // 14
uint minute = dt.minute; // 30
uint second = dt.second; // 45
<code>bool setDate(year, month, day)</code>

Устанавливает дату. Возвращает <code>true</code> при успехе, <code>false</code> при неверной дате.

'''Пример:'''
datetime dt;
bool success = dt.setDate(2024, 2, 29); // true (високосный год)
bool invalid = dt.setDate(2023, 2, 29); // false (не високосный)
<code>bool setTime(hour, minute, second)</code>

Устанавливает время. Возвращает <code>true</code> при успехе, <code>false</code> при неверном времени.

'''Пример:'''

cpp
datetime dt;
bool success = dt.setTime(23, 59, 59); // true
bool invalid = dt.setTime(25, 0, 0); // false (часы > 23)

===Арифметические операции===
Вычитание дат
int64 difference = dt1 - dt2;
Возвращает разницу в секундах.
datetime start = datetime(2024, 1, 1, 0, 0, 0);
datetime end = datetime(2024, 1, 2, 0, 0, 0);
int64 diff = end - start; // 86400 секунд (1 день)
Сложение с секундами
datetime result = dt + seconds;
datetime result = seconds + dt; // обратный порядок
dt += seconds;
'''Пример:'''
datetime dt = datetime(2024, 1, 1, 10, 0, 0);

// Добавить 2 часа
datetime later = dt + 7200;
dt += 7200;

// Обратный порядок
datetime same = 7200 + dt;
Вычитание секунд
datetime result = dt - seconds;
datetime result = seconds - dt; // обратный порядок
dt -= seconds;
'''Пример:'''
datetime dt = datetime(2024, 1, 1, 10, 0, 0);

// Вычесть 30 минут
datetime earlier = dt - 1800;
dt -= 1800;

===Операции сравнения ===
<code>bool opEquals(other)</code>

Проверка равенства дат.

<code>bool opLess(other)</code>

Проверка что дата раньше.

<code>int opCmp(other)</code>

Сравнение с возвратом -1 (меньше), 0 (равно), 1 (больше).

'''Пример:'''
datetime dt1 = datetime(2024, 1, 1);
datetime dt2 = datetime(2024, 1, 2);

if (dt1 < dt2) {
// dt1 раньше dt2
}

if (dt1 == dt2) {
// даты равны
}

int result = dt1.opCmp(dt2); // -1

===Практические примеры ===
Пример 1: Таймер выполнения
datetime startTime;

// Выполняем некоторую операцию
for (int i = 0; i < 1000000; i++)
{
// какая-то работа
}

datetime endTime;
int64 elapsed = endTime - startTime;
print("Операция заняла: " + elapsed + " секунд");
Пример 2: Расчет дат событий
// Дата начала проекта
datetime projectStart = datetime(2024, 1, 15);

// Напоминание за 3 дня до дедлайна
datetime deadline = datetime(2024, 3, 1);
datetime reminder = deadline - 3 * 86400; // 3 дня в секундах

// Продление срока на 2 недели
datetime extendedDeadline = deadline + 14 * 86400;
Пример 3: Проверка рабочего времени
datetime currentTime;

// Создаем время начала и конца рабочего дня
datetime workStart = datetime(currentTime.year, currentTime.month,
currentTime.day, 9, 0, 0);
datetime workEnd = workStart + 8 * 3600; // 8 часов

if (currentTime >= workStart && currentTime <= workEnd)
{
print("Рабочее время");
}
else
{
print("Вне рабочего времени");
}
Пример 4: Валидация даты
bool createAppointment(uint year, uint month, uint day, uint hour)
{
datetime appointment;

// Проверяем корректность даты
if (!appointment.setDate(year, month, day)) {
print("Неверная дата!");
return false;
}

// Проверяем корректность времени
if (!appointment.setTime(hour, 0, 0)) {
print("Неверное время!");
return false;
}

// Проверяем что дата не в прошлом
datetime now;
if (appointment < now) {
print("Дата не может быть в прошлом!");
return false;
}

print("Встреча создана: " + appointment.year + "-" + appointment.month + "-" + appointment.day);
return true;
}
Пример 5: Разбивка интервала времени
datetime start = datetime(2024, 1, 1, 0, 0, 0);
datetime end = start + 365 * 86400; // +1 год

int64 totalSeconds = end - start;
int64 days = totalSeconds / 86400;
int64 hours = (totalSeconds % 86400) / 3600;
int64 minutes = (totalSeconds % 3600) / 60;
int64 seconds = totalSeconds % 60;

print("Интервал: " + days + " дней, " + hours + " часов, " + minutes + " минут, " + seconds + " секунд");

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

На вход скрипта подаются значения некоего сигнала (Signal) и уставки (Constant). В том случае, если сигнал больше уставки, замыкается релейный выход (out0). Соотношение между сигналом и уставкой переводится в проценты и записывается в переменную Percent. Если это соотношение становится меньше определенного значения, то соответствующее сообщение записывается в переменную Alert.

Текст скрипта:
 bool main (float signal_val, float constant_val) // функция получает значения сигнала и уставки
{
float ratio; // переменная, в которой будет храниться соотношение сигнала и уставки
ratio = signal_val / constant_val; // вычисление соотношения
 percent_write(ratio); // вызов функции записи в узлы, с передачей в нее соотношения
 if ( signal_val > constant_val)
{
 return true; // если сигнал больше уставки, на выход скрипта приходит true
}
else
{
 return false; // если сигнал не больше уставки, на выход скрипта приходит false
}
}
 void percent_write (double ratio) // функция записи в узлы
{
string message = "Значение в пределах нормы"; // текстовое сообщение по умолчанию
double percent = ratio * 100; // вычисляется процентное соотношение

if ( percent < 50 )
{
 message = "Значение ниже нормы!"; // если процентное соотношение меньше 50
 // то текст сообщения меняется
}

// запись текстового сообщения в нужный узел
SetNodeValueAsString("/Конфигурация/Станция/Сигналы/Alert", message);

// запись процентного соотношения в нужный узел
SetNodeValueAsFloat("/Конфигурация/Станция/Сигналы/Percent", percent);
}

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

В этой таблице показаны доступные унарные операторы, в порядке убывания приоритета.
{| class="wikitable"
! Символ
!Операция
|-
|<code>::</code>
|Оператор разрешения области видимости
|-
|<code>[]</code>
| Оператор индексации
|-
|<code>++ --</code>
|Постинкремент и декремент
|-
|<code>.</code>
|Доступ
|-
|<code>++ --</code>
|Преинкремент и декремент
|-
|<code>!</code>
|Логическое НЕ
|-
|<code>+ -</code>
|Унарный положительный и отрицательный
|-
|<code>~</code>
|Побитовое дополнение
|-
|<code>@</code>
|Ссылка
|}
Эта таблица показывает приоритет бинарных и тернарных операторов в порядке убывания.
{| class="wikitable"
!Символ
!Операция
|-
|<code>**</code>
|Экспонента
|-
|<code>* / %</code>
|Умножить, разделить, по модулю
|-
|<code>+ -</code>
|Сложить и вычесть
|-
|<code><< >> >>></code>
|Сдвиг влево, сдвиг вправо и арифметический сдвиг вправо
|-
|<code>&</code>
|Битовое И
|-
|<code>^</code>
|Битовый XOR
|-
|<code><nowiki>|</nowiki></code>
|Битовое ИЛИ
|-
|<code><= < >= ></code>
|Сравнение
|-
|<code>== != is !is xor ^^</code>
|Равенство, идентичность и логическое исключающее ИЛИ
|-
|<code>and &&</code>
|Логическое И
|-
|<code><nowiki>or ||</nowiki></code>
|Логическое ИЛИ
|-
|<code>?:</code>
|Условие
|-
|<code>= += -= *= /= %= **= &=</code>

<code>|= ^= <<= >>= >>>=</code>
|Присваивание и составные присваивания
|}

==Зарезервированные ключевые слова==
Это ключевые слова, которые зарезервированы языком. Они не могут использоваться какими-либо идентификаторами, определенными скриптом.
{| class="wikitable"
|and

abstract

auto

bool

break

case

cast

catch

class

const

continue

default

do
|double

else

enum

explicit

external

false

final

float

for

from

funcdef

function

get
|if

import

in

inout

int

interface

int8

int16

int32

int64

is

mixin

namespace
|not

null

or

out

override

private

property

protected

return

set

shared

super

switch
|this

true

try

typedef

uint

uint8

uint16

uint32

uint64

void

while

xor
|}

==Ссылки==
<references />

[[Категория:AgavaSCADA/AgavaPLC]]

Узлы проекта AgavaSCADA/AgavaPLC

2026-04-13T06:10:32Z

TaushkanovKV: /* Система тревог */

== Узлы проекта ==
Узел - элементарная сущность проекта, осуществляющая хранение информации или реализующая определенный функционал. Каждый узел обладает набором [[Свойства узлов в AgavaSCADA/AgavaPLC|свойств]]. Все узлы, объединенные в иерархическую структуру, образуют проект.

== Проект ==
[[Файл:AgavaPLC–Дерево проекта.png|мини|Рисунок 21 – Дерево проекта]]
Узел "Проект" ("Корневой узел", "Корень") предназначен для хранения общей информации о проекте и связывания других узлов проекта.

== Станция ==
Станция – важнейший узел, управляющий работой собственных систем и выполняющий обмен данными с другими станциями. Физически станция представляет собой устройство, на котором исполняется проект (компьютер, панель оператора, МПР-60 или другое устройство).

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

* '''Станция''' - общий тип станции. Проекты с такой станцией могут выполняться на большинстве устройств - контроллеры, панели, персональные компьютеры. Чаще всего используется для проектов, предназначенных для выполнения на персональном компьютере.
* '''Панель ПО-40''' - специализированный тип для проектов на панелях оператора ПО-40. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием панели оператора (светодиоды индикации и др.), использования корзины субмодулей.
* '''Панель ПО-50''' - специализированный тип для проектов на панелях оператора ПО-50. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием панели оператора (светодиоды индикации и др.).
* '''Контроллер МПР-60''' - специализированный тип для проектов на программируемых реле МПР-60. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием устройства (светодиоды индикации и др.), использования корзины субмодулей.
* '''Контроллер ПЛК-70.A''' - специализированный тип для проектов, предназначенных для контроллеров АГАВА ПЛК-70.А. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием контроллера (светодиоды индикации и др.), использования корзины субмодулей.

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

Станции подчиняются узлы типа "Система" - Транспортная система, Система архивирования, Система визуализации и т. д.

== Транспортная система ==
Транспортная система управляет передачей данных по различным каналам связи. Система управляет работой "Транспортов" - узлов, выполняющих обмен данными с устройствами по определенному протоколу.

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

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

=== Транспорт ===
Транспорт предназначен для обмена данными с устройствами по определенному протоколу. Один транспорт, в зависимости от типа, позволяет обмениваться данными с одним или несколькими устройствами.

Доступны для использования следующие виды транспортов:

* Транспорт Modbus-TCP;
* Транспорт Modbus-RTU;
* Транспорт SNMP;
* Транспорт OPC UA;
* Транспорт OPC DA (только для Windows);
* Транспорт MQTT;
* Последовательный транспорт (устаревший);
* TCP/IP транспорт (устаревший).
Подробное описание транспортов приведено в отдельном документе "[[Транспорты AgavaSCADA/AgavaPLC]]".

==Система визуализации==
{{Внимание|Тип=Восклицание желтый.png|Текст=Система визуализации недоступна в проектах для контроллеров МПР}}

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

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

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

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

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

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

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

Подчиненные типы узлов:

*фрейм;
*окно;
*композиция.

===Фрейм===
[[Файл:AgavaPLC–Пример структуры сложного фрейма, состоящего из двух форм и одного окна с многослойной композицией.png|мини|Рисунок 23 – Пример структуры сложного фрейма, состоящего из двух форм и одного окна с многослойной композицией]]
Фрейм – узел, предназначенный для группировки окон, отображаемых на определенном дисплее. Обеспечивает организацию окон в пространстве экрана, управление мониторами и границами отображения.

Если необходимо отобразить информацию на нескольких дисплеях одновременно, то для каждого из них нужно использовать отдельный фрейм. Окон во фрейме может быть несколько, однако они не могут накладываться друг на друга.
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
|-
|Позиция X
|XCoord
|int
|Координата X левого верхнего угла фрейма
|Целое число
|-
|Позиция Y
|YCoord
|int
|Координата Y левого верхнего угла фрейма
|Целое число
|-
|Ширина
|XSize
|int
|Ширина фрейма в пикселях
|Целое число > 0
|-
|Высота
|YSize
|int
|Высота фрейма в пикселях
|Целое число > 0
|-
|Окна
|Windows
|NodesArray
|Список окон, принадлежащих фрейму
|Узлы типа: Window
|-
|Номер монитора
|DisplayNo
|int
|Номер монитора для отображения фрейма
|0 - по умолчанию
≥1 - конкретные мониторы
|-
|Тип границы
|BorderType
|enum
|Тип границы фрейма
|0: Не определен (ошибка)
1: Отсутствует

2: Фиксированная
|}

==== Позиция и размеры (XCoord, YCoord, XSize, YSize) ====

* '''Тип:''' int.
* '''Описание:''' Определяют положение и размеры фрейма на экране.
* '''Значения по умолчанию:''' (0, 0, 640, 480).
* '''Применение:''' Задание области экрана, которую занимает фрейм.

==== Окна (Windows) ====
'''Тип:''' NodesArray.

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

'''Особенности:'''

* Поддерживаются только узлы типа Window.

==== Номер монитора (DisplayNo) ====
'''Тип:''' int.

'''Описание:''' Определяет, на каком мониторе системы отображается фрейм. Значение 0 соответствует монитору по умолчанию.

'''Использование:'''

* 0 - основной монитор.
* 1, 2, ... - дополнительные мониторы.
* Свойство важно для многомониторных конфигураций.

==== Тип границы (BorderType) ====
'''Тип:''' enum.

'''Описание:''' Определяет тип обрамления фрейма. Влияет на внешний вид и поведение границ.

'''Значения:'''

* '''Отсутствует''' - фрейм без видимых границ.
* '''Фиксированная''' - стандартная граница окна.
* '''Не определен''' - используется только для обработки ошибок.

==== Наследование привилегий ====
Фрейм автоматически добавляет доступные привилегии для работы с окнами:

* <code>OpenWindow</code> - привилегия на открытие окон.
* <code>CloseWindow</code> - привилегия на закрытие окон.

===Окна===
Окно – узел, осуществляющий отображение видеокадра (мнемонической схемы).

Существуют несколько видов окон:

1. «Форма», предназначенная для вывода простого набора данных без необходимости управления видимостью или внешним видом его элементов. Для вывода информации в такое окно кроме создания окна и добавления к нему виджетов ничего более не требуется.
[[Файл:AgavaPLC-Меню.png|мини|164x164пкс|Рисунок 24 — Внешний вид меню в среде исполнения]]
2. «Окно с композицией», предназначенное для вывода большого количества информации и позволяющее организовать группировку элементов по слоям, управлять внешним видом элементов, видимостью слоев и отдельных элементов, а также дающее возможность регулирования работы пользователя с элементами. Для вывода информации в такое окно нужно к окну привязать композицию, содержащую минимум один слой, в который уже добавляются виджеты.

=== Форма ===
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Модальность
|Modality
|enum
|Режим модальности окна
|0: Не определен (ошибка)
1: Немодальное

2: Модальное (Фрейм)

3: Модальное (Система)
|Чтение/Запись
|-
|Тип границы
|BorderType
|enum
|Тип границы окна
|0: Не определен (ошибка)
1: Фиксированная

2: Изменяемая

3: Отсутствует
|Чтение/Запись
|-
|Отображать строку заголовка
|TitleEnabled
|bool
|Отображать строку заголовка
|true/false
|Чтение/Запись
|-
|Отображать кнопку "Закрыть"
|CloseEnabled
|bool
|Отображать кнопку "Закрыть"
|true/false
|Чтение/Запись
|-
|Цвет фона
|BackgroundColor
|NColor
|Цвет фона окна
|Цвет в формате RGBA
|Чтение/Запись
|-
|Затемнение
|NeedDarkenApplication
|bool
|Затемнение других окон приложения при открытии этого окна
|true/false
|Чтение/Запись
|-
|Цвет затемнения
|ColorDarkenApplication
|NColor
|Цвет затемнения
|Цвет в формате RGBA
|Чтение/Запись
|-
|Интервал обновления
|UpdateInterval
|int
|Интервал обновления виджетов, мс
|0 - без задержки
>0 - интервал в мс
|Чтение/Запись
|-
|Действия OnShow
|ActionsOnShow
|NodesContainer
|Действия при показе окна
|Узлы типа: Action
|Чтение/Запись
|-
|Действия OnClose
|ActionsOnClose
|NodesContainer
|Действия при закрытии окна
|Узлы типа: Action
|Чтение/Запись
|}

==== Модальность (Modality) ====
'''Тип:''' enum.

'''Описание:''' Определяет поведение окна относительно других окон приложения.

'''Значения:'''

* '''Немодальное''' - позволяет взаимодействовать с другими окнами.
* '''Модальное (Фрейм)''' - блокирует взаимодействие с окнами в том же фрейме.
* '''Модальное (Система)''' - блокирует все окна приложения.

==== Тип границы (BorderType) ====
'''Тип:''' enum.

'''Описание:''' Определяет тип и поведение границ окна.

'''Значения:'''

* '''Фиксированная''' - окно нельзя изменять размер.
* '''Изменяемая''' - пользователь может изменять размер окна.
* '''Отсутствует''' - окно без видимых границ.

==== Управление заголовком (TitleEnabled, CloseEnabled) ====
'''Тип:''' bool.

'''Описание:''' Контролируют отображение элементов заголовка окна.

==== Фон и затемнение (BackgroundColor, NeedDarkenApplication, ColorDarkenApplication) ====
'''Тип:''' NColor, bool, NColor.

'''Описание:''' Управляют визуальным оформлением окна и его влиянием на другие окна.

'''Особенности:'''

* Затемнение применяется только при NeedDarkenApplication = true.
* Цвет затемнения по умолчанию: черный с прозрачностью 50%.

==== Интервал обновления (UpdateInterval) ====
'''Тип:''' int.

'''Описание:''' Определяет частоту обновления виджетов в окне.

'''Рекомендации:'''

* 0 - 100 мс для композиций с критичным временем отклика.
* 100 - 500 мс хорошо подходит для большинства случаев.
* более 1000 мс - для статических или редко меняющихся данных.

==== Обработчики событий (ActionsOnShow, ActionsOnClose) ====
'''Тип:''' NodesContainer.

'''Описание:''' Коллекции действий, выполняемых при показе и закрытии окна.

=== Окно с композицией ===
Данный узел имеет те же свойства, что и форма, а также собственные:
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Композиция
|CompositionId
|NodeLink
|Основная композиция окна
|Узлы типа: CompositionLayered, CompositionTemplated
|Чтение/Запись
|-
|Описание текущей композиции
|CurrentCompositionDesc
|string
|Описание текущей загруженной композиции
|Автоматически формируется
|Только чтение
|}

==== Композиция (CompositionId) ====
'''Тип:''' NodeLink.

'''Описание:''' Ссылка на композицию, отображаемую в окне.

'''Поддерживаемые типы:''' CompositionLayered, CompositionTemplated.

==== Описание текущей композиции (CurrentCompositionDesc) ====
'''Тип:''' string.

'''Описание:''' Автоматически обновляемое описание загруженной композиции.

'''Особенности:''' Свойство только для чтения, обновляется системой автоматически.[[Файл:AgavaPLC-Настройка меню в среде разработки.png|мини|226x226пкс|Рисунок 25 — Настройка меню в среде разработки]]

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

Композиция дает возможность организовать виджеты в слои, видимостью которых можно управлять во время работы проекта.
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Размеры
|Size
|NSize
|Размеры композиции
|Структура {ширина, высота}
|Чтение/Запись
|-
|Кэширование
|Cacheable
|bool
|Кэширование данных композиции для быстрого повторного открытия
|true/false
|Чтение/Запись
|-
|Источник интервала обновления
|UpdateIntervalSource
|enum
|Определяет источник интервала обновления виджетов
|0: Окно
1: Композиция
|Чтение/Запись
|-
|Интервал обновления
|UpdateInterval
|int
|Интервал обновления виджетов в миллисекундах
|Целое число ≥ 0
|Чтение/Запись
|-
|Действия OnLoad
|ActionsOnLoad
|NodesContainer
|Действия при загрузке композиции
|Узлы типа: Action
|Чтение/Запись
|}

==== Размеры (Size) ====
'''Тип:''' NSize (ширина, высота).

'''Описание:''' Определяет размеры композиции в пикселях. По умолчанию установлены значения 800x600.

==== Кэширование (Cacheable) ====
'''Тип:''' bool.

'''Описание:''' Включает или отключает кэширование данных композиции. При включенном кэшировании композиция сохраняется в памяти для быстрого повторного открытия.

'''Преимущества кэширования:'''

* Быстрое переключение между композициями.
* Снижение нагрузки на систему при частом использовании.
* Сохранение состояния элементов.

'''Рекомендации:''' Включать для часто используемых композиций, отключать для редко используемых или ресурсоемких.

==== Источник интервала обновления (UpdateIntervalSource) ====
'''Тип:''' enum.

'''Описание:''' Определяет, откуда виджеты композиции получают интервал обновления.

'''Значения:'''

* '''Окно''' - интервал обновления наследуется от родительского окна.
* '''Композиция''' - используется собственный интервал обновления композиции.

'''Применение:''' Централизованное управление производительностью через окно или индивидуальная настройка для каждой композиции.

==== Интервал обновления (UpdateInterval) ====
'''Тип:''' int.

'''Описание:''' Задает интервал обновления виджетов в миллисекундах. При значении 0 отрисовка виджетов выполняется без задержки (максимальная частота).

'''Особенности:'''

* 0 - обновление без задержек (может создать высокую нагрузку).
* > 0 - обновление с заданным интервалом. Учитывается только при UpdateIntervalSource = "Композиция"

'''Рекомендации:'''

* 0 - 100 мс для композиций с критичным временем отклика.
* 100 - 500 мс хорошо подходит для большинства случаев.
* более 1000 мс - для статических или редко меняющихся данных.

==== Обработчик событий ActionsOnLoad ====
'''Тип:''' NodesContainer.

'''Описание:''' Коллекции действий, выполняемых после загрузки композиции <code>AS 1.6.27+</code>.

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

Свойства
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Z-Порядок
|ZOrder
|int
|Порядок слоя в композиции
|Целое число (чем выше значение, тем выше слой)
|Чтение/Запись
|-
|Прозрачность для действий
|ActionTransparency
|enum
|Определяет поведение слоя при взаимодействии с пользователем
|0: Не определен (ошибка)
1: Непрозрачный

2: Прозрачный
|Чтение/Запись
|-
|Видимость
|Visible
|bool
|Видимость слоя и всех его виджетов
|true/false
|Чтение/Запись
|}

==== Z-Порядок (ZOrder) ====
'''Тип:''' int

'''Описание:''' Определяет порядок отображения слоя относительно других слоев в композиции. Слои с большим значением ZOrder отображаются поверх слоев с меньшим значением.

'''Пример использования:'''

* Фоновый слой: ZOrder = 1.
* Основной контент: ZOrder = 2.
* Контекстные виджеты: ZOrder = 3.

==== Прозрачность для действий (ActionTransparency) ====
'''Тип:''' enum

'''Описание:''' Управляет взаимодействием слоя с пользовательскими действиями (клики, наведения и т.д.)

'''Значения:'''

* '''Непрозрачный''' - слой полностью перехватывает пользовательские действия, элементы под ним недоступны, даже если они видимы.
* '''Прозрачный''' - пользовательские действия проходят сквозь слой к элементам ниже.

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

==== Видимость (Visible) ====
'''Тип:''' bool

'''Описание:''' Определяет видимость всего слоя и всех его дочерних виджетов. При значении false слой и все его содержимое становится невидимым.

'''Применение:''' Временное скрытие виджетов или переключение их видимости.

===Виджет===
Виджет – элемент визуализации, предназначенный для отображения информации в заданном виде.

===Меню===
Меню – элемент визуализации, сочетающий в себе несколько виджетов «Кнопка». Используется для более удобного управления проектом (см. Рисунок 24).

Для добавления меню, необходимо в среде разработки назначить [[Универсальная среда разработки#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D0.B5 .C2.AB.D0.9E.D1.82.D0.BE.D0.B1.D1.80.D0.B0.D0.B6.D0.B5.D0.BD.D0.B8.D0.B5 .D0.BC.D0.B5.D0.BD.D1.8E.C2.BB|действие «Отображение меню»]] для кнопки (или любого другого виджета). После добавления действия необходимо выделить его и нажать на кнопку настроек на панели вверху окна действий. Открывшееся окно (см. Рисунок 25) содержит дерево со структурой меню, в который можно добавлять элементы двух типов:

*меню – элемент, который позволяет группировать элементы меню, выводя их в виде раскрывающегося списка. На рисунках 24 и 25 этим элементом являются кнопки «Арочник» и «БПО».
*элемент меню – элемент, который предоставляет функционал, аналогичный [[Универсальная среда разработки#.D0.92.D0.B8.D0.B4.D0.B6.D0.B5.D1.82 .C2.AB.D0.9A.D0.BD.D0.BE.D0.BF.D0.BA.D0.B0.C2.BB|виджету «Кнопка»]]. Для добавления действия, выполняющегося при нажатии на элемент меню в среде исполнения, необходимо нажать на него ПКМ в дереве структуры меню и выбрать "Создать действие". На рисунках 24 и 25 этим элементом являются кнопки «Котельная», «Котёл №1», «Котёл №2» и «Котёл №3».

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

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

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

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

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

===Виджеты===
====Виджет «Текстовая метка»====
[[Файл:AgavaPLC–Примеры оформления виджетов типа "Текстовая метка".png|мини|Рисунок 26 – Примеры оформления виджетов типа "Текстовая метка"]]
Виджет «Текстовая метка» – наиболее часто применяемый виджет, с помощью которого можно реализовать разные способы отображения текстовой информации.

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

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

*%f – значение в виде числа с плавающей точкой;
* %s – строка;
*%i – целое число со знаком;
*%u – целое число без знака;
* %d – целое число со знаком в десятичной системе исчисления.

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

Для отображения знака «%» необходимо указать его дважды: «%%».

===== Отображение нескольких значений =====
Одна текстовая метка может использоваться для отображения нескольких значений. Для этого все значения, которые нужно отобразить, указываются в свойстве «Источник», а в свойстве «Текст» указываются последовательно несколько спецификаторов формата соответственно порядку перечисления значений в свойстве «Источник».

Пример: текстовая метка, отображающая текущую позицию в очереди:

* Текст: <code>Позиция %i из %i</code>
* Источник: два узла из проекта.

=====Модификаторы спецификаторов формата=====

======Модификатор минимальной ширины поля======
Целое число, расположенное между знаком % и кодом формата, играет роль модификатора минимальной ширины поля. Если указан модификатор минимальной ширины поля, то, чтобы ширина поля вывода была не меньше указанной минимальной величины, вывод при необходимости будет дополнен пробелами. Если же выводятся строки или числа, которые длиннее указанного минимума, то они все равно будут отображаться полностью. По умолчанию для дополнения используются пробелы. А если для этого надо использовать нули, то перед модификатором ширины поля следует поместить 0. Например, %05i означает, что любое число, количество цифр которого меньше пяти, будет дополнено таким количеством нулей, чтобы состоять из пяти цифр.

Примеры
{| class="wikitable"
!Значение
!Спецификатор формата
!Выводимое значение
|-
|10.123
|%i
|10
|-
|10.123
|%d
|10
|-
|10.123
|%05i
|00010
|-
|10.123
|%f
|10.123000
|-
|10.123
|%.1f
| 10.1
|-
|10.123
|%10f
|<пробел>10.123000
|-
|10.123
|%012f
|00010.123000
|}

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

Когда модификатор точности применяется к данным с плавающей точкой, для преобразования которых используются спецификаторы преобразования %f, %e или %E, то он определяет количество выводимых десятичных разрядов. Например, %10.4f означает, что ширина поля вывода будет не менее 10 символов, причем для десятичных разрядов будет отведено четыре позиции.

Если модификатор точности применяется к %g или %G, то он определяет количество значащих цифр.

Примененный к строкам, модификатор точности определяет максимальную длину поля. Например, %5.7s означает, что длина выводимой строки будет составлять минимум пять и максимум семь символов. Если строка окажется длиннее, чем максимальная длина поля, то конечные символы выводиться не будут.

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

Примеры:
{| class="wikitable"
!Значение
!Спецификатор формата
!Выводимое значение
|-
|10.123
|%f
|10.123000
|-
|10.123
|%.1f
|10.1
|-
|10.123
|%10.4f
|<пробел><пробел><пробел>10.1230
|-
|10.123
|%010.3f
|000010.123
|-
| Это простая проверка
|%10.15s
|Это простая про
|}

====Виджет «Условная метка» ====
[[Файл:AgavaPLC–Список сопоставлений виджета "Условная метка".png|мини|Рисунок 27 – Список сопоставлений виджета "Условная метка"|ссылка=Файл:AgavaPLC–Список_сопоставлений_виджета_%22Условная_метка%22.png]]
Виджет «Условная метка» позволяет изменять выводимую строку в соответствии с изменениями привязанной к ней переменной.

Задать соответствие текста необходимому условию можно в свойстве «Список сопоставлений».

==== Виджет «Изображение»====
Виджет «Изображение» предназначен для отображения на окнах статичных изображений форматов png, gif, jpg, bmp или анимированных изображений в формате gif. Отображаемая картинка выбирается в разделе «Оформление» - «Изображение». Она должна находиться в папке проекта.

====Виджет «Условное изображение»====
[[Файл:AgavaPLC–Список сопоставлений виджета "Условное изображение".png|мини|Рисунок 28 – Список сопоставлений виджета "Условное изображение"|ссылка=Файл:AgavaPLC–Список_сопоставлений_виджета_%22Условное_изображение%22.png]]
Виджет «Условное изображение» позволяет изменять отображаемое изображение в соответствии с изменениями привязанной к нему переменной.

Задать соответствие изображения необходимому условию можно в свойстве «Список сопоставлений».

====Виджет «Движущееся изображение»====
Виджет предназначен для отображения на окнах изображений, перемещающихся в пределах области виджета. В основном используются на экране спящего режима.

Отображаемая картинка выбирается в разделе «Оформление» - «Изображение». Она должна находиться в папке проекта.

====Виджет «Кнопка»====
Виджет «Кнопка» предназначен для реализации функций управления:

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

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

====Виджет «Гистограмма»====
[[Файл:AgavaPLC–Виджет "Гистограмма".png|мини|Рисунок 29 – Виджет "Гистограмма"|ссылка=Файл:AgavaPLC–Виджет_%22Гистограмма%22.png]]
Виджет предназначен для отображения значений сигналов в виде столбчатой диаграммы.

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

====Виджет «Исторический график»====
Виджет «Исторический график» предназначен для отображения графиков параметров на двухкоординатной области изображения с привязкой к осям времени и значений.

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

При работе с архивируемыми данными интервал обновления графика зависит от режима выдачи значения у базы данных: при выборе сохраняемых в БД он будет соответствовать интервалу архивирования, а при сохраненных в БД - интервалу сохранения БД на диск. Независимо от режима выдачи, график не может обновляться меньше чем за 300 мс.

При работе напрямую с сигналами график обновляется при изменении значения сигнала, но также не чаще чем раз в 300 мс.
[[Файл:AgavaPLC–Экран «Архив» с виджетом «Исторический график».png|мини|Рисунок 30 – Виджет «Исторический график». Области кнопок-пиктограмм. В нижней части отображена легенда]]
Виджет «Исторический график» состоит из нескольких областей:

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

На виджете имеются несколько областей, содержащих кнопки-пиктограммы управления внешним видом графика (см. Рисунок 28):

#область пиктограмм графика;
#область пиктограмм оси времени (X);
#область пиктограмм оси значений (Y);
#область легенды.

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

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

В области пиктограмм оси времени (X) слева направо расположены следующие кнопки-пиктограммы:

*кнопка открытия окна выбора интервала времени для оси Х, текст кнопки отображает текущий выбранный интервал, например: 5М – 5 минут, 6Ч – 6 часов, 30М – 30 минут;
*кнопка-индикатор включения следящего режима.

В области пиктограмм оси значений (Y) расположена кнопка-пиктограмма «A» – кнопка переключения режима автоматического масштабирования значений.

=====Легенда=====
[[Файл:AgavaPLC–Легенда с четырьмя выключенными параметрами.png|мини|Рисунок 31 – Легенда с четырьмя выключенными параметрами]]
Легенда – специальная область в нижней части экрана архива, предназначенная для отображения параметров (наименование, текущее значение и т. д.) выводимых графиков в виде таблицы. Для ознакомления с примерным видом легенды см. Рисунок 31. Информация о каждом сигнале в легенде выводится в несколько колонок:

*«Цвет» – индицирует цвет, которым выводится соответствующая кривая на графике, колонка «Цвет» позволяет нажатием переключать видимость соответствующей кривой на графике (см. Рисунок 29). Также в колонке "Цвет" отображается номер пера, которым выводится кривая параметра на графике;
* «Имя» («Наименование») – содержит наименование параметра;
*«Время» – содержит время последнего зарегистрированного значения параметра;
*«Значение» – содержит последнее зарегистрированное значение параметра.

=====Режимы просмотра графиков=====
Пользователю доступно два режима просмотра графиков:

*следящий режим;
*режим просмотра истории.

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

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

Режим просмотра истории включается автоматически при прокрутке графика назад по времени.

=====Визирная линия=====
[[Файл:AgavaPLC–График в режиме просмотра истории с установленной визирной линией.png|мини|Рисунок 32 – График в режиме просмотра истории с установленной визирной линией]]
Для просмотра значений параметров в нужный момент времени служит визирная линия, отображаемая на графике как вертикальная линия.

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

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

====Виджет «График кусочно-линейной функции»====
Виджет предназначен для отображения графика зависимости двух параметров, расположенном на осях X и Y.
[[Файл:AgavaPLC–Виджет «График кусочно-линейной функции». Области кнопок-пиктограмм..png|мини|Рисунок 33 – Виджет «График кусочно-линейной функции». Области кнопок-пиктограмм.]]
Виджет состоит из нескольких областей:

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

На области вывода графика виджета имеются несколько областей, содержащих кнопки-пиктограммы управления внешним видом графика (см. Рисунок 33):

#Область пиктограмм графика.
#Область пиктограмм оси первого параметра (X).
#Область пиктограмм оси второго параметра (Y).

В области пиктограмм графика расположены следующие кнопки-пиктограммы:

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

В области пиктограмм оси первого (X) и второго (Y) параметров расположены кнопки-пиктограммы «А» – кнопка переключения режима автоматического масштабирования значений.[[Файл:AgavaPLC–Виджет "Список событий".png|мини|Рисунок 34 – Виджет "Список событий"|ссылка=Файл:AgavaPLC–Виджет_%22Список_событий%22.png]]
====Виджет «Список событий»====
[[Файл:AgavaPLC–Окно выбора интервала.png|мини|Рисунок 35 – Окно выбора интервала]]Виджет предназначен для отображения регистрируемых событий в работе.

В верхней части виджета расположена панель управления (1).

Панель управления содержит органы управления журналом:

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

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

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

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

Нажатие на кнопку-индикатор выбора интервала вызывает окно выбора интервала (см. Рисунок 35):[[Файл:AgavaPLC–Окно "Фильтр".png|мини|Рисунок 36 – Окно "Фильтр"|ссылка=Файл:AgavaPLC–Окно_%22Фильтр%22.png]]После выбора нужного интервала для сохранения выбора необходимо нажать кнопку «ОК». После сохранения будут отображены зарегистрированные события за выбранный интервал.
Нажатие на кнопку отображения окна фильтра вызывает соответствующее окно. Окно фильтра позволяет изменить содержимое основного окна журнала событий путем выбора групп и подгрупп событий, перечисленных в окне фильтра (см. Рисунок 36).

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

====Виджет «Ввод значения»====
Виджет «Ввод значения» предназначен для отображения значения привязанного сигнала и его редактирования.
[[Файл:AgavaPLC–Виджет «Ввод значения» с отображением экранной цифровой клавиатуры.png|мини|Рисунок 37 – Виджет «Ввод значения» с отображением экранной цифровой клавиатуры|212x212пкс]]
После выбора узла для чтения/записи и соответствующего типа значения необходимо выбрать нужный тип ввода в разделе «Оформление».

Доступны следующие типы ввода:

*кнопки изменения – при нажатии на виджет появляются кнопки увеличения и уменьшения на заданный шаг изменения;
*кнопка редактирования – при нажатии на виджет появляется кнопка, при клике на которую открывается экранная цифровая клавиатура;

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

====Виджет «Выбор значения из списка»====
[[Файл:AgavaPLC–Виджет «Выбор значения из списка».png|мини|Рисунок 38 – Виджет «Выбор значения из списка»]]
Виджет «Выбор значения из списка» предназначен для отображения значения привязанного сигнала и его изменения в удобном для пользователя текстовом виде (см. Рисунок 37).

С помощью свойства «Список сопоставлений» задается соответствие между значением сигнала и выводимой в виджете строкой.

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

====Виджет «Флаг»====
[[Файл:AgavaPLC–Варианты внешнего вида виджета «Флаг».png|мини|Рисунок 39 – Варианты внешнего вида виджета «Флаг»]]
Виджет «Флаг» предназначен для отображения значения и изменения булевой переменной (true/false). Состояние true отображается в виде галочки (см. Рисунок 38).

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

В случае, если флаг необходимо использовать только для отображения информации, поставьте галочку в свойстве «Отключен»

====Виджет «Отчет»====
[[Файл:AgavaPLC–Виджет «Отчет» в режиме отображения сформированного отчета.png|мини|Рисунок 40 – Виджет «Отчет» в режиме отображения сформированного отчета]]
Виджет «Отчет» предназначен для формирования отчетов по заранее спроектированному макету.

Подробный порядок создания и редактирования отчетов приведен в разделе [[#Отчеты]].
[[Файл:AgavaPLC–Окно выбора интервала отчета.png|мини|Рисунок 41 – Окно выбора интервала отчета]]
В верхней части виджета размещена панель управления, содержащая кнопки вызова команд:

* печать сформированного отчета на установленном в системе принтере;
*сохранение сформированного отчета в файле формата PDF;
*переход к предыдущей странице отчета;
*переход к следующей странице отчета;
*масштабирование экрана по ширине листа отчета;
*масштабирование экрана по высоте листа отчета.

При формировании отчета для изменения интервала времени, за который будет формироваться отчет, необходимо на панели управления щелкнуть кнопку выбора интервала (на ней отображается текущий выбранный интервал, например, «Начало суток без смещения – Конец суток без смещения»). Далее появится окно «Интервал», в котором можно выбрать начало и конец интервала (см. Рисунок 41).

В качестве начала и конца интервала можно выбрать как конкретную дату по календарю, так относительную, например, «Начало дня», "Конец недели". После выбора желаемого интервала необходимо нажать кнопку «ОК».

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

{{Шаблон:Действия AgavaSCADA/AgavaPLC}}

==Система тревог==
Система тревог предназначена для оповещения пользователя об обнаруженных нарушениях.

Система содержит два типа узлов:

*Группа событий.
*Контроллер событий.

===Группа событий===
Группа событий – узел, предназначенный для взаимодействия с виджетом «Список событий». Группы событий позволяют группировать события по какому-то признаку, например по уровню тревоги (авария, предупреждение, квитирование и т.д.), технологическому участку и т.д.

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

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

===Монитор событий===
Монитор событий (ранее - Контроллер событий) – узел, реализующий логику проверки соответствия выбранных сигналов контролируемым условиям. Контроллеры событий выполняют всю работу по проверке значений контролируемых параметров и выполнению соответствующих действий.

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

В качестве действий можно указать не только действие "Создание события", но и другие (см. раздел [[#Действия]]).
[[Файл:AgavaPLC-Cистема тревог.png|мини|Cистема тревог]]

===Порядок настройки системы===
Порядок настройки системы тревог следующий:
#Добавить в проект систему тревог. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система тревог».
#Добавить узел «События» в систему тревог. Для этого нажать ПКМ по системе тревог в дереве проекта, затем выбрать «Добавить узел» - «Группа» - «События». При необходимости настроить цвет шрифта и фона, которые будут отображаться у события в окне тревог или журнале.
#Добавить нужные [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.93.D1.80.D1.83.D0.BF.D0.BF.D0.B0 .D1.81.D0.BE.D0.B1.D1.8B.D1.82.D0.B8.D0.B9|группы событий]] в узел «События». Для этого нажать ПКМ по узлу «События» в дереве проекта, затем выбрать «Добавить узел» - «Группа событий».
#Добавить [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.9A.D0.BE.D0.BD.D1.82.D1.80.D0.BE.D0.BB.D0.BB.D0.B5.D1.80 .D1.81.D0.BE.D0.B1.D1.8B.D1.82.D0.B8.D0.B9|контроллеры событий]] в систему тревог. Для этого нажать ПКМ по системе тревог в дереве проекта, затем выбрать «Добавить узел» - «Контроллер событий».
#Добавить в свойство «Сигналы» контроллеров событий узлы, состояние которых необходимо контролировать.
#Задать для этих узлов контролируемые условия в соответствующем свойстве контроллера событий.
#Настроить [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D1.8F|действия]], которые будут выполняться при выполнении контролируемого условия. Для вывода аварий, предупреждений или информационных сообщений необходимо добавить действие «Создание события».
# Настроить действие «Создание события». В его свойстве «Группа событий» указать группу из созданных в пункте 2. Ввести тексты сообщения активации и деактивации (при необходимости), указать уровень события. Теперь, при срабатывании контролируемого условия, будет появляться окно тревог с сообщением активации.

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

Данное окно отображается при любом изменении состояния обрабатываемых тревог:

* появилось событие - отобразилось окно;
* квитировали событие - изменилось отображение события в окне;
* устранили первопричину - события пропали из окна.

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

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

Архивация параметров производится с помощью архиваторов. Архиваторы SQLite и PostgreSQL могут выполнять [[Узлы проекта AgavaSCADA/AgavaPLC#Прореживание данных|прореживание данных]].
[[Файл:AgavaPLC-Настройка архиватора.png|мини|505x505пкс|Настройка архиватора]]

===Порядок настройки системы===
Для сохранения истории изменения значений параметров в БД необходимо выполнить следующие действия:

#Добавить в проект систему архивации. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система архивации».
#Добавить в систему архивации архиватор. Для этого нажать ПКМ по узлу «Система архивации» в дереве проекта, затем выбрать «Добавить узел» - «Архиватор в БД SQLite».
#Настроить параметры архиватора, такие как: путь до файла БД, интервал архивирования (как часто система архивации будет опрашивать значение параметра), интервал сохранения БД на диск (как часто эти значения будут записываться в постоянную память), разбиение БД (будет ли система архивации создавать новый файл БД каждые сутки), период хранения и режим выдачи значений для построения графика (сохраняемые значения будут обновляться с частотой интервала архивирования, а сохраненные - с частотой интервала сохранения).
#Добавить параметры в коннекторы база данных. Для этого необходимо открыть свойство архиватора «Коннекторы БД», выбрать «Создать новый» - «Коннектор БД». После этого нужно нажать по добавленному коннектору, открыть его свойство «Сигналы» и добавить параметр, значение которого необходимо сохранять в БД.

=== Архиватор SQLite===
Архиватор SQLite предназначен для сохранения значений параметров в БД формата SQLite.

Для извлечения и просмотра баз данных формата SQLite с устройств может использоваться программа «[[Архиватор]]».

====Свойства узла "Архиватор SQLite"====
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Доступ
!Описание
|-
|Путь до файла БД
|FilePath
|STRING
|Чтение / запись
|Путь до файла БД. Абсолютный или относительный.
|-
|Интервал архивирования
|Interval
|INT
|Чтение / запись
|Интервал архивирования, мс.
|-
|Период хранения
|Retention
|INT
|Чтение / запись
|Период хранения, дней.
|-
|Разбиение БД
|DBSplitting
|BOOL
|Чтение / запись
|Разбиение БД на файлы. При включении база данных будет разделяться на отдельные файлы, содержащие данные за одни сутки.
|-
|Интервал сохранения БД на диск
|StoringInterval
|INT
|Чтение / запись
|Интервал сохранения БД на диск, мс.
|-
|Режим выдачи значений
|ValueReturnMode
|ENUM
|Чтение / запись
|Режим выдачи значений. Режим "Сохраняемые в БД" — данные выдаются сразу после получения архиватором, возможно до фактического сохранения в БД. Режим "Сохраненные в БД" — данные выдаются только после фактической записи в БД на диск.
|-
|Коннекторы БД
|Signals
|NODESARRAY
|Чтение / запись
|Список коннекторов, содержащих сигналы для архивирования.
|-
|Текущий размер БД
|DBCurrentSize
|INT
|Только чтение
|Текущий размер БД, Мб.
|-
|Максимальный размер БД
|DBMaxSize
|INT
|Только чтение
|Максимальный размер БД, Мб.
|-
|Состояние БД
|DBStatus
|INT
|Только чтение
|Текущий статус операций SQLite (числовой код). Для расшифровки см. раздел [[Узлы проекта AgavaSCADA/AgavaPLC#Статусы операций SQLite|Статусы операций SQLite]].
|-
|Включить прореживание
|ThinningEnabled
|BOOL
|Чтение / запись
|Включение режима прореживания архива. При включении применяется фильтрация по изменению значения.
|-
|Тип допуска
|ToleranceType
|ENUM
|Чтение / запись
|Тип допуска для прореживания. Возможные значения: "[[Узлы проекта AgavaSCADA/AgavaPLC#Абсолютный допуск|Абсолютные единицы]]", "[[Узлы проекта AgavaSCADA/AgavaPLC#Процент от последнего значения|Процент от последнего значения]]", "[[Узлы проекта AgavaSCADA/AgavaPLC#Процент от среднего N последних|Процент от среднего значения]]" и "[[Узлы проекта AgavaSCADA/AgavaPLC#Процент от среднего по временному окну|Процент от среднего значения (окно по времени)]]"
|-
|Допуск
|ThinningTolerance
|FLOAT
|Чтение / запись
|Величина допуска: в абсолютных единицах для режима «Абсолютные единицы», в процентах для режимов «Процент от…».
|-
|Период обязательной записи (мс)
|MandatoryPeriod
|UINT
|Чтение / запись
|Максимальный интервал между записями данных в архив, даже если значение не изменилось.
|-
|Размер окна среднего (N)
|AverageWindowN
|UINT
|Чтение / запись
|Количество последних значений для расчёта среднего. Используется только в режиме «Процент от среднего значения». В остальных режимах игнорируется.
|}

==== Статусы операций SQLite ====
В ходе работы SQLite возвращает статус выполнения операций в виде целочисленных значений. Далее приведена расшифровка этих кодов и возможные пути разрешения ошибок.
{| class="wikitable"
!Код
!Расшифровка
!Что предпринять чтобы починить?
|-
|'''0'''
|Операция выполнена успешно.
|Не ошибка. Действий не требуется.
|-
|'''1'''
|Общая ошибка выполнения операции.
|Повторите операцию. Проверьте доступность пути к базе и прав доступа, наличие свободного места на диске, отсутствие блокировки антивирусом/резервным копированием. Перезапустите приложение.
|-
|'''2'''
|Внутренняя ошибка SQLite (ошибка логики).
|Перезапустите приложение (при необходимости — ПК). Убедитесь, что не запущено несколько копий программы.
|-
|'''3'''
|Недостаточно прав для доступа к файлу или базе данных.
|Проверьте, что у пользователя или службы, от имени которой работает программа, есть разрешение на чтение и запись в каталог базы данных. Если база на сетевом диске — убедитесь, что доступ не заблокирован.
|-
|'''4'''
|Операция прервана внутренним процессом.
|Обычно это означает, что выполнение запроса было остановлено из-за внутреннего условия или сигнала прерывания. Повторите операцию. Если ошибка повторяется — перезапустите программу.
|-
|'''5'''
|Файл базы данных удерживается другой программой/процессом.
|Подождите 5–30 секунд и повторите операцию. Закройте другие копии программы/станции, отчёты, резервное копирование, антивирусное сканирование. Если база на сетевом диске — убедитесь, что её не открывают с других машин.
|-
|'''6'''
|Заблокирована таблица внутри базы.
|Дождитесь завершения текущей операции в программе. Закройте окна/отчёты, которые используют ту же таблицу. Если запущено несколько экземпляров на одной станции — оставьте один. Перезапустите программу.
|-
|'''7'''
|Недостаточно оперативной памяти.
|Закройте лишние приложения/тяжёлые отчёты и повторите. Перезапустите программу или ПК. Убедитесь, что хватает ОЗУ и места под файл подкачки. При систематическом повторении — используйте машину с большим объёмом памяти.
|-
|'''8'''
|Попытка записи в базу «только для чтения».
|Снимите атрибут «Только чтение» с файла .db и каталога. Проверьте права на запись (локально/на сетевой шаре). Убедитесь, что диск/том не смонтирован как «только чтение» и в настройках программы не выбран режим «только чтение».
|-
|'''9'''
|Операция была прервана системой/другим процессом.
|Повторите операцию и дождитесь завершения. Не закрывайте окно и не переключайте станцию во время выполнения. Убедитесь, что на станции не идут параллельно резервное копирование/антивирусное сканирование. Перезапустите приложение (при необходимости — ПК). Если повторяется — сохраните лог и время сбоя и обратитесь в поддержку.
|-
|'''10'''
|Ошибка чтения/записи на диск.
|Проверьте свободное место и доступ к диску; исключите блокировку антивирусом; проверьте доступность сетевого пути.
|-
|'''11'''
|Файл базы повреждён.
|Сделайте копию файла; восстановите из резервной копии. Если её нет — переименуйте/удалите базу (создастся заново; история будет потеряна).
|-
|'''12'''
|Запрошена неподдерживаемая низкоуровневая операция хранения.
|Если работа продолжается — действий не требуется. Если операция с базой данных не выполняется: перезапустите приложение; проверьте доступность диска/сетевого пути; по возможности временно перенесите базу на локальный диск.
|-
|'''13'''
|На диске закончилось место.
|Освободите место; уменьшите период хранения; включите разбиение БД на файлы.
|-
|'''14'''
|Не удаётся открыть файл базы.
|Проверьте путь и существование папки; права доступа; при необходимости укажите новый путь.
|-
|'''15'''
|Ошибка протокола блокировок (нарушен порядок совместного доступа).
|Закройте все окна/станции, которые используют базу. Подождите 30–60 секунд и запустите снова. Убедитесь, что не идут резервное копирование/антивирусное сканирование. Если база доступна по сети — временно скопируйте её на локальный диск и проверьте работу.
|-
|'''16'''
|Внутренняя ошибка SQLite (служебный код).
|Перезапустите приложение.
|-
|'''17'''
|Изменилась структура базы во время работы.
|Закройте другие экземпляры/станции, которые могли менять структуру. Перезапустите приложение. Если база обновлялась — дождитесь завершения обновления.
|-
|'''18'''
|Слишком большой блок данных.
|Уменьшите размер добавляемых данных.
|-
|'''19'''
|Нарушено ограничение данных (дубликат, пустое обязательное поле и т.п.).
|Проверьте вводимые значения: уникальные имена/ID, заполнение обязательных полей, корректные ссылки на объекты. Исправьте данные и повторите. Если источник данных внешний — исправьте файл/настройки импорта.
|-
|'''20'''
|Несовместимый тип данных (текст вместо числа и т.п.).
|Проверьте формат значений и региональные настройки (разделитель дроби, дата/время). Исправьте файл/настройки импорта или параметры тега и повторите.
|-
|'''21'''
|Ошибка использования библиотеки (ошибка приложения).
|Перезапустите приложение. Убедитесь, что не запускаете несколько конфликтующих копий.
|-
|'''22'''
|Файловая система/операционная система не поддерживает большие файлы/нужные функции.
|Вероятная причина — устаревшая файловая система или сетевое хранилище. Обратитесь к администратору для переноса базы на современную ФС/носитель. Как временная мера — уменьшите размер базы (сократите период хранения/включите ротацию).
|-
|'''23'''
|Отказ в авторизации (нет прав на действие).
|Войдите под учётной записью с нужными правами или запросите доступ у администратора. Если используется сеть — проверьте подключение и актуальность прав.
|-
|'''24'''
|Не используется (оставлен для обратной совместимости).
|Действий не требуется.
|-
|'''25'''
|Неверные параметры запроса (внутренняя ошибка приложения).
|Перезапустите приложение.
|-
|'''26'''
|Открыт файл, который не является базой данных.
|Проверьте путь и что выбран именно файл БД. Если файл повреждён — восстановите из резервной копии или создайте новую БД.
|-
|'''27'''
|Уведомление (информационное сообщение).
|Действий не требуется. В случае частых появлений кода проверьте логи базы данных для выяснения причины.
|-
|'''28'''
|Предупреждение (некритичная проблема).
|Действий не требуется. В случае частых появлений кода проверьте логи базы данных для выяснения причины.
|-
|'''100'''
|Доступна следующая строка данных.
|Не ошибка. Действий не требуется.
|-
|'''101'''
|Операция завершена, данных больше нет.
|Не ошибка. Действий не требуется.
|}

=== Архиватор PostgreSQL ===
Архиватор PostgreSQL предназначен для сохранения значений параметров в базы данных под управлением сервера PostgreSQL.

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

'''Назначение прореживания'''

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

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

Алгоритм прореживания работает по простому принципу:

# SCADA-система получает новое значение от источника данных.
# Она сравнивает это значение с последним, которое было сохранено в архив.
# Если изменение превышает заранее настроенный '''допуск''' (tolerance), новое значение сохраняется.
# Если изменение меньше допуска, значение пропускается.

Кроме того, существует параметр "'''Период обязательной записи"'''. Если с момента последней записи прошло больше времени, чем указано в этом параметре, новое значение будет сохранено '''независимо от его изменения'''. Это гарантирует, что записи в архив будут сохраняться не реже заданной периодичности, даже если сигнал не меняется. Ключевая идея: "'''Сохраняем только то, что заметно изменилось, но не реже, чем задано".'''

'''Как подобрать допуск?'''

* '''Слишком малый допуск''' приведёт к записи избыточных данных, и архив будет быстро расти.
* '''Слишком большой допуск''' может привести к потере мелких, но значимых изменений в сигнале.

Выбор правильного допуска — это компромисс между детализацией данных и размером архива.
==== Типы алгоритмов прореживания ====
В системе доступны несколько алгоритмов, которые определяют, как именно вычисляется «значимость» изменения. Выбор алгоритма зависит от характера сигнала и требований к точности данных.

# [[Узлы проекта AgavaSCADA/AgavaPLC#Абсолютный допуск|Абсолютный допуск]]
# [[Узлы проекта AgavaSCADA/AgavaPLC#Процент от последнего значения|Процент от последнего значения]]
# [[Узлы проекта AgavaSCADA/AgavaPLC#Процент от среднего N последних|Процент от среднего N последних]]
# [[Узлы проекта AgavaSCADA/AgavaPLC#Процент от среднего по временному окну|Процент от среднего по временному окну]]

'''Обозначения и определения'''

В дальнейшем используются следующие обозначения (для числовых сигналов):

* <math>x_{in}</math> — текущее измерение сигнала, полученное от источника данных к моменту обработки (кандидат на запись).
* <math>x_{ref}</math> — последнее сохранённое числовое значение сигнала в архиве на момент обработки (опорное значение).
* <math>|\Delta| = |x_{in} - x_{ref}|</math> — абсолютная величина изменения между текущим измерением и последним сохранённым значением.
* <math>\bar{x}_N</math> — арифметическое среднее последних <math>N</math> сохранённых числовых значений.
* <math>\bar{x}_T</math> — среднее всех сохранённых числовых значений, чьи метки времени попадают в временное окно длительности <math>T</math> миллисекунд.
* <math>\varepsilon</math> — машинная точность для чисел двойной точности; используется для формальной проверки «близости к нулю».
* <math>tolerance</math> — допуск: абсолютный (в физических единицах) или относительный (в процентах), в зависимости от выбранного алгоритма.

'''Настройки в Свойствах архиватора, общие для всех типов прореживания'''

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

===== Абсолютный допуск =====
'''Принцип:'''

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

<math display="block">|\Delta| > tolerance</math>

'''Когда использовать:'''

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

'''Преимущества:'''

* Обеспечивает предсказуемое и детерминированное поведение независимо от текущего масштаба значения.
* Не требует накопления или хранения дополнительных данных (окон/истории), вычислительно прост.
* Удобен при наличии нормативно заданных пределов точности в физических единицах.

'''Ограничения:'''

* Не масштабируется на широкий динамический диапазон: один и тот же порог может быть слишком грубым для малых значений и слишком чувствительным для больших.
* Требует аккуратного подбора порога под единицы измерения и разрешение датчика; при неверной калибровке возможны либо избыточные записи, либо потеря значимых мелких изменений.
* Не учитывает относительный контекст изменения (например, 1 единица при значении 10 и при значении 10 000 трактуется одинаково).

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — абсолютный порог в физических единицах сигнала. Определяет значение <math>tolerance</math>.

===== Процент от последнего значения =====
'''Принцип:'''

Новое значение сохраняется, если относительное изменение относительно последнего сохранённого превышает заданный процент.

<math display="block">\frac{|\Delta|}{|x_{ref}|} \times{100} > tolerance</math>

'''Когда использовать:'''

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

'''Преимущества:'''

* Масштабируемость: одинаково интерпретирует относительные изменения на низких и высоких уровнях сигнала.
* Не требует хранения окна значений; использует только последнее сохранённое значение, поэтому вычислительно лёгок.
* Быстро и корректно реагирует на пропорциональные изменения процесса (проценты), поддерживая заданную относительную чувствительность.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. [[Узлы проекта AgavaSCADA/AgavaPLC#Примечание к алгоритмам 'Процент от…'|примечание]]).
* При малых базовых значениях возможна повышенная чувствительность к шуму и микроколебаниям.
* Не подавляет высокочастотный шум сам по себе: при необходимости сочетать с обязательной записью по времени и корректной настройкой допуска.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

===== Процент от среднего N последних =====
'''Принцип:'''

Новое значение сохраняется, если изменение больше заданного процента от среднего по последним N сохранённым значениям.

<math display="block">\frac{|\Delta|}{|\bar{x}_{N}|} \times{100} > tolerance</math>

'''Когда использовать:'''

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

'''Преимущества:'''

* Снижает чувствительность к высокочастотному шуму за счёт опоры на усреднение; сокращает объём записей на стационарных участках.
* Гибко настраивается параметром <math>N</math>: увеличение окна повышает устойчивость, уменьшение — повышает чувствительность и снижает задержку реакции.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. [[Узлы проекта AgavaSCADA/AgavaPLC#Примечание к алгоритмам 'Процент от…'|примечание]]).

* Инерционность: при резких скачках возможна задержка фиксации изменения, особенно при большом <math>N</math>.
* Усреднение может «сглаживать» и не фиксировать кратковременные, но важные пики; не подходит для задач, критичных к коротким экстремумам.
* Предполагает относительно стабильную частоту выборок; при сильно переменной частоте эффективная «временная» ширина окна становится непредсказуемой.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

* '''Размер окна среднего (<math>N</math>)''' — число последних сохранённых значений, по которым считается среднее. Большее <math>N</math> повышает устойчивость к шуму, но увеличивает инерционность реакции.

===== Процент от среднего по временному окну =====
'''Принцип:'''

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

<math display="block">\frac{|\Delta|}{|\bar{x}_{T}|} \times{100} > tolerance</math>

'''Когда использовать:'''

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

'''Преимущества:'''

* Корректно работает при переменной частоте выборок: окно фиксируется по времени, а не по числу точек.
* Более реалистично оценивает тренд во времени на участках с неравномерными измерениями.
* Управляемый компромисс между подавлением шума и чувствительностью за счёт выбора длительности окна.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. [[Узлы проекта AgavaSCADA/AgavaPLC#Примечание к алгоритмам 'Процент от…'|примечание]]).

* Более высокая ресурсоёмкость: требуется хранить и периодически «очищать» значения по условию выхода из временного окна; потребление памяти зависит от фактической скорости поступления данных.
* Инерционность, присущая усреднению: возможна задержка фиксации коротких, но значимых пиковых изменений.
* Критичен выбор длительности окна: слишком малое окно даёт мало подавления шума, слишком большое — чрезмерную инерцию и риск пропуска кратких событий.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

* '''Интервал архивирования''' — длительность временного окна <math>T</math> (мс), в пределах которого вычисляется среднее. При увеличении <math>T</math> растёт сглаживание и уменьшается чувствительность к кратким всплескам; при уменьшении — наоборот. Значения, чьи метки времени выходят за пределы окна, автоматически исключаются из расчёта.

==== Примечание к алгоритмам 'Процент от…' ====
При малых опорных значениях система автоматически переходит в абсолютный режим, чтобы избежать деления на величину, близкую к нулю, и связанных с этим скачков чувствительности. Этот механизм применяется ко всем алгоритмам, использующим относительное сравнение: «Процент от последнего», «Процент от среднего N», «Процент от среднего по временному окну» и обеспечивает стабильность критерия при слабых сигналах.

* Условия входа в режим абсолютного допуска:
** для «Процента от последнего»: <math>|x_{ref}| < \varepsilon</math>;
** для «Процента от среднего N»: <math>|\bar{x}_{N}| < \varepsilon</math>;
** для «Процента от среднего по времени»: <math>|\bar{x}_{T}| < \varepsilon</math>.
* Критерий в режиме абсолютного допуска: значение фиксируется, если <math>|\Delta| > tolerance</math>.
* Условие выхода: как только соответствующая базовая величина (<math>|x_{ref}|</math>, <math>|\bar{x}_{N}|</math> или <math>|\bar{x}_{T}|</math>) становится <math>\geq \varepsilon</math>, система автоматически возвращается к относительному критерию.
* Трактовка <math>tolerance</math>: используется то же значение настройки; в абсолютном режиме оно интерпретируется как порог в физических единицах сигнала.

==== Сравнение алгоритмов прореживания данных ====
{| class="wikitable"
!Критерий
!Абсолютный
!% от последнего
!% от среднего N
!% от среднего по времени
|-
|Единицы допуска
|Физические
|Проценты
|Проценты
|Проценты
|-
|Устойчивость к шуму
|Низкая
|Средняя
|Высокая
|Высокая
|-
|Реакция на резкие скачки
|Быстрая
|Быстрая
|Задержка (при большом N)
|Задержка
|-
|Подходит при переменной частоте
|Да
|Да
|Нет
|Да
|}

==Система журналирования==
Система ведения журналов событий предназначена для управления регистрацией и хранением событий. В базу данных записываются все системные события и события, генерируемые с помощью [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.A1.D0.B8.D1.81.D1.82.D0.B5.D0.BC.D0.B0 .D1.82.D1.80.D0.B5.D0.B2.D0.BE.D0.B3|системы тревог]], которые соответствуют выбранному уровню сообщений.

Для ведения журналов используются узлы типа "Логгер".

===Порядок настройки системы===
Порядок настройки системы журналирования следующий:

#Добавить и [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.9F.D0.BE.D1.80.D1.8F.D0.B4.D0.BE.D0.BA .D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8 .D1.81.D0.B8.D1.81.D1.82.D0.B5.D0.BC.D1.8B|настроить систему тревог]] для генерации событий.
#Добавить в проект систему журналирования. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система журналирования».
#Добавить в систему журналирования логгер. Для этого нажать ПКМ по узлу «Система архивации» в дереве проекта, затем нажать «Добавить узел» и выбрать нужный логгер.
#Настроить параметры логгера (см. разделы ниже).

=== Логгер SQLite===
Логгер SQLite предназначен для сохранения событий, возникающих в ходе исполнения прикладной программы в СУБД SQLite.

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

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

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

===Логгер SMS===
Логгер SMS предназначен для SMS информирования с помощью субмодуля GRPS или внешнего GPRS модема.

Принцип работы логгера следующий:

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

==Система проверки прав пользователей==
[[Файл:AgavaPLC-Окно привилегий.png|мини|494x494пкс|Окно привилегий]]
Система реализует механизм контроля доступа к узлам проекта и их функциях на основе ролей. Узлы при выполнении действий проверяют наличие установленных привилегий у авторизованного в данный момент пользователя.

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

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

=== Привилегии ===
[[Файл:AgavaPLC-Система проверки прав пользователей.png|мини|Система проверки прав пользователей]]
Для узлов системы доступна установка следующих привилегий:

Все узлы:

*Чтение значения.
*Запись значения.
Окна и фреймы:
*Открытие окна.
*Закрытие окна.

При установке привилегий на какой-либо узел, все подчиненные узлы получают те же привилегии с флагом "унаследована".

Если привилегия не установлена, то считается что действие, регулируемое привилегией, запрещено.

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

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

#Добавить в проект систему проверки прав пользователей. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система проверки прав пользователей».
#Добавить в систему проверки прав пользователей узел «Роль». Для этого нажать ПКМ по узлу «Система проверки прав пользователей» в дереве проекта, затем выбрать «Добавить узел» - «Роли».
#Добавить в узел «Роли» необходимые роли. Для этого нажать ПКМ по узлу «Роли» в дереве проекта, затем выбрать «Добавить узел» - «Роль».
#Для каждой роли настроить привилегии в окне привилегий. Для этого необходимо нажать «Вид» - «Открыть привилегии». В открывшемся окне в выпадающем списке «Пользователь / роль» выбрать нужную роль. Затем, нажимая ПКМ по узлам и выбирая «Добавить привилегию» настроить все необходимые ограничения для данной роли.
#Добавить в систему проверки прав пользователей узел «Пользователи». Для этого нажать ПКМ по узлу «Система проверки прав пользователей» в дереве проекта, затем выбрать «Добавить узел» - «Пользователи».
#Добавить в узел «Пользователи» необходимых пользователей. Для этого нажать ПКМ по узлу «Пользователи» в дереве проекта, затем выбрать «Добавить узел» - «Пользователи».
#Для каждого пользователя указать имя и пароль, которые будут использоваться при авторизации, и выбрать одну или несколько ролей.

== Сигналы, источники и операции ==
Регистры и другие узлы, добавленные в группу «Сигналы», являются внутренними для проекта и могут менять свои значения только с помощь скриптов или других узлов, с которыми они связаны.

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

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

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

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

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

====Сигнал простой====
Узел типа "Сигнал простой" предназначен для хранения и обработки значения источника, или другого сигнала или операции. Позволяет произвести какие-либо действия с этим значением с помощью добавления нужных операций в свойство «Операции после чтения».

====Постоянная ====
Узел типа "Постоянная" предназначен для хранения данных выбранного формата и позволяет изменять их в ходе выполнения программы. Связывание с источником не предусмотрено. Изменение осуществляется с помощью специализированных функций или блока установки значения в задаче ПЛК.

====Массив====
Массив - совокупность каких-либо объектов, указанных в свойстве «Входные значения». Нумерация объектов в массиве начинается с 0. Может использоваться для взаимодействия с демультиплексором.

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

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

*ВАУ – верхняя аварийная уставка;
*ВПУ - верхняя предаварийная уставка;
*НПУ - нижняя предаварийная уставка;
*НАУ – нижняя аварийная уставка;
*ФНЧ – фильтр низких частот.

===Источник===
Источник - специальный тип узлов, предназначенных для передачи данных от внешних устройств.

====Регистр Modbus====
Регистр Modbus используется для приема и передачи данных по протоколам Modbus-RTU, Modbus-TCP. Данный тип узов также может использоваться для организации работы некоторых алгоритмов программы (например для взаимодействия с контроллером событий).

====Источник индексный====
Узел типа "Источник индексный" используется для обработки данных, полученных по протоколу Upd, а так же в массивах для индексации значений.

===Операция===
[[Файл:AgavaPLC-Входные значения операций.png|мини|Входные значения операций]]
Узлы типа "Операция" используются для реализации вычислительных алгоритмов в задаче ПЛК или отдельно, при их размещении в группе "Сигналы".

В качестве входных значений операций выбираются константные числа, другие узлы группы «Сигналы», регистры или блоки задачи ПЛК.

====Операция «Сложение»====
Выходным значением является сумма входных значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Вычитание»====
Выходным значением является разность первого входного значения и суммы всех последующих значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Умножение»====
Выходным значением является произведение значений всех входных значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Деление»====
Выходным значением является результат от деления первого входного значения на произведение всех последующих значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Условие»====
Узел типа "Операция условие" предназначен для сравнения значений двух узлов. Для условия задаются сравниваемые параметры и выбирается режим сравнения. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Пара условий»====
[[Файл:AgavaPLC-Операция «Пара условий».png|мини|Операция «Пара условий»]]
Операция содержит в себе два условия. Для каждого условия задаются индивидуальные сравнимаемые параметры и выбирается режим сравнения.

Выходное значение операции зависит от ее режима проверки – при выбранном режиме «Логическое ИЛИ» выходное значение равно логической «1» если одно из условий равно «1», при «Логическом И»- если оба условия равны «1».

====Операция «Логическое ИЛИ»====
Если одно из входных значений становится равно логической «1» (контакты замкнуты), то выходное значение становится логической «1» (выход включен).

====Операция «Логическое И»====
Если все входные значения становятся равны логической «1», выходное значение становится логической «1» (выход включен).

====Операция «Логическое НЕ»====
Если входное значение блока становится равно логическому «0», то выходное значение становится логической «1», и наоборот.

====Операция «Таймер»====
Таймер предназначен для выполнения каких-либо [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D1.8F|действий]] через одинаковые промежутки времени (например запись значения в узел). Промежуток между исполнениями действий задается в свойстве «Интервал срабатывания», а сами действия в свойстве «Действия OnTimer». Для работы операции ее необходимо добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения.

====Операция «Мультиплексор»====
Мультплексор осуществляет перевод нескольких булевых переменных в целочисленное значение по формуле: «выход = вход1 + вход2*2^1 + вход3*2^2 + ...».

Например если в качестве входных значений указаны два регистра, то выходное значение мультиплексора будет формироваться следующим образом:
{| class="wikitable"
!Значение регистра 1
!Значение регистра 2
!Выходное значение
|-
|0
|0
|0
|-
|1
|0
|1
|-
|0
|1
|2
|-
|1
|1
|3
|}

====Операция «Демультиплексор»====
Демультиплексор осуществляет перевод целочисленных значений из массива в несколько булевых переменных, при этом включается выход, номер которого соответствует числу из массива (например первый элемент массива равен 5, на пятом выходе появится значение true). Нумерация выходов начинается с нуля.

====Операция «Генератор случайного числа»====
Выходным значением является случайное число в диапазоне между указанным минимальным и максимальным значениями. Для работы операции ее необходимо добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения.

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

Для выполнения скрипта, можно добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения. Другим способом вызова срабатывания скрипта является добавление его в [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D0.B5 .C2.AB.D0.92.D1.8B.D0.BF.D0.BE.D0.BB.D0.BD.D0.B5.D0.BD.D0.B8.D0.B5 .D1.81.D0.BA.D1.80.D0.B8.D0.BF.D1.82.D0.B0.C2.BB|действие «Выполнение скрипта»]].

Пример скрипта, выполняющего получение значения определенного узла и запись измененного значения в другой узел:
float val()
{
float f = GetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Random2");
float f1 = f*100.0;
SetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Constant3", f1);
return f*10.0;
}
Приведенный выше скрипт возвращает исходное значение, умноженное на 10. Возвращаемое таким образом значение записывается в выход операции для возможности считывания в других операциях, скриптах и т. д.

Скрипты могут возвращать значения следующих типов:

*void;
*float;
*double;
*int.

Подробное описание реализации языка С++ в AgavaSCADA/AgavaPLC приведено на странице "[[Описание языка С++ в AgavaPLC]]".

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

'''ПЛК процессорный модуль'''

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

'''ПЛК субмодуль DI'''

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

'''ПЛК субмодуль R'''

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

'''ПЛК субмодуль SIM'''

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

'''ПЛК субмодуль DO6'''

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

'''ПЛК субмодуль AI'''

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

'''ПЛК субмодуль AIO'''

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

'''ПЛК субмодуль TMP'''

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

==Задачи==
Группа «Задачи» предназначена для группировки узлов типа «Задача», которые используются для циклического или разового выполнения созданных пользователем алгоритмов.

===Задача ПЛК===
Данный узел предоставляет возможности для связывания между собой других узлов (таких как сигналы, субмодули ПЛК, постоянные и т. д.) в удобной графической форме (см. Рисунок 64). Для перехода к редактору необходимо щелкнуть правой кнопкой мыши на задачу ПЛК и выбрать в открывшемся контекстном меню команду «Открыть графическое представление» или дважды щелкнуть левой кнопкой мыши на задаче ПЛК в дереве проекта.

Рисунок 64 – Окно графического редактирования задачи «ПЛК-60»

Панель инструментов задачи ПЛК, расположенная в верхней части окна, содержит следующие элементы (см. Рисунок 16):

*Выпадающий список выбора режима подписи портов.
*Выпадающий список выбора режима подписи блоков.
*Кнопка запуска режима симулятора.
*Кнопка запуска онлайн отладки.
*Кнопка печати задачи.
*Инструменты управления симуляцией.

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

Созданную связь можно удалить, выделив ее левой кнопкой мыши и нажав клавишу "Del". Связь можно "разорвать", то есть добавить разрыв, нажав по ней правой кнопкой мыши и выбрав в контекстном меню команду «Добавить разрыв».

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

Задача ПЛК предоставляет возможности для проведения тестирования и отладки проекта, описанные в разделе [[#Проверка и отладка проекта]].

====Блоки задачи ПЛК====
Помимо операций, описанных в разделе [[#Операция]], для реализации алгоритмов в задачу ПЛК можно добавлять блоки, описанные ниже.

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

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

'''Блок установки значения'''

Блок осуществляет запись значения, поданного на вход in0, в узел, указанный в свойстве «Узел для чтения/записи»

'''Блок задержки'''

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

'''Блок «Битовое OR»'''

Для вычисления значения будет произведена операция "ИЛИ" над каждым битом значения в отдельности. Например: 1010 OR 0110 = 1110

'''Блок «Логическое И»'''

Если все входные значения становятся равны логической «1», выходное значение становится логической «1» (выход включен).

'''Блок «Битовое AND»'''

Для вычисления значения будет произведена операция "И" над каждым битом значения в отдельности. Если все биты, стоящие на одинаковых позициях в двоичных представлениях значений, поступающих на входы блока, равны логической «1», то на выходе элемента в этой позиции появляется логическая «1» (выход включен). Например: 1010 AND 0110 = 0010

'''Блок «Логическое НЕ»'''

Если входное значение блока становится равно логическому «0», то выходное значение становится логической «1», и наоборот.

'''Блок «Битовое XOR»'''

Если только на один из входов блока функции поступает логическая «1», то на выходе элемента появляется логическая «1». Если на входы блока функции поступают целочисленные значения, то операция будет произведена над каждым битом значения в отдельности. Например: 1010 XOR 0110 = 1100

'''Блок «Битовое SHR»'''

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

'''Блок «Битовое SHL»'''

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

'''Блок «Таймер»'''

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

'''Блок «Мультиплексор»'''

Мультплексор осуществляет перевод нескольких булевых переменных в целочисленное значение по формуле: «выход = вход1 + вход2*2^1 + вход3*2^2 + ...»

'''Блок «Демультиплексор»'''

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

'''Блок «Генератор случайного числа»'''

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

'''Блок «Скрипт С++»'''

Операция «Скрипт С++» предназначена для реализации разнообразных алгоритмов на языке С++. Операция предусматривает реализацию одной или нескольких функций, выполняющих необходимые пользователю действия. Для выполнения скрипта, необходимо добавить его в качестве узла для задачи или задачи ПЛК.

Пример скрипта, выполняющего получение значения определенного узла и запись измененного значения в другой узел:
float val()
{
float f = GetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Random2");
float f1 = f*100.0;
SetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Constant3", f1);
return f*10.0;
}
Приведенный выше скрипт возвращает исходное значение, умноженное на 10. Возвращаемое таким образом значение записывается в выход операции для возможности считывания в других операциях, скриптах и т. д.

Скрипты могут возвращать значения следующих типов:

* void;
*float;
*double;
*int.

Подробное описание реализации языка С++ в AgavaSCADA/AgavaPLC приведено на странице "[[Описание языка С++ в AgavaPLC]]".

'''Блок «Таймер с задержкой»'''

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

'''Блок «Генератор прямоугольных импульсов»'''

Генератор прямоугольных импульсов используется для формирования прямоугольных импульсов пульсации. На выходе генератора формируются импульсы с заданными параметрами длительности включенного и отключенного импульса на время действия управляющего сигнала на входе (сигнал логической «1»).

'''Блок «Триггер RS»'''

RS-триггер с приоритетом выключения используется для переключения с фиксацией состояния во время поступления коротких импульсов на соответствующий вход. На выходе появится логическая «1» по фронту сигнала на входе Set, которая будет сброшена в «0», при поступлении импульса на вход Reset.

'''Блок «Триггер SR»'''

SR-триггер с приоритетом включения используется для переключения с фиксацией состояния в случае поступления коротких импульсов на соответствующий вход. На выходе появится логическая «1» по фронту сигнала на входе Set, которая будет сброшена в «0», при поступлении импульса на вход Reset.

'''Блок «Детектор переднего фронта импульса»'''

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

'''Блок «Детектор заднего фронта импульса»'''

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

'''Блок «D-триггер»'''

D-триггер используется для формирования импульса включения выхода на интервал времени импульса на входе D, выходной интервал будет синхронизирован с тактовой частотой на входе С. На выходе Q триггера появится сигнал логической «1» по фронту тактовых импульсов на входе С при наличии сигнала логической «1» на входе D. Возврат выхода в сигнал логического «0» произойдет по фронту тактовых импульсов на входе С при наличии сигнала логического «0» на входе D. Вход Set принудительно устанавливает выход в состояние логической «1». Вход Reset является приоритетным и устанавливает выход в состояние логического «0».

'''Блок «Селектор»'''

Если на вход Value подается логическая «1», то результатом выполнения операции блока на выходе является входной сигнал ValueT. Если же Value равен логической «0», то результатом выполнения операции блока на выходе является входной сигнал ValueF.

'''Блок «Больше чем»'''

На выход подается логическая «1», если значение in0 больше чем значение in1.

'''Блок «Равенство»'''

На выход подается логическая «1», если значение in0 равно значению in1.

'''Блок «Абсолютное значение числа»'''

Результатом операции функции на выходе является модуль подаваемого на вход значения. Если число на входе положительное, то на выход подается само число, если отрицательное – положительное число, получаемое от перемены его знака с «-» на «+».

'''Блок «Возведение в степень»'''

Результатом операции функции на выходе является значение, равное значению in0, возведенному в степень значения N.

'''Блок «PID-регулятор»'''

Регулятор PID применяется для поддержания заданного значения параметра. На вход Pv подается текущее значение регулируемой величины, на Sp – ее заданное значение. С помощью изменения коэффициентов ПИД регулятора kP, kI и kD достигается оптимальный режим работы. Min задает минимальное значение на выходе, Max – максимальное. time - период регулятора (в мс.).

'''Блок «PWM-регулятор»'''

Применяется для преобразования аналогового сигнала в дискретный с помощью ШИМ. На вход in подается текущее значение регулируемой величины, Min задает минимальное значение на входе, Max – максимальное. time - период регулятора (в мс.)

==Устройства==
Группа «Устройства» предназначена для группировки узлов типа "Устройство", выполняющие разнообразные задачи, например работа с внешними накопителями и ПЗУ.

Retain-накопитель дает возможность хранить значения регистров, постоянных и сигналов в постоянной памяти контроллера, что позволяет им сохранять свои значения после отключения питания.

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

== Отчеты==
{{Внимание|Тип=Восклицание желтый.png|Текст=Данный узел доступен только при исполнении проекта на настольном компьютере. На панелях оператора и контроллерах МПР этот узел не доступен.}}
Отчет – технологический документ, содержащий информацию о ходе производственного процесса, обработанную по заложенным в отчет алгоритмам. Отчеты формируются на основе макетов (статической части отчетов) путем добавления в них свойств и значений заданных параметров технологического процесса, которые формируются (выбираются из базы данных технологических параметров и проходят соответствующую обработку) по алгоритмам, размещенным в этих шаблонах.

Данные для отчета предоставляет выборка, осуществляющая получение данных и их обработку из базы данных.

===Создание нового отчета===
Создание любого отчета производится в два этапа.

#Создание необходимых узлов в конфигурации: сам отчет и необходимое количество выборок.
#Составление макета отчета.

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

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

Перед переходом к редактированию макета желательно проделать следующие операции:

*в свойстве отчета «Путь к файлу отчета» установить имя файла, в котором будет храниться макет отчета;
* в свойстве «Источники» выборки (выборок) отчета установить перечень архивных сигналов (коннекторов), которые будут выводиться в отчете.

===Редактирование макета отчета===
[[Файл:AgavaPLC–Редактор макета отчета.png|мини|Рисунок 42 – Редактор макета отчета]]
Для редактирования макета отчета необходимо переключиться из редактора конфигурации в редактор макета отчета с помощью команды «Открыть редактор макета отчета», доступной из контекстного меню дерева конфигурации, отображаемого при щелчке правой кнопкой мыши на узле типа «Отчет».

В окне редактора расположены:

*панели инструментов;
* панель объектов отчета;
*окно «Инспектор объектов»;
*окно «Инспектор данных»;
*окно «Инспектор скриптов»;
*область построения макета отчета;
*окно «Структура отчета».

Редактор макета позволяет вызывать команды сочетаниями клавиш:

*Ctrl + N – новый макет;
*Ctrl + O – загрузить макет;
*Ctrl + S – сохранить макет;
*Ctrl + Shift + S – сохранить макет под новым именем;
*Ctrl + P – предварительный просмотр;
*Ctrl + Z – отмена изменений;
*Ctrl + Shift + Z – возврат отмененных изменений;
* Ctrl + C – копировать объект;
*Ctrl + X – вырезать объект;
*Ctrl + V – вставить объект;
*Ctrl + Стрелки – переместить выделенный объект;
*Shift + Стрелки – изменить размер выделенных объектов;
*Del – удалить выделенные объекты;
*Shift + левая кнопка мыши – создать область выделения.

====Окно «Инспектор объектов»====
Окно «Инспектор объектов» содержит список свойств выделенного объекта и предназначено для их редактирования.

====Окно «Инспектор данных»====
Окно «Инспектор данных» содержит список доступных для использования источников данных (выборок) и предназначено для заполнения блока «Данные» элементами соответствующего типа.

====Окно «Инспектор скриптов»====
Окно «Инспектор скриптов» содержит список доступных для использования в отчете скриптов.

====Окно «Структура отчета»====
Окно «Структура отчет» отображает структуру отчета в виде дерева связанных элементов.

===Элементы отчета===
Для составления макета отчета доступны следующие элементы:

*текст;
*данные;
*изображение;
*фигура;
*компоновка (Layout).

====Текст====
Элемент «Текст» служит для вывода надписей или содержимого полей источников данных.

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

Одна из самых главных особенностей этого универсального объекта – это возможность отображения не только статичного текста, но и текста с применением вычисляемых выражений. Причем, выражения могут располагаться в объекте вперемешку с текстом. Рассмотрим простой пример – поместим в объект «Текст» следующую строку: «Привет! Сегодня $S{now()}».

Если запустить отчет на построение, мы увидим приблизительно следующее: «Привет! Сегодня 20180803». В процессе построения отчета выражение в тексте, заключенное $S{}, было вычислено и полученное значение вставлено обратно в текст. Объект «Текст» может содержать любое количество выражений, смешанных с обычным текстом. В скобки можно заключать и одиночные переменные, и выражения, например, $S{1+2*(3+4)}. В выражениях можно использовать константы, переменные ($V{}), функции, поля БД ($D{}).

Свойства элемента «Текст»:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|alignment
|Выравнивание текста по вертикали и горизонтали
|-
|angle
|Поворот надписи
|-
|autoHeight
|Автоматический подбор высоты
|-
|autoWidth
|Автоматический подбор ширины
|-
|backgroundColor
|Цвет заливки
|-
|backgroundMode
|Режим заливки
|-
| backgroundOpacity
|Прозрачность заливки
|-
|borders
|Границы
|-
|content
|Содержимое объекта «Текст»
|-
|font
|Шрифт
|-
|fontColor
|Цвет шрифта
|-
| foregroundOpacity
|Прозрачность шрифта
|-
|geometry
|Размер и расположение объекта
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|margin
|Отступы
|-
|objectName
| Имя объекта
|-
|stretchToMaxHeight
|Установка значения высоты самого высокого объекта на бэнде
|-
|trimValue
|Удаление пробелов в начале и в конце надписи
|}

Для редактирования свойства «Content» используется диалоговое окно «Text Item Editor», вызов которого осуществляется двойным щелчком левой кнопки мыши на элементе «Текст».

Свойство «Content» может содержать:

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

Для вывода значений переменных используется синтаксис «$V{имяПеременной}» (без кавычек), для вывода значения поля данных – «$D{имяНабораДанных.ИмяПеременной}», для вывода результата исполнения скрипта – «$S{телоСкрипта}».

==== Изображение ====
Элемент для вывода изображений:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|autoSize
|Подгонять размер под размер изображения
|-
|borders
|Границы
|-
|content
|
|-
|datasource
|Источник данных
|-
|field
|Поле данных
|-
|geometry
|Размер и расположение
|-
|image
|Изображение
|-
| itemLocation
|Расположение объекта (страница или бэнд)
|-
|objectName
|Имя объекта
|-
| stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

====Фигура====
Элемент для вывода фигур:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|borders
|Границы
|-
| geometry
|Размер и расположение
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|lineWidth
|Толщина линии
|-
|objectName
|Имя объекта
|-
|opacity
|Прозрачность
|-
|penStyle
|Стиль линии
|-
|shape
|Фигура
|-
|shapeBrush
|Стиль заливки
|-
|shapeBrushColor
|Цвет заливки
|-
|shapeColor
|Цвет фигуры
|-
|stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

====Горизонтальная компоновка (Layout)====
Элемент, позволяющий объединять несколько элементов в группу:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|borders
|Границы
|-
|geometry
|Размер и расположение
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|objectName
|Имя объекта
|-
|stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

=== Разделы отчета (бэнды) ===
Бэнд предназначен для размещения других элементов отчета. Бэнд может быть нескольких типов:

*Report Header – заголовок отчета;
*Report Footer – завершение отчета;
*Page Header – верхний колонтитул страницы отчета;
*Page Footer – нижний колонтитул страницы отчета;
*Data – данные отчета;
* SubDetail – подчиненные данные отчета;
*SubDetailHeader – заголовок подчиненных данных;
*SubDetailFooter – завершение подчиненных данных;
*GroupHeader – заголовок группы;
*GroupFooter – завершение группы.

Бэнды применяются для логической группировки объектов. К примеру, размещение объекта на элементе «Данные» типа «Page Header», приводит к отображению этого объекта в верхней части каждой страницы готового отчета. Аналогичным образом «Page Footer» выводится внизу каждой страницы со всеми лежащими на нем объектами.

Общие для всех элементов «Данные» свойства:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|autoHeight
|Автоматический подбор высоты
|-
|backgroundColor
|Цвет заливки бэнда
|-
|borders
|Границы
|-
|geometry
|Размер
|-
|keepBottomSpace
|Сохранение отступа от нижней границы бэнда
|-
|objectName
|Имя объекта
|-
|printIfEmpty
|Отображение пустого бэнда
|-
|splittable
|Разделение бэнда, если он не влезает на страницу
|}

Report Footer:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|maxScalePercent
|Максимальный процент, на который можно уменьшить бенд, если он не влезает на страницу. Если бэнд даже после сжатия

не влезает на страницу, он будет перенесен полностью или частично – в зависимости от настроек бэнда
|}

Data:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|datasource
|Источник данных. Data-бэнд будет сформирован для каждой строки в источнике данных
|-
|keepFooterTogether
|Если Report Footer не влезает на страницу, то он будет перенесен на следующую страницу совместно с последним

экземпляром Data-бэнда
|-
|sliceLastRow
| Указывает генератору отчетов на то, можно ли разрезать последний экземпляр Data-бэнда или его нужно перенести

целиком
|}

Бэнды данного типа предназначены для вывода на печать данных из наборов. Набор данных - это заранее неизвестное количество строк (записей), каждая из которых содержит определенное количество колонок (полей).

SubDetail:
{| class="wikitable"
! Наименование свойства
!Описание
|-
|datasource
| Источник данных. SubDetail-бэнд будет сформирован для каждой строки в источнике данных
|}

SubDetailHeader, SubDetailFooter:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|printAlways
| Печатать, даже если SubDetail пустой
|}

GroupHeader:
{| class="wikitable"
!Наименование свойства
! Описание
|-
|groupFieldName
|Поле, по которому осуществляется группировка. Экземпляр GroupHeader будет формироваться при смене значения в этом поле
|}

===Функции===
==== Агрегатные функции ====
Агрегатные функции предназначены для обработки значений, содержащихся в резделах Data и SubDetail.

===== AVG - вычисление среднего значения =====
Пример использования:
$S{AVG("TextItem4","DataBand1");}

===== SUM - вычисление суммы значений =====
Пример использования:
$S{SUM("TextItem8","DataBand1");}

===== MIN =====

===== MAX =====

===== COUNT =====

==== Числовые функции ====

===== numberFormat - форматирование числа =====
Синтаксис:
numberFormat(значение, 'формат', точность)
Форматы:

* <code>'f'</code> — фиксированная запись (например, <code>"123.45"</code>);
* <code>'g'</code> — общий формат (автоматически выбирает между <code>'f'</code> и <code>'e'</code>);
* <code>'e'</code> — экспоненциальная запись (например, <code>"1.2345e+02"</code>);

Пример использования:
$S{numberFormat($D{fetcharchiverdata1.ArchiversSourceConnector0 (среднее)}, 'f', 3)} -> 123.495
[[Категория:AgavaSCADA/AgavaPLC]]

Файл:Иерархия классов объектной модели AgavaPLC 1.6.png

2026-04-10T09:03:32Z

TaushkanovKV: TaushkanovKV загрузил новую версию Файл:Иерархия классов объектной модели AgavaPLC 1.6.png

Транспорты AgavaSCADA/AgavaPLC

2026-04-10T08:51:50Z

TaushkanovKV: /* Режим Slave (ведомый) */

==Транспорты Modbus-RTU, Modbus-TCP==
Данные виды транспортов предназначены для приема и передачи данных по протоколу Modbus. Поддерживаются последовательные и Ethernet подключения.
===Узлы===
*<code>Транспорт Modbus-RTU</code> - транспорт, работающий по последовательным линиям связи.
*<code>Транспорт Modbus-TCP</code> - транспорт, работающий по ethernet.
*<code>Modbus регистр</code> - источник, хранящий значение регистра.
====Транспорт Modbus-RTU====
Узел, представляющий транспорт Modbus, работающий по последовательным линиям связи RS-485, RS-422, RS-232.
=====Доступные дочерние узлы=====
* Группа узлов.
*Modbus регистр.
=====Свойства=====

====Транспорт Modbus-TCP====
Узел, представляющий транспорт Modbus, работающий по линиям связи Ethernet.
=====Доступные дочерние узлы =====
*Группа узлов.
*Modbus регистр.
=====Свойства=====

====Modbus регистр====
Узел-источник, хранящий значение регистра.

=====Доступные дочерние узлы=====
Нет

=====Свойства=====
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Доступ
!Описание
|-
|Устройство
|DeviceAddr
|INT
|Чтение / запись
|
|-
|Функция чтения
|ReadFunction
|INT
|Чтение / запись
|
|-
|Регистр чтения
|ReadRegister
|INT
|Чтение / запись
|
|-
|Размер регистра
|ParamSize
|INT
|Чтение / запись
|
|-
|Приоритет
|Priority
|INT
|Чтение / запись
|
|-
|Функция записи
|WriteFunction
|INT
|Чтение / запись
|
|-
|Регистр записи
|WriteRegister
|INT
|Чтение / запись
|
|-
|Тип значения
|ValueType
|INT
|Чтение / запись
|
|-
|Порядок байт
|ByteOrder
|INT
|Чтение / запись
|
|-
|Операции после чтения
|OperationsOnRead
|NODESARRAY
|Чтение / запись
|
|-
|Операции перед записью
|OperationsOnWrite
| NODESARRAY
|Чтение / запись
|
|-
|Узел для чтения/записи
|SourceId
|NODE
|Чтение / запись
|
|}Устройство

Функция чтения

Регистр чтения

Размер регистра

Приоритет

Функция записи

Регистр записи

Тип значения

Порядок байт

Операции после чтения

Операции перед записью

Узел для чтения/записи

===Работа транспорта===
Транспорты могут работать в двух режимах:

* Ведущий (Master).
* Ведомый (Slave).

====Режим Master (ведущий)====
[[Файл:AgavaPLC-Cхема работы Modbus мастера.png|мини|Cхема работы Modbus мастера]]
В режиме Master транспорт ведет обмен со связанными устройствами - запрашивает значения определенных регистров, записывает в регистры устройств значения, получаемые из виджетов или других узлов проекта. В этом режиме применяется [[Транспорты AgavaSCADA/AgavaPLC#Оптимизации операций записи в Modbus|оптимизация команд записи]].

Схема работы транспорта в режиме Master приведена на схеме.

Работа транспорта Modbus в этом режиме строится на следующих принципах:

* Обмен данными ведется циклами «Запрос — Ответ».
* Транспорт в этом режиме - Ведущий, то есть единственное устройство в сети, которое инициирует передачу данных.
* Ведомые (Slave) устройства никогда не начинают обмен самостоятельно, они только отвечают на запросы.

===== Цикл «Запрос — Ответ» =====
Работа транспорта в этом режиме организована как последовательные циклы:

# Формирование запроса: Master создает кадр, куда входит: адрес ведомого, код функции и данные (с какого адреса, сколько регистров).
# Отправка: Master передает кадр в шину (RS-485 или Ethernet).
# Ожидание: Master включает таймер ожидания ответа.
# Прием ответа: Если Slave с указанным адресом получил команду без ошибок, он отправляет ответный кадр.
# Тайм-аут: Если за отведенное время ответа нет, Master фиксирует ошибку (связь потеряна) и переходит к опросу следующего устройства или повторяет запрос.

===== Управление таймингами =====
Master жестко контролирует паузы в сети:

* Между отправкой запроса и приемом ответа: Master выдерживает минимальную паузу на смену направления передачи (для RS-485).
* Таймаут ожидания ответа: Задается в настройках Master. Если Slave медленный, Master не будет ждать вечно — он прерывает ожидание ответа и переходит к следующей транзакции.
* Межкадровая задержка: Master выдерживает паузу настраиваемой длительности между отправкой разных запросов, чтобы Slave успел обработать команду.

===== Адресация =====

* Master отправляет запрос строго конкретному Slave (адрес от 1 до 247).
* Широковещательный адрес (0): Master может отправить команду всем Slave сразу (например, «запустить моторы»). В этом режиме ведомые не отвечают, чтобы не создать коллизию в шине. В данный момент не поддерживается.

===== Обработка ошибок =====
Master проверяет:

* Контрольную сумму ответа (CRC) (только <code>Modbus-RTU</code>).
* Код исключения: Не вернул ли Slave код ошибки (например, 0x02 — неверный адрес регистра).

====Режим Slave (ведомый)====
[[Файл:AgavaPLC-Схема работы Modbus slave.png|мини|Схема работы Modbus slave]]
В режиме Slave транспорт ведет обмен со связанными устройствами в пассивном режиме - принимает запросы от ведущих и выдает ответы.

Схема работы транспорта в режиме Slave приведена на рисунке.

В режиме Slave транспорт Modbus работает как '''сервер''', ожидающий входящие запросы от внешнего ведущего устройства (Master). Транспорт не инициирует обмен самостоятельно, а только обрабатывает команды, полученные от Master: отдаёт значения указанных регистров или записывает в свои регистры принятые данные. Полученные значения могут передаваться в виджеты или другие узлы проекта.

Работа транспорта Modbus в этом режиме строится на следующих принципах:

* Транспорт в этом режиме — '''Ведомый (Slave)''', то есть отвечает только на запросы внешнего ведущего устройства.
* Обмен данными инициируется исключительно Master.
* Транспорт не опрашивает другие устройства и не формирует запросы самостоятельно.

===== Цикл «Запрос — Ответ» =====
Работа транспорта в этом режиме организована как обработка входящих запросов:

# '''Ожидание запроса:''' Slave находится в режиме приёма и прослушивает шину (RS-485 или Ethernet).
# '''Приём запроса:''' При получении кадра Slave проверяет, предназначен ли запрос ему (по адресу ведомого).
# '''Проверка целостности:''' Slave вычисляет контрольную сумму (CRC для Modbus-RTU) и проверяет корректность структуры кадра.
# '''Обработка команды:''' Если запрос адресован данному Slave и не содержит ошибок, транспорт выполняет требуемую операцию:
#* '''Чтение:''' извлекает значения из внутренних регистров (например, полученных от виджетов).
#* '''Запись:''' записывает принятые данные в указанные регистры.
# '''Формирование ответа:''' Slave формирует ответный кадр, куда входит: адрес ведомого, код функции и запрошенные данные (для чтения) или подтверждение (для записи).
# '''Отправка ответа:''' Slave передаёт ответ в шину.
# '''Обработка ошибок:''' При обнаружении любой ошибки (неверная контрольная сумма, неверный адрес регистра, неверный код функции) Slave формирует '''кадр исключения''' с соответствующим кодом ошибки или игнорирует запрос (в зависимости от настроек).

===== Управление таймингами =====
В режиме Slave транспорт соблюдает временные параметры, заданные ведущим устройством:

* '''Таймаут ожидания ответа:''' Настраивается на стороне Master. Slave не контролирует время между запросами — он отвечает в рамках разумного времени, определяемого его производительностью.
* '''Межкадровая задержка:''' Slave использует этот интервал (3.5 символа для RTU) для определения границ кадров. Если пауза между байтами превышает 3.5 символа, Slave считает кадр завершённым и начинает его обработку.
* '''Время обработки запроса:''' Slave обрабатывает запрос и отправляет ответ. Задержка между приёмом запроса и отправкой ответа должна быть минимальной (обычно несколько миллисекунд), но допустима в пределах, установленных Master в настройках таймаута.
* '''Пауза перед ответом:''' Для полудуплексных линий (RS-485) Slave перед отправкой ответа выдерживает минимальную технологическую паузу для смены направления передачи.

===== Адресация =====

* Каждый Slave в сети должен иметь '''уникальный адрес''' в диапазоне от 1 до 247. Адрес настраивается в конфигурации транспорта.
* Если пришедший запрос содержит '''широковещательный адрес (0)''', Slave обрабатывает команду (например, запись в регистры), но '''не отправляет ответ'''. В данный момент не поддерживается.
* Запросы, адресованные другому Slave, игнорируются.

===== Обработка ошибок =====
Slave проверяет каждый входящий запрос по следующим критериям:
{| class="wikitable"
!Проверка
!Действие при ошибке
|-
|'''Контрольная сумма (CRC для RTU)'''
|Кадр отбрасывается, ответ не отправляется (Master получит таймаут)
|-
|'''Адрес ведомого'''
|Если адрес не совпадает — кадр игнорируется
|-
|'''Код функции'''
|Если функция не поддерживается — отправляется исключение с кодом <code>0x01</code> (Illegal Function)
|-
|'''Адрес регистра'''
|Если адрес выходит за допустимые пределы — отправляется исключение <code>0x02</code> (Illegal Data Address)
|-
|'''Количество регистров'''
|Если запрашиваемое количество превышает допустимое — отправляется исключение <code>0x03</code> (Illegal Data Value)
|-
|'''Значение данных'''
|Если записываемое значение недопустимо — отправляется исключение <code>0x03</code>
|}
При успешной обработке запроса Slave отправляет '''положительный ответ''' — кадр, содержащий подтверждение выполнения операции или запрошенные данные.

===Оптимизации операций записи в Modbus===

*'''Цель''': уменьшить трафик и задержки и ускорить достижение согласованного состояния на устройстве.
*'''Область применения''': операции записи функций 5/6/15/16; чтение не оптимизируется.

==== Модель команды и терминология====

*'''Что содержит команда''': идентификатор устройства (<code>Slave ID</code>), номер функции (<code>func</code>), адрес или диапазон адресов, и полезную нагрузку (значения для записи).
**Для функций 5 и 6 записывается один адрес.
**Для функций 15 и 16 может записываться непрерывный диапазон адресов.
*При сравнении двух команд '''одинаковыми командами''' считаются те, у которых полностью совпадают <code>Slave ID</code>, функция и адрес регистра.
*'''Смежными диапазонами''' являются диапазоны, между которыми нет разрыва — один начинается сразу после другого. Примеры: смежные — <code>1..4</code> и <code>5..8</code>; <code>10..10</code> и <code>11..15</code>. Не смежные — <code>1..4</code> и <code>6..8</code> (разрыв), <code>3..7</code> и <code>5..9</code> (перекрытие).
*'''Неподтверждённой записью''', является та, которая находится в очереди и ещё не была отправлена драйвером на устройство.

====Этап 1. Дедупликация при постановке в очередь ====

*'''Назначение''': убрать лишние повторные записи одного и того же адреса, если между ними не было попытки отправки на устройство.
*'''Принцип дедупликации''': Если в очереди уже есть неподтверждённая запись для того же <code>Slave ID</code>, той же функции и того же адреса, то новая запись заменяет значение в существующей, а сама в очередь не добавляется.
*'''Что не дедуплицируется''':
**Разные адреса, разные функции или разные устройства.
**Операции чтения.
**Объединение диапазонов — отдельный механизм (см. Этап 2).
*'''Эффект''':
**Снижается нагрузка на канал и устройство при частых обновлениях одного тега.
**В устройство уходит самое свежее значение на момент отправки.

==== Этап 2. Объединение команд записи (функции 15 и 16)====

*'''Назначение''': сократить число запросов, объединив записи в соседние адреса в один непрерывный блок.
*'''Что объединяется''':
**Функция 15 (Write Multiple Coils): катушки с непрерывными адресами.
**Функция 16 (Write Multiple Registers): регистры хранения с непрерывными адресами.
**Только записи с одинаковыми <code>Slave ID</code> и одинаковой функцией (15 или 16).
*'''Условия объединения''': Несколько записей с одинаковыми <code>Slave ID</code> и функцией 15 или 16, чьи адресные диапазоны идут подряд без разрывов, объединяются в одну запись с общим диапазоном от минимального до максимального адреса.
*'''Формирование буфера значений''':
**Для 15: формируется массив булевых значений по адресам в объединённом диапазоне.
**Для 16: формируется массив 16-битных слов по адресам в объединённом диапазоне.
***32-битные типы (Int32/UInt32/Float32) занимают два 16-битных слова.
*** Соблюдается заданный порядок слов (Normal/Inverse).
**Если для одного адреса есть несколько кандидатов, берётся самое свежее значение на момент отправки.
*'''Порядок и атомарность''':
**Адреса в блоке упорядочиваются по возрастанию.
**Отправка выполняется одной операцией: <code>writeCoils</code> (15) или <code>writeRegisters</code> (16).
**Логирование отражает одну агрегированную запись.
*'''Что не объединяется''':
**Разные <code>Slave ID</code> или разные функции (15 и 16 не смешиваются).
**Диапазоны с разрывами.
**Операции чтения и иные типы команд.

====Ограничения====

#Ограничение длины кадра устройства/драйвера может приводить к разбиению больших блоков.
#Объединение выполняется на этапе подготовки к отправке; до него действует дедупликация.
# При ошибке статусы возвращаются для всей агрегированной операции, повторы — по общей логике.

====Примеры====

*'''Дедупликация''':
**Три записи в один регистр: 10 → 20 → 30. В очереди остаётся одна запись; отправляется значение 30.
**Две записи в разные регистры: обе будут отправлены независимо.
**Записи в один адрес, но с разными функциями (например, 5 и 15): считаются разными и отправляются раздельно.
*'''Объединение 15/16''':
**Функция 16: записи 40010..40011 и 40012 объединяются в 40010..40012 и уходят одной операцией.
**Функция 15: записи катушек 1..4 и 5..8 объединяются в 1..8 и отправляются одной операцией.
{{Шаблон:AgavaSCADA_плагин_OPC_UA}}
{{Шаблон:AgavaSCADA_плагин_SNMP}}

[[Категория:AgavaSCADA/AgavaPLC]]

Транспорты AgavaSCADA/AgavaPLC

2026-04-10T08:40:40Z

TaushkanovKV: /* Режимы работы транспорта */

Класс SystemAlarming

2026-04-10T08:36:36Z

TaushkanovKV:

[[Категория:AgavaSCADA/AgavaPLC]]
Класс SystemAlarming представляет собой узел типа <code>Система тревог</code>.

Класс доступен в версии <code>AS 1.6.34+</code>

Предок: [[Описание базовых классов AgavaSCADA/AgavaPLC#BasicNode|BasicNode]].

=== 4.1 Методы ===
'''void SystemAlarming::AcknowledgeAll()''' ///< Квитирование всех активных тревог
Метод выполняет квитирование всех активных тревог, отображаемых в окне тревог.

Результат - <code>void</code>.

Пример:

void FunctionCpp()
{
static SystemAlarming@ sysal = SystemAlarming("/Project/Station/SystemAlarming");

sysal.AcknowledgeAll();
}

Транспорты AgavaSCADA/AgavaPLC

2026-04-10T08:22:17Z

TaushkanovKV: /* Режимы работы транспорта */

Файл:AgavaPLC-Схема работы Modbus slave.png

2026-04-10T08:21:58Z

TaushkanovKV:

AgavaPLC-Схема работы Modbus slave

Транспорты AgavaSCADA/AgavaPLC

2026-04-10T08:18:16Z

TaushkanovKV: /* Транспорты Modbus-RTU, Modbus-TCP */

Транспорты AgavaSCADA/AgavaPLC

2026-04-10T08:13:30Z

TaushkanovKV: /* Транспорты Modbus-RTU, Modbus-TCP */

==Транспорты Modbus-RTU, Modbus-TCP==
Данные виды транспортов предназначены для приема и передачи данных по протоколу Modbus. Поддерживаются последовательные и Ethernet подключения, а также [[Транспорты AgavaSCADA/AgavaPLC#Оптимизации операций записи в Modbus|некоторые оптимизации команд записи]].
===Узлы===
*<code>Транспорт Modbus-RTU</code> - транспорт, работающий по последовательным линиям связи.
*<code>Транспорт Modbus-TCP</code> - транспорт, работающий по ethernet.
*<code>Modbus регистр</code> - источник, хранящий значение регистра.
====Транспорт Modbus-RTU====
Узел, представляющий транспорт Modbus, работающий по последовательным линиям связи RS-485, RS-422, RS-232.
=====Доступные дочерние узлы=====
*Группа узлов.
*Modbus регистр.
=====Свойства=====

==== Транспорт Modbus-TCP ====
Узел, представляющий транспорт Modbus, работающий по линиям связи Ethernet.
=====Доступные дочерние узлы=====
*Группа узлов.
*Modbus регистр.
=====Свойства=====

==== Modbus регистр ====
Узел-источник, хранящий значение регистра.

===== Доступные дочерние узлы =====
Нет

=====Свойства=====
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Доступ
!Описание
|-
|Устройство
|DeviceAddr
|INT
|Чтение / запись
|
|-
|Функция чтения
|ReadFunction
|INT
|Чтение / запись
|
|-
|Регистр чтения
|ReadRegister
|INT
|Чтение / запись
|
|-
|Размер регистра
|ParamSize
|INT
|Чтение / запись
|
|-
|Приоритет
|Priority
|INT
|Чтение / запись
|
|-
|Функция записи
|WriteFunction
|INT
|Чтение / запись
|
|-
|Регистр записи
|WriteRegister
|INT
|Чтение / запись
|
|-
|Тип значения
|ValueType
|INT
|Чтение / запись
|
|-
|Порядок байт
|ByteOrder
|INT
|Чтение / запись
|
|-
|Операции после чтения
|OperationsOnRead
|NODESARRAY
|Чтение / запись
|
|-
|Операции перед записью
|OperationsOnWrite
|NODESARRAY
|Чтение / запись
|
|-
|Узел для чтения/записи
|SourceId
|NODE
|Чтение / запись
|
|}Устройство

Функция чтения

Регистр чтения

Размер регистра

Приоритет

Функция записи

Регистр записи

Тип значения

Порядок байт

Операции после чтения

Операции перед записью

Узел для чтения/записи

=== Режимы работы транспорта ===

==== Режим Master (ведущий) ====
[[Файл:AgavaPLC-Cхема работы Modbus мастера.png|мини|Cхема работы Modbus мастера]]
Схема работы транспорта в режиме Master приведена на схеме.

==== Режим Slave (ведомый) ====

=== Оптимизации операций записи в Modbus ===

* '''Цель''': уменьшить трафик и задержки и ускорить достижение согласованного состояния на устройстве.
* '''Область применения''': операции записи функций 5/6/15/16; чтение не оптимизируется.

==== Модель команды и терминология ====

* '''Что содержит команда''': идентификатор устройства (<code>Slave ID</code>), номер функции (<code>func</code>), адрес или диапазон адресов, и полезную нагрузку (значения для записи).
** Для функций 5 и 6 записывается один адрес.
** Для функций 15 и 16 может записываться непрерывный диапазон адресов.
* При сравнении двух команд '''одинаковыми командами''' считаются те, у которых полностью совпадают <code>Slave ID</code>, функция и адрес регистра.
* '''Смежными диапазонами''' являются диапазоны, между которыми нет разрыва — один начинается сразу после другого. Примеры: смежные — <code>1..4</code> и <code>5..8</code>; <code>10..10</code> и <code>11..15</code>. Не смежные — <code>1..4</code> и <code>6..8</code> (разрыв), <code>3..7</code> и <code>5..9</code> (перекрытие).
* '''Неподтверждённой записью''', является та, которая находится в очереди и ещё не была отправлена драйвером на устройство.

==== Этап 1. Дедупликация при постановке в очередь ====

* '''Назначение''': убрать лишние повторные записи одного и того же адреса, если между ними не было попытки отправки на устройство.
* '''Принцип дедупликации''': Если в очереди уже есть неподтверждённая запись для того же <code>Slave ID</code>, той же функции и того же адреса, то новая запись заменяет значение в существующей, а сама в очередь не добавляется.
* '''Что не дедуплицируется''':
** Разные адреса, разные функции или разные устройства.
** Операции чтения.
** Объединение диапазонов — отдельный механизм (см. Этап 2).
* '''Эффект''':
** Снижается нагрузка на канал и устройство при частых обновлениях одного тега.
** В устройство уходит самое свежее значение на момент отправки.

==== Этап 2. Объединение команд записи (функции 15 и 16) ====

* '''Назначение''': сократить число запросов, объединив записи в соседние адреса в один непрерывный блок.
* '''Что объединяется''':
** Функция 15 (Write Multiple Coils): катушки с непрерывными адресами.
** Функция 16 (Write Multiple Registers): регистры хранения с непрерывными адресами.
** Только записи с одинаковыми <code>Slave ID</code> и одинаковой функцией (15 или 16).
* '''Условия объединения''': Несколько записей с одинаковыми <code>Slave ID</code> и функцией 15 или 16, чьи адресные диапазоны идут подряд без разрывов, объединяются в одну запись с общим диапазоном от минимального до максимального адреса.
* '''Формирование буфера значений''':
** Для 15: формируется массив булевых значений по адресам в объединённом диапазоне.
** Для 16: формируется массив 16-битных слов по адресам в объединённом диапазоне.
*** 32-битные типы (Int32/UInt32/Float32) занимают два 16-битных слова.
*** Соблюдается заданный порядок слов (Normal/Inverse).
** Если для одного адреса есть несколько кандидатов, берётся самое свежее значение на момент отправки.
* '''Порядок и атомарность''':
** Адреса в блоке упорядочиваются по возрастанию.
** Отправка выполняется одной операцией: <code>writeCoils</code> (15) или <code>writeRegisters</code> (16).
** Логирование отражает одну агрегированную запись.
* '''Что не объединяется''':
** Разные <code>Slave ID</code> или разные функции (15 и 16 не смешиваются).
** Диапазоны с разрывами.
** Операции чтения и иные типы команд.

==== Ограничения ====

# Ограничение длины кадра устройства/драйвера может приводить к разбиению больших блоков.
# Объединение выполняется на этапе подготовки к отправке; до него действует дедупликация.
# При ошибке статусы возвращаются для всей агрегированной операции, повторы — по общей логике.

==== Примеры ====

* '''Дедупликация''':
** Три записи в один регистр: 10 → 20 → 30. В очереди остаётся одна запись; отправляется значение 30.
** Две записи в разные регистры: обе будут отправлены независимо.
** Записи в один адрес, но с разными функциями (например, 5 и 15): считаются разными и отправляются раздельно.
* '''Объединение 15/16''':
** Функция 16: записи 40010..40011 и 40012 объединяются в 40010..40012 и уходят одной операцией.
** Функция 15: записи катушек 1..4 и 5..8 объединяются в 1..8 и отправляются одной операцией.
{{Шаблон:AgavaSCADA_плагин_OPC_UA}}
{{Шаблон:AgavaSCADA_плагин_SNMP}}

[[Категория:AgavaSCADA/AgavaPLC]]

Файл:AgavaPLC-Cхема работы Modbus мастера.png

2026-04-10T08:12:33Z

TaushkanovKV:

AgavaPLC-Cхема работы Modbus мастера

Класс SystemAlarming

2026-04-10T06:38:29Z

TaushkanovKV: /* 4.1 Методы */

[[Категория:AgavaSCADA/AgavaPLC]]
Класс SystemAlarming представляет собой узел типа <code>Система тревог</code>.

Класс доступен в версии <code>AS 1.6.34+</code>

Предок: [[Описание базовых классов AgavaSCADA/AgavaPLC#BasicNode|BasicNode]].

=== 4.1 Методы ===
'''void SystemAlarming::AcknowldgeAll()''' ///< Квитирование всех активных тревог
Метод выполняет квитирование всех активных тревог, отображаемых в окне тревог.

Результат - <code>void</code>.

Класс SystemAlarming

2026-04-10T06:21:05Z

TaushkanovKV:

[[Категория:AgavaSCADA/AgavaPLC]]
Класс SystemAlarming представляет собой узел типа <code>Система тревог</code>.

Класс доступен в версии <code>AS 1.6.34+</code>

Предок: [[Описание базовых классов AgavaSCADA/AgavaPLC#BasicNode|BasicNode]].

=== 4.1 Методы ===
'''void AcknowldgeAll()''' ///< Квитирование всех активных тревог
Метод выполняет квитирование всех активных тревог, отображаемых в окне тревог.

Результат - <code>void</code>.

Класс SystemAlarming

2026-04-10T06:17:44Z

TaushkanovKV: Создана пустая страница

ASLauncher

2026-04-08T10:06:23Z

TaushkanovKV:

ASLauncher - менеджер рабочего стола AgavaSCADA.

ASLauncher предназначен для использования совместно со средой исполнения и позволяет заменить собой штатную оболочку Windows.

ASLauncher реализует следующие функции:

* автозапуск AgavaSCADA;
* замена рабочего стола Windows;
* программный сторожевой таймер.

== Автозапуск AgavaSCADA ==
Для настройки автозапуска AgavaSCADA при включении компьютера можно воспользоваться штатными функциями операционной системы Windows, либо использовать утилиту ASLauncher, способную выполнять автозапуск AgavaSCADA и позволяющую заменить стандартную оболочку Windows.

== Замена оболочки рабочего стола Windows 10 ==
Для настройки ASLauncher в качестве оболочки рабочего стола Windows 10 необходимо внести изменения в реестр операционной системы. Вызовем стандартную утилиту '''«Редактор реестра»''' с помощью сочетания клавиш <code>Win + R</code>, указав в качестве выполняемой программы <code>regedit</code>.

'''Внимание:''' Перед внесением изменений в реестр рекомендуется создать резервную копию.

=== Настройка автозапуска ASLauncher ===

# Чтобы ASLauncher автоматически запускался при старте операционной системы, необходимо добавить соответствующую запись в реестр. В '''«Редакторе реестра»''' перейдите в папку: <code>Компьютер\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run</code>
# В правой части окна нажмите правой кнопкой мыши и выберите '''«Создать»''' → '''«Строковый параметр»'''. Присвойте ему имя <code>ASLauncher</code>.
# Для созданного параметра необходимо указать путь до исполняемого файла. Нажмите правой кнопкой мыши на записи <code>ASLauncher</code> и выберите пункт '''«Изменить...»'''. В поле '''«Значение»''' введите полный путь до исполняемого файла (например, <code>C:\AgavaSCADA-1.2\bin\aslauncher.exe</code>).

=== Установка ASLauncher в качестве стандартной оболочки рабочего стола ===

# Чтобы сделать ASLauncher оболочкой рабочего стола по умолчанию, в '''«Редакторе реестра»''' перейдите в папку: <code>Компьютер\HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\Winlogon</code>
# Найдите параметр <code>Shell</code> (по умолчанию его значение — <code>explorer.exe</code>). Если такого параметра нет, создайте новый '''«Строковый параметр»''' с именем <code>Shell</code>.
# Нажмите дважды на параметре <code>Shell</code> и замените его значение на полный путь до исполняемого файла ASLauncher (например, <code>C:\AgavaSCADA-1.2\bin\aslauncher.exe</code>).

=== Отключение Error Reporting ===

# Для отключения отправки отчетов об ошибках, в '''«Редакторе реестра»''' перейдите к следующему разделу: <code>Компьютер\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting</code>
# В правой части окна найдите параметр <code>Disabled</code> типа <code>DWORD (32-бит)</code>. Если такого параметра нет, создайте его, нажав правой кнопкой мыши, выбрав '''«Создать»''' → '''«Параметр DWORD (32 бита)»''' и присвоив ему имя '''Disabled'''.
# Дважды щелкните по параметру <code>Disabled</code> и установите значение '''1''' в поле '''«Значение»'''. Нажмите '''«ОК»''' для сохранения изменений.

=== Примечание ===

# После внесения всех изменений перезагрузите компьютер, чтобы они вступили в силу.
# В результате замены стандартной оболочки рабочего стола Windows на ASLauncher, для пользователя блокируются все штатные функции Windows — запуск установленных программ, все операции с файлами на дисках и т. д. ASLauncher предоставляет пользователю собственный рабочий стол со следующими функциями:
#* Запуск среды исполнения.
#* Перезагрузка и выключение АРМ.
#* Просмотр текущей даты и времени.
#* Запуск штатной оболочки Windows.

=== Отключение ASLauncher как оболочки рабочего стола Windows 10 ===

== Конфигурирование ASLauncher, версия 1.2 ==
Все настройки ASLauncher хранятся в файле aslauncher.ini, размещаемом в папке с исполняемыми файлами AgavaSCADA.

Пример содержимого файла приведен ниже:
[General]
ProcessFile="C:/AavaSCADA-1.2/bin/rtu.exe"
Wallpaper="C:/Images/wallpaper.png"

=== Описание параметров и значений <code>.ini</code> файла ===
Секция <code>[General]</code> содержит основные настройки приложения.
* Параметр<code>Wallpaper</code>
**'''Описание''': Задает путь к изображению, используемому в качестве обоев рабочего стола.
**'''Тип''': Файл.
**'''Формат''': Абсолютный путь.
**'''Пример значения''': <code>Wallpaper="C:/Images/wallpaper.png"</code>

* Параметр<code>ProcessFile</code>
**'''Описание''': Задает путь до исполняемого файла (обычно rtu.exe), запускаемого при старте ASLauncher.
**'''Тип''': Файл.
**'''Формат''': Абсолютный путь.
**'''Пример значения''': <code>ProcessFile="C:/AavaSCADA-1.2/bin/rtu.exe"</code>

== Конфигурирование ASLauncher, версия 1.5 ==

=== Описание конфигурационного файла и его параметров ===
Данный раздел описывает структуру и назначение конфигурационного файла формата <code>.ini</code>, используемого в нашем приложении. Этот файл содержит настройки для обоев рабочего стола и путей к лог-файлам приложения и связанных процессов.

==== Общая структура <code>.ini</code> файла ====
Файл <code>.ini</code> состоит из разделов и пар параметр-значение:

* '''Разделы''': обозначаются названием в квадратных скобках, например, <code>[General]</code>.
* '''Параметры и значения''': пары вида <code>Параметр=Значение</code>, определяющие настройку.

Образец общей структуры <code>.ini</code> файла:
[SectionName]
Key1=Value1
Key2=Value2

==== Описание параметров и значений <code>.ini</code> файла ====
Секция <code>[General]</code> содержит основные настройки приложения.

* Параметр<code>Wallpaper</code>
**'''Описание''': Задает путь к изображению, используемому в качестве обоев рабочего стола.
** '''Тип''': Файл.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>Wallpaper=/home/user/Images/wallpaper.png</code>

* Параметр<code>ProcessErrorLogFile</code>
**'''Описание''': Указывает путь к файлу, в который записываются ошибки основного процесса приложения.
** '''Тип''': Файл.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>ProcessErrorLogFile=/var/log/rtu/rtu_process_error.log</code>

* Параметр<code>ProcessStandardLogFile</code>
**'''Описание''': Указывает путь к файлу, в который записывается стандартный вывод основного процесса приложения.
** '''Тип''': Файл.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>ProcessStandardLogFile=/var/log/rtu/rtu_process_standard.log</code>

* Параметр<code>ASLauncherLogsDir</code>
**'''Описание''': Задает директорию для хранения файлов логирования ASLauncher и приложений рабочего стола.
** '''Тип''': Директория.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>ASLauncherLogsDir=/var/log/aslauncher</code>
* Параметр<code>DesktopEntriesDir</code>
**'''Описание''': Задает директорию, в которой хранятся файлы записей рабочих столов (Desktop Entries) в формате <code>.desktop</code>. Эти файлы используются для запуска приложений и отображения их в меню или на панели запуска.
** '''Тип''': Директория.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>DesktopEntriesDir=/usr/share/aslauncher</code>

==== Примечание ====

* Все описанные параметры, за исключением <code>Wallpaper</code>, являются обязательными и должны иметь корректные значения для запуска и штатной работы программы. Параметр <code>Wallpaper</code> является необязательным и в случае его отсутствия фон рабочего стола будет залит черным цветом.

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

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

=== Документация для <code>.desktop</code> файлов ===
Файлы с расширением <code>.desktop</code> используются для описания приложений и их поведения в системе. Они позволяют интегрировать приложения в графическую оболочку, определяя, как они отображаются на рабочем столе, какие иконки используют, и как запускаются.

==== Общая структура <code>.desktop</code> файла ====
Файл состоит из секции <code>[Desktop Entry]</code> и набора ключей с соответствующими значениями. Пример файла:
[Desktop Entry]
Name=MyApp
Process=/usr/bin/myapp
Arguments=--mode test
Icon=/usr/share/icons/myapp.png
Type=Application
AutoLaunch=true
AutoRestartOnCrash=true
User=myuser
PasswordPrompt=false

==== Примечания ====

* Для некоторых параметров используются значения типа 'Логическое значение'. Возможные варианты значений для данного типа: <code>true</code>, <code>True</code> или <code>1</code> — для истинных значений и <code>false</code>, <code>False</code> или <code>0</code> — для ложных.
* Параметры и значения чувствительны к регистру — убедитесь, что вы используете правильный регистр для каждого ключа.
* Убедитесь, что все указанные пути существуют и доступны для чтения/запуска.
* Если иконка не отображается, значит, по меньшей мере одна пара параметр-значение содержит ошибку. Чтобы исправить это, проверьте файлы логирования ASLauncher — информация, которая поможет выявить и исправить эту ошибку, будет отображена там.

==== Описание ключей и значений <code>.desktop</code> файла ====

# Параметр<code>Name</code>
#*'''Описание''': Отображаемое имя приложения в меню или панели запуска.
#* '''Формат''': Строка.
#* '''Пример значения''': <code>Name=MyApp</code>
# Параметр<code>Process</code>
#*'''Описание''': Путь к исполняемому файлу приложения.
#* '''Формат''': Абсолютный путь.
#* '''Пример значения''': <code>Process=/usr/bin/myapp</code>
# Ключ <code>Arguments</code>
#* '''Описание''': Аргументы командной строки, передаваемые приложению при запуске.
#* '''Формат''': Строка с аргументами, разделенными пробелами.
#* '''Пример значения''': <code>Arguments=--mode test --verbose</code>
# Параметр<code>Icon</code>
#*'''Описание''': Путь к файлу иконки или имя иконки из темы значков.
#* '''Формат''': Абсолютный путь.
#* '''Пример значения''': <code>Icon=/usr/share/icons/hicolor/48x48/apps/myapp.png</code>
# Параметр<code>Type</code>
#*'''Описание''': Тип записи, определяет, как система будет обрабатывать файл.
#* '''Возможные значения''': <code>Application</code> — исполняемое приложение.
#* '''Пример значения''': <code>Type=Application</code>
# Параметр<code>AutoLaunch</code>
#*'''Описание''': Указывает, должно ли приложение запускаться автоматически при входе пользователя в систему.
#* '''Формат''': Логическое значение.
#* '''[Если] Параметр отсутствует''': Значение по умолчанию — <code>false</code>
#* '''Пример значения''': <code>AutoLaunch=true</code>
# Параметр<code>AutoRestartOnCrash</code>
#*'''Описание''': Определяет, будет ли приложение автоматически перезапущено в случае сбоя или аварийного завершения.
#* '''Формат''': Логическое значение.
#* '''[Если] Параметр отсутствует''': Значение по умолчанию — <code>false</code>
#* '''Пример значения''': <code>AutoRestartOnCrash=true</code>
# Параметр<code>User</code>
#*'''Описание''': Имя пользователя, от имени которого должно запускаться приложение.
#* '''Формат''': Строка.
#* '''[Если] Параметр отсутствует''': Приложение запускается из-под пользователя <code>root</code>.
#* '''Пример значения''': <code>User=john_doe</code>
# Параметр<code>PasswordPrompt</code>
#*'''Описание''': Указывает, необходимо ли запрашивать пароль при запуске приложения.
#* '''Формат''': Имя пользователя, пароль аккаунта которого должен быть введён.
#* '''Возможные значения''': <code>default</code> — будет запрошен пароль <code>123asd890</code>.
#* '''[Если] Параметр отсутствует:''' Пароль не запрашивается.
#* '''Пример значения''': <code>PasswordPrompt=default</code>

== Дополнительные утилиты ==
Данные утилиты доступны с версии <code>AS 1.5+</code>

=== Конфигуратор системы - SystemConfigurator ===
Утилита предназначена для настройки параметров системы, на которой работает среда исполнения AgavaSCADA:

* Системные дата и время.
* Параметры основного сетевого адаптера.

=== Утилита обновления проекта - UpdateManager ===
Утилита предназначена для обновления проекта, загружаемого средой исполнения.
[[Категория:AgavaSCADA/AgavaPLC]]

Описание базовых классов AgavaSCADA/AgavaPLC

2026-04-07T03:54:25Z

TaushkanovKV: TaushkanovKV переименовал страницу Описание базовых классов AgavaSCADA/AgavaPLC в Базовые классы AgavaSCADA/AgavaPLC

#перенаправление [[Базовые классы AgavaSCADA/AgavaPLC]]

Базовые классы AgavaSCADA/AgavaPLC

2026-04-07T03:54:25Z

TaushkanovKV: TaushkanovKV переименовал страницу Описание базовых классов AgavaSCADA/AgavaPLC в Базовые классы AgavaSCADA/AgavaPLC

В данном документе описываются свойства, поля и методы базовых классов AgavaPLC/AgavaSCADA, взаимодействие с которыми доступно в функциях, классах и программах приложений.
[[Файл:Иерархия классов объектной модели AgavaPLC 1.6.png|альт=|мини|Иерархия классов объектной модели AgavaPLC 1.6]]
Данный документ применим к AgavaSCADA/AgavaPLC версии 1.5 и старше (новее).

==BasicNode==
Базовый класс для всех узлов проекта.

Предок: нет.

=== Конструкторы ===
BasicNode::BasicNode() ///< Конструктор по умолчанию
BasicNode::BasicNode(string path) ///< Создание узла по пути в проекте

===Методы===
string BasicNode::GetName() ///< Получение имени узла
string BasicNode::GetShortName() ///< Получение шифра узла
string BasicNode::GetDescription() ///< Получение описания узла

void BasicNode::SetName(string name)
void BasicNode::SetShortName(string shortname)
void BasicNode::SetDescription(string description)

string BasicNode::GetPath() ///< Получение пути узла в проекте

void BasicNode::Start() ///< Запуск узла
void BasicNode::Stop() ///< Остановка узла

NodeProperty@ BasicNode::GetProperty(string& prop) ///< Получение указателя на свойство узла
void BasicNode::PropertyValueUpdated(string& prop) ///< Сигнализация об обновлении значения свойства

=== Свойства ===
{|style="width:75%" class="wikitable"
|+
!style="width:15%"|Имя
!style="width:25%"|Описание
!style="width:10%"|Тип
!style="width:15%"|Доступ
!Внутренний идентификатор
|-
|Id
|Идентификатор узла
|int
|Чтение/Запись
|CONFIGNODE_PARAM_ID
|-
|Name
|Имя узла
|string
|Чтение/Запись
|CONFIGNODE_PARAM_NAME
|-
|Description
|Описание узла
|string
|Чтение/Запись
|CONFIGNODE_PARAM_DESCRIPTION
|-
|ShortName
|Шифр узла
|string
|Чтение/Запись
|CONFIGNODE_PARAM_SHORTNAME
|-
|NodeDisabled
|Узел выключен
|bool
|Чтение/Запись
|CONFIGNODE_PARAM_DISABLED
|}

==SignalValue==
Класс, хранящий значение, передаваемое между узлами.

Предок: нет.

=== Конструкторы ===
SignalValue::SignalValue(string value)
SignalValue::SignalValue(int value)
SignalValue::SignalValue(double value)
SignalValue::SignalValue(bool value)

===Методы===
string SignalValue::ToString() ///< Преобразовать значение в строку
int SignalValue::ToInt() ///< Преобразовать значение в int
double SignalValue::ToDouble() ///< Преобразовать значение в double
bool SignalValue::ToBool() ///< Преобразовать значение в bool

void SignalValue::SetValue(string& value)
void SignalValue::SetValue(int value)
void SignalValue::SetValue(double value)
void SignalValue::SetValue(bool value)

bool SignalValue::IsNumber() ///< Значение является числовым
bool SignalValue::IsError() ///< Значение является ошибкой

=== Примеры ===
'''void fnIncrementSource(BasicSource_t &source)'''
{
SignalValue sv = source.GetValue();

if (sv.IsNumber() == true)
{
int iVal = sv.ToInt();
iVal++;

sv = SignalValue(iVal);
}
else
{
sv = SignalValue(0);
}

source.SetValue(sv);
}

== NodeProperty ==
Класс, предоставляющий доступ к свойствам узлов.

Предок: нет.

=== Конструкторы ===
NodeProperty::NodeProperty()
NodeProperty::NodeProperty(NodeProperty& other)

===Методы===
string NodeProperty::GetName() ///< Получение имени свойства
string NodeProperty::GetShortName() ///< Получение шифра свойства
string NodeProperty::GetDescription() ///< Получение описания свойства
string NodeProperty::GetTitle() ///< Получение заголовка свойства

string NodeProperty::ToString() ///< Преобразование значения свойства в строку
int NodeProperty::ToInt() ///< Преобразование значения свойства в число типа int
double NodeProperty::ToDouble() ///< Преобразование значения свойства в число типа double
bool NodeProperty::ToBool() ///< Преобразование значения свойства в булевское значение

int NodeProperty::SetValue(string val) ///< Установка значения свойства
int NodeProperty::SetValue(int val) ///< Установка значения свойства
int NodeProperty::SetValue(double val) ///< Установка значения свойства
int NodeProperty::SetValue(bool val) ///< Установка значения свойства

=== Примеры ===
BasicNode node("/Root/node");
NodeProperty@ prop = node.GetProperty("ShortName");

string sn2 = prop.ToString();
prop.SetValue(string(sn2+"ShortName1"));

== BasicSource ==
Предок: [[Описание базовых классов AgavaSCADA/AgavaPLC#BasicNode|BasicNode]].
===Методы===
'''SignalValue BasicSource::GetValue()''' ///< Получение значения.
Метод производит получение значения источника.

Результат - значение типа [[Описание базовых классов AgavaSCADA/AgavaPLC#SignalValue|SignalValue]].

'''int BasicSource::SetValue(SignalValue sv)''' ///< Установка собственного значения с установкой значений связанных узлов (в транспорте).
Метод производит установку нового значения источника. Если источник связан с транспортом, то транспорт выполнит передачу нового значения в связанное с ним внешнее устройство.

Результат - [[Коды ошибок и предупреждений AgavaSCADA/AgavaPLC|код выполнения операции]].

'''int BasicSource::UpdateValue(SignalValue sv)''' ///< Установка собственного значения.
Метод производит установку нового значения источника без передачи значения транспорту.

Результат - [[Коды ошибок и предупреждений AgavaSCADA/AgavaPLC|код выполнения операции]].

==BasicSignal==
Предок: [[#BasicSource|BasicSource]].
===Методы===
'''SignalValue BasicSignal::GetValue()''' ///< Получение значения.
Метод производит получение значения сигнала.

Результат - значение типа [[Описание базовых классов AgavaSCADA/AgavaPLC#SignalValue|SignalValue]].

'''int BasicSignal::SetValue(SignalValue sv)''' ///< Установка собственного значения с установкой значений связанных узлов (источников).
Метод производит установку нового значения сигнала. Если сигнал связан с источником (или несколькими источниками), то будет выполнена передача нового значения в источник(-и).

Результат - [[Коды ошибок и предупреждений AgavaSCADA/AgavaPLC|код выполнения операции]].

'''int BasicSignal::UpdateValue(SignalValue sv)''' ///< Установка собственного значения.
Метод производит установку нового значения источника без передачи значения источнику.

Результат - [[Коды ошибок и предупреждений AgavaSCADA/AgavaPLC|код выполнения операции]].

==ModbusRegister==
Предок: [[#BasicSource|BasicSource]].
===Поля===
uint8 m_ucDeviceNo ///< Номер устройства.
uint8 m_ucReadFunctionNo ///< Номер функции чтения.
uint16 m_wReadRegisterNo ///< Номер регистра чтения.
uint8 m_ucWriteFunctionNo ///< Номер функции записи.
uint16 m_wWriteRegisterNo ///< Номер регистра записи.
uint8 m_ucSize ///< Размер регистра в битах.
uint8 m_ucPriority ///< Приоритет. Не используется.
===Методы===
int BasicSource::WriteValue(SignalValue sv) ///< Установка собственного значения с записью значения в устройство.
==BasicWidget==
Предок: [[Описание базовых классов AgavaSCADA/AgavaPLC#BasicNode|BasicNode]].

Подробное описание обработчиков и методов рисования приведено в документе [[Описание классов для рисования и работы с графическим интерфейсом AgavaSCADA/AgavaPLC]].

===Методы===
void BasicWidget::Repaint() ///< Перерисовка виджета

=== Обработчики ===
void BasicWidget::OnPaint(Painter@ painter) ///< Обработчик отрисовки виджета
void BasicWidget::OnMousePress([[Описание классов для рисования и работы с графическим интерфейсом AgavaSCADA/AgavaPLC#MouseEvent|MouseEvent]]@ event) ///< Обработчик нажатия кнопки мыши
void BasicWidget::OnMouseRelease(MouseEvent@ event) ///< Обработчик отпускания кнопки мыши
void BasicWidget::OnMouseDoubleClick(MouseEvent@ event) ///< Обработчик двойного нажатия кнопки мыши
void BasicWidget::OnMouseMove(MouseEvent@ event) ///< Обработчик перемещения курсора мыши над виджетом
void BasicWidget::OnMouseEnter() ///< Обработчик входа курсора мыши в область над виджетом
void BasicWidget::OnMouseLeave() ///< Обработчик выхода курсора мыши из области над виджетом
void BasicWidget::OnWheel(WheelEvent@ event) ///< Обработчик прокрутки колеса мыши при нахождении курсора мыши в области над виджетом

== BasicWindow ==
Предок: [[Описание базовых классов AgavaSCADA/AgavaPLC#BasicWidget|BasicWidget]].

Подробное описание обработчиков и методов рисования приведено в документе [[Описание классов для рисования и работы с графическим интерфейсом AgavaSCADA/AgavaPLC]].

===Методы===
void BasicWindow::Show() ///< Отображение окна.
void BasicWindow::Hide() ///< Сокрытие окна.
[[Категория:AgavaSCADA/AgavaPLC]]

Описание классов для рисования и работы с графическим интерфейсом AgavaSCADA/AgavaPLC

2026-04-07T03:41:36Z

TaushkanovKV: TaushkanovKV переименовал страницу Описание классов для рисования и работы с графическим интерфейсом AgavaSCADA/AgavaPLC в Классы для рисования и работы с графическим интерфейсом AgavaSCADA/AgavaPLC

#перенаправление [[Классы для рисования и работы с графическим интерфейсом AgavaSCADA/AgavaPLC]]

Классы для рисования и работы с графическим интерфейсом AgavaSCADA/AgavaPLC

2026-04-07T03:41:36Z

== Обзор ==
Данное описание предназначено для использования с системами версии 1.6+. Ниже описываются инструменты, реализующие вывод графических примитивов, инструменты рисования и обработки событий.

== Основные классы и структуры ==

=== Rect ===
Прямоугольная область с координатами и размерами.

'''Конструкторы:'''

* <code>Rect()</code> - пустой прямоугольник
* <code>Rect(int x, int y, int w, int h)</code> - с заданными параметрами

'''Свойства:'''

* <code>int x</code>, <code>int y</code> - координаты верхнего левого угла
* <code>int width</code>, <code>int height</code> - размеры

'''Пример использования:'''
Rect rect(10, 20, 100, 50); // x=10, y=20, width=100, height=50
Rect area = Rect(0, 0, 800, 600);

=== Point ===
Точка в 2D-пространстве.

'''Конструкторы:'''

* <code>Point()</code> - точка (0,0)
* <code>Point(int x, int y)</code> - с заданными координатами

'''Свойства:'''

* <code>int x</code>, <code>int y</code> - координаты

'''Пример использования:'''
Point start(0, 0);
Point end(100, 100);
Point center = Point(50, 50);

=== Color ===
Цвет в формате RGBA.

'''Конструкторы:'''

* <code>Color()</code> - черный непрозрачный
* <code>Color(int r, int g, int b, int a = 255)</code> - с компонентами цвета

'''Свойства:'''

* <code>int r</code>, <code>int g</code>, <code>int b</code> - цветовые компоненты (0-255)
* <code>int a</code> - альфа-канал (0-255), где 255 - полностью непрозрачный

'''Пример использования:'''
Color red(255, 0, 0); // Красный
Color blue(0, 0, 255, 128); // Синий полупрозрачный
Color white(255, 255, 255); // Белый

=== Font ===
Описание шрифта для текста.

'''Конструкторы:'''

* <code>Font()</code> - шрифт по умолчанию
* <code>Font(int size, string name, bool italic = false, bool bold = false, bool underline = false, bool strikethrough = false)</code>

'''Свойства:'''

* <code>int size</code> - размер шрифта
* <code>string name</code> - название шрифта
* <code>bool italic</code> - курсив
* <code>bool bold</code> - жирный
* <code>bool underline</code> - подчеркнутый
* <code>bool strikethrough</code> - зачеркнутый

'''Пример использования:'''
Font defaultFont;
Font titleFont(24, "Arial", false, true); // Жирный Arial 24px
Font italicFont(12, "Times New Roman", true); // Курсивный

=== Pen ===
Инструмент для рисования линий и контуров.

'''Конструкторы:'''

* <code>Pen()</code> - перо по умолчанию
* <code>Pen(int size, Color color, LineType lineType = LineType::Solid)</code>

'''Свойства:'''

* <code>int size</code> - толщина линии
* <code>Color color</code> - цвет
* <code>LineType lineType</code> - тип линии

'''Перечисление LineType:'''

* <code>Undefined</code> - неопределенный тип
* <code>Solid</code> - сплошная линия
* <code>Dash</code> - пунктирная линия
* <code>Dot</code> - точечная линия
* <code>DashDot</code> - штрих-пунктирная
* <code>DashDotDot</code> - штрих-две точки

'''Пример использования:'''
Pen thinRed(1, Color(255, 0, 0), LineType::Solid);
Pen thickBlue(3, Color(0, 0, 255), LineType::Dash);
Pen dottedBlack(2, Color(0, 0, 0), LineType::Dot);

=== ResourceLink ===
Ссылка на ресурсы (изображения, звуковый файлы).

'''Конструкторы:'''

* <code>ResourceLink()</code> - пустая ссылка
* <code>ResourceLink(const string &in path)</code> - из файлового пути
* <code>ResourceLink(const string &in lib, const string &in res)</code> - из библиотеки ресурсов

'''Методы:'''

* <code>string GetFilePath() const</code> - путь к файлу
* <code>string GetFullFilePath() const</code> - полный путь
* <code>string GetLibraryName() const</code> - имя библиотеки
* <code>string GetResourceName() const</code> - имя ресурса
* <code>bool IsValid()</code> - проверка валидности
* <code>bool IsEmpty()</code> - проверка на пустоту
* <code>LinkType GetLinkType() const</code> - тип ссылки
* <code>string ToString()</code> - строковое представление

'''Перечисление LinkType:'''

* <code>Undefined</code> - неопределенный тип
* <code>Resource</code> - ресурс из библиотеки
* <code>File</code> - файл из файловой системы

'''Пример использования:'''
ResourceLink fileImage("images/background.png");
ResourceLink libImage("textures", "wood_pattern");
ResourceLink invalidLink;

if (fileImage.IsValid())
{
string path = fileImage.GetFilePath();
}

=== Gradient ===
Градиентная заливка.

'''Конструкторы:'''

* <code>Gradient()</code> - градиент по умолчанию
* <code>Gradient(GradientType type)</code> - с указанием типа

'''Свойства:'''

* <code>GradientType type</code> - тип градиента
* <code>Point start</code>, <code>Point end</code> - начальная и конечная точки (для линейного)
* <code>Point center</code> - центр (для радиального)
* <code>float radius</code> - радиус (для радиального)
* <code>Point focal</code> - фокальная точка
* <code>Point centerConical</code> - центр конического градиента
* <code>float angle</code> - угол

'''Методы для работы с цветовыми остановками:'''

* <code>void AddColorStop(float position, Color color)</code> - добавить цветовую остановку
* <code>void ClearColorStops()</code> - очистить все остановки
* <code>int GetColorStopCount() const</code> - количество остановок
* <code>void GetColorStop(int index, float& out position, Color& out color) const</code> - получить остановку
* <code>void SetColorStop(int index, float position, Color color)</code> - установить остановку

'''Перечисление GradientType:'''

* <code>Linear</code> - линейный градиент
* <code>Radial</code> - радиальный градиент
* <code>Conical</code> - конический градиент

'''Пример использования:'''
Gradient linearGrad(GradientType::Linear);
linearGrad.start = Point(0, 0);
linearGrad.end = Point(100, 0);
linearGrad.AddColorStop(0.0, Color(255, 0, 0)); // Красный в начале
linearGrad.AddColorStop(1.0, Color(0, 0, 255)); // Синий в конце

Gradient radialGrad(GradientType::Radial);
radialGrad.center = Point(50, 50);
radialGrad.radius = 50;

=== Brush ===
Инструмент заливки.

'''Конструкторы:'''

* <code>Brush()</code> - кисть по умолчанию
* <code>Brush(Color color, BrushStyle style = BrushStyle::SolidPattern)</code> - сплошной цвет
* <code>Brush(Gradient gradient, BrushStyle style = BrushStyle::LinearGradientPattern)</code> - градиент
* <code>Brush(ResourceLink texture, BrushStyle style = BrushStyle::TexturePattern)</code> - текстура

'''Свойства:'''

* <code>BrushStyle style</code> - стиль кисти
* <code>Color color</code> - цвет (для SolidPattern)
* <code>Gradient gradient</code> - градиент
* <code>ResourceLink texture</code> - текстура

'''Перечисление BrushStyle:'''

* '''Сплошные и пустые:''' <code>NoBrush</code>, <code>SolidPattern</code>
* '''Плотность заливки:''' <code>Dense1Pattern</code> - <code>Dense7Pattern</code> (от самой плотной до самой редкой)
* '''Линейные паттерны:''' <code>HorPattern</code> (горизонтальные линии), <code>VerPattern</code> (вертикальные линии), <code>CrossPattern</code> (сетка)
* '''Диагональные паттерны:''' <code>BDiagPattern</code>, <code>FDiagPattern</code>, <code>DiagCrossPattern</code>
* '''Специальные:''' <code>LinearGradientPattern</code>, <code>RadialGradientPattern</code>, <code>ConicalGradientPattern</code>, <code>TexturePattern</code>

'''Пример использования:'''
Brush solidRed(Color(255, 0, 0));
Brush gradientBrush(linearGrad); // Градиентная кисть
Brush textureBrush(textureLink, BrushStyle::TexturePattern);
Brush patternBrush(Color(0, 0, 0), BrushStyle::CrossPattern); // Сетка

=== Alignment ===
Флаги выравнивания текста.

'''Значения:'''

* '''Горизонтальное:''' <code>AlignLeft</code>, <code>AlignRight</code>, <code>AlignHCenter</code>, <code>AlignJustify</code>, <code>AlignAbsolute</code>
* '''Вертикальное:''' <code>AlignTop</code>, <code>AlignBottom</code>, <code>AlignVCenter</code>, <code>AlignBaseline</code>
* '''Комбинированные:''' <code>AlignCenter</code> (центр по горизонтали и вертикали)

'''Пример использования:'''
Alignment leftTop = Alignment::AlignLeft | Alignment::AlignTop;
Alignment center = Alignment::AlignCenter;
Alignment rightBottom = Alignment::AlignRight | Alignment::AlignBottom;

== Класс Painter ==
Основной класс для рисования, предоставляющий широкий набор графических операций.

=== Методы рисования фигур ===
'''Дуги и секторы'''

* <code>DrawArc(const Rect &in, int startAngle, int spanAngle)</code> - дуга в прямоугольнике
* <code>DrawArc(int x, int y, int w, int h, int startAngle, int spanAngle)</code> - дуга с координатами
* <code>DrawChord()</code> - хорда (замкнутая дуга)
* <code>DrawPie()</code> - сектор круга

'''Пример:'''
painter.DrawArc(Rect(10, 10, 100, 100), 45, 90); // Дуга от 45 до 135 градусов
painter.DrawPie(50, 50, 80, 80, 0, 90); // Сектор 90 градусов
'''Эллипсы и окружности'''
* <code>DrawEllipse(const Rect &in)</code> - эллипс в прямоугольнике
* <code>DrawEllipse(int x, int y, int w, int h)</code> - эллипс с координатами
* <code>DrawEllipse(const Point &in center, int rx, int ry)</code> - эллипс из центра

'''Пример:'''
painter.DrawEllipse(Rect(0, 0, 200, 100)); // Эллипс
painter.DrawEllipse(Point(100, 100), 50, 50); // Окружность
'''Линии и точки'''
* <code>DrawLine(int x1, int y1, int x2, int y2)</code> - линия между точками
* <code>DrawLine(const Point &in start, const Point &in end)</code> - линия между точками
* <code>DrawPoint(const Point &in)</code> - точка
* <code>DrawPoint(int x, int y)</code> - точка с координатами

'''Пример:'''
painter.DrawLine(0, 0, 100, 100); // Диагональная линия
painter.DrawLine(Point(10, 10), Point(50, 50)); // Линия между точками
painter.DrawPoint(25, 25); // Точка
'''Прямоугольники'''

* <code>DrawRect(const Rect &in)</code> - прямоугольник
* <code>DrawRect(int x, int y, int w, int h)</code> - прямоугольник с координатами
* <code>DrawRoundedRect(const Rect &in, double xRadius, double yRadius)</code> - скругленный прямоугольник
* <code>DrawRoundedRect(int x, int y, int w, int h, double xRadius, double yRadius)</code> - скругленный с координатами

'''Пример:'''
painter.DrawRect(Rect(10, 10, 100, 50)); // Прямоугольник
painter.DrawRoundedRect(20, 20, 80, 40, 10, 10); // Скругленный прямоугольник
'''Изображения'''

* <code>DrawImage(const Rect &in target, const ResourceLink &in image, const Rect &in source)</code> - изображение с областью
* <code>DrawImage(const Point &in pos, const ResourceLink &in image, const Rect &in source)</code> - изображение в позиции с областью
* <code>DrawImage(const Rect &in target, const ResourceLink &in image)</code> - изображение в прямоугольник
* <code>DrawImage(const Point &in pos, const ResourceLink &in image)</code> - изображение в позиции

'''Пример:'''
ResourceLink img("images/icon.png");
painter.DrawImage(Point(0, 0), img); // Рисуем в позиции (0,0)
painter.DrawImage(Rect(10, 10, 32, 32), img); // Масштабируем в прямоугольник
painter.DrawImage(Rect(0, 0, 64, 64), img, Rect(0, 0, 32, 32)); // Часть изображения
'''Текст'''

* <code>DrawText(const Point &in pos, const string &in text)</code> - текст в позиции
* <code>DrawText(int x, int y, const string &in text)</code> - текст с координатами
* <code>DrawText(const Rect &in rect, int alignment, const string &in text)</code> - текст в прямоугольнике с выравниванием
* <code>DrawText(int x, int y, int w, int h, int alignment, const string &in text)</code> - текст в области с выравниванием

'''Пример:'''
painter.DrawText(Point(10, 10), "Hello World"); // Простой текст
painter.DrawText(Rect(0, 0, 200, 50), Alignment::AlignCenter, "Centered Text"); // Выровненный текст

=== Методы заливки и очистки ===

* <code>EraseRect(const Rect &in)</code> - очистить прямоугольную область
* <code>EraseRect(int x, int y, int w, int h)</code> - очистить область с координатами
* <code>FillRect(const Rect &in, const Brush &in)</code> - залить прямоугольник кистью
* <code>FillRect(int x, int y, int w, int h, const Brush &in)</code> - залить область кистью
* <code>FillRect(const Rect &in, const Color &in)</code> - залить прямоугольник цветом
* <code>FillRect(int x, int y, int w, int h, const Color &in)</code> - залить область цветом

'''Пример:'''
painter.FillRect(Rect(0, 0, 100, 100), Color(255, 0, 0)); // Красный прямоугольник
painter.FillRect(10, 10, 50, 50, gradientBrush); // Градиентная заливка
painter.EraseRect(5, 5, 10, 10); // Очистить область

=== Управление состоянием ===
'''Геттеры и сеттеры стилей'''

* <code>Brush GetBackground()</code>, <code>void SetBackground(const Brush &in)</code> - фон
* <code>Brush GetBrush()</code>, <code>void SetBrush(const Brush &in)</code> - кисть заливки
* <code>Point GetBrushOrigin()</code>, <code>void SetBrushOrigin(const Point &in)</code> - начало координат кисти
* <code>Font GetFont()</code>, <code>void SetFont(const Font &in)</code> - шрифт текста
* <code>Pen GetPen()</code>, <code>void SetPen(const Pen &in)</code> - перо для линий

'''Пример:'''
// Установка стилей
painter.SetPen(Pen(2, Color(0, 0, 0)));
painter.SetBrush(Brush(Color(255, 255, 0)));
painter.SetFont(Font(12, "Arial", false, true));

// Получение текущих стилей
Pen currentPen = painter.GetPen();
Brush currentBrush = painter.GetBrush();

=== Трансформации и clipping ===
'''Трансформации'''

* <code>void ResetTransform()</code> - сброс всех трансформаций
* <code>void Rotate(double angle)</code> - поворот на угол (в градусах)
* <code>void Scale(double sx, double sy)</code> - масштабирование
* <code>void Shear(double sh, double sv)</code> - наклон/скос
* <code>void Translate(const Point &in)</code> - смещение
* <code>void Save()</code>, <code>void Restore()</code> - сохранение/восстановление состояния

'''Clipping (область отсечения)'''

* <code>bool HasClipping()</code> - проверка наличия области отсечения
* <code>void SetClipRect(const Rect &in, int operation = 1)</code> - установка прямоугольной области отсечения
* <code>void SetClipRect(int x, int y, int w, int h, int operation = 1)</code> - установка области с координатами
* <code>void SetClipping(bool enable)</code> - включить/выключить отсечение

'''Пример:'''
// Трансформации
painter.Save(); // Сохраняем состояние
painter.Translate(Point(100, 100)); // Смещаем начало координат
painter.Rotate(45); // Поворачиваем на 45 градусов
painter.Scale(1.5, 1.0); // Масштабируем
// Рисуем трансформированные объекты
painter.Restore(); // Восстанавливаем состояние

// Clipping
painter.SetClipRect(Rect(50, 50, 100, 100)); // Устанавливаем область отсечения
// Все рисование будет обрезано по этой области

=== Вспомогательные методы ===

* <code>bool HasClipping()</code> - проверка наличия clipping
* <code>int GetLayoutDirection()</code>, <code>void SetLayoutDirection(int)</code> - направление layout (LTR/RTL)
* <code>double GetOpacity()</code>, <code>void SetOpacity(double)</code> - прозрачность (0.0-1.0)
* <code>Rect GetBoundingRect(const Rect &in, int alignment, const string &in text)</code> - вычисление ограничивающего прямоугольника для текста
* <code>Rect GetBoundingRect(int x, int y, int w, int h, int alignment, const string &in text)</code> - вычисление с координатами

'''Пример:'''
// Вычисление размера текста
Rect textBounds = painter.GetBoundingRect(Rect(0, 0, 0, 0), Alignment::AlignLeft, "Sample Text");
int textWidth = textBounds.width;
int textHeight = textBounds.height;

// Установка прозрачности
painter.SetOpacity(0.5); // Полупрозрачное рисование

=== Полный пример использования Painter ===
// Создание инструментов
Pen borderPen(2, Color(0, 0, 0), LineType::Solid);
Brush fillBrush(Color(255, 255, 0));
Font textFont(14, "Arial", false, true);

// Настройка painter
painter.SetPen(borderPen);
painter.SetBrush(fillBrush);
painter.SetFont(textFont);

// Рисование
painter.DrawRect(Rect(10, 10, 100, 50)); // Прямоугольник
painter.DrawEllipse(Point(150, 35), 25, 15); // Эллипс
painter.DrawLine(Point(200, 10), Point(250, 60)); // Линия
painter.DrawText(Point(15, 15), "Hello World"); // Текст

// Градиентная заливка
Gradient grad(GradientType::Linear);
grad.start = Point(0, 0);
grad.end = Point(100, 0);
grad.AddColorStop(0.0, Color(255, 0, 0));
grad.AddColorStop(1.0, Color(0, 0, 255));
Brush gradBrush(grad);
painter.SetBrush(gradBrush);
painter.FillRect(Rect(300, 10, 100, 50), gradBrush);

== Обработка событий ==

=== MouseEvent ===
Событие мыши.

'''Методы:'''

* <code>MouseButton button() const</code> - нажатая кнопка
* <code>Point pos() const</code> - позиция курсора
* <code>int x() const</code> - координата X
* <code>int y() const</code> - координата Y

'''Перечисление MouseButton:'''

* <code>NoButton</code> - нет нажатой кнопки
* <code>LeftButton</code> - левая кнопка мыши
* <code>RightButton</code> - правая кнопка мыши
* <code>MiddleButton</code> - средняя кнопка мыши

'''Пример использования:'''
void OnMouseClick(MouseEvent@ event)
{
if (event.button() == MouseButton::LeftButton)
{
Point clickPos = event.pos();
int x = event.x();
int y = event.y();
}
}

=== WheelEvent ===
Событие колесика мыши.

'''Методы:'''

* <code>int angleDelta() const</code> - угол поворота колесика (положительный - вверх, отрицательный - вниз)

'''Пример использования:'''
void OnWheel(WheelEvent@ event)
{
int delta = event.angleDelta();

if (delta > 0)
{
// Прокрутка вверх
}
else
{
// Прокрутка вниз
}
}

[[Категория:AgavaSCADA/AgavaPLC]]

Перечень изменений AgavaSCADA/AgavaPLC 1.6

2026-04-06T06:28:08Z

TaushkanovKV: /* 1.6.33-rc335f5d9dacf от 2026-04-01 */

Основные изменения в сравнении с версией 1.2:

# Добавлена возможность создания программ на языке C++ в соответствии с подходом, описанным в стандарте МЭК 61131-3.
# Продолжение развития объектной модели и возможности разработки программ, начатых в версии <code>AS 1.5</code>. [[Объектная модель AgavaSCADA/AgavaPLC]].
# Добавлена поддержка локального и онлайн (удаленного) отладчика.
# Для редактирования текстов программ, функций и классов внедрен новый, удобный и функциональный текстовый редактор, подобный распространенному VSCode.
# Транспорты MQTT, SNMP, МЭК 60870-5-101, МЭК 60870-5-104 портированы на ПК с ОС Linux x64 и контроллеры АГАВА.
# Реализован новый архиватор в БД PostgreSQL.
# Добавлена поддержка ресурсов и библиотек ресурсов.
# Добавлена Web-визуализация. См. пример <code>MultiImageLabel</code>.
# Разработан ряд примеров, демонстрирующих новые возможности: <code>AIParameter</code>, <code>PIDRegulator</code>, <code>Leds</code>, <code>Wdt</code>, <code>AgavaAnalogInput</code>, <code>WidgetAgavaInput</code>, <code>Pump</code>, <code>MultiImageLabel</code> и другие.
Также запланировано добавление новых возможностей:
# Поддержка языка ST МЭК 61131-3 (Structured text).
# Поддержка распределенных проектов.
# Поддержка сохранения в проекте информации о целевой системе.
# Конфигурирование целевых устройств из проекта.
# Создание расширений для среды разработки с помощью SDK.
Перевод разработанных ранее проектов на актуальную версию описан в документе [[Миграция проектов AgavaSCADA/AgavaPLC]].

== 1.6.33-rc335f5d9dacf от 2026-04-01 ==

=== Узлы ===
# Доработан выполнение алгоритмов C++:
#* Возвращён вызов виртуальных методов BasicSource.
#* Реализована защита от рекурсии в методах BasicSource.
# Доработан класс <code>SignalValue</code> - зарегистрированы конструкторы и методы работы с типами uint64, uint32.
# Доработан узел <code>Транспорт Modbus-TCP</code>:
#* Функция записи по умолчанию установлена на 0.
#* Отключена возможность множественных подключений к транспорту в режиме <code>Сервер</code>.
# Доработан узел <code>Транспорт Modbus-RTU</code> :
#* Функция записи по умолчанию установлена на 0.
#* Восстановлена работа в режиме <code>Сервер</code>.
# Доработан узел <code>Транспорт УПД</code>:
## Исправлена работа со свойством <code>Идентификаторы ведущих</code>.
## Добавлено отслеживание активного подключения в режиме <code>Slave</code>.
# Зарегистрирован класс [[Класс any|any]].
# Доработан узел <code>Retain накопитель</code> - реализована возможность сохранения через задержку.
# Добавлена возможность связывания свойств экземпляров с свойствами других узлов.
# Добавлены типы (u)int64 для связи со свойствами экземпляров.

=== Среда разработки ===

# Исправлена критическая ошибка в команде "Показать в графическом представлении".
# Доработано контекстное меню дерева проекта:
#* Исправлена критическая ошибка в команде "Выделить" для виджетов.
#* Пункт "Выделить" перемещен на уровень выше.
#* Добавлено действие "Выделить" на двойной клик по виджетам.
# Исправлена критическая ошибка, возникавшая при открытии диалога "Настройки" для графиков.
# Устранены назойливые сообщения загрузки плагинов и регистрации узлов при проверке проекта.
# Добавлена возможность восстановления связей между узлами при вставке фрагментов из других проектов.
# Исправлена ошибка многократной установки ошибок в редактор кода, приводившая к сильному замедлению работы при большом количестве открытых окон редактора.
# Реализовано отображение содержимого массивов и указателей (хэндлов) в режиме отладки.
# Добавлены файловые ассоциации на файл проекта для быстрого открытия проекта в среде разработки с помощью двойного клика по .asp файлу.
# '''Отключен вызов сеттеров свойств при установке значений свойств в среде разработки.'''
# Отключено кеширование композиций в среде разработки.
# Исправлена критическая ошибка, возникавшая при установке значения свойства типа <code>string</code> у экземпляра после сборки проекта.
# Доработано контекстное меню дерева проекта и контекстное меню графического предаставления - добавлены иконки элементов контекстного меню <code>Добавить узел</code>, изменен порядок команд для более удобного их использования.
# Изменена горячая клавиша создания проекта на <code>Ctrl+Shift+N</code>.

=== Среда исполнения ===

# Добавлено логгирование для системного и межстанционного транспортов.
# Убрана поддержка IPv6 в системном транспорте и межстанционном транспорте для работы на встраиваемых системах без IPv6.
# Исправлена критическая ошибка в BasicNode, иногда приводившая к крахам при одновременном доступе к объекту из разных задач.

== 1.6.32-r79b12a16bbd7 от 2026-03-05 ==

=== Узлы ===
# Класс <code>WindowForm</code> добавлен в объектную модель.
# Отключена возможность добавления узлов типа <code>Задача ПЛК</code> как устаревшего функционала. Вместо него будет добавлена возможность создавать программы на языках FBD, CFC, SFC.
# Реализовано автоматическое создание конструкторов по умолчанию для классов из ОМ при отсутствии пользовательского.
# Исправлен запуск сигналов.
# Устранены утечки памяти при сохранении проекта в .bin.
# Внутренняя реорганизация обработчиков событий OperationsInput, OperationsOutput в узле <code>Сигнал простой</code>.
# Добавлен TransportModbusRtuIdr2.
# В действии <code>Создание события</code> исправлена работа форматтера <code>$$pd</code>.

=== Среда разработки ===

# Доработан редактор графического представления: добавлена сетка, [[Универсальная среда разработки Agava#.D0.98.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5 .D1.8F.D0.BA.D0.BE.D1.80.D0.B5.D0.B9|линейки, якоря]], функции выравнивания виджетов.
# Исправлена ошибка, вызывавшая двойной вызов обработчиков событий мыши для окон.
# Устранена ошибка, связанная с утечкой памяти при удалении виджетов.
# Добавлено приветственное окно со списком последних открытых проектов и таблицей примеров.
# Исправлена некритическая ошибка, возникавшая при закрытии фрейма.

=== Среда исполнения ===

# Устранена ошибка, связанная с утечкой памяти при закрытии окна с кешированными композициями.

== 1.6.31-rac6da98668fb от 2025-12-26 ==

=== Примеры ===
# Добавлен пример <code>Controllers/PLC70_Submodules</code>.

== 1.6.31-r9e81e0333260 от 2025-12-25 ==

=== Узлы ===

# Добавлена возможность создания конструкторов вида Classname(const string &in path) в дереве.
# Исправлена ошибка в вызове обработчика <code>OnWheel</code> у виджетов.
# Доработан узел <code>Корзина субмодулей</code>:
#* Уменьшено время ожидания ответа субмодуля с 1000 мс до 25 мс.
#* Реализована поддержка слотов G/H/I/K для ПЛК-70.
#* Реализовано создание узлов для каналов субмодулей в дереве проекта. '''Обратите внимание, проекты, использующие прежнюю структуру субмодулей, не совместимы с версией AgavaSCADA/AgavaPLC 1.6.31!'''
#* Исправлена валидация слотов на уровне субмодуля. Добавлена проверка на занятость одного слота несколькими субмодулями с формированием сообщения об ошибке.
# Доработаны узлы <code>Станция ПК-40</code>, <code>Станция ПК-50</code>, <code>Станция ПК-60</code>, <code>Станция ПК-70</code>:
#* Добавлено ограничение значений подсветки экрана и индикаторов, добавлена валидация соответствующих свойств узлов.
#* Реализована установка яркости подсветки экрана и состояния светодиодов согласно настроек в проекте.
# Доработан транспорт OPC UA:
#* Добавлена поддержка типа double.
#* Устранены критические ошибки при повторном запуске транспорта и при записи в read-only тэги.
#* Добавлено уведомление пользователя о некорректных тэгах.
# Доработан виджет <code>Ввод значения</code>: исправлено форматирование значений типа double - число знаков после запятой теперь зависит от шага значения.

=== Среда разработки ===

# Устранена потенциальная ошибка сохранения проекта при открытии в проводнике папки с проектом.
# Изменен мастер создания проектов: для проектов для <code>ПЛК-70.А</code>, создаваемых с помощью мастера, используется узел <code>Станция ПК-70</code> вместо <code>Станция ПК-40</code> в предыдущей версии.

=== Среда исполнения ===

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

== 1.6.30-rb3d3b577ed29 от 2025-12-05 ==

=== Ядро ===

# Исправлена работа системного транспорта: устранена ошибка взаимодействия с другими станциями.

=== Узлы ===

# Исправлена ошибка с обработкой вложенных групп в узле типа <code>Приложение</code>.
# Доработан класс <code>NodeProperty</code>: изменена регистрация класса, устранены критические ошибки.

=== Среда разработки ===

# Доработано редактирование свойств типа <code>ValueLink</code>: добавлен сброс значения, позволяющий удалить ранее установленное значение.
# Доработан редактирование свойств типа <code>NodeLink</code>: исправлена ошибка при работе с узлами с одними цифрами в имени.
# Доработано окно свойств: свойства типа <code>ValueLink</code> принимают перетаскивание узлов.
# Доработано окно <code>Стек вызовов</code>: при двойном клике по элементам таблицы открывается редактор кода.
# Доработан редактор кода: добавлены маркеры ошибок компиляции.
# Доработано окно <code>Ошибки</code>: при двойном клике на ошибке выполняется открытие редактора кода.
# '''Добавлена возможность поиска по проекту. Панель поиска вызывается комбинацией клавиш <code>Ctrl+Shift+F</code>.'''

=== Среда исполнения ===

# Доработано окно тревог: добавлено сообщение "Активных тревог нет" в центре таблицы при отсутствии активных тревог.

== 1.6.29-rf17ce9e25c7a от 2025-11-18 ==

=== Узлы ===

# Добавлена функция <code>SetNodeValueAsUInt(string strNodePath, uint32_t uiValue)</code>.
# Доработано действие <code>Создание события</code>: добавлено свойство <code>Требовать квитирование</code>.
# Доработана система тревог: добавлены обработчики событий <code>OnActiveEventsCleared</code> и <code>OnActiveEventsAcknowledged</code>.
# Доработан архиватор SQLite: изменен алгоритм прореживания в режиме <code>Процент от среднего значения</code> — теперь среднее вычисляется по последним N значениям. Добавлено свойство <code>Размер окна среднего (N)</code> для настройки ширины окна. Также добавлена опция <code>Процент от среднего (окно по времени)</code>, в которой среднее рассчитывается по значениям за временной интервал, равный параметру <code>Интервал архивирования</code>. Исправлено отсутствие таблицы <code>SignalInfo</code> при ротации БД.
# Доработана система тревог: добавлено свойство <code>Использовать цвет группы</code> для отображения элементов в окне тревог. Добавлено сохранение событий квитирования.
# Доработано окно смены пароля: добавлена поддержка свойства <code>Запретить смену пароля</code> у узла пользователя.
# Добавлена функция <code>void sleep(ms)</code>.
# Изменена логика работы функции <code>LaunchProcess</code>, которая теперь выполняет запуск в блокирующем режиме, то есть функция завершится после завершения запущенного процесса.
# Исправлена ошибка в узле <code>Операция Таймер</code>. Теперь выключенные действия в обработчике <code>OnTimerFinished</code> не исполняются.

=== Среда разработки ===

# Упорядочен вывод сообщений в окно Сообщения. Устранен вывод служебных сообщений.

=== Примеры ===

# Исправлены примеры <code>DistributedDemoServer</code>, <code>DistributedDemoClient</code>.

== 1.6.28-r7aa0d6dc2386 от 2025-11-01 ==

=== Узлы ===

# Доработано действие Смена пароля пользователя - пользователи с запретом смены пароля блокируются в списке выбора.
# Исправлена критическая ошибка в системе проверки прав, возникающая при некорректной конфигурации системы. Дополнена валидация системы для уведомления о некорректной конфигурации.
# Доработана стандартная библиотека: реализованы функции <code>array<string> GetInterfaceAddresses(string)</code>, <code>array<string> GetNetworkInterfaces()</code>.
# Доработан узел <code>Пользователь</code> - добавлено свойство <code>Запретить изменение пароля</code>.
# Оптимизирована работа со значениями типа SignalValue.
# Доработаны приложения - реализована выдача значений типа SignalValue для свойств экземпляров.

=== Среда разработки ===

# Исправлена критическая ошибка в виджетах <code>Кнопка</code> и <code>Гистограмма</code>, возникавшая при удалении источника из списка.
# Добавлено сохранение типа узла в его тег в XML проекте.
# Изменено редактирование узлов <code>Операция скрипт С++</code>, размещенных в обработчиках. Теперь это работает почти как в версии 1.2, но переход к редактору возможен только по нажатию ОК. При закрытии диалога контейнера добавлено закрытие окна редактора кода для вложенного узла.

=== Примеры ===

# Добавлен пример <code>AIParameter</code>, демонстрирующий применение ООП в проекте.
# Добавлены примеры <code>DistributedDemoServer</code>, <code>DistributedDemoClient</code>, демонстрирующие принцип построения распределенных проектов.

== 1.6.27-r8573369cf034 от 2025-10-29 ==

=== Узлы ===
# Доработана [[Узлы проекта AgavaSCADA/AgavaPLC#Композиция|композиция многослойная]]: добавлено свойство <code>ActionsOnLoad</code>.
# В стандартную библиотеку добавлена поддержка класса <code>filesystem</code>.
# Добавлено чтение свойств типа <code>NColor</code> [[Свойства узлов в AgavaSCADA/AgavaPLC#NColor|через преобразование в int]].
# Устранены критические ошибки в системных функциях поиска файлов, возникавшие при работе с разрушенными файловыми системами.
# Добавлены функции <code>bool isnan(float value)</code>, <code>void LaunchProcess(string strFilePath)</code>.

== 1.6.26-rfd1b5cbbf1fc от 2025-10-23 ==

=== Узлы ===
# Для узлов <code>RetainStorage</code> и <code>StorageDrive</code> реализовано онлайн создание свойств.
# Доработаны методы <code>BasicSignal::SetValue</code>, <code>BasicSignal::UpdateValue</code>, <code>BasicSource::SetValue</code>, <code>BasicSource::UpdateValue</code> - реализована выдача кодов [[Коды ошибок и предупреждений AgavaSCADA/AgavaPLC|ошибок]].
# Доработаны архиваторы <code>SQLite</code>, <code>PostreSQL</code> - добавлена возможность прореживания записи в БД.
# Выполнен рестайлинг окон проверки подлинности пользователя и смены пароля пользователя.
# Доработаны библиотеки ресурсов - исправлена работа с русскими символами.
# Доработано действие <code>Смена пароля пользователя</code>: добавлено свойство <code>Текущий</code>.
# Доработана логика работы операторов <code>SignalValue operator&&</code>, <code>SignalValue operator||</code> - реализована генерация соответствующих событий при ошибках исполнения. Реализовано более простое и корректное сравнение значений. Изменен режим сравнения аргументов типа <code>string</code>, <code>Result</code>.
# Доработано окно с композицией: исправлена работа с свойством <code>CurrentCompositionDesc</code>.
# Доработаны транспорты <code>Modbus</code>: устранена ошибка "Illegal Data Address" в режиме "Сервер" при создании нескольких блоков регистров.
# Доработано действие <code>Запуск метода экземпляра</code>: добавлена возможность передачи аргументов.
# Доработано действие <code>Создание события</code>: добавлен форматтер <code>$$ns</code> - шифр узла.
# Доработан виджет <code>Кнопка</code>: для вложенных действий типа <code>Создание события</code> передается ссылка на себя для работы с форматтерами.

=== Среда разработки ===

# Устранена критическая ошибка, возникавшая при кликах по свойствам только для чтения типа bool узлов в дереве проекта.

== 1.6.25-r97ac006e3905 от 2025-10-15 ==

=== Узлы ===
# Добавлена функция <code>bool isnan(double)</code>.
# Добавлена функция <code>int LoadComposition(string, string, int)</code>.
# Добавлено действие <code>Смена пароля пользователя</code>.
# Доработано окно тревог: добавлена возможность размещения пользовательских виджетов.
# Доработан узел <code>Пользователь</code>: добавлено свойство <code>Не показывать в списке</code>.
# Исправлена ошибка в действии <code>Закрытие окна</code>, возникавшая при закрытии нескольких окон подряд на активном экране.
# Доработан узел <code>Тренд</code> графика исторического: в свойство <code>Использовать описание и шифр</code> добавлен вариант <code>Вышестоящий узел сигнала</code>.
# Доработано окно тревог: добавлена отдельная иконка для аварий. Исправлена работа свойства <code>Включить воспроизведение звуков</code> на контроллерах.
# Доработано действие <code>Создание события</code>: исправлена ошибка, при возникновении которой при деактивации события выводился текст активации.

=== Среда разработки ===

# Исправлена ошибка при редактировании свойств типа <code>Узел</code>, <code>Список узлов</code>.
# Устранено "зависание" среды разработки при онлайн отладке и просмотре значений переменных из отлаживаемой программы.
# Доработано окно редактирования свойств типа <code>Список узлов</code>: добавлена возможность перемещения элементов.
# Доработано окно редактирования списка привилегий у роли: добавлена поддержка клавиши Del, реализовано сохранение и восстановление геометрии окна, реализовано удаление множества элементов.
# Доработано окно ошибок: двойной клик по ошибке выделяет в дереве проекта узел, вызвавший ошибку.
# Исправлено повторное открытие окна настройки привилегий.
# Доработана библиотека ресурсов: сохранение теперь выполняется только при наличии изменений.

== 1.6.24-r93067f2c1dd1 от 2025-10-06 ==

=== Узлы ===
# Добавлена функция <code>double rand(double, double)</code>.
# Добавлена поддержка команды <code>Сброс</code> для действия <code>Команда узлу</code>.
# Узел <code>Контроллер событий</code> переименован в <code>Монитор событий</code>.
# Для монитора событий добавлено свойство <code>Блокировка работы</code>, добавлен обработчик <code>OnActiveEventsCleared</code>, вызывающийся после удаления всех активных тревог.
# Доработан узел <code>Регистр Modbus</code> - добавлена поддержка онлайн создания свойств.
# Доработан <code>Транспорт Modbus</code>: в режиме работы Slave устранена критическая ошибка, если не было указано свойство "Узел для чтения/записи". Добавлено соответствующее предупреждение при сборке проекта.
# Добавлена поддержка связывания свойств экземпляров через аргументы типа <code>SignalValue</code>.
# Доработан <code>Монитор событий</code>: добавлено свойство <code>Поведение при блокировании</code>. Добавлена проверка значений контролируемых узлов при старте проекта.

=== Среда разработки ===

# Доработан текстовый редактор кода: добавлена обработка нажатия клавиши <code>F9</code> для добавления/удаления точек останова. Значительно ускорено открытие текстов программ в редакторе.
# Доработан отладчик: добавлено человеко-читаемое представление значений типа <code>SignalValue</code>.

=== Примеры ===

# Дополнен пример <code>TestEventsAlarms</code>.

== 1.6.23-ra13bff0d25ce от 2025-09-29 ==

=== Узлы ===
# Добавлено восстановление свойств экземпляров объектов из retain.
# Доработаны транспорты <code>Modbus</code> - реализован арбитраж чтения/записи с помощью приоритетов.
# Исправлено некорректное позиционирование окон авторизации пользователя, выбора интервала графика или журнала и др. в проектах с составными фреймами, содержащими множество окон.
# Реализована запись во все источники узла <code>Сигнал простой</code>.

=== Среда разработки ===

# Исправлена ошибка в редактировании свойств типа <code>Цвет</code>, из-за которой иногда некорректно сохранялось значение альфа канала.
# Исправлена ошибка использования одной библиотеки ресурсов в разных проектах.

== 1.6.22-r2d092373a7c2 от 2025-09-24 ==

=== Узлы ===
# Исправлены критические ошибки обращения к свойствам экземпляров объектов при выполнении программ.
# Исправлена ошибка первичного отображения окна тревог.
# Устранены ошибки в работе субмодулей.

=== Среда разработки ===

# Устранены ошибки компиляции проектов, использующих субмодули.

== 1 1.6.21-rb7d9d1301bf0 от 2025-09-18 ==

=== 1.1 Узлы ===

# Исправлена ошибка "онлайн" создания свойств для виджета <code>Ввод значения</code>.
# Реализована проверка свойства <code>Отключен</code> у действий перед выполнением.
# Исправлена ошибка "онлайн" создания свойств экземпляров объектов и связывания их с методами и инициализации значениями.
# AS/PLC 2.38.
# Реализована возможность игнорирования ошибок связи при работе транспорта <code>Modbus-TCP</code> (свойство <code>Действие при превышении порога ошибок 2</code>).
# Реализована инициализация значения сигнала простого значением связанного источника при запуске.
# Реализован кэш методов экземпляров объектов.
# Изменен механизм определения IP-адресов станции.

=== 1.2 Среда разработки ===

# Восстановлена возможность выбора свойств узлов как источников для операций.
# Реализовано отображение признака <code>Отключен</code> узлов в окне выбора узлов.
# Дополнена валидация виджета <code>Ввод значения</code>.

== 1.6.20-r0ad724e1e636 от 2025-08-08 ==

=== Узлы ===

# Добавлена функция <code>int StoreMessage(int iMessageLevel, string strMessage, string strGroup).</code>
# Добавлена возможность вызова методов экземпляров объектов из действий.
# Исправлено выполнение действия <code>Создание события</code>, теперь возможно создание событий из обработчиков.
# В тренды графиков добавлено свойство <code>Единицы измерения</code>.
# Добавлен межстанционный транспорт. Для станций добавлено свойство <code>Роль</code>. Станция с ролью <code>Клиент</code> производит подключение к удаленным станциям с ролью <code>Сервер</code> и уведомляет об изменениях источников и сигналов.
# Устранена ошибочная генерация нескольких дублирующихся событий при работе контроллеров событий.
# В окне <code>Фильтр</code> виджета <code>Список событий</code> размер элементов теперь зависит от свойства системы тревог <code>Размер кнопки</code>.
# Доработаны транспорты <code>Modbus</code>:
#* добавлена [[Транспорты AgavaSCADA/AgavaPLC#Этап 2. Объединение команд записи (функции 15 и 16)|группировка команд записи]] для функций 15 и 16;
#* реализована [[Транспорты AgavaSCADA/AgavaPLC#Этап 1. Дедупликация при постановке в очередь|дедупликация команд записи]].
# Доработан транспорт OPC-UA:
#* исправлены типы свойств;
#* сервер теперь привязывается к порту, указанному в свойстве <code>Адрес</code> (ранее всегда использовался 4840).

=== Среда разработки ===

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

== 1.6.19-r89b594033f4d от 2025-09-02 ==

=== Узлы ===

# Реализовано определение локальной станции для запуска проекта.
# Исправлен запуск узла типа <code>Сигнал простой</code>.

=== Среда разработки ===

# В мастер создания проектов добавлена поддержка АГАВА ПЛК-70.А.
# Исправлена конвертация виджетов <code>Ввод значения</code> при обновлении проекта с версии 1.2.
# Исправлена ошибка в окне настройки исторического графика, связанная с одновременным удалением нескольких трендов.
# Доработана проверка проекта перед сохранением конфигурации. При обнаружении критических ошибок - отказ сохранения.
# Добавлена проверки станций на использование адреса 127.0.0.1, на дублирующиеся IP-адреса.

== 1.6.18-r4a325427448b от 2025-08-06 ==

=== Узлы ===

# Доработана установка аргументов в вызываемые методы экземпляров (добавлен тип <code>string</code> для некоторых сценариев).
# Доработаны узлы <code>Транспорт Modbus-TCP</code>, <code>Транспорт Modbus-RTU</code>:
#* Добавлен узел типа <code>Счетчик</code>, хранящий признак активного подключения к устройству с заданным Modbus адресом.
# Доработан узел <code>Транспорт Modbus-TCP</code>:
#* Реализовано множественное подключение клиентов в режиме работы <code>Сервер</code>.
#* Доработан режим <code>Сервер</code>: добавлена возможность настройки таймаута активности клиента и максимального количества подключений к серверу.
# Узел <code>Шаблонная композиция</code> убран из списка доступных типов для группы "Композиции".
# Исправлена критическая ошибка, изредка возникавшая при переключении окон.
# Исправлена ошибка выполнения действия Закрытие окна.

=== Среда разработки ===

# Исправлена функция просмотра и редактирования списка источников формы.

#

== 1.6.17-r1f70359a00b4 от 2025-08-01 ==

=== Узлы ===

# Исправлена ошибка передачи аргументов типов <code>float</code>, <code>double</code> в методы классов.
# Исправлено связывание свойств экземпляров базовых типов с узлами проекта.
# Доработан вызов методов типа <code>void</code> классов для исключения критических ошибок.
# Для кривых графиков изменена толщина линии по умолчанию на <code>1</code>.
# Исправлена ошибка в команде <code>Сохранить архив проекта</code> - устранено ошибочное создание дубликатов некоторых используемых проектом файлов.
# Доработано восстановление <code>retain</code> - добавлена возможность восстановления в свойства экземпляров классов.
# Изменена конвертация <code>Result</code> в другие типы.

=== Среда разработки ===

# Исправлены ошибки работы отладчика с точками останова в методах и свойствах классов.
# Изменен уровень ошибок компиляции при поиске путей в проекте (Get/SetNodeValueAs... и др.) с <code>Ошибка</code> на <code>Предупреждение</code>.
# Реализовано связывание виджетов со свойствами узлов путем перетаскивания.
# Добавлено местное (inplace) редактирование свойств типа <code>SignalValue</code> в диалоге редактирования сопоставлений, например в окне редактирования сопоставлений виджета <code>Выпадающий список</code>.
# Уточнено сообщение об ошибочном открытии проекта из папки <code>.autosave</code>.
# Доработано окно выбора узлов - кнопка <code>ОК</code> теперь является кнопкой по умолчанию.

=== Примеры ===

# Добавлен пример SQLiteDecimation, демонстрирующий возможности прореживания при записи архива SQLite.
# Доработан пример TestEventsAlarms.

== 1.6.16-r4dc07fc875a4 от 2025-07-18 ==

=== Узлы ===

# Доработан системный транспорт <code>TransportSystem2</code> - изменена процедура остановка сервера для устранения незавершенных соединений.
# Доработаны виджеты <code>Гистограмма</code> и <code>Кнопка</code> - исправлена работа с источником.
# Доработано действие <code>Запуск процесса</code> - исправлен запуск процесса.

=== Среда разработки ===

# Восстановлено обновление BuildNo и даты сборки проекта.

=== ASLauncher ===

# Убрано диалоговое окно с сообщением о частых попытках перезапуска при выходе.
# При запуске приложений из `.desktop` файлов добавлена проверка, что логирование в указанные файлы возможно.
# В файлы логов добавлена информация о версии приложения.

== 1.6.15-r710146e4389e от 2025-07-09 ==

=== Узлы ===

# Узел Система тревог - добавлены настройки окна тревог (ширина, высота, перенос строк в сообщениях).
# Исправлена ошибка в проверке прав на закрытие фрейма, из-за чего в некоторых проектах без системы проверки прав закрытие фрейма не работало.
# Виджет <code>Список событий</code> - исправлена ошибка при работе с диалогом ожидания.
# Действие <code>Авторизация пользователя</code> - добавлено свойство <code>Запрашивать пароль</code>. Действие с включенным свойством <code>Запрашивать пароль</code> будет отображать окно авторизации без возможности смены пользователя.
# Реализована возможность инициализации свойств экземпляров объектов постоянными значениями, задаваемыми в среде разработки (доступны типы bool, int, uint, long, ulong, double, string).
# Для транспортов <code>Modbus-RTU</code>, <code>Modbus-TCP</code> добавлена очистка очереди команд при (ре)старте обмена.

=== Среда разработки ===

# Добавлена поддержка нового системного транспорта. Для подключения к панелям оператора и контроллерам из среды разработки необходимо обновить среду исполнения до версии 1.6.15 или более новой.
# Добавлена иконка для приложения [[Универсальная среда разработки Agava]] (впервые с версии 1.0!).
# Исправлены критические ошибки в webvisu из-за отсутствия qml модулей.

=== Среда исполнения ===

# Откорректировано оформление окна авторизации с целью улучшения привлекательности.

=== Примеры ===

# Добавлены примеры <code>MultiImageLabel</code>, <code>LayersDemo</code>. Пример <code>MultiImageLabel</code> дополнен демонстрацией webvisu.
# Добавлены примеры <code>OpcUaDemo</code>, <code>OpcUaClientDemo</code>.

'''Версия переведена в стабильную стадию.'''

== 1.6.14-r1c61c35c3da4 от 2025-06-20 ==

=== Среда разработки ===

# Добавлена возможность регулирования частоты обновления форм и экранов с композициями. Добавлено свойство "Интервал обновления" для экранов и композиций.
# У виджета "График" изменен форматтер оси времени по умолчанию с "dd.MM.yy hh:mm:ss" на "dd.MM.yyyy hh:mm:ss".

=== Среда исполнения ===

# Оптимизирован вывод информации на экран - исключена повторная отрисовка виджетов, при записи значений в их свойства из скриптов и программ.
# Реализовано профилирование вызова базовых методов и работы с контекстами.
# Реализован вывод информации о перерисовке виджетов в консоль с настройкой через файл as.ini.

=== Примеры ===

# Добавлен пример <code>WindowUpdateRate</code>, демонстрирующий возможность ограничения частоты обновления окон.

== 1.6.13-r13248581de39 от 2025-06-17 ==

=== Среда разработки ===

# Исправлена ошибка функции "Просмотр событий", из-за которой некорректно выдавались события в проектах без логгеров.
# Реализовано копирование станций ПК-40, ПК-50, ПК-60.
# Устранено сохранение в архив проекта файлов .bi?, хранящихся в подпапках, начинающихся с точки. Например .autosave, .backup
# Разрешено добавление приложений к станциям ПО-40, ПО-50, ПО-60.
# Убрана зависимость от библиотеки libclang.

=== Среда исполнения ===

# Реализован вывод информации о регионах перерисовки окон в консоль с настройкой через файл as.ini.
# Доработаны методы BasicSignal::GetValue, BasicSignal::SetValue для корректного обращения к узлам проекта.
# Исправлена ошибка в работе со светодиодами станции ПК-40.
# Исправлено создание BasicSource("path"), BasicSignal("path"), BasicWidget("path") в программах. Теперь появилась возможность доступа ко всем свойствам узла проекта, а не только к свойствам, определенным в BasicNode.
# Добавлена проверка типа при создании экземпляра BasicSource (ОМ).

=== Примеры ===

# Разработан пример <code>Leds</code>, демонстрирующий работу со светодиодами ПО-50 из программы с использованием объектной модели.

=== ASLauncher ===

# Добавлен скрипт для восстановления <code>explorer.exe</code> в качестве оболочки рабочего стола после установки ASLauncher.

== 1.6.12-r17b244111a8c от 2025-05-30 ==

=== Среда разработки ===

# Исправлена ошибка, возникавшая при перемещении узлов в дереве проекта, из-за которой перемещаемые узлы пропадали.
# Добавлено текстовое описание при появлении окна с ошибками, например при сохранении проекта.
# Узел <code>Операция Пара условий</code> - исправлены имена свойств. В проектах версии 1.2 операция не работала в режиме проверки двух условий. '''Необходимо проверить корректность настроек при переходе с версии 1.2.'''
# Исправлена ошибка определения уровня логгеров при вызове команды <code>Просмотр событий</code>, из-за которой при наличии в проекте логгеров с уровнями логгирования <code>INFO</code> в окно событий не попадали события ниже уровнем.

=== Среда исполнения ===

# Оптимизация узла <code>Транспорт TCP</code>.
# Оптимизирована система журналирования.

== 1.6.8-r915d8d477fa4 от 2025-05-14 ==

=== Среда разработки ===
# Исправлено несоответствие настроек узла <code>Действие "Команда узлу"</code> и фактически исполняемых команд. '''При обновлении на эту версию необходимо проверить корректность настроек всех улов типа <code>Действие "Команда узлу"</code>.'''

[[Категория:AgavaSCADA/AgavaPLC]]
__NOTOC__

Перечень изменений AgavaSCADA/AgavaPLC 1.6

2026-04-06T06:27:12Z

TaushkanovKV:

Основные изменения в сравнении с версией 1.2:

# Добавлена возможность создания программ на языке C++ в соответствии с подходом, описанным в стандарте МЭК 61131-3.
# Продолжение развития объектной модели и возможности разработки программ, начатых в версии <code>AS 1.5</code>. [[Объектная модель AgavaSCADA/AgavaPLC]].
# Добавлена поддержка локального и онлайн (удаленного) отладчика.
# Для редактирования текстов программ, функций и классов внедрен новый, удобный и функциональный текстовый редактор, подобный распространенному VSCode.
# Транспорты MQTT, SNMP, МЭК 60870-5-101, МЭК 60870-5-104 портированы на ПК с ОС Linux x64 и контроллеры АГАВА.
# Реализован новый архиватор в БД PostgreSQL.
# Добавлена поддержка ресурсов и библиотек ресурсов.
# Добавлена Web-визуализация. См. пример <code>MultiImageLabel</code>.
# Разработан ряд примеров, демонстрирующих новые возможности: <code>AIParameter</code>, <code>PIDRegulator</code>, <code>Leds</code>, <code>Wdt</code>, <code>AgavaAnalogInput</code>, <code>WidgetAgavaInput</code>, <code>Pump</code>, <code>MultiImageLabel</code> и другие.
Также запланировано добавление новых возможностей:
# Поддержка языка ST МЭК 61131-3 (Structured text).
# Поддержка распределенных проектов.
# Поддержка сохранения в проекте информации о целевой системе.
# Конфигурирование целевых устройств из проекта.
# Создание расширений для среды разработки с помощью SDK.
Перевод разработанных ранее проектов на актуальную версию описан в документе [[Миграция проектов AgavaSCADA/AgavaPLC]].

== 1.6.33-rc335f5d9dacf от 2026-04-01 ==

=== Узлы ===
# Доработан выполнение алгоритмов C++:
#* Возвращён вызов виртуальных методов BasicSource.
#* Реализована защита от рекурсии в методах BasicSource.
# Доработан класс <code>SignalValue</code> - зарегистрированы конструкторы и методы работы с типами uint64, uint32.
# Доработан узел <code>Транспорт Modbus-TCP</code>:
#* Функция записи по умолчанию установлена на 0.
#* Отключена возможность множественных подключений к транспорту в режиме <code>Сервер</code>.
# Доработан узел <code>Транспорт Modbus-RTU</code> :
#* Функция записи по умолчанию установлена на 0.
#* Восстановлена работа в режиме <code>Сервер</code>.
# Доработан узел <code>Транспорт УПД</code>:
## Исправлена работа со свойством <code>Идентификаторы ведущих</code>.
## Добавлено отслеживание активного подключения в режиме <code>Slave</code>.
# Зарегистрирован класс any.
# Доработан узел <code>Retain накопитель</code> - реализована возможность сохранения через задержку.
# Добавлена возможность связывания свойств экземпляров с свойствами других узлов.
# Добавлены типы (u)int64 для связи со свойствами экземпляров.

=== Среда разработки ===

# Исправлена критическая ошибка в команде "Показать в графическом представлении".
# Доработано контекстное меню дерева проекта:
#* Исправлена критическая ошибка в команде "Выделить" для виджетов.
#* Пункт "Выделить" перемещен на уровень выше.
#* Добавлено действие "Выделить" на двойной клик по виджетам.
# Исправлена критическая ошибка, возникавшая при открытии диалога "Настройки" для графиков.
# Устранены назойливые сообщения загрузки плагинов и регистрации узлов при проверке проекта.
# Добавлена возможность восстановления связей между узлами при вставке фрагментов из других проектов.
# Исправлена ошибка многократной установки ошибок в редактор кода, приводившая к сильному замедлению работы при большом количестве открытых окон редактора.
# Реализовано отображение содержимого массивов и указателей (хэндлов) в режиме отладки.
# Добавлены файловые ассоциации на файл проекта для быстрого открытия проекта в среде разработки с помощью двойного клика по .asp файлу.
# '''Отключен вызов сеттеров свойств при установке значений свойств в среде разработки.'''
# Отключено кеширование композиций в среде разработки.
# Исправлена критическая ошибка, возникавшая при установке значения свойства типа <code>string</code> у экземпляра после сборки проекта.
# Доработано контекстное меню дерева проекта и контекстное меню графического предаставления - добавлены иконки элементов контекстного меню <code>Добавить узел</code>, изменен порядок команд для более удобного их использования.
# Изменена горячая клавиша создания проекта на <code>Ctrl+Shift+N</code>.

=== Среда исполнения ===

# Добавлено логгирование для системного и межстанционного транспортов.
# Убрана поддержка IPv6 в системном транспорте и межстанционном транспорте для работы на встраиваемых системах без IPv6.
# Исправлена критическая ошибка в BasicNode, иногда приводившая к крахам при одновременном доступе к объекту из разных задач.

== 1.6.32-r79b12a16bbd7 от 2026-03-05 ==

=== Узлы ===
# Класс <code>WindowForm</code> добавлен в объектную модель.
# Отключена возможность добавления узлов типа <code>Задача ПЛК</code> как устаревшего функционала. Вместо него будет добавлена возможность создавать программы на языках FBD, CFC, SFC.
# Реализовано автоматическое создание конструкторов по умолчанию для классов из ОМ при отсутствии пользовательского.
# Исправлен запуск сигналов.
# Устранены утечки памяти при сохранении проекта в .bin.
# Внутренняя реорганизация обработчиков событий OperationsInput, OperationsOutput в узле <code>Сигнал простой</code>.
# Добавлен TransportModbusRtuIdr2.
# В действии <code>Создание события</code> исправлена работа форматтера <code>$$pd</code>.

=== Среда разработки ===

# Доработан редактор графического представления: добавлена сетка, [[Универсальная среда разработки Agava#.D0.98.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5 .D1.8F.D0.BA.D0.BE.D1.80.D0.B5.D0.B9|линейки, якоря]], функции выравнивания виджетов.
# Исправлена ошибка, вызывавшая двойной вызов обработчиков событий мыши для окон.
# Устранена ошибка, связанная с утечкой памяти при удалении виджетов.
# Добавлено приветственное окно со списком последних открытых проектов и таблицей примеров.
# Исправлена некритическая ошибка, возникавшая при закрытии фрейма.

=== Среда исполнения ===

# Устранена ошибка, связанная с утечкой памяти при закрытии окна с кешированными композициями.

== 1.6.31-rac6da98668fb от 2025-12-26 ==

=== Примеры ===
# Добавлен пример <code>Controllers/PLC70_Submodules</code>.

== 1.6.31-r9e81e0333260 от 2025-12-25 ==

=== Узлы ===

# Добавлена возможность создания конструкторов вида Classname(const string &in path) в дереве.
# Исправлена ошибка в вызове обработчика <code>OnWheel</code> у виджетов.
# Доработан узел <code>Корзина субмодулей</code>:
#* Уменьшено время ожидания ответа субмодуля с 1000 мс до 25 мс.
#* Реализована поддержка слотов G/H/I/K для ПЛК-70.
#* Реализовано создание узлов для каналов субмодулей в дереве проекта. '''Обратите внимание, проекты, использующие прежнюю структуру субмодулей, не совместимы с версией AgavaSCADA/AgavaPLC 1.6.31!'''
#* Исправлена валидация слотов на уровне субмодуля. Добавлена проверка на занятость одного слота несколькими субмодулями с формированием сообщения об ошибке.
# Доработаны узлы <code>Станция ПК-40</code>, <code>Станция ПК-50</code>, <code>Станция ПК-60</code>, <code>Станция ПК-70</code>:
#* Добавлено ограничение значений подсветки экрана и индикаторов, добавлена валидация соответствующих свойств узлов.
#* Реализована установка яркости подсветки экрана и состояния светодиодов согласно настроек в проекте.
# Доработан транспорт OPC UA:
#* Добавлена поддержка типа double.
#* Устранены критические ошибки при повторном запуске транспорта и при записи в read-only тэги.
#* Добавлено уведомление пользователя о некорректных тэгах.
# Доработан виджет <code>Ввод значения</code>: исправлено форматирование значений типа double - число знаков после запятой теперь зависит от шага значения.

=== Среда разработки ===

# Устранена потенциальная ошибка сохранения проекта при открытии в проводнике папки с проектом.
# Изменен мастер создания проектов: для проектов для <code>ПЛК-70.А</code>, создаваемых с помощью мастера, используется узел <code>Станция ПК-70</code> вместо <code>Станция ПК-40</code> в предыдущей версии.

=== Среда исполнения ===

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

== 1.6.30-rb3d3b577ed29 от 2025-12-05 ==

=== Ядро ===

# Исправлена работа системного транспорта: устранена ошибка взаимодействия с другими станциями.

=== Узлы ===

# Исправлена ошибка с обработкой вложенных групп в узле типа <code>Приложение</code>.
# Доработан класс <code>NodeProperty</code>: изменена регистрация класса, устранены критические ошибки.

=== Среда разработки ===

# Доработано редактирование свойств типа <code>ValueLink</code>: добавлен сброс значения, позволяющий удалить ранее установленное значение.
# Доработан редактирование свойств типа <code>NodeLink</code>: исправлена ошибка при работе с узлами с одними цифрами в имени.
# Доработано окно свойств: свойства типа <code>ValueLink</code> принимают перетаскивание узлов.
# Доработано окно <code>Стек вызовов</code>: при двойном клике по элементам таблицы открывается редактор кода.
# Доработан редактор кода: добавлены маркеры ошибок компиляции.
# Доработано окно <code>Ошибки</code>: при двойном клике на ошибке выполняется открытие редактора кода.
# '''Добавлена возможность поиска по проекту. Панель поиска вызывается комбинацией клавиш <code>Ctrl+Shift+F</code>.'''

=== Среда исполнения ===

# Доработано окно тревог: добавлено сообщение "Активных тревог нет" в центре таблицы при отсутствии активных тревог.

== 1.6.29-rf17ce9e25c7a от 2025-11-18 ==

=== Узлы ===

# Добавлена функция <code>SetNodeValueAsUInt(string strNodePath, uint32_t uiValue)</code>.
# Доработано действие <code>Создание события</code>: добавлено свойство <code>Требовать квитирование</code>.
# Доработана система тревог: добавлены обработчики событий <code>OnActiveEventsCleared</code> и <code>OnActiveEventsAcknowledged</code>.
# Доработан архиватор SQLite: изменен алгоритм прореживания в режиме <code>Процент от среднего значения</code> — теперь среднее вычисляется по последним N значениям. Добавлено свойство <code>Размер окна среднего (N)</code> для настройки ширины окна. Также добавлена опция <code>Процент от среднего (окно по времени)</code>, в которой среднее рассчитывается по значениям за временной интервал, равный параметру <code>Интервал архивирования</code>. Исправлено отсутствие таблицы <code>SignalInfo</code> при ротации БД.
# Доработана система тревог: добавлено свойство <code>Использовать цвет группы</code> для отображения элементов в окне тревог. Добавлено сохранение событий квитирования.
# Доработано окно смены пароля: добавлена поддержка свойства <code>Запретить смену пароля</code> у узла пользователя.
# Добавлена функция <code>void sleep(ms)</code>.
# Изменена логика работы функции <code>LaunchProcess</code>, которая теперь выполняет запуск в блокирующем режиме, то есть функция завершится после завершения запущенного процесса.
# Исправлена ошибка в узле <code>Операция Таймер</code>. Теперь выключенные действия в обработчике <code>OnTimerFinished</code> не исполняются.

=== Среда разработки ===

# Упорядочен вывод сообщений в окно Сообщения. Устранен вывод служебных сообщений.

=== Примеры ===

# Исправлены примеры <code>DistributedDemoServer</code>, <code>DistributedDemoClient</code>.

== 1.6.28-r7aa0d6dc2386 от 2025-11-01 ==

=== Узлы ===

# Доработано действие Смена пароля пользователя - пользователи с запретом смены пароля блокируются в списке выбора.
# Исправлена критическая ошибка в системе проверки прав, возникающая при некорректной конфигурации системы. Дополнена валидация системы для уведомления о некорректной конфигурации.
# Доработана стандартная библиотека: реализованы функции <code>array<string> GetInterfaceAddresses(string)</code>, <code>array<string> GetNetworkInterfaces()</code>.
# Доработан узел <code>Пользователь</code> - добавлено свойство <code>Запретить изменение пароля</code>.
# Оптимизирована работа со значениями типа SignalValue.
# Доработаны приложения - реализована выдача значений типа SignalValue для свойств экземпляров.

=== Среда разработки ===

# Исправлена критическая ошибка в виджетах <code>Кнопка</code> и <code>Гистограмма</code>, возникавшая при удалении источника из списка.
# Добавлено сохранение типа узла в его тег в XML проекте.
# Изменено редактирование узлов <code>Операция скрипт С++</code>, размещенных в обработчиках. Теперь это работает почти как в версии 1.2, но переход к редактору возможен только по нажатию ОК. При закрытии диалога контейнера добавлено закрытие окна редактора кода для вложенного узла.

=== Примеры ===

# Добавлен пример <code>AIParameter</code>, демонстрирующий применение ООП в проекте.
# Добавлены примеры <code>DistributedDemoServer</code>, <code>DistributedDemoClient</code>, демонстрирующие принцип построения распределенных проектов.

== 1.6.27-r8573369cf034 от 2025-10-29 ==

=== Узлы ===
# Доработана [[Узлы проекта AgavaSCADA/AgavaPLC#Композиция|композиция многослойная]]: добавлено свойство <code>ActionsOnLoad</code>.
# В стандартную библиотеку добавлена поддержка класса <code>filesystem</code>.
# Добавлено чтение свойств типа <code>NColor</code> [[Свойства узлов в AgavaSCADA/AgavaPLC#NColor|через преобразование в int]].
# Устранены критические ошибки в системных функциях поиска файлов, возникавшие при работе с разрушенными файловыми системами.
# Добавлены функции <code>bool isnan(float value)</code>, <code>void LaunchProcess(string strFilePath)</code>.

== 1.6.26-rfd1b5cbbf1fc от 2025-10-23 ==

=== Узлы ===
# Для узлов <code>RetainStorage</code> и <code>StorageDrive</code> реализовано онлайн создание свойств.
# Доработаны методы <code>BasicSignal::SetValue</code>, <code>BasicSignal::UpdateValue</code>, <code>BasicSource::SetValue</code>, <code>BasicSource::UpdateValue</code> - реализована выдача кодов [[Коды ошибок и предупреждений AgavaSCADA/AgavaPLC|ошибок]].
# Доработаны архиваторы <code>SQLite</code>, <code>PostreSQL</code> - добавлена возможность прореживания записи в БД.
# Выполнен рестайлинг окон проверки подлинности пользователя и смены пароля пользователя.
# Доработаны библиотеки ресурсов - исправлена работа с русскими символами.
# Доработано действие <code>Смена пароля пользователя</code>: добавлено свойство <code>Текущий</code>.
# Доработана логика работы операторов <code>SignalValue operator&&</code>, <code>SignalValue operator||</code> - реализована генерация соответствующих событий при ошибках исполнения. Реализовано более простое и корректное сравнение значений. Изменен режим сравнения аргументов типа <code>string</code>, <code>Result</code>.
# Доработано окно с композицией: исправлена работа с свойством <code>CurrentCompositionDesc</code>.
# Доработаны транспорты <code>Modbus</code>: устранена ошибка "Illegal Data Address" в режиме "Сервер" при создании нескольких блоков регистров.
# Доработано действие <code>Запуск метода экземпляра</code>: добавлена возможность передачи аргументов.
# Доработано действие <code>Создание события</code>: добавлен форматтер <code>$$ns</code> - шифр узла.
# Доработан виджет <code>Кнопка</code>: для вложенных действий типа <code>Создание события</code> передается ссылка на себя для работы с форматтерами.

=== Среда разработки ===

# Устранена критическая ошибка, возникавшая при кликах по свойствам только для чтения типа bool узлов в дереве проекта.

== 1.6.25-r97ac006e3905 от 2025-10-15 ==

=== Узлы ===
# Добавлена функция <code>bool isnan(double)</code>.
# Добавлена функция <code>int LoadComposition(string, string, int)</code>.
# Добавлено действие <code>Смена пароля пользователя</code>.
# Доработано окно тревог: добавлена возможность размещения пользовательских виджетов.
# Доработан узел <code>Пользователь</code>: добавлено свойство <code>Не показывать в списке</code>.
# Исправлена ошибка в действии <code>Закрытие окна</code>, возникавшая при закрытии нескольких окон подряд на активном экране.
# Доработан узел <code>Тренд</code> графика исторического: в свойство <code>Использовать описание и шифр</code> добавлен вариант <code>Вышестоящий узел сигнала</code>.
# Доработано окно тревог: добавлена отдельная иконка для аварий. Исправлена работа свойства <code>Включить воспроизведение звуков</code> на контроллерах.
# Доработано действие <code>Создание события</code>: исправлена ошибка, при возникновении которой при деактивации события выводился текст активации.

=== Среда разработки ===

# Исправлена ошибка при редактировании свойств типа <code>Узел</code>, <code>Список узлов</code>.
# Устранено "зависание" среды разработки при онлайн отладке и просмотре значений переменных из отлаживаемой программы.
# Доработано окно редактирования свойств типа <code>Список узлов</code>: добавлена возможность перемещения элементов.
# Доработано окно редактирования списка привилегий у роли: добавлена поддержка клавиши Del, реализовано сохранение и восстановление геометрии окна, реализовано удаление множества элементов.
# Доработано окно ошибок: двойной клик по ошибке выделяет в дереве проекта узел, вызвавший ошибку.
# Исправлено повторное открытие окна настройки привилегий.
# Доработана библиотека ресурсов: сохранение теперь выполняется только при наличии изменений.

== 1.6.24-r93067f2c1dd1 от 2025-10-06 ==

=== Узлы ===
# Добавлена функция <code>double rand(double, double)</code>.
# Добавлена поддержка команды <code>Сброс</code> для действия <code>Команда узлу</code>.
# Узел <code>Контроллер событий</code> переименован в <code>Монитор событий</code>.
# Для монитора событий добавлено свойство <code>Блокировка работы</code>, добавлен обработчик <code>OnActiveEventsCleared</code>, вызывающийся после удаления всех активных тревог.
# Доработан узел <code>Регистр Modbus</code> - добавлена поддержка онлайн создания свойств.
# Доработан <code>Транспорт Modbus</code>: в режиме работы Slave устранена критическая ошибка, если не было указано свойство "Узел для чтения/записи". Добавлено соответствующее предупреждение при сборке проекта.
# Добавлена поддержка связывания свойств экземпляров через аргументы типа <code>SignalValue</code>.
# Доработан <code>Монитор событий</code>: добавлено свойство <code>Поведение при блокировании</code>. Добавлена проверка значений контролируемых узлов при старте проекта.

=== Среда разработки ===

# Доработан текстовый редактор кода: добавлена обработка нажатия клавиши <code>F9</code> для добавления/удаления точек останова. Значительно ускорено открытие текстов программ в редакторе.
# Доработан отладчик: добавлено человеко-читаемое представление значений типа <code>SignalValue</code>.

=== Примеры ===

# Дополнен пример <code>TestEventsAlarms</code>.

== 1.6.23-ra13bff0d25ce от 2025-09-29 ==

=== Узлы ===
# Добавлено восстановление свойств экземпляров объектов из retain.
# Доработаны транспорты <code>Modbus</code> - реализован арбитраж чтения/записи с помощью приоритетов.
# Исправлено некорректное позиционирование окон авторизации пользователя, выбора интервала графика или журнала и др. в проектах с составными фреймами, содержащими множество окон.
# Реализована запись во все источники узла <code>Сигнал простой</code>.

=== Среда разработки ===

# Исправлена ошибка в редактировании свойств типа <code>Цвет</code>, из-за которой иногда некорректно сохранялось значение альфа канала.
# Исправлена ошибка использования одной библиотеки ресурсов в разных проектах.

== 1.6.22-r2d092373a7c2 от 2025-09-24 ==

=== Узлы ===
# Исправлены критические ошибки обращения к свойствам экземпляров объектов при выполнении программ.
# Исправлена ошибка первичного отображения окна тревог.
# Устранены ошибки в работе субмодулей.

=== Среда разработки ===

# Устранены ошибки компиляции проектов, использующих субмодули.

== 1 1.6.21-rb7d9d1301bf0 от 2025-09-18 ==

=== 1.1 Узлы ===

# Исправлена ошибка "онлайн" создания свойств для виджета <code>Ввод значения</code>.
# Реализована проверка свойства <code>Отключен</code> у действий перед выполнением.
# Исправлена ошибка "онлайн" создания свойств экземпляров объектов и связывания их с методами и инициализации значениями.
# AS/PLC 2.38.
# Реализована возможность игнорирования ошибок связи при работе транспорта <code>Modbus-TCP</code> (свойство <code>Действие при превышении порога ошибок 2</code>).
# Реализована инициализация значения сигнала простого значением связанного источника при запуске.
# Реализован кэш методов экземпляров объектов.
# Изменен механизм определения IP-адресов станции.

=== 1.2 Среда разработки ===

# Восстановлена возможность выбора свойств узлов как источников для операций.
# Реализовано отображение признака <code>Отключен</code> узлов в окне выбора узлов.
# Дополнена валидация виджета <code>Ввод значения</code>.

== 1.6.20-r0ad724e1e636 от 2025-08-08 ==

=== Узлы ===

# Добавлена функция <code>int StoreMessage(int iMessageLevel, string strMessage, string strGroup).</code>
# Добавлена возможность вызова методов экземпляров объектов из действий.
# Исправлено выполнение действия <code>Создание события</code>, теперь возможно создание событий из обработчиков.
# В тренды графиков добавлено свойство <code>Единицы измерения</code>.
# Добавлен межстанционный транспорт. Для станций добавлено свойство <code>Роль</code>. Станция с ролью <code>Клиент</code> производит подключение к удаленным станциям с ролью <code>Сервер</code> и уведомляет об изменениях источников и сигналов.
# Устранена ошибочная генерация нескольких дублирующихся событий при работе контроллеров событий.
# В окне <code>Фильтр</code> виджета <code>Список событий</code> размер элементов теперь зависит от свойства системы тревог <code>Размер кнопки</code>.
# Доработаны транспорты <code>Modbus</code>:
#* добавлена [[Транспорты AgavaSCADA/AgavaPLC#Этап 2. Объединение команд записи (функции 15 и 16)|группировка команд записи]] для функций 15 и 16;
#* реализована [[Транспорты AgavaSCADA/AgavaPLC#Этап 1. Дедупликация при постановке в очередь|дедупликация команд записи]].
# Доработан транспорт OPC-UA:
#* исправлены типы свойств;
#* сервер теперь привязывается к порту, указанному в свойстве <code>Адрес</code> (ранее всегда использовался 4840).

=== Среда разработки ===

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

== 1.6.19-r89b594033f4d от 2025-09-02 ==

=== Узлы ===

# Реализовано определение локальной станции для запуска проекта.
# Исправлен запуск узла типа <code>Сигнал простой</code>.

=== Среда разработки ===

# В мастер создания проектов добавлена поддержка АГАВА ПЛК-70.А.
# Исправлена конвертация виджетов <code>Ввод значения</code> при обновлении проекта с версии 1.2.
# Исправлена ошибка в окне настройки исторического графика, связанная с одновременным удалением нескольких трендов.
# Доработана проверка проекта перед сохранением конфигурации. При обнаружении критических ошибок - отказ сохранения.
# Добавлена проверки станций на использование адреса 127.0.0.1, на дублирующиеся IP-адреса.

== 1.6.18-r4a325427448b от 2025-08-06 ==

=== Узлы ===

# Доработана установка аргументов в вызываемые методы экземпляров (добавлен тип <code>string</code> для некоторых сценариев).
# Доработаны узлы <code>Транспорт Modbus-TCP</code>, <code>Транспорт Modbus-RTU</code>:
#* Добавлен узел типа <code>Счетчик</code>, хранящий признак активного подключения к устройству с заданным Modbus адресом.
# Доработан узел <code>Транспорт Modbus-TCP</code>:
#* Реализовано множественное подключение клиентов в режиме работы <code>Сервер</code>.
#* Доработан режим <code>Сервер</code>: добавлена возможность настройки таймаута активности клиента и максимального количества подключений к серверу.
# Узел <code>Шаблонная композиция</code> убран из списка доступных типов для группы "Композиции".
# Исправлена критическая ошибка, изредка возникавшая при переключении окон.
# Исправлена ошибка выполнения действия Закрытие окна.

=== Среда разработки ===

# Исправлена функция просмотра и редактирования списка источников формы.

#

== 1.6.17-r1f70359a00b4 от 2025-08-01 ==

=== Узлы ===

# Исправлена ошибка передачи аргументов типов <code>float</code>, <code>double</code> в методы классов.
# Исправлено связывание свойств экземпляров базовых типов с узлами проекта.
# Доработан вызов методов типа <code>void</code> классов для исключения критических ошибок.
# Для кривых графиков изменена толщина линии по умолчанию на <code>1</code>.
# Исправлена ошибка в команде <code>Сохранить архив проекта</code> - устранено ошибочное создание дубликатов некоторых используемых проектом файлов.
# Доработано восстановление <code>retain</code> - добавлена возможность восстановления в свойства экземпляров классов.
# Изменена конвертация <code>Result</code> в другие типы.

=== Среда разработки ===

# Исправлены ошибки работы отладчика с точками останова в методах и свойствах классов.
# Изменен уровень ошибок компиляции при поиске путей в проекте (Get/SetNodeValueAs... и др.) с <code>Ошибка</code> на <code>Предупреждение</code>.
# Реализовано связывание виджетов со свойствами узлов путем перетаскивания.
# Добавлено местное (inplace) редактирование свойств типа <code>SignalValue</code> в диалоге редактирования сопоставлений, например в окне редактирования сопоставлений виджета <code>Выпадающий список</code>.
# Уточнено сообщение об ошибочном открытии проекта из папки <code>.autosave</code>.
# Доработано окно выбора узлов - кнопка <code>ОК</code> теперь является кнопкой по умолчанию.

=== Примеры ===

# Добавлен пример SQLiteDecimation, демонстрирующий возможности прореживания при записи архива SQLite.
# Доработан пример TestEventsAlarms.

== 1.6.16-r4dc07fc875a4 от 2025-07-18 ==

=== Узлы ===

# Доработан системный транспорт <code>TransportSystem2</code> - изменена процедура остановка сервера для устранения незавершенных соединений.
# Доработаны виджеты <code>Гистограмма</code> и <code>Кнопка</code> - исправлена работа с источником.
# Доработано действие <code>Запуск процесса</code> - исправлен запуск процесса.

=== Среда разработки ===

# Восстановлено обновление BuildNo и даты сборки проекта.

=== ASLauncher ===

# Убрано диалоговое окно с сообщением о частых попытках перезапуска при выходе.
# При запуске приложений из `.desktop` файлов добавлена проверка, что логирование в указанные файлы возможно.
# В файлы логов добавлена информация о версии приложения.

== 1.6.15-r710146e4389e от 2025-07-09 ==

=== Узлы ===

# Узел Система тревог - добавлены настройки окна тревог (ширина, высота, перенос строк в сообщениях).
# Исправлена ошибка в проверке прав на закрытие фрейма, из-за чего в некоторых проектах без системы проверки прав закрытие фрейма не работало.
# Виджет <code>Список событий</code> - исправлена ошибка при работе с диалогом ожидания.
# Действие <code>Авторизация пользователя</code> - добавлено свойство <code>Запрашивать пароль</code>. Действие с включенным свойством <code>Запрашивать пароль</code> будет отображать окно авторизации без возможности смены пользователя.
# Реализована возможность инициализации свойств экземпляров объектов постоянными значениями, задаваемыми в среде разработки (доступны типы bool, int, uint, long, ulong, double, string).
# Для транспортов <code>Modbus-RTU</code>, <code>Modbus-TCP</code> добавлена очистка очереди команд при (ре)старте обмена.

=== Среда разработки ===

# Добавлена поддержка нового системного транспорта. Для подключения к панелям оператора и контроллерам из среды разработки необходимо обновить среду исполнения до версии 1.6.15 или более новой.
# Добавлена иконка для приложения [[Универсальная среда разработки Agava]] (впервые с версии 1.0!).
# Исправлены критические ошибки в webvisu из-за отсутствия qml модулей.

=== Среда исполнения ===

# Откорректировано оформление окна авторизации с целью улучшения привлекательности.

=== Примеры ===

# Добавлены примеры <code>MultiImageLabel</code>, <code>LayersDemo</code>. Пример <code>MultiImageLabel</code> дополнен демонстрацией webvisu.
# Добавлены примеры <code>OpcUaDemo</code>, <code>OpcUaClientDemo</code>.

'''Версия переведена в стабильную стадию.'''

== 1.6.14-r1c61c35c3da4 от 2025-06-20 ==

=== Среда разработки ===

# Добавлена возможность регулирования частоты обновления форм и экранов с композициями. Добавлено свойство "Интервал обновления" для экранов и композиций.
# У виджета "График" изменен форматтер оси времени по умолчанию с "dd.MM.yy hh:mm:ss" на "dd.MM.yyyy hh:mm:ss".

=== Среда исполнения ===

# Оптимизирован вывод информации на экран - исключена повторная отрисовка виджетов, при записи значений в их свойства из скриптов и программ.
# Реализовано профилирование вызова базовых методов и работы с контекстами.
# Реализован вывод информации о перерисовке виджетов в консоль с настройкой через файл as.ini.

=== Примеры ===

# Добавлен пример <code>WindowUpdateRate</code>, демонстрирующий возможность ограничения частоты обновления окон.

== 1.6.13-r13248581de39 от 2025-06-17 ==

=== Среда разработки ===

# Исправлена ошибка функции "Просмотр событий", из-за которой некорректно выдавались события в проектах без логгеров.
# Реализовано копирование станций ПК-40, ПК-50, ПК-60.
# Устранено сохранение в архив проекта файлов .bi?, хранящихся в подпапках, начинающихся с точки. Например .autosave, .backup
# Разрешено добавление приложений к станциям ПО-40, ПО-50, ПО-60.
# Убрана зависимость от библиотеки libclang.

=== Среда исполнения ===

# Реализован вывод информации о регионах перерисовки окон в консоль с настройкой через файл as.ini.
# Доработаны методы BasicSignal::GetValue, BasicSignal::SetValue для корректного обращения к узлам проекта.
# Исправлена ошибка в работе со светодиодами станции ПК-40.
# Исправлено создание BasicSource("path"), BasicSignal("path"), BasicWidget("path") в программах. Теперь появилась возможность доступа ко всем свойствам узла проекта, а не только к свойствам, определенным в BasicNode.
# Добавлена проверка типа при создании экземпляра BasicSource (ОМ).

=== Примеры ===

# Разработан пример <code>Leds</code>, демонстрирующий работу со светодиодами ПО-50 из программы с использованием объектной модели.

=== ASLauncher ===

# Добавлен скрипт для восстановления <code>explorer.exe</code> в качестве оболочки рабочего стола после установки ASLauncher.

== 1.6.12-r17b244111a8c от 2025-05-30 ==

=== Среда разработки ===

# Исправлена ошибка, возникавшая при перемещении узлов в дереве проекта, из-за которой перемещаемые узлы пропадали.
# Добавлено текстовое описание при появлении окна с ошибками, например при сохранении проекта.
# Узел <code>Операция Пара условий</code> - исправлены имена свойств. В проектах версии 1.2 операция не работала в режиме проверки двух условий. '''Необходимо проверить корректность настроек при переходе с версии 1.2.'''
# Исправлена ошибка определения уровня логгеров при вызове команды <code>Просмотр событий</code>, из-за которой при наличии в проекте логгеров с уровнями логгирования <code>INFO</code> в окно событий не попадали события ниже уровнем.

=== Среда исполнения ===

# Оптимизация узла <code>Транспорт TCP</code>.
# Оптимизирована система журналирования.

== 1.6.8-r915d8d477fa4 от 2025-05-14 ==

=== Среда разработки ===
# Исправлено несоответствие настроек узла <code>Действие "Команда узлу"</code> и фактически исполняемых команд. '''При обновлении на эту версию необходимо проверить корректность настроек всех улов типа <code>Действие "Команда узлу"</code>.'''

[[Категория:AgavaSCADA/AgavaPLC]]
__NOTOC__

Универсальная среда разработки Agava

2026-03-27T09:49:45Z

TaushkanovKV: /* Режим симулятора */

Универсальная среда разработки предназначена для создания и редактирования программного обеспечения для панелей оператора АГАВА ПО, многоканальных программируемых реле АГАВА МПР-60 и систем диспетчеризации на базе SCADA-системы AgavaSCADA.

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

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

=== Версии программного обеспечения ===
{{Внимание|Текст=При использовании среды разработки совместно с панелями оператора АГАВА ПО или многоканальными программируемыми реле АГАВА МПР-60 необходимо использовать соответствующую версию среды разработки|Тип=Восклицание синий.png}}
Для определения подходящей версии среды разработки необходимо определить версию среды исполнения, установленной в панели оператора или реле. Тип и версия среды исполнения указаны в системной утилите прибора. Например, "AgavaPLC 1.1", "AgavaPLC 1.2" и т.д. Для использования со средой исполнения AgavaPLC 1.1 необходимо использовать среду разработки версии 1.1, для среды исполнения AgavaPLC 1.2 необходима среда разработки версии 1.2 и так далее.

=== Дополнительные статьи и документы ===
*[[Узлы проекта AgavaSCADA/AgavaPLC|Описание узлов AgavaSCADA/AgavaPLC]].
*[[Свойства узлов в AgavaSCADA/AgavaPLC]].
*[[Транспорты AgavaSCADA/AgavaPLC]].
*[[Описание языка С++ в AgavaPLC|Описание языка С++ в AgavaSCADA/AgavaPLC]]..
*[[Объектная модель AgavaSCADA/AgavaPLC]].
*[[Описание базовых классов AgavaSCADA/AgavaPLC]].
*[[Коды ошибок и предупреждений AgavaSCADA/AgavaPLC]].
*[[Рекомендации по разработке приложений AgavaSCADA/AgavaPLC]].
Полный перечень всех документов, связанных с разработкой приложений на AgavaSCADA/AgavaPLC, приведен на странице [[:Категория:AgavaSCADA/AgavaPLC|категории AgavaSCADA/AgavaPLC]].

== Разработка проекта ==

=== Создание нового проекта ===
Создание нового проекта в среде разработки осуществляется с помощью команды «Создать проект…» в меню «Файл». После вызова данной команды откроется диалоговое окно создания нового проекта (см. Рисунок 1).
[[Файл:AgavaPLC-Создание проекта.png|мини|Рисунок 1 - Окно "Создание нового проекта"]]
Для создания проекта необходимо в списке типов проектов выбрать необходимый, ввести имя проекта и путь для его сохранения, после чего нажать кнопку «Создать проект».

Доступны несколько типов проектов:

* «Пустой проект» – пустой проект, не содержащий никаких узлов. Данный тип можно использовать для создания произвольного проекта "с нуля".
* «Локальный проект» – предварительно настроенный проект, содержащий необходимые подсистемы и предназначенный для реализации простой системы для одного устройства, при выборе данного типа пользователь имеет возможность выбрать нужные ему подсистемы и получить полностью рабочий проект в минимальной конфигурации.
* «Проект АГАВА ПО-40» - проект, предназначенный для исполнения на панели оператора АГАВА ПО-40.
* «Проект АГАВА ПО-50» - проект, предназначенный для исполнения на панели оператора АГАВА ПО-50.
* «Проект АГАВА МПР-60» - проект, предназначенный для исполнения на контроллере АГАВА МПР-60.
* «Проект АГАВА ПЛК-70.А» - проект, предназначенный для исполнения на контроллере АГАВА ПЛК-70.А.

=== Редактирование существующего проекта ===
Редактирование существующего проекта начинается с открытия файла проекта путем вызова команды «Открыть…» в меню «Файл». После загрузки файла в основном окне среды разработки будут отображены свойства и параметры проекта (см. Рисунок 2).
[[Файл:AgavaPLC-Основное окно среды разработки.png|мини|Рисунок 2 – Основное окно среды разработки AgavaPLC с загруженным проектом]]
По умолчанию основное окно среды разработки содержит перечисленные ниже части:

# Строка заголовка приложения, панель меню и панель инструментов.
# Окно дерева проекта. Предоставляет доступ ко всей структуре проекта (см. раздел [[Узлы проекта AgavaSCADA/AgavaPLC|Узлы проекта]]).
# Окно свойств (см. раздел [[#Редактирование свойств узлов]] ).
# Область для отображения содержимого, например графического представления окна, текста программы или задачи ПЛК.
# Область вспомогательных окон:
## Окно "Сообщения".
## Окно "Ошибки".
## Окно "Точки останова".
## Окно "Ресурсы".
## Окно "Глобальные переменные".
## Окно "Выражения".
## Окно "Стек вызовов".
## Окно "Наблюдение".
## Окно "Локальные переменные".
## Окно "Поиск".

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

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

=== Структура и состав проекта ===
Типичный проект содержит следующие части:

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

Проект также может содержать следующие части:

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

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

Описание всех частей проекта и их узлов приведено в разделе 4.

=== Разработка проекта ===
[[Файл:AgavaPLC-Добавление узла в проект.png|мини|Рисунок 3 – Добавление узла в проект AgavaPLC]]
Перед началом разработки проекта рекомендуется проанализировать поставленную задачи и определить подсистемы, необходимые для её реализации. Взаимодействие с подсистемами осуществляется через дерево проекта (см. Рисунок 2), в которое добавляются нужные узлы. Для добавления нового узла, необходимо нажать правой кнопкой мыши на узел верхнего уровня, которому он подчинён, и выбрать в контекстном меню команду «Добавить узел».

Основные части типовой программы и способы их реализации приведены ниже.

==== Взаимодействие с внешними устройствами ====
Реализуется через подсистему «Транспорты» в окне дерева проекта. Необходимо добавить в нее нужные протоколы, в зависимости от имеющейся конфигурации контроллера.
[[Файл:AgavaPLC-Транспорты.png|мини|Рисунок 4 - Транспорты в дереве проекта AgavaPLC]]
# Транспорт для обмена с субмодулями контроллера (для контроллеров с корзиной субмодулей). В качестве порта транспорта необходимо указать “/dev/ttyS0”. В проекте для МПР-60 присутствует по-умолчанию.
# Транспорт последовательный (для управления по RS-232, RS-485 и т.д.).
# Транспорт TCP/IP (для управления по Ethernet).

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

==== Визуализация данных ====
Визуализация данных технологических процессов реализуется с помощью элементов подсистемы «Визуализация».

Система визуализации недоступна в проектах для контроллеров МПР.
[[Файл:AgavaPLC-Пример визуализации.png|мини|Рисунок 5 - Пример визуализации]]
Визуализация содержит одно или несколько окон, описанных ниже.

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

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

Редактирование содержимого окна или композиции осуществляется в его графическом представлении (см. раздел [[#Редактирование графического представления узла]]).

Более подробное описание подсистемы визуализации приведено в разделе [[#Подсистема визуализации]].

==== Пользовательские алгоритмы ====
Реализовать нужные алгоритмы работы программы можно с помощью различных инструментов, которые выбираются в зависимости от сложности проектов и навыков программиста:

# Операции в группе «Сигналы» – отдельные логические операции. В основном используются для небольших проектов, не требующих сложных методов управления;
# Задачи ПЛК – графическое программирование с помощью связывания между собой различных функциональных блоков. Подходит для больших проектов. Реализуется в узле «Задача ПЛК» группы «Задачи». Подробное описание приведено в разделе [[#Задача ПЛК]]'''.'''
# Скрипты С++ – текстовое программирование на языке высокого уровня. Подходит для больших проектов. Реализуется с помощью операций «Скрипт С++», расположенных в группе «Сигналы» или в задаче ПЛК. Описание реализации языка С++ приведено на странице [[Описание языка С++ в AgavaPLC]].
=== Редактирование свойств узлов ===
Среда разработки обладает развитыми возможностями по редактированию свойств узлов. Описание доступных типов свойств приведно в статье [[Свойства узлов в AgavaPLC/AgavaSCADA]].

==== Редактирование свойств узлов с помощью окна «Свойства» ====
[[Файл:AgavaPLC-Окно "Свойства".png|мини|Рисунок 6 – Окно «Свойства» виджета «Кнопка»]]
Редактирование свойств всех узлов осуществляется с помощью окна «Свойства».

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

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

==== Групповое редактирование свойств узлов ====
При необходимости редактирования разных свойств у большого количества узлов можно воспользоваться специальным окном «Список узлов».
[[Файл:AgavaPLC-Окно "Список узлов".png|мини|Рисунок 7 - Окно "Список узлов"]]
Открытие окна выполняется с помощью вызова команды «Открыть список узлов» в контекстном меню дерева конфигурации. Открытое окно содержит все узлы, вложенные в выбранные при вызове команды.

Окно позволяет редактировать свойства непосредственно в ячейках таблицы, без переключения на окно «Свойства». Групповое редактирование свойств узлов через окно «Свойства» также доступно.

Щелчок правой кнопкой мыши на списке вызывает контекстное меню, содержащее команды:

* “Свойства”;
* “Экспорт в *.txt”;
* “Импорт из *.txt”;
* “Удалить узел”.

Команда «Свойства» открывает диалоговое окно выбора отображаемых свойств.

Команды «Экспорт», «Импорт» выполняют экспорт списка свойств узлов в текстовый файл и импорт соответственно.

Команда «Удалить узел» производит удаление выделенного узла (узлов).

==== Функция групповой замены источников в узлах ====
При разработке сложных проектов может возникнуть необходимость заменить источники сразу в большом количестве узлов. Для этой цели используется функция групповой замены источников. Необходимо перейти в редактирование свойств типа «Список источников», которое производится в соответствующем окне (см. Рисунок 8).
[[Файл:AgavaPLC-Окно редактирования свойств типа «Список источников».png|мини|Рисунок 8 - Окно редактирования свойств типа «Список источников»]]
Затем необходимо использовать функцию групповой замены (см. Рисунок 9), выделив нужные узлы, нажав на них правой кнопкой мыши и выбрав «Групповая замена».
[[Файл:AgavaPLC-Окно функции «Групповая замена».png|мини|Рисунок 9 - Окно функции «Групповая замена»]]

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

* фрейм;
* форма;
* окно с композицией;
* слой.

Открытое графическое представление выбранного узла может содержать все уже размещенные на нем элементы визуализации и (или) другие узлы и позволяет добавить новые.
[[Файл:AgavaPLC–Открытое графическое представление окна «winMain».png|мини|Рисунок 10 – Открытое графическое представление окна «winMain»]]
На рисунке 10 представлено графическое представление окна «winMain», обведенное пунктирной рамкой серого цвета, обозначающей внешнюю границу открытого узла. Тип рамки пользователь может выбрать по своему усмотрению, выбор производится в окне настроек среды разработки, доступном через команду «Настройки» в меню «Параметры».

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

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

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

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

Для связи виджетов с источниками данных можно воспользоваться обычным способом связывания через окно «Свойства». К примеру, связывание размещенного на форме виджета «Текстовая метка» с регистром Modbus осуществляется добавлением регистра Modbus в свойство виджета «Источник».

Вместе с обычным способом связывания существует и другой, более быстрый способ. Для быстрого связывания регистра с виджетом достаточно нажать на регистр в дереве конфигурации левой кнопкой мыши и перенести его на виджет в открытом графическом представлении.
[[Файл:AgavaPLC–Связывание узла «sourceModbusRegister0» и виджета.png|мини|Рисунок 11 – Связывание узла «sourceModbusRegister0» и виджета]]
При помещении курсора над виджетом последний будет заштрихован сеткой зеленого или красного цвета, а курсор изменит свой вид на стрелку с квадратиком (см. рисунок 11).

Зеленая штриховка виджета означает отсутствие связи выделенного виджета с источником данных, в этом случае связывание будет произведено. Красная штриховка говорит об ошибках связывания виджета и сигнала/источника.

==== Редактирование многослойных композиций ====
Редактирование многослойных композиций принципиально не отличается от редактирования форм, кроме одного нюанса. Так как композиция может состоять из нескольких слоев, и виджеты на слоях могут располагаться один над другим, для использования наиболее удобного способа редактирования такой композиции можно воспользоваться возможностью открытия каждого слоя в отдельном окне.
[[Файл:AgavaPLC–Пример структуры композиции «Composition1», состоящей из трех слоев.png|мини|Рисунок 12 – Пример структуры композиции «Composition1», состоящей из трех слоев]]
Для открытия графического представления слоя нужно воспользоваться командой «Открыть графическое представление» аналогично открытию графического представления формы или композиции.

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

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

==== Использование якорей ====
Данная возможность доступна с версии <code>AS 1.6.32+</code>.

При работе с графическими представлениями окон и композиций, содержащих большое количество виджетов, могут быть полезны якоря - создаваемые пользователем метки на размерных линейках.
[[Файл:AgavaPLC-Графическое представление-якоря.png|мини|AS 1.6.32+: Графическое представление формы с установленными якорями]]
Якоря позволяют контролировать положение групп виджетов благодаря связанным с ними линиям привязки. Линии привязки, позволяют быстрее выстраивать группы виджетов благодяря "прилипанию".

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

* Двойным кликом левой кнопки мыши по размерной линейке.
* Кликом правой кнопки мыши на размерной линейке и выбором команды "Добавить якорь".

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

* Двойным кликом левой кнопки мыши по якорю на размерной линейке.
* Кликом правой кнопки мыши на размерной линейке и выбором команды "Удалить якорь".

Созданные якоря можно перемещать по размерной линейке с помощью мыши.

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

== Проверка и отладка проекта ==

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

Для этого необходимо:

# Установить текущий проект как проект по умолчанию. Для этого необходимо вызвать команду "Проект->Установить проект по умолчанию..." и выбрать ранее сохраненный файл конфигурации.
# Запустить среду исполнения. Для этого нужно вызвать команду меню "Проект->Запуск среды исполнения". После этого будет выполнен запуск в новом окне среды исполнения.

=== Мониторинг сигналов ===
[[Файл:AgavaPLC–Окно "Наблюдение".png|мини|Рисунок 14 – Окно "Наблюдение"|ссылка=Файл:AgavaPLC–Окно_%22Наблюдение%22.png]]
Функция мониторинга сигналов позволяет наблюдать значения, хранящиеся в узлах проекта при исполнении проекта на целевом устройстве.

Для запуска данной функции необходимо:

# Запустить среду исполнения.
# Вызвать команду меню «<code>Устройство → Подключение/отключение</code>», в появившемся окне выбрать IP-адрес и порт устройства, значения узлов которого необходимо мониторить. При необходимости просмотра значений узлов и сигналов в режиме эмуляции проекта на персональном компьютере укажите адрес 127.0.0.1. Если необходимо просматривать значения узлов проекта, выполняющегося на контроллере или панели оператора, укажите IP-адрес контроллера или панели.
# Нажать кнопку «Подключение».

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

Для добавления узлов в окно "Наблюдение" необходимо нажать на нужном узле в дереве проекта правой кнопкой мыши и выбрать команду «<code>Добавить в окно наблюдения</code>». Выбранные узлы будут отображаться в окне «Наблюдение» вместе со считанными значениями.

=== Мониторинг событий ===
[[Файл:AgavaPLC–Окно просмотра событий.png|мини|Рисунок 15 – Окно просмотра событий]]Мониторинг событий позволяет наблюдать за исполнением проекта, работающего в устройстве. При включении мониторинга пользователь получает информацию о возникающих нефатальных ошибках и предупреждениях, возникающих в ходе исполнения проекта со следующими признаками:

* метка времени, соответствующая времени возникновения события;
* степень важности события;
* тип события - информационное или события активирования, деактивирования и квитирования тревог;
* имя узла, сформировавшего событие.
* текст события.

==== Использование мониторинга ====
Для старта мониторинга необходимо подключиться к нужному устройству способом, рассмотренным в разделе [[#Мониторинг сигналов]], а затем вызвать команду «<code>Устройство → Просмотр событий</code>». В открывшемся окне будут выводиться все события, регистрируемые устройством.

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

==== Фильтрация событий ====
''Функция доступна начиная с версии <code>AgavaSCADA/AgavaPLC 1.2.56+, 1.5.25+</code>.''

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

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

=== Отладка в задаче ПЛК ===
''Данный раздел актуален для версии <code>AS 1.2.61</code> и старее. В версиях <code>AS 1.6+</code> используется [[Универсальная среда разработки Agava#Отладка проекта|современный пошаговый отладчик]].''

Задача ПЛК (см. раздел [[#Задача ПЛК]]) позволяет проводить тестирование проектов с помощью режима симулятора (на компьютере, без использования контроллера) или онлайн отладки (на контроллере).

==== Управление отладкой ====
Управление режимом симуляции и онлайн отладкой осуществляется с помощью панели инструментов задачи ПЛК (см. рисунок 16).

Панель инструментов содержит следующие элементы:

* Кнопка «Запустить симуляцию».
* Кнопка «Сделать шаг на один цикл».
* Кнопка «Приостановить симуляцию» - ставит выполнение задачи на паузу.
* Кнопка «Остановить симуляцию» - сбрасывает состояние всех блоков к их состоянию по умолчанию.
* Список выбора периода выполнения задачи.
* Кнопка «Показать окно «Наблюдение».

==== Режим симулятора ====
[[Файл:AgavaPLC-Панель инструментов задачи ПЛК.png|мини|Рисунок 16 - Панель инструментов задачи ПЛК]]
Режим симулятора позволяет провести тестирование работы алгоритмов проекта на компьютере. С помощью симуляции можно выявить ошибки в работе алгоритмов проекта до его загрузки в контроллер.

Управление симуляцией осуществляется через команды на панели инструментов задачи ПЛК.

Для перехода в режим симуляции нажмите кнопку «Режим симулятора» на панели управления задачи ПЛК.

После активации режима симуляции, для изменения значения входа дважды щелкните на нем левой кнопкой мыши и выберите нужный тип и значение. Текущие значения всех блоков, в соответствии с работой программы, будут отображаться в реальном времени.
[[Файл:AgavaPLC–Вид блоков задачи в режиме симулятора.png|мини|Рисунок 17 – Вид блоков задачи в режиме симулятора]]
Для выхода из режима симуляции повторно нажмите кнопку «Режим симуляции» на панели управления задачи ПЛК.

==== Онлайн отладка ====
Режим онлайн отладки позволяет провести тестирование проекта, загруженного и исполняемого в контроллере. Для перехода в режим онлайн отладки загрузите конфигурацию в контроллер, подключитесь к нему, после чего нажмите кнопку «Онлайн отладка» на панели инструментов задачи ПЛК.
[[Файл:AgavaPLC–Вид блоков задачи в режиме онлайн отладки.png|мини|Рисунок 18 – Вид блоков задачи в режиме онлайн отладки]]
На рисунке 18 изображен вид задачи ПЛК в режиме онлайн отладки проекта, запущенного на МПР-60 с установленными субмодулями DI (входы) и R (выходы).

Для онлайн отладки на панели инструментов недоступны кнопка «Приостановить симуляцию» и список выбора периода.

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

=== Проверка проекта ===
[[Файл:AgavaPLC–Окно «Ошибки».png|мини|Рисунок 19 – Окно «Ошибки»]]
Перед сохранением проекта желательно выполнить его проверку на наличие ошибок с помощью команды «Проект->Проверить проект». После проверки обнаруженные ошибки будут отображены в окне «Ошибки».

Если отображение окна «Ошибки» выключено, его можно включить командой «Вид->Показать окно ошибок».

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

Также щелчок левой кнопкой мыши на строке с ошибкой открывает окно «Свойства» и дает возможность изменить в нем все свойства узла, содержащего ошибку.

==== Установка пароля на файл конфигурации ====
[[Файл:AgavaPLC–Установка пароля.png|мини|Рисунок 13 – Установка пароля]]
Файл конфигурации, загружаемый в контроллер или панель оператора, можно защитить паролем, чтобы предотвратить его несанкционированное изменение.

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

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

== Загрузка проекта в устройство ==
Загрузка проекта в целевое устройство может быть осуществлена несколькими способами:

* загрузка из среды разработки;
* загрузка с помощью USB-Flash накопителя (для панелей оператора);
* загрузка через браузер (для МПР-60).

=== Загрузка из среды разработки ===
[[Файл:AgavaPLC–Окно «Загрузка проекта в устройство» после подключения к контроллеру.png|мини|Рисунок 20 – Окно «Загрузка проекта в устройство» после подключения к контроллеру]]
Для загрузки проекта из среды разработки необходимо произвести следующие действия в указанном порядке:

# Создайте файл конфигурации.
# Выполните подключение целевого устройства к ПК по сети Ethernet.
# После подключения вызовите в среде разработки команду «Проект->Загрузка проекта в устройство».
# В открывшемся окне будет отображен список файлов проекта, доступных для загрузки в целевое устройство.
# Выберите необходимые файлы и нажмите кнопку «Загрузить». После нажатия кнопки начнется процесс загрузки файлов, при этом в нижней части окна будет меняться состояние полосы прогресса, а также для каждого файла в таблице будет отображен результат загрузки.
# После окончания загрузки среда исполнения в целевом устройстве будет перезапущена и загруженный проект будет запущен.

=== Загрузка через USB-Flash (для ПО-40 и ПО-50) ===
Для загрузки проекта в устройство с помощью USB-Flash накопителя необходимо произвести следующие действия в указанном порядке:

# Подготовьте USB-Flash накопитель, предварительно отформатировав его в файловую систему FAT32.
# Вызовите в среде разработки команду «Подготовка архива для обновления» в меню «Проект».
# Сохраните архив в корень USB-Flash накопителя.
# Перейдите в системную утилиту, перезагрузив панель оператора, при загрузке во время однократного звукового сигнала нажмите на экран и удерживайте до повторного звукового сигнала. Введите пароль: 111111.
# Перейдите на вкладку «Обновление», затем подключите USB-Flash накопитель через переходник USB-OTG, выберите из списка загрузочный архив, нажать кнопку «Обновить». Дождитесь сообщения «Обновление успешно» и нажмите кнопку «ОК».
# Перейдите на вкладку «Перезапуск» и нажмите кнопку «Перезапуск».
После перезагрузки панели загруженный проект будет запущен.

=== Загрузка через браузер (для МПР-60) ===
Для загрузки проекта через браузер необходимо произвести следующие действия в указанном порядке.

# Вызовите в среде разработки команду «Подготовка архива для обновления» в меню «Проект».
# Сохраните архив.
# Откройте системную утилиту, введя IP-адрес контроллера в адресную строку браузера.
# Перейдите на вкладку «Загрузка ПО». Рисунок 71 - Вкладка системной утилиты «Загрузка ПО»
# Выберите на компьютере архив с проектом, который необходимо загрузить в контроллер.
# Нажмите кнопку «Загрузить».
# Дождитесь окончания загрузки файла и обновления проекта.

== Отладка проекта ==
''Данный функционал доступен в версиях <code>AS 1.6+</code>. Для версий <code>AS 1.2</code> используйте мониторинг, [[Универсальная среда разработки Agava#Отладка в задаче ПЛК|отладку в задачах ПЛК]].''

=== Локальная отладка ===

=== Удаленная отладка ===
[[Категория:AgavaSCADA/AgavaPLC]]

Универсальная среда разработки Agava

2026-03-27T09:48:05Z

TaushkanovKV: /* Редактирование существующего проекта */

Универсальная среда разработки предназначена для создания и редактирования программного обеспечения для панелей оператора АГАВА ПО, многоканальных программируемых реле АГАВА МПР-60 и систем диспетчеризации на базе SCADA-системы AgavaSCADA.

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

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

=== Версии программного обеспечения ===
{{Внимание|Текст=При использовании среды разработки совместно с панелями оператора АГАВА ПО или многоканальными программируемыми реле АГАВА МПР-60 необходимо использовать соответствующую версию среды разработки|Тип=Восклицание синий.png}}
Для определения подходящей версии среды разработки необходимо определить версию среды исполнения, установленной в панели оператора или реле. Тип и версия среды исполнения указаны в системной утилите прибора. Например, "AgavaPLC 1.1", "AgavaPLC 1.2" и т.д. Для использования со средой исполнения AgavaPLC 1.1 необходимо использовать среду разработки версии 1.1, для среды исполнения AgavaPLC 1.2 необходима среда разработки версии 1.2 и так далее.

=== Дополнительные статьи и документы ===
*[[Узлы проекта AgavaSCADA/AgavaPLC|Описание узлов AgavaSCADA/AgavaPLC]].
*[[Свойства узлов в AgavaSCADA/AgavaPLC]].
*[[Транспорты AgavaSCADA/AgavaPLC]].
*[[Описание языка С++ в AgavaPLC|Описание языка С++ в AgavaSCADA/AgavaPLC]]..
*[[Объектная модель AgavaSCADA/AgavaPLC]].
*[[Описание базовых классов AgavaSCADA/AgavaPLC]].
*[[Коды ошибок и предупреждений AgavaSCADA/AgavaPLC]].
*[[Рекомендации по разработке приложений AgavaSCADA/AgavaPLC]].
Полный перечень всех документов, связанных с разработкой приложений на AgavaSCADA/AgavaPLC, приведен на странице [[:Категория:AgavaSCADA/AgavaPLC|категории AgavaSCADA/AgavaPLC]].

== Разработка проекта ==

=== Создание нового проекта ===
Создание нового проекта в среде разработки осуществляется с помощью команды «Создать проект…» в меню «Файл». После вызова данной команды откроется диалоговое окно создания нового проекта (см. Рисунок 1).
[[Файл:AgavaPLC-Создание проекта.png|мини|Рисунок 1 - Окно "Создание нового проекта"]]
Для создания проекта необходимо в списке типов проектов выбрать необходимый, ввести имя проекта и путь для его сохранения, после чего нажать кнопку «Создать проект».

Доступны несколько типов проектов:

* «Пустой проект» – пустой проект, не содержащий никаких узлов. Данный тип можно использовать для создания произвольного проекта "с нуля".
* «Локальный проект» – предварительно настроенный проект, содержащий необходимые подсистемы и предназначенный для реализации простой системы для одного устройства, при выборе данного типа пользователь имеет возможность выбрать нужные ему подсистемы и получить полностью рабочий проект в минимальной конфигурации.
* «Проект АГАВА ПО-40» - проект, предназначенный для исполнения на панели оператора АГАВА ПО-40.
* «Проект АГАВА ПО-50» - проект, предназначенный для исполнения на панели оператора АГАВА ПО-50.
* «Проект АГАВА МПР-60» - проект, предназначенный для исполнения на контроллере АГАВА МПР-60.
* «Проект АГАВА ПЛК-70.А» - проект, предназначенный для исполнения на контроллере АГАВА ПЛК-70.А.

=== Редактирование существующего проекта ===
Редактирование существующего проекта начинается с открытия файла проекта путем вызова команды «Открыть…» в меню «Файл». После загрузки файла в основном окне среды разработки будут отображены свойства и параметры проекта (см. Рисунок 2).
[[Файл:AgavaPLC-Основное окно среды разработки.png|мини|Рисунок 2 – Основное окно среды разработки AgavaPLC с загруженным проектом]]
По умолчанию основное окно среды разработки содержит перечисленные ниже части:

# Строка заголовка приложения, панель меню и панель инструментов.
# Окно дерева проекта. Предоставляет доступ ко всей структуре проекта (см. раздел [[Узлы проекта AgavaSCADA/AgavaPLC|Узлы проекта]]).
# Окно свойств (см. раздел [[#Редактирование свойств узлов]] ).
# Область для отображения содержимого, например графического представления окна, текста программы или задачи ПЛК.
# Область вспомогательных окон:
## Окно "Сообщения".
## Окно "Ошибки".
## Окно "Точки останова".
## Окно "Ресурсы".
## Окно "Глобальные переменные".
## Окно "Выражения".
## Окно "Стек вызовов".
## Окно "Наблюдение".
## Окно "Локальные переменные".
## Окно "Поиск".

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

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

=== Структура и состав проекта ===
Типичный проект содержит следующие части:

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

Проект также может содержать следующие части:

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

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

Описание всех частей проекта и их узлов приведено в разделе 4.

=== Разработка проекта ===
[[Файл:AgavaPLC-Добавление узла в проект.png|мини|Рисунок 3 – Добавление узла в проект AgavaPLC]]
Перед началом разработки проекта рекомендуется проанализировать поставленную задачи и определить подсистемы, необходимые для её реализации. Взаимодействие с подсистемами осуществляется через дерево проекта (см. Рисунок 2), в которое добавляются нужные узлы. Для добавления нового узла, необходимо нажать правой кнопкой мыши на узел верхнего уровня, которому он подчинён, и выбрать в контекстном меню команду «Добавить узел».

Основные части типовой программы и способы их реализации приведены ниже.

==== Взаимодействие с внешними устройствами ====
Реализуется через подсистему «Транспорты» в окне дерева проекта. Необходимо добавить в нее нужные протоколы, в зависимости от имеющейся конфигурации контроллера.
[[Файл:AgavaPLC-Транспорты.png|мини|Рисунок 4 - Транспорты в дереве проекта AgavaPLC]]
# Транспорт для обмена с субмодулями контроллера (для контроллеров с корзиной субмодулей). В качестве порта транспорта необходимо указать “/dev/ttyS0”. В проекте для МПР-60 присутствует по-умолчанию.
# Транспорт последовательный (для управления по RS-232, RS-485 и т.д.).
# Транспорт TCP/IP (для управления по Ethernet).

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

==== Визуализация данных ====
Визуализация данных технологических процессов реализуется с помощью элементов подсистемы «Визуализация».

Система визуализации недоступна в проектах для контроллеров МПР.
[[Файл:AgavaPLC-Пример визуализации.png|мини|Рисунок 5 - Пример визуализации]]
Визуализация содержит одно или несколько окон, описанных ниже.

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

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

Редактирование содержимого окна или композиции осуществляется в его графическом представлении (см. раздел [[#Редактирование графического представления узла]]).

Более подробное описание подсистемы визуализации приведено в разделе [[#Подсистема визуализации]].

==== Пользовательские алгоритмы ====
Реализовать нужные алгоритмы работы программы можно с помощью различных инструментов, которые выбираются в зависимости от сложности проектов и навыков программиста:

# Операции в группе «Сигналы» – отдельные логические операции. В основном используются для небольших проектов, не требующих сложных методов управления;
# Задачи ПЛК – графическое программирование с помощью связывания между собой различных функциональных блоков. Подходит для больших проектов. Реализуется в узле «Задача ПЛК» группы «Задачи». Подробное описание приведено в разделе [[#Задача ПЛК]]'''.'''
# Скрипты С++ – текстовое программирование на языке высокого уровня. Подходит для больших проектов. Реализуется с помощью операций «Скрипт С++», расположенных в группе «Сигналы» или в задаче ПЛК. Описание реализации языка С++ приведено на странице [[Описание языка С++ в AgavaPLC]].
=== Редактирование свойств узлов ===
Среда разработки обладает развитыми возможностями по редактированию свойств узлов. Описание доступных типов свойств приведно в статье [[Свойства узлов в AgavaPLC/AgavaSCADA]].

==== Редактирование свойств узлов с помощью окна «Свойства» ====
[[Файл:AgavaPLC-Окно "Свойства".png|мини|Рисунок 6 – Окно «Свойства» виджета «Кнопка»]]
Редактирование свойств всех узлов осуществляется с помощью окна «Свойства».

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

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

==== Групповое редактирование свойств узлов ====
При необходимости редактирования разных свойств у большого количества узлов можно воспользоваться специальным окном «Список узлов».
[[Файл:AgavaPLC-Окно "Список узлов".png|мини|Рисунок 7 - Окно "Список узлов"]]
Открытие окна выполняется с помощью вызова команды «Открыть список узлов» в контекстном меню дерева конфигурации. Открытое окно содержит все узлы, вложенные в выбранные при вызове команды.

Окно позволяет редактировать свойства непосредственно в ячейках таблицы, без переключения на окно «Свойства». Групповое редактирование свойств узлов через окно «Свойства» также доступно.

Щелчок правой кнопкой мыши на списке вызывает контекстное меню, содержащее команды:

* “Свойства”;
* “Экспорт в *.txt”;
* “Импорт из *.txt”;
* “Удалить узел”.

Команда «Свойства» открывает диалоговое окно выбора отображаемых свойств.

Команды «Экспорт», «Импорт» выполняют экспорт списка свойств узлов в текстовый файл и импорт соответственно.

Команда «Удалить узел» производит удаление выделенного узла (узлов).

==== Функция групповой замены источников в узлах ====
При разработке сложных проектов может возникнуть необходимость заменить источники сразу в большом количестве узлов. Для этой цели используется функция групповой замены источников. Необходимо перейти в редактирование свойств типа «Список источников», которое производится в соответствующем окне (см. Рисунок 8).
[[Файл:AgavaPLC-Окно редактирования свойств типа «Список источников».png|мини|Рисунок 8 - Окно редактирования свойств типа «Список источников»]]
Затем необходимо использовать функцию групповой замены (см. Рисунок 9), выделив нужные узлы, нажав на них правой кнопкой мыши и выбрав «Групповая замена».
[[Файл:AgavaPLC-Окно функции «Групповая замена».png|мини|Рисунок 9 - Окно функции «Групповая замена»]]

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

* фрейм;
* форма;
* окно с композицией;
* слой.

Открытое графическое представление выбранного узла может содержать все уже размещенные на нем элементы визуализации и (или) другие узлы и позволяет добавить новые.
[[Файл:AgavaPLC–Открытое графическое представление окна «winMain».png|мини|Рисунок 10 – Открытое графическое представление окна «winMain»]]
На рисунке 10 представлено графическое представление окна «winMain», обведенное пунктирной рамкой серого цвета, обозначающей внешнюю границу открытого узла. Тип рамки пользователь может выбрать по своему усмотрению, выбор производится в окне настроек среды разработки, доступном через команду «Настройки» в меню «Параметры».

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

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

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

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

Для связи виджетов с источниками данных можно воспользоваться обычным способом связывания через окно «Свойства». К примеру, связывание размещенного на форме виджета «Текстовая метка» с регистром Modbus осуществляется добавлением регистра Modbus в свойство виджета «Источник».

Вместе с обычным способом связывания существует и другой, более быстрый способ. Для быстрого связывания регистра с виджетом достаточно нажать на регистр в дереве конфигурации левой кнопкой мыши и перенести его на виджет в открытом графическом представлении.
[[Файл:AgavaPLC–Связывание узла «sourceModbusRegister0» и виджета.png|мини|Рисунок 11 – Связывание узла «sourceModbusRegister0» и виджета]]
При помещении курсора над виджетом последний будет заштрихован сеткой зеленого или красного цвета, а курсор изменит свой вид на стрелку с квадратиком (см. рисунок 11).

Зеленая штриховка виджета означает отсутствие связи выделенного виджета с источником данных, в этом случае связывание будет произведено. Красная штриховка говорит об ошибках связывания виджета и сигнала/источника.

==== Редактирование многослойных композиций ====
Редактирование многослойных композиций принципиально не отличается от редактирования форм, кроме одного нюанса. Так как композиция может состоять из нескольких слоев, и виджеты на слоях могут располагаться один над другим, для использования наиболее удобного способа редактирования такой композиции можно воспользоваться возможностью открытия каждого слоя в отдельном окне.
[[Файл:AgavaPLC–Пример структуры композиции «Composition1», состоящей из трех слоев.png|мини|Рисунок 12 – Пример структуры композиции «Composition1», состоящей из трех слоев]]
Для открытия графического представления слоя нужно воспользоваться командой «Открыть графическое представление» аналогично открытию графического представления формы или композиции.

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

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

==== Использование якорей ====
Данная возможность доступна с версии <code>AS 1.6.32+</code>.

При работе с графическими представлениями окон и композиций, содержащих большое количество виджетов, могут быть полезны якоря - создаваемые пользователем метки на размерных линейках.
[[Файл:AgavaPLC-Графическое представление-якоря.png|мини|AS 1.6.32+: Графическое представление формы с установленными якорями]]
Якоря позволяют контролировать положение групп виджетов благодаря связанным с ними линиям привязки. Линии привязки, позволяют быстрее выстраивать группы виджетов благодяря "прилипанию".

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

* Двойным кликом левой кнопки мыши по размерной линейке.
* Кликом правой кнопки мыши на размерной линейке и выбором команды "Добавить якорь".

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

* Двойным кликом левой кнопки мыши по якорю на размерной линейке.
* Кликом правой кнопки мыши на размерной линейке и выбором команды "Удалить якорь".

Созданные якоря можно перемещать по размерной линейке с помощью мыши.

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

== Проверка и отладка проекта ==

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

Для этого необходимо:

# Установить текущий проект как проект по умолчанию. Для этого необходимо вызвать команду "Проект->Установить проект по умолчанию..." и выбрать ранее сохраненный файл конфигурации.
# Запустить среду исполнения. Для этого нужно вызвать команду меню "Проект->Запуск среды исполнения". После этого будет выполнен запуск в новом окне среды исполнения.

=== Мониторинг сигналов ===
[[Файл:AgavaPLC–Окно "Наблюдение".png|мини|Рисунок 14 – Окно "Наблюдение"|ссылка=Файл:AgavaPLC–Окно_%22Наблюдение%22.png]]
Функция мониторинга сигналов позволяет наблюдать значения, хранящиеся в узлах проекта при исполнении проекта на целевом устройстве.

Для запуска данной функции необходимо:

# Запустить среду исполнения.
# Вызвать команду меню «<code>Устройство → Подключение/отключение</code>», в появившемся окне выбрать IP-адрес и порт устройства, значения узлов которого необходимо мониторить. При необходимости просмотра значений узлов и сигналов в режиме эмуляции проекта на персональном компьютере укажите адрес 127.0.0.1. Если необходимо просматривать значения узлов проекта, выполняющегося на контроллере или панели оператора, укажите IP-адрес контроллера или панели.
# Нажать кнопку «Подключение».

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

Для добавления узлов в окно "Наблюдение" необходимо нажать на нужном узле в дереве проекта правой кнопкой мыши и выбрать команду «<code>Добавить в окно наблюдения</code>». Выбранные узлы будут отображаться в окне «Наблюдение» вместе со считанными значениями.

=== Мониторинг событий ===
[[Файл:AgavaPLC–Окно просмотра событий.png|мини|Рисунок 15 – Окно просмотра событий]]Мониторинг событий позволяет наблюдать за исполнением проекта, работающего в устройстве. При включении мониторинга пользователь получает информацию о возникающих нефатальных ошибках и предупреждениях, возникающих в ходе исполнения проекта со следующими признаками:

* метка времени, соответствующая времени возникновения события;
* степень важности события;
* тип события - информационное или события активирования, деактивирования и квитирования тревог;
* имя узла, сформировавшего событие.
* текст события.

==== Использование мониторинга ====
Для старта мониторинга необходимо подключиться к нужному устройству способом, рассмотренным в разделе [[#Мониторинг сигналов]], а затем вызвать команду «<code>Устройство → Просмотр событий</code>». В открывшемся окне будут выводиться все события, регистрируемые устройством.

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

==== Фильтрация событий ====
''Функция доступна начиная с версии <code>AgavaSCADA/AgavaPLC 1.2.56+, 1.5.25+</code>.''

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

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

=== Отладка в задаче ПЛК ===
''Данный раздел актуален для версии <code>AS 1.2.61</code> и старее. В версиях <code>AS 1.6+</code> используется [[Универсальная среда разработки Agava#Отладка проекта|современный пошаговый отладчик]].''

Задача ПЛК (см. раздел [[#Задача ПЛК]]) позволяет проводить тестирование проектов с помощью режима симулятора (на компьютере, без использования контроллера) или онлайн отладки (на контроллере).

==== Управление отладкой ====
Управление режимом симуляции и онлайн отладкой осуществляется с помощью панели инструментов задачи ПЛК (см. рисунок 16).

Панель инструментов содержит следующие элементы:

* Кнопка «Запустить симуляцию».
* Кнопка «Сделать шаг на один цикл».
* Кнопка «Приостановить симуляцию» - ставит выполнение задачи на паузу.
* Кнопка «Остановить симуляцию» - сбрасывает состояние всех блоков к их состоянию по умолчанию.
* Список выбора периода выполнения задачи.
* Кнопка «Показать окно «Наблюдение».

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

Управление симуляцией осуществляется через команды на панели инструментов задачи ПЛК.

Для перехода в режим симуляции нажмите кнопку «Режим симулятора» на панели управления задачи ПЛК.
[[Файл:AgavaPLC-Панель инструментов задачи ПЛК.png|мини|Рисунок 16 - Панель инструментов задачи ПЛК]]
После активации режима симуляции, для изменения значения входа дважды щелкните на нем левой кнопкой мыши и выберите нужный тип и значение. Текущие значения всех блоков, в соответствии с работой программы, будут отображаться в реальном времени.
[[Файл:AgavaPLC–Вид блоков задачи в режиме симулятора.png|мини|Рисунок 17 – Вид блоков задачи в режиме симулятора]]
Для выхода из режима симуляции повторно нажмите кнопку «Режим симуляции» на панели управления задачи ПЛК.

==== Онлайн отладка ====
Режим онлайн отладки позволяет провести тестирование проекта, загруженного и исполняемого в контроллере. Для перехода в режим онлайн отладки загрузите конфигурацию в контроллер, подключитесь к нему, после чего нажмите кнопку «Онлайн отладка» на панели инструментов задачи ПЛК.
[[Файл:AgavaPLC–Вид блоков задачи в режиме онлайн отладки.png|мини|Рисунок 18 – Вид блоков задачи в режиме онлайн отладки]]
На рисунке 18 изображен вид задачи ПЛК в режиме онлайн отладки проекта, запущенного на МПР-60 с установленными субмодулями DI (входы) и R (выходы).

Для онлайн отладки на панели инструментов недоступны кнопка «Приостановить симуляцию» и список выбора периода.

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

=== Проверка проекта ===
[[Файл:AgavaPLC–Окно «Ошибки».png|мини|Рисунок 19 – Окно «Ошибки»]]
Перед сохранением проекта желательно выполнить его проверку на наличие ошибок с помощью команды «Проект->Проверить проект». После проверки обнаруженные ошибки будут отображены в окне «Ошибки».

Если отображение окна «Ошибки» выключено, его можно включить командой «Вид->Показать окно ошибок».

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

Также щелчок левой кнопкой мыши на строке с ошибкой открывает окно «Свойства» и дает возможность изменить в нем все свойства узла, содержащего ошибку.

==== Установка пароля на файл конфигурации ====
[[Файл:AgavaPLC–Установка пароля.png|мини|Рисунок 13 – Установка пароля]]
Файл конфигурации, загружаемый в контроллер или панель оператора, можно защитить паролем, чтобы предотвратить его несанкционированное изменение.

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

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

== Загрузка проекта в устройство ==
Загрузка проекта в целевое устройство может быть осуществлена несколькими способами:

* загрузка из среды разработки;
* загрузка с помощью USB-Flash накопителя (для панелей оператора);
* загрузка через браузер (для МПР-60).

=== Загрузка из среды разработки ===
[[Файл:AgavaPLC–Окно «Загрузка проекта в устройство» после подключения к контроллеру.png|мини|Рисунок 20 – Окно «Загрузка проекта в устройство» после подключения к контроллеру]]
Для загрузки проекта из среды разработки необходимо произвести следующие действия в указанном порядке:

# Создайте файл конфигурации.
# Выполните подключение целевого устройства к ПК по сети Ethernet.
# После подключения вызовите в среде разработки команду «Проект->Загрузка проекта в устройство».
# В открывшемся окне будет отображен список файлов проекта, доступных для загрузки в целевое устройство.
# Выберите необходимые файлы и нажмите кнопку «Загрузить». После нажатия кнопки начнется процесс загрузки файлов, при этом в нижней части окна будет меняться состояние полосы прогресса, а также для каждого файла в таблице будет отображен результат загрузки.
# После окончания загрузки среда исполнения в целевом устройстве будет перезапущена и загруженный проект будет запущен.

=== Загрузка через USB-Flash (для ПО-40 и ПО-50) ===
Для загрузки проекта в устройство с помощью USB-Flash накопителя необходимо произвести следующие действия в указанном порядке:

# Подготовьте USB-Flash накопитель, предварительно отформатировав его в файловую систему FAT32.
# Вызовите в среде разработки команду «Подготовка архива для обновления» в меню «Проект».
# Сохраните архив в корень USB-Flash накопителя.
# Перейдите в системную утилиту, перезагрузив панель оператора, при загрузке во время однократного звукового сигнала нажмите на экран и удерживайте до повторного звукового сигнала. Введите пароль: 111111.
# Перейдите на вкладку «Обновление», затем подключите USB-Flash накопитель через переходник USB-OTG, выберите из списка загрузочный архив, нажать кнопку «Обновить». Дождитесь сообщения «Обновление успешно» и нажмите кнопку «ОК».
# Перейдите на вкладку «Перезапуск» и нажмите кнопку «Перезапуск».
После перезагрузки панели загруженный проект будет запущен.

=== Загрузка через браузер (для МПР-60) ===
Для загрузки проекта через браузер необходимо произвести следующие действия в указанном порядке.

# Вызовите в среде разработки команду «Подготовка архива для обновления» в меню «Проект».
# Сохраните архив.
# Откройте системную утилиту, введя IP-адрес контроллера в адресную строку браузера.
# Перейдите на вкладку «Загрузка ПО». Рисунок 71 - Вкладка системной утилиты «Загрузка ПО»
# Выберите на компьютере архив с проектом, который необходимо загрузить в контроллер.
# Нажмите кнопку «Загрузить».
# Дождитесь окончания загрузки файла и обновления проекта.

== Отладка проекта ==
''Данный функционал доступен в версиях <code>AS 1.6+</code>. Для версий <code>AS 1.2</code> используйте мониторинг, [[Универсальная среда разработки Agava#Отладка в задаче ПЛК|отладку в задачах ПЛК]].''

=== Локальная отладка ===

=== Удаленная отладка ===
[[Категория:AgavaSCADA/AgavaPLC]]

Универсальная среда разработки Agava

2026-03-27T09:46:26Z

TaushkanovKV: /* Редактирование существующего проекта */

Универсальная среда разработки предназначена для создания и редактирования программного обеспечения для панелей оператора АГАВА ПО, многоканальных программируемых реле АГАВА МПР-60 и систем диспетчеризации на базе SCADA-системы AgavaSCADA.

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

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

=== Версии программного обеспечения ===
{{Внимание|Текст=При использовании среды разработки совместно с панелями оператора АГАВА ПО или многоканальными программируемыми реле АГАВА МПР-60 необходимо использовать соответствующую версию среды разработки|Тип=Восклицание синий.png}}
Для определения подходящей версии среды разработки необходимо определить версию среды исполнения, установленной в панели оператора или реле. Тип и версия среды исполнения указаны в системной утилите прибора. Например, "AgavaPLC 1.1", "AgavaPLC 1.2" и т.д. Для использования со средой исполнения AgavaPLC 1.1 необходимо использовать среду разработки версии 1.1, для среды исполнения AgavaPLC 1.2 необходима среда разработки версии 1.2 и так далее.

=== Дополнительные статьи и документы ===
*[[Узлы проекта AgavaSCADA/AgavaPLC|Описание узлов AgavaSCADA/AgavaPLC]].
*[[Свойства узлов в AgavaSCADA/AgavaPLC]].
*[[Транспорты AgavaSCADA/AgavaPLC]].
*[[Описание языка С++ в AgavaPLC|Описание языка С++ в AgavaSCADA/AgavaPLC]]..
*[[Объектная модель AgavaSCADA/AgavaPLC]].
*[[Описание базовых классов AgavaSCADA/AgavaPLC]].
*[[Коды ошибок и предупреждений AgavaSCADA/AgavaPLC]].
*[[Рекомендации по разработке приложений AgavaSCADA/AgavaPLC]].
Полный перечень всех документов, связанных с разработкой приложений на AgavaSCADA/AgavaPLC, приведен на странице [[:Категория:AgavaSCADA/AgavaPLC|категории AgavaSCADA/AgavaPLC]].

== Разработка проекта ==

=== Создание нового проекта ===
Создание нового проекта в среде разработки осуществляется с помощью команды «Создать проект…» в меню «Файл». После вызова данной команды откроется диалоговое окно создания нового проекта (см. Рисунок 1).
[[Файл:AgavaPLC-Создание проекта.png|мини|Рисунок 1 - Окно "Создание нового проекта"]]
Для создания проекта необходимо в списке типов проектов выбрать необходимый, ввести имя проекта и путь для его сохранения, после чего нажать кнопку «Создать проект».

Доступны несколько типов проектов:

* «Пустой проект» – пустой проект, не содержащий никаких узлов. Данный тип можно использовать для создания произвольного проекта "с нуля".
* «Локальный проект» – предварительно настроенный проект, содержащий необходимые подсистемы и предназначенный для реализации простой системы для одного устройства, при выборе данного типа пользователь имеет возможность выбрать нужные ему подсистемы и получить полностью рабочий проект в минимальной конфигурации.
* «Проект АГАВА ПО-40» - проект, предназначенный для исполнения на панели оператора АГАВА ПО-40.
* «Проект АГАВА ПО-50» - проект, предназначенный для исполнения на панели оператора АГАВА ПО-50.
* «Проект АГАВА МПР-60» - проект, предназначенный для исполнения на контроллере АГАВА МПР-60.
* «Проект АГАВА ПЛК-70.А» - проект, предназначенный для исполнения на контроллере АГАВА ПЛК-70.А.

=== Редактирование существующего проекта ===
Редактирование существующего проекта начинается с открытия файла проекта путем вызова команды «Открыть…» в меню «Файл». После загрузки файла в основном окне среды разработки будут отображены свойства и параметры проекта (см. Рисунок 2).
[[Файл:AgavaPLC-Основное окно среды разработки.png|мини|Рисунок 2 – Основное окно среды разработки AgavaPLC с загруженным проектом]]
По умолчанию основное окно среды разработки содержит перечисленные ниже части:

# Строка заголовка приложения, панель меню и панель инструментов.
# Окно дерева проекта. Предоставляет доступ ко всей структуре проекта (см. раздел [[#Описание узлов]]).
# Окно свойств (см. раздел [[#Редактирование свойств узлов]] ).
# Область для отображения содержимого, например графического представления окна, текста программы или задачи ПЛК.
# Область вспомогательных окон:
## Окно "Сообщения".
## Окно "Ошибки".
## Окно "Точки останова".
## Окно "Ресурсы".
## Окно "Глобальные переменные".
## Окно "Выражения".
## Окно "Стек вызовов".
## Окно "Наблюдение".
## Окно "Локальные переменные".
## Окно "Поиск".

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

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

=== Структура и состав проекта ===
Типичный проект содержит следующие части:

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

Проект также может содержать следующие части:

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

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

Описание всех частей проекта и их узлов приведено в разделе 4.

=== Разработка проекта ===
[[Файл:AgavaPLC-Добавление узла в проект.png|мини|Рисунок 3 – Добавление узла в проект AgavaPLC]]
Перед началом разработки проекта рекомендуется проанализировать поставленную задачи и определить подсистемы, необходимые для её реализации. Взаимодействие с подсистемами осуществляется через дерево проекта (см. Рисунок 2), в которое добавляются нужные узлы. Для добавления нового узла, необходимо нажать правой кнопкой мыши на узел верхнего уровня, которому он подчинён, и выбрать в контекстном меню команду «Добавить узел».

Основные части типовой программы и способы их реализации приведены ниже.

==== Взаимодействие с внешними устройствами ====
Реализуется через подсистему «Транспорты» в окне дерева проекта. Необходимо добавить в нее нужные протоколы, в зависимости от имеющейся конфигурации контроллера.
[[Файл:AgavaPLC-Транспорты.png|мини|Рисунок 4 - Транспорты в дереве проекта AgavaPLC]]
# Транспорт для обмена с субмодулями контроллера (для контроллеров с корзиной субмодулей). В качестве порта транспорта необходимо указать “/dev/ttyS0”. В проекте для МПР-60 присутствует по-умолчанию.
# Транспорт последовательный (для управления по RS-232, RS-485 и т.д.).
# Транспорт TCP/IP (для управления по Ethernet).

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

==== Визуализация данных ====
Визуализация данных технологических процессов реализуется с помощью элементов подсистемы «Визуализация».

Система визуализации недоступна в проектах для контроллеров МПР.
[[Файл:AgavaPLC-Пример визуализации.png|мини|Рисунок 5 - Пример визуализации]]
Визуализация содержит одно или несколько окон, описанных ниже.

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

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

Редактирование содержимого окна или композиции осуществляется в его графическом представлении (см. раздел [[#Редактирование графического представления узла]]).

Более подробное описание подсистемы визуализации приведено в разделе [[#Подсистема визуализации]].

==== Пользовательские алгоритмы ====
Реализовать нужные алгоритмы работы программы можно с помощью различных инструментов, которые выбираются в зависимости от сложности проектов и навыков программиста:

# Операции в группе «Сигналы» – отдельные логические операции. В основном используются для небольших проектов, не требующих сложных методов управления;
# Задачи ПЛК – графическое программирование с помощью связывания между собой различных функциональных блоков. Подходит для больших проектов. Реализуется в узле «Задача ПЛК» группы «Задачи». Подробное описание приведено в разделе [[#Задача ПЛК]]'''.'''
# Скрипты С++ – текстовое программирование на языке высокого уровня. Подходит для больших проектов. Реализуется с помощью операций «Скрипт С++», расположенных в группе «Сигналы» или в задаче ПЛК. Описание реализации языка С++ приведено на странице [[Описание языка С++ в AgavaPLC]].
=== Редактирование свойств узлов ===
Среда разработки обладает развитыми возможностями по редактированию свойств узлов. Описание доступных типов свойств приведно в статье [[Свойства узлов в AgavaPLC/AgavaSCADA]].

==== Редактирование свойств узлов с помощью окна «Свойства» ====
[[Файл:AgavaPLC-Окно "Свойства".png|мини|Рисунок 6 – Окно «Свойства» виджета «Кнопка»]]
Редактирование свойств всех узлов осуществляется с помощью окна «Свойства».

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

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

==== Групповое редактирование свойств узлов ====
При необходимости редактирования разных свойств у большого количества узлов можно воспользоваться специальным окном «Список узлов».
[[Файл:AgavaPLC-Окно "Список узлов".png|мини|Рисунок 7 - Окно "Список узлов"]]
Открытие окна выполняется с помощью вызова команды «Открыть список узлов» в контекстном меню дерева конфигурации. Открытое окно содержит все узлы, вложенные в выбранные при вызове команды.

Окно позволяет редактировать свойства непосредственно в ячейках таблицы, без переключения на окно «Свойства». Групповое редактирование свойств узлов через окно «Свойства» также доступно.

Щелчок правой кнопкой мыши на списке вызывает контекстное меню, содержащее команды:

* “Свойства”;
* “Экспорт в *.txt”;
* “Импорт из *.txt”;
* “Удалить узел”.

Команда «Свойства» открывает диалоговое окно выбора отображаемых свойств.

Команды «Экспорт», «Импорт» выполняют экспорт списка свойств узлов в текстовый файл и импорт соответственно.

Команда «Удалить узел» производит удаление выделенного узла (узлов).

==== Функция групповой замены источников в узлах ====
При разработке сложных проектов может возникнуть необходимость заменить источники сразу в большом количестве узлов. Для этой цели используется функция групповой замены источников. Необходимо перейти в редактирование свойств типа «Список источников», которое производится в соответствующем окне (см. Рисунок 8).
[[Файл:AgavaPLC-Окно редактирования свойств типа «Список источников».png|мини|Рисунок 8 - Окно редактирования свойств типа «Список источников»]]
Затем необходимо использовать функцию групповой замены (см. Рисунок 9), выделив нужные узлы, нажав на них правой кнопкой мыши и выбрав «Групповая замена».
[[Файл:AgavaPLC-Окно функции «Групповая замена».png|мини|Рисунок 9 - Окно функции «Групповая замена»]]

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

* фрейм;
* форма;
* окно с композицией;
* слой.

Открытое графическое представление выбранного узла может содержать все уже размещенные на нем элементы визуализации и (или) другие узлы и позволяет добавить новые.
[[Файл:AgavaPLC–Открытое графическое представление окна «winMain».png|мини|Рисунок 10 – Открытое графическое представление окна «winMain»]]
На рисунке 10 представлено графическое представление окна «winMain», обведенное пунктирной рамкой серого цвета, обозначающей внешнюю границу открытого узла. Тип рамки пользователь может выбрать по своему усмотрению, выбор производится в окне настроек среды разработки, доступном через команду «Настройки» в меню «Параметры».

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

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

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

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

Для связи виджетов с источниками данных можно воспользоваться обычным способом связывания через окно «Свойства». К примеру, связывание размещенного на форме виджета «Текстовая метка» с регистром Modbus осуществляется добавлением регистра Modbus в свойство виджета «Источник».

Вместе с обычным способом связывания существует и другой, более быстрый способ. Для быстрого связывания регистра с виджетом достаточно нажать на регистр в дереве конфигурации левой кнопкой мыши и перенести его на виджет в открытом графическом представлении.
[[Файл:AgavaPLC–Связывание узла «sourceModbusRegister0» и виджета.png|мини|Рисунок 11 – Связывание узла «sourceModbusRegister0» и виджета]]
При помещении курсора над виджетом последний будет заштрихован сеткой зеленого или красного цвета, а курсор изменит свой вид на стрелку с квадратиком (см. рисунок 11).

Зеленая штриховка виджета означает отсутствие связи выделенного виджета с источником данных, в этом случае связывание будет произведено. Красная штриховка говорит об ошибках связывания виджета и сигнала/источника.

==== Редактирование многослойных композиций ====
Редактирование многослойных композиций принципиально не отличается от редактирования форм, кроме одного нюанса. Так как композиция может состоять из нескольких слоев, и виджеты на слоях могут располагаться один над другим, для использования наиболее удобного способа редактирования такой композиции можно воспользоваться возможностью открытия каждого слоя в отдельном окне.
[[Файл:AgavaPLC–Пример структуры композиции «Composition1», состоящей из трех слоев.png|мини|Рисунок 12 – Пример структуры композиции «Composition1», состоящей из трех слоев]]
Для открытия графического представления слоя нужно воспользоваться командой «Открыть графическое представление» аналогично открытию графического представления формы или композиции.

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

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

==== Использование якорей ====
Данная возможность доступна с версии <code>AS 1.6.32+</code>.

При работе с графическими представлениями окон и композиций, содержащих большое количество виджетов, могут быть полезны якоря - создаваемые пользователем метки на размерных линейках.
[[Файл:AgavaPLC-Графическое представление-якоря.png|мини|AS 1.6.32+: Графическое представление формы с установленными якорями]]
Якоря позволяют контролировать положение групп виджетов благодаря связанным с ними линиям привязки. Линии привязки, позволяют быстрее выстраивать группы виджетов благодяря "прилипанию".

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

* Двойным кликом левой кнопки мыши по размерной линейке.
* Кликом правой кнопки мыши на размерной линейке и выбором команды "Добавить якорь".

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

* Двойным кликом левой кнопки мыши по якорю на размерной линейке.
* Кликом правой кнопки мыши на размерной линейке и выбором команды "Удалить якорь".

Созданные якоря можно перемещать по размерной линейке с помощью мыши.

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

== Проверка и отладка проекта ==

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

Для этого необходимо:

# Установить текущий проект как проект по умолчанию. Для этого необходимо вызвать команду "Проект->Установить проект по умолчанию..." и выбрать ранее сохраненный файл конфигурации.
# Запустить среду исполнения. Для этого нужно вызвать команду меню "Проект->Запуск среды исполнения". После этого будет выполнен запуск в новом окне среды исполнения.

=== Мониторинг сигналов ===
[[Файл:AgavaPLC–Окно "Наблюдение".png|мини|Рисунок 14 – Окно "Наблюдение"|ссылка=Файл:AgavaPLC–Окно_%22Наблюдение%22.png]]
Функция мониторинга сигналов позволяет наблюдать значения, хранящиеся в узлах проекта при исполнении проекта на целевом устройстве.

Для запуска данной функции необходимо:

# Запустить среду исполнения.
# Вызвать команду меню «<code>Устройство → Подключение/отключение</code>», в появившемся окне выбрать IP-адрес и порт устройства, значения узлов которого необходимо мониторить. При необходимости просмотра значений узлов и сигналов в режиме эмуляции проекта на персональном компьютере укажите адрес 127.0.0.1. Если необходимо просматривать значения узлов проекта, выполняющегося на контроллере или панели оператора, укажите IP-адрес контроллера или панели.
# Нажать кнопку «Подключение».

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

Для добавления узлов в окно "Наблюдение" необходимо нажать на нужном узле в дереве проекта правой кнопкой мыши и выбрать команду «<code>Добавить в окно наблюдения</code>». Выбранные узлы будут отображаться в окне «Наблюдение» вместе со считанными значениями.

=== Мониторинг событий ===
[[Файл:AgavaPLC–Окно просмотра событий.png|мини|Рисунок 15 – Окно просмотра событий]]Мониторинг событий позволяет наблюдать за исполнением проекта, работающего в устройстве. При включении мониторинга пользователь получает информацию о возникающих нефатальных ошибках и предупреждениях, возникающих в ходе исполнения проекта со следующими признаками:

* метка времени, соответствующая времени возникновения события;
* степень важности события;
* тип события - информационное или события активирования, деактивирования и квитирования тревог;
* имя узла, сформировавшего событие.
* текст события.

==== Использование мониторинга ====
Для старта мониторинга необходимо подключиться к нужному устройству способом, рассмотренным в разделе [[#Мониторинг сигналов]], а затем вызвать команду «<code>Устройство → Просмотр событий</code>». В открывшемся окне будут выводиться все события, регистрируемые устройством.

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

==== Фильтрация событий ====
''Функция доступна начиная с версии <code>AgavaSCADA/AgavaPLC 1.2.56+, 1.5.25+</code>.''

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

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

=== Отладка в задаче ПЛК ===
''Данный раздел актуален для версии <code>AS 1.2.61</code> и старее. В версиях <code>AS 1.6+</code> используется [[Универсальная среда разработки Agava#Отладка проекта|современный пошаговый отладчик]].''

Задача ПЛК (см. раздел [[#Задача ПЛК]]) позволяет проводить тестирование проектов с помощью режима симулятора (на компьютере, без использования контроллера) или онлайн отладки (на контроллере).

==== Управление отладкой ====
Управление режимом симуляции и онлайн отладкой осуществляется с помощью панели инструментов задачи ПЛК (см. рисунок 16).

Панель инструментов содержит следующие элементы:

* Кнопка «Запустить симуляцию».
* Кнопка «Сделать шаг на один цикл».
* Кнопка «Приостановить симуляцию» - ставит выполнение задачи на паузу.
* Кнопка «Остановить симуляцию» - сбрасывает состояние всех блоков к их состоянию по умолчанию.
* Список выбора периода выполнения задачи.
* Кнопка «Показать окно «Наблюдение».

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

Управление симуляцией осуществляется через команды на панели инструментов задачи ПЛК.

Для перехода в режим симуляции нажмите кнопку «Режим симулятора» на панели управления задачи ПЛК.
[[Файл:AgavaPLC-Панель инструментов задачи ПЛК.png|мини|Рисунок 16 - Панель инструментов задачи ПЛК]]
После активации режима симуляции, для изменения значения входа дважды щелкните на нем левой кнопкой мыши и выберите нужный тип и значение. Текущие значения всех блоков, в соответствии с работой программы, будут отображаться в реальном времени.
[[Файл:AgavaPLC–Вид блоков задачи в режиме симулятора.png|мини|Рисунок 17 – Вид блоков задачи в режиме симулятора]]
Для выхода из режима симуляции повторно нажмите кнопку «Режим симуляции» на панели управления задачи ПЛК.

==== Онлайн отладка ====
Режим онлайн отладки позволяет провести тестирование проекта, загруженного и исполняемого в контроллере. Для перехода в режим онлайн отладки загрузите конфигурацию в контроллер, подключитесь к нему, после чего нажмите кнопку «Онлайн отладка» на панели инструментов задачи ПЛК.
[[Файл:AgavaPLC–Вид блоков задачи в режиме онлайн отладки.png|мини|Рисунок 18 – Вид блоков задачи в режиме онлайн отладки]]
На рисунке 18 изображен вид задачи ПЛК в режиме онлайн отладки проекта, запущенного на МПР-60 с установленными субмодулями DI (входы) и R (выходы).

Для онлайн отладки на панели инструментов недоступны кнопка «Приостановить симуляцию» и список выбора периода.

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

=== Проверка проекта ===
[[Файл:AgavaPLC–Окно «Ошибки».png|мини|Рисунок 19 – Окно «Ошибки»]]
Перед сохранением проекта желательно выполнить его проверку на наличие ошибок с помощью команды «Проект->Проверить проект». После проверки обнаруженные ошибки будут отображены в окне «Ошибки».

Если отображение окна «Ошибки» выключено, его можно включить командой «Вид->Показать окно ошибок».

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

Также щелчок левой кнопкой мыши на строке с ошибкой открывает окно «Свойства» и дает возможность изменить в нем все свойства узла, содержащего ошибку.

==== Установка пароля на файл конфигурации ====
[[Файл:AgavaPLC–Установка пароля.png|мини|Рисунок 13 – Установка пароля]]
Файл конфигурации, загружаемый в контроллер или панель оператора, можно защитить паролем, чтобы предотвратить его несанкционированное изменение.

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

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

== Загрузка проекта в устройство ==
Загрузка проекта в целевое устройство может быть осуществлена несколькими способами:

* загрузка из среды разработки;
* загрузка с помощью USB-Flash накопителя (для панелей оператора);
* загрузка через браузер (для МПР-60).

=== Загрузка из среды разработки ===
[[Файл:AgavaPLC–Окно «Загрузка проекта в устройство» после подключения к контроллеру.png|мини|Рисунок 20 – Окно «Загрузка проекта в устройство» после подключения к контроллеру]]
Для загрузки проекта из среды разработки необходимо произвести следующие действия в указанном порядке:

# Создайте файл конфигурации.
# Выполните подключение целевого устройства к ПК по сети Ethernet.
# После подключения вызовите в среде разработки команду «Проект->Загрузка проекта в устройство».
# В открывшемся окне будет отображен список файлов проекта, доступных для загрузки в целевое устройство.
# Выберите необходимые файлы и нажмите кнопку «Загрузить». После нажатия кнопки начнется процесс загрузки файлов, при этом в нижней части окна будет меняться состояние полосы прогресса, а также для каждого файла в таблице будет отображен результат загрузки.
# После окончания загрузки среда исполнения в целевом устройстве будет перезапущена и загруженный проект будет запущен.

=== Загрузка через USB-Flash (для ПО-40 и ПО-50) ===
Для загрузки проекта в устройство с помощью USB-Flash накопителя необходимо произвести следующие действия в указанном порядке:

# Подготовьте USB-Flash накопитель, предварительно отформатировав его в файловую систему FAT32.
# Вызовите в среде разработки команду «Подготовка архива для обновления» в меню «Проект».
# Сохраните архив в корень USB-Flash накопителя.
# Перейдите в системную утилиту, перезагрузив панель оператора, при загрузке во время однократного звукового сигнала нажмите на экран и удерживайте до повторного звукового сигнала. Введите пароль: 111111.
# Перейдите на вкладку «Обновление», затем подключите USB-Flash накопитель через переходник USB-OTG, выберите из списка загрузочный архив, нажать кнопку «Обновить». Дождитесь сообщения «Обновление успешно» и нажмите кнопку «ОК».
# Перейдите на вкладку «Перезапуск» и нажмите кнопку «Перезапуск».
После перезагрузки панели загруженный проект будет запущен.

=== Загрузка через браузер (для МПР-60) ===
Для загрузки проекта через браузер необходимо произвести следующие действия в указанном порядке.

# Вызовите в среде разработки команду «Подготовка архива для обновления» в меню «Проект».
# Сохраните архив.
# Откройте системную утилиту, введя IP-адрес контроллера в адресную строку браузера.
# Перейдите на вкладку «Загрузка ПО». Рисунок 71 - Вкладка системной утилиты «Загрузка ПО»
# Выберите на компьютере архив с проектом, который необходимо загрузить в контроллер.
# Нажмите кнопку «Загрузить».
# Дождитесь окончания загрузки файла и обновления проекта.

== Отладка проекта ==
''Данный функционал доступен в версиях <code>AS 1.6+</code>. Для версий <code>AS 1.2</code> используйте мониторинг, [[Универсальная среда разработки Agava#Отладка в задаче ПЛК|отладку в задачах ПЛК]].''

=== Локальная отладка ===

=== Удаленная отладка ===
[[Категория:AgavaSCADA/AgavaPLC]]

Файл:AgavaPLC-Основное окно среды разработки.png

2026-03-27T09:42:19Z

TaushkanovKV: TaushkanovKV загрузил новую версию Файл:AgavaPLC-Основное окно среды разработки.png

Основное окно среды разработки AgavaPLC с загруженным проектом

Универсальная среда разработки Agava

2026-03-27T09:33:12Z

TaushkanovKV: /* Создание нового проекта */

Универсальная среда разработки предназначена для создания и редактирования программного обеспечения для панелей оператора АГАВА ПО, многоканальных программируемых реле АГАВА МПР-60 и систем диспетчеризации на базе SCADA-системы AgavaSCADA.

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

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

=== Версии программного обеспечения ===
{{Внимание|Текст=При использовании среды разработки совместно с панелями оператора АГАВА ПО или многоканальными программируемыми реле АГАВА МПР-60 необходимо использовать соответствующую версию среды разработки|Тип=Восклицание синий.png}}
Для определения подходящей версии среды разработки необходимо определить версию среды исполнения, установленной в панели оператора или реле. Тип и версия среды исполнения указаны в системной утилите прибора. Например, "AgavaPLC 1.1", "AgavaPLC 1.2" и т.д. Для использования со средой исполнения AgavaPLC 1.1 необходимо использовать среду разработки версии 1.1, для среды исполнения AgavaPLC 1.2 необходима среда разработки версии 1.2 и так далее.

=== Дополнительные статьи и документы ===
*[[Узлы проекта AgavaSCADA/AgavaPLC|Описание узлов AgavaSCADA/AgavaPLC]].
*[[Свойства узлов в AgavaSCADA/AgavaPLC]].
*[[Транспорты AgavaSCADA/AgavaPLC]].
*[[Описание языка С++ в AgavaPLC|Описание языка С++ в AgavaSCADA/AgavaPLC]]..
*[[Объектная модель AgavaSCADA/AgavaPLC]].
*[[Описание базовых классов AgavaSCADA/AgavaPLC]].
*[[Коды ошибок и предупреждений AgavaSCADA/AgavaPLC]].
*[[Рекомендации по разработке приложений AgavaSCADA/AgavaPLC]].
Полный перечень всех документов, связанных с разработкой приложений на AgavaSCADA/AgavaPLC, приведен на странице [[:Категория:AgavaSCADA/AgavaPLC|категории AgavaSCADA/AgavaPLC]].

== Разработка проекта ==

=== Создание нового проекта ===
Создание нового проекта в среде разработки осуществляется с помощью команды «Создать проект…» в меню «Файл». После вызова данной команды откроется диалоговое окно создания нового проекта (см. Рисунок 1).
[[Файл:AgavaPLC-Создание проекта.png|мини|Рисунок 1 - Окно "Создание нового проекта"]]
Для создания проекта необходимо в списке типов проектов выбрать необходимый, ввести имя проекта и путь для его сохранения, после чего нажать кнопку «Создать проект».

Доступны несколько типов проектов:

* «Пустой проект» – пустой проект, не содержащий никаких узлов. Данный тип можно использовать для создания произвольного проекта "с нуля".
* «Локальный проект» – предварительно настроенный проект, содержащий необходимые подсистемы и предназначенный для реализации простой системы для одного устройства, при выборе данного типа пользователь имеет возможность выбрать нужные ему подсистемы и получить полностью рабочий проект в минимальной конфигурации.
* «Проект АГАВА ПО-40» - проект, предназначенный для исполнения на панели оператора АГАВА ПО-40.
* «Проект АГАВА ПО-50» - проект, предназначенный для исполнения на панели оператора АГАВА ПО-50.
* «Проект АГАВА МПР-60» - проект, предназначенный для исполнения на контроллере АГАВА МПР-60.
* «Проект АГАВА ПЛК-70.А» - проект, предназначенный для исполнения на контроллере АГАВА ПЛК-70.А.

=== Редактирование существующего проекта ===
Редактирование существующего проекта начинается с открытия файла проекта путем вызова команды «Открыть…» в меню «Файл». После загрузки файла в основном окне среды разработки будут отображены свойства и параметры проекта (см. Рисунок 2).
[[Файл:AgavaPLC-Основное окно среды разработки.png|мини|Рисунок 2 – Основное окно среды разработки AgavaPLC с загруженным проектом]]
По умолчанию основное окно среды разработки содержит перечисленные ниже части:

# Строка заголовка приложения, панель меню и панель инструментов.
# Окно дерева проекта. Предоставляет доступ ко всей структуре проекта (см. раздел [[#Описание узлов]]).
# Окно свойств (см. раздел [[#Редактирование свойств узлов]] ).
# Область для отображения содержимого, например графического представления окна или задачи ПЛК.
# Область вспомогательных окон (окна наблюдения, ошибок и сообщений)

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

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

=== Структура и состав проекта ===
Типичный проект содержит следующие части:

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

Проект также может содержать следующие части:

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

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

Описание всех частей проекта и их узлов приведено в разделе 4.

=== Разработка проекта ===
[[Файл:AgavaPLC-Добавление узла в проект.png|мини|Рисунок 3 – Добавление узла в проект AgavaPLC]]
Перед началом разработки проекта рекомендуется проанализировать поставленную задачи и определить подсистемы, необходимые для её реализации. Взаимодействие с подсистемами осуществляется через дерево проекта (см. Рисунок 2), в которое добавляются нужные узлы. Для добавления нового узла, необходимо нажать правой кнопкой мыши на узел верхнего уровня, которому он подчинён, и выбрать в контекстном меню команду «Добавить узел».

Основные части типовой программы и способы их реализации приведены ниже.

==== Взаимодействие с внешними устройствами ====
Реализуется через подсистему «Транспорты» в окне дерева проекта. Необходимо добавить в нее нужные протоколы, в зависимости от имеющейся конфигурации контроллера.
[[Файл:AgavaPLC-Транспорты.png|мини|Рисунок 4 - Транспорты в дереве проекта AgavaPLC]]
# Транспорт для обмена с субмодулями контроллера (для контроллеров с корзиной субмодулей). В качестве порта транспорта необходимо указать “/dev/ttyS0”. В проекте для МПР-60 присутствует по-умолчанию.
# Транспорт последовательный (для управления по RS-232, RS-485 и т.д.).
# Транспорт TCP/IP (для управления по Ethernet).

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

==== Визуализация данных ====
Визуализация данных технологических процессов реализуется с помощью элементов подсистемы «Визуализация».

Система визуализации недоступна в проектах для контроллеров МПР.
[[Файл:AgavaPLC-Пример визуализации.png|мини|Рисунок 5 - Пример визуализации]]
Визуализация содержит одно или несколько окон, описанных ниже.

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

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

Редактирование содержимого окна или композиции осуществляется в его графическом представлении (см. раздел [[#Редактирование графического представления узла]]).

Более подробное описание подсистемы визуализации приведено в разделе [[#Подсистема визуализации]].

==== Пользовательские алгоритмы ====
Реализовать нужные алгоритмы работы программы можно с помощью различных инструментов, которые выбираются в зависимости от сложности проектов и навыков программиста:

# Операции в группе «Сигналы» – отдельные логические операции. В основном используются для небольших проектов, не требующих сложных методов управления;
# Задачи ПЛК – графическое программирование с помощью связывания между собой различных функциональных блоков. Подходит для больших проектов. Реализуется в узле «Задача ПЛК» группы «Задачи». Подробное описание приведено в разделе [[#Задача ПЛК]]'''.'''
# Скрипты С++ – текстовое программирование на языке высокого уровня. Подходит для больших проектов. Реализуется с помощью операций «Скрипт С++», расположенных в группе «Сигналы» или в задаче ПЛК. Описание реализации языка С++ приведено на странице [[Описание языка С++ в AgavaPLC]].
=== Редактирование свойств узлов ===
Среда разработки обладает развитыми возможностями по редактированию свойств узлов. Описание доступных типов свойств приведно в статье [[Свойства узлов в AgavaPLC/AgavaSCADA]].

==== Редактирование свойств узлов с помощью окна «Свойства» ====
[[Файл:AgavaPLC-Окно "Свойства".png|мини|Рисунок 6 – Окно «Свойства» виджета «Кнопка»]]
Редактирование свойств всех узлов осуществляется с помощью окна «Свойства».

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

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

==== Групповое редактирование свойств узлов ====
При необходимости редактирования разных свойств у большого количества узлов можно воспользоваться специальным окном «Список узлов».
[[Файл:AgavaPLC-Окно "Список узлов".png|мини|Рисунок 7 - Окно "Список узлов"]]
Открытие окна выполняется с помощью вызова команды «Открыть список узлов» в контекстном меню дерева конфигурации. Открытое окно содержит все узлы, вложенные в выбранные при вызове команды.

Окно позволяет редактировать свойства непосредственно в ячейках таблицы, без переключения на окно «Свойства». Групповое редактирование свойств узлов через окно «Свойства» также доступно.

Щелчок правой кнопкой мыши на списке вызывает контекстное меню, содержащее команды:

* “Свойства”;
* “Экспорт в *.txt”;
* “Импорт из *.txt”;
* “Удалить узел”.

Команда «Свойства» открывает диалоговое окно выбора отображаемых свойств.

Команды «Экспорт», «Импорт» выполняют экспорт списка свойств узлов в текстовый файл и импорт соответственно.

Команда «Удалить узел» производит удаление выделенного узла (узлов).

==== Функция групповой замены источников в узлах ====
При разработке сложных проектов может возникнуть необходимость заменить источники сразу в большом количестве узлов. Для этой цели используется функция групповой замены источников. Необходимо перейти в редактирование свойств типа «Список источников», которое производится в соответствующем окне (см. Рисунок 8).
[[Файл:AgavaPLC-Окно редактирования свойств типа «Список источников».png|мини|Рисунок 8 - Окно редактирования свойств типа «Список источников»]]
Затем необходимо использовать функцию групповой замены (см. Рисунок 9), выделив нужные узлы, нажав на них правой кнопкой мыши и выбрав «Групповая замена».
[[Файл:AgavaPLC-Окно функции «Групповая замена».png|мини|Рисунок 9 - Окно функции «Групповая замена»]]

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

* фрейм;
* форма;
* окно с композицией;
* слой.

Открытое графическое представление выбранного узла может содержать все уже размещенные на нем элементы визуализации и (или) другие узлы и позволяет добавить новые.
[[Файл:AgavaPLC–Открытое графическое представление окна «winMain».png|мини|Рисунок 10 – Открытое графическое представление окна «winMain»]]
На рисунке 10 представлено графическое представление окна «winMain», обведенное пунктирной рамкой серого цвета, обозначающей внешнюю границу открытого узла. Тип рамки пользователь может выбрать по своему усмотрению, выбор производится в окне настроек среды разработки, доступном через команду «Настройки» в меню «Параметры».

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

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

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

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

Для связи виджетов с источниками данных можно воспользоваться обычным способом связывания через окно «Свойства». К примеру, связывание размещенного на форме виджета «Текстовая метка» с регистром Modbus осуществляется добавлением регистра Modbus в свойство виджета «Источник».

Вместе с обычным способом связывания существует и другой, более быстрый способ. Для быстрого связывания регистра с виджетом достаточно нажать на регистр в дереве конфигурации левой кнопкой мыши и перенести его на виджет в открытом графическом представлении.
[[Файл:AgavaPLC–Связывание узла «sourceModbusRegister0» и виджета.png|мини|Рисунок 11 – Связывание узла «sourceModbusRegister0» и виджета]]
При помещении курсора над виджетом последний будет заштрихован сеткой зеленого или красного цвета, а курсор изменит свой вид на стрелку с квадратиком (см. рисунок 11).

Зеленая штриховка виджета означает отсутствие связи выделенного виджета с источником данных, в этом случае связывание будет произведено. Красная штриховка говорит об ошибках связывания виджета и сигнала/источника.

==== Редактирование многослойных композиций ====
Редактирование многослойных композиций принципиально не отличается от редактирования форм, кроме одного нюанса. Так как композиция может состоять из нескольких слоев, и виджеты на слоях могут располагаться один над другим, для использования наиболее удобного способа редактирования такой композиции можно воспользоваться возможностью открытия каждого слоя в отдельном окне.
[[Файл:AgavaPLC–Пример структуры композиции «Composition1», состоящей из трех слоев.png|мини|Рисунок 12 – Пример структуры композиции «Composition1», состоящей из трех слоев]]
Для открытия графического представления слоя нужно воспользоваться командой «Открыть графическое представление» аналогично открытию графического представления формы или композиции.

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

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

==== Использование якорей ====
Данная возможность доступна с версии <code>AS 1.6.32+</code>.

При работе с графическими представлениями окон и композиций, содержащих большое количество виджетов, могут быть полезны якоря - создаваемые пользователем метки на размерных линейках.
[[Файл:AgavaPLC-Графическое представление-якоря.png|мини|AS 1.6.32+: Графическое представление формы с установленными якорями]]
Якоря позволяют контролировать положение групп виджетов благодаря связанным с ними линиям привязки. Линии привязки, позволяют быстрее выстраивать группы виджетов благодяря "прилипанию".

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

* Двойным кликом левой кнопки мыши по размерной линейке.
* Кликом правой кнопки мыши на размерной линейке и выбором команды "Добавить якорь".

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

* Двойным кликом левой кнопки мыши по якорю на размерной линейке.
* Кликом правой кнопки мыши на размерной линейке и выбором команды "Удалить якорь".

Созданные якоря можно перемещать по размерной линейке с помощью мыши.

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

== Проверка и отладка проекта ==

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

Для этого необходимо:

# Установить текущий проект как проект по умолчанию. Для этого необходимо вызвать команду "Проект->Установить проект по умолчанию..." и выбрать ранее сохраненный файл конфигурации.
# Запустить среду исполнения. Для этого нужно вызвать команду меню "Проект->Запуск среды исполнения". После этого будет выполнен запуск в новом окне среды исполнения.

=== Мониторинг сигналов ===
[[Файл:AgavaPLC–Окно "Наблюдение".png|мини|Рисунок 14 – Окно "Наблюдение"|ссылка=Файл:AgavaPLC–Окно_%22Наблюдение%22.png]]
Функция мониторинга сигналов позволяет наблюдать значения, хранящиеся в узлах проекта при исполнении проекта на целевом устройстве.

Для запуска данной функции необходимо:

# Запустить среду исполнения.
# Вызвать команду меню «<code>Устройство → Подключение/отключение</code>», в появившемся окне выбрать IP-адрес и порт устройства, значения узлов которого необходимо мониторить. При необходимости просмотра значений узлов и сигналов в режиме эмуляции проекта на персональном компьютере укажите адрес 127.0.0.1. Если необходимо просматривать значения узлов проекта, выполняющегося на контроллере или панели оператора, укажите IP-адрес контроллера или панели.
# Нажать кнопку «Подключение».

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

Для добавления узлов в окно "Наблюдение" необходимо нажать на нужном узле в дереве проекта правой кнопкой мыши и выбрать команду «<code>Добавить в окно наблюдения</code>». Выбранные узлы будут отображаться в окне «Наблюдение» вместе со считанными значениями.

=== Мониторинг событий ===
[[Файл:AgavaPLC–Окно просмотра событий.png|мини|Рисунок 15 – Окно просмотра событий]]Мониторинг событий позволяет наблюдать за исполнением проекта, работающего в устройстве. При включении мониторинга пользователь получает информацию о возникающих нефатальных ошибках и предупреждениях, возникающих в ходе исполнения проекта со следующими признаками:

* метка времени, соответствующая времени возникновения события;
* степень важности события;
* тип события - информационное или события активирования, деактивирования и квитирования тревог;
* имя узла, сформировавшего событие.
* текст события.

==== Использование мониторинга ====
Для старта мониторинга необходимо подключиться к нужному устройству способом, рассмотренным в разделе [[#Мониторинг сигналов]], а затем вызвать команду «<code>Устройство → Просмотр событий</code>». В открывшемся окне будут выводиться все события, регистрируемые устройством.

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

==== Фильтрация событий ====
''Функция доступна начиная с версии <code>AgavaSCADA/AgavaPLC 1.2.56+, 1.5.25+</code>.''

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

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

=== Отладка в задаче ПЛК ===
''Данный раздел актуален для версии <code>AS 1.2.61</code> и старее. В версиях <code>AS 1.6+</code> используется [[Универсальная среда разработки Agava#Отладка проекта|современный пошаговый отладчик]].''

Задача ПЛК (см. раздел [[#Задача ПЛК]]) позволяет проводить тестирование проектов с помощью режима симулятора (на компьютере, без использования контроллера) или онлайн отладки (на контроллере).

==== Управление отладкой ====
Управление режимом симуляции и онлайн отладкой осуществляется с помощью панели инструментов задачи ПЛК (см. рисунок 16).

Панель инструментов содержит следующие элементы:

* Кнопка «Запустить симуляцию».
* Кнопка «Сделать шаг на один цикл».
* Кнопка «Приостановить симуляцию» - ставит выполнение задачи на паузу.
* Кнопка «Остановить симуляцию» - сбрасывает состояние всех блоков к их состоянию по умолчанию.
* Список выбора периода выполнения задачи.
* Кнопка «Показать окно «Наблюдение».

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

Управление симуляцией осуществляется через команды на панели инструментов задачи ПЛК.

Для перехода в режим симуляции нажмите кнопку «Режим симулятора» на панели управления задачи ПЛК.
[[Файл:AgavaPLC-Панель инструментов задачи ПЛК.png|мини|Рисунок 16 - Панель инструментов задачи ПЛК]]
После активации режима симуляции, для изменения значения входа дважды щелкните на нем левой кнопкой мыши и выберите нужный тип и значение. Текущие значения всех блоков, в соответствии с работой программы, будут отображаться в реальном времени.
[[Файл:AgavaPLC–Вид блоков задачи в режиме симулятора.png|мини|Рисунок 17 – Вид блоков задачи в режиме симулятора]]
Для выхода из режима симуляции повторно нажмите кнопку «Режим симуляции» на панели управления задачи ПЛК.

==== Онлайн отладка ====
Режим онлайн отладки позволяет провести тестирование проекта, загруженного и исполняемого в контроллере. Для перехода в режим онлайн отладки загрузите конфигурацию в контроллер, подключитесь к нему, после чего нажмите кнопку «Онлайн отладка» на панели инструментов задачи ПЛК.
[[Файл:AgavaPLC–Вид блоков задачи в режиме онлайн отладки.png|мини|Рисунок 18 – Вид блоков задачи в режиме онлайн отладки]]
На рисунке 18 изображен вид задачи ПЛК в режиме онлайн отладки проекта, запущенного на МПР-60 с установленными субмодулями DI (входы) и R (выходы).

Для онлайн отладки на панели инструментов недоступны кнопка «Приостановить симуляцию» и список выбора периода.

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

=== Проверка проекта ===
[[Файл:AgavaPLC–Окно «Ошибки».png|мини|Рисунок 19 – Окно «Ошибки»]]
Перед сохранением проекта желательно выполнить его проверку на наличие ошибок с помощью команды «Проект->Проверить проект». После проверки обнаруженные ошибки будут отображены в окне «Ошибки».

Если отображение окна «Ошибки» выключено, его можно включить командой «Вид->Показать окно ошибок».

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

Также щелчок левой кнопкой мыши на строке с ошибкой открывает окно «Свойства» и дает возможность изменить в нем все свойства узла, содержащего ошибку.

==== Установка пароля на файл конфигурации ====
[[Файл:AgavaPLC–Установка пароля.png|мини|Рисунок 13 – Установка пароля]]
Файл конфигурации, загружаемый в контроллер или панель оператора, можно защитить паролем, чтобы предотвратить его несанкционированное изменение.

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

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

== Загрузка проекта в устройство ==
Загрузка проекта в целевое устройство может быть осуществлена несколькими способами:

* загрузка из среды разработки;
* загрузка с помощью USB-Flash накопителя (для панелей оператора);
* загрузка через браузер (для МПР-60).

=== Загрузка из среды разработки ===
[[Файл:AgavaPLC–Окно «Загрузка проекта в устройство» после подключения к контроллеру.png|мини|Рисунок 20 – Окно «Загрузка проекта в устройство» после подключения к контроллеру]]
Для загрузки проекта из среды разработки необходимо произвести следующие действия в указанном порядке:

# Создайте файл конфигурации.
# Выполните подключение целевого устройства к ПК по сети Ethernet.
# После подключения вызовите в среде разработки команду «Проект->Загрузка проекта в устройство».
# В открывшемся окне будет отображен список файлов проекта, доступных для загрузки в целевое устройство.
# Выберите необходимые файлы и нажмите кнопку «Загрузить». После нажатия кнопки начнется процесс загрузки файлов, при этом в нижней части окна будет меняться состояние полосы прогресса, а также для каждого файла в таблице будет отображен результат загрузки.
# После окончания загрузки среда исполнения в целевом устройстве будет перезапущена и загруженный проект будет запущен.

=== Загрузка через USB-Flash (для ПО-40 и ПО-50) ===
Для загрузки проекта в устройство с помощью USB-Flash накопителя необходимо произвести следующие действия в указанном порядке:

# Подготовьте USB-Flash накопитель, предварительно отформатировав его в файловую систему FAT32.
# Вызовите в среде разработки команду «Подготовка архива для обновления» в меню «Проект».
# Сохраните архив в корень USB-Flash накопителя.
# Перейдите в системную утилиту, перезагрузив панель оператора, при загрузке во время однократного звукового сигнала нажмите на экран и удерживайте до повторного звукового сигнала. Введите пароль: 111111.
# Перейдите на вкладку «Обновление», затем подключите USB-Flash накопитель через переходник USB-OTG, выберите из списка загрузочный архив, нажать кнопку «Обновить». Дождитесь сообщения «Обновление успешно» и нажмите кнопку «ОК».
# Перейдите на вкладку «Перезапуск» и нажмите кнопку «Перезапуск».
После перезагрузки панели загруженный проект будет запущен.

=== Загрузка через браузер (для МПР-60) ===
Для загрузки проекта через браузер необходимо произвести следующие действия в указанном порядке.

# Вызовите в среде разработки команду «Подготовка архива для обновления» в меню «Проект».
# Сохраните архив.
# Откройте системную утилиту, введя IP-адрес контроллера в адресную строку браузера.
# Перейдите на вкладку «Загрузка ПО». Рисунок 71 - Вкладка системной утилиты «Загрузка ПО»
# Выберите на компьютере архив с проектом, который необходимо загрузить в контроллер.
# Нажмите кнопку «Загрузить».
# Дождитесь окончания загрузки файла и обновления проекта.

== Отладка проекта ==
''Данный функционал доступен в версиях <code>AS 1.6+</code>. Для версий <code>AS 1.2</code> используйте мониторинг, [[Универсальная среда разработки Agava#Отладка в задаче ПЛК|отладку в задачах ПЛК]].''

=== Локальная отладка ===

=== Удаленная отладка ===
[[Категория:AgavaSCADA/AgavaPLC]]

Файл:AgavaPLC-Создание проекта.png

2026-03-27T09:30:32Z

TaushkanovKV: TaushkanovKV загрузил новую версию Файл:AgavaPLC-Создание проекта.png

Окно "Создание нового проекта"

Универсальная среда разработки Agava

2026-03-27T06:36:20Z

TaushkanovKV: /* Отладка в задаче ПЛК */

Универсальная среда разработки предназначена для создания и редактирования программного обеспечения для панелей оператора АГАВА ПО, многоканальных программируемых реле АГАВА МПР-60 и систем диспетчеризации на базе SCADA-системы AgavaSCADA.

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

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

=== Версии программного обеспечения ===
{{Внимание|Текст=При использовании среды разработки совместно с панелями оператора АГАВА ПО или многоканальными программируемыми реле АГАВА МПР-60 необходимо использовать соответствующую версию среды разработки|Тип=Восклицание синий.png}}
Для определения подходящей версии среды разработки необходимо определить версию среды исполнения, установленной в панели оператора или реле. Тип и версия среды исполнения указаны в системной утилите прибора. Например, "AgavaPLC 1.1", "AgavaPLC 1.2" и т.д. Для использования со средой исполнения AgavaPLC 1.1 необходимо использовать среду разработки версии 1.1, для среды исполнения AgavaPLC 1.2 необходима среда разработки версии 1.2 и так далее.

=== Дополнительные статьи и документы ===
*[[Узлы проекта AgavaSCADA/AgavaPLC|Описание узлов AgavaSCADA/AgavaPLC]].
*[[Свойства узлов в AgavaSCADA/AgavaPLC]].
*[[Транспорты AgavaSCADA/AgavaPLC]].
*[[Описание языка С++ в AgavaPLC|Описание языка С++ в AgavaSCADA/AgavaPLC]]..
*[[Объектная модель AgavaSCADA/AgavaPLC]].
*[[Описание базовых классов AgavaSCADA/AgavaPLC]].
*[[Коды ошибок и предупреждений AgavaSCADA/AgavaPLC]].
*[[Рекомендации по разработке приложений AgavaSCADA/AgavaPLC]].
Полный перечень всех документов, связанных с разработкой приложений на AgavaSCADA/AgavaPLC, приведен на странице [[:Категория:AgavaSCADA/AgavaPLC|категории AgavaSCADA/AgavaPLC]].

== Разработка проекта ==

=== Создание нового проекта ===
Создание нового проекта в среде разработки осуществляется с помощью команды «Создать проект…» в меню «Файл». После вызова данной команды откроется диалоговое окно создания нового проекта (см. Рисунок 1).
[[Файл:AgavaPLC-Создание проекта.png|мини|Рисунок 1 - Окно "Создание нового проекта"]]
Для создания проекта необходимо в списке типов проектов выбрать необходимый, ввести имя проекта и путь для его сохранения, после чего нажать кнопку «Создать проект».

Доступны несколько типов проектов:

* «Пустой проект» – пустой проект, не содержащий никаких узлов. Можно использвоать для создания произвольного проекта "с нуля".
* «Локальный проект» – предварительно настроенный проект, содержащий необходимые подсистемы и предназначенный для реализации простой системы для одного устройства, при выборе данного типа пользователь имеет возможность выбрать нужные ему подсистемы и получить полностью рабочий проект в минимальной конфигурации.
* «Проект АГАВА МПР-60» - проект, предназначенный для исполнения на контроллере АГАВА МПР-60.

=== Редактирование существующего проекта ===
Редактирование существующего проекта начинается с открытия файла проекта путем вызова команды «Открыть…» в меню «Файл». После загрузки файла в основном окне среды разработки будут отображены свойства и параметры проекта (см. Рисунок 2).
[[Файл:AgavaPLC-Основное окно среды разработки.png|мини|Рисунок 2 – Основное окно среды разработки AgavaPLC с загруженным проектом]]
По умолчанию основное окно среды разработки содержит перечисленные ниже части:

# Строка заголовка приложения, панель меню и панель инструментов.
# Окно дерева проекта. Предоставляет доступ ко всей структуре проекта (см. раздел [[#Описание узлов]]).
# Окно свойств (см. раздел [[#Редактирование свойств узлов]] ).
# Область для отображения содержимого, например графического представления окна или задачи ПЛК.
# Область вспомогательных окон (окна наблюдения, ошибок и сообщений)

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

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

=== Структура и состав проекта ===
Типичный проект содержит следующие части:

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

Проект также может содержать следующие части:

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

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

Описание всех частей проекта и их узлов приведено в разделе 4.

=== Разработка проекта ===
[[Файл:AgavaPLC-Добавление узла в проект.png|мини|Рисунок 3 – Добавление узла в проект AgavaPLC]]
Перед началом разработки проекта рекомендуется проанализировать поставленную задачи и определить подсистемы, необходимые для её реализации. Взаимодействие с подсистемами осуществляется через дерево проекта (см. Рисунок 2), в которое добавляются нужные узлы. Для добавления нового узла, необходимо нажать правой кнопкой мыши на узел верхнего уровня, которому он подчинён, и выбрать в контекстном меню команду «Добавить узел».

Основные части типовой программы и способы их реализации приведены ниже.

==== Взаимодействие с внешними устройствами ====
Реализуется через подсистему «Транспорты» в окне дерева проекта. Необходимо добавить в нее нужные протоколы, в зависимости от имеющейся конфигурации контроллера.
[[Файл:AgavaPLC-Транспорты.png|мини|Рисунок 4 - Транспорты в дереве проекта AgavaPLC]]
# Транспорт для обмена с субмодулями контроллера (для контроллеров с корзиной субмодулей). В качестве порта транспорта необходимо указать “/dev/ttyS0”. В проекте для МПР-60 присутствует по-умолчанию.
# Транспорт последовательный (для управления по RS-232, RS-485 и т.д.).
# Транспорт TCP/IP (для управления по Ethernet).

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

==== Визуализация данных ====
Визуализация данных технологических процессов реализуется с помощью элементов подсистемы «Визуализация».

Система визуализации недоступна в проектах для контроллеров МПР.
[[Файл:AgavaPLC-Пример визуализации.png|мини|Рисунок 5 - Пример визуализации]]
Визуализация содержит одно или несколько окон, описанных ниже.

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

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

Редактирование содержимого окна или композиции осуществляется в его графическом представлении (см. раздел [[#Редактирование графического представления узла]]).

Более подробное описание подсистемы визуализации приведено в разделе [[#Подсистема визуализации]].

==== Пользовательские алгоритмы ====
Реализовать нужные алгоритмы работы программы можно с помощью различных инструментов, которые выбираются в зависимости от сложности проектов и навыков программиста:

# Операции в группе «Сигналы» – отдельные логические операции. В основном используются для небольших проектов, не требующих сложных методов управления;
# Задачи ПЛК – графическое программирование с помощью связывания между собой различных функциональных блоков. Подходит для больших проектов. Реализуется в узле «Задача ПЛК» группы «Задачи». Подробное описание приведено в разделе [[#Задача ПЛК]]'''.'''
# Скрипты С++ – текстовое программирование на языке высокого уровня. Подходит для больших проектов. Реализуется с помощью операций «Скрипт С++», расположенных в группе «Сигналы» или в задаче ПЛК. Описание реализации языка С++ приведено на странице [[Описание языка С++ в AgavaPLC]].
=== Редактирование свойств узлов ===
Среда разработки обладает развитыми возможностями по редактированию свойств узлов. Описание доступных типов свойств приведно в статье [[Свойства узлов в AgavaPLC/AgavaSCADA]].

==== Редактирование свойств узлов с помощью окна «Свойства» ====
[[Файл:AgavaPLC-Окно "Свойства".png|мини|Рисунок 6 – Окно «Свойства» виджета «Кнопка»]]
Редактирование свойств всех узлов осуществляется с помощью окна «Свойства».

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

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

==== Групповое редактирование свойств узлов ====
При необходимости редактирования разных свойств у большого количества узлов можно воспользоваться специальным окном «Список узлов».
[[Файл:AgavaPLC-Окно "Список узлов".png|мини|Рисунок 7 - Окно "Список узлов"]]
Открытие окна выполняется с помощью вызова команды «Открыть список узлов» в контекстном меню дерева конфигурации. Открытое окно содержит все узлы, вложенные в выбранные при вызове команды.

Окно позволяет редактировать свойства непосредственно в ячейках таблицы, без переключения на окно «Свойства». Групповое редактирование свойств узлов через окно «Свойства» также доступно.

Щелчок правой кнопкой мыши на списке вызывает контекстное меню, содержащее команды:

* “Свойства”;
* “Экспорт в *.txt”;
* “Импорт из *.txt”;
* “Удалить узел”.

Команда «Свойства» открывает диалоговое окно выбора отображаемых свойств.

Команды «Экспорт», «Импорт» выполняют экспорт списка свойств узлов в текстовый файл и импорт соответственно.

Команда «Удалить узел» производит удаление выделенного узла (узлов).

==== Функция групповой замены источников в узлах ====
При разработке сложных проектов может возникнуть необходимость заменить источники сразу в большом количестве узлов. Для этой цели используется функция групповой замены источников. Необходимо перейти в редактирование свойств типа «Список источников», которое производится в соответствующем окне (см. Рисунок 8).
[[Файл:AgavaPLC-Окно редактирования свойств типа «Список источников».png|мини|Рисунок 8 - Окно редактирования свойств типа «Список источников»]]
Затем необходимо использовать функцию групповой замены (см. Рисунок 9), выделив нужные узлы, нажав на них правой кнопкой мыши и выбрав «Групповая замена».
[[Файл:AgavaPLC-Окно функции «Групповая замена».png|мини|Рисунок 9 - Окно функции «Групповая замена»]]

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

* фрейм;
* форма;
* окно с композицией;
* слой.

Открытое графическое представление выбранного узла может содержать все уже размещенные на нем элементы визуализации и (или) другие узлы и позволяет добавить новые.
[[Файл:AgavaPLC–Открытое графическое представление окна «winMain».png|мини|Рисунок 10 – Открытое графическое представление окна «winMain»]]
На рисунке 10 представлено графическое представление окна «winMain», обведенное пунктирной рамкой серого цвета, обозначающей внешнюю границу открытого узла. Тип рамки пользователь может выбрать по своему усмотрению, выбор производится в окне настроек среды разработки, доступном через команду «Настройки» в меню «Параметры».

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

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

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

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

Для связи виджетов с источниками данных можно воспользоваться обычным способом связывания через окно «Свойства». К примеру, связывание размещенного на форме виджета «Текстовая метка» с регистром Modbus осуществляется добавлением регистра Modbus в свойство виджета «Источник».

Вместе с обычным способом связывания существует и другой, более быстрый способ. Для быстрого связывания регистра с виджетом достаточно нажать на регистр в дереве конфигурации левой кнопкой мыши и перенести его на виджет в открытом графическом представлении.
[[Файл:AgavaPLC–Связывание узла «sourceModbusRegister0» и виджета.png|мини|Рисунок 11 – Связывание узла «sourceModbusRegister0» и виджета]]
При помещении курсора над виджетом последний будет заштрихован сеткой зеленого или красного цвета, а курсор изменит свой вид на стрелку с квадратиком (см. рисунок 11).

Зеленая штриховка виджета означает отсутствие связи выделенного виджета с источником данных, в этом случае связывание будет произведено. Красная штриховка говорит об ошибках связывания виджета и сигнала/источника.

==== Редактирование многослойных композиций ====
Редактирование многослойных композиций принципиально не отличается от редактирования форм, кроме одного нюанса. Так как композиция может состоять из нескольких слоев, и виджеты на слоях могут располагаться один над другим, для использования наиболее удобного способа редактирования такой композиции можно воспользоваться возможностью открытия каждого слоя в отдельном окне.
[[Файл:AgavaPLC–Пример структуры композиции «Composition1», состоящей из трех слоев.png|мини|Рисунок 12 – Пример структуры композиции «Composition1», состоящей из трех слоев]]
Для открытия графического представления слоя нужно воспользоваться командой «Открыть графическое представление» аналогично открытию графического представления формы или композиции.

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

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

==== Использование якорей ====
Данная возможность доступна с версии <code>AS 1.6.32+</code>.

При работе с графическими представлениями окон и композиций, содержащих большое количество виджетов, могут быть полезны якоря - создаваемые пользователем метки на размерных линейках.
[[Файл:AgavaPLC-Графическое представление-якоря.png|мини|AS 1.6.32+: Графическое представление формы с установленными якорями]]
Якоря позволяют контролировать положение групп виджетов благодаря связанным с ними линиям привязки. Линии привязки, позволяют быстрее выстраивать группы виджетов благодяря "прилипанию".

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

* Двойным кликом левой кнопки мыши по размерной линейке.
* Кликом правой кнопки мыши на размерной линейке и выбором команды "Добавить якорь".

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

* Двойным кликом левой кнопки мыши по якорю на размерной линейке.
* Кликом правой кнопки мыши на размерной линейке и выбором команды "Удалить якорь".

Созданные якоря можно перемещать по размерной линейке с помощью мыши.

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

== Проверка и отладка проекта ==

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

Для этого необходимо:

# Установить текущий проект как проект по умолчанию. Для этого необходимо вызвать команду "Проект->Установить проект по умолчанию..." и выбрать ранее сохраненный файл конфигурации.
# Запустить среду исполнения. Для этого нужно вызвать команду меню "Проект->Запуск среды исполнения". После этого будет выполнен запуск в новом окне среды исполнения.

=== Мониторинг сигналов ===
[[Файл:AgavaPLC–Окно "Наблюдение".png|мини|Рисунок 14 – Окно "Наблюдение"|ссылка=Файл:AgavaPLC–Окно_%22Наблюдение%22.png]]
Функция мониторинга сигналов позволяет наблюдать значения, хранящиеся в узлах проекта при исполнении проекта на целевом устройстве.

Для запуска данной функции необходимо:

# Запустить среду исполнения.
# Вызвать команду меню «<code>Устройство → Подключение/отключение</code>», в появившемся окне выбрать IP-адрес и порт устройства, значения узлов которого необходимо мониторить. При необходимости просмотра значений узлов и сигналов в режиме эмуляции проекта на персональном компьютере укажите адрес 127.0.0.1. Если необходимо просматривать значения узлов проекта, выполняющегося на контроллере или панели оператора, укажите IP-адрес контроллера или панели.
# Нажать кнопку «Подключение».

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

Для добавления узлов в окно "Наблюдение" необходимо нажать на нужном узле в дереве проекта правой кнопкой мыши и выбрать команду «<code>Добавить в окно наблюдения</code>». Выбранные узлы будут отображаться в окне «Наблюдение» вместе со считанными значениями.

=== Мониторинг событий ===
[[Файл:AgavaPLC–Окно просмотра событий.png|мини|Рисунок 15 – Окно просмотра событий]]Мониторинг событий позволяет наблюдать за исполнением проекта, работающего в устройстве. При включении мониторинга пользователь получает информацию о возникающих нефатальных ошибках и предупреждениях, возникающих в ходе исполнения проекта со следующими признаками:

* метка времени, соответствующая времени возникновения события;
* степень важности события;
* тип события - информационное или события активирования, деактивирования и квитирования тревог;
* имя узла, сформировавшего событие.
* текст события.

==== Использование мониторинга ====
Для старта мониторинга необходимо подключиться к нужному устройству способом, рассмотренным в разделе [[#Мониторинг сигналов]], а затем вызвать команду «<code>Устройство → Просмотр событий</code>». В открывшемся окне будут выводиться все события, регистрируемые устройством.

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

==== Фильтрация событий ====
''Функция доступна начиная с версии <code>AgavaSCADA/AgavaPLC 1.2.56+, 1.5.25+</code>.''

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

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

=== Отладка в задаче ПЛК ===
''Данный раздел актуален для версии <code>AS 1.2.61</code> и старее. В версиях <code>AS 1.6+</code> используется [[Универсальная среда разработки Agava#Отладка проекта|современный пошаговый отладчик]].''

Задача ПЛК (см. раздел [[#Задача ПЛК]]) позволяет проводить тестирование проектов с помощью режима симулятора (на компьютере, без использования контроллера) или онлайн отладки (на контроллере).

==== Управление отладкой ====
Управление режимом симуляции и онлайн отладкой осуществляется с помощью панели инструментов задачи ПЛК (см. рисунок 16).

Панель инструментов содержит следующие элементы:

* Кнопка «Запустить симуляцию».
* Кнопка «Сделать шаг на один цикл».
* Кнопка «Приостановить симуляцию» - ставит выполнение задачи на паузу.
* Кнопка «Остановить симуляцию» - сбрасывает состояние всех блоков к их состоянию по умолчанию.
* Список выбора периода выполнения задачи.
* Кнопка «Показать окно «Наблюдение».

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

Управление симуляцией осуществляется через команды на панели инструментов задачи ПЛК.

Для перехода в режим симуляции нажмите кнопку «Режим симулятора» на панели управления задачи ПЛК.
[[Файл:AgavaPLC-Панель инструментов задачи ПЛК.png|мини|Рисунок 16 - Панель инструментов задачи ПЛК]]
После активации режима симуляции, для изменения значения входа дважды щелкните на нем левой кнопкой мыши и выберите нужный тип и значение. Текущие значения всех блоков, в соответствии с работой программы, будут отображаться в реальном времени.
[[Файл:AgavaPLC–Вид блоков задачи в режиме симулятора.png|мини|Рисунок 17 – Вид блоков задачи в режиме симулятора]]
Для выхода из режима симуляции повторно нажмите кнопку «Режим симуляции» на панели управления задачи ПЛК.

==== Онлайн отладка ====
Режим онлайн отладки позволяет провести тестирование проекта, загруженного и исполняемого в контроллере. Для перехода в режим онлайн отладки загрузите конфигурацию в контроллер, подключитесь к нему, после чего нажмите кнопку «Онлайн отладка» на панели инструментов задачи ПЛК.
[[Файл:AgavaPLC–Вид блоков задачи в режиме онлайн отладки.png|мини|Рисунок 18 – Вид блоков задачи в режиме онлайн отладки]]
На рисунке 18 изображен вид задачи ПЛК в режиме онлайн отладки проекта, запущенного на МПР-60 с установленными субмодулями DI (входы) и R (выходы).

Для онлайн отладки на панели инструментов недоступны кнопка «Приостановить симуляцию» и список выбора периода.

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

=== Проверка проекта ===
[[Файл:AgavaPLC–Окно «Ошибки».png|мини|Рисунок 19 – Окно «Ошибки»]]
Перед сохранением проекта желательно выполнить его проверку на наличие ошибок с помощью команды «Проект->Проверить проект». После проверки обнаруженные ошибки будут отображены в окне «Ошибки».

Если отображение окна «Ошибки» выключено, его можно включить командой «Вид->Показать окно ошибок».

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

Также щелчок левой кнопкой мыши на строке с ошибкой открывает окно «Свойства» и дает возможность изменить в нем все свойства узла, содержащего ошибку.

==== Установка пароля на файл конфигурации ====
[[Файл:AgavaPLC–Установка пароля.png|мини|Рисунок 13 – Установка пароля]]
Файл конфигурации, загружаемый в контроллер или панель оператора, можно защитить паролем, чтобы предотвратить его несанкционированное изменение.

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

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

== Загрузка проекта в устройство ==
Загрузка проекта в целевое устройство может быть осуществлена несколькими способами:

* загрузка из среды разработки;
* загрузка с помощью USB-Flash накопителя (для панелей оператора);
* загрузка через браузер (для МПР-60).

=== Загрузка из среды разработки ===
[[Файл:AgavaPLC–Окно «Загрузка проекта в устройство» после подключения к контроллеру.png|мини|Рисунок 20 – Окно «Загрузка проекта в устройство» после подключения к контроллеру]]
Для загрузки проекта из среды разработки необходимо произвести следующие действия в указанном порядке:

# Создайте файл конфигурации.
# Выполните подключение целевого устройства к ПК по сети Ethernet.
# После подключения вызовите в среде разработки команду «Проект->Загрузка проекта в устройство».
# В открывшемся окне будет отображен список файлов проекта, доступных для загрузки в целевое устройство.
# Выберите необходимые файлы и нажмите кнопку «Загрузить». После нажатия кнопки начнется процесс загрузки файлов, при этом в нижней части окна будет меняться состояние полосы прогресса, а также для каждого файла в таблице будет отображен результат загрузки.
# После окончания загрузки среда исполнения в целевом устройстве будет перезапущена и загруженный проект будет запущен.

=== Загрузка через USB-Flash (для ПО-40 и ПО-50) ===
Для загрузки проекта в устройство с помощью USB-Flash накопителя необходимо произвести следующие действия в указанном порядке:

# Подготовьте USB-Flash накопитель, предварительно отформатировав его в файловую систему FAT32.
# Вызовите в среде разработки команду «Подготовка архива для обновления» в меню «Проект».
# Сохраните архив в корень USB-Flash накопителя.
# Перейдите в системную утилиту, перезагрузив панель оператора, при загрузке во время однократного звукового сигнала нажмите на экран и удерживайте до повторного звукового сигнала. Введите пароль: 111111.
# Перейдите на вкладку «Обновление», затем подключите USB-Flash накопитель через переходник USB-OTG, выберите из списка загрузочный архив, нажать кнопку «Обновить». Дождитесь сообщения «Обновление успешно» и нажмите кнопку «ОК».
# Перейдите на вкладку «Перезапуск» и нажмите кнопку «Перезапуск».
После перезагрузки панели загруженный проект будет запущен.

=== Загрузка через браузер (для МПР-60) ===
Для загрузки проекта через браузер необходимо произвести следующие действия в указанном порядке.

# Вызовите в среде разработки команду «Подготовка архива для обновления» в меню «Проект».
# Сохраните архив.
# Откройте системную утилиту, введя IP-адрес контроллера в адресную строку браузера.
# Перейдите на вкладку «Загрузка ПО». Рисунок 71 - Вкладка системной утилиты «Загрузка ПО»
# Выберите на компьютере архив с проектом, который необходимо загрузить в контроллер.
# Нажмите кнопку «Загрузить».
# Дождитесь окончания загрузки файла и обновления проекта.

== Отладка проекта ==
''Данный функционал доступен в версиях <code>AS 1.6+</code>. Для версий <code>AS 1.2</code> используйте мониторинг, [[Универсальная среда разработки Agava#Отладка в задаче ПЛК|отладку в задачах ПЛК]].''

=== Локальная отладка ===

=== Удаленная отладка ===
[[Категория:AgavaSCADA/AgavaPLC]]

Универсальная среда разработки Agava

2026-03-27T06:35:25Z

TaushkanovKV: /* Загрузка через браузер (для МПР-60) */

Универсальная среда разработки предназначена для создания и редактирования программного обеспечения для панелей оператора АГАВА ПО, многоканальных программируемых реле АГАВА МПР-60 и систем диспетчеризации на базе SCADA-системы AgavaSCADA.

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

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

=== Версии программного обеспечения ===
{{Внимание|Текст=При использовании среды разработки совместно с панелями оператора АГАВА ПО или многоканальными программируемыми реле АГАВА МПР-60 необходимо использовать соответствующую версию среды разработки|Тип=Восклицание синий.png}}
Для определения подходящей версии среды разработки необходимо определить версию среды исполнения, установленной в панели оператора или реле. Тип и версия среды исполнения указаны в системной утилите прибора. Например, "AgavaPLC 1.1", "AgavaPLC 1.2" и т.д. Для использования со средой исполнения AgavaPLC 1.1 необходимо использовать среду разработки версии 1.1, для среды исполнения AgavaPLC 1.2 необходима среда разработки версии 1.2 и так далее.

=== Дополнительные статьи и документы ===
*[[Узлы проекта AgavaSCADA/AgavaPLC|Описание узлов AgavaSCADA/AgavaPLC]].
*[[Свойства узлов в AgavaSCADA/AgavaPLC]].
*[[Транспорты AgavaSCADA/AgavaPLC]].
*[[Описание языка С++ в AgavaPLC|Описание языка С++ в AgavaSCADA/AgavaPLC]]..
*[[Объектная модель AgavaSCADA/AgavaPLC]].
*[[Описание базовых классов AgavaSCADA/AgavaPLC]].
*[[Коды ошибок и предупреждений AgavaSCADA/AgavaPLC]].
*[[Рекомендации по разработке приложений AgavaSCADA/AgavaPLC]].
Полный перечень всех документов, связанных с разработкой приложений на AgavaSCADA/AgavaPLC, приведен на странице [[:Категория:AgavaSCADA/AgavaPLC|категории AgavaSCADA/AgavaPLC]].

== Разработка проекта ==

=== Создание нового проекта ===
Создание нового проекта в среде разработки осуществляется с помощью команды «Создать проект…» в меню «Файл». После вызова данной команды откроется диалоговое окно создания нового проекта (см. Рисунок 1).
[[Файл:AgavaPLC-Создание проекта.png|мини|Рисунок 1 - Окно "Создание нового проекта"]]
Для создания проекта необходимо в списке типов проектов выбрать необходимый, ввести имя проекта и путь для его сохранения, после чего нажать кнопку «Создать проект».

Доступны несколько типов проектов:

* «Пустой проект» – пустой проект, не содержащий никаких узлов. Можно использвоать для создания произвольного проекта "с нуля".
* «Локальный проект» – предварительно настроенный проект, содержащий необходимые подсистемы и предназначенный для реализации простой системы для одного устройства, при выборе данного типа пользователь имеет возможность выбрать нужные ему подсистемы и получить полностью рабочий проект в минимальной конфигурации.
* «Проект АГАВА МПР-60» - проект, предназначенный для исполнения на контроллере АГАВА МПР-60.

=== Редактирование существующего проекта ===
Редактирование существующего проекта начинается с открытия файла проекта путем вызова команды «Открыть…» в меню «Файл». После загрузки файла в основном окне среды разработки будут отображены свойства и параметры проекта (см. Рисунок 2).
[[Файл:AgavaPLC-Основное окно среды разработки.png|мини|Рисунок 2 – Основное окно среды разработки AgavaPLC с загруженным проектом]]
По умолчанию основное окно среды разработки содержит перечисленные ниже части:

# Строка заголовка приложения, панель меню и панель инструментов.
# Окно дерева проекта. Предоставляет доступ ко всей структуре проекта (см. раздел [[#Описание узлов]]).
# Окно свойств (см. раздел [[#Редактирование свойств узлов]] ).
# Область для отображения содержимого, например графического представления окна или задачи ПЛК.
# Область вспомогательных окон (окна наблюдения, ошибок и сообщений)

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

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

=== Структура и состав проекта ===
Типичный проект содержит следующие части:

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

Проект также может содержать следующие части:

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

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

Описание всех частей проекта и их узлов приведено в разделе 4.

=== Разработка проекта ===
[[Файл:AgavaPLC-Добавление узла в проект.png|мини|Рисунок 3 – Добавление узла в проект AgavaPLC]]
Перед началом разработки проекта рекомендуется проанализировать поставленную задачи и определить подсистемы, необходимые для её реализации. Взаимодействие с подсистемами осуществляется через дерево проекта (см. Рисунок 2), в которое добавляются нужные узлы. Для добавления нового узла, необходимо нажать правой кнопкой мыши на узел верхнего уровня, которому он подчинён, и выбрать в контекстном меню команду «Добавить узел».

Основные части типовой программы и способы их реализации приведены ниже.

==== Взаимодействие с внешними устройствами ====
Реализуется через подсистему «Транспорты» в окне дерева проекта. Необходимо добавить в нее нужные протоколы, в зависимости от имеющейся конфигурации контроллера.
[[Файл:AgavaPLC-Транспорты.png|мини|Рисунок 4 - Транспорты в дереве проекта AgavaPLC]]
# Транспорт для обмена с субмодулями контроллера (для контроллеров с корзиной субмодулей). В качестве порта транспорта необходимо указать “/dev/ttyS0”. В проекте для МПР-60 присутствует по-умолчанию.
# Транспорт последовательный (для управления по RS-232, RS-485 и т.д.).
# Транспорт TCP/IP (для управления по Ethernet).

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

==== Визуализация данных ====
Визуализация данных технологических процессов реализуется с помощью элементов подсистемы «Визуализация».

Система визуализации недоступна в проектах для контроллеров МПР.
[[Файл:AgavaPLC-Пример визуализации.png|мини|Рисунок 5 - Пример визуализации]]
Визуализация содержит одно или несколько окон, описанных ниже.

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

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

Редактирование содержимого окна или композиции осуществляется в его графическом представлении (см. раздел [[#Редактирование графического представления узла]]).

Более подробное описание подсистемы визуализации приведено в разделе [[#Подсистема визуализации]].

==== Пользовательские алгоритмы ====
Реализовать нужные алгоритмы работы программы можно с помощью различных инструментов, которые выбираются в зависимости от сложности проектов и навыков программиста:

# Операции в группе «Сигналы» – отдельные логические операции. В основном используются для небольших проектов, не требующих сложных методов управления;
# Задачи ПЛК – графическое программирование с помощью связывания между собой различных функциональных блоков. Подходит для больших проектов. Реализуется в узле «Задача ПЛК» группы «Задачи». Подробное описание приведено в разделе [[#Задача ПЛК]]'''.'''
# Скрипты С++ – текстовое программирование на языке высокого уровня. Подходит для больших проектов. Реализуется с помощью операций «Скрипт С++», расположенных в группе «Сигналы» или в задаче ПЛК. Описание реализации языка С++ приведено на странице [[Описание языка С++ в AgavaPLC]].
=== Редактирование свойств узлов ===
Среда разработки обладает развитыми возможностями по редактированию свойств узлов. Описание доступных типов свойств приведно в статье [[Свойства узлов в AgavaPLC/AgavaSCADA]].

==== Редактирование свойств узлов с помощью окна «Свойства» ====
[[Файл:AgavaPLC-Окно "Свойства".png|мини|Рисунок 6 – Окно «Свойства» виджета «Кнопка»]]
Редактирование свойств всех узлов осуществляется с помощью окна «Свойства».

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

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

==== Групповое редактирование свойств узлов ====
При необходимости редактирования разных свойств у большого количества узлов можно воспользоваться специальным окном «Список узлов».
[[Файл:AgavaPLC-Окно "Список узлов".png|мини|Рисунок 7 - Окно "Список узлов"]]
Открытие окна выполняется с помощью вызова команды «Открыть список узлов» в контекстном меню дерева конфигурации. Открытое окно содержит все узлы, вложенные в выбранные при вызове команды.

Окно позволяет редактировать свойства непосредственно в ячейках таблицы, без переключения на окно «Свойства». Групповое редактирование свойств узлов через окно «Свойства» также доступно.

Щелчок правой кнопкой мыши на списке вызывает контекстное меню, содержащее команды:

* “Свойства”;
* “Экспорт в *.txt”;
* “Импорт из *.txt”;
* “Удалить узел”.

Команда «Свойства» открывает диалоговое окно выбора отображаемых свойств.

Команды «Экспорт», «Импорт» выполняют экспорт списка свойств узлов в текстовый файл и импорт соответственно.

Команда «Удалить узел» производит удаление выделенного узла (узлов).

==== Функция групповой замены источников в узлах ====
При разработке сложных проектов может возникнуть необходимость заменить источники сразу в большом количестве узлов. Для этой цели используется функция групповой замены источников. Необходимо перейти в редактирование свойств типа «Список источников», которое производится в соответствующем окне (см. Рисунок 8).
[[Файл:AgavaPLC-Окно редактирования свойств типа «Список источников».png|мини|Рисунок 8 - Окно редактирования свойств типа «Список источников»]]
Затем необходимо использовать функцию групповой замены (см. Рисунок 9), выделив нужные узлы, нажав на них правой кнопкой мыши и выбрав «Групповая замена».
[[Файл:AgavaPLC-Окно функции «Групповая замена».png|мини|Рисунок 9 - Окно функции «Групповая замена»]]

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

* фрейм;
* форма;
* окно с композицией;
* слой.

Открытое графическое представление выбранного узла может содержать все уже размещенные на нем элементы визуализации и (или) другие узлы и позволяет добавить новые.
[[Файл:AgavaPLC–Открытое графическое представление окна «winMain».png|мини|Рисунок 10 – Открытое графическое представление окна «winMain»]]
На рисунке 10 представлено графическое представление окна «winMain», обведенное пунктирной рамкой серого цвета, обозначающей внешнюю границу открытого узла. Тип рамки пользователь может выбрать по своему усмотрению, выбор производится в окне настроек среды разработки, доступном через команду «Настройки» в меню «Параметры».

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

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

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

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

Для связи виджетов с источниками данных можно воспользоваться обычным способом связывания через окно «Свойства». К примеру, связывание размещенного на форме виджета «Текстовая метка» с регистром Modbus осуществляется добавлением регистра Modbus в свойство виджета «Источник».

Вместе с обычным способом связывания существует и другой, более быстрый способ. Для быстрого связывания регистра с виджетом достаточно нажать на регистр в дереве конфигурации левой кнопкой мыши и перенести его на виджет в открытом графическом представлении.
[[Файл:AgavaPLC–Связывание узла «sourceModbusRegister0» и виджета.png|мини|Рисунок 11 – Связывание узла «sourceModbusRegister0» и виджета]]
При помещении курсора над виджетом последний будет заштрихован сеткой зеленого или красного цвета, а курсор изменит свой вид на стрелку с квадратиком (см. рисунок 11).

Зеленая штриховка виджета означает отсутствие связи выделенного виджета с источником данных, в этом случае связывание будет произведено. Красная штриховка говорит об ошибках связывания виджета и сигнала/источника.

==== Редактирование многослойных композиций ====
Редактирование многослойных композиций принципиально не отличается от редактирования форм, кроме одного нюанса. Так как композиция может состоять из нескольких слоев, и виджеты на слоях могут располагаться один над другим, для использования наиболее удобного способа редактирования такой композиции можно воспользоваться возможностью открытия каждого слоя в отдельном окне.
[[Файл:AgavaPLC–Пример структуры композиции «Composition1», состоящей из трех слоев.png|мини|Рисунок 12 – Пример структуры композиции «Composition1», состоящей из трех слоев]]
Для открытия графического представления слоя нужно воспользоваться командой «Открыть графическое представление» аналогично открытию графического представления формы или композиции.

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

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

==== Использование якорей ====
Данная возможность доступна с версии <code>AS 1.6.32+</code>.

При работе с графическими представлениями окон и композиций, содержащих большое количество виджетов, могут быть полезны якоря - создаваемые пользователем метки на размерных линейках.
[[Файл:AgavaPLC-Графическое представление-якоря.png|мини|AS 1.6.32+: Графическое представление формы с установленными якорями]]
Якоря позволяют контролировать положение групп виджетов благодаря связанным с ними линиям привязки. Линии привязки, позволяют быстрее выстраивать группы виджетов благодяря "прилипанию".

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

* Двойным кликом левой кнопки мыши по размерной линейке.
* Кликом правой кнопки мыши на размерной линейке и выбором команды "Добавить якорь".

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

* Двойным кликом левой кнопки мыши по якорю на размерной линейке.
* Кликом правой кнопки мыши на размерной линейке и выбором команды "Удалить якорь".

Созданные якоря можно перемещать по размерной линейке с помощью мыши.

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

== Проверка и отладка проекта ==

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

Для этого необходимо:

# Установить текущий проект как проект по умолчанию. Для этого необходимо вызвать команду "Проект->Установить проект по умолчанию..." и выбрать ранее сохраненный файл конфигурации.
# Запустить среду исполнения. Для этого нужно вызвать команду меню "Проект->Запуск среды исполнения". После этого будет выполнен запуск в новом окне среды исполнения.

=== Мониторинг сигналов ===
[[Файл:AgavaPLC–Окно "Наблюдение".png|мини|Рисунок 14 – Окно "Наблюдение"|ссылка=Файл:AgavaPLC–Окно_%22Наблюдение%22.png]]
Функция мониторинга сигналов позволяет наблюдать значения, хранящиеся в узлах проекта при исполнении проекта на целевом устройстве.

Для запуска данной функции необходимо:

# Запустить среду исполнения.
# Вызвать команду меню «<code>Устройство → Подключение/отключение</code>», в появившемся окне выбрать IP-адрес и порт устройства, значения узлов которого необходимо мониторить. При необходимости просмотра значений узлов и сигналов в режиме эмуляции проекта на персональном компьютере укажите адрес 127.0.0.1. Если необходимо просматривать значения узлов проекта, выполняющегося на контроллере или панели оператора, укажите IP-адрес контроллера или панели.
# Нажать кнопку «Подключение».

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

Для добавления узлов в окно "Наблюдение" необходимо нажать на нужном узле в дереве проекта правой кнопкой мыши и выбрать команду «<code>Добавить в окно наблюдения</code>». Выбранные узлы будут отображаться в окне «Наблюдение» вместе со считанными значениями.

=== Мониторинг событий ===
[[Файл:AgavaPLC–Окно просмотра событий.png|мини|Рисунок 15 – Окно просмотра событий]]Мониторинг событий позволяет наблюдать за исполнением проекта, работающего в устройстве. При включении мониторинга пользователь получает информацию о возникающих нефатальных ошибках и предупреждениях, возникающих в ходе исполнения проекта со следующими признаками:

* метка времени, соответствующая времени возникновения события;
* степень важности события;
* тип события - информационное или события активирования, деактивирования и квитирования тревог;
* имя узла, сформировавшего событие.
* текст события.

==== Использование мониторинга ====
Для старта мониторинга необходимо подключиться к нужному устройству способом, рассмотренным в разделе [[#Мониторинг сигналов]], а затем вызвать команду «<code>Устройство → Просмотр событий</code>». В открывшемся окне будут выводиться все события, регистрируемые устройством.

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

==== Фильтрация событий ====
''Функция доступна начиная с версии <code>AgavaSCADA/AgavaPLC 1.2.56+, 1.5.25+</code>.''

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

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

=== Отладка в задаче ПЛК ===
''Данный раздел актуален для версии <code>AS 1.2.61</code> и старее. В версиях <code>AS 1.6+</code> используется другой, пошаговый отладчик.''

Задача ПЛК (см. раздел [[#Задача ПЛК]]) позволяет проводить тестирование проектов с помощью режима симулятора (на компьютере, без использования контроллера) или онлайн отладки (на контроллере).

==== Управление отладкой ====
Управление режимом симуляции и онлайн отладкой осуществляется с помощью панели инструментов задачи ПЛК (см. рисунок 16).

Панель инструментов содержит следующие элементы:

* Кнопка «Запустить симуляцию».
* Кнопка «Сделать шаг на один цикл».
* Кнопка «Приостановить симуляцию» - ставит выполнение задачи на паузу.
* Кнопка «Остановить симуляцию» - сбрасывает состояние всех блоков к их состоянию по умолчанию.
* Список выбора периода выполнения задачи.
* Кнопка «Показать окно «Наблюдение».

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

Управление симуляцией осуществляется через команды на панели инструментов задачи ПЛК.

Для перехода в режим симуляции нажмите кнопку «Режим симулятора» на панели управления задачи ПЛК.
[[Файл:AgavaPLC-Панель инструментов задачи ПЛК.png|мини|Рисунок 16 - Панель инструментов задачи ПЛК]]
После активации режима симуляции, для изменения значения входа дважды щелкните на нем левой кнопкой мыши и выберите нужный тип и значение. Текущие значения всех блоков, в соответствии с работой программы, будут отображаться в реальном времени.
[[Файл:AgavaPLC–Вид блоков задачи в режиме симулятора.png|мини|Рисунок 17 – Вид блоков задачи в режиме симулятора]]
Для выхода из режима симуляции повторно нажмите кнопку «Режим симуляции» на панели управления задачи ПЛК.

==== Онлайн отладка ====
Режим онлайн отладки позволяет провести тестирование проекта, загруженного и исполняемого в контроллере. Для перехода в режим онлайн отладки загрузите конфигурацию в контроллер, подключитесь к нему, после чего нажмите кнопку «Онлайн отладка» на панели инструментов задачи ПЛК.
[[Файл:AgavaPLC–Вид блоков задачи в режиме онлайн отладки.png|мини|Рисунок 18 – Вид блоков задачи в режиме онлайн отладки]]
На рисунке 18 изображен вид задачи ПЛК в режиме онлайн отладки проекта, запущенного на МПР-60 с установленными субмодулями DI (входы) и R (выходы).

Для онлайн отладки на панели инструментов недоступны кнопка «Приостановить симуляцию» и список выбора периода.

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

=== Проверка проекта ===
[[Файл:AgavaPLC–Окно «Ошибки».png|мини|Рисунок 19 – Окно «Ошибки»]]
Перед сохранением проекта желательно выполнить его проверку на наличие ошибок с помощью команды «Проект->Проверить проект». После проверки обнаруженные ошибки будут отображены в окне «Ошибки».

Если отображение окна «Ошибки» выключено, его можно включить командой «Вид->Показать окно ошибок».

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

Также щелчок левой кнопкой мыши на строке с ошибкой открывает окно «Свойства» и дает возможность изменить в нем все свойства узла, содержащего ошибку.

==== Установка пароля на файл конфигурации ====
[[Файл:AgavaPLC–Установка пароля.png|мини|Рисунок 13 – Установка пароля]]
Файл конфигурации, загружаемый в контроллер или панель оператора, можно защитить паролем, чтобы предотвратить его несанкционированное изменение.

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

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

== Загрузка проекта в устройство ==
Загрузка проекта в целевое устройство может быть осуществлена несколькими способами:

* загрузка из среды разработки;
* загрузка с помощью USB-Flash накопителя (для панелей оператора);
* загрузка через браузер (для МПР-60).

=== Загрузка из среды разработки ===
[[Файл:AgavaPLC–Окно «Загрузка проекта в устройство» после подключения к контроллеру.png|мини|Рисунок 20 – Окно «Загрузка проекта в устройство» после подключения к контроллеру]]
Для загрузки проекта из среды разработки необходимо произвести следующие действия в указанном порядке:

# Создайте файл конфигурации.
# Выполните подключение целевого устройства к ПК по сети Ethernet.
# После подключения вызовите в среде разработки команду «Проект->Загрузка проекта в устройство».
# В открывшемся окне будет отображен список файлов проекта, доступных для загрузки в целевое устройство.
# Выберите необходимые файлы и нажмите кнопку «Загрузить». После нажатия кнопки начнется процесс загрузки файлов, при этом в нижней части окна будет меняться состояние полосы прогресса, а также для каждого файла в таблице будет отображен результат загрузки.
# После окончания загрузки среда исполнения в целевом устройстве будет перезапущена и загруженный проект будет запущен.

=== Загрузка через USB-Flash (для ПО-40 и ПО-50) ===
Для загрузки проекта в устройство с помощью USB-Flash накопителя необходимо произвести следующие действия в указанном порядке:

# Подготовьте USB-Flash накопитель, предварительно отформатировав его в файловую систему FAT32.
# Вызовите в среде разработки команду «Подготовка архива для обновления» в меню «Проект».
# Сохраните архив в корень USB-Flash накопителя.
# Перейдите в системную утилиту, перезагрузив панель оператора, при загрузке во время однократного звукового сигнала нажмите на экран и удерживайте до повторного звукового сигнала. Введите пароль: 111111.
# Перейдите на вкладку «Обновление», затем подключите USB-Flash накопитель через переходник USB-OTG, выберите из списка загрузочный архив, нажать кнопку «Обновить». Дождитесь сообщения «Обновление успешно» и нажмите кнопку «ОК».
# Перейдите на вкладку «Перезапуск» и нажмите кнопку «Перезапуск».
После перезагрузки панели загруженный проект будет запущен.

=== Загрузка через браузер (для МПР-60) ===
Для загрузки проекта через браузер необходимо произвести следующие действия в указанном порядке.

# Вызовите в среде разработки команду «Подготовка архива для обновления» в меню «Проект».
# Сохраните архив.
# Откройте системную утилиту, введя IP-адрес контроллера в адресную строку браузера.
# Перейдите на вкладку «Загрузка ПО». Рисунок 71 - Вкладка системной утилиты «Загрузка ПО»
# Выберите на компьютере архив с проектом, который необходимо загрузить в контроллер.
# Нажмите кнопку «Загрузить».
# Дождитесь окончания загрузки файла и обновления проекта.

== Отладка проекта ==
''Данный функционал доступен в версиях <code>AS 1.6+</code>. Для версий <code>AS 1.2</code> используйте мониторинг, [[Универсальная среда разработки Agava#Отладка в задаче ПЛК|отладку в задачах ПЛК]].''

=== Локальная отладка ===

=== Удаленная отладка ===
[[Категория:AgavaSCADA/AgavaPLC]]

Универсальная среда разработки Agava

2026-03-27T06:31:17Z

TaushkanovKV: /* Отладка в задаче ПЛК */

Универсальная среда разработки предназначена для создания и редактирования программного обеспечения для панелей оператора АГАВА ПО, многоканальных программируемых реле АГАВА МПР-60 и систем диспетчеризации на базе SCADA-системы AgavaSCADA.

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

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

=== Версии программного обеспечения ===
{{Внимание|Текст=При использовании среды разработки совместно с панелями оператора АГАВА ПО или многоканальными программируемыми реле АГАВА МПР-60 необходимо использовать соответствующую версию среды разработки|Тип=Восклицание синий.png}}
Для определения подходящей версии среды разработки необходимо определить версию среды исполнения, установленной в панели оператора или реле. Тип и версия среды исполнения указаны в системной утилите прибора. Например, "AgavaPLC 1.1", "AgavaPLC 1.2" и т.д. Для использования со средой исполнения AgavaPLC 1.1 необходимо использовать среду разработки версии 1.1, для среды исполнения AgavaPLC 1.2 необходима среда разработки версии 1.2 и так далее.

=== Дополнительные статьи и документы ===
*[[Узлы проекта AgavaSCADA/AgavaPLC|Описание узлов AgavaSCADA/AgavaPLC]].
*[[Свойства узлов в AgavaSCADA/AgavaPLC]].
*[[Транспорты AgavaSCADA/AgavaPLC]].
*[[Описание языка С++ в AgavaPLC|Описание языка С++ в AgavaSCADA/AgavaPLC]]..
*[[Объектная модель AgavaSCADA/AgavaPLC]].
*[[Описание базовых классов AgavaSCADA/AgavaPLC]].
*[[Коды ошибок и предупреждений AgavaSCADA/AgavaPLC]].
*[[Рекомендации по разработке приложений AgavaSCADA/AgavaPLC]].
Полный перечень всех документов, связанных с разработкой приложений на AgavaSCADA/AgavaPLC, приведен на странице [[:Категория:AgavaSCADA/AgavaPLC|категории AgavaSCADA/AgavaPLC]].

== Разработка проекта ==

=== Создание нового проекта ===
Создание нового проекта в среде разработки осуществляется с помощью команды «Создать проект…» в меню «Файл». После вызова данной команды откроется диалоговое окно создания нового проекта (см. Рисунок 1).
[[Файл:AgavaPLC-Создание проекта.png|мини|Рисунок 1 - Окно "Создание нового проекта"]]
Для создания проекта необходимо в списке типов проектов выбрать необходимый, ввести имя проекта и путь для его сохранения, после чего нажать кнопку «Создать проект».

Доступны несколько типов проектов:

* «Пустой проект» – пустой проект, не содержащий никаких узлов. Можно использвоать для создания произвольного проекта "с нуля".
* «Локальный проект» – предварительно настроенный проект, содержащий необходимые подсистемы и предназначенный для реализации простой системы для одного устройства, при выборе данного типа пользователь имеет возможность выбрать нужные ему подсистемы и получить полностью рабочий проект в минимальной конфигурации.
* «Проект АГАВА МПР-60» - проект, предназначенный для исполнения на контроллере АГАВА МПР-60.

=== Редактирование существующего проекта ===
Редактирование существующего проекта начинается с открытия файла проекта путем вызова команды «Открыть…» в меню «Файл». После загрузки файла в основном окне среды разработки будут отображены свойства и параметры проекта (см. Рисунок 2).
[[Файл:AgavaPLC-Основное окно среды разработки.png|мини|Рисунок 2 – Основное окно среды разработки AgavaPLC с загруженным проектом]]
По умолчанию основное окно среды разработки содержит перечисленные ниже части:

# Строка заголовка приложения, панель меню и панель инструментов.
# Окно дерева проекта. Предоставляет доступ ко всей структуре проекта (см. раздел [[#Описание узлов]]).
# Окно свойств (см. раздел [[#Редактирование свойств узлов]] ).
# Область для отображения содержимого, например графического представления окна или задачи ПЛК.
# Область вспомогательных окон (окна наблюдения, ошибок и сообщений)

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

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

=== Структура и состав проекта ===
Типичный проект содержит следующие части:

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

Проект также может содержать следующие части:

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

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

Описание всех частей проекта и их узлов приведено в разделе 4.

=== Разработка проекта ===
[[Файл:AgavaPLC-Добавление узла в проект.png|мини|Рисунок 3 – Добавление узла в проект AgavaPLC]]
Перед началом разработки проекта рекомендуется проанализировать поставленную задачи и определить подсистемы, необходимые для её реализации. Взаимодействие с подсистемами осуществляется через дерево проекта (см. Рисунок 2), в которое добавляются нужные узлы. Для добавления нового узла, необходимо нажать правой кнопкой мыши на узел верхнего уровня, которому он подчинён, и выбрать в контекстном меню команду «Добавить узел».

Основные части типовой программы и способы их реализации приведены ниже.

==== Взаимодействие с внешними устройствами ====
Реализуется через подсистему «Транспорты» в окне дерева проекта. Необходимо добавить в нее нужные протоколы, в зависимости от имеющейся конфигурации контроллера.
[[Файл:AgavaPLC-Транспорты.png|мини|Рисунок 4 - Транспорты в дереве проекта AgavaPLC]]
# Транспорт для обмена с субмодулями контроллера (для контроллеров с корзиной субмодулей). В качестве порта транспорта необходимо указать “/dev/ttyS0”. В проекте для МПР-60 присутствует по-умолчанию.
# Транспорт последовательный (для управления по RS-232, RS-485 и т.д.).
# Транспорт TCP/IP (для управления по Ethernet).

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

==== Визуализация данных ====
Визуализация данных технологических процессов реализуется с помощью элементов подсистемы «Визуализация».

Система визуализации недоступна в проектах для контроллеров МПР.
[[Файл:AgavaPLC-Пример визуализации.png|мини|Рисунок 5 - Пример визуализации]]
Визуализация содержит одно или несколько окон, описанных ниже.

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

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

Редактирование содержимого окна или композиции осуществляется в его графическом представлении (см. раздел [[#Редактирование графического представления узла]]).

Более подробное описание подсистемы визуализации приведено в разделе [[#Подсистема визуализации]].

==== Пользовательские алгоритмы ====
Реализовать нужные алгоритмы работы программы можно с помощью различных инструментов, которые выбираются в зависимости от сложности проектов и навыков программиста:

# Операции в группе «Сигналы» – отдельные логические операции. В основном используются для небольших проектов, не требующих сложных методов управления;
# Задачи ПЛК – графическое программирование с помощью связывания между собой различных функциональных блоков. Подходит для больших проектов. Реализуется в узле «Задача ПЛК» группы «Задачи». Подробное описание приведено в разделе [[#Задача ПЛК]]'''.'''
# Скрипты С++ – текстовое программирование на языке высокого уровня. Подходит для больших проектов. Реализуется с помощью операций «Скрипт С++», расположенных в группе «Сигналы» или в задаче ПЛК. Описание реализации языка С++ приведено на странице [[Описание языка С++ в AgavaPLC]].
=== Редактирование свойств узлов ===
Среда разработки обладает развитыми возможностями по редактированию свойств узлов. Описание доступных типов свойств приведно в статье [[Свойства узлов в AgavaPLC/AgavaSCADA]].

==== Редактирование свойств узлов с помощью окна «Свойства» ====
[[Файл:AgavaPLC-Окно "Свойства".png|мини|Рисунок 6 – Окно «Свойства» виджета «Кнопка»]]
Редактирование свойств всех узлов осуществляется с помощью окна «Свойства».

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

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

==== Групповое редактирование свойств узлов ====
При необходимости редактирования разных свойств у большого количества узлов можно воспользоваться специальным окном «Список узлов».
[[Файл:AgavaPLC-Окно "Список узлов".png|мини|Рисунок 7 - Окно "Список узлов"]]
Открытие окна выполняется с помощью вызова команды «Открыть список узлов» в контекстном меню дерева конфигурации. Открытое окно содержит все узлы, вложенные в выбранные при вызове команды.

Окно позволяет редактировать свойства непосредственно в ячейках таблицы, без переключения на окно «Свойства». Групповое редактирование свойств узлов через окно «Свойства» также доступно.

Щелчок правой кнопкой мыши на списке вызывает контекстное меню, содержащее команды:

* “Свойства”;
* “Экспорт в *.txt”;
* “Импорт из *.txt”;
* “Удалить узел”.

Команда «Свойства» открывает диалоговое окно выбора отображаемых свойств.

Команды «Экспорт», «Импорт» выполняют экспорт списка свойств узлов в текстовый файл и импорт соответственно.

Команда «Удалить узел» производит удаление выделенного узла (узлов).

==== Функция групповой замены источников в узлах ====
При разработке сложных проектов может возникнуть необходимость заменить источники сразу в большом количестве узлов. Для этой цели используется функция групповой замены источников. Необходимо перейти в редактирование свойств типа «Список источников», которое производится в соответствующем окне (см. Рисунок 8).
[[Файл:AgavaPLC-Окно редактирования свойств типа «Список источников».png|мини|Рисунок 8 - Окно редактирования свойств типа «Список источников»]]
Затем необходимо использовать функцию групповой замены (см. Рисунок 9), выделив нужные узлы, нажав на них правой кнопкой мыши и выбрав «Групповая замена».
[[Файл:AgavaPLC-Окно функции «Групповая замена».png|мини|Рисунок 9 - Окно функции «Групповая замена»]]

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

* фрейм;
* форма;
* окно с композицией;
* слой.

Открытое графическое представление выбранного узла может содержать все уже размещенные на нем элементы визуализации и (или) другие узлы и позволяет добавить новые.
[[Файл:AgavaPLC–Открытое графическое представление окна «winMain».png|мини|Рисунок 10 – Открытое графическое представление окна «winMain»]]
На рисунке 10 представлено графическое представление окна «winMain», обведенное пунктирной рамкой серого цвета, обозначающей внешнюю границу открытого узла. Тип рамки пользователь может выбрать по своему усмотрению, выбор производится в окне настроек среды разработки, доступном через команду «Настройки» в меню «Параметры».

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

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

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

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

Для связи виджетов с источниками данных можно воспользоваться обычным способом связывания через окно «Свойства». К примеру, связывание размещенного на форме виджета «Текстовая метка» с регистром Modbus осуществляется добавлением регистра Modbus в свойство виджета «Источник».

Вместе с обычным способом связывания существует и другой, более быстрый способ. Для быстрого связывания регистра с виджетом достаточно нажать на регистр в дереве конфигурации левой кнопкой мыши и перенести его на виджет в открытом графическом представлении.
[[Файл:AgavaPLC–Связывание узла «sourceModbusRegister0» и виджета.png|мини|Рисунок 11 – Связывание узла «sourceModbusRegister0» и виджета]]
При помещении курсора над виджетом последний будет заштрихован сеткой зеленого или красного цвета, а курсор изменит свой вид на стрелку с квадратиком (см. рисунок 11).

Зеленая штриховка виджета означает отсутствие связи выделенного виджета с источником данных, в этом случае связывание будет произведено. Красная штриховка говорит об ошибках связывания виджета и сигнала/источника.

==== Редактирование многослойных композиций ====
Редактирование многослойных композиций принципиально не отличается от редактирования форм, кроме одного нюанса. Так как композиция может состоять из нескольких слоев, и виджеты на слоях могут располагаться один над другим, для использования наиболее удобного способа редактирования такой композиции можно воспользоваться возможностью открытия каждого слоя в отдельном окне.
[[Файл:AgavaPLC–Пример структуры композиции «Composition1», состоящей из трех слоев.png|мини|Рисунок 12 – Пример структуры композиции «Composition1», состоящей из трех слоев]]
Для открытия графического представления слоя нужно воспользоваться командой «Открыть графическое представление» аналогично открытию графического представления формы или композиции.

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

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

==== Использование якорей ====
Данная возможность доступна с версии <code>AS 1.6.32+</code>.

При работе с графическими представлениями окон и композиций, содержащих большое количество виджетов, могут быть полезны якоря - создаваемые пользователем метки на размерных линейках.
[[Файл:AgavaPLC-Графическое представление-якоря.png|мини|AS 1.6.32+: Графическое представление формы с установленными якорями]]
Якоря позволяют контролировать положение групп виджетов благодаря связанным с ними линиям привязки. Линии привязки, позволяют быстрее выстраивать группы виджетов благодяря "прилипанию".

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

* Двойным кликом левой кнопки мыши по размерной линейке.
* Кликом правой кнопки мыши на размерной линейке и выбором команды "Добавить якорь".

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

* Двойным кликом левой кнопки мыши по якорю на размерной линейке.
* Кликом правой кнопки мыши на размерной линейке и выбором команды "Удалить якорь".

Созданные якоря можно перемещать по размерной линейке с помощью мыши.

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

== Проверка и отладка проекта ==

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

Для этого необходимо:

# Установить текущий проект как проект по умолчанию. Для этого необходимо вызвать команду "Проект->Установить проект по умолчанию..." и выбрать ранее сохраненный файл конфигурации.
# Запустить среду исполнения. Для этого нужно вызвать команду меню "Проект->Запуск среды исполнения". После этого будет выполнен запуск в новом окне среды исполнения.

=== Мониторинг сигналов ===
[[Файл:AgavaPLC–Окно "Наблюдение".png|мини|Рисунок 14 – Окно "Наблюдение"|ссылка=Файл:AgavaPLC–Окно_%22Наблюдение%22.png]]
Функция мониторинга сигналов позволяет наблюдать значения, хранящиеся в узлах проекта при исполнении проекта на целевом устройстве.

Для запуска данной функции необходимо:

# Запустить среду исполнения.
# Вызвать команду меню «<code>Устройство → Подключение/отключение</code>», в появившемся окне выбрать IP-адрес и порт устройства, значения узлов которого необходимо мониторить. При необходимости просмотра значений узлов и сигналов в режиме эмуляции проекта на персональном компьютере укажите адрес 127.0.0.1. Если необходимо просматривать значения узлов проекта, выполняющегося на контроллере или панели оператора, укажите IP-адрес контроллера или панели.
# Нажать кнопку «Подключение».

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

Для добавления узлов в окно "Наблюдение" необходимо нажать на нужном узле в дереве проекта правой кнопкой мыши и выбрать команду «<code>Добавить в окно наблюдения</code>». Выбранные узлы будут отображаться в окне «Наблюдение» вместе со считанными значениями.

=== Мониторинг событий ===
[[Файл:AgavaPLC–Окно просмотра событий.png|мини|Рисунок 15 – Окно просмотра событий]]Мониторинг событий позволяет наблюдать за исполнением проекта, работающего в устройстве. При включении мониторинга пользователь получает информацию о возникающих нефатальных ошибках и предупреждениях, возникающих в ходе исполнения проекта со следующими признаками:

* метка времени, соответствующая времени возникновения события;
* степень важности события;
* тип события - информационное или события активирования, деактивирования и квитирования тревог;
* имя узла, сформировавшего событие.
* текст события.

==== Использование мониторинга ====
Для старта мониторинга необходимо подключиться к нужному устройству способом, рассмотренным в разделе [[#Мониторинг сигналов]], а затем вызвать команду «<code>Устройство → Просмотр событий</code>». В открывшемся окне будут выводиться все события, регистрируемые устройством.

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

==== Фильтрация событий ====
''Функция доступна начиная с версии <code>AgavaSCADA/AgavaPLC 1.2.56+, 1.5.25+</code>.''

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

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

=== Отладка в задаче ПЛК ===
''Данный раздел актуален для версии <code>AS 1.2.61</code> и старее. В версиях <code>AS 1.6+</code> используется другой, пошаговый отладчик.''

Задача ПЛК (см. раздел [[#Задача ПЛК]]) позволяет проводить тестирование проектов с помощью режима симулятора (на компьютере, без использования контроллера) или онлайн отладки (на контроллере).

==== Управление отладкой ====
Управление режимом симуляции и онлайн отладкой осуществляется с помощью панели инструментов задачи ПЛК (см. рисунок 16).

Панель инструментов содержит следующие элементы:

* Кнопка «Запустить симуляцию».
* Кнопка «Сделать шаг на один цикл».
* Кнопка «Приостановить симуляцию» - ставит выполнение задачи на паузу.
* Кнопка «Остановить симуляцию» - сбрасывает состояние всех блоков к их состоянию по умолчанию.
* Список выбора периода выполнения задачи.
* Кнопка «Показать окно «Наблюдение».

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

Управление симуляцией осуществляется через команды на панели инструментов задачи ПЛК.

Для перехода в режим симуляции нажмите кнопку «Режим симулятора» на панели управления задачи ПЛК.
[[Файл:AgavaPLC-Панель инструментов задачи ПЛК.png|мини|Рисунок 16 - Панель инструментов задачи ПЛК]]
После активации режима симуляции, для изменения значения входа дважды щелкните на нем левой кнопкой мыши и выберите нужный тип и значение. Текущие значения всех блоков, в соответствии с работой программы, будут отображаться в реальном времени.
[[Файл:AgavaPLC–Вид блоков задачи в режиме симулятора.png|мини|Рисунок 17 – Вид блоков задачи в режиме симулятора]]
Для выхода из режима симуляции повторно нажмите кнопку «Режим симуляции» на панели управления задачи ПЛК.

==== Онлайн отладка ====
Режим онлайн отладки позволяет провести тестирование проекта, загруженного и исполняемого в контроллере. Для перехода в режим онлайн отладки загрузите конфигурацию в контроллер, подключитесь к нему, после чего нажмите кнопку «Онлайн отладка» на панели инструментов задачи ПЛК.
[[Файл:AgavaPLC–Вид блоков задачи в режиме онлайн отладки.png|мини|Рисунок 18 – Вид блоков задачи в режиме онлайн отладки]]
На рисунке 18 изображен вид задачи ПЛК в режиме онлайн отладки проекта, запущенного на МПР-60 с установленными субмодулями DI (входы) и R (выходы).

Для онлайн отладки на панели инструментов недоступны кнопка «Приостановить симуляцию» и список выбора периода.

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

=== Проверка проекта ===
[[Файл:AgavaPLC–Окно «Ошибки».png|мини|Рисунок 19 – Окно «Ошибки»]]
Перед сохранением проекта желательно выполнить его проверку на наличие ошибок с помощью команды «Проект->Проверить проект». После проверки обнаруженные ошибки будут отображены в окне «Ошибки».

Если отображение окна «Ошибки» выключено, его можно включить командой «Вид->Показать окно ошибок».

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

Также щелчок левой кнопкой мыши на строке с ошибкой открывает окно «Свойства» и дает возможность изменить в нем все свойства узла, содержащего ошибку.

==== Установка пароля на файл конфигурации ====
[[Файл:AgavaPLC–Установка пароля.png|мини|Рисунок 13 – Установка пароля]]
Файл конфигурации, загружаемый в контроллер или панель оператора, можно защитить паролем, чтобы предотвратить его несанкционированное изменение.

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

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

== Загрузка проекта в устройство ==
Загрузка проекта в целевое устройство может быть осуществлена несколькими способами:

* загрузка из среды разработки;
* загрузка с помощью USB-Flash накопителя (для панелей оператора);
* загрузка через браузер (для МПР-60).

=== Загрузка из среды разработки ===
[[Файл:AgavaPLC–Окно «Загрузка проекта в устройство» после подключения к контроллеру.png|мини|Рисунок 20 – Окно «Загрузка проекта в устройство» после подключения к контроллеру]]
Для загрузки проекта из среды разработки необходимо произвести следующие действия в указанном порядке:

# Создайте файл конфигурации.
# Выполните подключение целевого устройства к ПК по сети Ethernet.
# После подключения вызовите в среде разработки команду «Проект->Загрузка проекта в устройство».
# В открывшемся окне будет отображен список файлов проекта, доступных для загрузки в целевое устройство.
# Выберите необходимые файлы и нажмите кнопку «Загрузить». После нажатия кнопки начнется процесс загрузки файлов, при этом в нижней части окна будет меняться состояние полосы прогресса, а также для каждого файла в таблице будет отображен результат загрузки.
# После окончания загрузки среда исполнения в целевом устройстве будет перезапущена и загруженный проект будет запущен.

=== Загрузка через USB-Flash (для ПО-40 и ПО-50) ===
Для загрузки проекта в устройство с помощью USB-Flash накопителя необходимо произвести следующие действия в указанном порядке:

# Подготовьте USB-Flash накопитель, предварительно отформатировав его в файловую систему FAT32.
# Вызовите в среде разработки команду «Подготовка архива для обновления» в меню «Проект».
# Сохраните архив в корень USB-Flash накопителя.
# Перейдите в системную утилиту, перезагрузив панель оператора, при загрузке во время однократного звукового сигнала нажмите на экран и удерживайте до повторного звукового сигнала. Введите пароль: 111111.
# Перейдите на вкладку «Обновление», затем подключите USB-Flash накопитель через переходник USB-OTG, выберите из списка загрузочный архив, нажать кнопку «Обновить». Дождитесь сообщения «Обновление успешно» и нажмите кнопку «ОК».
# Перейдите на вкладку «Перезапуск» и нажмите кнопку «Перезапуск».
После перезагрузки панели загруженный проект будет запущен.

=== Загрузка через браузер (для МПР-60) ===
Для загрузки проекта через браузер необходимо произвести следующие действия в указанном порядке.

# Вызовите в среде разработки команду «Подготовка архива для обновления» в меню «Проект».
# Сохраните архив.
# Откройте системную утилиту, введя IP-адрес контроллера в адресную строку браузера.
# Перейдите на вкладку «Загрузка ПО». Рисунок 71 - Вкладка системной утилиты «Загрузка ПО»
# Выберите на компьютере архив с проектом, который необходимо загрузить в контроллер.
# Нажмите кнопку «Загрузить».
# Дождитесь окончания загрузки файла и обновления проекта.

[[Категория:AgavaSCADA/AgavaPLC]]