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

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]]

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

2026-03-27T05:37:35Z

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.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-27T05:36:40Z

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>». В открывшемся окне будут выводиться все события, регистрируемые устройством.

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

==== Фильтрация событий ====
''Функция доступна начиная с версии AgavaSCADA/AgavaPLC 1.2.56+, 1.5.25+.''

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

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

=== Отладка в задаче ПЛК ===
Задача ПЛК (см. раздел [[#Задача ПЛК]]) позволяет проводить тестирование проектов с помощью режима симулятора (на компьютере, без использования контроллера) или онлайн отладки (на контроллере).

==== Управление отладкой ====
Управление режимом симуляции и онлайн отладкой осуществляется с помощью панели инструментов задачи ПЛК (см. рисунок 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]]

Универсальная среда разработки Agava

2026-03-27T05:34:40Z

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|мини|Графическое представление формы с установленными якорями]]
Якоря позволяют контролировать положение групп виджетов благодаря связанным с ними линиям привязки. Линии привязки, позволяют быстрее выстраивать группы виджетов благодяря "прилипанию".

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

* Двойным кликом левой кнопки мыши по размерной линейке.
* Кликом правой кнопки мыши на размерной линейке и выбором команды "Добавить якорь".

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

* Двойным кликом левой кнопки мыши по якорю на размерной линейке.
* Кликом правой кнопки мыши на размерной линейке и выбором команды "Удалить якорь".

Созданные якоря можно перемещать по размерной линейке с помощью мыши.

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

== Проверка и отладка проекта ==

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

Для этого необходимо:

# Установить текущий проект как проект по умолчанию. Для этого необходимо вызвать команду "Проект->Установить проект по умолчанию..." и выбрать ранее сохраненный файл конфигурации.
# Запустить среду исполнения. Для этого нужно вызвать команду меню "Проект->Запуск среды исполнения". После этого будет выполнен запуск в новом окне среды исполнения.

=== Мониторинг сигналов ===
[[Файл:AgavaPLC–Окно "Наблюдение".png|мини|Рисунок 14 – Окно "Наблюдение"|ссылка=Файл:AgavaPLC–Окно_%22Наблюдение%22.png]]
Функция мониторинга сигналов позволяет наблюдать значения, хранящиеся в узлах проекта при исполнении проекта на целевом устройстве.

Для запуска данной функции необходимо:

# Запустить среду исполнения.
# Вызвать команду меню «<code>Устройство → Подключение/отключение</code>», в появившемся окне выбрать IP-адрес и порт устройства, значения узлов которого необходимо мониторить. При необходимости просмотра значений узлов и сигналов в режиме эмуляции проекта на персональном компьютере укажите адрес 127.0.0.1. Если необходимо просматривать значения узлов проекта, выполняющегося на контроллере или панели оператора, укажите IP-адрес контроллера или панели.
# Нажать кнопку «Подключение».

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

Для добавления узлов в окно "Наблюдение" необходимо нажать на нужном узле в дереве проекта правой кнопкой мыши и выбрать команду «<code>Добавить в окно наблюдения</code>». Выбранные узлы будут отображаться в окне «Наблюдение» вместе со считанными значениями.

=== Мониторинг событий ===
[[Файл:AgavaPLC–Окно просмотра событий.png|мини|Рисунок 15 – Окно просмотра событий]]Мониторинг событий позволяет наблюдать за исполнением проекта, работающего в устройстве. При включении мониторинга пользователь получает информацию о возникающих нефатальных ошибках и предупреждениях, возникающих в ходе исполнения проекта со следующими признаками:

* метка времени, соответствующая времени возникновения события;
* степень важности события;
* тип события - информационное или события активирования, деактивирования и квитирования тревог;
* имя узла, сформировавшего событие.
* текст события.

==== Использование мониторинга ====
Для старта мониторинга необходимо подключиться к нужному устройству способом, рассмотренным в разделе [[#Мониторинг сигналов]], а затем вызвать команду «<code>Устройство → Просмотр событий</code>». В открывшемся окне будут выводиться все события, регистрируемые устройством.

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

==== Фильтрация событий ====
''Функция доступна начиная с версии AgavaSCADA/AgavaPLC 1.2.56+, 1.5.25+.''

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

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

=== Отладка в задаче ПЛК ===
Задача ПЛК (см. раздел [[#Задача ПЛК]]) позволяет проводить тестирование проектов с помощью режима симулятора (на компьютере, без использования контроллера) или онлайн отладки (на контроллере).

==== Управление отладкой ====
Управление режимом симуляции и онлайн отладкой осуществляется с помощью панели инструментов задачи ПЛК (см. рисунок 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]]

Файл:AgavaPLC-Графическое представление-якоря.png

2026-03-27T05:26:19Z

TaushkanovKV:

AgavaPLC-Графическое представление-якоря

Класс any

2026-03-26T06:03:30Z

TaushkanovKV: /* Примеры использования */

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

При работе с объектами выполняется их "глубокое" копирование.

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

=== Методы класса ===

==== Конструкторы ====

# '''<code>any@ f()</code>'''
#* Создает пустой объект <code>any</code>
#* Не хранит никакого значения
# '''<code>any@ f(?&in) explicit</code>'''
#* Создает объект <code>any</code> с копией переданного значения
#* Поддерживает любые типы
#* Помечен как <code>explicit</code> для предотвращения неявных преобразований
# '''<code>any@ f(const int64&in) explicit</code>'''
#* Специализированный конструктор для 64-битных целых чисел
#* Создает объект <code>any</code> с целочисленным значением
# '''<code>any@ f(const double&in) explicit</code>'''
#* Специализированный конструктор для чисел с плавающей точкой
#* Создает объект <code>any</code> со значением double

==== Операторы ====

# '''<code>any &opAssign(any&in)</code>'''
#* Оператор присваивания
#* Копирует содержимое другого объекта <code>any</code>
#* Возвращает ссылку на текущий объект

==== Методы хранения данных ====

# '''<code>void store(?&in)</code>'''
#* Сохраняет значение любого типа в объекте <code>any</code>
#* Для объектов: создает копию
#* Для handle: увеличивает счетчик ссылок
#* Для примитивов: копирует значение
# '''<code>void store(const int64&in)</code>'''
#* Специализированная версия для 64-битных целых чисел
#* Сохраняет целочисленное значение
# '''<code>void store(const double&in)</code>'''
#* Специализированная версия для чисел с плавающей точкой
#* Сохраняет значение double

==== Методы извлечения данных ====

# '''<code>bool retrieve(?&out) const</code>'''
#* Извлекает сохраненное значение в переданную переменную
#* Возвращает <code>true</code> если типы совместимы, иначе <code>false</code>
#* Для handle: проверяет совместимость типов и выполняет приведение
# '''<code>bool retrieve(int64&out) const</code>'''
#* Специализированная версия для 64-битных целых чисел
#* Позволяет извлечь значение как int64
#* Может выполнять преобразование из double
# '''<code>bool retrieve(double&out) const</code>'''
#* Специализированная версия для чисел с плавающей точкой
#* Позволяет извлечь значение как double
#* Может выполнять преобразование из int64

=== Примеры использования ===
void FunctionCpp()
{
// Создание и использование any
any a; // Пустой объект
any@ b = any(42); // Хранит целое число
any c = any(3.14159); // Хранит double

// Сохранение значений
a.store("Hello"); // Сохранить строку
a.store(123); // Сохранить целое число
a.store(45.67); // Сохранить double

// Извлечение значений
int64 intValue;

if (b.retrieve(intValue))
// Успешно извлекли целое число
{

}

double doubleValue;

if (c.retrieve(doubleValue))
// Успешно извлекли double
{

}

// Присваивание
any d = a; // Копирование

// Пример с объектом

MyClass@ obj = MyClass(42);

any@ e = any(obj); // Сохраняем объект
MyClass@ retrieved;

if (e.retrieve(@retrieved))
{

}
}

class MyClass
{
int value;
MyClass() {};
MyClass(int v) { value = v; }
}

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

Класс any

2026-03-26T06:02:49Z

TaushkanovKV:

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

При работе с объектами выполняется их "глубокое" копирование.

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

=== Методы класса ===

==== Конструкторы ====

# '''<code>any@ f()</code>'''
#* Создает пустой объект <code>any</code>
#* Не хранит никакого значения
# '''<code>any@ f(?&in) explicit</code>'''
#* Создает объект <code>any</code> с копией переданного значения
#* Поддерживает любые типы
#* Помечен как <code>explicit</code> для предотвращения неявных преобразований
# '''<code>any@ f(const int64&in) explicit</code>'''
#* Специализированный конструктор для 64-битных целых чисел
#* Создает объект <code>any</code> с целочисленным значением
# '''<code>any@ f(const double&in) explicit</code>'''
#* Специализированный конструктор для чисел с плавающей точкой
#* Создает объект <code>any</code> со значением double

==== Операторы ====

# '''<code>any &opAssign(any&in)</code>'''
#* Оператор присваивания
#* Копирует содержимое другого объекта <code>any</code>
#* Возвращает ссылку на текущий объект

==== Методы хранения данных ====

# '''<code>void store(?&in)</code>'''
#* Сохраняет значение любого типа в объекте <code>any</code>
#* Для объектов: создает копию
#* Для handle: увеличивает счетчик ссылок
#* Для примитивов: копирует значение
# '''<code>void store(const int64&in)</code>'''
#* Специализированная версия для 64-битных целых чисел
#* Сохраняет целочисленное значение
# '''<code>void store(const double&in)</code>'''
#* Специализированная версия для чисел с плавающей точкой
#* Сохраняет значение double

==== Методы извлечения данных ====

# '''<code>bool retrieve(?&out) const</code>'''
#* Извлекает сохраненное значение в переданную переменную
#* Возвращает <code>true</code> если типы совместимы, иначе <code>false</code>
#* Для handle: проверяет совместимость типов и выполняет приведение
# '''<code>bool retrieve(int64&out) const</code>'''
#* Специализированная версия для 64-битных целых чисел
#* Позволяет извлечь значение как int64
#* Может выполнять преобразование из double
# '''<code>bool retrieve(double&out) const</code>'''
#* Специализированная версия для чисел с плавающей точкой
#* Позволяет извлечь значение как double
#* Может выполнять преобразование из int64

=== Примеры использования ===
void FunctionCpp()
{
// Создание и использование any
any a; // Пустой объект
any b = any(42); // Хранит целое число
any c = any(3.14159); // Хранит double

// Сохранение значений
a.store("Hello"); // Сохранить строку
a.store(123); // Сохранить целое число
a.store(45.67); // Сохранить double

// Извлечение значений
int64 intValue;

if (b.retrieve(intValue))
// Успешно извлекли целое число
{

}

double doubleValue;

if (c.retrieve(doubleValue))
// Успешно извлекли double
{

}

// Присваивание
any d = a; // Копирование

// Пример с объектом

MyClass@ obj = MyClass(42);

any@ e = any(obj); // Сохраняем объект
MyClass@ retrieved;

if (e.retrieve(@retrieved))
{

}
}

class MyClass
{
int value;
MyClass() {};
MyClass(int v) { value = v; }
}

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

Класс any

2026-03-26T05:28:33Z

TaushkanovKV: /* Примеры использования */

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

При работе с объектами выполняется их "глубокое" копирование.

=== Методы класса ===

==== Конструкторы ====

# '''<code>any@ f()</code>'''
#* Создает пустой объект <code>any</code>
#* Не хранит никакого значения
# '''<code>any@ f(?&in) explicit</code>'''
#* Создает объект <code>any</code> с копией переданного значения
#* Поддерживает любые типы
#* Помечен как <code>explicit</code> для предотвращения неявных преобразований
# '''<code>any@ f(const int64&in) explicit</code>'''
#* Специализированный конструктор для 64-битных целых чисел
#* Создает объект <code>any</code> с целочисленным значением
# '''<code>any@ f(const double&in) explicit</code>'''
#* Специализированный конструктор для чисел с плавающей точкой
#* Создает объект <code>any</code> со значением double

==== Операторы ====

# '''<code>any &opAssign(any&in)</code>'''
#* Оператор присваивания
#* Копирует содержимое другого объекта <code>any</code>
#* Возвращает ссылку на текущий объект

==== Методы хранения данных ====

# '''<code>void store(?&in)</code>'''
#* Сохраняет значение любого типа в объекте <code>any</code>
#* Для объектов: создает копию
#* Для handle: увеличивает счетчик ссылок
#* Для примитивов: копирует значение
# '''<code>void store(const int64&in)</code>'''
#* Специализированная версия для 64-битных целых чисел
#* Сохраняет целочисленное значение
# '''<code>void store(const double&in)</code>'''
#* Специализированная версия для чисел с плавающей точкой
#* Сохраняет значение double

==== Методы извлечения данных ====

# '''<code>bool retrieve(?&out) const</code>'''
#* Извлекает сохраненное значение в переданную переменную
#* Возвращает <code>true</code> если типы совместимы, иначе <code>false</code>
#* Для handle: проверяет совместимость типов и выполняет приведение
# '''<code>bool retrieve(int64&out) const</code>'''
#* Специализированная версия для 64-битных целых чисел
#* Позволяет извлечь значение как int64
#* Может выполнять преобразование из double
# '''<code>bool retrieve(double&out) const</code>'''
#* Специализированная версия для чисел с плавающей точкой
#* Позволяет извлечь значение как double
#* Может выполнять преобразование из int64

=== Примеры использования ===
void FunctionCpp()
{
// Создание и использование any
any a; // Пустой объект
any b = any(42); // Хранит целое число
any c = any(3.14159); // Хранит double

// Сохранение значений
a.store("Hello"); // Сохранить строку
a.store(123); // Сохранить целое число
a.store(45.67); // Сохранить double

// Извлечение значений
int64 intValue;

if (b.retrieve(intValue))
// Успешно извлекли целое число
{

}

double doubleValue;

if (c.retrieve(doubleValue))
// Успешно извлекли double
{

}

// Присваивание
any d = a; // Копирование

// Пример с объектом

MyClass@ obj = MyClass(42);

any@ e = any(obj); // Сохраняем объект
MyClass@ retrieved;

if (e.retrieve(@retrieved))
{

}
}

class MyClass
{
int value;
MyClass() {};
MyClass(int v) { value = v; }
}

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

Класс any

2026-03-26T05:25:09Z

TaushkanovKV:

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

При работе с объектами выполняется их "глубокое" копирование.

=== Методы класса ===

==== Конструкторы ====

# '''<code>any@ f()</code>'''
#* Создает пустой объект <code>any</code>
#* Не хранит никакого значения
# '''<code>any@ f(?&in) explicit</code>'''
#* Создает объект <code>any</code> с копией переданного значения
#* Поддерживает любые типы
#* Помечен как <code>explicit</code> для предотвращения неявных преобразований
# '''<code>any@ f(const int64&in) explicit</code>'''
#* Специализированный конструктор для 64-битных целых чисел
#* Создает объект <code>any</code> с целочисленным значением
# '''<code>any@ f(const double&in) explicit</code>'''
#* Специализированный конструктор для чисел с плавающей точкой
#* Создает объект <code>any</code> со значением double

==== Операторы ====

# '''<code>any &opAssign(any&in)</code>'''
#* Оператор присваивания
#* Копирует содержимое другого объекта <code>any</code>
#* Возвращает ссылку на текущий объект

==== Методы хранения данных ====

# '''<code>void store(?&in)</code>'''
#* Сохраняет значение любого типа в объекте <code>any</code>
#* Для объектов: создает копию
#* Для handle: увеличивает счетчик ссылок
#* Для примитивов: копирует значение
# '''<code>void store(const int64&in)</code>'''
#* Специализированная версия для 64-битных целых чисел
#* Сохраняет целочисленное значение
# '''<code>void store(const double&in)</code>'''
#* Специализированная версия для чисел с плавающей точкой
#* Сохраняет значение double

==== Методы извлечения данных ====

# '''<code>bool retrieve(?&out) const</code>'''
#* Извлекает сохраненное значение в переданную переменную
#* Возвращает <code>true</code> если типы совместимы, иначе <code>false</code>
#* Для handle: проверяет совместимость типов и выполняет приведение
# '''<code>bool retrieve(int64&out) const</code>'''
#* Специализированная версия для 64-битных целых чисел
#* Позволяет извлечь значение как int64
#* Может выполнять преобразование из double
# '''<code>bool retrieve(double&out) const</code>'''
#* Специализированная версия для чисел с плавающей точкой
#* Позволяет извлечь значение как double
#* Может выполнять преобразование из int64

=== Примеры использования ===
void FunctionCpp()
{
// Создание и использование any
any a; // Пустой объект
any@ b = any(42); // Хранит целое число
any@ c = any(3.14159); // Хранит double

// Сохранение значений
a.store("Hello"); // Сохранить строку
a.store(123); // Сохранить целое число
a.store(45.67); // Сохранить double

// Извлечение значений
int64 intValue;

if (b.retrieve(intValue))
// Успешно извлекли целое число
{

}

double doubleValue;

if (c.retrieve(doubleValue))
// Успешно извлекли double
{

}

// Присваивание
any d = a; // Копирование

// Пример с объектом

MyClass@ obj = MyClass(42);

any@ e = any(obj); // Сохраняем объект
MyClass@ retrieved;

if (e.retrieve(@retrieved))
{

}
}

class MyClass
{
int value;
MyClass() {};
MyClass(int v) { value = v; }
}

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

Класс any

2026-03-26T05:24:17Z

TaushkanovKV:

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

=== Методы класса ===

==== Конструкторы ====

# '''<code>any@ f()</code>'''
#* Создает пустой объект <code>any</code>
#* Не хранит никакого значения
# '''<code>any@ f(?&in) explicit</code>'''
#* Создает объект <code>any</code> с копией переданного значения
#* Поддерживает любые типы
#* Помечен как <code>explicit</code> для предотвращения неявных преобразований
# '''<code>any@ f(const int64&in) explicit</code>'''
#* Специализированный конструктор для 64-битных целых чисел
#* Создает объект <code>any</code> с целочисленным значением
# '''<code>any@ f(const double&in) explicit</code>'''
#* Специализированный конструктор для чисел с плавающей точкой
#* Создает объект <code>any</code> со значением double

==== Операторы ====

# '''<code>any &opAssign(any&in)</code>'''
#* Оператор присваивания
#* Копирует содержимое другого объекта <code>any</code>
#* Возвращает ссылку на текущий объект

==== Методы хранения данных ====

# '''<code>void store(?&in)</code>'''
#* Сохраняет значение любого типа в объекте <code>any</code>
#* Для объектов: создает копию
#* Для handle: увеличивает счетчик ссылок
#* Для примитивов: копирует значение
# '''<code>void store(const int64&in)</code>'''
#* Специализированная версия для 64-битных целых чисел
#* Сохраняет целочисленное значение
# '''<code>void store(const double&in)</code>'''
#* Специализированная версия для чисел с плавающей точкой
#* Сохраняет значение double

==== Методы извлечения данных ====

# '''<code>bool retrieve(?&out) const</code>'''
#* Извлекает сохраненное значение в переданную переменную
#* Возвращает <code>true</code> если типы совместимы, иначе <code>false</code>
#* Для handle: проверяет совместимость типов и выполняет приведение
# '''<code>bool retrieve(int64&out) const</code>'''
#* Специализированная версия для 64-битных целых чисел
#* Позволяет извлечь значение как int64
#* Может выполнять преобразование из double
# '''<code>bool retrieve(double&out) const</code>'''
#* Специализированная версия для чисел с плавающей точкой
#* Позволяет извлечь значение как double
#* Может выполнять преобразование из int64

=== Примеры использования ===
void FunctionCpp()
{
// Создание и использование any
any a; // Пустой объект
any@ b = any(42); // Хранит целое число
any@ c = any(3.14159); // Хранит double

// Сохранение значений
a.store("Hello"); // Сохранить строку
a.store(123); // Сохранить целое число
a.store(45.67); // Сохранить double

// Извлечение значений
int64 intValue;

if (b.retrieve(intValue))
// Успешно извлекли целое число
{

}

double doubleValue;

if (c.retrieve(doubleValue))
// Успешно извлекли double
{

}

// Присваивание
any d = a; // Копирование

// Пример с объектом

MyClass@ obj = MyClass(42);

any@ e = any(obj); // Сохраняем объект
MyClass@ retrieved;

if (e.retrieve(@retrieved))
{

}
}

class MyClass
{
int value;
MyClass() {};
MyClass(int v) { value = v; }
}

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

Класс any

2026-03-26T05:04:18Z

TaushkanovKV:

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

=== Методы класса ===

==== Конструкторы ====

# '''<code>any@ f()</code>'''
#* Создает пустой объект <code>any</code>
#* Не хранит никакого значения
# '''<code>any@ f(?&in) explicit</code>'''
#* Создает объект <code>any</code> с копией переданного значения
#* Поддерживает любые типы
#* Помечен как <code>explicit</code> для предотвращения неявных преобразований
# '''<code>any@ f(const int64&in) explicit</code>'''
#* Специализированный конструктор для 64-битных целых чисел
#* Создает объект <code>any</code> с целочисленным значением
# '''<code>any@ f(const double&in) explicit</code>'''
#* Специализированный конструктор для чисел с плавающей точкой
#* Создает объект <code>any</code> со значением double

==== Операторы ====

# '''<code>any &opAssign(any&in)</code>'''
#* Оператор присваивания
#* Копирует содержимое другого объекта <code>any</code>
#* Возвращает ссылку на текущий объект

==== Методы хранения данных ====

# '''<code>void store(?&in)</code>'''
#* Сохраняет значение любого типа в объекте <code>any</code>
#* Для объектов: создает копию
#* Для handle: увеличивает счетчик ссылок
#* Для примитивов: копирует значение
# '''<code>void store(const int64&in)</code>'''
#* Специализированная версия для 64-битных целых чисел
#* Сохраняет целочисленное значение
# '''<code>void store(const double&in)</code>'''
#* Специализированная версия для чисел с плавающей точкой
#* Сохраняет значение double

==== Методы извлечения данных ====

# '''<code>bool retrieve(?&out) const</code>'''
#* Извлекает сохраненное значение в переданную переменную
#* Возвращает <code>true</code> если типы совместимы, иначе <code>false</code>
#* Для handle: проверяет совместимость типов и выполняет приведение
# '''<code>bool retrieve(int64&out) const</code>'''
#* Специализированная версия для 64-битных целых чисел
#* Позволяет извлечь значение как int64
#* Может выполнять преобразование из double
# '''<code>bool retrieve(double&out) const</code>'''
#* Специализированная версия для чисел с плавающей точкой
#* Позволяет извлечь значение как double
#* Может выполнять преобразование из int64

=== Примеры использования ===
// Создание и использование any
any a; // Пустой объект
any b = 42; // Хранит целое число
any c = 3.14159; // Хранит double

// Сохранение значений
a.store("Hello"); // Сохранить строку
a.store(123); // Сохранить целое число
a.store(45.67); // Сохранить double

// Извлечение значений
int64 intValue;
if (b.retrieve(intValue))
// Успешно извлекли целое число

double doubleValue;
if (c.retrieve(doubleValue))
// Успешно извлекли double

// Присваивание
any d = a; // Копирование

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

Класс any

2026-03-26T05:03:15Z

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

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

=== Методы класса ===

==== Конструкторы ====

# '''<code>any@ f()</code>'''
#* Создает пустой объект <code>any</code>
#* Не хранит никакого значения
# '''<code>any@ f(?&in) explicit</code>'''
#* Создает объект <code>any</code> с копией переданного значения
#* Поддерживает любые типы
#* Помечен как <code>explicit</code> для предотвращения неявных преобразований
# '''<code>any@ f(const int64&in) explicit</code>'''
#* Специализированный конструктор для 64-битных целых чисел
#* Создает объект <code>any</code> с целочисленным значением
# '''<code>any@ f(const double&in) explicit</code>'''
#* Специализированный конструктор для чисел с плавающей точкой
#* Создает объект <code>any</code> со значением double

==== Операторы ====

# '''<code>any &opAssign(any&in)</code>'''
#* Оператор присваивания
#* Копирует содержимое другого объекта <code>any</code>
#* Возвращает ссылку на текущий объект

==== Методы хранения данных ====

# '''<code>void store(?&in)</code>'''
#* Сохраняет значение любого типа в объекте <code>any</code>
#* Для объектов: создает копию
#* Для handle: увеличивает счетчик ссылок
#* Для примитивов: копирует значение
# '''<code>void store(const int64&in)</code>'''
#* Специализированная версия для 64-битных целых чисел
#* Сохраняет целочисленное значение
# '''<code>void store(const double&in)</code>'''
#* Специализированная версия для чисел с плавающей точкой
#* Сохраняет значение double

==== Методы извлечения данных ====

# '''<code>bool retrieve(?&out) const</code>'''
#* Извлекает сохраненное значение в переданную переменную
#* Возвращает <code>true</code> если типы совместимы, иначе <code>false</code>
#* Для handle: проверяет совместимость типов и выполняет приведение
# '''<code>bool retrieve(int64&out) const</code>'''
#* Специализированная версия для 64-битных целых чисел
#* Позволяет извлечь значение как int64
#* Может выполнять преобразование из double
# '''<code>bool retrieve(double&out) const</code>'''
#* Специализированная версия для чисел с плавающей точкой
#* Позволяет извлечь значение как double
#* Может выполнять преобразование из int64

=== Примеры использования ===
// Создание и использование any
any a; // Пустой объект
any b = 42; // Хранит целое число
any c = 3.14159; // Хранит double

// Сохранение значений
a.store("Hello"); // Сохранить строку
a.store(123); // Сохранить целое число
a.store(45.67); // Сохранить double

// Извлечение значений
int64 intValue;
if (b.retrieve(intValue))
// Успешно извлекли целое число

double doubleValue;
if (c.retrieve(doubleValue))
// Успешно извлекли double

// Присваивание
any d = a; // Копирование

Базовые классы AgavaSCADA/AgavaPLC

2026-03-23T05:04:40Z

TaushkanovKV: /* Обработчики */

Руководство по эксплуатации АГАВА СК-01

2026-03-12T09:01:27Z

TaushkanovKV: /* Интерфейс WAN */

[[Файл:АГАВАСК01 Внешний вид1.png|мини|Шлюз АГАВА СК-01]]

== Введение ==
Данное руководство по эксплуатации содержит сведения, необходимые для обеспечения правильной эксплуатации и полного использования технических возможностей сетевого шлюза АГАВА СК-01, далее по тексту: прибор, СК-01 или шлюз.

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

== Назначение ==

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

Подключение к внешним устройствам осуществляется через Ethernet, Wi-Fi, RS-485 (MODBUS-RTU);

=== Используемые термины и сокращения ===
ПК – персональный компьютер;

ОС – операционная система;

ПО – программное обеспечение;

ОЗУ – оперативное запоминающее устройство;

ФС – файловая система.

=== Условное обозначение прибора ===
Пример полного условного обозначения прибора:

* СК-01.1 – базовое исполнение;
* СК-01.2 – исполнение без GSM модема.

== Оснащение прибора ==

=== Состав прибора ===

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

На корпусе прибора установлены разъёмы для подключения внешних антенн.

На варианте исполнения СК-01.1 установлено 2 разъема для подключения антенн Wi-Fi и GSM (LTE) модема, СК-01.2 установлен 1 разъем для подключения антенны Wi-Fi.

В месте с прибором в зависимости от варианта исполнения поставляются одна (две) антенна(ы) с коэффициентом усиления 2dB.

В прибор СК-01.1 для работы GSM (LTE) модема устанавливается стандартная SIM-карта.

=== Конструкция Прибора ===
Габаритные размеры и позиционные обозначения компонентов Прибора приведены на рисунке ниже.
[[Файл:Views 1.png|без|мини|550x550пкс|Рисунок 1 - Габаритные размеры и позиционные обозначения СК-01]]Обозначение компонентов приведено в таблице ниже:
{| class="wikitable"
!Позиционное
обозначение
!Расшифровка
|-
|1
|GSM антенна
|-
|2
|Wi-Fi антенна
|-
|3
|Кнопка сброса настроек
|-
|4
|Место установки SIM карты
|-
|5
|Разъем подключения LAN
|-
|6
|Клемник подключения питания и RS-485
|-
|7
|Разъем подключения WAN
|-
|8
|Светодиодные индикаторы
|-
|9
|Переключатель для подключения встроенного терминального резистора RS-485
|-
|10
|Фиксатор прибора на DIN-рейке
|}

=== Технические характеристики ===
{| class="wikitable" style="width:75%"
|+

!№ п/п
! colspan="3" |Общие сведения
|-
|1
|Конструктивное исполнение
| colspan="2" |Моноблок на DIN-рейку
|-
|2
|Габаритные размеры (ВхШхГ), мм:
| colspan="2" |88 × 35 × 62

188 × 35 × 62 – с установленной антенной
|-
|3
|Масса прибора, не более, кг
| colspan="2" |0.120
|-
|4
|Степень защиты корпуса
| colspan="2" |IP20
|-
|5
|Напряжение питания
| colspan="2" |24 В ±10 % постоянного тока
|-
|6
|Потребляемая мощность, не более
| colspan="2" |12 Вт
|-
! colspan="4" |Интерфейсы подключения к AgavaCloud
|-
!style="width:3%" |
!style="width:13%" |
!style="width:20%" | АГАВА СК-01.1
!style="width:20%" | АГАВА СК-01.2
|-
|7
|Ethernet
| colspan="2" |WAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|8
|Wi-Fi
| colspan="2" |Режим "Клиент", стандарты 802.11 b/g/n, антенна внешняя.
Макс. чувствительность приемника 76 дБ, макс. мощность передатчика 21.1 дБ.

Тип разъема для антенны – SMA-F
|-
|9
|GSM
|1шт., GSM(LTE) - LTE CAT1 модуль, с поддержкой LTE-TDD/LTE-FDD.
Максимальная скорость загрузки 10Mbps, скорость передачи - 5Mbps.

Тип разъема для антенны – SMA-F

Стандартная mini-SIM карта с поддержкой всех операторов беспроводной связи
|Отсутствует
|-
! colspan="4" |Интерфейсы подключения устройств
|-
|10
|Ethernet
| colspan="2" |LAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|11
|RS-485
| colspan="2" |1шт. с гальванической развязкой, скорость до 115200 Mбит/с включительно
|-
! colspan="4" |Индикация и управление
|-
| rowspan="6" |12
| rowspan="6" |Индикация
| colspan="2" |Индикатор наличия питания - <code>POW</code>
|-
| colspan="2" |Индикатор состояния GSM модема - <code>GSM</code>
|-
| colspan="2" |Индикатор состояния WIFI - <code>WiFi</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейса RS-485 - <code>RX</code> <code>TX</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейсов Ethernet (на разъемах интерфейсов)
|-
| colspan="2" |Индикатор режима работы - <code>USR</code>
|-
|13
|Органы управления
| colspan="2" |Кнопка сброса, возврата к заводским установкам
|-
|14
|Переключатель
| colspan="2" |Включение и отключение терминального резистора
|}

== Условия эксплуатации ==
{| class="wikitable"
! colspan="2" |Условия эксплуатации
|-
|Тип помещения
|Закрытые взрывобезопасные помещения без агрессивных паров и газов
|-
|Температура окружающего воздуха
|От 0 до +50°С
|-
|Влажность воздуха
|Верхний предел относительной влажности воздуха 80% при +35°С и более низких температурах без конденсации влаги
|-
|Атмосферное давление
|От 86 до 107 кПа
|}

== Маркировка ==
На боковой панели прибора расположена наклейка с информацией о приборе:

* обозначение исполнения Прибора;
* заводской номер Прибора;
* уникальный идентификационный номер Прибора (УИН).

== Устройство и принцип работы прибора ==

=== Подготовка прибора к использованию ===

==== Общие указания ====
В зимнее время тару с прибором распаковывать в отапливаемом помещении не ранее чем через 4 часа после внесения их в помещение. Монтаж, эксплуатация и демонтаж СК-01 должны производиться персоналом, ознакомленным с правилами его эксплуатации и прошедшим инструктаж для работы с электрооборудованием в соответствии с правилами, установленными на предприятии-потребителе.

==== Указания мер безопасности ====
По способу защиты от поражения электрическим током CK-01 соответствует классу 0 по ГОСТ 12.2.007.0-75.

При эксплуатации и техническом обслуживании необходимо соблюдать требования ГОСТ 12.3.019-80, «Правил эксплуатации электроустановок потребителей» и «Правил охраны труда при эксплуатации электроустановок потребителей».

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

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

Установка и извлечение SIM-карты в сетевой шлюз АГАВА СК-01.1должна выполняться только при отключенном питании прибора.

==== Монтаж и подключение прибора ====
Прибор устанавливается на DIN-рейку 35мм. при помощи специального фиксатора (Рисунок 1, Позиция 10), расположенного в верхней части прибора.

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

Установку SIM-карты (Рисунок 1, Позиция 4) в сетевой шлюз АГАВА СК-01.1 производить до установки Прибора на DIN-рейку.

Установку антенн производить после установки прибора на DIN-рейку.

Подключаемые к прибору провода должны быть многожильными сечением от 0,25 до 0,5 мм2. Рекомендуемые типы кабелей МКШ, МКЭШ, МКШМ ГОСТ 10348-80.

Рекомендуется обжимать концы подключаемых проводов наконечниками типа НШВИ.

==== Подключение линий связи ====
Ниже приведены схемы подключения внешних устройств (блоков питания, линии RS-485 и Ethernet) к прибору.

===== Схема подключения питания =====
[[Файл:Power.png|мини|550x550px|Рисунок 2 - Схема подключения питания|альт=|без]]

===== Схема подключения линии RS-485 (без дренажного провода) =====
[[Файл:RS-485 NO DRAIN.png|без|мини|550x550px|Рисунок -3 Схема подключения линии RS-485 (без дренажного провода)|альт=]]

===== Схема подключения линии RS-485 (c дренажным проводом) =====
[[Файл:RS-485 with drain.png|без|мини|550x550px|Рисунок 4 - Схема подключения линии RS-485 (c дренажным проводом)|альт=]]Примечание''':''' для подключения встроенных терминальных резисторов RS-485 (120 Ом) необходимо перевести переключатель SW-1 (Рисунок 1, Позиция 9) в положение “ON” .

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

Для уменьшения влияния электромагнитных помех необходимо выполнять приведенные ниже рекомендации:

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

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

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

=== Интерфейсы прибора и их назначение ===
Прибор оснащен большим количеством интерфейсов передачи данных, имеющих разное назначение.

Интерфейсы связи с системой AgavaCloud:

# 3G-GSM.
# WAN.
# WIFI (клиент).

Интерфейсы для сбора данных с подключаемых устройств:

# LAN.
# RS-485.

Интерфейсы для настройки Прибора:

# LAN
# WIFI (точка доступа).

=== Состав программного обеспечения прибора ===
Программное обеспечение прибора состоит из следующих частей:

* Системное программное обеспечение.
* Прикладное программное обеспечение, обеспечивающее взаимодействие с AgavaCloud.

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

== Порядок работы с прибором ==
=== Первое включение и загрузка ===
[[Файл:АГАВАСК01-Циклограмма работы.png.png|мини|600x600пкс|Рисунок 5 - Циклограмма мигания индикатора USR]]
Подключите прибор к источнику питания +24В соблюдая полярность.

После подачи питания должен загореться индикатор питания “POW” и начаться инициализация. В процессе инициализации будет мигать светодиоды “Wi-Fi”, "USR", "GSM".

Светодиод "USR" индицирует текущий режим/этап работы Прибора с помощью мигания. Характер мигания светодиода в разных режимах показан на рис. 5.

Светодиод "GSM" отображает статус сети. Режимы мигания показаны на рис. 6.

[[Файл:АГАВАСК01-циклограмма-LED-индикатора-GSM.png|мини|599x599px|Рисунок 6 - Циклограмма мигания индикатора GSM|альт=]]

=== Режимы и этапы работы Прибора ===
После включения Прибор последовательно проходит через описываемые ниже режимы и этапы. Характер мигания светодиода в разных режимах показан на рис. 5.

# Режим <code>Подготовка</code>. Начинается после подачи питания.
## Этап <code>Инициализация</code>. Длительность этапа - примерно 10 с.
## Этап <code>Загрузка</code>. Длительность этапа - примерно 60-70 с.
## Этап <code>Окончание загрузки</code>. Длительность этапа - примерно 1-5 с.
# Режим <code>Работа</code>. Примерно через 70 секунд после включения прибор начинает обмен информацией с AgavaCloud, состоящий из следующих этапов:
## Этап <code>Подключение</code> к AgavaCloud. На этом этапе производится установление соединения с AgavaCloud. Длительность режима - примерно 1 с при настроенном подключении Прибора к сети Internet. При отсутствии подключения Прибор находится в данном режиме до установления подключения к AgavaCloud. Светодиод USR кратковременно зажигается (на 100 мс), далее гаснет на 900 мс, после чего цикл повторяется.
## Этап <code>Регистрация</code> в AgavaCloud. На этом этапе подключение к AgavaCloud установлено, прибор авторизуется в системе. После успешной регистрации прибор переходит к следующему этапу. На данном этапе светодиод USR делает два импульса по 100 мс с промежутком в 100 мс, далее гаснет на 700 мс, после чего цикл повторяется. Длительность режима - примерно 1 с. При наличии проблем с регистрацией Прибор находится в данном режиме до установления подключения к AgavaCloud
## Этап <code>Получение задания</code>. Длительность режима при наличии задания (то есть в каком-либо проекте задействован Прибор и для него определена конфигурация) - примерно 1 с, при отсутствии задания прибор находится в этом режиме до тех пор, пока не получит задание. На данном этапе светодиод USR делает три импульса по 100 мс с промежутком в 100 мс, далее гаснет на 500 мс, после чего цикл повторяется.
## Этап <code>Передача данных</code>. Основной этап, в котором находится прибор в нормальном состоянии (настроено подключение и прибор присутствует в каком-либо проекте в AgavaCloud). Светодиод USR попеременно зажигается и гаснет на 1 с.

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

Для настройки Прибора необходимо подключиться к нему одним из следующих способов:

* Кабельное подключение через Ethernet.
* Подключение к встроенной точке доступа WIFI.

==== Настройка Прибора через кабельное подключение через Ethernet ====

* Соедините кабелем Ethernet компьютер и порт LAN Прибора напрямую или через коммутатор.
* Убедитесь, что на компьютере в настройках сетевого адаптера имеется IP-адрес из сети <code>192.168.1.х</code>, например <code>192.168.1.88</code>, маска <code>255.255.255.0</code>.
* Откройте интернет-обозреватель и в адресной строке введите адрес: <code>192.168.1.1</code>. После загрузки прибора браузер автоматически откроет страницу системной утилиты.
* Введите логин и пароль, далее произведите настройку Прибора.

==== Настройка Прибора через Wi-Fi ====
Прибор оснащен модулем WIFI, по умолчанию настроенным на работу в режиме точки доступа, в котором возможно подключение к Прибору для его настройки.

Порядок подключения:
* Откройте на компьютере настройку беспроводных сетей и выполните поиск доступных Wi-Fi сетей, либо на смартфоне включите модуль WIFI и откройте окно выбора сети. В списке сетей должна появиться сеть c именем <code>AGAVA-SK01</code>.
* Подключите компьютер к сети <code>AGAVA-SK01</code>. Сеть <code>AGAVA-SK01</code> является открытой и не требует пароля и шифрования.
* После удачного подключения к <code>AGAVA-SK01</code> откройте интернет-обозреватель и в адресной строке введите адрес устройства: <code>192.168.2.1</code>. Браузер откроет страницу системной утилиты.

* Введите логин и пароль, далее произведите настройку Прибора.

=== Подключение Прибора к сети Internet ===
Для использования Прибора необходимо подключить его к сети Internet одним из следующих способов:

# Кабельное подключение через локальную сеть или напрямую к поставщику услуг сети Internet.
# WIFI подключение к существующей точке доступа.
# Беспроводное 3G/LTE соединение с Internet с помощью встроенного 3G/LTE модема.
{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Установку SIM-карты в Прибор необходимо производить при отключенном электропитании.}}{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Для передачи данных через беспроводное 3G/LTE соединение требуется приобретение у поставщика услуг связи тарифа на передачу данных, совместимого с роутерами}}

=== Настройка подключения Прибора к сети Internet ===
Настройка подключения Прибора к сети осуществляется с помощью встроенной системной утилиты, доступной через интерфейсы прибора LAN или WIFI (в режиме "Точка доступа").

=== Системная утилита ===
Системная утилита - встроенное в Прибор программное обеспечение, предназначенное для конфигурирования прибора и просмотра его параметров. Взаимодействие с системной утилитой осуществляется через браузер (обозреватель).

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

Настройте подключение к Прибору, как описано в разделе [[Руководство по эксплуатации АГАВА СК-01#Настройка Прибора|Настройка Прибора]].

Для авторизации используйте следующие реквизиты:

* имя пользователя — <code>web</code>
* пароль — <code>inc23.crffdswe</code>

После ввода реквизитов нажмите кнопку "Войти".
[[Файл:АГАВАСК01-Авторизация.png|мини|Авторизация при входе в системную утилиту|640x640px|альт=|центр]]

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

[[Файл:АГАВАСК01-Начальная-страница-обновленная.png|альт=|мини|640x640px|Главная страница системной утилиты|центр]]

На странице отображены, сверху вниз:

* полоса заголовка с названием Прибора, выпадающим списком перехода на другие страницы системной утилиты и ссылка "Выйти" для завершения работы с системной утилитой;
* интерфейсы Прибора, их состояние и кнопки управления интерфейсами;
* Кнопки "Применить" и "Сохранить" для сохранения внесенных изменений;
* "подвал" страницы с указанием названия системной утилиты и версии прошивки Прибора.
{{Внимание|Тип=Восклицание синий.png|Текст=Рекомендуется установить новый пароль для входа в системную утилиту. Для этого кликните по вкладке меню «Основные настройки», затем выберете пункт «Пароль сетевого шлюза», далее задайте новый пароль и подтвердите его. Для сохранения изменений нажмите кнопку «Сохранить».}}

==== Настройка сетевых интерфейсов ====

===== Интерфейс 3G-GSM =====

Если в Прибор установлена SIM карта, то после включения и загрузки устройства, на странице «Интерфейсы» в интерфейсе 3g-GSM будет отображен полученный IP-адрес предоставленный оператором связи, а также статистика обмена пакетами (RX) и (TX).[[Файл:АГАВАСК01-3G-Интерфейс.png|мини|640x640px|3g-GSM интерфейс, IP-адрес, статистика обмена пакетами|альт=|центр]]

{{Внимание|Тип=Восклицание синий.png|Текст=Настройку интерфейса 3g-GSM в большинстве случаев производить не требуется, так как она выполняется автоматически согласно параметрам, получаемым от поставщика услуг мобильной связи.}}

При необходимости настройки параметров интерфейса 3g-GSM нажмите кнопку «Изменить».

В открывшемся окне на вкладке «Основные настройки» в полях <code>APN</code>, <code>Имя пользователя</code>, <code>Пароль</code> введите нужные значения параметров.

Для примера ниже приведены настройки для доступа к сети интернет через оператора связи МТС:

* APN: internet.mts.ru.
* Имя пользователя: mts
* Пароль: mts.

[[Файл:АГАВАСК01-Настройка-GSM.png|мини|Настройка параметров интерфейса GSM|640x640px|альт=|центр]]

После внесения изменений нажмите кнопку «Сохранить», при этом автоматически будет выполнен переход на главную страницу. На главной странице отображается плашка "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ", сигнализирующая о внесенных в настройки прибора изменениях, но не принятых в работу.

[[Файл:АГАВАСК01-Главная страница-Изменения.png|альт=|центр|мини|639x639пкс|Начальная страница системной утилиты - внесены изменения в настройки, ожидается их применение]]
Для '''принятия внесенных изменений''' необходимо выполнить одно из двух действий:

* нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Применить";
* нажать на кнопку "Применить" в низу главной страницы, при этом подтверждение не запрашивается и изменения сразу применяются.

Для '''отмены внесенных изменений''' необходимо нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Вернуть".

===== Интерфейс LAN =====

Интерфейс LAN предназначен для сбора данных с подключаемых устройств и настройки самого Прибора.
[[Файл:АГАВАСК01-Интерфейс LAN.png|альт=|центр|мини|640x640пкс|Иинтерфейс LAN: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «LAN» нажмите кнопку «Изменить».

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

* выбор протокола (по умолчанию установлено в «Статический адрес»)
* задание IP адреса, маски сети и адреса шлюза.

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

[[Файл:АГАВАСК01-Настройка-интерфейса-lan.png|мини|640x640px|Настройка интерфейса lan|альт=|центр]]Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WAN =====
Интерфейс WAN предназначен для подключения к системе AgavaCloud.

[[Файл:АГАВАСК01-Интерфейс WAN.png|альт=|центр|мини|640x640пкс|Интерфейс WAN: IP-адрес, статистика обмена пакетами]]

В случае подключения шлюза к AgavaCloud через кабельное Internet/ЛВС подключение, если в сети присутствует DHCP сервер, то настройка интерфейса WAN не требуется. В этом случае интерфейс будет настроен автоматически согласно параметрам, получаемым от DHCP сервера. Иначе необходимо вручную настроить WAN интерфейс.

Для настройки интерфейса «WAN» нажмите кнопку «Изменить».

В открывшемся окне отображен статус устройства, имеется возможность выбора режима (по умолчанию установлен режим «DHCP-клиент») и настройки параметров.

[[Файл:АГАВАСК01-Настройка-интерфейса-Wan.png|мини|640x640px|Настройка интерфейса WAN. По умолчанию включен режим DHCP клиент.|альт=|центр]]

Для настройки статического IP-адреса в поле «Режим» из выпадающего списка выберите пункт «Статический адрес», подтвердите выбор нажатием вновь появившейся кнопки «Изменить режим». Далее в полях «IPv4-адрес», «маска сети IPv4», «IPv4-адрес шлюза» внесите необходимые настройки и нажмите кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WAN-Настройка2.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WAN. Настройка режима "Статический адрес".]]

Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WIFI (клиент) =====

Интерфейс WIFI в режиме "Клиент" предназначен для подключения к системе AgavaCloud.
[[Файл:АГАВАСК01-Интерфейс WIFI.png|альт=|центр|мини|640x640пкс|Иинтерфейс WIFI: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «WIFI» нажмите кнопку «Изменить».

В открывшемся окне отображен статус интерфейса, имеются следующие возможности:

* выбор SSID (точки доступа) из списка обнаруженных;
* выбор режима и алгоритма шифрования;
* ввод ключа (пароля) для подключения к точке доступа.

После внесения изменений, необходимо нажать кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WIFI-Настройка.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WIFI (клиент)]]
Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].{{Внимание|Тип=Восклицание синий.png|Текст=При применении настроек WIFI будет выполнен перезапуск сетевых интерфейсов Прибора. Если настройка WIFI Прибора осуществляется со смартфона, то соединение смартфона и точки доступа Прибора будет разорвано и необходимо будет повторно подключиться к точке доступа AGAVA-SK01. При настройке WIFI через LAN таких разрывов нет.}}

==== Дополнительная настройка беспроводных подключений ====
Страница "Беспроводная сеть" системной утилиты позволяет выполнить дополнительные настройки беспроводной сети Прибора:

* Включать или отключать беспроводные интерфейсы WIFI (клиент) и WIFI (точка доступа).
* Изменять настройки собственной точки доступа, например пароль или SSID. Последнее актуально при использовании нескольких приборов с покрытием WIFI одной области.
* Просматривать список клиентов, подключенных к точке доступа и отключать их.

Для перехода к странице "Беспроводная сеть" выберите пункт «Беспроводная сеть» в меню «Основные настройки».

[[Файл:АГАВАСК01-Настройка-беспроводной-сети.png|мини|Страница "Беспроводная сеть"|640x640px|альт=|центр]]

===== Настройка собственной точки доступа (WIFI в режиме "точка доступа") =====
Для настройки собственной точки доступа необходимо на странице "Беспроводная сеть" в разделе «Список беспроводных сетей» нажать кнопку «Изменить» напротив беспроводной сети <code>AGAVA-SK01 | Режим: Master</code>.

В открывшемся окне можно изменить множество настроек точки. Наиболее востребованные параметры - SSID (имя точки), пароль.
После внесения изменений нужно нажать кнопку «Сохранить» в правом нижнем углу окна.
[[Файл:АГАВАСК01-Настройка-беспроводной-сети-в-режим-работы-точка-доступа.png|мини|686x686px|Настройка WIFI в режиме "Точка доступа"|альт=|центр]]Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

=== Использование Прибора с AgavaCloud ===

==== Регистрация Прибора в AgavaCloud ====
После настройки подключения Прибора к сети Internet необходимо зарегистрировать Прибор в своем проекте AgavaCloud. Регистрация выполняется следующим образом:

# Войдите в свой проект AgavaCloud.
# Откройте раздел <code>Устройства</code> вашего проекта.
# Добавьте устройство типа <code>Шлюз АГАВА СК-01</code> и введите в поле <code>Идентификатор</code> 16-значный УИН, указанный на шильдике, находящемся на корпусе Прибора.

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

==== Добавление подчиненных устройств ====
Прибор поддерживает опрос подчиненных устройств следующих типов:

* Устройства с протоколом Modbus-TCP.
* Устройства с протоколом Modbus-RTU.

===== Добавление устройств с протоколом Modbus-RTU =====
Для опроса Прибором устройств с протоколом Modbus-RTU необходимо в проекте AgavaCloud добавить в шлюз соответствующее устройство.

При заполнении настроек устройства необходимо указать адрес последовательного порта:<code>/dev/ttyS1</code>. Остальные настройки устанавливаются в соответствии с параметрами опрашиваемого устройства.

Дальнейшие операции по настройке проекта для передачи данных Прибора в AgavaCloud описаны на [https://cloud.kb-agava.ru/doc/ страницах описания AgavaCloud].

== Обновление программного обеспечения АГАВА СК-01 ==
Прибор поставляется со всем необходимым установленным системным и прикладным программным обеспечением.

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

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

== Правила транспортирования и хранения ==
Прибор должен транспортироваться в упаковке при температуре от -30 °С до +80 °С и относительной влажности воздуха не более 95 % (при 35 °С).

Транспортирование допускается всеми видами закрытого транспорта.

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

Условия хранения прибора в транспортной таре на складе потребителя должны соответствовать условиям 1 по ГОСТ 15150-69.

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

== Техническое обслуживание ==
Прибор специального обслуживания не требует.

Периодически не реже чем раз в 6 месяцев проводить:

* осмотр прибора на внешние повреждения;
* соединения зажимных контактов;
* очистку прибора от пыли и грязи;
* качества крепления на DIN-рейке.

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

== Комплектность ==
{| class="wikitable"
|+
|№ п/п
|Наименование
|Количество,
шт.
|-
|1
|Сетевой шлюз АГАВА СК-01
|1
|-
|2
|Антенна Wi-Fi (2dB)
|1
|-
|3
|Антенна GSM (2dB) *
|1
|-
|4
|Паспорт
|1
|}
<nowiki>*</nowiki> Вариант исполнения с GSM модемом СК-01.1

== Гарантийные обязательства ==
Гарантийный срок эксплуатации – 12 месяцев со дня продажи.

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

Для отправки в ремонт необходимо вложить в тару с сетевым шлюзом АГАВА СК-01 паспорт, акт отказа и отправить по адресу:

620144, г. Екатеринбург, ул. Верещагина, д. 6а, ООО КБ «АГАВА»

Тел: (343) 382-01-92.

[[Категория:АГАВА СК-01]]

Руководство по эксплуатации АГАВА СК-01

2026-03-12T07:21:25Z

TaushkanovKV: /* Добавление устройств с протоколом Modbus-RTU */

[[Файл:АГАВАСК01 Внешний вид1.png|мини|Шлюз АГАВА СК-01]]

== Введение ==
Данное руководство по эксплуатации содержит сведения, необходимые для обеспечения правильной эксплуатации и полного использования технических возможностей сетевого шлюза АГАВА СК-01, далее по тексту: прибор, СК-01 или шлюз.

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

== Назначение ==

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

Подключение к внешним устройствам осуществляется через Ethernet, Wi-Fi, RS-485 (MODBUS-RTU);

=== Используемые термины и сокращения ===
ПК – персональный компьютер;

ОС – операционная система;

ПО – программное обеспечение;

ОЗУ – оперативное запоминающее устройство;

ФС – файловая система.

=== Условное обозначение прибора ===
Пример полного условного обозначения прибора:

* СК-01.1 – базовое исполнение;
* СК-01.2 – исполнение без GSM модема.

== Оснащение прибора ==

=== Состав прибора ===

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

На корпусе прибора установлены разъёмы для подключения внешних антенн.

На варианте исполнения СК-01.1 установлено 2 разъема для подключения антенн Wi-Fi и GSM (LTE) модема, СК-01.2 установлен 1 разъем для подключения антенны Wi-Fi.

В месте с прибором в зависимости от варианта исполнения поставляются одна (две) антенна(ы) с коэффициентом усиления 2dB.

В прибор СК-01.1 для работы GSM (LTE) модема устанавливается стандартная SIM-карта.

=== Конструкция Прибора ===
Габаритные размеры и позиционные обозначения компонентов Прибора приведены на рисунке ниже.
[[Файл:Views 1.png|без|мини|550x550пкс|Рисунок 1 - Габаритные размеры и позиционные обозначения СК-01]]Обозначение компонентов приведено в таблице ниже:
{| class="wikitable"
!Позиционное
обозначение
!Расшифровка
|-
|1
|GSM антенна
|-
|2
|Wi-Fi антенна
|-
|3
|Кнопка сброса настроек
|-
|4
|Место установки SIM карты
|-
|5
|Разъем подключения LAN
|-
|6
|Клемник подключения питания и RS-485
|-
|7
|Разъем подключения WAN
|-
|8
|Светодиодные индикаторы
|-
|9
|Переключатель для подключения встроенного терминального резистора RS-485
|-
|10
|Фиксатор прибора на DIN-рейке
|}

=== Технические характеристики ===
{| class="wikitable" style="width:75%"
|+

!№ п/п
! colspan="3" |Общие сведения
|-
|1
|Конструктивное исполнение
| colspan="2" |Моноблок на DIN-рейку
|-
|2
|Габаритные размеры (ВхШхГ), мм:
| colspan="2" |88 × 35 × 62

188 × 35 × 62 – с установленной антенной
|-
|3
|Масса прибора, не более, кг
| colspan="2" |0.120
|-
|4
|Степень защиты корпуса
| colspan="2" |IP20
|-
|5
|Напряжение питания
| colspan="2" |24 В ±10 % постоянного тока
|-
|6
|Потребляемая мощность, не более
| colspan="2" |12 Вт
|-
! colspan="4" |Интерфейсы подключения к AgavaCloud
|-
!style="width:3%" |
!style="width:13%" |
!style="width:20%" | АГАВА СК-01.1
!style="width:20%" | АГАВА СК-01.2
|-
|7
|Ethernet
| colspan="2" |WAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|8
|Wi-Fi
| colspan="2" |Режим "Клиент", стандарты 802.11 b/g/n, антенна внешняя.
Макс. чувствительность приемника 76 дБ, макс. мощность передатчика 21.1 дБ.

Тип разъема для антенны – SMA-F
|-
|9
|GSM
|1шт., GSM(LTE) - LTE CAT1 модуль, с поддержкой LTE-TDD/LTE-FDD.
Максимальная скорость загрузки 10Mbps, скорость передачи - 5Mbps.

Тип разъема для антенны – SMA-F

Стандартная mini-SIM карта с поддержкой всех операторов беспроводной связи
|Отсутствует
|-
! colspan="4" |Интерфейсы подключения устройств
|-
|10
|Ethernet
| colspan="2" |LAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|11
|RS-485
| colspan="2" |1шт. с гальванической развязкой, скорость до 115200 Mбит/с включительно
|-
! colspan="4" |Индикация и управление
|-
| rowspan="6" |12
| rowspan="6" |Индикация
| colspan="2" |Индикатор наличия питания - <code>POW</code>
|-
| colspan="2" |Индикатор состояния GSM модема - <code>GSM</code>
|-
| colspan="2" |Индикатор состояния WIFI - <code>WiFi</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейса RS-485 - <code>RX</code> <code>TX</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейсов Ethernet (на разъемах интерфейсов)
|-
| colspan="2" |Индикатор режима работы - <code>USR</code>
|-
|13
|Органы управления
| colspan="2" |Кнопка сброса, возврата к заводским установкам
|-
|14
|Переключатель
| colspan="2" |Включение и отключение терминального резистора
|}

== Условия эксплуатации ==
{| class="wikitable"
! colspan="2" |Условия эксплуатации
|-
|Тип помещения
|Закрытые взрывобезопасные помещения без агрессивных паров и газов
|-
|Температура окружающего воздуха
|От 0 до +50°С
|-
|Влажность воздуха
|Верхний предел относительной влажности воздуха 80% при +35°С и более низких температурах без конденсации влаги
|-
|Атмосферное давление
|От 86 до 107 кПа
|}

== Маркировка ==
На боковой панели прибора расположена наклейка с информацией о приборе:

* обозначение исполнения Прибора;
* заводской номер Прибора;
* уникальный идентификационный номер Прибора (УИН).

== Устройство и принцип работы прибора ==

=== Подготовка прибора к использованию ===

==== Общие указания ====
В зимнее время тару с прибором распаковывать в отапливаемом помещении не ранее чем через 4 часа после внесения их в помещение. Монтаж, эксплуатация и демонтаж СК-01 должны производиться персоналом, ознакомленным с правилами его эксплуатации и прошедшим инструктаж для работы с электрооборудованием в соответствии с правилами, установленными на предприятии-потребителе.

==== Указания мер безопасности ====
По способу защиты от поражения электрическим током CK-01 соответствует классу 0 по ГОСТ 12.2.007.0-75.

При эксплуатации и техническом обслуживании необходимо соблюдать требования ГОСТ 12.3.019-80, «Правил эксплуатации электроустановок потребителей» и «Правил охраны труда при эксплуатации электроустановок потребителей».

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

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

Установка и извлечение SIM-карты в сетевой шлюз АГАВА СК-01.1должна выполняться только при отключенном питании прибора.

==== Монтаж и подключение прибора ====
Прибор устанавливается на DIN-рейку 35мм. при помощи специального фиксатора (Рисунок 1, Позиция 10), расположенного в верхней части прибора.

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

Установку SIM-карты (Рисунок 1, Позиция 4) в сетевой шлюз АГАВА СК-01.1 производить до установки Прибора на DIN-рейку.

Установку антенн производить после установки прибора на DIN-рейку.

Подключаемые к прибору провода должны быть многожильными сечением от 0,25 до 0,5 мм2. Рекомендуемые типы кабелей МКШ, МКЭШ, МКШМ ГОСТ 10348-80.

Рекомендуется обжимать концы подключаемых проводов наконечниками типа НШВИ.

==== Подключение линий связи ====
Ниже приведены схемы подключения внешних устройств (блоков питания, линии RS-485 и Ethernet) к прибору.

===== Схема подключения питания =====
[[Файл:Power.png|мини|550x550px|Рисунок 2 - Схема подключения питания|альт=|без]]

===== Схема подключения линии RS-485 (без дренажного провода) =====
[[Файл:RS-485 NO DRAIN.png|без|мини|550x550px|Рисунок -3 Схема подключения линии RS-485 (без дренажного провода)|альт=]]

===== Схема подключения линии RS-485 (c дренажным проводом) =====
[[Файл:RS-485 with drain.png|без|мини|550x550px|Рисунок 4 - Схема подключения линии RS-485 (c дренажным проводом)|альт=]]Примечание''':''' для подключения встроенных терминальных резисторов RS-485 (120 Ом) необходимо перевести переключатель SW-1 (Рисунок 1, Позиция 9) в положение “ON” .

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

Для уменьшения влияния электромагнитных помех необходимо выполнять приведенные ниже рекомендации:

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

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

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

=== Интерфейсы прибора и их назначение ===
Прибор оснащен большим количеством интерфейсов передачи данных, имеющих разное назначение.

Интерфейсы связи с системой AgavaCloud:

# 3G-GSM.
# WAN.
# WIFI (клиент).

Интерфейсы для сбора данных с подключаемых устройств:

# LAN.
# RS-485.

Интерфейсы для настройки Прибора:

# LAN
# WIFI (точка доступа).

=== Состав программного обеспечения прибора ===
Программное обеспечение прибора состоит из следующих частей:

* Системное программное обеспечение.
* Прикладное программное обеспечение, обеспечивающее взаимодействие с AgavaCloud.

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

== Порядок работы с прибором ==
=== Первое включение и загрузка ===
[[Файл:АГАВАСК01-Циклограмма работы.png.png|мини|600x600пкс|Рисунок 5 - Циклограмма мигания индикатора USR]]
Подключите прибор к источнику питания +24В соблюдая полярность.

После подачи питания должен загореться индикатор питания “POW” и начаться инициализация. В процессе инициализации будет мигать светодиоды “Wi-Fi”, "USR", "GSM".

Светодиод "USR" индицирует текущий режим/этап работы Прибора с помощью мигания. Характер мигания светодиода в разных режимах показан на рис. 5.

Светодиод "GSM" отображает статус сети. Режимы мигания показаны на рис. 6.

[[Файл:АГАВАСК01-циклограмма-LED-индикатора-GSM.png|мини|599x599px|Рисунок 6 - Циклограмма мигания индикатора GSM|альт=]]

=== Режимы и этапы работы Прибора ===
После включения Прибор последовательно проходит через описываемые ниже режимы и этапы. Характер мигания светодиода в разных режимах показан на рис. 5.

# Режим <code>Подготовка</code>. Начинается после подачи питания.
## Этап <code>Инициализация</code>. Длительность этапа - примерно 10 с.
## Этап <code>Загрузка</code>. Длительность этапа - примерно 60-70 с.
## Этап <code>Окончание загрузки</code>. Длительность этапа - примерно 1-5 с.
# Режим <code>Работа</code>. Примерно через 70 секунд после включения прибор начинает обмен информацией с AgavaCloud, состоящий из следующих этапов:
## Этап <code>Подключение</code> к AgavaCloud. На этом этапе производится установление соединения с AgavaCloud. Длительность режима - примерно 1 с при настроенном подключении Прибора к сети Internet. При отсутствии подключения Прибор находится в данном режиме до установления подключения к AgavaCloud. Светодиод USR кратковременно зажигается (на 100 мс), далее гаснет на 900 мс, после чего цикл повторяется.
## Этап <code>Регистрация</code> в AgavaCloud. На этом этапе подключение к AgavaCloud установлено, прибор авторизуется в системе. После успешной регистрации прибор переходит к следующему этапу. На данном этапе светодиод USR делает два импульса по 100 мс с промежутком в 100 мс, далее гаснет на 700 мс, после чего цикл повторяется. Длительность режима - примерно 1 с. При наличии проблем с регистрацией Прибор находится в данном режиме до установления подключения к AgavaCloud
## Этап <code>Получение задания</code>. Длительность режима при наличии задания (то есть в каком-либо проекте задействован Прибор и для него определена конфигурация) - примерно 1 с, при отсутствии задания прибор находится в этом режиме до тех пор, пока не получит задание. На данном этапе светодиод USR делает три импульса по 100 мс с промежутком в 100 мс, далее гаснет на 500 мс, после чего цикл повторяется.
## Этап <code>Передача данных</code>. Основной этап, в котором находится прибор в нормальном состоянии (настроено подключение и прибор присутствует в каком-либо проекте в AgavaCloud). Светодиод USR попеременно зажигается и гаснет на 1 с.

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

Для настройки Прибора необходимо подключиться к нему одним из следующих способов:

* Кабельное подключение через Ethernet.
* Подключение к встроенной точке доступа WIFI.

==== Настройка Прибора через кабельное подключение через Ethernet ====

* Соедините кабелем Ethernet компьютер и порт LAN Прибора напрямую или через коммутатор.
* Убедитесь, что на компьютере в настройках сетевого адаптера имеется IP-адрес из сети <code>192.168.1.х</code>, например <code>192.168.1.88</code>, маска <code>255.255.255.0</code>.
* Откройте интернет-обозреватель и в адресной строке введите адрес: <code>192.168.1.1</code>. После загрузки прибора браузер автоматически откроет страницу системной утилиты.
* Введите логин и пароль, далее произведите настройку Прибора.

==== Настройка Прибора через Wi-Fi ====
Прибор оснащен модулем WIFI, по умолчанию настроенным на работу в режиме точки доступа, в котором возможно подключение к Прибору для его настройки.

Порядок подключения:
* Откройте на компьютере настройку беспроводных сетей и выполните поиск доступных Wi-Fi сетей, либо на смартфоне включите модуль WIFI и откройте окно выбора сети. В списке сетей должна появиться сеть c именем <code>AGAVA-SK01</code>.
* Подключите компьютер к сети <code>AGAVA-SK01</code>. Сеть <code>AGAVA-SK01</code> является открытой и не требует пароля и шифрования.
* После удачного подключения к <code>AGAVA-SK01</code> откройте интернет-обозреватель и в адресной строке введите адрес устройства: <code>192.168.2.1</code>. Браузер откроет страницу системной утилиты.

* Введите логин и пароль, далее произведите настройку Прибора.

=== Подключение Прибора к сети Internet ===
Для использования Прибора необходимо подключить его к сети Internet одним из следующих способов:

# Кабельное подключение через локальную сеть или напрямую к поставщику услуг сети Internet.
# WIFI подключение к существующей точке доступа.
# Беспроводное 3G/LTE соединение с Internet с помощью встроенного 3G/LTE модема.
{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Установку SIM-карты в Прибор необходимо производить при отключенном электропитании.}}{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Для передачи данных через беспроводное 3G/LTE соединение требуется приобретение у поставщика услуг связи тарифа на передачу данных, совместимого с роутерами}}

=== Настройка подключения Прибора к сети Internet ===
Настройка подключения Прибора к сети осуществляется с помощью встроенной системной утилиты, доступной через интерфейсы прибора LAN или WIFI (в режиме "Точка доступа").

=== Системная утилита ===
Системная утилита - встроенное в Прибор программное обеспечение, предназначенное для конфигурирования прибора и просмотра его параметров. Взаимодействие с системной утилитой осуществляется через браузер (обозреватель).

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

Настройте подключение к Прибору, как описано в разделе [[Руководство по эксплуатации АГАВА СК-01#Настройка Прибора|Настройка Прибора]].

Для авторизации используйте следующие реквизиты:

* имя пользователя — <code>web</code>
* пароль — <code>inc23.crffdswe</code>

После ввода реквизитов нажмите кнопку "Войти".
[[Файл:АГАВАСК01-Авторизация.png|мини|Авторизация при входе в системную утилиту|640x640px|альт=|центр]]

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

[[Файл:АГАВАСК01-Начальная-страница-обновленная.png|альт=|мини|640x640px|Главная страница системной утилиты|центр]]

На странице отображены, сверху вниз:

* полоса заголовка с названием Прибора, выпадающим списком перехода на другие страницы системной утилиты и ссылка "Выйти" для завершения работы с системной утилитой;
* интерфейсы Прибора, их состояние и кнопки управления интерфейсами;
* Кнопки "Применить" и "Сохранить" для сохранения внесенных изменений;
* "подвал" страницы с указанием названия системной утилиты и версии прошивки Прибора.
{{Внимание|Тип=Восклицание синий.png|Текст=Рекомендуется установить новый пароль для входа в системную утилиту. Для этого кликните по вкладке меню «Основные настройки», затем выберете пункт «Пароль сетевого шлюза», далее задайте новый пароль и подтвердите его. Для сохранения изменений нажмите кнопку «Сохранить».}}

==== Настройка сетевых интерфейсов ====

===== Интерфейс 3G-GSM =====

Если в Прибор установлена SIM карта, то после включения и загрузки устройства, на странице «Интерфейсы» в интерфейсе 3g-GSM будет отображен полученный IP-адрес предоставленный оператором связи, а также статистика обмена пакетами (RX) и (TX).[[Файл:АГАВАСК01-3G-Интерфейс.png|мини|640x640px|3g-GSM интерфейс, IP-адрес, статистика обмена пакетами|альт=|центр]]

{{Внимание|Тип=Восклицание синий.png|Текст=Настройку интерфейса 3g-GSM в большинстве случаев производить не требуется, так как она выполняется автоматически при запуске Прибора.}}

При необходимости настройки параметров интерфейса 3g-GSM нажмите кнопку «Изменить».

В открывшемся окне на вкладке «Основные настройки» в полях <code>APN</code>, <code>Имя пользователя</code>, <code>Пароль</code> введите нужные значения параметров.

Для примера ниже приведены настройки для доступа к сети интернет через оператора связи МТС:

* APN: internet.mts.ru.
* Имя пользователя: mts
* Пароль: mts.

[[Файл:АГАВАСК01-Настройка-GSM.png|мини|Настройка параметров интерфейса GSM|640x640px|альт=|центр]]

После внесения изменений нажмите кнопку «Сохранить», при этом автоматически будет выполнен переход на главную страницу. На главной странице отображается плашка "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ", сигнализирующая о внесенных в настройки прибора изменениях, но не принятых в работу.

[[Файл:АГАВАСК01-Главная страница-Изменения.png|альт=|центр|мини|639x639пкс|Начальная страница системной утилиты - внесены изменения в настройки, ожидается их применение]]
Для '''принятия внесенных изменений''' необходимо выполнить одно из двух действий:

* нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Применить";
* нажать на кнопку "Применить" в низу главной страницы, при этом подтверждение не запрашивается и изменения сразу применяются.

Для '''отмены внесенных изменений''' необходимо нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Вернуть".

===== Интерфейс LAN =====

Интерфейс LAN предназначен для сбора данных с подключаемых устройств и настройки самого Прибора.
[[Файл:АГАВАСК01-Интерфейс LAN.png|альт=|центр|мини|640x640пкс|Иинтерфейс LAN: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «LAN» нажмите кнопку «Изменить».

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

* выбор протокола (по умолчанию установлено в «Статический адрес»)
* задание IP адреса, маски сети и адреса шлюза.

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

[[Файл:АГАВАСК01-Настройка-интерфейса-lan.png|мини|640x640px|Настройка интерфейса lan|альт=|центр]]Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WAN =====
Интерфейс WAN предназначен для подключения к системе AgavaCloud.

[[Файл:АГАВАСК01-Интерфейс WAN.png|альт=|центр|мини|640x640пкс|Интерфейс WAN: IP-адрес, статистика обмена пакетами]]

Для настройки интерфейса «WAN» нажмите кнопку «Изменить».

В открывшемся окне отображен статус устройства, имеется возможность выбора режима (по умолчанию установлен режим «DHCP-клиент») и настройки параметров.

[[Файл:АГАВАСК01-Настройка-интерфейса-Wan.png|мини|640x640px|Настройка интерфейса WAN. По умолчанию включен режим DHCP клиент.|альт=|центр]]

Для настройки статического IP-адреса в поле «Режим» из выпадающего списка выберите пункт «Статический адрес», подтвердите выбор нажатием вновь появившейся кнопки «Изменить режим». Далее в полях «IPv4-адрес», «маска сети IPv4», «IPv4-адрес шлюза» внесите необходимые настройки и нажмите кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WAN-Настройка2.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WAN. Настройка режима "Статический адрес".]]

Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WIFI (клиент) =====

Интерфейс WIFI в режиме "Клиент" предназначен для подключения к системе AgavaCloud.
[[Файл:АГАВАСК01-Интерфейс WIFI.png|альт=|центр|мини|640x640пкс|Иинтерфейс WIFI: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «WIFI» нажмите кнопку «Изменить».

В открывшемся окне отображен статус интерфейса, имеются следующие возможности:

* выбор SSID (точки доступа) из списка обнаруженных;
* выбор режима и алгоритма шифрования;
* ввод ключа (пароля) для подключения к точке доступа.

После внесения изменений, необходимо нажать кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WIFI-Настройка.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WIFI (клиент)]]
Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].{{Внимание|Тип=Восклицание синий.png|Текст=При применении настроек WIFI будет выполнен перезапуск сетевых интерфейсов Прибора. Если настройка WIFI Прибора осуществляется со смартфона, то соединение смартфона и точки доступа Прибора будет разорвано и необходимо будет повторно подключиться к точке доступа AGAVA-SK01. При настройке WIFI через LAN таких разрывов нет.}}

==== Дополнительная настройка беспроводных подключений ====
Страница "Беспроводная сеть" системной утилиты позволяет выполнить дополнительные настройки беспроводной сети Прибора:

* Включать или отключать беспроводные интерфейсы WIFI (клиент) и WIFI (точка доступа).
* Изменять настройки собственной точки доступа, например пароль или SSID. Последнее актуально при использовании нескольких приборов с покрытием WIFI одной области.
* Просматривать список клиентов, подключенных к точке доступа и отключать их.

Для перехода к странице "Беспроводная сеть" выберите пункт «Беспроводная сеть» в меню «Основные настройки».

[[Файл:АГАВАСК01-Настройка-беспроводной-сети.png|мини|Страница "Беспроводная сеть"|640x640px|альт=|центр]]

===== Настройка собственной точки доступа (WIFI в режиме "точка доступа") =====
Для настройки собственной точки доступа необходимо на странице "Беспроводная сеть" в разделе «Список беспроводных сетей» нажать кнопку «Изменить» напротив беспроводной сети <code>AGAVA-SK01 | Режим: Master</code>.

В открывшемся окне можно изменить множество настроек точки. Наиболее востребованные параметры - SSID (имя точки), пароль.
После внесения изменений нужно нажать кнопку «Сохранить» в правом нижнем углу окна.
[[Файл:АГАВАСК01-Настройка-беспроводной-сети-в-режим-работы-точка-доступа.png|мини|686x686px|Настройка WIFI в режиме "Точка доступа"|альт=|центр]]Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

=== Использование Прибора с AgavaCloud ===

==== Регистрация Прибора в AgavaCloud ====
После настройки подключения Прибора к сети Internet необходимо зарегистрировать Прибор в своем проекте AgavaCloud. Регистрация выполняется следующим образом:

# Войдите в свой проект AgavaCloud.
# Откройте раздел <code>Устройства</code> вашего проекта.
# Добавьте устройство типа <code>Шлюз АГАВА СК-01</code> и введите в поле <code>Идентификатор</code> 16-значный УИН, указанный на шильдике, находящемся на корпусе Прибора.

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

==== Добавление подчиненных устройств ====
Прибор поддерживает опрос подчиненных устройств следующих типов:

* Устройства с протоколом Modbus-TCP.
* Устройства с протоколом Modbus-RTU.

===== Добавление устройств с протоколом Modbus-RTU =====
Для опроса Прибором устройств с протоколом Modbus-RTU необходимо в проекте AgavaCloud добавить в шлюз соответствующее устройство.

При заполнении настроек устройства необходимо указать адрес последовательного порта:<code>/dev/ttyS1</code>. Остальные настройки устанавливаются в соответствии с параметрами опрашиваемого устройства.

Дальнейшие операции по настройке проекта для передачи данных Прибора в AgavaCloud описаны на [https://cloud.kb-agava.ru/doc/ страницах описания AgavaCloud].

== Обновление программного обеспечения АГАВА СК-01 ==
Прибор поставляется со всем необходимым установленным системным и прикладным программным обеспечением.

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

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

== Правила транспортирования и хранения ==
Прибор должен транспортироваться в упаковке при температуре от -30 °С до +80 °С и относительной влажности воздуха не более 95 % (при 35 °С).

Транспортирование допускается всеми видами закрытого транспорта.

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

Условия хранения прибора в транспортной таре на складе потребителя должны соответствовать условиям 1 по ГОСТ 15150-69.

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

== Техническое обслуживание ==
Прибор специального обслуживания не требует.

Периодически не реже чем раз в 6 месяцев проводить:

* осмотр прибора на внешние повреждения;
* соединения зажимных контактов;
* очистку прибора от пыли и грязи;
* качества крепления на DIN-рейке.

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

== Комплектность ==
{| class="wikitable"
|+
|№ п/п
|Наименование
|Количество,
шт.
|-
|1
|Сетевой шлюз АГАВА СК-01
|1
|-
|2
|Антенна Wi-Fi (2dB)
|1
|-
|3
|Антенна GSM (2dB) *
|1
|-
|4
|Паспорт
|1
|}
<nowiki>*</nowiki> Вариант исполнения с GSM модемом СК-01.1

== Гарантийные обязательства ==
Гарантийный срок эксплуатации – 12 месяцев со дня продажи.

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

Для отправки в ремонт необходимо вложить в тару с сетевым шлюзом АГАВА СК-01 паспорт, акт отказа и отправить по адресу:

620144, г. Екатеринбург, ул. Верещагина, д. 6а, ООО КБ «АГАВА»

Тел: (343) 382-01-92.

[[Категория:АГАВА СК-01]]

Файл:АГАВАСК01 Внешний вид1.png

2026-03-12T03:46:11Z

TaushkanovKV: TaushkanovKV загрузил новую версию Файл:АГАВАСК01 Внешний вид1.png

АГАВА СК-01 Внешний вид

Cетевой шлюз АГАВА СК-01

2026-03-11T10:36:27Z

TaushkanovKV:

[[Файл:АГАВАСК01 Внешний вид1.png|мини|Шлюз АГАВА СК-01]]
Cетевой шлюз АГАВА СК-01 предназначен для передачи данных в систему облачной Internet-диспетчеризации от различных средств автоматизации, модулей ввода-вывода и других контроллеров и вычислителей из списка поддерживаемых.

== Документация ==

* [[Руководство по эксплуатации АГАВА СК-01]]

[[Категория:АГАВА СК-01]]

Руководство по эксплуатации АГАВА СК-01

2026-03-11T10:36:02Z

TaushkanovKV:

[[Файл:АГАВАСК01 Внешний вид1.png|мини|Шлюз АГАВА СК-01]]

== Введение ==
Данное руководство по эксплуатации содержит сведения, необходимые для обеспечения правильной эксплуатации и полного использования технических возможностей сетевого шлюза АГАВА СК-01, далее по тексту: прибор, СК-01 или шлюз.

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

== Назначение ==

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

Подключение к внешним устройствам осуществляется через Ethernet, Wi-Fi, RS-485 (MODBUS-RTU);

=== Используемые термины и сокращения ===
ПК – персональный компьютер;

ОС – операционная система;

ПО – программное обеспечение;

ОЗУ – оперативное запоминающее устройство;

ФС – файловая система.

=== Условное обозначение прибора ===
Пример полного условного обозначения прибора:

* СК-01.1 – базовое исполнение;
* СК-01.2 – исполнение без GSM модема.

== Оснащение прибора ==

=== Состав прибора ===

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

На корпусе прибора установлены разъёмы для подключения внешних антенн.

На варианте исполнения СК-01.1 установлено 2 разъема для подключения антенн Wi-Fi и GSM (LTE) модема, СК-01.2 установлен 1 разъем для подключения антенны Wi-Fi.

В месте с прибором в зависимости от варианта исполнения поставляются одна (две) антенна(ы) с коэффициентом усиления 2dB.

В прибор СК-01.1 для работы GSM (LTE) модема устанавливается стандартная SIM-карта.

=== Конструкция Прибора ===
Габаритные размеры и позиционные обозначения компонентов Прибора приведены на рисунке ниже.
[[Файл:Views 1.png|без|мини|550x550пкс|Рисунок 1 - Габаритные размеры и позиционные обозначения СК-01]]Обозначение компонентов приведено в таблице ниже:
{| class="wikitable"
!Позиционное
обозначение
!Расшифровка
|-
|1
|GSM антенна
|-
|2
|Wi-Fi антенна
|-
|3
|Кнопка сброса настроек
|-
|4
|Место установки SIM карты
|-
|5
|Разъем подключения LAN
|-
|6
|Клемник подключения питания и RS-485
|-
|7
|Разъем подключения WAN
|-
|8
|Светодиодные индикаторы
|-
|9
|Переключатель для подключения встроенного терминального резистора RS-485
|-
|10
|Фиксатор прибора на DIN-рейке
|}

=== Технические характеристики ===
{| class="wikitable" style="width:75%"
|+

!№ п/п
! colspan="3" |Общие сведения
|-
|1
|Конструктивное исполнение
| colspan="2" |Моноблок на DIN-рейку
|-
|2
|Габаритные размеры (ВхШхГ), мм:
| colspan="2" |88 × 35 × 62

188 × 35 × 62 – с установленной антенной
|-
|3
|Масса прибора, не более, кг
| colspan="2" |0.120
|-
|4
|Степень защиты корпуса
| colspan="2" |IP20
|-
|5
|Напряжение питания
| colspan="2" |24 В ±10 % постоянного тока
|-
|6
|Потребляемая мощность, не более
| colspan="2" |12 Вт
|-
! colspan="4" |Интерфейсы подключения к AgavaCloud
|-
!style="width:3%" |
!style="width:13%" |
!style="width:20%" | АГАВА СК-01.1
!style="width:20%" | АГАВА СК-01.2
|-
|7
|Ethernet
| colspan="2" |WAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|8
|Wi-Fi
| colspan="2" |Режим "Клиент", стандарты 802.11 b/g/n, антенна внешняя.
Макс. чувствительность приемника 76 дБ, макс. мощность передатчика 21.1 дБ.

Тип разъема для антенны – SMA-F
|-
|9
|GSM
|1шт., GSM(LTE) - LTE CAT1 модуль, с поддержкой LTE-TDD/LTE-FDD.
Максимальная скорость загрузки 10Mbps, скорость передачи - 5Mbps.

Тип разъема для антенны – SMA-F

Стандартная mini-SIM карта с поддержкой всех операторов беспроводной связи
|Отсутствует
|-
! colspan="4" |Интерфейсы подключения устройств
|-
|10
|Ethernet
| colspan="2" |LAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|11
|RS-485
| colspan="2" |1шт. с гальванической развязкой, скорость до 115200 Mбит/с включительно
|-
! colspan="4" |Индикация и управление
|-
| rowspan="6" |12
| rowspan="6" |Индикация
| colspan="2" |Индикатор наличия питания - <code>POW</code>
|-
| colspan="2" |Индикатор состояния GSM модема - <code>GSM</code>
|-
| colspan="2" |Индикатор состояния WIFI - <code>WiFi</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейса RS-485 - <code>RX</code> <code>TX</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейсов Ethernet (на разъемах интерфейсов)
|-
| colspan="2" |Индикатор режима работы - <code>USR</code>
|-
|13
|Органы управления
| colspan="2" |Кнопка сброса, возврата к заводским установкам
|-
|14
|Переключатель
| colspan="2" |Включение и отключение терминального резистора
|}

== Условия эксплуатации ==
{| class="wikitable"
! colspan="2" |Условия эксплуатации
|-
|Тип помещения
|Закрытые взрывобезопасные помещения без агрессивных паров и газов
|-
|Температура окружающего воздуха
|От 0 до +50°С
|-
|Влажность воздуха
|Верхний предел относительной влажности воздуха 80% при +35°С и более низких температурах без конденсации влаги
|-
|Атмосферное давление
|От 86 до 107 кПа
|}

== Маркировка ==
На боковой панели прибора расположена наклейка с информацией о приборе:

* обозначение исполнения Прибора;
* заводской номер Прибора;
* уникальный идентификационный номер Прибора (УИН).

== Устройство и принцип работы прибора ==

=== Подготовка прибора к использованию ===

==== Общие указания ====
В зимнее время тару с прибором распаковывать в отапливаемом помещении не ранее чем через 4 часа после внесения их в помещение. Монтаж, эксплуатация и демонтаж СК-01 должны производиться персоналом, ознакомленным с правилами его эксплуатации и прошедшим инструктаж для работы с электрооборудованием в соответствии с правилами, установленными на предприятии-потребителе.

==== Указания мер безопасности ====
По способу защиты от поражения электрическим током CK-01 соответствует классу 0 по ГОСТ 12.2.007.0-75.

При эксплуатации и техническом обслуживании необходимо соблюдать требования ГОСТ 12.3.019-80, «Правил эксплуатации электроустановок потребителей» и «Правил охраны труда при эксплуатации электроустановок потребителей».

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

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

Установка и извлечение SIM-карты в сетевой шлюз АГАВА СК-01.1должна выполняться только при отключенном питании прибора.

==== Монтаж и подключение прибора ====
Прибор устанавливается на DIN-рейку 35мм. при помощи специального фиксатора (Рисунок 1, Позиция 10), расположенного в верхней части прибора.

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

Установку SIM-карты (Рисунок 1, Позиция 4) в сетевой шлюз АГАВА СК-01.1 производить до установки Прибора на DIN-рейку.

Установку антенн производить после установки прибора на DIN-рейку.

Подключаемые к прибору провода должны быть многожильными сечением от 0,25 до 0,5 мм2. Рекомендуемые типы кабелей МКШ, МКЭШ, МКШМ ГОСТ 10348-80.

Рекомендуется обжимать концы подключаемых проводов наконечниками типа НШВИ.

==== Подключение линий связи ====
Ниже приведены схемы подключения внешних устройств (блоков питания, линии RS-485 и Ethernet) к прибору.

===== Схема подключения питания =====
[[Файл:Power.png|мини|550x550px|Рисунок 2 - Схема подключения питания|альт=|без]]

===== Схема подключения линии RS-485 (без дренажного провода) =====
[[Файл:RS-485 NO DRAIN.png|без|мини|550x550px|Рисунок -3 Схема подключения линии RS-485 (без дренажного провода)|альт=]]

===== Схема подключения линии RS-485 (c дренажным проводом) =====
[[Файл:RS-485 with drain.png|без|мини|550x550px|Рисунок 4 - Схема подключения линии RS-485 (c дренажным проводом)|альт=]]Примечание''':''' для подключения встроенных терминальных резисторов RS-485 (120 Ом) необходимо перевести переключатель SW-1 (Рисунок 1, Позиция 9) в положение “ON” .

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

Для уменьшения влияния электромагнитных помех необходимо выполнять приведенные ниже рекомендации:

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

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

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

=== Интерфейсы прибора и их назначение ===
Прибор оснащен большим количеством интерфейсов передачи данных, имеющих разное назначение.

Интерфейсы связи с системой AgavaCloud:

# 3G-GSM.
# WAN.
# WIFI (клиент).

Интерфейсы для сбора данных с подключаемых устройств:

# LAN.
# RS-485.

Интерфейсы для настройки Прибора:

# LAN
# WIFI (точка доступа).

=== Состав программного обеспечения прибора ===
Программное обеспечение прибора состоит из следующих частей:

* Системное программное обеспечение.
* Прикладное программное обеспечение, обеспечивающее взаимодействие с AgavaCloud.

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

== Порядок работы с прибором ==
=== Первое включение и загрузка ===
[[Файл:АГАВАСК01-Циклограмма работы.png.png|мини|600x600пкс|Рисунок 5 - Циклограмма мигания индикатора USR]]
Подключите прибор к источнику питания +24В соблюдая полярность.

После подачи питания должен загореться индикатор питания “POW” и начаться инициализация. В процессе инициализации будет мигать светодиоды “Wi-Fi”, "USR", "GSM".

Светодиод "USR" индицирует текущий режим/этап работы Прибора с помощью мигания. Характер мигания светодиода в разных режимах показан на рис. 5.

Светодиод "GSM" отображает статус сети. Режимы мигания показаны на рис. 6.

[[Файл:АГАВАСК01-циклограмма-LED-индикатора-GSM.png|мини|599x599px|Рисунок 6 - Циклограмма мигания индикатора GSM|альт=]]

=== Режимы и этапы работы Прибора ===
После включения Прибор последовательно проходит через описываемые ниже режимы и этапы. Характер мигания светодиода в разных режимах показан на рис. 5.

# Режим <code>Подготовка</code>. Начинается после подачи питания.
## Этап <code>Инициализация</code>. Длительность этапа - примерно 10 с.
## Этап <code>Загрузка</code>. Длительность этапа - примерно 60-70 с.
## Этап <code>Окончание загрузки</code>. Длительность этапа - примерно 1-5 с.
# Режим <code>Работа</code>. Примерно через 70 секунд после включения прибор начинает обмен информацией с AgavaCloud, состоящий из следующих этапов:
## Этап <code>Подключение</code> к AgavaCloud. На этом этапе производится установление соединения с AgavaCloud. Длительность режима - примерно 1 с при настроенном подключении Прибора к сети Internet. При отсутствии подключения Прибор находится в данном режиме до установления подключения к AgavaCloud. Светодиод USR кратковременно зажигается (на 100 мс), далее гаснет на 900 мс, после чего цикл повторяется.
## Этап <code>Регистрация</code> в AgavaCloud. На этом этапе подключение к AgavaCloud установлено, прибор авторизуется в системе. После успешной регистрации прибор переходит к следующему этапу. На данном этапе светодиод USR делает два импульса по 100 мс с промежутком в 100 мс, далее гаснет на 700 мс, после чего цикл повторяется. Длительность режима - примерно 1 с. При наличии проблем с регистрацией Прибор находится в данном режиме до установления подключения к AgavaCloud
## Этап <code>Получение задания</code>. Длительность режима при наличии задания (то есть в каком-либо проекте задействован Прибор и для него определена конфигурация) - примерно 1 с, при отсутствии задания прибор находится в этом режиме до тех пор, пока не получит задание. На данном этапе светодиод USR делает три импульса по 100 мс с промежутком в 100 мс, далее гаснет на 500 мс, после чего цикл повторяется.
## Этап <code>Передача данных</code>. Основной этап, в котором находится прибор в нормальном состоянии (настроено подключение и прибор присутствует в каком-либо проекте в AgavaCloud). Светодиод USR попеременно зажигается и гаснет на 1 с.

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

Для настройки Прибора необходимо подключиться к нему одним из следующих способов:

* Кабельное подключение через Ethernet.
* Подключение к встроенной точке доступа WIFI.

==== Настройка Прибора через кабельное подключение через Ethernet ====

* Соедините кабелем Ethernet компьютер и порт LAN Прибора напрямую или через коммутатор.
* Убедитесь, что на компьютере в настройках сетевого адаптера имеется IP-адрес из сети <code>192.168.1.х</code>, например <code>192.168.1.88</code>, маска <code>255.255.255.0</code>.
* Откройте интернет-обозреватель и в адресной строке введите адрес: <code>192.168.1.1</code>. После загрузки прибора браузер автоматически откроет страницу системной утилиты.
* Введите логин и пароль, далее произведите настройку Прибора.

==== Настройка Прибора через Wi-Fi ====
Прибор оснащен модулем WIFI, по умолчанию настроенным на работу в режиме точки доступа, в котором возможно подключение к Прибору для его настройки.

Порядок подключения:
* Откройте на компьютере настройку беспроводных сетей и выполните поиск доступных Wi-Fi сетей, либо на смартфоне включите модуль WIFI и откройте окно выбора сети. В списке сетей должна появиться сеть c именем <code>AGAVA-SK01</code>.
* Подключите компьютер к сети <code>AGAVA-SK01</code>. Сеть <code>AGAVA-SK01</code> является открытой и не требует пароля и шифрования.
* После удачного подключения к <code>AGAVA-SK01</code> откройте интернет-обозреватель и в адресной строке введите адрес устройства: <code>192.168.2.1</code>. Браузер откроет страницу системной утилиты.

* Введите логин и пароль, далее произведите настройку Прибора.

=== Подключение Прибора к сети Internet ===
Для использования Прибора необходимо подключить его к сети Internet одним из следующих способов:

# Кабельное подключение через локальную сеть или напрямую к поставщику услуг сети Internet.
# WIFI подключение к существующей точке доступа.
# Беспроводное 3G/LTE соединение с Internet с помощью встроенного 3G/LTE модема.
{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Установку SIM-карты в Прибор необходимо производить при отключенном электропитании.}}{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Для передачи данных через беспроводное 3G/LTE соединение требуется приобретение у поставщика услуг связи тарифа на передачу данных, совместимого с роутерами}}

=== Настройка подключения Прибора к сети Internet ===
Настройка подключения Прибора к сети осуществляется с помощью встроенной системной утилиты, доступной через интерфейсы прибора LAN или WIFI (в режиме "Точка доступа").

=== Системная утилита ===
Системная утилита - встроенное в Прибор программное обеспечение, предназначенное для конфигурирования прибора и просмотра его параметров. Взаимодействие с системной утилитой осуществляется через браузер (обозреватель).

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

Настройте подключение к Прибору, как описано в разделе [[Руководство по эксплуатации АГАВА СК-01#Настройка Прибора|Настройка Прибора]].

Для авторизации используйте следующие реквизиты:

* имя пользователя — <code>web</code>
* пароль — <code>inc23.crffdswe</code>

После ввода реквизитов нажмите кнопку "Войти".
[[Файл:АГАВАСК01-Авторизация.png|мини|Авторизация при входе в системную утилиту|640x640px|альт=|центр]]

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

[[Файл:АГАВАСК01-Начальная-страница-обновленная.png|альт=|мини|640x640px|Главная страница системной утилиты|центр]]

На странице отображены, сверху вниз:

* полоса заголовка с названием Прибора, выпадающим списком перехода на другие страницы системной утилиты и ссылка "Выйти" для завершения работы с системной утилитой;
* интерфейсы Прибора, их состояние и кнопки управления интерфейсами;
* Кнопки "Применить" и "Сохранить" для сохранения внесенных изменений;
* "подвал" страницы с указанием названия системной утилиты и версии прошивки Прибора.
{{Внимание|Тип=Восклицание синий.png|Текст=Рекомендуется установить новый пароль для входа в системную утилиту. Для этого кликните по вкладке меню «Основные настройки», затем выберете пункт «Пароль сетевого шлюза», далее задайте новый пароль и подтвердите его. Для сохранения изменений нажмите кнопку «Сохранить».}}

==== Настройка сетевых интерфейсов ====

===== Интерфейс 3G-GSM =====

Если в Прибор установлена SIM карта, то после включения и загрузки устройства, на странице «Интерфейсы» в интерфейсе 3g-GSM будет отображен полученный IP-адрес предоставленный оператором связи, а также статистика обмена пакетами (RX) и (TX).[[Файл:АГАВАСК01-3G-Интерфейс.png|мини|640x640px|3g-GSM интерфейс, IP-адрес, статистика обмена пакетами|альт=|центр]]

{{Внимание|Тип=Восклицание синий.png|Текст=Настройку интерфейса 3g-GSM в большинстве случаев производить не требуется, так как она выполняется автоматически при запуске Прибора.}}

При необходимости настройки параметров интерфейса 3g-GSM нажмите кнопку «Изменить».

В открывшемся окне на вкладке «Основные настройки» в полях <code>APN</code>, <code>Имя пользователя</code>, <code>Пароль</code> введите нужные значения параметров.

Для примера ниже приведены настройки для доступа к сети интернет через оператора связи МТС:

* APN: internet.mts.ru.
* Имя пользователя: mts
* Пароль: mts.

[[Файл:АГАВАСК01-Настройка-GSM.png|мини|Настройка параметров интерфейса GSM|640x640px|альт=|центр]]

После внесения изменений нажмите кнопку «Сохранить», при этом автоматически будет выполнен переход на главную страницу. На главной странице отображается плашка "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ", сигнализирующая о внесенных в настройки прибора изменениях, но не принятых в работу.

[[Файл:АГАВАСК01-Главная страница-Изменения.png|альт=|центр|мини|639x639пкс|Начальная страница системной утилиты - внесены изменения в настройки, ожидается их применение]]
Для '''принятия внесенных изменений''' необходимо выполнить одно из двух действий:

* нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Применить";
* нажать на кнопку "Применить" в низу главной страницы, при этом подтверждение не запрашивается и изменения сразу применяются.

Для '''отмены внесенных изменений''' необходимо нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Вернуть".

===== Интерфейс LAN =====

Интерфейс LAN предназначен для сбора данных с подключаемых устройств и настройки самого Прибора.
[[Файл:АГАВАСК01-Интерфейс LAN.png|альт=|центр|мини|640x640пкс|Иинтерфейс LAN: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «LAN» нажмите кнопку «Изменить».

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

* выбор протокола (по умолчанию установлено в «Статический адрес»)
* задание IP адреса, маски сети и адреса шлюза.

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

[[Файл:АГАВАСК01-Настройка-интерфейса-lan.png|мини|640x640px|Настройка интерфейса lan|альт=|центр]]Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WAN =====
Интерфейс WAN предназначен для подключения к системе AgavaCloud.

[[Файл:АГАВАСК01-Интерфейс WAN.png|альт=|центр|мини|640x640пкс|Интерфейс WAN: IP-адрес, статистика обмена пакетами]]

Для настройки интерфейса «WAN» нажмите кнопку «Изменить».

В открывшемся окне отображен статус устройства, имеется возможность выбора режима (по умолчанию установлен режим «DHCP-клиент») и настройки параметров.

[[Файл:АГАВАСК01-Настройка-интерфейса-Wan.png|мини|640x640px|Настройка интерфейса WAN. По умолчанию включен режим DHCP клиент.|альт=|центр]]

Для настройки статического IP-адреса в поле «Режим» из выпадающего списка выберите пункт «Статический адрес», подтвердите выбор нажатием вновь появившейся кнопки «Изменить режим». Далее в полях «IPv4-адрес», «маска сети IPv4», «IPv4-адрес шлюза» внесите необходимые настройки и нажмите кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WAN-Настройка2.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WAN. Настройка режима "Статический адрес".]]

Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WIFI (клиент) =====

Интерфейс WIFI в режиме "Клиент" предназначен для подключения к системе AgavaCloud.
[[Файл:АГАВАСК01-Интерфейс WIFI.png|альт=|центр|мини|640x640пкс|Иинтерфейс WIFI: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «WIFI» нажмите кнопку «Изменить».

В открывшемся окне отображен статус интерфейса, имеются следующие возможности:

* выбор SSID (точки доступа) из списка обнаруженных;
* выбор режима и алгоритма шифрования;
* ввод ключа (пароля) для подключения к точке доступа.

После внесения изменений, необходимо нажать кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WIFI-Настройка.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WIFI (клиент)]]
Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].{{Внимание|Тип=Восклицание синий.png|Текст=При применении настроек WIFI будет выполнен перезапуск сетевых интерфейсов Прибора. Если настройка WIFI Прибора осуществляется со смартфона, то соединение смартфона и точки доступа Прибора будет разорвано и необходимо будет повторно подключиться к точке доступа AGAVA-SK01. При настройке WIFI через LAN таких разрывов нет.}}

==== Дополнительная настройка беспроводных подключений ====
Страница "Беспроводная сеть" системной утилиты позволяет выполнить дополнительные настройки беспроводной сети Прибора:

* Включать или отключать беспроводные интерфейсы WIFI (клиент) и WIFI (точка доступа).
* Изменять настройки собственной точки доступа, например пароль или SSID. Последнее актуально при использовании нескольких приборов с покрытием WIFI одной области.
* Просматривать список клиентов, подключенных к точке доступа и отключать их.

Для перехода к странице "Беспроводная сеть" выберите пункт «Беспроводная сеть» в меню «Основные настройки».

[[Файл:АГАВАСК01-Настройка-беспроводной-сети.png|мини|Страница "Беспроводная сеть"|640x640px|альт=|центр]]

===== Настройка собственной точки доступа (WIFI в режиме "точка доступа") =====
Для настройки собственной точки доступа необходимо на странице "Беспроводная сеть" в разделе «Список беспроводных сетей» нажать кнопку «Изменить» напротив беспроводной сети <code>AGAVA-SK01 | Режим: Master</code>.

В открывшемся окне можно изменить множество настроек точки. Наиболее востребованные параметры - SSID (имя точки), пароль.
После внесения изменений нужно нажать кнопку «Сохранить» в правом нижнем углу окна.
[[Файл:АГАВАСК01-Настройка-беспроводной-сети-в-режим-работы-точка-доступа.png|мини|686x686px|Настройка WIFI в режиме "Точка доступа"|альт=|центр]]Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

=== Использование Прибора с AgavaCloud ===

==== Регистрация Прибора в AgavaCloud ====
После настройки подключения Прибора к сети Internet необходимо зарегистрировать Прибор в своем проекте AgavaCloud. Регистрация выполняется следующим образом:

# Войдите в свой проект AgavaCloud.
# Откройте раздел <code>Устройства</code> вашего проекта.
# Добавьте устройство типа <code>Шлюз АГАВА СК-01</code> и введите в поле <code>Идентификатор</code> 16-значный УИН, указанный на шильдике, находящемся на корпусе Прибора.

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

==== Добавление подчиненных устройств ====
Прибор поддерживает опрос подчиненных устройств следующих типов:

* Устройства с протоколом Modbus-TCP.
* Устройства с протоколом Modbus-RTU.

===== Добавление устройств с протоколом Modbus-RTU =====
Для опроса Прибором устройств с протоколом Modbus-RTU необходимо в проекте AgavaCloud добавить в шлюз соответствующее устройство.

При заполнении настроек устройства необходимо указать адрес последовательного порта:<code>/dev/ttyS1</code>. Остальные настройки устанавливаются в соответствии с параметрами опрашиваемого устройства.

Дальнейшие операции по настройке проекта для передачи данных Прибора в AgavaCloud описаны на [[Система облачной диспетчеризации AgavaCloud|страницах описания AgavaCloud]].

== Обновление программного обеспечения АГАВА СК-01 ==
Прибор поставляется со всем необходимым установленным системным и прикладным программным обеспечением.

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

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

== Правила транспортирования и хранения ==
Прибор должен транспортироваться в упаковке при температуре от -30 °С до +80 °С и относительной влажности воздуха не более 95 % (при 35 °С).

Транспортирование допускается всеми видами закрытого транспорта.

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

Условия хранения прибора в транспортной таре на складе потребителя должны соответствовать условиям 1 по ГОСТ 15150-69.

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

== Техническое обслуживание ==
Прибор специального обслуживания не требует.

Периодически не реже чем раз в 6 месяцев проводить:

* осмотр прибора на внешние повреждения;
* соединения зажимных контактов;
* очистку прибора от пыли и грязи;
* качества крепления на DIN-рейке.

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

== Комплектность ==
{| class="wikitable"
|+
|№ п/п
|Наименование
|Количество,
шт.
|-
|1
|Сетевой шлюз АГАВА СК-01
|1
|-
|2
|Антенна Wi-Fi (2dB)
|1
|-
|3
|Антенна GSM (2dB) *
|1
|-
|4
|Паспорт
|1
|}
<nowiki>*</nowiki> Вариант исполнения с GSM модемом СК-01.1

== Гарантийные обязательства ==
Гарантийный срок эксплуатации – 12 месяцев со дня продажи.

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

Для отправки в ремонт необходимо вложить в тару с сетевым шлюзом АГАВА СК-01 паспорт, акт отказа и отправить по адресу:

620144, г. Екатеринбург, ул. Верещагина, д. 6а, ООО КБ «АГАВА»

Тел: (343) 382-01-92.

[[Категория:АГАВА СК-01]]

Категория:АГАВА СК-01

2026-03-11T10:35:39Z

TaushkanovKV: Создана пустая страница

Cетевой шлюз АГАВА СК-01

2026-03-11T10:35:34Z

TaushkanovKV:

Cетевой шлюз АГАВА СК-01 предназначен для передачи данных в систему облачной Internet-диспетчеризации от различных средств автоматизации, модулей ввода-вывода и других контроллеров и вычислителей из списка поддерживаемых.

== Документация ==

* [[Руководство по эксплуатации АГАВА СК-01]]

[[Категория:АГАВА СК-01]]

Руководство по эксплуатации АГАВА СК-01

2026-03-11T10:34:47Z

TaushkanovKV:

[[Файл:АГАВАСК01 Внешний вид1.png|мини|Шлюз АГАВА СК-01]]

== Введение ==
Данное руководство по эксплуатации содержит сведения, необходимые для обеспечения правильной эксплуатации и полного использования технических возможностей сетевого шлюза АГАВА СК-01, далее по тексту: прибор, СК-01 или шлюз.

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

== Назначение ==

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

Подключение к внешним устройствам осуществляется через Ethernet, Wi-Fi, RS-485 (MODBUS-RTU);

=== Используемые термины и сокращения ===
ПК – персональный компьютер;

ОС – операционная система;

ПО – программное обеспечение;

ОЗУ – оперативное запоминающее устройство;

ФС – файловая система.

=== Условное обозначение прибора ===
Пример полного условного обозначения прибора:

* СК-01.1 – базовое исполнение;
* СК-01.2 – исполнение без GSM модема.

== Оснащение прибора ==

=== Состав прибора ===

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

На корпусе прибора установлены разъёмы для подключения внешних антенн.

На варианте исполнения СК-01.1 установлено 2 разъема для подключения антенн Wi-Fi и GSM (LTE) модема, СК-01.2 установлен 1 разъем для подключения антенны Wi-Fi.

В месте с прибором в зависимости от варианта исполнения поставляются одна (две) антенна(ы) с коэффициентом усиления 2dB.

В прибор СК-01.1 для работы GSM (LTE) модема устанавливается стандартная SIM-карта.

=== Конструкция Прибора ===
Габаритные размеры и позиционные обозначения компонентов Прибора приведены на рисунке ниже.
[[Файл:Views 1.png|без|мини|550x550пкс|Рисунок 1 - Габаритные размеры и позиционные обозначения СК-01]]Обозначение компонентов приведено в таблице ниже:
{| class="wikitable"
!Позиционное
обозначение
!Расшифровка
|-
|1
|GSM антенна
|-
|2
|Wi-Fi антенна
|-
|3
|Кнопка сброса настроек
|-
|4
|Место установки SIM карты
|-
|5
|Разъем подключения LAN
|-
|6
|Клемник подключения питания и RS-485
|-
|7
|Разъем подключения WAN
|-
|8
|Светодиодные индикаторы
|-
|9
|Переключатель для подключения встроенного терминального резистора RS-485
|-
|10
|Фиксатор прибора на DIN-рейке
|}

=== Технические характеристики ===
{| class="wikitable" style="width:75%"
|+

!№ п/п
! colspan="3" |Общие сведения
|-
|1
|Конструктивное исполнение
| colspan="2" |Моноблок на DIN-рейку
|-
|2
|Габаритные размеры (ВхШхГ), мм:
| colspan="2" |88 × 35 × 62

188 × 35 × 62 – с установленной антенной
|-
|3
|Масса прибора, не более, кг
| colspan="2" |0.120
|-
|4
|Степень защиты корпуса
| colspan="2" |IP20
|-
|5
|Напряжение питания
| colspan="2" |24 В ±10 % постоянного тока
|-
|6
|Потребляемая мощность, не более
| colspan="2" |12 Вт
|-
! colspan="4" |Интерфейсы подключения к AgavaCloud
|-
!style="width:3%" |
!style="width:13%" |
!style="width:20%" | АГАВА СК-01.1
!style="width:20%" | АГАВА СК-01.2
|-
|7
|Ethernet
| colspan="2" |WAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|8
|Wi-Fi
| colspan="2" |Режим "Клиент", стандарты 802.11 b/g/n, антенна внешняя.
Макс. чувствительность приемника 76 дБ, макс. мощность передатчика 21.1 дБ.

Тип разъема для антенны – SMA-F
|-
|9
|GSM
|1шт., GSM(LTE) - LTE CAT1 модуль, с поддержкой LTE-TDD/LTE-FDD.
Максимальная скорость загрузки 10Mbps, скорость передачи - 5Mbps.

Тип разъема для антенны – SMA-F

Стандартная mini-SIM карта с поддержкой всех операторов беспроводной связи
|Отсутствует
|-
! colspan="4" |Интерфейсы подключения устройств
|-
|10
|Ethernet
| colspan="2" |LAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|11
|RS-485
| colspan="2" |1шт. с гальванической развязкой, скорость до 115200 Mбит/с включительно
|-
! colspan="4" |Индикация и управление
|-
| rowspan="6" |12
| rowspan="6" |Индикация
| colspan="2" |Индикатор наличия питания - <code>POW</code>
|-
| colspan="2" |Индикатор состояния GSM модема - <code>GSM</code>
|-
| colspan="2" |Индикатор состояния WIFI - <code>WiFi</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейса RS-485 - <code>RX</code> <code>TX</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейсов Ethernet (на разъемах интерфейсов)
|-
| colspan="2" |Индикатор режима работы - <code>USR</code>
|-
|13
|Органы управления
| colspan="2" |Кнопка сброса, возврата к заводским установкам
|-
|14
|Переключатель
| colspan="2" |Включение и отключение терминального резистора
|}

== Условия эксплуатации ==
{| class="wikitable"
! colspan="2" |Условия эксплуатации
|-
|Тип помещения
|Закрытые взрывобезопасные помещения без агрессивных паров и газов
|-
|Температура окружающего воздуха
|От 0 до +50°С
|-
|Влажность воздуха
|Верхний предел относительной влажности воздуха 80% при +35°С и более низких температурах без конденсации влаги
|-
|Атмосферное давление
|От 86 до 107 кПа
|}

== Маркировка ==
На боковой панели прибора расположена наклейка с информацией о приборе:

* обозначение исполнения Прибора;
* заводской номер Прибора;
* уникальный идентификационный номер Прибора (УИН).

== Устройство и принцип работы прибора ==

=== Подготовка прибора к использованию ===

==== Общие указания ====
В зимнее время тару с прибором распаковывать в отапливаемом помещении не ранее чем через 4 часа после внесения их в помещение. Монтаж, эксплуатация и демонтаж СК-01 должны производиться персоналом, ознакомленным с правилами его эксплуатации и прошедшим инструктаж для работы с электрооборудованием в соответствии с правилами, установленными на предприятии-потребителе.

==== Указания мер безопасности ====
По способу защиты от поражения электрическим током CK-01 соответствует классу 0 по ГОСТ 12.2.007.0-75.

При эксплуатации и техническом обслуживании необходимо соблюдать требования ГОСТ 12.3.019-80, «Правил эксплуатации электроустановок потребителей» и «Правил охраны труда при эксплуатации электроустановок потребителей».

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

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

Установка и извлечение SIM-карты в сетевой шлюз АГАВА СК-01.1должна выполняться только при отключенном питании прибора.

==== Монтаж и подключение прибора ====
Прибор устанавливается на DIN-рейку 35мм. при помощи специального фиксатора (Рисунок 1, Позиция 10), расположенного в верхней части прибора.

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

Установку SIM-карты (Рисунок 1, Позиция 4) в сетевой шлюз АГАВА СК-01.1 производить до установки Прибора на DIN-рейку.

Установку антенн производить после установки прибора на DIN-рейку.

Подключаемые к прибору провода должны быть многожильными сечением от 0,25 до 0,5 мм2. Рекомендуемые типы кабелей МКШ, МКЭШ, МКШМ ГОСТ 10348-80.

Рекомендуется обжимать концы подключаемых проводов наконечниками типа НШВИ.

==== Подключение линий связи ====
Ниже приведены схемы подключения внешних устройств (блоков питания, линии RS-485 и Ethernet) к прибору.

===== Схема подключения питания =====
[[Файл:Power.png|мини|550x550px|Рисунок 2 - Схема подключения питания|альт=|без]]

===== Схема подключения линии RS-485 (без дренажного провода) =====
[[Файл:RS-485 NO DRAIN.png|без|мини|550x550px|Рисунок -3 Схема подключения линии RS-485 (без дренажного провода)|альт=]]

===== Схема подключения линии RS-485 (c дренажным проводом) =====
[[Файл:RS-485 with drain.png|без|мини|550x550px|Рисунок 4 - Схема подключения линии RS-485 (c дренажным проводом)|альт=]]Примечание''':''' для подключения встроенных терминальных резисторов RS-485 (120 Ом) необходимо перевести переключатель SW-1 (Рисунок 1, Позиция 9) в положение “ON” .

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

Для уменьшения влияния электромагнитных помех необходимо выполнять приведенные ниже рекомендации:

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

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

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

=== Интерфейсы прибора и их назначение ===
Прибор оснащен большим количеством интерфейсов передачи данных, имеющих разное назначение.

Интерфейсы связи с системой AgavaCloud:

# 3G-GSM.
# WAN.
# WIFI (клиент).

Интерфейсы для сбора данных с подключаемых устройств:

# LAN.
# RS-485.

Интерфейсы для настройки Прибора:

# LAN
# WIFI (точка доступа).

=== Состав программного обеспечения прибора ===
Программное обеспечение прибора состоит из следующих частей:

* Системное программное обеспечение.
* Прикладное программное обеспечение, обеспечивающее взаимодействие с AgavaCloud.

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

== Порядок работы с прибором ==
=== Первое включение и загрузка ===
[[Файл:АГАВАСК01-Циклограмма работы.png.png|мини|600x600пкс|Рисунок 5 - Циклограмма мигания индикатора USR]]
Подключите прибор к источнику питания +24В соблюдая полярность.

После подачи питания должен загореться индикатор питания “POW” и начаться инициализация. В процессе инициализации будет мигать светодиоды “Wi-Fi”, "USR", "GSM".

Светодиод "USR" индицирует текущий режим/этап работы Прибора с помощью мигания. Характер мигания светодиода в разных режимах показан на рис. 5.

Светодиод "GSM" отображает статус сети. Режимы мигания показаны на рис. 6.

[[Файл:АГАВАСК01-циклограмма-LED-индикатора-GSM.png|мини|599x599px|Рисунок 6 - Циклограмма мигания индикатора GSM|альт=]]

=== Режимы и этапы работы Прибора ===
После включения Прибор последовательно проходит через описываемые ниже режимы и этапы. Характер мигания светодиода в разных режимах показан на рис. 5.

# Режим <code>Подготовка</code>. Начинается после подачи питания.
## Этап <code>Инициализация</code>. Длительность этапа - примерно 10 с.
## Этап <code>Загрузка</code>. Длительность этапа - примерно 60-70 с.
## Этап <code>Окончание загрузки</code>. Длительность этапа - примерно 1-5 с.
# Режим <code>Работа</code>. Примерно через 70 секунд после включения прибор начинает обмен информацией с AgavaCloud, состоящий из следующих этапов:
## Этап <code>Подключение</code> к AgavaCloud. На этом этапе производится установление соединения с AgavaCloud. Длительность режима - примерно 1 с при настроенном подключении Прибора к сети Internet. При отсутствии подключения Прибор находится в данном режиме до установления подключения к AgavaCloud. Светодиод USR кратковременно зажигается (на 100 мс), далее гаснет на 900 мс, после чего цикл повторяется.
## Этап <code>Регистрация</code> в AgavaCloud. На этом этапе подключение к AgavaCloud установлено, прибор авторизуется в системе. После успешной регистрации прибор переходит к следующему этапу. На данном этапе светодиод USR делает два импульса по 100 мс с промежутком в 100 мс, далее гаснет на 700 мс, после чего цикл повторяется. Длительность режима - примерно 1 с. При наличии проблем с регистрацией Прибор находится в данном режиме до установления подключения к AgavaCloud
## Этап <code>Получение задания</code>. Длительность режима при наличии задания (то есть в каком-либо проекте задействован Прибор и для него определена конфигурация) - примерно 1 с, при отсутствии задания прибор находится в этом режиме до тех пор, пока не получит задание. На данном этапе светодиод USR делает три импульса по 100 мс с промежутком в 100 мс, далее гаснет на 500 мс, после чего цикл повторяется.
## Этап <code>Передача данных</code>. Основной этап, в котором находится прибор в нормальном состоянии (настроено подключение и прибор присутствует в каком-либо проекте в AgavaCloud). Светодиод USR попеременно зажигается и гаснет на 1 с.

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

Для настройки Прибора необходимо подключиться к нему одним из следующих способов:

* Кабельное подключение через Ethernet.
* Подключение к встроенной точке доступа WIFI.

==== Настройка Прибора через кабельное подключение через Ethernet ====

* Соедините кабелем Ethernet компьютер и порт LAN Прибора напрямую или через коммутатор.
* Убедитесь, что на компьютере в настройках сетевого адаптера имеется IP-адрес из сети <code>192.168.1.х</code>, например <code>192.168.1.88</code>, маска <code>255.255.255.0</code>.
* Откройте интернет-обозреватель и в адресной строке введите адрес: <code>192.168.1.1</code>. После загрузки прибора браузер автоматически откроет страницу системной утилиты.
* Введите логин и пароль, далее произведите настройку Прибора.

==== Настройка Прибора через Wi-Fi ====
Прибор оснащен модулем WIFI, по умолчанию настроенным на работу в режиме точки доступа, в котором возможно подключение к Прибору для его настройки.

Порядок подключения:
* Откройте на компьютере настройку беспроводных сетей и выполните поиск доступных Wi-Fi сетей, либо на смартфоне включите модуль WIFI и откройте окно выбора сети. В списке сетей должна появиться сеть c именем <code>AGAVA-SK01</code>.
* Подключите компьютер к сети <code>AGAVA-SK01</code>. Сеть <code>AGAVA-SK01</code> является открытой и не требует пароля и шифрования.
* После удачного подключения к <code>AGAVA-SK01</code> откройте интернет-обозреватель и в адресной строке введите адрес устройства: <code>192.168.2.1</code>. Браузер откроет страницу системной утилиты.

* Введите логин и пароль, далее произведите настройку Прибора.

=== Подключение Прибора к сети Internet ===
Для использования Прибора необходимо подключить его к сети Internet одним из следующих способов:

# Кабельное подключение через локальную сеть или напрямую к поставщику услуг сети Internet.
# WIFI подключение к существующей точке доступа.
# Беспроводное 3G/LTE соединение с Internet с помощью встроенного 3G/LTE модема.
{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Установку SIM-карты в Прибор необходимо производить при отключенном электропитании.}}{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Для передачи данных через беспроводное 3G/LTE соединение требуется приобретение у поставщика услуг связи тарифа на передачу данных, совместимого с роутерами}}

=== Настройка подключения Прибора к сети Internet ===
Настройка подключения Прибора к сети осуществляется с помощью встроенной системной утилиты, доступной через интерфейсы прибора LAN или WIFI (в режиме "Точка доступа").

=== Системная утилита ===
Системная утилита - встроенное в Прибор программное обеспечение, предназначенное для конфигурирования прибора и просмотра его параметров. Взаимодействие с системной утилитой осуществляется через браузер (обозреватель).

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

Настройте подключение к Прибору, как описано в разделе [[Руководство по эксплуатации АГАВА СК-01#Настройка Прибора|Настройка Прибора]].

Для авторизации используйте следующие реквизиты:

* имя пользователя — <code>web</code>
* пароль — <code>inc23.crffdswe</code>

После ввода реквизитов нажмите кнопку "Войти".
[[Файл:АГАВАСК01-Авторизация.png|мини|Авторизация при входе в системную утилиту|640x640px|альт=|центр]]

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

[[Файл:АГАВАСК01-Начальная-страница-обновленная.png|альт=|мини|640x640px|Главная страница системной утилиты|центр]]

На странице отображены, сверху вниз:

* полоса заголовка с названием Прибора, выпадающим списком перехода на другие страницы системной утилиты и ссылка "Выйти" для завершения работы с системной утилитой;
* интерфейсы Прибора, их состояние и кнопки управления интерфейсами;
* Кнопки "Применить" и "Сохранить" для сохранения внесенных изменений;
* "подвал" страницы с указанием названия системной утилиты и версии прошивки Прибора.
{{Внимание|Тип=Восклицание синий.png|Текст=Рекомендуется установить новый пароль для входа в системную утилиту. Для этого кликните по вкладке меню «Основные настройки», затем выберете пункт «Пароль сетевого шлюза», далее задайте новый пароль и подтвердите его. Для сохранения изменений нажмите кнопку «Сохранить».}}

==== Настройка сетевых интерфейсов ====

===== Интерфейс 3G-GSM =====

Если в Прибор установлена SIM карта, то после включения и загрузки устройства, на странице «Интерфейсы» в интерфейсе 3g-GSM будет отображен полученный IP-адрес предоставленный оператором связи, а также статистика обмена пакетами (RX) и (TX).[[Файл:АГАВАСК01-3G-Интерфейс.png|мини|640x640px|3g-GSM интерфейс, IP-адрес, статистика обмена пакетами|альт=|центр]]

{{Внимание|Тип=Восклицание синий.png|Текст=Настройку интерфейса 3g-GSM в большинстве случаев производить не требуется, так как она выполняется автоматически при запуске Прибора.}}

При необходимости настройки параметров интерфейса 3g-GSM нажмите кнопку «Изменить».

В открывшемся окне на вкладке «Основные настройки» в полях <code>APN</code>, <code>Имя пользователя</code>, <code>Пароль</code> введите нужные значения параметров.

Для примера ниже приведены настройки для доступа к сети интернет через оператора связи МТС:

* APN: internet.mts.ru.
* Имя пользователя: mts
* Пароль: mts.

[[Файл:АГАВАСК01-Настройка-GSM.png|мини|Настройка параметров интерфейса GSM|640x640px|альт=|центр]]

После внесения изменений нажмите кнопку «Сохранить», при этом автоматически будет выполнен переход на главную страницу. На главной странице отображается плашка "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ", сигнализирующая о внесенных в настройки прибора изменениях, но не принятых в работу.

[[Файл:АГАВАСК01-Главная страница-Изменения.png|альт=|центр|мини|639x639пкс|Начальная страница системной утилиты - внесены изменения в настройки, ожидается их применение]]
Для '''принятия внесенных изменений''' необходимо выполнить одно из двух действий:

* нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Применить";
* нажать на кнопку "Применить" в низу главной страницы, при этом подтверждение не запрашивается и изменения сразу применяются.

Для '''отмены внесенных изменений''' необходимо нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Вернуть".

===== Интерфейс LAN =====

Интерфейс LAN предназначен для сбора данных с подключаемых устройств и настройки самого Прибора.
[[Файл:АГАВАСК01-Интерфейс LAN.png|альт=|центр|мини|640x640пкс|Иинтерфейс LAN: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «LAN» нажмите кнопку «Изменить».

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

* выбор протокола (по умолчанию установлено в «Статический адрес»)
* задание IP адреса, маски сети и адреса шлюза.

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

[[Файл:АГАВАСК01-Настройка-интерфейса-lan.png|мини|640x640px|Настройка интерфейса lan|альт=|центр]]Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WAN =====
Интерфейс WAN предназначен для подключения к системе AgavaCloud.

[[Файл:АГАВАСК01-Интерфейс WAN.png|альт=|центр|мини|640x640пкс|Интерфейс WAN: IP-адрес, статистика обмена пакетами]]

Для настройки интерфейса «WAN» нажмите кнопку «Изменить».

В открывшемся окне отображен статус устройства, имеется возможность выбора режима (по умолчанию установлен режим «DHCP-клиент») и настройки параметров.

[[Файл:АГАВАСК01-Настройка-интерфейса-Wan.png|мини|640x640px|Настройка интерфейса WAN. По умолчанию включен режим DHCP клиент.|альт=|центр]]

Для настройки статического IP-адреса в поле «Режим» из выпадающего списка выберите пункт «Статический адрес», подтвердите выбор нажатием вновь появившейся кнопки «Изменить режим». Далее в полях «IPv4-адрес», «маска сети IPv4», «IPv4-адрес шлюза» внесите необходимые настройки и нажмите кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WAN-Настройка2.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WAN. Настройка режима "Статический адрес".]]

Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WIFI (клиент) =====

Интерфейс WIFI в режиме "Клиент" предназначен для подключения к системе AgavaCloud.
[[Файл:АГАВАСК01-Интерфейс WIFI.png|альт=|центр|мини|640x640пкс|Иинтерфейс WIFI: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «WIFI» нажмите кнопку «Изменить».

В открывшемся окне отображен статус интерфейса, имеются следующие возможности:

* выбор SSID (точки доступа) из списка обнаруженных;
* выбор режима и алгоритма шифрования;
* ввод ключа (пароля) для подключения к точке доступа.

После внесения изменений, необходимо нажать кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WIFI-Настройка.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WIFI (клиент)]]
Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].{{Внимание|Тип=Восклицание синий.png|Текст=При применении настроек WIFI будет выполнен перезапуск сетевых интерфейсов Прибора. Если настройка WIFI Прибора осуществляется со смартфона, то соединение смартфона и точки доступа Прибора будет разорвано и необходимо будет повторно подключиться к точке доступа AGAVA-SK01. При настройке WIFI через LAN таких разрывов нет.}}

==== Дополнительная настройка беспроводных подключений ====
Страница "Беспроводная сеть" системной утилиты позволяет выполнить дополнительные настройки беспроводной сети Прибора:

* Включать или отключать беспроводные интерфейсы WIFI (клиент) и WIFI (точка доступа).
* Изменять настройки собственной точки доступа, например пароль или SSID. Последнее актуально при использовании нескольких приборов с покрытием WIFI одной области.
* Просматривать список клиентов, подключенных к точке доступа и отключать их.

Для перехода к странице "Беспроводная сеть" выберите пункт «Беспроводная сеть» в меню «Основные настройки».

[[Файл:АГАВАСК01-Настройка-беспроводной-сети.png|мини|Страница "Беспроводная сеть"|640x640px|альт=|центр]]

===== Настройка собственной точки доступа (WIFI в режиме "точка доступа") =====
Для настройки собственной точки доступа необходимо на странице "Беспроводная сеть" в разделе «Список беспроводных сетей» нажать кнопку «Изменить» напротив беспроводной сети <code>AGAVA-SK01 | Режим: Master</code>.

В открывшемся окне можно изменить множество настроек точки. Наиболее востребованные параметры - SSID (имя точки), пароль.
После внесения изменений нужно нажать кнопку «Сохранить» в правом нижнем углу окна.
[[Файл:АГАВАСК01-Настройка-беспроводной-сети-в-режим-работы-точка-доступа.png|мини|686x686px|Настройка WIFI в режиме "Точка доступа"|альт=|центр]]Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

=== Использование Прибора с AgavaCloud ===

==== Регистрация Прибора в AgavaCloud ====
После настройки подключения Прибора к сети Internet необходимо зарегистрировать Прибор в своем проекте AgavaCloud. Регистрация выполняется следующим образом:

# Войдите в свой проект AgavaCloud.
# Откройте раздел <code>Устройства</code> вашего проекта.
# Добавьте устройство типа <code>Шлюз АГАВА СК-01</code> и введите в поле <code>Идентификатор</code> 16-значный УИН, указанный на шильдике, находящемся на корпусе Прибора.

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

==== Добавление подчиненных устройств ====
Прибор поддерживает опрос подчиненных устройств следующих типов:

* Устройства с протоколом Modbus-TCP.
* Устройства с протоколом Modbus-RTU.

===== Добавление устройств с протоколом Modbus-RTU =====
Для опроса Прибором устройств с протоколом Modbus-RTU необходимо в проекте AgavaCloud добавить в шлюз соответствующее устройство.

При заполнении настроек устройства необходимо указать адрес последовательного порта:<code>/dev/ttyS1</code>. Остальные настройки устанавливаются в соответствии с параметрами опрашиваемого устройства.

Дальнейшие операции по настройке проекта для передачи данных Прибора в AgavaCloud описаны на [[Система облачной диспетчеризации AgavaCloud|страницах описания AgavaCloud]].

== Обновление программного обеспечения АГАВА СК-01 ==
Прибор поставляется со всем необходимым установленным системным и прикладным программным обеспечением.

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

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

== Правила транспортирования и хранения ==
Прибор должен транспортироваться в упаковке при температуре от -30 °С до +80 °С и относительной влажности воздуха не более 95 % (при 35 °С).

Транспортирование допускается всеми видами закрытого транспорта.

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

Условия хранения прибора в транспортной таре на складе потребителя должны соответствовать условиям 1 по ГОСТ 15150-69.

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

== Техническое обслуживание ==
Прибор специального обслуживания не требует.

Периодически не реже чем раз в 6 месяцев проводить:

* осмотр прибора на внешние повреждения;
* соединения зажимных контактов;
* очистку прибора от пыли и грязи;
* качества крепления на DIN-рейке.

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

== Комплектность ==
{| class="wikitable"
|+
|№ п/п
|Наименование
|Количество,
шт.
|-
|1
|Сетевой шлюз АГАВА СК-01
|1
|-
|2
|Антенна Wi-Fi (2dB)
|1
|-
|3
|Антенна GSM (2dB) *
|1
|-
|4
|Паспорт
|1
|}
<nowiki>*</nowiki> Вариант исполнения с GSM модемом СК-01.1

== Гарантийные обязательства ==
Гарантийный срок эксплуатации – 12 месяцев со дня продажи.

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

Для отправки в ремонт необходимо вложить в тару с сетевым шлюзом АГАВА СК-01 паспорт, акт отказа и отправить по адресу:

620144, г. Екатеринбург, ул. Верещагина, д. 6а, ООО КБ «АГАВА»

Тел: (343) 382-01-92.

Файл:АГАВАСК01 Внешний вид1.png

2026-03-11T10:34:17Z

TaushkanovKV:

АГАВА СК-01 Внешний вид

Система облачной диспетчеризации AgavaCloud

2026-03-11T09:14:18Z

TaushkanovKV: /* Подключение устройств других типов */

AgavaCloud - облачная система диспетчеризации, предоставляющая следующие возможности:

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

== Сбор и регистрация данных ==
AgavaCloud поддерживает несколько способов сбора данных:

* Прямое подключение к устройствам, работающим по протоколам Modbus-TCP, MQTT(*), OPC-UA(*).
* Подключение к устройствам через шлюзы АГАВА СК-01, АГАВА СК-02 или программные шлюзы rtgw для ОС Windows или Linux.

(*) - возможность появится в ближайшей перспективе.

Прямое подключение к устройствам требует наличия постоянного "белого" IP-адреса и настроенного маршрутизатора, обеспечивающего вывод устройств в сеть Internet.

Подключение к устройствам через шлюзы АГАВА СК-01, АГАВА СК-02 '''не требует постоянного "белого" IP-адреса и маршрутизатора,''' возможно использование GSM/GPRS/LTE связи.

Регистрация данных производится с настраиваемой периодичностью. Время хранения зарегистрированных данных также настраивается

=== Подключение к устройствам с использованием шлюзов АГАВА СК-01, АГАВА СК-02 ===
Каждый шлюз имеет Уникальный Идентификационный Номер (УИН).

Для подключения оборудования через шлюз необходимо добавить его в свой "проект" AgavaCloud по УИН в разделе "Устройства". С этого момента шлюз доступен к использованию в облаке. Можно приступить к добавлению подчиненных устройств в шлюз.

=== Подключение устройств других типов ===
AgavaCloud поддерживает подключение устройств с протоколом Modbus-TCP, подключенных к сети Internet.

==== Подключение устройств с протоколом Modbus-TCP ====
Подключаемое устройство должно быть доступно из сети Internet, для чего нужно выполнить настройку маршрутизатора, через который подключаемое устройство соединяется с Internet. Подключение маршрутизатора к сети Internet должно осуществляться через постоянный "белый" IP-адрес.

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

== Визуализация данных ==
AgavaCloud предоставляет возможности визуализации данных в следующих видах:

* Таблицы параметров.
* Экраны с виджетами.
* Графики.
* Журнал событий.
[[Файл:AgavaCloud-Параметры устройства.png|мини|Параметры устройства]]
=== Таблицы параметров ===
Просмотр значений параметров в виде таблицы.

=== Экраны с виджетами ===
Экран "Панель" настраиваемого пользователем вида, на котором размещаются различные виджеты, индицирующие параметры в виде цифровых индикаторов или небольших графиков.[[Файл:AgavaCloud-Архив1.png|мини|Графики в архиве AgavaCloud]]
=== Графики ===
Специализированный экран, содержащий графики выбранных пользователем параметров с возможностями просмотра в различном масштабе и контроля точных значений параметров в нужное время.

=== Журнал событий ===
[[Файл:AgavaCloud-Журнал событий.png|мини|Журнал событий]]
Журнал событий хранит события, регистрируемые в ходе работы оборудования и возникающие при обработке принимаемых данных по алгоритмам пользователя.

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

Для всех параметров возможно включение сигнализации по следующим алгоритмам:

* выход значения параметра за аварийные (НАУ/ВАУ) и (или) предупредительные (НПУ/ВПУ) пределы изменения;
* превышение заданной уставки или понижение значения параметра ниже уставки.

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

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

== Функциональные пакеты AgavaCloud ==
Функционал AgavaCloud доступен в трех пакетах - "бесплатный", "базовый" и "оптимальный".

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

{| class="wikitable"
|+
! Функция
! style="width:16%" | Бесплатный *1
! style="width:16%" | Базовый
! style="width:16%" | Оптимальный
! style="width:16%" | Максимальный
|-
|'''Устройства'''
| colspan="4" |
|-
|Типы подключаемых устройств
|Шлюзы АГАВА-СК
|Шлюзы АГАВА-СК,
[[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройства из списка]]
|Шлюзы АГАВА-СК,
[[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройства из списка]]
|Шлюзы АГАВА-СК,
[[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройства из списка]]
|-
|Количество подключаемых шлюзов
|не ограничено
|не ограничено
|не ограничено
|не ограничено
|-
|Количество подключаемых [[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройств других типов]]
|0
|1
|10
|не ограничено
|-
|Интервал опроса, с
|60
|15
|5
|1*2
|-
|'''Параметры'''
| colspan="4" |
|-
|Количество измеряемых параметров
|10
|100
|не ограничено
|не ограничено
|-
|Количество вычисляемых параметров
|×
|10
|не ограничено
|не ограничено
|-
|'''Экраны'''
| colspan="4" |
|-
|Экран "Панель"
| ●
| ●
| ●
|●
|-
|Экран "Таблица параметров"
| ●
| ●
| ●
|●
|-
|'''Архивы'''
| colspan="4" |
|-
|Количество архивов
| 1
| 5
| 10
|не ограничено
|-
|Минимальный интервал архивирования, с
| 60
|15
|5
|1
|-
|Максимальный период хранения архива
| 30 дней
|30 дней
|365 дней
|3650 дней
|-
|Высокоскоростное архивирование*3
| ×
| ×
| ×
|●
|-
|'''Журналы'''
| colspan="4" |
|-
|Журнал событий
| ●
|●
| ●
|●
|-
|Максимальный период хранения журнала
|30 дней
|30 дней
|365 дней
|3650 дней
|-
|'''Сигнализация'''
| colspan="3" |
|
|-
|Алгоритмы сигнализации
| colspan="4" |
|-
|Контроль НАУ/НПУ/ВПУ/ВАУ измеряемых параметров
|×
|×
| ●
|●
|-
|Контроль уставки
|×
|×
| ●
|●
|-
|Действия
| colspan="4" |
|-
|Регистрация события в журнале
|×
|×
| ●
|●
|-
|Запись значения в параметр
|×
|×
| ●
|●
|-
|Отправка сообщения в телеграм
|×
|×
| ●
|●
|-
|Отправка сообщения по электронной почте
|×
|×
|●
|●
|-
|'''Стоимость подписки, за месяц, рублей'''
|0
|1000
|3000
|8500
|}
Примечания:

*1 - при использовании со шлюзами АГАВА СК-01 или аналогичными производства КБ АГАВА.

*2 - типичное время, при наличии более быстродействующего оборудования интервал может быть меньше.

*3 - возможность архивирования данных чаще, чем осуществляется передача данных на сервер. Минимальный интервал высокоскоростного архивирования - 100 мс. В данный момент возможность не предоставляется.
[[Категория:AgavaCloud]]

Система облачной диспетчеризации AgavaCloud

2026-03-11T09:11:38Z

TaushkanovKV: /* Функциональные пакеты AgavaCloud */

AgavaCloud - облачная система диспетчеризации, предоставляющая следующие возможности:

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

== Сбор и регистрация данных ==
AgavaCloud поддерживает несколько способов сбора данных:

* Прямое подключение к устройствам, работающим по протоколам Modbus-TCP, MQTT(*), OPC-UA(*).
* Подключение к устройствам через шлюзы АГАВА СК-01, АГАВА СК-02 или программные шлюзы rtgw для ОС Windows или Linux.

(*) - возможность появится в ближайшей перспективе.

Прямое подключение к устройствам требует наличия постоянного "белого" IP-адреса и настроенного маршрутизатора, обеспечивающего вывод устройств в сеть Internet.

Подключение к устройствам через шлюзы АГАВА СК-01, АГАВА СК-02 '''не требует постоянного "белого" IP-адреса и маршрутизатора,''' возможно использование GSM/GPRS/LTE связи.

Регистрация данных производится с настраиваемой периодичностью. Время хранения зарегистрированных данных также настраивается

=== Подключение к устройствам с использованием шлюзов АГАВА СК-01, АГАВА СК-02 ===
Каждый шлюз имеет Уникальный Идентификационный Номер (УИН).

Для подключения оборудования через шлюз необходимо добавить его в свой "проект" AgavaCloud по УИН в разделе "Устройства". С этого момента шлюз доступен к использованию в облаке. Можно приступить к добавлению подчиненных устройств в шлюз.

=== Подключение устройств других типов ===

==== Устройства с протоколом Modbus-TCP ====
Подключаемое устройство должно быть доступно из сети Internet, для чего нужно выполнить настройку маршрутизатора, через который подключаемое устройство соединяется с Internet. Подключение маршрутизатора к сети Internet должно осуществляться через постоянный "белый" IP-адрес.

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

== Визуализация данных ==
AgavaCloud предоставляет возможности визуализации данных в следующих видах:

* Таблицы параметров.
* Экраны с виджетами.
* Графики.
* Журнал событий.
[[Файл:AgavaCloud-Параметры устройства.png|мини|Параметры устройства]]
=== Таблицы параметров ===
Просмотр значений параметров в виде таблицы.

=== Экраны с виджетами ===
Экран "Панель" настраиваемого пользователем вида, на котором размещаются различные виджеты, индицирующие параметры в виде цифровых индикаторов или небольших графиков.[[Файл:AgavaCloud-Архив1.png|мини|Графики в архиве AgavaCloud]]
=== Графики ===
Специализированный экран, содержащий графики выбранных пользователем параметров с возможностями просмотра в различном масштабе и контроля точных значений параметров в нужное время.

=== Журнал событий ===
[[Файл:AgavaCloud-Журнал событий.png|мини|Журнал событий]]
Журнал событий хранит события, регистрируемые в ходе работы оборудования и возникающие при обработке принимаемых данных по алгоритмам пользователя.

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

Для всех параметров возможно включение сигнализации по следующим алгоритмам:

* выход значения параметра за аварийные (НАУ/ВАУ) и (или) предупредительные (НПУ/ВПУ) пределы изменения;
* превышение заданной уставки или понижение значения параметра ниже уставки.

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

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

== Функциональные пакеты AgavaCloud ==
Функционал AgavaCloud доступен в трех пакетах - "бесплатный", "базовый" и "оптимальный".

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

{| class="wikitable"
|+
! Функция
! style="width:16%" | Бесплатный *1
! style="width:16%" | Базовый
! style="width:16%" | Оптимальный
! style="width:16%" | Максимальный
|-
|'''Устройства'''
| colspan="4" |
|-
|Типы подключаемых устройств
|Шлюзы АГАВА-СК
|Шлюзы АГАВА-СК,
[[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройства из списка]]
|Шлюзы АГАВА-СК,
[[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройства из списка]]
|Шлюзы АГАВА-СК,
[[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройства из списка]]
|-
|Количество подключаемых шлюзов
|не ограничено
|не ограничено
|не ограничено
|не ограничено
|-
|Количество подключаемых [[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройств других типов]]
|0
|1
|10
|не ограничено
|-
|Интервал опроса, с
|60
|15
|5
|1*2
|-
|'''Параметры'''
| colspan="4" |
|-
|Количество измеряемых параметров
|10
|100
|не ограничено
|не ограничено
|-
|Количество вычисляемых параметров
|×
|10
|не ограничено
|не ограничено
|-
|'''Экраны'''
| colspan="4" |
|-
|Экран "Панель"
| ●
| ●
| ●
|●
|-
|Экран "Таблица параметров"
| ●
| ●
| ●
|●
|-
|'''Архивы'''
| colspan="4" |
|-
|Количество архивов
| 1
| 5
| 10
|не ограничено
|-
|Минимальный интервал архивирования, с
| 60
|15
|5
|1
|-
|Максимальный период хранения архива
| 30 дней
|30 дней
|365 дней
|3650 дней
|-
|Высокоскоростное архивирование*3
| ×
| ×
| ×
|●
|-
|'''Журналы'''
| colspan="4" |
|-
|Журнал событий
| ●
|●
| ●
|●
|-
|Максимальный период хранения журнала
|30 дней
|30 дней
|365 дней
|3650 дней
|-
|'''Сигнализация'''
| colspan="3" |
|
|-
|Алгоритмы сигнализации
| colspan="4" |
|-
|Контроль НАУ/НПУ/ВПУ/ВАУ измеряемых параметров
|×
|×
| ●
|●
|-
|Контроль уставки
|×
|×
| ●
|●
|-
|Действия
| colspan="4" |
|-
|Регистрация события в журнале
|×
|×
| ●
|●
|-
|Запись значения в параметр
|×
|×
| ●
|●
|-
|Отправка сообщения в телеграм
|×
|×
| ●
|●
|-
|Отправка сообщения по электронной почте
|×
|×
|●
|●
|-
|'''Стоимость подписки, за месяц, рублей'''
|0
|1000
|3000
|8500
|}
Примечания:

*1 - при использовании со шлюзами АГАВА СК-01 или аналогичными производства КБ АГАВА.

*2 - типичное время, при наличии более быстродействующего оборудования интервал может быть меньше.

*3 - возможность архивирования данных чаще, чем осуществляется передача данных на сервер. Минимальный интервал высокоскоростного архивирования - 100 мс. В данный момент возможность не предоставляется.
[[Категория:AgavaCloud]]

Система облачной диспетчеризации AgavaCloud

2026-03-11T09:10:01Z

TaushkanovKV: /* Функциональные пакеты AgavaCloud */

AgavaCloud - облачная система диспетчеризации, предоставляющая следующие возможности:

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

== Сбор и регистрация данных ==
AgavaCloud поддерживает несколько способов сбора данных:

* Прямое подключение к устройствам, работающим по протоколам Modbus-TCP, MQTT(*), OPC-UA(*).
* Подключение к устройствам через шлюзы АГАВА СК-01, АГАВА СК-02 или программные шлюзы rtgw для ОС Windows или Linux.

(*) - возможность появится в ближайшей перспективе.

Прямое подключение к устройствам требует наличия постоянного "белого" IP-адреса и настроенного маршрутизатора, обеспечивающего вывод устройств в сеть Internet.

Подключение к устройствам через шлюзы АГАВА СК-01, АГАВА СК-02 '''не требует постоянного "белого" IP-адреса и маршрутизатора,''' возможно использование GSM/GPRS/LTE связи.

Регистрация данных производится с настраиваемой периодичностью. Время хранения зарегистрированных данных также настраивается

=== Подключение к устройствам с использованием шлюзов АГАВА СК-01, АГАВА СК-02 ===
Каждый шлюз имеет Уникальный Идентификационный Номер (УИН).

Для подключения оборудования через шлюз необходимо добавить его в свой "проект" AgavaCloud по УИН в разделе "Устройства". С этого момента шлюз доступен к использованию в облаке. Можно приступить к добавлению подчиненных устройств в шлюз.

=== Подключение устройств других типов ===

==== Устройства с протоколом Modbus-TCP ====
Подключаемое устройство должно быть доступно из сети Internet, для чего нужно выполнить настройку маршрутизатора, через который подключаемое устройство соединяется с Internet. Подключение маршрутизатора к сети Internet должно осуществляться через постоянный "белый" IP-адрес.

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

== Визуализация данных ==
AgavaCloud предоставляет возможности визуализации данных в следующих видах:

* Таблицы параметров.
* Экраны с виджетами.
* Графики.
* Журнал событий.
[[Файл:AgavaCloud-Параметры устройства.png|мини|Параметры устройства]]
=== Таблицы параметров ===
Просмотр значений параметров в виде таблицы.

=== Экраны с виджетами ===
Экран "Панель" настраиваемого пользователем вида, на котором размещаются различные виджеты, индицирующие параметры в виде цифровых индикаторов или небольших графиков.[[Файл:AgavaCloud-Архив1.png|мини|Графики в архиве AgavaCloud]]
=== Графики ===
Специализированный экран, содержащий графики выбранных пользователем параметров с возможностями просмотра в различном масштабе и контроля точных значений параметров в нужное время.

=== Журнал событий ===
[[Файл:AgavaCloud-Журнал событий.png|мини|Журнал событий]]
Журнал событий хранит события, регистрируемые в ходе работы оборудования и возникающие при обработке принимаемых данных по алгоритмам пользователя.

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

Для всех параметров возможно включение сигнализации по следующим алгоритмам:

* выход значения параметра за аварийные (НАУ/ВАУ) и (или) предупредительные (НПУ/ВПУ) пределы изменения;
* превышение заданной уставки или понижение значения параметра ниже уставки.

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

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

== Функциональные пакеты AgavaCloud ==
Функционал AgavaCloud доступен в трех пакетах - "бесплатный", "базовый" и "оптимальный".

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

{| class="wikitable"
|+
! Функция
! style="width:16%" | Бесплатный *1
! style="width:16%" | Базовый
! style="width:16%" | Оптимальный
! style="width:16%" | Максимальный
|-
|'''Устройства'''
| colspan="4" |
|-
|Типы подключаемых устройств
|Шлюзы АГАВА-СК
|Шлюзы АГАВА-СК,
[[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройства из списка]]
|Шлюзы АГАВА-СК,
[[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройства из списка]]
|Шлюзы АГАВА-СК,
[[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройства из списка]]
|-
|Количество подключаемых шлюзов
|не ограничено
|не ограничено
|не ограничено
|не ограничено
|-
|Количество подключаемых [[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройств других типов]]
|0
|1
|10
|не ограничено
|-
|Интервал опроса, с
|60
|15
|5
|1*2
|-
|'''Параметры'''
| colspan="4" |
|-
|Количество измеряемых параметров
|10
|100
|не ограничено
|не ограничено
|-
|Количество вычисляемых параметров
|×
|10
|не ограничено
|не ограничено
|-
|'''Экраны'''
| colspan="4" |
|-
|Экран "Панель"
| ●
| ●
| ●
|●
|-
|Экран "Таблица параметров"
| ●
| ●
| ●
|●
|-
|'''Архивы'''
| colspan="4" |
|-
|Количество архивов
| 1
| 5
| 10
|не ограничено
|-
|Минимальный интервал архивирования
| ×
|15 с
|5 с
|1 с
|-
|Максимальный период хранения архива
| 30 дней
|30 дней
|365 дней
|3650 дней
|-
|Высокоскоростное архивирование*3
| ×
| ×
| ×
|●
|-
|'''Журналы'''
| colspan="4" |
|-
|Журнал событий
| ●
|●
| ●
|●
|-
|Максимальный период хранения журнала
|30 дней
|30 дней
|365 дней
|3650 дней
|-
|'''Сигнализация'''
| colspan="3" |
|
|-
|Алгоритмы сигнализации
| colspan="4" |
|-
|Контроль НАУ/НПУ/ВПУ/ВАУ измеряемых параметров
|×
|×
| ●
|●
|-
|Контроль уставки
|×
|×
| ●
|●
|-
|Действия
| colspan="4" |
|-
|Регистрация события в журнале
|×
|×
| ●
|●
|-
|Запись значения в параметр
|×
|×
| ●
|●
|-
|Отправка сообщения в телеграм
|×
|×
| ●
|●
|-
|Отправка сообщения по электронной почте
|×
|×
|●
|●
|-
|'''Стоимость подписки, за месяц, рублей'''
|0
|1000
|3000
|8500
|}
Примечания:

*1 - при использовании со шлюзами АГАВА СК-01 или аналогичными производства КБ АГАВА.

*2 - типичное время, при наличии более быстродействующего оборудования интервал может быть меньше.

*3 - возможность архивирования данных чаще, чем осуществляется передача данных на сервер. Минимальный интервал высокоскоростного архивирования - 100 мс. В данный момент возможность не предоставляется.
[[Категория:AgavaCloud]]

Система облачной диспетчеризации AgavaCloud

2026-03-11T09:07:00Z

TaushkanovKV: /* Функциональные пакеты AgavaCloud */

AgavaCloud - облачная система диспетчеризации, предоставляющая следующие возможности:

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

== Сбор и регистрация данных ==
AgavaCloud поддерживает несколько способов сбора данных:

* Прямое подключение к устройствам, работающим по протоколам Modbus-TCP, MQTT(*), OPC-UA(*).
* Подключение к устройствам через шлюзы АГАВА СК-01, АГАВА СК-02 или программные шлюзы rtgw для ОС Windows или Linux.

(*) - возможность появится в ближайшей перспективе.

Прямое подключение к устройствам требует наличия постоянного "белого" IP-адреса и настроенного маршрутизатора, обеспечивающего вывод устройств в сеть Internet.

Подключение к устройствам через шлюзы АГАВА СК-01, АГАВА СК-02 '''не требует постоянного "белого" IP-адреса и маршрутизатора,''' возможно использование GSM/GPRS/LTE связи.

Регистрация данных производится с настраиваемой периодичностью. Время хранения зарегистрированных данных также настраивается

=== Подключение к устройствам с использованием шлюзов АГАВА СК-01, АГАВА СК-02 ===
Каждый шлюз имеет Уникальный Идентификационный Номер (УИН).

Для подключения оборудования через шлюз необходимо добавить его в свой "проект" AgavaCloud по УИН в разделе "Устройства". С этого момента шлюз доступен к использованию в облаке. Можно приступить к добавлению подчиненных устройств в шлюз.

=== Подключение устройств других типов ===

==== Устройства с протоколом Modbus-TCP ====
Подключаемое устройство должно быть доступно из сети Internet, для чего нужно выполнить настройку маршрутизатора, через который подключаемое устройство соединяется с Internet. Подключение маршрутизатора к сети Internet должно осуществляться через постоянный "белый" IP-адрес.

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

== Визуализация данных ==
AgavaCloud предоставляет возможности визуализации данных в следующих видах:

* Таблицы параметров.
* Экраны с виджетами.
* Графики.
* Журнал событий.
[[Файл:AgavaCloud-Параметры устройства.png|мини|Параметры устройства]]
=== Таблицы параметров ===
Просмотр значений параметров в виде таблицы.

=== Экраны с виджетами ===
Экран "Панель" настраиваемого пользователем вида, на котором размещаются различные виджеты, индицирующие параметры в виде цифровых индикаторов или небольших графиков.[[Файл:AgavaCloud-Архив1.png|мини|Графики в архиве AgavaCloud]]
=== Графики ===
Специализированный экран, содержащий графики выбранных пользователем параметров с возможностями просмотра в различном масштабе и контроля точных значений параметров в нужное время.

=== Журнал событий ===
[[Файл:AgavaCloud-Журнал событий.png|мини|Журнал событий]]
Журнал событий хранит события, регистрируемые в ходе работы оборудования и возникающие при обработке принимаемых данных по алгоритмам пользователя.

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

Для всех параметров возможно включение сигнализации по следующим алгоритмам:

* выход значения параметра за аварийные (НАУ/ВАУ) и (или) предупредительные (НПУ/ВПУ) пределы изменения;
* превышение заданной уставки или понижение значения параметра ниже уставки.

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

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

== Функциональные пакеты AgavaCloud ==
Функционал AgavaCloud доступен в трех пакетах - "бесплатный", "базовый" и "оптимальный".

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

{| class="wikitable"
|+
! Функция
! style="width:16%" | Бесплатный *1
! style="width:16%" | Базовый
! style="width:16%" | Оптимальный
! style="width:16%" | Максимальный
|-
|'''Устройства'''
| colspan="4" |
|-
|Типы подключаемых устройств
|Шлюзы АГАВА-СК
|Шлюзы АГАВА-СК,
[[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройства из списка]]
|Шлюзы АГАВА-СК,
[[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройства из списка]]
|Шлюзы АГАВА-СК,
[[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройства из списка]]
|-
|Количество подключаемых шлюзов
|не ограничено
|не ограничено
|не ограничено
|не ограничено
|-
|Количество подключаемых [[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройств других типов]]
|0
|1
|10
|не ограничено
|-
|Интервал опроса, с
|60
|15
|5
|1*2
|-
|'''Параметры'''
| colspan="4" |
|-
|Количество измеряемых параметров
|10
|100
|не ограничено
|не ограничено
|-
|Количество вычисляемых параметров
|×
|10
|не ограничено
|не ограничено
|-
|'''Экраны'''
| colspan="4" |
|-
|Экран "Панель"
| ●
| ●
| ●
|●
|-
|Экран "Таблица параметров"
| ●
| ●
| ●
|●
|-
|'''Архивы'''
| colspan="4" |
|-
|Количество архивов
| 1
| 5
| 10
|не ограничено
|-
|Минимальный интервал архивирования
| ×
|15 с
|5 с
|1 с
|-
|Максимальный период хранения архива
| ×
|30 дней
|365 дней
|3650 дней
|-
|Высокоскоростное архивирование*3
| ×
| ×
| ×
|●
|-
|'''Журналы'''
| colspan="4" |
|-
|Журнал событий
| ●
|●
| ●
|●
|-
|'''Сигнализация'''
| colspan="3" |
|
|-
|Алгоритмы сигнализации
| colspan="4" |
|-
|Контроль НАУ/НПУ/ВПУ/ВАУ измеряемых параметров
|×
|×
| ●
|●
|-
|Контроль уставки
|×
|×
| ●
|●
|-
|Действия
| colspan="4" |
|-
|Регистрация события в журнале
|×
|×
| ●
|●
|-
|Запись значения в параметр
|×
|×
| ●
|●
|-
|Отправка сообщения в телеграм
|×
|×
| ●
|●
|-
|Отправка сообщения по электронной почте
|×
|×
|●
|●
|-
|'''Стоимость подписки, за месяц, рублей'''
|0
|1000
|3000
|8500
|}
Примечания:

*1 - при использовании со шлюзами АГАВА СК-01 или аналогичными производства КБ АГАВА.

*2 - типичное время, при наличии более быстродействующего оборудования интервал может быть меньше.

*3 - возможность архивирования данных чаще, чем осуществляется передача данных на сервер. Минимальный интервал высокоскоростного архивирования - 100 мс. В данный момент возможность не предоставляется.
[[Категория:AgavaCloud]]

Система облачной диспетчеризации AgavaCloud

2026-03-11T09:02:42Z

TaushkanovKV: /* Функциональные пакеты AgavaCloud */

AgavaCloud - облачная система диспетчеризации, предоставляющая следующие возможности:

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

== Сбор и регистрация данных ==
AgavaCloud поддерживает несколько способов сбора данных:

* Прямое подключение к устройствам, работающим по протоколам Modbus-TCP, MQTT(*), OPC-UA(*).
* Подключение к устройствам через шлюзы АГАВА СК-01, АГАВА СК-02 или программные шлюзы rtgw для ОС Windows или Linux.

(*) - возможность появится в ближайшей перспективе.

Прямое подключение к устройствам требует наличия постоянного "белого" IP-адреса и настроенного маршрутизатора, обеспечивающего вывод устройств в сеть Internet.

Подключение к устройствам через шлюзы АГАВА СК-01, АГАВА СК-02 '''не требует постоянного "белого" IP-адреса и маршрутизатора,''' возможно использование GSM/GPRS/LTE связи.

Регистрация данных производится с настраиваемой периодичностью. Время хранения зарегистрированных данных также настраивается

=== Подключение к устройствам с использованием шлюзов АГАВА СК-01, АГАВА СК-02 ===
Каждый шлюз имеет Уникальный Идентификационный Номер (УИН).

Для подключения оборудования через шлюз необходимо добавить его в свой "проект" AgavaCloud по УИН в разделе "Устройства". С этого момента шлюз доступен к использованию в облаке. Можно приступить к добавлению подчиненных устройств в шлюз.

=== Подключение устройств других типов ===

==== Устройства с протоколом Modbus-TCP ====
Подключаемое устройство должно быть доступно из сети Internet, для чего нужно выполнить настройку маршрутизатора, через который подключаемое устройство соединяется с Internet. Подключение маршрутизатора к сети Internet должно осуществляться через постоянный "белый" IP-адрес.

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

== Визуализация данных ==
AgavaCloud предоставляет возможности визуализации данных в следующих видах:

* Таблицы параметров.
* Экраны с виджетами.
* Графики.
* Журнал событий.
[[Файл:AgavaCloud-Параметры устройства.png|мини|Параметры устройства]]
=== Таблицы параметров ===
Просмотр значений параметров в виде таблицы.

=== Экраны с виджетами ===
Экран "Панель" настраиваемого пользователем вида, на котором размещаются различные виджеты, индицирующие параметры в виде цифровых индикаторов или небольших графиков.[[Файл:AgavaCloud-Архив1.png|мини|Графики в архиве AgavaCloud]]
=== Графики ===
Специализированный экран, содержащий графики выбранных пользователем параметров с возможностями просмотра в различном масштабе и контроля точных значений параметров в нужное время.

=== Журнал событий ===
[[Файл:AgavaCloud-Журнал событий.png|мини|Журнал событий]]
Журнал событий хранит события, регистрируемые в ходе работы оборудования и возникающие при обработке принимаемых данных по алгоритмам пользователя.

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

Для всех параметров возможно включение сигнализации по следующим алгоритмам:

* выход значения параметра за аварийные (НАУ/ВАУ) и (или) предупредительные (НПУ/ВПУ) пределы изменения;
* превышение заданной уставки или понижение значения параметра ниже уставки.

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

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

== Функциональные пакеты AgavaCloud ==
Функционал AgavaCloud доступен в трех пакетах - "бесплатный", "базовый" и "оптимальный".

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

{| class="wikitable"
|+
! Функция
! style="width:16%" | Бесплатный *1
! style="width:16%" | Базовый
! style="width:16%" | Оптимальный
! style="width:16%" | Максимальный
|-
|'''Устройства'''
| colspan="4" |
|-
|Типы подключаемых устройств
|Шлюзы АГАВА-СК
|Шлюзы АГАВА-СК,
[[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройства из списка]]
|Шлюзы АГАВА-СК,
[[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройства из списка]]
|Шлюзы АГАВА-СК,
[[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройства из списка]]
|-
|Количество подключаемых шлюзов
|не ограничено
|не ограничено
|не ограничено
|не ограничено
|-
|Количество подключаемых устройств других типов
|0
|1
|10
|не ограничено
|-
|Интервал опроса, с
|60
|15
|5
|1*2
|-
|'''Параметры'''
| colspan="4" |
|-
|Количество измеряемых параметров
|10
|100
|не ограничено
|не ограничено
|-
|Количество вычисляемых параметров
|×
|10
|не ограничено
|не ограничено
|-
|'''Экраны'''
| colspan="4" |
|-
|Экран "Панель"
| ●
| ●
| ●
|●
|-
|Экран "Таблица параметров"
| ●
| ●
| ●
|●
|-
|'''Архивы'''
| colspan="4" |
|-
|Количество архивов
| 1
| 5
| 10
|не ограничено
|-
|Минимальный интервал архивирования
| ×
|15 с
|5 с
|1 с
|-
|Максимальный период хранения архива
| ×
|30 дней
|365 дней
|3650 дней
|-
|Высокоскоростное архивирование*3
| ×
| ×
| ×
|●
|-
|'''Журналы'''
| colspan="4" |
|-
|Журнал событий
| ●
|●
| ●
|●
|-
|'''Сигнализация'''
| colspan="3" |
|
|-
|Алгоритмы сигнализации
| colspan="4" |
|-
|Контроль НАУ/НПУ/ВПУ/ВАУ измеряемых параметров
|×
|×
| ●
|●
|-
|Контроль уставки
|×
|×
| ●
|●
|-
|Действия
| colspan="4" |
|-
|Регистрация события в журнале
|×
|×
| ●
|●
|-
|Запись значения в параметр
|×
|×
| ●
|●
|-
|Отправка сообщения в телеграм
|×
|×
| ●
|●
|-
|Отправка сообщения по электронной почте
|×
|×
|●
|●
|-
|'''Стоимость подписки, за месяц, рублей'''
|0
|1000
|3000
|8500
|}
Примечания:

*1 - при использовании со шлюзами АГАВА СК-01 или аналогичными производства КБ АГАВА.

*2 - типичное время, при наличии более быстродействующего оборудования интервал может быть меньше.

*3 - возможность архивирования данных чаще, чем осуществляется передача данных на сервер. Минимальный интервал высокоскоростного архивирования - 100 мс. В данный момент возможность не предоставляется.
[[Категория:AgavaCloud]]

Система облачной диспетчеризации AgavaCloud

2026-03-11T09:00:55Z

TaushkanovKV: /* Функциональные пакеты AgavaCloud */

AgavaCloud - облачная система диспетчеризации, предоставляющая следующие возможности:

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

== Сбор и регистрация данных ==
AgavaCloud поддерживает несколько способов сбора данных:

* Прямое подключение к устройствам, работающим по протоколам Modbus-TCP, MQTT(*), OPC-UA(*).
* Подключение к устройствам через шлюзы АГАВА СК-01, АГАВА СК-02 или программные шлюзы rtgw для ОС Windows или Linux.

(*) - возможность появится в ближайшей перспективе.

Прямое подключение к устройствам требует наличия постоянного "белого" IP-адреса и настроенного маршрутизатора, обеспечивающего вывод устройств в сеть Internet.

Подключение к устройствам через шлюзы АГАВА СК-01, АГАВА СК-02 '''не требует постоянного "белого" IP-адреса и маршрутизатора,''' возможно использование GSM/GPRS/LTE связи.

Регистрация данных производится с настраиваемой периодичностью. Время хранения зарегистрированных данных также настраивается

=== Подключение к устройствам с использованием шлюзов АГАВА СК-01, АГАВА СК-02 ===
Каждый шлюз имеет Уникальный Идентификационный Номер (УИН).

Для подключения оборудования через шлюз необходимо добавить его в свой "проект" AgavaCloud по УИН в разделе "Устройства". С этого момента шлюз доступен к использованию в облаке. Можно приступить к добавлению подчиненных устройств в шлюз.

=== Подключение устройств других типов ===

==== Устройства с протоколом Modbus-TCP ====
Подключаемое устройство должно быть доступно из сети Internet, для чего нужно выполнить настройку маршрутизатора, через который подключаемое устройство соединяется с Internet. Подключение маршрутизатора к сети Internet должно осуществляться через постоянный "белый" IP-адрес.

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

== Визуализация данных ==
AgavaCloud предоставляет возможности визуализации данных в следующих видах:

* Таблицы параметров.
* Экраны с виджетами.
* Графики.
* Журнал событий.
[[Файл:AgavaCloud-Параметры устройства.png|мини|Параметры устройства]]
=== Таблицы параметров ===
Просмотр значений параметров в виде таблицы.

=== Экраны с виджетами ===
Экран "Панель" настраиваемого пользователем вида, на котором размещаются различные виджеты, индицирующие параметры в виде цифровых индикаторов или небольших графиков.[[Файл:AgavaCloud-Архив1.png|мини|Графики в архиве AgavaCloud]]
=== Графики ===
Специализированный экран, содержащий графики выбранных пользователем параметров с возможностями просмотра в различном масштабе и контроля точных значений параметров в нужное время.

=== Журнал событий ===
[[Файл:AgavaCloud-Журнал событий.png|мини|Журнал событий]]
Журнал событий хранит события, регистрируемые в ходе работы оборудования и возникающие при обработке принимаемых данных по алгоритмам пользователя.

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

Для всех параметров возможно включение сигнализации по следующим алгоритмам:

* выход значения параметра за аварийные (НАУ/ВАУ) и (или) предупредительные (НПУ/ВПУ) пределы изменения;
* превышение заданной уставки или понижение значения параметра ниже уставки.

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

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

== Функциональные пакеты AgavaCloud ==
Функционал AgavaCloud доступен в трех пакетах - "бесплатный", "базовый" и "оптимальный".

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

{| class="wikitable"
|+
! Функция
! style="width:15%" | Бесплатный *1
! style="width:15%" | Базовый
! style="width:15%" | Оптимальный
!Максимальный
|-
|'''Устройства'''
| colspan="4" |
|-
|Типы подключаемых устройств
|Шлюзы АГАВА-СК
|Шлюзы АГАВА-СК,
[[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройства из списка]]
|Шлюзы АГАВА-СК,
[[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройства из списка]]
|Шлюзы АГАВА-СК,
[[Система облачной диспетчеризации AgavaCloud#Подключение устройств других типов|устройства из списка]]
|-
|Количество подключаемых шлюзов
|не ограничено
|не ограничено
|не ограничено
|не ограничено
|-
|Количество подключаемых устройств других типов
|0
|1
|10
|не ограничено
|-
|Интервал опроса, с
|60
|15
|5
|1*2
|-
|'''Параметры'''
| colspan="4" |
|-
|Количество измеряемых параметров
|10
|100
|не ограничено
|не ограничено
|-
|Количество вычисляемых параметров
|×
|10
|не ограничено
|не ограничено
|-
|'''Экраны'''
| colspan="4" |
|-
|Экран "Панель"
| ●
| ●
| ●
|●
|-
|Экран "Таблица параметров"
| ●
| ●
| ●
|●
|-
|'''Архивы'''
| colspan="4" |
|-
|Количество архивов
| 1
| 5
| 10
|не ограничено
|-
|Минимальный интервал архивирования
| ×
|15 с
|5 с
|1 с
|-
|Максимальный период хранения архива
| ×
|30 дней
|365 дней
|3650 дней
|-
|Высокоскоростное архивирование*3
| ×
| ×
| ×
|●
|-
|'''Журналы'''
| colspan="4" |
|-
|Журнал событий
| ●
|●
| ●
|●
|-
|'''Сигнализация'''
| colspan="3" |
|
|-
|Алгоритмы сигнализации
| colspan="4" |
|-
|Контроль НАУ/НПУ/ВПУ/ВАУ измеряемых параметров
|×
|×
| ●
|●
|-
|Контроль уставки
|×
|×
| ●
|●
|-
|Действия
| colspan="4" |
|-
|Регистрация события в журнале
|×
|×
| ●
|●
|-
|Запись значения в параметр
|×
|×
| ●
|●
|-
|Отправка сообщения в телеграм
|×
|×
| ●
|●
|-
|Отправка сообщения по электронной почте
|×
|×
|●
|●
|-
|'''Стоимость подписки, за месяц, рублей'''
|0
|1000
|3000
|8500
|}
Примечания:

*1 - при использовании со шлюзами АГАВА СК-01 или аналогичными производства КБ АГАВА.

*2 - типичное время, при наличии более быстродействующего оборудования интервал может быть меньше.

*3 - возможность архивирования данных чаще, чем осуществляется передача данных на сервер. Минимальный интервал высокоскоростного архивирования - 100 мс. В данный момент возможность не предоставляется.
[[Категория:AgavaCloud]]

Руководство по эксплуатации АГАВА СК-01

2026-03-11T08:32:40Z

TaushkanovKV: /* Системная утилита */

== Введение ==
Данное руководство по эксплуатации содержит сведения, необходимые для обеспечения правильной эксплуатации и полного использования технических возможностей сетевого шлюза АГАВА СК-01, далее по тексту: прибор, СК-01 или шлюз.

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

== Назначение ==

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

Подключение к внешним устройствам осуществляется через Ethernet, Wi-Fi, RS-485 (MODBUS-RTU);

=== Используемые термины и сокращения ===
ПК – персональный компьютер;

ОС – операционная система;

ПО – программное обеспечение;

ОЗУ – оперативное запоминающее устройство;

ФС – файловая система.

=== Условное обозначение прибора ===
Пример полного условного обозначения прибора:

* СК-01.1 – базовое исполнение;
* СК-01.2 – исполнение без GSM модема.

== Оснащение прибора ==

=== Состав прибора ===

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

На корпусе прибора установлены разъёмы для подключения внешних антенн.

На варианте исполнения СК-01.1 установлено 2 разъема для подключения антенн Wi-Fi и GSM (LTE) модема, СК-01.2 установлен 1 разъем для подключения антенны Wi-Fi.

В месте с прибором в зависимости от варианта исполнения поставляются одна (две) антенна(ы) с коэффициентом усиления 2dB.

В прибор СК-01.1 для работы GSM (LTE) модема устанавливается стандартная SIM-карта.

=== Конструкция Прибора ===
Габаритные размеры и позиционные обозначения компонентов Прибора приведены на рисунке ниже.
[[Файл:Views 1.png|без|мини|550x550пкс|Рисунок 1 - Габаритные размеры и позиционные обозначения СК-01]]Обозначение компонентов приведено в таблице ниже:
{| class="wikitable"
!Позиционное
обозначение
!Расшифровка
|-
|1
|GSM антенна
|-
|2
|Wi-Fi антенна
|-
|3
|Кнопка сброса настроек
|-
|4
|Место установки SIM карты
|-
|5
|Разъем подключения LAN
|-
|6
|Клемник подключения питания и RS-485
|-
|7
|Разъем подключения WAN
|-
|8
|Светодиодные индикаторы
|-
|9
|Переключатель для подключения встроенного терминального резистора RS-485
|-
|10
|Фиксатор прибора на DIN-рейке
|}

=== Технические характеристики ===
{| class="wikitable" style="width:75%"
|+

!№ п/п
! colspan="3" |Общие сведения
|-
|1
|Конструктивное исполнение
| colspan="2" |Моноблок на DIN-рейку
|-
|2
|Габаритные размеры (ВхШхГ), мм:
| colspan="2" |88 × 35 × 62

188 × 35 × 62 – с установленной антенной
|-
|3
|Масса прибора, не более, кг
| colspan="2" |0.120
|-
|4
|Степень защиты корпуса
| colspan="2" |IP20
|-
|5
|Напряжение питания
| colspan="2" |24 В ±10 % постоянного тока
|-
|6
|Потребляемая мощность, не более
| colspan="2" |12 Вт
|-
! colspan="4" |Интерфейсы подключения к AgavaCloud
|-
!style="width:3%" |
!style="width:13%" |
!style="width:20%" | АГАВА СК-01.1
!style="width:20%" | АГАВА СК-01.2
|-
|7
|Ethernet
| colspan="2" |WAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|8
|Wi-Fi
| colspan="2" |Режим "Клиент", стандарты 802.11 b/g/n, антенна внешняя.
Макс. чувствительность приемника 76 дБ, макс. мощность передатчика 21.1 дБ.

Тип разъема для антенны – SMA-F
|-
|9
|GSM
|1шт., GSM(LTE) - LTE CAT1 модуль, с поддержкой LTE-TDD/LTE-FDD.
Максимальная скорость загрузки 10Mbps, скорость передачи - 5Mbps.

Тип разъема для антенны – SMA-F

Стандартная mini-SIM карта с поддержкой всех операторов беспроводной связи
|Отсутствует
|-
! colspan="4" |Интерфейсы подключения устройств
|-
|10
|Ethernet
| colspan="2" |LAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|11
|RS-485
| colspan="2" |1шт. с гальванической развязкой, скорость до 115200 Mбит/с включительно
|-
! colspan="4" |Индикация и управление
|-
| rowspan="6" |12
| rowspan="6" |Индикация
| colspan="2" |Индикатор наличия питания - <code>POW</code>
|-
| colspan="2" |Индикатор состояния GSM модема - <code>GSM</code>
|-
| colspan="2" |Индикатор состояния WIFI - <code>WiFi</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейса RS-485 - <code>RX</code> <code>TX</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейсов Ethernet (на разъемах интерфейсов)
|-
| colspan="2" |Индикатор режима работы - <code>USR</code>
|-
|13
|Органы управления
| colspan="2" |Кнопка сброса, возврата к заводским установкам
|-
|14
|Переключатель
| colspan="2" |Включение и отключение терминального резистора
|}

== Условия эксплуатации ==
{| class="wikitable"
! colspan="2" |Условия эксплуатации
|-
|Тип помещения
|Закрытые взрывобезопасные помещения без агрессивных паров и газов
|-
|Температура окружающего воздуха
|От 0 до +50°С
|-
|Влажность воздуха
|Верхний предел относительной влажности воздуха 80% при +35°С и более низких температурах без конденсации влаги
|-
|Атмосферное давление
|От 86 до 107 кПа
|}

== Маркировка ==
На боковой панели прибора расположена наклейка с информацией о приборе:

* обозначение исполнения Прибора;
* заводской номер Прибора;
* уникальный идентификационный номер Прибора (УИН).

== Устройство и принцип работы прибора ==

=== Подготовка прибора к использованию ===

==== Общие указания ====
В зимнее время тару с прибором распаковывать в отапливаемом помещении не ранее чем через 4 часа после внесения их в помещение. Монтаж, эксплуатация и демонтаж СК-01 должны производиться персоналом, ознакомленным с правилами его эксплуатации и прошедшим инструктаж для работы с электрооборудованием в соответствии с правилами, установленными на предприятии-потребителе.

==== Указания мер безопасности ====
По способу защиты от поражения электрическим током CK-01 соответствует классу 0 по ГОСТ 12.2.007.0-75.

При эксплуатации и техническом обслуживании необходимо соблюдать требования ГОСТ 12.3.019-80, «Правил эксплуатации электроустановок потребителей» и «Правил охраны труда при эксплуатации электроустановок потребителей».

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

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

Установка и извлечение SIM-карты в сетевой шлюз АГАВА СК-01.1должна выполняться только при отключенном питании прибора.

==== Монтаж и подключение прибора ====
Прибор устанавливается на DIN-рейку 35мм. при помощи специального фиксатора (Рисунок 1, Позиция 10), расположенного в верхней части прибора.

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

Установку SIM-карты (Рисунок 1, Позиция 4) в сетевой шлюз АГАВА СК-01.1 производить до установки Прибора на DIN-рейку.

Установку антенн производить после установки прибора на DIN-рейку.

Подключаемые к прибору провода должны быть многожильными сечением от 0,25 до 0,5 мм2. Рекомендуемые типы кабелей МКШ, МКЭШ, МКШМ ГОСТ 10348-80.

Рекомендуется обжимать концы подключаемых проводов наконечниками типа НШВИ.

==== Подключение линий связи ====
Ниже приведены схемы подключения внешних устройств (блоков питания, линии RS-485 и Ethernet) к прибору.

===== Схема подключения питания =====
[[Файл:Power.png|мини|550x550px|Рисунок 2 - Схема подключения питания|альт=|без]]

===== Схема подключения линии RS-485 (без дренажного провода) =====
[[Файл:RS-485 NO DRAIN.png|без|мини|550x550px|Рисунок -3 Схема подключения линии RS-485 (без дренажного провода)|альт=]]

===== Схема подключения линии RS-485 (c дренажным проводом) =====
[[Файл:RS-485 with drain.png|без|мини|550x550px|Рисунок 4 - Схема подключения линии RS-485 (c дренажным проводом)|альт=]]Примечание''':''' для подключения встроенных терминальных резисторов RS-485 (120 Ом) необходимо перевести переключатель SW-1 (Рисунок 1, Позиция 9) в положение “ON” .

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

Для уменьшения влияния электромагнитных помех необходимо выполнять приведенные ниже рекомендации:

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

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

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

=== Интерфейсы прибора и их назначение ===
Прибор оснащен большим количеством интерфейсов передачи данных, имеющих разное назначение.

Интерфейсы связи с системой AgavaCloud:

# 3G-GSM.
# WAN.
# WIFI (клиент).

Интерфейсы для сбора данных с подключаемых устройств:

# LAN.
# RS-485.

Интерфейсы для настройки Прибора:

# LAN
# WIFI (точка доступа).

=== Состав программного обеспечения прибора ===
Программное обеспечение прибора состоит из следующих частей:

* Системное программное обеспечение.
* Прикладное программное обеспечение, обеспечивающее взаимодействие с AgavaCloud.

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

== Порядок работы с прибором ==
=== Первое включение и загрузка ===
[[Файл:АГАВАСК01-Циклограмма работы.png.png|мини|600x600пкс|Рисунок 5 - Циклограмма мигания индикатора USR]]
Подключите прибор к источнику питания +24В соблюдая полярность.

После подачи питания должен загореться индикатор питания “POW” и начаться инициализация. В процессе инициализации будет мигать светодиоды “Wi-Fi”, "USR", "GSM".

Светодиод "USR" индицирует текущий режим/этап работы Прибора с помощью мигания. Характер мигания светодиода в разных режимах показан на рис. 5.

Светодиод "GSM" отображает статус сети. Режимы мигания показаны на рис. 6.

[[Файл:АГАВАСК01-циклограмма-LED-индикатора-GSM.png|мини|599x599px|Рисунок 6 - Циклограмма мигания индикатора GSM|альт=]]

=== Режимы и этапы работы Прибора ===
После включения Прибор последовательно проходит через описываемые ниже режимы и этапы. Характер мигания светодиода в разных режимах показан на рис. 5.

# Режим <code>Подготовка</code>. Начинается после подачи питания.
## Этап <code>Инициализация</code>. Длительность этапа - примерно 10 с.
## Этап <code>Загрузка</code>. Длительность этапа - примерно 60-70 с.
## Этап <code>Окончание загрузки</code>. Длительность этапа - примерно 1-5 с.
# Режим <code>Работа</code>. Примерно через 70 секунд после включения прибор начинает обмен информацией с AgavaCloud, состоящий из следующих этапов:
## Этап <code>Подключение</code> к AgavaCloud. На этом этапе производится установление соединения с AgavaCloud. Длительность режима - примерно 1 с при настроенном подключении Прибора к сети Internet. При отсутствии подключения Прибор находится в данном режиме до установления подключения к AgavaCloud. Светодиод USR кратковременно зажигается (на 100 мс), далее гаснет на 900 мс, после чего цикл повторяется.
## Этап <code>Регистрация</code> в AgavaCloud. На этом этапе подключение к AgavaCloud установлено, прибор авторизуется в системе. После успешной регистрации прибор переходит к следующему этапу. На данном этапе светодиод USR делает два импульса по 100 мс с промежутком в 100 мс, далее гаснет на 700 мс, после чего цикл повторяется. Длительность режима - примерно 1 с. При наличии проблем с регистрацией Прибор находится в данном режиме до установления подключения к AgavaCloud
## Этап <code>Получение задания</code>. Длительность режима при наличии задания (то есть в каком-либо проекте задействован Прибор и для него определена конфигурация) - примерно 1 с, при отсутствии задания прибор находится в этом режиме до тех пор, пока не получит задание. На данном этапе светодиод USR делает три импульса по 100 мс с промежутком в 100 мс, далее гаснет на 500 мс, после чего цикл повторяется.
## Этап <code>Передача данных</code>. Основной этап, в котором находится прибор в нормальном состоянии (настроено подключение и прибор присутствует в каком-либо проекте в AgavaCloud). Светодиод USR попеременно зажигается и гаснет на 1 с.

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

Для настройки Прибора необходимо подключиться к нему одним из следующих способов:

* Кабельное подключение через Ethernet.
* Подключение к встроенной точке доступа WIFI.

==== Настройка Прибора через кабельное подключение через Ethernet ====

* Соедините кабелем Ethernet компьютер и порт LAN Прибора напрямую или через коммутатор.
* Убедитесь, что на компьютере в настройках сетевого адаптера имеется IP-адрес из сети <code>192.168.1.х</code>, например <code>192.168.1.88</code>, маска <code>255.255.255.0</code>.
* Откройте интернет-обозреватель и в адресной строке введите адрес: <code>192.168.1.1</code>. После загрузки прибора браузер автоматически откроет страницу системной утилиты.
* Введите логин и пароль, далее произведите настройку Прибора.

==== Настройка Прибора через Wi-Fi ====
Прибор оснащен модулем WIFI, по умолчанию настроенным на работу в режиме точки доступа, в котором возможно подключение к Прибору для его настройки.

Порядок подключения:
* Откройте на компьютере настройку беспроводных сетей и выполните поиск доступных Wi-Fi сетей, либо на смартфоне включите модуль WIFI и откройте окно выбора сети. В списке сетей должна появиться сеть c именем <code>AGAVA-SK01</code>.
* Подключите компьютер к сети <code>AGAVA-SK01</code>. Сеть <code>AGAVA-SK01</code> является открытой и не требует пароля и шифрования.
* После удачного подключения к <code>AGAVA-SK01</code> откройте интернет-обозреватель и в адресной строке введите адрес устройства: <code>192.168.2.1</code>. Браузер откроет страницу системной утилиты.

* Введите логин и пароль, далее произведите настройку Прибора.

=== Подключение Прибора к сети Internet ===
Для использования Прибора необходимо подключить его к сети Internet одним из следующих способов:

# Кабельное подключение через локальную сеть или напрямую к поставщику услуг сети Internet.
# WIFI подключение к существующей точке доступа.
# Беспроводное 3G/LTE соединение с Internet с помощью встроенного 3G/LTE модема.
{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Установку SIM-карты в Прибор необходимо производить при отключенном электропитании.}}{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Для передачи данных через беспроводное 3G/LTE соединение требуется приобретение у поставщика услуг связи тарифа на передачу данных, совместимого с роутерами}}

=== Настройка подключения Прибора к сети Internet ===
Настройка подключения Прибора к сети осуществляется с помощью встроенной системной утилиты, доступной через интерфейсы прибора LAN или WIFI (в режиме "Точка доступа").

=== Системная утилита ===
Системная утилита - встроенное в Прибор программное обеспечение, предназначенное для конфигурирования прибора и просмотра его параметров. Взаимодействие с системной утилитой осуществляется через браузер (обозреватель).

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

Настройте подключение к Прибору, как описано в разделе [[Руководство по эксплуатации АГАВА СК-01#Настройка Прибора|Настройка Прибора]].

Для авторизации используйте следующие реквизиты:

* имя пользователя — <code>web</code>
* пароль — <code>inc23.crffdswe</code>

После ввода реквизитов нажмите кнопку "Войти".
[[Файл:АГАВАСК01-Авторизация.png|мини|Авторизация при входе в системную утилиту|640x640px|альт=|центр]]

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

[[Файл:АГАВАСК01-Начальная-страница-обновленная.png|альт=|мини|640x640px|Главная страница системной утилиты|центр]]

На странице отображены, сверху вниз:

* полоса заголовка с названием Прибора, выпадающим списком перехода на другие страницы системной утилиты и ссылка "Выйти" для завершения работы с системной утилитой;
* интерфейсы Прибора, их состояние и кнопки управления интерфейсами;
* Кнопки "Применить" и "Сохранить" для сохранения внесенных изменений;
* "подвал" страницы с указанием названия системной утилиты и версии прошивки Прибора.
{{Внимание|Тип=Восклицание синий.png|Текст=Рекомендуется установить новый пароль для входа в системную утилиту. Для этого кликните по вкладке меню «Основные настройки», затем выберете пункт «Пароль сетевого шлюза», далее задайте новый пароль и подтвердите его. Для сохранения изменений нажмите кнопку «Сохранить».}}

==== Настройка сетевых интерфейсов ====

===== Интерфейс 3G-GSM =====

Если в Прибор установлена SIM карта, то после включения и загрузки устройства, на странице «Интерфейсы» в интерфейсе 3g-GSM будет отображен полученный IP-адрес предоставленный оператором связи, а также статистика обмена пакетами (RX) и (TX).[[Файл:АГАВАСК01-3G-Интерфейс.png|мини|640x640px|3g-GSM интерфейс, IP-адрес, статистика обмена пакетами|альт=|центр]]

{{Внимание|Тип=Восклицание синий.png|Текст=Настройку интерфейса 3g-GSM в большинстве случаев производить не требуется, так как она выполняется автоматически при запуске Прибора.}}

При необходимости настройки параметров интерфейса 3g-GSM нажмите кнопку «Изменить».

В открывшемся окне на вкладке «Основные настройки» в полях <code>APN</code>, <code>Имя пользователя</code>, <code>Пароль</code> введите нужные значения параметров.

Для примера ниже приведены настройки для доступа к сети интернет через оператора связи МТС:

* APN: internet.mts.ru.
* Имя пользователя: mts
* Пароль: mts.

[[Файл:АГАВАСК01-Настройка-GSM.png|мини|Настройка параметров интерфейса GSM|640x640px|альт=|центр]]

После внесения изменений нажмите кнопку «Сохранить», при этом автоматически будет выполнен переход на главную страницу. На главной странице отображается плашка "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ", сигнализирующая о внесенных в настройки прибора изменениях, но не принятых в работу.

[[Файл:АГАВАСК01-Главная страница-Изменения.png|альт=|центр|мини|639x639пкс|Начальная страница системной утилиты - внесены изменения в настройки, ожидается их применение]]
Для '''принятия внесенных изменений''' необходимо выполнить одно из двух действий:

* нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Применить";
* нажать на кнопку "Применить" в низу главной страницы, при этом подтверждение не запрашивается и изменения сразу применяются.

Для '''отмены внесенных изменений''' необходимо нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Вернуть".

===== Интерфейс LAN =====

Интерфейс LAN предназначен для сбора данных с подключаемых устройств и настройки самого Прибора.
[[Файл:АГАВАСК01-Интерфейс LAN.png|альт=|центр|мини|640x640пкс|Иинтерфейс LAN: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «LAN» нажмите кнопку «Изменить».

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

* выбор протокола (по умолчанию установлено в «Статический адрес»)
* задание IP адреса, маски сети и адреса шлюза.

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

[[Файл:АГАВАСК01-Настройка-интерфейса-lan.png|мини|640x640px|Настройка интерфейса lan|альт=|центр]]Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WAN =====
Интерфейс WAN предназначен для подключения к системе AgavaCloud.

[[Файл:АГАВАСК01-Интерфейс WAN.png|альт=|центр|мини|640x640пкс|Интерфейс WAN: IP-адрес, статистика обмена пакетами]]

Для настройки интерфейса «WAN» нажмите кнопку «Изменить».

В открывшемся окне отображен статус устройства, имеется возможность выбора режима (по умолчанию установлен режим «DHCP-клиент») и настройки параметров.

[[Файл:АГАВАСК01-Настройка-интерфейса-Wan.png|мини|640x640px|Настройка интерфейса WAN. По умолчанию включен режим DHCP клиент.|альт=|центр]]

Для настройки статического IP-адреса в поле «Режим» из выпадающего списка выберите пункт «Статический адрес», подтвердите выбор нажатием вновь появившейся кнопки «Изменить режим». Далее в полях «IPv4-адрес», «маска сети IPv4», «IPv4-адрес шлюза» внесите необходимые настройки и нажмите кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WAN-Настройка2.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WAN. Настройка режима "Статический адрес".]]

Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WIFI (клиент) =====

Интерфейс WIFI в режиме "Клиент" предназначен для подключения к системе AgavaCloud.
[[Файл:АГАВАСК01-Интерфейс WIFI.png|альт=|центр|мини|640x640пкс|Иинтерфейс WIFI: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «WIFI» нажмите кнопку «Изменить».

В открывшемся окне отображен статус интерфейса, имеются следующие возможности:

* выбор SSID (точки доступа) из списка обнаруженных;
* выбор режима и алгоритма шифрования;
* ввод ключа (пароля) для подключения к точке доступа.

После внесения изменений, необходимо нажать кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WIFI-Настройка.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WIFI (клиент)]]
Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].{{Внимание|Тип=Восклицание синий.png|Текст=При применении настроек WIFI будет выполнен перезапуск сетевых интерфейсов Прибора. Если настройка WIFI Прибора осуществляется со смартфона, то соединение смартфона и точки доступа Прибора будет разорвано и необходимо будет повторно подключиться к точке доступа AGAVA-SK01. При настройке WIFI через LAN таких разрывов нет.}}

==== Дополнительная настройка беспроводных подключений ====
Страница "Беспроводная сеть" системной утилиты позволяет выполнить дополнительные настройки беспроводной сети Прибора:

* Включать или отключать беспроводные интерфейсы WIFI (клиент) и WIFI (точка доступа).
* Изменять настройки собственной точки доступа, например пароль или SSID. Последнее актуально при использовании нескольких приборов с покрытием WIFI одной области.
* Просматривать список клиентов, подключенных к точке доступа и отключать их.

Для перехода к странице "Беспроводная сеть" выберите пункт «Беспроводная сеть» в меню «Основные настройки».

[[Файл:АГАВАСК01-Настройка-беспроводной-сети.png|мини|Страница "Беспроводная сеть"|640x640px|альт=|центр]]

===== Настройка собственной точки доступа (WIFI в режиме "точка доступа") =====
Для настройки собственной точки доступа необходимо на странице "Беспроводная сеть" в разделе «Список беспроводных сетей» нажать кнопку «Изменить» напротив беспроводной сети <code>AGAVA-SK01 | Режим: Master</code>.

В открывшемся окне можно изменить множество настроек точки. Наиболее востребованные параметры - SSID (имя точки), пароль.
После внесения изменений нужно нажать кнопку «Сохранить» в правом нижнем углу окна.
[[Файл:АГАВАСК01-Настройка-беспроводной-сети-в-режим-работы-точка-доступа.png|мини|686x686px|Настройка WIFI в режиме "Точка доступа"|альт=|центр]]Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

=== Использование Прибора с AgavaCloud ===

==== Регистрация Прибора в AgavaCloud ====
После настройки подключения Прибора к сети Internet необходимо зарегистрировать Прибор в своем проекте AgavaCloud. Регистрация выполняется следующим образом:

# Войдите в свой проект AgavaCloud.
# Откройте раздел <code>Устройства</code> вашего проекта.
# Добавьте устройство типа <code>Шлюз АГАВА СК-01</code> и введите в поле <code>Идентификатор</code> 16-значный УИН, указанный на шильдике, находящемся на корпусе Прибора.

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

==== Добавление подчиненных устройств ====
Прибор поддерживает опрос подчиненных устройств следующих типов:

* Устройства с протоколом Modbus-TCP.
* Устройства с протоколом Modbus-RTU.

===== Добавление устройств с протоколом Modbus-RTU =====
Для опроса Прибором устройств с протоколом Modbus-RTU необходимо в проекте AgavaCloud добавить в шлюз соответствующее устройство.

При заполнении настроек устройства необходимо указать адрес последовательного порта:<code>/dev/ttyS1</code>. Остальные настройки устанавливаются в соответствии с параметрами опрашиваемого устройства.

Дальнейшие операции по настройке проекта для передачи данных Прибора в AgavaCloud описаны на [[Система облачной диспетчеризации AgavaCloud|страницах описания AgavaCloud]].

== Обновление программного обеспечения АГАВА СК-01 ==
Прибор поставляется со всем необходимым установленным системным и прикладным программным обеспечением.

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

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

== Правила транспортирования и хранения ==
Прибор должен транспортироваться в упаковке при температуре от -30 °С до +80 °С и относительной влажности воздуха не более 95 % (при 35 °С).

Транспортирование допускается всеми видами закрытого транспорта.

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

Условия хранения прибора в транспортной таре на складе потребителя должны соответствовать условиям 1 по ГОСТ 15150-69.

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

== Техническое обслуживание ==
Прибор специального обслуживания не требует.

Периодически не реже чем раз в 6 месяцев проводить:

* осмотр прибора на внешние повреждения;
* соединения зажимных контактов;
* очистку прибора от пыли и грязи;
* качества крепления на DIN-рейке.

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

== Комплектность ==
{| class="wikitable"
|+
|№ п/п
|Наименование
|Количество,
шт.
|-
|1
|Сетевой шлюз АГАВА СК-01
|1
|-
|2
|Антенна Wi-Fi (2dB)
|1
|-
|3
|Антенна GSM (2dB) *
|1
|-
|4
|Паспорт
|1
|}
<nowiki>*</nowiki> Вариант исполнения с GSM модемом СК-01.1

== Гарантийные обязательства ==
Гарантийный срок эксплуатации – 12 месяцев со дня продажи.

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

Для отправки в ремонт необходимо вложить в тару с сетевым шлюзом АГАВА СК-01 паспорт, акт отказа и отправить по адресу:

620144, г. Екатеринбург, ул. Верещагина, д. 6а, ООО КБ «АГАВА»

Тел: (343) 382-01-92.

Руководство по эксплуатации АГАВА СК-01

2026-03-11T08:31:20Z

TaushkanovKV: /* Системная утилита */

== Введение ==
Данное руководство по эксплуатации содержит сведения, необходимые для обеспечения правильной эксплуатации и полного использования технических возможностей сетевого шлюза АГАВА СК-01, далее по тексту: прибор, СК-01 или шлюз.

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

== Назначение ==

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

Подключение к внешним устройствам осуществляется через Ethernet, Wi-Fi, RS-485 (MODBUS-RTU);

=== Используемые термины и сокращения ===
ПК – персональный компьютер;

ОС – операционная система;

ПО – программное обеспечение;

ОЗУ – оперативное запоминающее устройство;

ФС – файловая система.

=== Условное обозначение прибора ===
Пример полного условного обозначения прибора:

* СК-01.1 – базовое исполнение;
* СК-01.2 – исполнение без GSM модема.

== Оснащение прибора ==

=== Состав прибора ===

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

На корпусе прибора установлены разъёмы для подключения внешних антенн.

На варианте исполнения СК-01.1 установлено 2 разъема для подключения антенн Wi-Fi и GSM (LTE) модема, СК-01.2 установлен 1 разъем для подключения антенны Wi-Fi.

В месте с прибором в зависимости от варианта исполнения поставляются одна (две) антенна(ы) с коэффициентом усиления 2dB.

В прибор СК-01.1 для работы GSM (LTE) модема устанавливается стандартная SIM-карта.

=== Конструкция Прибора ===
Габаритные размеры и позиционные обозначения компонентов Прибора приведены на рисунке ниже.
[[Файл:Views 1.png|без|мини|550x550пкс|Рисунок 1 - Габаритные размеры и позиционные обозначения СК-01]]Обозначение компонентов приведено в таблице ниже:
{| class="wikitable"
!Позиционное
обозначение
!Расшифровка
|-
|1
|GSM антенна
|-
|2
|Wi-Fi антенна
|-
|3
|Кнопка сброса настроек
|-
|4
|Место установки SIM карты
|-
|5
|Разъем подключения LAN
|-
|6
|Клемник подключения питания и RS-485
|-
|7
|Разъем подключения WAN
|-
|8
|Светодиодные индикаторы
|-
|9
|Переключатель для подключения встроенного терминального резистора RS-485
|-
|10
|Фиксатор прибора на DIN-рейке
|}

=== Технические характеристики ===
{| class="wikitable" style="width:75%"
|+

!№ п/п
! colspan="3" |Общие сведения
|-
|1
|Конструктивное исполнение
| colspan="2" |Моноблок на DIN-рейку
|-
|2
|Габаритные размеры (ВхШхГ), мм:
| colspan="2" |88 × 35 × 62

188 × 35 × 62 – с установленной антенной
|-
|3
|Масса прибора, не более, кг
| colspan="2" |0.120
|-
|4
|Степень защиты корпуса
| colspan="2" |IP20
|-
|5
|Напряжение питания
| colspan="2" |24 В ±10 % постоянного тока
|-
|6
|Потребляемая мощность, не более
| colspan="2" |12 Вт
|-
! colspan="4" |Интерфейсы подключения к AgavaCloud
|-
!style="width:3%" |
!style="width:13%" |
!style="width:20%" | АГАВА СК-01.1
!style="width:20%" | АГАВА СК-01.2
|-
|7
|Ethernet
| colspan="2" |WAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|8
|Wi-Fi
| colspan="2" |Режим "Клиент", стандарты 802.11 b/g/n, антенна внешняя.
Макс. чувствительность приемника 76 дБ, макс. мощность передатчика 21.1 дБ.

Тип разъема для антенны – SMA-F
|-
|9
|GSM
|1шт., GSM(LTE) - LTE CAT1 модуль, с поддержкой LTE-TDD/LTE-FDD.
Максимальная скорость загрузки 10Mbps, скорость передачи - 5Mbps.

Тип разъема для антенны – SMA-F

Стандартная mini-SIM карта с поддержкой всех операторов беспроводной связи
|Отсутствует
|-
! colspan="4" |Интерфейсы подключения устройств
|-
|10
|Ethernet
| colspan="2" |LAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|11
|RS-485
| colspan="2" |1шт. с гальванической развязкой, скорость до 115200 Mбит/с включительно
|-
! colspan="4" |Индикация и управление
|-
| rowspan="6" |12
| rowspan="6" |Индикация
| colspan="2" |Индикатор наличия питания - <code>POW</code>
|-
| colspan="2" |Индикатор состояния GSM модема - <code>GSM</code>
|-
| colspan="2" |Индикатор состояния WIFI - <code>WiFi</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейса RS-485 - <code>RX</code> <code>TX</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейсов Ethernet (на разъемах интерфейсов)
|-
| colspan="2" |Индикатор режима работы - <code>USR</code>
|-
|13
|Органы управления
| colspan="2" |Кнопка сброса, возврата к заводским установкам
|-
|14
|Переключатель
| colspan="2" |Включение и отключение терминального резистора
|}

== Условия эксплуатации ==
{| class="wikitable"
! colspan="2" |Условия эксплуатации
|-
|Тип помещения
|Закрытые взрывобезопасные помещения без агрессивных паров и газов
|-
|Температура окружающего воздуха
|От 0 до +50°С
|-
|Влажность воздуха
|Верхний предел относительной влажности воздуха 80% при +35°С и более низких температурах без конденсации влаги
|-
|Атмосферное давление
|От 86 до 107 кПа
|}

== Маркировка ==
На боковой панели прибора расположена наклейка с информацией о приборе:

* обозначение исполнения Прибора;
* заводской номер Прибора;
* уникальный идентификационный номер Прибора (УИН).

== Устройство и принцип работы прибора ==

=== Подготовка прибора к использованию ===

==== Общие указания ====
В зимнее время тару с прибором распаковывать в отапливаемом помещении не ранее чем через 4 часа после внесения их в помещение. Монтаж, эксплуатация и демонтаж СК-01 должны производиться персоналом, ознакомленным с правилами его эксплуатации и прошедшим инструктаж для работы с электрооборудованием в соответствии с правилами, установленными на предприятии-потребителе.

==== Указания мер безопасности ====
По способу защиты от поражения электрическим током CK-01 соответствует классу 0 по ГОСТ 12.2.007.0-75.

При эксплуатации и техническом обслуживании необходимо соблюдать требования ГОСТ 12.3.019-80, «Правил эксплуатации электроустановок потребителей» и «Правил охраны труда при эксплуатации электроустановок потребителей».

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

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

Установка и извлечение SIM-карты в сетевой шлюз АГАВА СК-01.1должна выполняться только при отключенном питании прибора.

==== Монтаж и подключение прибора ====
Прибор устанавливается на DIN-рейку 35мм. при помощи специального фиксатора (Рисунок 1, Позиция 10), расположенного в верхней части прибора.

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

Установку SIM-карты (Рисунок 1, Позиция 4) в сетевой шлюз АГАВА СК-01.1 производить до установки Прибора на DIN-рейку.

Установку антенн производить после установки прибора на DIN-рейку.

Подключаемые к прибору провода должны быть многожильными сечением от 0,25 до 0,5 мм2. Рекомендуемые типы кабелей МКШ, МКЭШ, МКШМ ГОСТ 10348-80.

Рекомендуется обжимать концы подключаемых проводов наконечниками типа НШВИ.

==== Подключение линий связи ====
Ниже приведены схемы подключения внешних устройств (блоков питания, линии RS-485 и Ethernet) к прибору.

===== Схема подключения питания =====
[[Файл:Power.png|мини|550x550px|Рисунок 2 - Схема подключения питания|альт=|без]]

===== Схема подключения линии RS-485 (без дренажного провода) =====
[[Файл:RS-485 NO DRAIN.png|без|мини|550x550px|Рисунок -3 Схема подключения линии RS-485 (без дренажного провода)|альт=]]

===== Схема подключения линии RS-485 (c дренажным проводом) =====
[[Файл:RS-485 with drain.png|без|мини|550x550px|Рисунок 4 - Схема подключения линии RS-485 (c дренажным проводом)|альт=]]Примечание''':''' для подключения встроенных терминальных резисторов RS-485 (120 Ом) необходимо перевести переключатель SW-1 (Рисунок 1, Позиция 9) в положение “ON” .

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

Для уменьшения влияния электромагнитных помех необходимо выполнять приведенные ниже рекомендации:

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

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

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

=== Интерфейсы прибора и их назначение ===
Прибор оснащен большим количеством интерфейсов передачи данных, имеющих разное назначение.

Интерфейсы связи с системой AgavaCloud:

# 3G-GSM.
# WAN.
# WIFI (клиент).

Интерфейсы для сбора данных с подключаемых устройств:

# LAN.
# RS-485.

Интерфейсы для настройки Прибора:

# LAN
# WIFI (точка доступа).

=== Состав программного обеспечения прибора ===
Программное обеспечение прибора состоит из следующих частей:

* Системное программное обеспечение.
* Прикладное программное обеспечение, обеспечивающее взаимодействие с AgavaCloud.

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

== Порядок работы с прибором ==
=== Первое включение и загрузка ===
[[Файл:АГАВАСК01-Циклограмма работы.png.png|мини|600x600пкс|Рисунок 5 - Циклограмма мигания индикатора USR]]
Подключите прибор к источнику питания +24В соблюдая полярность.

После подачи питания должен загореться индикатор питания “POW” и начаться инициализация. В процессе инициализации будет мигать светодиоды “Wi-Fi”, "USR", "GSM".

Светодиод "USR" индицирует текущий режим/этап работы Прибора с помощью мигания. Характер мигания светодиода в разных режимах показан на рис. 5.

Светодиод "GSM" отображает статус сети. Режимы мигания показаны на рис. 6.

[[Файл:АГАВАСК01-циклограмма-LED-индикатора-GSM.png|мини|599x599px|Рисунок 6 - Циклограмма мигания индикатора GSM|альт=]]

=== Режимы и этапы работы Прибора ===
После включения Прибор последовательно проходит через описываемые ниже режимы и этапы. Характер мигания светодиода в разных режимах показан на рис. 5.

# Режим <code>Подготовка</code>. Начинается после подачи питания.
## Этап <code>Инициализация</code>. Длительность этапа - примерно 10 с.
## Этап <code>Загрузка</code>. Длительность этапа - примерно 60-70 с.
## Этап <code>Окончание загрузки</code>. Длительность этапа - примерно 1-5 с.
# Режим <code>Работа</code>. Примерно через 70 секунд после включения прибор начинает обмен информацией с AgavaCloud, состоящий из следующих этапов:
## Этап <code>Подключение</code> к AgavaCloud. На этом этапе производится установление соединения с AgavaCloud. Длительность режима - примерно 1 с при настроенном подключении Прибора к сети Internet. При отсутствии подключения Прибор находится в данном режиме до установления подключения к AgavaCloud. Светодиод USR кратковременно зажигается (на 100 мс), далее гаснет на 900 мс, после чего цикл повторяется.
## Этап <code>Регистрация</code> в AgavaCloud. На этом этапе подключение к AgavaCloud установлено, прибор авторизуется в системе. После успешной регистрации прибор переходит к следующему этапу. На данном этапе светодиод USR делает два импульса по 100 мс с промежутком в 100 мс, далее гаснет на 700 мс, после чего цикл повторяется. Длительность режима - примерно 1 с. При наличии проблем с регистрацией Прибор находится в данном режиме до установления подключения к AgavaCloud
## Этап <code>Получение задания</code>. Длительность режима при наличии задания (то есть в каком-либо проекте задействован Прибор и для него определена конфигурация) - примерно 1 с, при отсутствии задания прибор находится в этом режиме до тех пор, пока не получит задание. На данном этапе светодиод USR делает три импульса по 100 мс с промежутком в 100 мс, далее гаснет на 500 мс, после чего цикл повторяется.
## Этап <code>Передача данных</code>. Основной этап, в котором находится прибор в нормальном состоянии (настроено подключение и прибор присутствует в каком-либо проекте в AgavaCloud). Светодиод USR попеременно зажигается и гаснет на 1 с.

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

Для настройки Прибора необходимо подключиться к нему одним из следующих способов:

* Кабельное подключение через Ethernet.
* Подключение к встроенной точке доступа WIFI.

==== Настройка Прибора через кабельное подключение через Ethernet ====

* Соедините кабелем Ethernet компьютер и порт LAN Прибора напрямую или через коммутатор.
* Убедитесь, что на компьютере в настройках сетевого адаптера имеется IP-адрес из сети <code>192.168.1.х</code>, например <code>192.168.1.88</code>, маска <code>255.255.255.0</code>.
* Откройте интернет-обозреватель и в адресной строке введите адрес: <code>192.168.1.1</code>. После загрузки прибора браузер автоматически откроет страницу системной утилиты.
* Введите логин и пароль, далее произведите настройку Прибора.

==== Настройка Прибора через Wi-Fi ====
Прибор оснащен модулем WIFI, по умолчанию настроенным на работу в режиме точки доступа, в котором возможно подключение к Прибору для его настройки.

Порядок подключения:
* Откройте на компьютере настройку беспроводных сетей и выполните поиск доступных Wi-Fi сетей, либо на смартфоне включите модуль WIFI и откройте окно выбора сети. В списке сетей должна появиться сеть c именем <code>AGAVA-SK01</code>.
* Подключите компьютер к сети <code>AGAVA-SK01</code>. Сеть <code>AGAVA-SK01</code> является открытой и не требует пароля и шифрования.
* После удачного подключения к <code>AGAVA-SK01</code> откройте интернет-обозреватель и в адресной строке введите адрес устройства: <code>192.168.2.1</code>. Браузер откроет страницу системной утилиты.

* Введите логин и пароль, далее произведите настройку Прибора.

=== Подключение Прибора к сети Internet ===
Для использования Прибора необходимо подключить его к сети Internet одним из следующих способов:

# Кабельное подключение через локальную сеть или напрямую к поставщику услуг сети Internet.
# WIFI подключение к существующей точке доступа.
# Беспроводное 3G/LTE соединение с Internet с помощью встроенного 3G/LTE модема.
{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Установку SIM-карты в Прибор необходимо производить при отключенном электропитании.}}{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Для передачи данных через беспроводное 3G/LTE соединение требуется приобретение у поставщика услуг связи тарифа на передачу данных, совместимого с роутерами}}

=== Настройка подключения Прибора к сети Internet ===
Настройка подключения Прибора к сети осуществляется с помощью встроенной системной утилиты, доступной через интерфейсы прибора LAN или WIFI (в режиме "Точка доступа").

=== Системная утилита ===
Системная утилита - встроенное в Прибор программное обеспечение, предназначенное для конфигурирования прибора и просмотра его параметров. Взаимодействие с системной утилитой осуществляется через браузер (обозреватель).

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

Настройте подключение к Прибору, как описано в разделе [[Руководство по эксплуатации АГАВА СК-01#Настройка Прибора|Настройка Прибора]].

Для авторизации используйте следующие реквизиты:

* имя пользователя — <code>web</code>
* пароль — <code>inc23.crffdswe</code>

После ввода реквизитов нажмите кнопку "Войти".
[[Файл:АГАВАСК01-Авторизация.png|мини|АГАВА СК-01-Авторизация|640x640px|альт=|центр]]

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

[[Файл:АГАВАСК01-Начальная-страница-обновленная.png|альт=|мини|640x640px|Начальная страница системной утилиты|центр]]

На странице отображены, сверху вниз:

* полоса заголовка с названием Прибора, выпадающим списком перехода на другие страницы системной утилиты и ссылка "Выйти" для завершения работы с системной утилитой;
* интерфейсы Прибора, их состояние и кнопки управления интерфейсами;
* Кнопки "Применить" и "Сохранить" для сохранения внесенных изменений;
* "подвал" страницы с указанием названия системной утилиты и версии прошивки Прибора.
{{Внимание|Тип=Восклицание синий.png|Текст=Рекомендуется установить новый пароль для входа в системную утилиту. Для этого кликните по вкладке меню «Основные настройки», затем выберете пункт «Пароль сетевого шлюза», далее задайте новый пароль и подтвердите его. Для сохранения изменений нажмите кнопку «Сохранить».}}

==== Настройка сетевых интерфейсов ====

===== Интерфейс 3G-GSM =====

Если в Прибор установлена SIM карта, то после включения и загрузки устройства, на странице «Интерфейсы» в интерфейсе 3g-GSM будет отображен полученный IP-адрес предоставленный оператором связи, а также статистика обмена пакетами (RX) и (TX).[[Файл:АГАВАСК01-3G-Интерфейс.png|мини|640x640px|3g-GSM интерфейс, IP-адрес, статистика обмена пакетами|альт=|центр]]

{{Внимание|Тип=Восклицание синий.png|Текст=Настройку интерфейса 3g-GSM в большинстве случаев производить не требуется, так как она выполняется автоматически при запуске Прибора.}}

При необходимости настройки параметров интерфейса 3g-GSM нажмите кнопку «Изменить».

В открывшемся окне на вкладке «Основные настройки» в полях <code>APN</code>, <code>Имя пользователя</code>, <code>Пароль</code> введите нужные значения параметров.

Для примера ниже приведены настройки для доступа к сети интернет через оператора связи МТС:

* APN: internet.mts.ru.
* Имя пользователя: mts
* Пароль: mts.

[[Файл:АГАВАСК01-Настройка-GSM.png|мини|Настройка параметров интерфейса GSM|640x640px|альт=|центр]]

После внесения изменений нажмите кнопку «Сохранить», при этом автоматически будет выполнен переход на главную страницу. На главной странице отображается плашка "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ", сигнализирующая о внесенных в настройки прибора изменениях, но не принятых в работу.

[[Файл:АГАВАСК01-Главная страница-Изменения.png|альт=|центр|мини|639x639пкс|Начальная страница системной утилиты - внесены изменения в настройки, ожидается их применение]]
Для '''принятия внесенных изменений''' необходимо выполнить одно из двух действий:

* нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Применить";
* нажать на кнопку "Применить" в низу главной страницы, при этом подтверждение не запрашивается и изменения сразу применяются.

Для '''отмены внесенных изменений''' необходимо нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Вернуть".

===== Интерфейс LAN =====

Интерфейс LAN предназначен для сбора данных с подключаемых устройств и настройки самого Прибора.
[[Файл:АГАВАСК01-Интерфейс LAN.png|альт=|центр|мини|640x640пкс|Иинтерфейс LAN: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «LAN» нажмите кнопку «Изменить».

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

* выбор протокола (по умолчанию установлено в «Статический адрес»)
* задание IP адреса, маски сети и адреса шлюза.

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

[[Файл:АГАВАСК01-Настройка-интерфейса-lan.png|мини|640x640px|Настройка интерфейса lan|альт=|центр]]Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WAN =====
Интерфейс WAN предназначен для подключения к системе AgavaCloud.

[[Файл:АГАВАСК01-Интерфейс WAN.png|альт=|центр|мини|640x640пкс|Интерфейс WAN: IP-адрес, статистика обмена пакетами]]

Для настройки интерфейса «WAN» нажмите кнопку «Изменить».

В открывшемся окне отображен статус устройства, имеется возможность выбора режима (по умолчанию установлен режим «DHCP-клиент») и настройки параметров.

[[Файл:АГАВАСК01-Настройка-интерфейса-Wan.png|мини|640x640px|Настройка интерфейса WAN. По умолчанию включен режим DHCP клиент.|альт=|центр]]

Для настройки статического IP-адреса в поле «Режим» из выпадающего списка выберите пункт «Статический адрес», подтвердите выбор нажатием вновь появившейся кнопки «Изменить режим». Далее в полях «IPv4-адрес», «маска сети IPv4», «IPv4-адрес шлюза» внесите необходимые настройки и нажмите кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WAN-Настройка2.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WAN. Настройка режима "Статический адрес".]]

Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WIFI (клиент) =====

Интерфейс WIFI в режиме "Клиент" предназначен для подключения к системе AgavaCloud.
[[Файл:АГАВАСК01-Интерфейс WIFI.png|альт=|центр|мини|640x640пкс|Иинтерфейс WIFI: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «WIFI» нажмите кнопку «Изменить».

В открывшемся окне отображен статус интерфейса, имеются следующие возможности:

* выбор SSID (точки доступа) из списка обнаруженных;
* выбор режима и алгоритма шифрования;
* ввод ключа (пароля) для подключения к точке доступа.

После внесения изменений, необходимо нажать кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WIFI-Настройка.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WIFI (клиент)]]
Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].{{Внимание|Тип=Восклицание синий.png|Текст=При применении настроек WIFI будет выполнен перезапуск сетевых интерфейсов Прибора. Если настройка WIFI Прибора осуществляется со смартфона, то соединение смартфона и точки доступа Прибора будет разорвано и необходимо будет повторно подключиться к точке доступа AGAVA-SK01. При настройке WIFI через LAN таких разрывов нет.}}

==== Дополнительная настройка беспроводных подключений ====
Страница "Беспроводная сеть" системной утилиты позволяет выполнить дополнительные настройки беспроводной сети Прибора:

* Включать или отключать беспроводные интерфейсы WIFI (клиент) и WIFI (точка доступа).
* Изменять настройки собственной точки доступа, например пароль или SSID. Последнее актуально при использовании нескольких приборов с покрытием WIFI одной области.
* Просматривать список клиентов, подключенных к точке доступа и отключать их.

Для перехода к странице "Беспроводная сеть" выберите пункт «Беспроводная сеть» в меню «Основные настройки».

[[Файл:АГАВАСК01-Настройка-беспроводной-сети.png|мини|Страница "Беспроводная сеть"|640x640px|альт=|центр]]

===== Настройка собственной точки доступа (WIFI в режиме "точка доступа") =====
Для настройки собственной точки доступа необходимо на странице "Беспроводная сеть" в разделе «Список беспроводных сетей» нажать кнопку «Изменить» напротив беспроводной сети <code>AGAVA-SK01 | Режим: Master</code>.

В открывшемся окне можно изменить множество настроек точки. Наиболее востребованные параметры - SSID (имя точки), пароль.
После внесения изменений нужно нажать кнопку «Сохранить» в правом нижнем углу окна.
[[Файл:АГАВАСК01-Настройка-беспроводной-сети-в-режим-работы-точка-доступа.png|мини|686x686px|Настройка WIFI в режиме "Точка доступа"|альт=|центр]]Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

=== Использование Прибора с AgavaCloud ===

==== Регистрация Прибора в AgavaCloud ====
После настройки подключения Прибора к сети Internet необходимо зарегистрировать Прибор в своем проекте AgavaCloud. Регистрация выполняется следующим образом:

# Войдите в свой проект AgavaCloud.
# Откройте раздел <code>Устройства</code> вашего проекта.
# Добавьте устройство типа <code>Шлюз АГАВА СК-01</code> и введите в поле <code>Идентификатор</code> 16-значный УИН, указанный на шильдике, находящемся на корпусе Прибора.

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

==== Добавление подчиненных устройств ====
Прибор поддерживает опрос подчиненных устройств следующих типов:

* Устройства с протоколом Modbus-TCP.
* Устройства с протоколом Modbus-RTU.

===== Добавление устройств с протоколом Modbus-RTU =====
Для опроса Прибором устройств с протоколом Modbus-RTU необходимо в проекте AgavaCloud добавить в шлюз соответствующее устройство.

При заполнении настроек устройства необходимо указать адрес последовательного порта:<code>/dev/ttyS1</code>. Остальные настройки устанавливаются в соответствии с параметрами опрашиваемого устройства.

Дальнейшие операции по настройке проекта для передачи данных Прибора в AgavaCloud описаны на [[Система облачной диспетчеризации AgavaCloud|страницах описания AgavaCloud]].

== Обновление программного обеспечения АГАВА СК-01 ==
Прибор поставляется со всем необходимым установленным системным и прикладным программным обеспечением.

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

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

== Правила транспортирования и хранения ==
Прибор должен транспортироваться в упаковке при температуре от -30 °С до +80 °С и относительной влажности воздуха не более 95 % (при 35 °С).

Транспортирование допускается всеми видами закрытого транспорта.

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

Условия хранения прибора в транспортной таре на складе потребителя должны соответствовать условиям 1 по ГОСТ 15150-69.

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

== Техническое обслуживание ==
Прибор специального обслуживания не требует.

Периодически не реже чем раз в 6 месяцев проводить:

* осмотр прибора на внешние повреждения;
* соединения зажимных контактов;
* очистку прибора от пыли и грязи;
* качества крепления на DIN-рейке.

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

== Комплектность ==
{| class="wikitable"
|+
|№ п/п
|Наименование
|Количество,
шт.
|-
|1
|Сетевой шлюз АГАВА СК-01
|1
|-
|2
|Антенна Wi-Fi (2dB)
|1
|-
|3
|Антенна GSM (2dB) *
|1
|-
|4
|Паспорт
|1
|}
<nowiki>*</nowiki> Вариант исполнения с GSM модемом СК-01.1

== Гарантийные обязательства ==
Гарантийный срок эксплуатации – 12 месяцев со дня продажи.

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

Для отправки в ремонт необходимо вложить в тару с сетевым шлюзом АГАВА СК-01 паспорт, акт отказа и отправить по адресу:

620144, г. Екатеринбург, ул. Верещагина, д. 6а, ООО КБ «АГАВА»

Тел: (343) 382-01-92.

Руководство по эксплуатации АГАВА СК-01

2026-03-11T08:28:20Z

TaushkanovKV: /* Системная утилита */

== Введение ==
Данное руководство по эксплуатации содержит сведения, необходимые для обеспечения правильной эксплуатации и полного использования технических возможностей сетевого шлюза АГАВА СК-01, далее по тексту: прибор, СК-01 или шлюз.

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

== Назначение ==

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

Подключение к внешним устройствам осуществляется через Ethernet, Wi-Fi, RS-485 (MODBUS-RTU);

=== Используемые термины и сокращения ===
ПК – персональный компьютер;

ОС – операционная система;

ПО – программное обеспечение;

ОЗУ – оперативное запоминающее устройство;

ФС – файловая система.

=== Условное обозначение прибора ===
Пример полного условного обозначения прибора:

* СК-01.1 – базовое исполнение;
* СК-01.2 – исполнение без GSM модема.

== Оснащение прибора ==

=== Состав прибора ===

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

На корпусе прибора установлены разъёмы для подключения внешних антенн.

На варианте исполнения СК-01.1 установлено 2 разъема для подключения антенн Wi-Fi и GSM (LTE) модема, СК-01.2 установлен 1 разъем для подключения антенны Wi-Fi.

В месте с прибором в зависимости от варианта исполнения поставляются одна (две) антенна(ы) с коэффициентом усиления 2dB.

В прибор СК-01.1 для работы GSM (LTE) модема устанавливается стандартная SIM-карта.

=== Конструкция Прибора ===
Габаритные размеры и позиционные обозначения компонентов Прибора приведены на рисунке ниже.
[[Файл:Views 1.png|без|мини|550x550пкс|Рисунок 1 - Габаритные размеры и позиционные обозначения СК-01]]Обозначение компонентов приведено в таблице ниже:
{| class="wikitable"
!Позиционное
обозначение
!Расшифровка
|-
|1
|GSM антенна
|-
|2
|Wi-Fi антенна
|-
|3
|Кнопка сброса настроек
|-
|4
|Место установки SIM карты
|-
|5
|Разъем подключения LAN
|-
|6
|Клемник подключения питания и RS-485
|-
|7
|Разъем подключения WAN
|-
|8
|Светодиодные индикаторы
|-
|9
|Переключатель для подключения встроенного терминального резистора RS-485
|-
|10
|Фиксатор прибора на DIN-рейке
|}

=== Технические характеристики ===
{| class="wikitable" style="width:75%"
|+

!№ п/п
! colspan="3" |Общие сведения
|-
|1
|Конструктивное исполнение
| colspan="2" |Моноблок на DIN-рейку
|-
|2
|Габаритные размеры (ВхШхГ), мм:
| colspan="2" |88 × 35 × 62

188 × 35 × 62 – с установленной антенной
|-
|3
|Масса прибора, не более, кг
| colspan="2" |0.120
|-
|4
|Степень защиты корпуса
| colspan="2" |IP20
|-
|5
|Напряжение питания
| colspan="2" |24 В ±10 % постоянного тока
|-
|6
|Потребляемая мощность, не более
| colspan="2" |12 Вт
|-
! colspan="4" |Интерфейсы подключения к AgavaCloud
|-
!style="width:3%" |
!style="width:13%" |
!style="width:20%" | АГАВА СК-01.1
!style="width:20%" | АГАВА СК-01.2
|-
|7
|Ethernet
| colspan="2" |WAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|8
|Wi-Fi
| colspan="2" |Режим "Клиент", стандарты 802.11 b/g/n, антенна внешняя.
Макс. чувствительность приемника 76 дБ, макс. мощность передатчика 21.1 дБ.

Тип разъема для антенны – SMA-F
|-
|9
|GSM
|1шт., GSM(LTE) - LTE CAT1 модуль, с поддержкой LTE-TDD/LTE-FDD.
Максимальная скорость загрузки 10Mbps, скорость передачи - 5Mbps.

Тип разъема для антенны – SMA-F

Стандартная mini-SIM карта с поддержкой всех операторов беспроводной связи
|Отсутствует
|-
! colspan="4" |Интерфейсы подключения устройств
|-
|10
|Ethernet
| colspan="2" |LAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|11
|RS-485
| colspan="2" |1шт. с гальванической развязкой, скорость до 115200 Mбит/с включительно
|-
! colspan="4" |Индикация и управление
|-
| rowspan="6" |12
| rowspan="6" |Индикация
| colspan="2" |Индикатор наличия питания - <code>POW</code>
|-
| colspan="2" |Индикатор состояния GSM модема - <code>GSM</code>
|-
| colspan="2" |Индикатор состояния WIFI - <code>WiFi</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейса RS-485 - <code>RX</code> <code>TX</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейсов Ethernet (на разъемах интерфейсов)
|-
| colspan="2" |Индикатор режима работы - <code>USR</code>
|-
|13
|Органы управления
| colspan="2" |Кнопка сброса, возврата к заводским установкам
|-
|14
|Переключатель
| colspan="2" |Включение и отключение терминального резистора
|}

== Условия эксплуатации ==
{| class="wikitable"
! colspan="2" |Условия эксплуатации
|-
|Тип помещения
|Закрытые взрывобезопасные помещения без агрессивных паров и газов
|-
|Температура окружающего воздуха
|От 0 до +50°С
|-
|Влажность воздуха
|Верхний предел относительной влажности воздуха 80% при +35°С и более низких температурах без конденсации влаги
|-
|Атмосферное давление
|От 86 до 107 кПа
|}

== Маркировка ==
На боковой панели прибора расположена наклейка с информацией о приборе:

* обозначение исполнения Прибора;
* заводской номер Прибора;
* уникальный идентификационный номер Прибора (УИН).

== Устройство и принцип работы прибора ==

=== Подготовка прибора к использованию ===

==== Общие указания ====
В зимнее время тару с прибором распаковывать в отапливаемом помещении не ранее чем через 4 часа после внесения их в помещение. Монтаж, эксплуатация и демонтаж СК-01 должны производиться персоналом, ознакомленным с правилами его эксплуатации и прошедшим инструктаж для работы с электрооборудованием в соответствии с правилами, установленными на предприятии-потребителе.

==== Указания мер безопасности ====
По способу защиты от поражения электрическим током CK-01 соответствует классу 0 по ГОСТ 12.2.007.0-75.

При эксплуатации и техническом обслуживании необходимо соблюдать требования ГОСТ 12.3.019-80, «Правил эксплуатации электроустановок потребителей» и «Правил охраны труда при эксплуатации электроустановок потребителей».

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

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

Установка и извлечение SIM-карты в сетевой шлюз АГАВА СК-01.1должна выполняться только при отключенном питании прибора.

==== Монтаж и подключение прибора ====
Прибор устанавливается на DIN-рейку 35мм. при помощи специального фиксатора (Рисунок 1, Позиция 10), расположенного в верхней части прибора.

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

Установку SIM-карты (Рисунок 1, Позиция 4) в сетевой шлюз АГАВА СК-01.1 производить до установки Прибора на DIN-рейку.

Установку антенн производить после установки прибора на DIN-рейку.

Подключаемые к прибору провода должны быть многожильными сечением от 0,25 до 0,5 мм2. Рекомендуемые типы кабелей МКШ, МКЭШ, МКШМ ГОСТ 10348-80.

Рекомендуется обжимать концы подключаемых проводов наконечниками типа НШВИ.

==== Подключение линий связи ====
Ниже приведены схемы подключения внешних устройств (блоков питания, линии RS-485 и Ethernet) к прибору.

===== Схема подключения питания =====
[[Файл:Power.png|мини|550x550px|Рисунок 2 - Схема подключения питания|альт=|без]]

===== Схема подключения линии RS-485 (без дренажного провода) =====
[[Файл:RS-485 NO DRAIN.png|без|мини|550x550px|Рисунок -3 Схема подключения линии RS-485 (без дренажного провода)|альт=]]

===== Схема подключения линии RS-485 (c дренажным проводом) =====
[[Файл:RS-485 with drain.png|без|мини|550x550px|Рисунок 4 - Схема подключения линии RS-485 (c дренажным проводом)|альт=]]Примечание''':''' для подключения встроенных терминальных резисторов RS-485 (120 Ом) необходимо перевести переключатель SW-1 (Рисунок 1, Позиция 9) в положение “ON” .

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

Для уменьшения влияния электромагнитных помех необходимо выполнять приведенные ниже рекомендации:

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

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

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

=== Интерфейсы прибора и их назначение ===
Прибор оснащен большим количеством интерфейсов передачи данных, имеющих разное назначение.

Интерфейсы связи с системой AgavaCloud:

# 3G-GSM.
# WAN.
# WIFI (клиент).

Интерфейсы для сбора данных с подключаемых устройств:

# LAN.
# RS-485.

Интерфейсы для настройки Прибора:

# LAN
# WIFI (точка доступа).

=== Состав программного обеспечения прибора ===
Программное обеспечение прибора состоит из следующих частей:

* Системное программное обеспечение.
* Прикладное программное обеспечение, обеспечивающее взаимодействие с AgavaCloud.

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

== Порядок работы с прибором ==
=== Первое включение и загрузка ===
[[Файл:АГАВАСК01-Циклограмма работы.png.png|мини|600x600пкс|Рисунок 5 - Циклограмма мигания индикатора USR]]
Подключите прибор к источнику питания +24В соблюдая полярность.

После подачи питания должен загореться индикатор питания “POW” и начаться инициализация. В процессе инициализации будет мигать светодиоды “Wi-Fi”, "USR", "GSM".

Светодиод "USR" индицирует текущий режим/этап работы Прибора с помощью мигания. Характер мигания светодиода в разных режимах показан на рис. 5.

Светодиод "GSM" отображает статус сети. Режимы мигания показаны на рис. 6.

[[Файл:АГАВАСК01-циклограмма-LED-индикатора-GSM.png|мини|599x599px|Рисунок 6 - Циклограмма мигания индикатора GSM|альт=]]

=== Режимы и этапы работы Прибора ===
После включения Прибор последовательно проходит через описываемые ниже режимы и этапы. Характер мигания светодиода в разных режимах показан на рис. 5.

# Режим <code>Подготовка</code>. Начинается после подачи питания.
## Этап <code>Инициализация</code>. Длительность этапа - примерно 10 с.
## Этап <code>Загрузка</code>. Длительность этапа - примерно 60-70 с.
## Этап <code>Окончание загрузки</code>. Длительность этапа - примерно 1-5 с.
# Режим <code>Работа</code>. Примерно через 70 секунд после включения прибор начинает обмен информацией с AgavaCloud, состоящий из следующих этапов:
## Этап <code>Подключение</code> к AgavaCloud. На этом этапе производится установление соединения с AgavaCloud. Длительность режима - примерно 1 с при настроенном подключении Прибора к сети Internet. При отсутствии подключения Прибор находится в данном режиме до установления подключения к AgavaCloud. Светодиод USR кратковременно зажигается (на 100 мс), далее гаснет на 900 мс, после чего цикл повторяется.
## Этап <code>Регистрация</code> в AgavaCloud. На этом этапе подключение к AgavaCloud установлено, прибор авторизуется в системе. После успешной регистрации прибор переходит к следующему этапу. На данном этапе светодиод USR делает два импульса по 100 мс с промежутком в 100 мс, далее гаснет на 700 мс, после чего цикл повторяется. Длительность режима - примерно 1 с. При наличии проблем с регистрацией Прибор находится в данном режиме до установления подключения к AgavaCloud
## Этап <code>Получение задания</code>. Длительность режима при наличии задания (то есть в каком-либо проекте задействован Прибор и для него определена конфигурация) - примерно 1 с, при отсутствии задания прибор находится в этом режиме до тех пор, пока не получит задание. На данном этапе светодиод USR делает три импульса по 100 мс с промежутком в 100 мс, далее гаснет на 500 мс, после чего цикл повторяется.
## Этап <code>Передача данных</code>. Основной этап, в котором находится прибор в нормальном состоянии (настроено подключение и прибор присутствует в каком-либо проекте в AgavaCloud). Светодиод USR попеременно зажигается и гаснет на 1 с.

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

Для настройки Прибора необходимо подключиться к нему одним из следующих способов:

* Кабельное подключение через Ethernet.
* Подключение к встроенной точке доступа WIFI.

==== Настройка Прибора через кабельное подключение через Ethernet ====

* Соедините кабелем Ethernet компьютер и порт LAN Прибора напрямую или через коммутатор.
* Убедитесь, что на компьютере в настройках сетевого адаптера имеется IP-адрес из сети <code>192.168.1.х</code>, например <code>192.168.1.88</code>, маска <code>255.255.255.0</code>.
* Откройте интернет-обозреватель и в адресной строке введите адрес: <code>192.168.1.1</code>. После загрузки прибора браузер автоматически откроет страницу системной утилиты.
* Введите логин и пароль, далее произведите настройку Прибора.

==== Настройка Прибора через Wi-Fi ====
Прибор оснащен модулем WIFI, по умолчанию настроенным на работу в режиме точки доступа, в котором возможно подключение к Прибору для его настройки.

Порядок подключения:
* Откройте на компьютере настройку беспроводных сетей и выполните поиск доступных Wi-Fi сетей, либо на смартфоне включите модуль WIFI и откройте окно выбора сети. В списке сетей должна появиться сеть c именем <code>AGAVA-SK01</code>.
* Подключите компьютер к сети <code>AGAVA-SK01</code>. Сеть <code>AGAVA-SK01</code> является открытой и не требует пароля и шифрования.
* После удачного подключения к <code>AGAVA-SK01</code> откройте интернет-обозреватель и в адресной строке введите адрес устройства: <code>192.168.2.1</code>. Браузер откроет страницу системной утилиты.

* Введите логин и пароль, далее произведите настройку Прибора.

=== Подключение Прибора к сети Internet ===
Для использования Прибора необходимо подключить его к сети Internet одним из следующих способов:

# Кабельное подключение через локальную сеть или напрямую к поставщику услуг сети Internet.
# WIFI подключение к существующей точке доступа.
# Беспроводное 3G/LTE соединение с Internet с помощью встроенного 3G/LTE модема.
{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Установку SIM-карты в Прибор необходимо производить при отключенном электропитании.}}{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Для передачи данных через беспроводное 3G/LTE соединение требуется приобретение у поставщика услуг связи тарифа на передачу данных, совместимого с роутерами}}

=== Настройка подключения Прибора к сети Internet ===
Настройка подключения Прибора к сети осуществляется с помощью встроенной системной утилиты, доступной через интерфейсы прибора LAN или WIFI (в режиме "Точка доступа").

=== Системная утилита ===
Системная утилита - встроенное в Прибор программное обеспечение, предназначенное для конфигурирования прибора и просмотра его параметров. Взаимодействие с системной утилитой осуществляется через браузер (обозреватель).

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

Настройте подключение к Прибору, как описано в разделе [[Руководство по эксплуатации АГАВА СК-01#Настройка Прибора|Настройка Прибора]].

Для авторизации используйте следующие реквизиты:

* имя пользователя — <code>web</code>
* пароль — <code>inc23.crffdswe</code>

После ввода реквизитов нажмите кнопку "Войти".
[[Файл:АГАВАСК01-Авторизация.png|мини|АГАВА СК-01-Авторизация|640x640px|альт=|центр]]

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

[[Файл:АГАВАСК01-Начальная-страница-обновленная.png|альт=|мини|640x640px|Начальная страница системной утилиты|центр]]

На странице отображены, сверху вниз:

* полоса заголовка с названием Прибора, выпадающим списком перехода на другие страницы системной утилиты и ссылка "Выйти" для завершения работы с системной утилитой;
* интерфейсы Прибора, их состояние и кнопки управления интерфейсами;
* Кнопки "Применить" и "Сохранить" для сохранения внесенных изменений;
* "подвал" страницы с указанием названия системной утилиты и версии прошивки Прибора.
{{Внимание|Тип=Восклицание синий.png|Текст=Рекомендуется установить новый пароль для входа в системную утилиту. Для этого кликните по вкладке меню «Основные настройки», затем выберете пункт «Пароль сетевого шлюза», далее задайте новый пароль и подтвердите его. Для сохранения изменений нажмите кнопку «Сохранить».}}

==== Настройка сетевых интерфейсов ====

===== Интерфейс 3G-GSM =====

Если в Прибор установлена SIM карта, то после включения и загрузки устройства, на странице «Интерфейсы» в интерфейсе 3g-GSM будет отображен полученный IP-адрес предоставленный оператором связи, а также статистика обмена пакетами (RX) и (TX).[[Файл:АГАВАСК01-3G-Интерфейс.png|мини|640x640px|3g-GSM интерфейс, IP-адрес, статистика обмена пакетами|альт=|центр]]

{{Внимание|Тип=Восклицание синий.png|Текст=Настройку интерфейса 3g-GSM в большинстве случаев производить не требуется, так как она выполняется автоматически при запуске Прибора.}}

При необходимости настройки параметров интерфейса 3g-GSM нажмите кнопку «Изменить».

В открывшемся окне на вкладке «Основные настройки» в полях <code>APN</code>, <code>Имя пользователя</code>, <code>Пароль</code> введите нужные значения параметров.

Для примера ниже приведены настройки для доступа к сети интернет через оператора связи МТС:

* APN: internet.mts.ru.
* Имя пользователя: mts
* Пароль: mts.

[[Файл:АГАВАСК01-Настройка-GSM.png|мини|Настройка параметров интерфейса GSM|640x640px|альт=|центр]]

После внесения изменений нажмите кнопку «Сохранить», при этом автоматически будет выполнен переход на главную страницу. На главной странице отображается плашка "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ", сигнализирующая о внесенных в настройки прибора изменениях, но не принятых в работу.

[[Файл:АГАВАСК01-Главная страница-Изменения.png|альт=|центр|мини|639x639пкс|Начальная страница системной утилиты - внесены изменения в настройки, ожидается их применение]]
Для '''принятия внесенных изменений''' необходимо выполнить одно из двух действий:

* нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Применить";
* нажать на кнопку "Применить" в низу главной страницы, при этом подтверждение не запрашивается и изменения сразу применяются.

Для '''отмены внесенных изменений''' необходимо нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Вернуть".

===== Интерфейс LAN =====

Интерфейс LAN предназначен для сбора данных с подключаемых устройств и настройки самого Прибора.
[[Файл:АГАВАСК01-Интерфейс LAN.png|альт=|центр|мини|640x640пкс|Иинтерфейс LAN: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «LAN» нажмите кнопку «Изменить».

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

* выбор протокола (по умолчанию установлено в «Статический адрес»)
* задание IP адреса, маски сети и адреса шлюза.

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

[[Файл:АГАВАСК01-Настройка-интерфейса-lan.png|мини|640x640px|Настройка интерфейса lan|альт=|центр]]Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WAN =====
Интерфейс WAN предназначен для подключения к системе AgavaCloud.

[[Файл:АГАВАСК01-Интерфейс WAN.png|альт=|центр|мини|640x640пкс|Интерфейс WAN: IP-адрес, статистика обмена пакетами]]

Для настройки интерфейса «WAN» нажмите кнопку «Изменить».

В открывшемся окне отображен статус устройства, имеется возможность выбора режима (по умолчанию установлен режим «DHCP-клиент») и настройки параметров.

[[Файл:АГАВАСК01-Настройка-интерфейса-Wan.png|мини|640x640px|Настройка интерфейса WAN. По умолчанию включен режим DHCP клиент.|альт=|центр]]

Для настройки статического IP-адреса в поле «Режим» из выпадающего списка выберите пункт «Статический адрес», подтвердите выбор нажатием вновь появившейся кнопки «Изменить режим». Далее в полях «IPv4-адрес», «маска сети IPv4», «IPv4-адрес шлюза» внесите необходимые настройки и нажмите кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WAN-Настройка2.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WAN. Настройка режима "Статический адрес".]]

Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WIFI (клиент) =====

Интерфейс WIFI в режиме "Клиент" предназначен для подключения к системе AgavaCloud.
[[Файл:АГАВАСК01-Интерфейс WIFI.png|альт=|центр|мини|640x640пкс|Иинтерфейс WIFI: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «WIFI» нажмите кнопку «Изменить».

В открывшемся окне отображен статус интерфейса, имеются следующие возможности:

* выбор SSID (точки доступа) из списка обнаруженных;
* выбор режима и алгоритма шифрования;
* ввод ключа (пароля) для подключения к точке доступа.

После внесения изменений, необходимо нажать кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WIFI-Настройка.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WIFI (клиент)]]
Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].{{Внимание|Тип=Восклицание синий.png|Текст=При применении настроек WIFI будет выполнен перезапуск сетевых интерфейсов Прибора. Если настройка WIFI Прибора осуществляется со смартфона, то соединение смартфона и точки доступа Прибора будет разорвано и необходимо будет повторно подключиться к точке доступа AGAVA-SK01. При настройке WIFI через LAN таких разрывов нет.}}

==== Дополнительная настройка беспроводных подключений ====
Страница "Беспроводная сеть" системной утилиты позволяет выполнить дополнительные настройки беспроводной сети Прибора:

* Включать или отключать беспроводные интерфейсы WIFI (клиент) и WIFI (точка доступа).
* Изменять настройки собственной точки доступа, например пароль или SSID. Последнее актуально при использовании нескольких приборов с покрытием WIFI одной области.
* Просматривать список клиентов, подключенных к точке доступа и отключать их.

Для перехода к странице "Беспроводная сеть" выберите пункт «Беспроводная сеть» в меню «Основные настройки».

[[Файл:АГАВАСК01-Настройка-беспроводной-сети.png|мини|Страница "Беспроводная сеть"|640x640px|альт=|центр]]

===== Настройка собственной точки доступа (WIFI в режиме "точка доступа") =====
Для настройки собственной точки доступа необходимо на странице "Беспроводная сеть" в разделе «Список беспроводных сетей» нажать кнопку «Изменить» напротив беспроводной сети <code>AGAVA-SK01 | Режим: Master</code>.

В открывшемся окне можно изменить множество настроек точки. Наиболее востребованные параметры - SSID (имя точки), пароль.
После внесения изменений нужно нажать кнопку «Сохранить» в правом нижнем углу окна.
[[Файл:АГАВАСК01-Настройка-беспроводной-сети-в-режим-работы-точка-доступа.png|мини|686x686px|Настройка WIFI в режиме "Точка доступа"|альт=|центр]]Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

=== Использование Прибора с AgavaCloud ===

==== Регистрация Прибора в AgavaCloud ====
После настройки подключения Прибора к сети Internet необходимо зарегистрировать Прибор в своем проекте AgavaCloud. Регистрация выполняется следующим образом:

# Войдите в свой проект AgavaCloud.
# Откройте раздел <code>Устройства</code> вашего проекта.
# Добавьте устройство типа <code>Шлюз АГАВА СК-01</code> и введите в поле <code>Идентификатор</code> 16-значный УИН, указанный на шильдике, находящемся на корпусе Прибора.

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

==== Добавление подчиненных устройств ====
Прибор поддерживает опрос подчиненных устройств следующих типов:

* Устройства с протоколом Modbus-TCP.
* Устройства с протоколом Modbus-RTU.

===== Добавление устройств с протоколом Modbus-RTU =====
Для опроса Прибором устройств с протоколом Modbus-RTU необходимо в проекте AgavaCloud добавить в шлюз соответствующее устройство.

При заполнении настроек устройства необходимо указать адрес последовательного порта:<code>/dev/ttyS1</code>. Остальные настройки устанавливаются в соответствии с параметрами опрашиваемого устройства.

Дальнейшие операции по настройке проекта для передачи данных Прибора в AgavaCloud описаны на [[Система облачной диспетчеризации AgavaCloud|страницах описания AgavaCloud]].

== Обновление программного обеспечения АГАВА СК-01 ==
Прибор поставляется со всем необходимым установленным системным и прикладным программным обеспечением.

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

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

== Правила транспортирования и хранения ==
Прибор должен транспортироваться в упаковке при температуре от -30 °С до +80 °С и относительной влажности воздуха не более 95 % (при 35 °С).

Транспортирование допускается всеми видами закрытого транспорта.

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

Условия хранения прибора в транспортной таре на складе потребителя должны соответствовать условиям 1 по ГОСТ 15150-69.

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

== Техническое обслуживание ==
Прибор специального обслуживания не требует.

Периодически не реже чем раз в 6 месяцев проводить:

* осмотр прибора на внешние повреждения;
* соединения зажимных контактов;
* очистку прибора от пыли и грязи;
* качества крепления на DIN-рейке.

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

== Комплектность ==
{| class="wikitable"
|+
|№ п/п
|Наименование
|Количество,
шт.
|-
|1
|Сетевой шлюз АГАВА СК-01
|1
|-
|2
|Антенна Wi-Fi (2dB)
|1
|-
|3
|Антенна GSM (2dB) *
|1
|-
|4
|Паспорт
|1
|}
<nowiki>*</nowiki> Вариант исполнения с GSM модемом СК-01.1

== Гарантийные обязательства ==
Гарантийный срок эксплуатации – 12 месяцев со дня продажи.

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

Для отправки в ремонт необходимо вложить в тару с сетевым шлюзом АГАВА СК-01 паспорт, акт отказа и отправить по адресу:

620144, г. Екатеринбург, ул. Верещагина, д. 6а, ООО КБ «АГАВА»

Тел: (343) 382-01-92.

Руководство по эксплуатации АГАВА СК-01

2026-03-11T07:17:48Z

TaushkanovKV: /* Настройка собственной точки доступа (WIFI в режиме "точка доступа") */

== Введение ==
Данное руководство по эксплуатации содержит сведения, необходимые для обеспечения правильной эксплуатации и полного использования технических возможностей сетевого шлюза АГАВА СК-01, далее по тексту: прибор, СК-01 или шлюз.

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

== Назначение ==

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

Подключение к внешним устройствам осуществляется через Ethernet, Wi-Fi, RS-485 (MODBUS-RTU);

=== Используемые термины и сокращения ===
ПК – персональный компьютер;

ОС – операционная система;

ПО – программное обеспечение;

ОЗУ – оперативное запоминающее устройство;

ФС – файловая система.

=== Условное обозначение прибора ===
Пример полного условного обозначения прибора:

* СК-01.1 – базовое исполнение;
* СК-01.2 – исполнение без GSM модема.

== Оснащение прибора ==

=== Состав прибора ===

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

На корпусе прибора установлены разъёмы для подключения внешних антенн.

На варианте исполнения СК-01.1 установлено 2 разъема для подключения антенн Wi-Fi и GSM (LTE) модема, СК-01.2 установлен 1 разъем для подключения антенны Wi-Fi.

В месте с прибором в зависимости от варианта исполнения поставляются одна (две) антенна(ы) с коэффициентом усиления 2dB.

В прибор СК-01.1 для работы GSM (LTE) модема устанавливается стандартная SIM-карта.

=== Конструкция Прибора ===
Габаритные размеры и позиционные обозначения компонентов Прибора приведены на рисунке ниже.
[[Файл:Views 1.png|без|мини|550x550пкс|Рисунок 1 - Габаритные размеры и позиционные обозначения СК-01]]Обозначение компонентов приведено в таблице ниже:
{| class="wikitable"
!Позиционное
обозначение
!Расшифровка
|-
|1
|GSM антенна
|-
|2
|Wi-Fi антенна
|-
|3
|Кнопка сброса настроек
|-
|4
|Место установки SIM карты
|-
|5
|Разъем подключения LAN
|-
|6
|Клемник подключения питания и RS-485
|-
|7
|Разъем подключения WAN
|-
|8
|Светодиодные индикаторы
|-
|9
|Переключатель для подключения встроенного терминального резистора RS-485
|-
|10
|Фиксатор прибора на DIN-рейке
|}

=== Технические характеристики ===
{| class="wikitable" style="width:75%"
|+

!№ п/п
! colspan="3" |Общие сведения
|-
|1
|Конструктивное исполнение
| colspan="2" |Моноблок на DIN-рейку
|-
|2
|Габаритные размеры (ВхШхГ), мм:
| colspan="2" |88 × 35 × 62

188 × 35 × 62 – с установленной антенной
|-
|3
|Масса прибора, не более, кг
| colspan="2" |0.120
|-
|4
|Степень защиты корпуса
| colspan="2" |IP20
|-
|5
|Напряжение питания
| colspan="2" |24 В ±10 % постоянного тока
|-
|6
|Потребляемая мощность, не более
| colspan="2" |12 Вт
|-
! colspan="4" |Интерфейсы подключения к AgavaCloud
|-
!style="width:3%" |
!style="width:13%" |
!style="width:20%" | АГАВА СК-01.1
!style="width:20%" | АГАВА СК-01.2
|-
|7
|Ethernet
| colspan="2" |WAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|8
|Wi-Fi
| colspan="2" |Режим "Клиент", стандарты 802.11 b/g/n, антенна внешняя.
Макс. чувствительность приемника 76 дБ, макс. мощность передатчика 21.1 дБ.

Тип разъема для антенны – SMA-F
|-
|9
|GSM
|1шт., GSM(LTE) - LTE CAT1 модуль, с поддержкой LTE-TDD/LTE-FDD.
Максимальная скорость загрузки 10Mbps, скорость передачи - 5Mbps.

Тип разъема для антенны – SMA-F

Стандартная mini-SIM карта с поддержкой всех операторов беспроводной связи
|Отсутствует
|-
! colspan="4" |Интерфейсы подключения устройств
|-
|10
|Ethernet
| colspan="2" |LAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|11
|RS-485
| colspan="2" |1шт. с гальванической развязкой, скорость до 115200 Mбит/с включительно
|-
! colspan="4" |Индикация и управление
|-
| rowspan="6" |12
| rowspan="6" |Индикация
| colspan="2" |Индикатор наличия питания - <code>POW</code>
|-
| colspan="2" |Индикатор состояния GSM модема - <code>GSM</code>
|-
| colspan="2" |Индикатор состояния WIFI - <code>WiFi</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейса RS-485 - <code>RX</code> <code>TX</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейсов Ethernet (на разъемах интерфейсов)
|-
| colspan="2" |Индикатор режима работы - <code>USR</code>
|-
|13
|Органы управления
| colspan="2" |Кнопка сброса, возврата к заводским установкам
|-
|14
|Переключатель
| colspan="2" |Включение и отключение терминального резистора
|}

== Условия эксплуатации ==
{| class="wikitable"
! colspan="2" |Условия эксплуатации
|-
|Тип помещения
|Закрытые взрывобезопасные помещения без агрессивных паров и газов
|-
|Температура окружающего воздуха
|От 0 до +50°С
|-
|Влажность воздуха
|Верхний предел относительной влажности воздуха 80% при +35°С и более низких температурах без конденсации влаги
|-
|Атмосферное давление
|От 86 до 107 кПа
|}

== Маркировка ==
На боковой панели прибора расположена наклейка с информацией о приборе:

* обозначение исполнения Прибора;
* заводской номер Прибора;
* уникальный идентификационный номер Прибора (УИН).

== Устройство и принцип работы прибора ==

=== Подготовка прибора к использованию ===

==== Общие указания ====
В зимнее время тару с прибором распаковывать в отапливаемом помещении не ранее чем через 4 часа после внесения их в помещение. Монтаж, эксплуатация и демонтаж СК-01 должны производиться персоналом, ознакомленным с правилами его эксплуатации и прошедшим инструктаж для работы с электрооборудованием в соответствии с правилами, установленными на предприятии-потребителе.

==== Указания мер безопасности ====
По способу защиты от поражения электрическим током CK-01 соответствует классу 0 по ГОСТ 12.2.007.0-75.

При эксплуатации и техническом обслуживании необходимо соблюдать требования ГОСТ 12.3.019-80, «Правил эксплуатации электроустановок потребителей» и «Правил охраны труда при эксплуатации электроустановок потребителей».

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

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

Установка и извлечение SIM-карты в сетевой шлюз АГАВА СК-01.1должна выполняться только при отключенном питании прибора.

==== Монтаж и подключение прибора ====
Прибор устанавливается на DIN-рейку 35мм. при помощи специального фиксатора (Рисунок 1, Позиция 10), расположенного в верхней части прибора.

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

Установку SIM-карты (Рисунок 1, Позиция 4) в сетевой шлюз АГАВА СК-01.1 производить до установки Прибора на DIN-рейку.

Установку антенн производить после установки прибора на DIN-рейку.

Подключаемые к прибору провода должны быть многожильными сечением от 0,25 до 0,5 мм2. Рекомендуемые типы кабелей МКШ, МКЭШ, МКШМ ГОСТ 10348-80.

Рекомендуется обжимать концы подключаемых проводов наконечниками типа НШВИ.

==== Подключение линий связи ====
Ниже приведены схемы подключения внешних устройств (блоков питания, линии RS-485 и Ethernet) к прибору.

===== Схема подключения питания =====
[[Файл:Power.png|мини|550x550px|Рисунок 2 - Схема подключения питания|альт=|без]]

===== Схема подключения линии RS-485 (без дренажного провода) =====
[[Файл:RS-485 NO DRAIN.png|без|мини|550x550px|Рисунок -3 Схема подключения линии RS-485 (без дренажного провода)|альт=]]

===== Схема подключения линии RS-485 (c дренажным проводом) =====
[[Файл:RS-485 with drain.png|без|мини|550x550px|Рисунок 4 - Схема подключения линии RS-485 (c дренажным проводом)|альт=]]Примечание''':''' для подключения встроенных терминальных резисторов RS-485 (120 Ом) необходимо перевести переключатель SW-1 (Рисунок 1, Позиция 9) в положение “ON” .

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

Для уменьшения влияния электромагнитных помех необходимо выполнять приведенные ниже рекомендации:

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

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

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

=== Интерфейсы прибора и их назначение ===
Прибор оснащен большим количеством интерфейсов передачи данных, имеющих разное назначение.

Интерфейсы связи с системой AgavaCloud:

# 3G-GSM.
# WAN.
# WIFI (клиент).

Интерфейсы для сбора данных с подключаемых устройств:

# LAN.
# RS-485.

Интерфейсы для настройки Прибора:

# LAN
# WIFI (точка доступа).

=== Состав программного обеспечения прибора ===
Программное обеспечение прибора состоит из следующих частей:

* Системное программное обеспечение.
* Прикладное программное обеспечение, обеспечивающее взаимодействие с AgavaCloud.

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

== Порядок работы с прибором ==
=== Первое включение и загрузка ===
[[Файл:АГАВАСК01-Циклограмма работы.png.png|мини|600x600пкс|Рисунок 5 - Циклограмма мигания индикатора USR]]
Подключите прибор к источнику питания +24В соблюдая полярность.

После подачи питания должен загореться индикатор питания “POW” и начаться инициализация. В процессе инициализации будет мигать светодиоды “Wi-Fi”, "USR", "GSM".

Светодиод "USR" индицирует текущий режим/этап работы Прибора с помощью мигания. Характер мигания светодиода в разных режимах показан на рис. 5.

Светодиод "GSM" отображает статус сети. Режимы мигания показаны на рис. 6.

[[Файл:АГАВАСК01-циклограмма-LED-индикатора-GSM.png|мини|599x599px|Рисунок 6 - Циклограмма мигания индикатора GSM|альт=]]

=== Режимы и этапы работы Прибора ===
После включения Прибор последовательно проходит через описываемые ниже режимы и этапы. Характер мигания светодиода в разных режимах показан на рис. 5.

# Режим <code>Подготовка</code>. Начинается после подачи питания.
## Этап <code>Инициализация</code>. Длительность этапа - примерно 10 с.
## Этап <code>Загрузка</code>. Длительность этапа - примерно 60-70 с.
## Этап <code>Окончание загрузки</code>. Длительность этапа - примерно 1-5 с.
# Режим <code>Работа</code>. Примерно через 70 секунд после включения прибор начинает обмен информацией с AgavaCloud, состоящий из следующих этапов:
## Этап <code>Подключение</code> к AgavaCloud. На этом этапе производится установление соединения с AgavaCloud. Длительность режима - примерно 1 с при настроенном подключении Прибора к сети Internet. При отсутствии подключения Прибор находится в данном режиме до установления подключения к AgavaCloud. Светодиод USR кратковременно зажигается (на 100 мс), далее гаснет на 900 мс, после чего цикл повторяется.
## Этап <code>Регистрация</code> в AgavaCloud. На этом этапе подключение к AgavaCloud установлено, прибор авторизуется в системе. После успешной регистрации прибор переходит к следующему этапу. На данном этапе светодиод USR делает два импульса по 100 мс с промежутком в 100 мс, далее гаснет на 700 мс, после чего цикл повторяется. Длительность режима - примерно 1 с. При наличии проблем с регистрацией Прибор находится в данном режиме до установления подключения к AgavaCloud
## Этап <code>Получение задания</code>. Длительность режима при наличии задания (то есть в каком-либо проекте задействован Прибор и для него определена конфигурация) - примерно 1 с, при отсутствии задания прибор находится в этом режиме до тех пор, пока не получит задание. На данном этапе светодиод USR делает три импульса по 100 мс с промежутком в 100 мс, далее гаснет на 500 мс, после чего цикл повторяется.
## Этап <code>Передача данных</code>. Основной этап, в котором находится прибор в нормальном состоянии (настроено подключение и прибор присутствует в каком-либо проекте в AgavaCloud). Светодиод USR попеременно зажигается и гаснет на 1 с.

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

Для настройки Прибора необходимо подключиться к нему одним из следующих способов:

* Кабельное подключение через Ethernet.
* Подключение к встроенной точке доступа WIFI.

==== Настройка Прибора через кабельное подключение через Ethernet ====

* Соедините кабелем Ethernet компьютер и порт LAN Прибора напрямую или через коммутатор.
* Убедитесь, что на компьютере в настройках сетевого адаптера имеется IP-адрес из сети <code>192.168.1.х</code>, например <code>192.168.1.88</code>, маска <code>255.255.255.0</code>.
* Откройте интернет-обозреватель и в адресной строке введите адрес: <code>192.168.1.1</code>. После загрузки прибора браузер автоматически откроет страницу системной утилиты.
* Введите логин и пароль, далее произведите настройку Прибора.

==== Настройка Прибора через Wi-Fi ====
Прибор оснащен модулем WIFI, по умолчанию настроенным на работу в режиме точки доступа, в котором возможно подключение к Прибору для его настройки.

Порядок подключения:
* Откройте на компьютере настройку беспроводных сетей и выполните поиск доступных Wi-Fi сетей, либо на смартфоне включите модуль WIFI и откройте окно выбора сети. В списке сетей должна появиться сеть c именем <code>AGAVA-SK01</code>.
* Подключите компьютер к сети <code>AGAVA-SK01</code>. Сеть <code>AGAVA-SK01</code> является открытой и не требует пароля и шифрования.
* После удачного подключения к <code>AGAVA-SK01</code> откройте интернет-обозреватель и в адресной строке введите адрес устройства: <code>192.168.2.1</code>. Браузер откроет страницу системной утилиты.

* Введите логин и пароль, далее произведите настройку Прибора.

=== Подключение Прибора к сети Internet ===
Для использования Прибора необходимо подключить его к сети Internet одним из следующих способов:

# Кабельное подключение через локальную сеть или напрямую к поставщику услуг сети Internet.
# WIFI подключение к существующей точке доступа.
# Беспроводное 3G/LTE соединение с Internet с помощью встроенного 3G/LTE модема.
{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Установку SIM-карты в Прибор необходимо производить при отключенном электропитании.}}{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Для передачи данных через беспроводное 3G/LTE соединение требуется приобретение у поставщика услуг связи тарифа на передачу данных, совместимого с роутерами}}

=== Настройка подключения Прибора к сети Internet ===
Настройка подключения Прибора к сети осуществляется с помощью встроенной системной утилиты, доступной через интерфейсы прибора LAN или WIFI (в режиме "Точка доступа").

=== Системная утилита ===
Для авторизации используйте следующие реквизиты:

* имя пользователя — <code>web</code>
* пароль — <code>inc23.crffdswe</code>

После ввода реквизитов нажмите кнопку "Войти".
[[Файл:АГАВАСК01-Авторизация.png|мини|АГАВА СК-01-Авторизация|640x640px|альт=|центр]]

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

[[Файл:АГАВАСК01-Начальная-страница-обновленная.png|альт=|мини|640x640px|Начальная страница системной утилиты|центр]]

На странице отображены, сверху вниз:

* полоса заголовка с названием Прибора, выпадающим списком перехода на другие страницы системной утилиты и ссылка "Выйти" для завершения работы с системной утилитой;
* интерфейсы Прибора, их состояние и кнопки управления интерфейсами;
* Кнопки "Применить" и "Сохранить" для сохранения внесенных изменений;
* "подвал" страницы с указанием названия системной утилиты и версии прошивки Прибора.
{{Внимание|Тип=Восклицание синий.png|Текст=Рекомендуется установить новый пароль для входа в системную утилиту. Для этого кликните по вкладке меню «Основные настройки», затем выберете пункт «Пароль сетевого шлюза», далее задайте новый пароль и подтвердите его. Для сохранения изменений нажмите кнопку «Сохранить».}}

==== Настройка сетевых интерфейсов ====

===== Интерфейс 3G-GSM =====

Если в Прибор установлена SIM карта, то после включения и загрузки устройства, на странице «Интерфейсы» в интерфейсе 3g-GSM будет отображен полученный IP-адрес предоставленный оператором связи, а также статистика обмена пакетами (RX) и (TX).[[Файл:АГАВАСК01-3G-Интерфейс.png|мини|640x640px|3g-GSM интерфейс, IP-адрес, статистика обмена пакетами|альт=|центр]]

{{Внимание|Тип=Восклицание синий.png|Текст=Настройку интерфейса 3g-GSM в большинстве случаев производить не требуется, так как она выполняется автоматически при запуске Прибора.}}

При необходимости настройки параметров интерфейса 3g-GSM нажмите кнопку «Изменить».

В открывшемся окне на вкладке «Основные настройки» в полях <code>APN</code>, <code>Имя пользователя</code>, <code>Пароль</code> введите нужные значения параметров.

Для примера ниже приведены настройки для доступа к сети интернет через оператора связи МТС:

* APN: internet.mts.ru.
* Имя пользователя: mts
* Пароль: mts.

[[Файл:АГАВАСК01-Настройка-GSM.png|мини|Настройка параметров интерфейса GSM|640x640px|альт=|центр]]

После внесения изменений нажмите кнопку «Сохранить», при этом автоматически будет выполнен переход на главную страницу. На главной странице отображается плашка "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ", сигнализирующая о внесенных в настройки прибора изменениях, но не принятых в работу.

[[Файл:АГАВАСК01-Главная страница-Изменения.png|альт=|центр|мини|639x639пкс|Начальная страница системной утилиты - внесены изменения в настройки, ожидается их применение]]
Для '''принятия внесенных изменений''' необходимо выполнить одно из двух действий:

* нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Применить";
* нажать на кнопку "Применить" в низу главной страницы, при этом подтверждение не запрашивается и изменения сразу применяются.

Для '''отмены внесенных изменений''' необходимо нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Вернуть".

===== Интерфейс LAN =====

Интерфейс LAN предназначен для сбора данных с подключаемых устройств и настройки самого Прибора.
[[Файл:АГАВАСК01-Интерфейс LAN.png|альт=|центр|мини|640x640пкс|Иинтерфейс LAN: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «LAN» нажмите кнопку «Изменить».

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

* выбор протокола (по умолчанию установлено в «Статический адрес»)
* задание IP адреса, маски сети и адреса шлюза.

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

[[Файл:АГАВАСК01-Настройка-интерфейса-lan.png|мини|640x640px|Настройка интерфейса lan|альт=|центр]]Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WAN =====
Интерфейс WAN предназначен для подключения к системе AgavaCloud.

[[Файл:АГАВАСК01-Интерфейс WAN.png|альт=|центр|мини|640x640пкс|Интерфейс WAN: IP-адрес, статистика обмена пакетами]]

Для настройки интерфейса «WAN» нажмите кнопку «Изменить».

В открывшемся окне отображен статус устройства, имеется возможность выбора режима (по умолчанию установлен режим «DHCP-клиент») и настройки параметров.

[[Файл:АГАВАСК01-Настройка-интерфейса-Wan.png|мини|640x640px|Настройка интерфейса WAN. По умолчанию включен режим DHCP клиент.|альт=|центр]]

Для настройки статического IP-адреса в поле «Режим» из выпадающего списка выберите пункт «Статический адрес», подтвердите выбор нажатием вновь появившейся кнопки «Изменить режим». Далее в полях «IPv4-адрес», «маска сети IPv4», «IPv4-адрес шлюза» внесите необходимые настройки и нажмите кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WAN-Настройка2.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WAN. Настройка режима "Статический адрес".]]

Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WIFI (клиент) =====

Интерфейс WIFI в режиме "Клиент" предназначен для подключения к системе AgavaCloud.
[[Файл:АГАВАСК01-Интерфейс WIFI.png|альт=|центр|мини|640x640пкс|Иинтерфейс WIFI: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «WIFI» нажмите кнопку «Изменить».

В открывшемся окне отображен статус интерфейса, имеются следующие возможности:

* выбор SSID (точки доступа) из списка обнаруженных;
* выбор режима и алгоритма шифрования;
* ввод ключа (пароля) для подключения к точке доступа.

После внесения изменений, необходимо нажать кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WIFI-Настройка.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WIFI (клиент)]]
Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].{{Внимание|Тип=Восклицание синий.png|Текст=При применении настроек WIFI будет выполнен перезапуск сетевых интерфейсов Прибора. Если настройка WIFI Прибора осуществляется со смартфона, то соединение смартфона и точки доступа Прибора будет разорвано и необходимо будет повторно подключиться к точке доступа AGAVA-SK01. При настройке WIFI через LAN таких разрывов нет.}}

==== Дополнительная настройка беспроводных подключений ====
Страница "Беспроводная сеть" системной утилиты позволяет выполнить дополнительные настройки беспроводной сети Прибора:

* Включать или отключать беспроводные интерфейсы WIFI (клиент) и WIFI (точка доступа).
* Изменять настройки собственной точки доступа, например пароль или SSID. Последнее актуально при использовании нескольких приборов с покрытием WIFI одной области.
* Просматривать список клиентов, подключенных к точке доступа и отключать их.

Для перехода к странице "Беспроводная сеть" выберите пункт «Беспроводная сеть» в меню «Основные настройки».

[[Файл:АГАВАСК01-Настройка-беспроводной-сети.png|мини|Страница "Беспроводная сеть"|640x640px|альт=|центр]]

===== Настройка собственной точки доступа (WIFI в режиме "точка доступа") =====
Для настройки собственной точки доступа необходимо на странице "Беспроводная сеть" в разделе «Список беспроводных сетей» нажать кнопку «Изменить» напротив беспроводной сети <code>AGAVA-SK01 | Режим: Master</code>.

В открывшемся окне можно изменить множество настроек точки. Наиболее востребованные параметры - SSID (имя точки), пароль.
После внесения изменений нужно нажать кнопку «Сохранить» в правом нижнем углу окна.
[[Файл:АГАВАСК01-Настройка-беспроводной-сети-в-режим-работы-точка-доступа.png|мини|686x686px|Настройка WIFI в режиме "Точка доступа"|альт=|центр]]Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

=== Использование Прибора с AgavaCloud ===

==== Регистрация Прибора в AgavaCloud ====
После настройки подключения Прибора к сети Internet необходимо зарегистрировать Прибор в своем проекте AgavaCloud. Регистрация выполняется следующим образом:

# Войдите в свой проект AgavaCloud.
# Откройте раздел <code>Устройства</code> вашего проекта.
# Добавьте устройство типа <code>Шлюз АГАВА СК-01</code> и введите в поле <code>Идентификатор</code> 16-значный УИН, указанный на шильдике, находящемся на корпусе Прибора.

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

==== Добавление подчиненных устройств ====
Прибор поддерживает опрос подчиненных устройств следующих типов:

* Устройства с протоколом Modbus-TCP.
* Устройства с протоколом Modbus-RTU.

===== Добавление устройств с протоколом Modbus-RTU =====
Для опроса Прибором устройств с протоколом Modbus-RTU необходимо в проекте AgavaCloud добавить в шлюз соответствующее устройство.

При заполнении настроек устройства необходимо указать адрес последовательного порта:<code>/dev/ttyS1</code>. Остальные настройки устанавливаются в соответствии с параметрами опрашиваемого устройства.

Дальнейшие операции по настройке проекта для передачи данных Прибора в AgavaCloud описаны на [[Система облачной диспетчеризации AgavaCloud|страницах описания AgavaCloud]].

== Обновление программного обеспечения АГАВА СК-01 ==
Прибор поставляется со всем необходимым установленным системным и прикладным программным обеспечением.

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

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

== Правила транспортирования и хранения ==
Прибор должен транспортироваться в упаковке при температуре от -30 °С до +80 °С и относительной влажности воздуха не более 95 % (при 35 °С).

Транспортирование допускается всеми видами закрытого транспорта.

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

Условия хранения прибора в транспортной таре на складе потребителя должны соответствовать условиям 1 по ГОСТ 15150-69.

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

== Техническое обслуживание ==
Прибор специального обслуживания не требует.

Периодически не реже чем раз в 6 месяцев проводить:

* осмотр прибора на внешние повреждения;
* соединения зажимных контактов;
* очистку прибора от пыли и грязи;
* качества крепления на DIN-рейке.

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

== Комплектность ==
{| class="wikitable"
|+
|№ п/п
|Наименование
|Количество,
шт.
|-
|1
|Сетевой шлюз АГАВА СК-01
|1
|-
|2
|Антенна Wi-Fi (2dB)
|1
|-
|3
|Антенна GSM (2dB) *
|1
|-
|4
|Паспорт
|1
|}
<nowiki>*</nowiki> Вариант исполнения с GSM модемом СК-01.1

== Гарантийные обязательства ==
Гарантийный срок эксплуатации – 12 месяцев со дня продажи.

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

Для отправки в ремонт необходимо вложить в тару с сетевым шлюзом АГАВА СК-01 паспорт, акт отказа и отправить по адресу:

620144, г. Екатеринбург, ул. Верещагина, д. 6а, ООО КБ «АГАВА»

Тел: (343) 382-01-92.

Файл:АГАВАСК01-Настройка-беспроводной-сети-в-режим-работы-точка-доступа.png

2026-03-11T07:16:54Z

TaushkanovKV: TaushkanovKV загрузил новую версию Файл:АГАВАСК01-Настройка-беспроводной-сети-в-режим-работы-точка-доступа.png

Настройка беспроводной сети в режим работы точка доступа

Руководство по эксплуатации АГАВА СК-01

2026-03-11T07:16:30Z

TaushkanovKV: /* Настройка режима «Точка доступа» */

== Введение ==
Данное руководство по эксплуатации содержит сведения, необходимые для обеспечения правильной эксплуатации и полного использования технических возможностей сетевого шлюза АГАВА СК-01, далее по тексту: прибор, СК-01 или шлюз.

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

== Назначение ==

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

Подключение к внешним устройствам осуществляется через Ethernet, Wi-Fi, RS-485 (MODBUS-RTU);

=== Используемые термины и сокращения ===
ПК – персональный компьютер;

ОС – операционная система;

ПО – программное обеспечение;

ОЗУ – оперативное запоминающее устройство;

ФС – файловая система.

=== Условное обозначение прибора ===
Пример полного условного обозначения прибора:

* СК-01.1 – базовое исполнение;
* СК-01.2 – исполнение без GSM модема.

== Оснащение прибора ==

=== Состав прибора ===

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

На корпусе прибора установлены разъёмы для подключения внешних антенн.

На варианте исполнения СК-01.1 установлено 2 разъема для подключения антенн Wi-Fi и GSM (LTE) модема, СК-01.2 установлен 1 разъем для подключения антенны Wi-Fi.

В месте с прибором в зависимости от варианта исполнения поставляются одна (две) антенна(ы) с коэффициентом усиления 2dB.

В прибор СК-01.1 для работы GSM (LTE) модема устанавливается стандартная SIM-карта.

=== Конструкция Прибора ===
Габаритные размеры и позиционные обозначения компонентов Прибора приведены на рисунке ниже.
[[Файл:Views 1.png|без|мини|550x550пкс|Рисунок 1 - Габаритные размеры и позиционные обозначения СК-01]]Обозначение компонентов приведено в таблице ниже:
{| class="wikitable"
!Позиционное
обозначение
!Расшифровка
|-
|1
|GSM антенна
|-
|2
|Wi-Fi антенна
|-
|3
|Кнопка сброса настроек
|-
|4
|Место установки SIM карты
|-
|5
|Разъем подключения LAN
|-
|6
|Клемник подключения питания и RS-485
|-
|7
|Разъем подключения WAN
|-
|8
|Светодиодные индикаторы
|-
|9
|Переключатель для подключения встроенного терминального резистора RS-485
|-
|10
|Фиксатор прибора на DIN-рейке
|}

=== Технические характеристики ===
{| class="wikitable" style="width:75%"
|+

!№ п/п
! colspan="3" |Общие сведения
|-
|1
|Конструктивное исполнение
| colspan="2" |Моноблок на DIN-рейку
|-
|2
|Габаритные размеры (ВхШхГ), мм:
| colspan="2" |88 × 35 × 62

188 × 35 × 62 – с установленной антенной
|-
|3
|Масса прибора, не более, кг
| colspan="2" |0.120
|-
|4
|Степень защиты корпуса
| colspan="2" |IP20
|-
|5
|Напряжение питания
| colspan="2" |24 В ±10 % постоянного тока
|-
|6
|Потребляемая мощность, не более
| colspan="2" |12 Вт
|-
! colspan="4" |Интерфейсы подключения к AgavaCloud
|-
!style="width:3%" |
!style="width:13%" |
!style="width:20%" | АГАВА СК-01.1
!style="width:20%" | АГАВА СК-01.2
|-
|7
|Ethernet
| colspan="2" |WAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|8
|Wi-Fi
| colspan="2" |Режим "Клиент", стандарты 802.11 b/g/n, антенна внешняя.
Макс. чувствительность приемника 76 дБ, макс. мощность передатчика 21.1 дБ.

Тип разъема для антенны – SMA-F
|-
|9
|GSM
|1шт., GSM(LTE) - LTE CAT1 модуль, с поддержкой LTE-TDD/LTE-FDD.
Максимальная скорость загрузки 10Mbps, скорость передачи - 5Mbps.

Тип разъема для антенны – SMA-F

Стандартная mini-SIM карта с поддержкой всех операторов беспроводной связи
|Отсутствует
|-
! colspan="4" |Интерфейсы подключения устройств
|-
|10
|Ethernet
| colspan="2" |LAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|11
|RS-485
| colspan="2" |1шт. с гальванической развязкой, скорость до 115200 Mбит/с включительно
|-
! colspan="4" |Индикация и управление
|-
| rowspan="6" |12
| rowspan="6" |Индикация
| colspan="2" |Индикатор наличия питания - <code>POW</code>
|-
| colspan="2" |Индикатор состояния GSM модема - <code>GSM</code>
|-
| colspan="2" |Индикатор состояния WIFI - <code>WiFi</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейса RS-485 - <code>RX</code> <code>TX</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейсов Ethernet (на разъемах интерфейсов)
|-
| colspan="2" |Индикатор режима работы - <code>USR</code>
|-
|13
|Органы управления
| colspan="2" |Кнопка сброса, возврата к заводским установкам
|-
|14
|Переключатель
| colspan="2" |Включение и отключение терминального резистора
|}

== Условия эксплуатации ==
{| class="wikitable"
! colspan="2" |Условия эксплуатации
|-
|Тип помещения
|Закрытые взрывобезопасные помещения без агрессивных паров и газов
|-
|Температура окружающего воздуха
|От 0 до +50°С
|-
|Влажность воздуха
|Верхний предел относительной влажности воздуха 80% при +35°С и более низких температурах без конденсации влаги
|-
|Атмосферное давление
|От 86 до 107 кПа
|}

== Маркировка ==
На боковой панели прибора расположена наклейка с информацией о приборе:

* обозначение исполнения Прибора;
* заводской номер Прибора;
* уникальный идентификационный номер Прибора (УИН).

== Устройство и принцип работы прибора ==

=== Подготовка прибора к использованию ===

==== Общие указания ====
В зимнее время тару с прибором распаковывать в отапливаемом помещении не ранее чем через 4 часа после внесения их в помещение. Монтаж, эксплуатация и демонтаж СК-01 должны производиться персоналом, ознакомленным с правилами его эксплуатации и прошедшим инструктаж для работы с электрооборудованием в соответствии с правилами, установленными на предприятии-потребителе.

==== Указания мер безопасности ====
По способу защиты от поражения электрическим током CK-01 соответствует классу 0 по ГОСТ 12.2.007.0-75.

При эксплуатации и техническом обслуживании необходимо соблюдать требования ГОСТ 12.3.019-80, «Правил эксплуатации электроустановок потребителей» и «Правил охраны труда при эксплуатации электроустановок потребителей».

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

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

Установка и извлечение SIM-карты в сетевой шлюз АГАВА СК-01.1должна выполняться только при отключенном питании прибора.

==== Монтаж и подключение прибора ====
Прибор устанавливается на DIN-рейку 35мм. при помощи специального фиксатора (Рисунок 1, Позиция 10), расположенного в верхней части прибора.

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

Установку SIM-карты (Рисунок 1, Позиция 4) в сетевой шлюз АГАВА СК-01.1 производить до установки Прибора на DIN-рейку.

Установку антенн производить после установки прибора на DIN-рейку.

Подключаемые к прибору провода должны быть многожильными сечением от 0,25 до 0,5 мм2. Рекомендуемые типы кабелей МКШ, МКЭШ, МКШМ ГОСТ 10348-80.

Рекомендуется обжимать концы подключаемых проводов наконечниками типа НШВИ.

==== Подключение линий связи ====
Ниже приведены схемы подключения внешних устройств (блоков питания, линии RS-485 и Ethernet) к прибору.

===== Схема подключения питания =====
[[Файл:Power.png|мини|550x550px|Рисунок 2 - Схема подключения питания|альт=|без]]

===== Схема подключения линии RS-485 (без дренажного провода) =====
[[Файл:RS-485 NO DRAIN.png|без|мини|550x550px|Рисунок -3 Схема подключения линии RS-485 (без дренажного провода)|альт=]]

===== Схема подключения линии RS-485 (c дренажным проводом) =====
[[Файл:RS-485 with drain.png|без|мини|550x550px|Рисунок 4 - Схема подключения линии RS-485 (c дренажным проводом)|альт=]]Примечание''':''' для подключения встроенных терминальных резисторов RS-485 (120 Ом) необходимо перевести переключатель SW-1 (Рисунок 1, Позиция 9) в положение “ON” .

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

Для уменьшения влияния электромагнитных помех необходимо выполнять приведенные ниже рекомендации:

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

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

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

=== Интерфейсы прибора и их назначение ===
Прибор оснащен большим количеством интерфейсов передачи данных, имеющих разное назначение.

Интерфейсы связи с системой AgavaCloud:

# 3G-GSM.
# WAN.
# WIFI (клиент).

Интерфейсы для сбора данных с подключаемых устройств:

# LAN.
# RS-485.

Интерфейсы для настройки Прибора:

# LAN
# WIFI (точка доступа).

=== Состав программного обеспечения прибора ===
Программное обеспечение прибора состоит из следующих частей:

* Системное программное обеспечение.
* Прикладное программное обеспечение, обеспечивающее взаимодействие с AgavaCloud.

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

== Порядок работы с прибором ==
=== Первое включение и загрузка ===
[[Файл:АГАВАСК01-Циклограмма работы.png.png|мини|600x600пкс|Рисунок 5 - Циклограмма мигания индикатора USR]]
Подключите прибор к источнику питания +24В соблюдая полярность.

После подачи питания должен загореться индикатор питания “POW” и начаться инициализация. В процессе инициализации будет мигать светодиоды “Wi-Fi”, "USR", "GSM".

Светодиод "USR" индицирует текущий режим/этап работы Прибора с помощью мигания. Характер мигания светодиода в разных режимах показан на рис. 5.

Светодиод "GSM" отображает статус сети. Режимы мигания показаны на рис. 6.

[[Файл:АГАВАСК01-циклограмма-LED-индикатора-GSM.png|мини|599x599px|Рисунок 6 - Циклограмма мигания индикатора GSM|альт=]]

=== Режимы и этапы работы Прибора ===
После включения Прибор последовательно проходит через описываемые ниже режимы и этапы. Характер мигания светодиода в разных режимах показан на рис. 5.

# Режим <code>Подготовка</code>. Начинается после подачи питания.
## Этап <code>Инициализация</code>. Длительность этапа - примерно 10 с.
## Этап <code>Загрузка</code>. Длительность этапа - примерно 60-70 с.
## Этап <code>Окончание загрузки</code>. Длительность этапа - примерно 1-5 с.
# Режим <code>Работа</code>. Примерно через 70 секунд после включения прибор начинает обмен информацией с AgavaCloud, состоящий из следующих этапов:
## Этап <code>Подключение</code> к AgavaCloud. На этом этапе производится установление соединения с AgavaCloud. Длительность режима - примерно 1 с при настроенном подключении Прибора к сети Internet. При отсутствии подключения Прибор находится в данном режиме до установления подключения к AgavaCloud. Светодиод USR кратковременно зажигается (на 100 мс), далее гаснет на 900 мс, после чего цикл повторяется.
## Этап <code>Регистрация</code> в AgavaCloud. На этом этапе подключение к AgavaCloud установлено, прибор авторизуется в системе. После успешной регистрации прибор переходит к следующему этапу. На данном этапе светодиод USR делает два импульса по 100 мс с промежутком в 100 мс, далее гаснет на 700 мс, после чего цикл повторяется. Длительность режима - примерно 1 с. При наличии проблем с регистрацией Прибор находится в данном режиме до установления подключения к AgavaCloud
## Этап <code>Получение задания</code>. Длительность режима при наличии задания (то есть в каком-либо проекте задействован Прибор и для него определена конфигурация) - примерно 1 с, при отсутствии задания прибор находится в этом режиме до тех пор, пока не получит задание. На данном этапе светодиод USR делает три импульса по 100 мс с промежутком в 100 мс, далее гаснет на 500 мс, после чего цикл повторяется.
## Этап <code>Передача данных</code>. Основной этап, в котором находится прибор в нормальном состоянии (настроено подключение и прибор присутствует в каком-либо проекте в AgavaCloud). Светодиод USR попеременно зажигается и гаснет на 1 с.

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

Для настройки Прибора необходимо подключиться к нему одним из следующих способов:

* Кабельное подключение через Ethernet.
* Подключение к встроенной точке доступа WIFI.

==== Настройка Прибора через кабельное подключение через Ethernet ====

* Соедините кабелем Ethernet компьютер и порт LAN Прибора напрямую или через коммутатор.
* Убедитесь, что на компьютере в настройках сетевого адаптера имеется IP-адрес из сети <code>192.168.1.х</code>, например <code>192.168.1.88</code>, маска <code>255.255.255.0</code>.
* Откройте интернет-обозреватель и в адресной строке введите адрес: <code>192.168.1.1</code>. После загрузки прибора браузер автоматически откроет страницу системной утилиты.
* Введите логин и пароль, далее произведите настройку Прибора.

==== Настройка Прибора через Wi-Fi ====
Прибор оснащен модулем WIFI, по умолчанию настроенным на работу в режиме точки доступа, в котором возможно подключение к Прибору для его настройки.

Порядок подключения:
* Откройте на компьютере настройку беспроводных сетей и выполните поиск доступных Wi-Fi сетей, либо на смартфоне включите модуль WIFI и откройте окно выбора сети. В списке сетей должна появиться сеть c именем <code>AGAVA-SK01</code>.
* Подключите компьютер к сети <code>AGAVA-SK01</code>. Сеть <code>AGAVA-SK01</code> является открытой и не требует пароля и шифрования.
* После удачного подключения к <code>AGAVA-SK01</code> откройте интернет-обозреватель и в адресной строке введите адрес устройства: <code>192.168.2.1</code>. Браузер откроет страницу системной утилиты.

* Введите логин и пароль, далее произведите настройку Прибора.

=== Подключение Прибора к сети Internet ===
Для использования Прибора необходимо подключить его к сети Internet одним из следующих способов:

# Кабельное подключение через локальную сеть или напрямую к поставщику услуг сети Internet.
# WIFI подключение к существующей точке доступа.
# Беспроводное 3G/LTE соединение с Internet с помощью встроенного 3G/LTE модема.
{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Установку SIM-карты в Прибор необходимо производить при отключенном электропитании.}}{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Для передачи данных через беспроводное 3G/LTE соединение требуется приобретение у поставщика услуг связи тарифа на передачу данных, совместимого с роутерами}}

=== Настройка подключения Прибора к сети Internet ===
Настройка подключения Прибора к сети осуществляется с помощью встроенной системной утилиты, доступной через интерфейсы прибора LAN или WIFI (в режиме "Точка доступа").

=== Системная утилита ===
Для авторизации используйте следующие реквизиты:

* имя пользователя — <code>web</code>
* пароль — <code>inc23.crffdswe</code>

После ввода реквизитов нажмите кнопку "Войти".
[[Файл:АГАВАСК01-Авторизация.png|мини|АГАВА СК-01-Авторизация|640x640px|альт=|центр]]

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

[[Файл:АГАВАСК01-Начальная-страница-обновленная.png|альт=|мини|640x640px|Начальная страница системной утилиты|центр]]

На странице отображены, сверху вниз:

* полоса заголовка с названием Прибора, выпадающим списком перехода на другие страницы системной утилиты и ссылка "Выйти" для завершения работы с системной утилитой;
* интерфейсы Прибора, их состояние и кнопки управления интерфейсами;
* Кнопки "Применить" и "Сохранить" для сохранения внесенных изменений;
* "подвал" страницы с указанием названия системной утилиты и версии прошивки Прибора.
{{Внимание|Тип=Восклицание синий.png|Текст=Рекомендуется установить новый пароль для входа в системную утилиту. Для этого кликните по вкладке меню «Основные настройки», затем выберете пункт «Пароль сетевого шлюза», далее задайте новый пароль и подтвердите его. Для сохранения изменений нажмите кнопку «Сохранить».}}

==== Настройка сетевых интерфейсов ====

===== Интерфейс 3G-GSM =====

Если в Прибор установлена SIM карта, то после включения и загрузки устройства, на странице «Интерфейсы» в интерфейсе 3g-GSM будет отображен полученный IP-адрес предоставленный оператором связи, а также статистика обмена пакетами (RX) и (TX).[[Файл:АГАВАСК01-3G-Интерфейс.png|мини|640x640px|3g-GSM интерфейс, IP-адрес, статистика обмена пакетами|альт=|центр]]

{{Внимание|Тип=Восклицание синий.png|Текст=Настройку интерфейса 3g-GSM в большинстве случаев производить не требуется, так как она выполняется автоматически при запуске Прибора.}}

При необходимости настройки параметров интерфейса 3g-GSM нажмите кнопку «Изменить».

В открывшемся окне на вкладке «Основные настройки» в полях <code>APN</code>, <code>Имя пользователя</code>, <code>Пароль</code> введите нужные значения параметров.

Для примера ниже приведены настройки для доступа к сети интернет через оператора связи МТС:

* APN: internet.mts.ru.
* Имя пользователя: mts
* Пароль: mts.

[[Файл:АГАВАСК01-Настройка-GSM.png|мини|Настройка параметров интерфейса GSM|640x640px|альт=|центр]]

После внесения изменений нажмите кнопку «Сохранить», при этом автоматически будет выполнен переход на главную страницу. На главной странице отображается плашка "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ", сигнализирующая о внесенных в настройки прибора изменениях, но не принятых в работу.

[[Файл:АГАВАСК01-Главная страница-Изменения.png|альт=|центр|мини|639x639пкс|Начальная страница системной утилиты - внесены изменения в настройки, ожидается их применение]]
Для '''принятия внесенных изменений''' необходимо выполнить одно из двух действий:

* нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Применить";
* нажать на кнопку "Применить" в низу главной страницы, при этом подтверждение не запрашивается и изменения сразу применяются.

Для '''отмены внесенных изменений''' необходимо нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Вернуть".

===== Интерфейс LAN =====

Интерфейс LAN предназначен для сбора данных с подключаемых устройств и настройки самого Прибора.
[[Файл:АГАВАСК01-Интерфейс LAN.png|альт=|центр|мини|640x640пкс|Иинтерфейс LAN: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «LAN» нажмите кнопку «Изменить».

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

* выбор протокола (по умолчанию установлено в «Статический адрес»)
* задание IP адреса, маски сети и адреса шлюза.

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

[[Файл:АГАВАСК01-Настройка-интерфейса-lan.png|мини|640x640px|Настройка интерфейса lan|альт=|центр]]Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WAN =====
Интерфейс WAN предназначен для подключения к системе AgavaCloud.

[[Файл:АГАВАСК01-Интерфейс WAN.png|альт=|центр|мини|640x640пкс|Интерфейс WAN: IP-адрес, статистика обмена пакетами]]

Для настройки интерфейса «WAN» нажмите кнопку «Изменить».

В открывшемся окне отображен статус устройства, имеется возможность выбора режима (по умолчанию установлен режим «DHCP-клиент») и настройки параметров.

[[Файл:АГАВАСК01-Настройка-интерфейса-Wan.png|мини|640x640px|Настройка интерфейса WAN. По умолчанию включен режим DHCP клиент.|альт=|центр]]

Для настройки статического IP-адреса в поле «Режим» из выпадающего списка выберите пункт «Статический адрес», подтвердите выбор нажатием вновь появившейся кнопки «Изменить режим». Далее в полях «IPv4-адрес», «маска сети IPv4», «IPv4-адрес шлюза» внесите необходимые настройки и нажмите кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WAN-Настройка2.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WAN. Настройка режима "Статический адрес".]]

Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WIFI (клиент) =====

Интерфейс WIFI в режиме "Клиент" предназначен для подключения к системе AgavaCloud.
[[Файл:АГАВАСК01-Интерфейс WIFI.png|альт=|центр|мини|640x640пкс|Иинтерфейс WIFI: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «WIFI» нажмите кнопку «Изменить».

В открывшемся окне отображен статус интерфейса, имеются следующие возможности:

* выбор SSID (точки доступа) из списка обнаруженных;
* выбор режима и алгоритма шифрования;
* ввод ключа (пароля) для подключения к точке доступа.

После внесения изменений, необходимо нажать кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WIFI-Настройка.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WIFI (клиент)]]
Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].{{Внимание|Тип=Восклицание синий.png|Текст=При применении настроек WIFI будет выполнен перезапуск сетевых интерфейсов Прибора. Если настройка WIFI Прибора осуществляется со смартфона, то соединение смартфона и точки доступа Прибора будет разорвано и необходимо будет повторно подключиться к точке доступа AGAVA-SK01. При настройке WIFI через LAN таких разрывов нет.}}

==== Дополнительная настройка беспроводных подключений ====
Страница "Беспроводная сеть" системной утилиты позволяет выполнить дополнительные настройки беспроводной сети Прибора:

* Включать или отключать беспроводные интерфейсы WIFI (клиент) и WIFI (точка доступа).
* Изменять настройки собственной точки доступа, например пароль или SSID. Последнее актуально при использовании нескольких приборов с покрытием WIFI одной области.
* Просматривать список клиентов, подключенных к точке доступа и отключать их.

Для перехода к странице "Беспроводная сеть" выберите пункт «Беспроводная сеть» в меню «Основные настройки».

[[Файл:АГАВАСК01-Настройка-беспроводной-сети.png|мини|Страница "Беспроводная сеть"|640x640px|альт=|центр]]

===== Настройка собственной точки доступа (WIFI в режиме "точка доступа") =====
Для настройки собственной точки доступа необходимо на странице "Беспроводная сеть" в разделе «Список беспроводных сетей» нажать кнопку «Изменить» напротив беспроводной сети <code>AGAVA-SK01 | Режим: Master</code>.

В открывшемся окне можно изменить множество настроек точки. Наиболее востребованные параметры - SSID (имя точки), пароль.
После внесения изменений нужно нажать кнопку «Сохранить» в правом нижнем углу окна.
[[Файл:АГАВАСК01-Настройка-беспроводной-сети-в-режим-работы-точка-доступа.png|мини|686x686px|Настройка беспроводной сети в режим работы точка доступа|альт=|центр]]Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

=== Использование Прибора с AgavaCloud ===

==== Регистрация Прибора в AgavaCloud ====
После настройки подключения Прибора к сети Internet необходимо зарегистрировать Прибор в своем проекте AgavaCloud. Регистрация выполняется следующим образом:

# Войдите в свой проект AgavaCloud.
# Откройте раздел <code>Устройства</code> вашего проекта.
# Добавьте устройство типа <code>Шлюз АГАВА СК-01</code> и введите в поле <code>Идентификатор</code> 16-значный УИН, указанный на шильдике, находящемся на корпусе Прибора.

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

==== Добавление подчиненных устройств ====
Прибор поддерживает опрос подчиненных устройств следующих типов:

* Устройства с протоколом Modbus-TCP.
* Устройства с протоколом Modbus-RTU.

===== Добавление устройств с протоколом Modbus-RTU =====
Для опроса Прибором устройств с протоколом Modbus-RTU необходимо в проекте AgavaCloud добавить в шлюз соответствующее устройство.

При заполнении настроек устройства необходимо указать адрес последовательного порта:<code>/dev/ttyS1</code>. Остальные настройки устанавливаются в соответствии с параметрами опрашиваемого устройства.

Дальнейшие операции по настройке проекта для передачи данных Прибора в AgavaCloud описаны на [[Система облачной диспетчеризации AgavaCloud|страницах описания AgavaCloud]].

== Обновление программного обеспечения АГАВА СК-01 ==
Прибор поставляется со всем необходимым установленным системным и прикладным программным обеспечением.

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

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

== Правила транспортирования и хранения ==
Прибор должен транспортироваться в упаковке при температуре от -30 °С до +80 °С и относительной влажности воздуха не более 95 % (при 35 °С).

Транспортирование допускается всеми видами закрытого транспорта.

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

Условия хранения прибора в транспортной таре на складе потребителя должны соответствовать условиям 1 по ГОСТ 15150-69.

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

== Техническое обслуживание ==
Прибор специального обслуживания не требует.

Периодически не реже чем раз в 6 месяцев проводить:

* осмотр прибора на внешние повреждения;
* соединения зажимных контактов;
* очистку прибора от пыли и грязи;
* качества крепления на DIN-рейке.

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

== Комплектность ==
{| class="wikitable"
|+
|№ п/п
|Наименование
|Количество,
шт.
|-
|1
|Сетевой шлюз АГАВА СК-01
|1
|-
|2
|Антенна Wi-Fi (2dB)
|1
|-
|3
|Антенна GSM (2dB) *
|1
|-
|4
|Паспорт
|1
|}
<nowiki>*</nowiki> Вариант исполнения с GSM модемом СК-01.1

== Гарантийные обязательства ==
Гарантийный срок эксплуатации – 12 месяцев со дня продажи.

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

Для отправки в ремонт необходимо вложить в тару с сетевым шлюзом АГАВА СК-01 паспорт, акт отказа и отправить по адресу:

620144, г. Екатеринбург, ул. Верещагина, д. 6а, ООО КБ «АГАВА»

Тел: (343) 382-01-92.

Руководство по эксплуатации АГАВА СК-01

2026-03-11T07:06:03Z

TaushkanovKV: /* Интерфейс LAN */

== Введение ==
Данное руководство по эксплуатации содержит сведения, необходимые для обеспечения правильной эксплуатации и полного использования технических возможностей сетевого шлюза АГАВА СК-01, далее по тексту: прибор, СК-01 или шлюз.

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

== Назначение ==

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

Подключение к внешним устройствам осуществляется через Ethernet, Wi-Fi, RS-485 (MODBUS-RTU);

=== Используемые термины и сокращения ===
ПК – персональный компьютер;

ОС – операционная система;

ПО – программное обеспечение;

ОЗУ – оперативное запоминающее устройство;

ФС – файловая система.

=== Условное обозначение прибора ===
Пример полного условного обозначения прибора:

* СК-01.1 – базовое исполнение;
* СК-01.2 – исполнение без GSM модема.

== Оснащение прибора ==

=== Состав прибора ===

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

На корпусе прибора установлены разъёмы для подключения внешних антенн.

На варианте исполнения СК-01.1 установлено 2 разъема для подключения антенн Wi-Fi и GSM (LTE) модема, СК-01.2 установлен 1 разъем для подключения антенны Wi-Fi.

В месте с прибором в зависимости от варианта исполнения поставляются одна (две) антенна(ы) с коэффициентом усиления 2dB.

В прибор СК-01.1 для работы GSM (LTE) модема устанавливается стандартная SIM-карта.

=== Конструкция Прибора ===
Габаритные размеры и позиционные обозначения компонентов Прибора приведены на рисунке ниже.
[[Файл:Views 1.png|без|мини|550x550пкс|Рисунок 1 - Габаритные размеры и позиционные обозначения СК-01]]Обозначение компонентов приведено в таблице ниже:
{| class="wikitable"
!Позиционное
обозначение
!Расшифровка
|-
|1
|GSM антенна
|-
|2
|Wi-Fi антенна
|-
|3
|Кнопка сброса настроек
|-
|4
|Место установки SIM карты
|-
|5
|Разъем подключения LAN
|-
|6
|Клемник подключения питания и RS-485
|-
|7
|Разъем подключения WAN
|-
|8
|Светодиодные индикаторы
|-
|9
|Переключатель для подключения встроенного терминального резистора RS-485
|-
|10
|Фиксатор прибора на DIN-рейке
|}

=== Технические характеристики ===
{| class="wikitable" style="width:75%"
|+

!№ п/п
! colspan="3" |Общие сведения
|-
|1
|Конструктивное исполнение
| colspan="2" |Моноблок на DIN-рейку
|-
|2
|Габаритные размеры (ВхШхГ), мм:
| colspan="2" |88 × 35 × 62

188 × 35 × 62 – с установленной антенной
|-
|3
|Масса прибора, не более, кг
| colspan="2" |0.120
|-
|4
|Степень защиты корпуса
| colspan="2" |IP20
|-
|5
|Напряжение питания
| colspan="2" |24 В ±10 % постоянного тока
|-
|6
|Потребляемая мощность, не более
| colspan="2" |12 Вт
|-
! colspan="4" |Интерфейсы подключения к AgavaCloud
|-
!style="width:3%" |
!style="width:13%" |
!style="width:20%" | АГАВА СК-01.1
!style="width:20%" | АГАВА СК-01.2
|-
|7
|Ethernet
| colspan="2" |WAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|8
|Wi-Fi
| colspan="2" |Режим "Клиент", стандарты 802.11 b/g/n, антенна внешняя.
Макс. чувствительность приемника 76 дБ, макс. мощность передатчика 21.1 дБ.

Тип разъема для антенны – SMA-F
|-
|9
|GSM
|1шт., GSM(LTE) - LTE CAT1 модуль, с поддержкой LTE-TDD/LTE-FDD.
Максимальная скорость загрузки 10Mbps, скорость передачи - 5Mbps.

Тип разъема для антенны – SMA-F

Стандартная mini-SIM карта с поддержкой всех операторов беспроводной связи
|Отсутствует
|-
! colspan="4" |Интерфейсы подключения устройств
|-
|10
|Ethernet
| colspan="2" |LAN - 1 шт., скорость 10/100 Мб/с, гальваническая развязка
|-
|11
|RS-485
| colspan="2" |1шт. с гальванической развязкой, скорость до 115200 Mбит/с включительно
|-
! colspan="4" |Индикация и управление
|-
| rowspan="6" |12
| rowspan="6" |Индикация
| colspan="2" |Индикатор наличия питания - <code>POW</code>
|-
| colspan="2" |Индикатор состояния GSM модема - <code>GSM</code>
|-
| colspan="2" |Индикатор состояния WIFI - <code>WiFi</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейса RS-485 - <code>RX</code> <code>TX</code>
|-
| colspan="2" |Индикаторы приема-передачи интерфейсов Ethernet (на разъемах интерфейсов)
|-
| colspan="2" |Индикатор режима работы - <code>USR</code>
|-
|13
|Органы управления
| colspan="2" |Кнопка сброса, возврата к заводским установкам
|-
|14
|Переключатель
| colspan="2" |Включение и отключение терминального резистора
|}

== Условия эксплуатации ==
{| class="wikitable"
! colspan="2" |Условия эксплуатации
|-
|Тип помещения
|Закрытые взрывобезопасные помещения без агрессивных паров и газов
|-
|Температура окружающего воздуха
|От 0 до +50°С
|-
|Влажность воздуха
|Верхний предел относительной влажности воздуха 80% при +35°С и более низких температурах без конденсации влаги
|-
|Атмосферное давление
|От 86 до 107 кПа
|}

== Маркировка ==
На боковой панели прибора расположена наклейка с информацией о приборе:

* обозначение исполнения Прибора;
* заводской номер Прибора;
* уникальный идентификационный номер Прибора (УИН).

== Устройство и принцип работы прибора ==

=== Подготовка прибора к использованию ===

==== Общие указания ====
В зимнее время тару с прибором распаковывать в отапливаемом помещении не ранее чем через 4 часа после внесения их в помещение. Монтаж, эксплуатация и демонтаж СК-01 должны производиться персоналом, ознакомленным с правилами его эксплуатации и прошедшим инструктаж для работы с электрооборудованием в соответствии с правилами, установленными на предприятии-потребителе.

==== Указания мер безопасности ====
По способу защиты от поражения электрическим током CK-01 соответствует классу 0 по ГОСТ 12.2.007.0-75.

При эксплуатации и техническом обслуживании необходимо соблюдать требования ГОСТ 12.3.019-80, «Правил эксплуатации электроустановок потребителей» и «Правил охраны труда при эксплуатации электроустановок потребителей».

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

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

Установка и извлечение SIM-карты в сетевой шлюз АГАВА СК-01.1должна выполняться только при отключенном питании прибора.

==== Монтаж и подключение прибора ====
Прибор устанавливается на DIN-рейку 35мм. при помощи специального фиксатора (Рисунок 1, Позиция 10), расположенного в верхней части прибора.

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

Установку SIM-карты (Рисунок 1, Позиция 4) в сетевой шлюз АГАВА СК-01.1 производить до установки Прибора на DIN-рейку.

Установку антенн производить после установки прибора на DIN-рейку.

Подключаемые к прибору провода должны быть многожильными сечением от 0,25 до 0,5 мм2. Рекомендуемые типы кабелей МКШ, МКЭШ, МКШМ ГОСТ 10348-80.

Рекомендуется обжимать концы подключаемых проводов наконечниками типа НШВИ.

==== Подключение линий связи ====
Ниже приведены схемы подключения внешних устройств (блоков питания, линии RS-485 и Ethernet) к прибору.

===== Схема подключения питания =====
[[Файл:Power.png|мини|550x550px|Рисунок 2 - Схема подключения питания|альт=|без]]

===== Схема подключения линии RS-485 (без дренажного провода) =====
[[Файл:RS-485 NO DRAIN.png|без|мини|550x550px|Рисунок -3 Схема подключения линии RS-485 (без дренажного провода)|альт=]]

===== Схема подключения линии RS-485 (c дренажным проводом) =====
[[Файл:RS-485 with drain.png|без|мини|550x550px|Рисунок 4 - Схема подключения линии RS-485 (c дренажным проводом)|альт=]]Примечание''':''' для подключения встроенных терминальных резисторов RS-485 (120 Ом) необходимо перевести переключатель SW-1 (Рисунок 1, Позиция 9) в положение “ON” .

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

Для уменьшения влияния электромагнитных помех необходимо выполнять приведенные ниже рекомендации:

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

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

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

=== Интерфейсы прибора и их назначение ===
Прибор оснащен большим количеством интерфейсов передачи данных, имеющих разное назначение.

Интерфейсы связи с системой AgavaCloud:

# 3G-GSM.
# WAN.
# WIFI (клиент).

Интерфейсы для сбора данных с подключаемых устройств:

# LAN.
# RS-485.

Интерфейсы для настройки Прибора:

# LAN
# WIFI (точка доступа).

=== Состав программного обеспечения прибора ===
Программное обеспечение прибора состоит из следующих частей:

* Системное программное обеспечение.
* Прикладное программное обеспечение, обеспечивающее взаимодействие с AgavaCloud.

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

== Порядок работы с прибором ==
=== Первое включение и загрузка ===
[[Файл:АГАВАСК01-Циклограмма работы.png.png|мини|600x600пкс|Рисунок 5 - Циклограмма мигания индикатора USR]]
Подключите прибор к источнику питания +24В соблюдая полярность.

После подачи питания должен загореться индикатор питания “POW” и начаться инициализация. В процессе инициализации будет мигать светодиоды “Wi-Fi”, "USR", "GSM".

Светодиод "USR" индицирует текущий режим/этап работы Прибора с помощью мигания. Характер мигания светодиода в разных режимах показан на рис. 5.

Светодиод "GSM" отображает статус сети. Режимы мигания показаны на рис. 6.

[[Файл:АГАВАСК01-циклограмма-LED-индикатора-GSM.png|мини|599x599px|Рисунок 6 - Циклограмма мигания индикатора GSM|альт=]]

=== Режимы и этапы работы Прибора ===
После включения Прибор последовательно проходит через описываемые ниже режимы и этапы. Характер мигания светодиода в разных режимах показан на рис. 5.

# Режим <code>Подготовка</code>. Начинается после подачи питания.
## Этап <code>Инициализация</code>. Длительность этапа - примерно 10 с.
## Этап <code>Загрузка</code>. Длительность этапа - примерно 60-70 с.
## Этап <code>Окончание загрузки</code>. Длительность этапа - примерно 1-5 с.
# Режим <code>Работа</code>. Примерно через 70 секунд после включения прибор начинает обмен информацией с AgavaCloud, состоящий из следующих этапов:
## Этап <code>Подключение</code> к AgavaCloud. На этом этапе производится установление соединения с AgavaCloud. Длительность режима - примерно 1 с при настроенном подключении Прибора к сети Internet. При отсутствии подключения Прибор находится в данном режиме до установления подключения к AgavaCloud. Светодиод USR кратковременно зажигается (на 100 мс), далее гаснет на 900 мс, после чего цикл повторяется.
## Этап <code>Регистрация</code> в AgavaCloud. На этом этапе подключение к AgavaCloud установлено, прибор авторизуется в системе. После успешной регистрации прибор переходит к следующему этапу. На данном этапе светодиод USR делает два импульса по 100 мс с промежутком в 100 мс, далее гаснет на 700 мс, после чего цикл повторяется. Длительность режима - примерно 1 с. При наличии проблем с регистрацией Прибор находится в данном режиме до установления подключения к AgavaCloud
## Этап <code>Получение задания</code>. Длительность режима при наличии задания (то есть в каком-либо проекте задействован Прибор и для него определена конфигурация) - примерно 1 с, при отсутствии задания прибор находится в этом режиме до тех пор, пока не получит задание. На данном этапе светодиод USR делает три импульса по 100 мс с промежутком в 100 мс, далее гаснет на 500 мс, после чего цикл повторяется.
## Этап <code>Передача данных</code>. Основной этап, в котором находится прибор в нормальном состоянии (настроено подключение и прибор присутствует в каком-либо проекте в AgavaCloud). Светодиод USR попеременно зажигается и гаснет на 1 с.

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

Для настройки Прибора необходимо подключиться к нему одним из следующих способов:

* Кабельное подключение через Ethernet.
* Подключение к встроенной точке доступа WIFI.

==== Настройка Прибора через кабельное подключение через Ethernet ====

* Соедините кабелем Ethernet компьютер и порт LAN Прибора напрямую или через коммутатор.
* Убедитесь, что на компьютере в настройках сетевого адаптера имеется IP-адрес из сети <code>192.168.1.х</code>, например <code>192.168.1.88</code>, маска <code>255.255.255.0</code>.
* Откройте интернет-обозреватель и в адресной строке введите адрес: <code>192.168.1.1</code>. После загрузки прибора браузер автоматически откроет страницу системной утилиты.
* Введите логин и пароль, далее произведите настройку Прибора.

==== Настройка Прибора через Wi-Fi ====
Прибор оснащен модулем WIFI, по умолчанию настроенным на работу в режиме точки доступа, в котором возможно подключение к Прибору для его настройки.

Порядок подключения:
* Откройте на компьютере настройку беспроводных сетей и выполните поиск доступных Wi-Fi сетей, либо на смартфоне включите модуль WIFI и откройте окно выбора сети. В списке сетей должна появиться сеть c именем <code>AGAVA-SK01</code>.
* Подключите компьютер к сети <code>AGAVA-SK01</code>. Сеть <code>AGAVA-SK01</code> является открытой и не требует пароля и шифрования.
* После удачного подключения к <code>AGAVA-SK01</code> откройте интернет-обозреватель и в адресной строке введите адрес устройства: <code>192.168.2.1</code>. Браузер откроет страницу системной утилиты.

* Введите логин и пароль, далее произведите настройку Прибора.

=== Подключение Прибора к сети Internet ===
Для использования Прибора необходимо подключить его к сети Internet одним из следующих способов:

# Кабельное подключение через локальную сеть или напрямую к поставщику услуг сети Internet.
# WIFI подключение к существующей точке доступа.
# Беспроводное 3G/LTE соединение с Internet с помощью встроенного 3G/LTE модема.
{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Установку SIM-карты в Прибор необходимо производить при отключенном электропитании.}}{{Внимание|Тип=Восклицание синий.png|Текст=Обратите внимание! Для передачи данных через беспроводное 3G/LTE соединение требуется приобретение у поставщика услуг связи тарифа на передачу данных, совместимого с роутерами}}

=== Настройка подключения Прибора к сети Internet ===
Настройка подключения Прибора к сети осуществляется с помощью встроенной системной утилиты, доступной через интерфейсы прибора LAN или WIFI (в режиме "Точка доступа").

=== Системная утилита ===
Для авторизации используйте следующие реквизиты:

* имя пользователя — <code>web</code>
* пароль — <code>inc23.crffdswe</code>

После ввода реквизитов нажмите кнопку "Войти".
[[Файл:АГАВАСК01-Авторизация.png|мини|АГАВА СК-01-Авторизация|640x640px|альт=|центр]]

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

[[Файл:АГАВАСК01-Начальная-страница-обновленная.png|альт=|мини|640x640px|Начальная страница системной утилиты|центр]]

На странице отображены, сверху вниз:

* полоса заголовка с названием Прибора, выпадающим списком перехода на другие страницы системной утилиты и ссылка "Выйти" для завершения работы с системной утилитой;
* интерфейсы Прибора, их состояние и кнопки управления интерфейсами;
* Кнопки "Применить" и "Сохранить" для сохранения внесенных изменений;
* "подвал" страницы с указанием названия системной утилиты и версии прошивки Прибора.
{{Внимание|Тип=Восклицание синий.png|Текст=Рекомендуется установить новый пароль для входа в системную утилиту. Для этого кликните по вкладке меню «Основные настройки», затем выберете пункт «Пароль сетевого шлюза», далее задайте новый пароль и подтвердите его. Для сохранения изменений нажмите кнопку «Сохранить».}}

==== Настройка сетевых интерфейсов ====

===== Интерфейс 3G-GSM =====

Если в Прибор установлена SIM карта, то после включения и загрузки устройства, на странице «Интерфейсы» в интерфейсе 3g-GSM будет отображен полученный IP-адрес предоставленный оператором связи, а также статистика обмена пакетами (RX) и (TX).[[Файл:АГАВАСК01-3G-Интерфейс.png|мини|640x640px|3g-GSM интерфейс, IP-адрес, статистика обмена пакетами|альт=|центр]]

{{Внимание|Тип=Восклицание синий.png|Текст=Настройку интерфейса 3g-GSM в большинстве случаев производить не требуется, так как она выполняется автоматически при запуске Прибора.}}

При необходимости настройки параметров интерфейса 3g-GSM нажмите кнопку «Изменить».

В открывшемся окне на вкладке «Основные настройки» в полях <code>APN</code>, <code>Имя пользователя</code>, <code>Пароль</code> введите нужные значения параметров.

Для примера ниже приведены настройки для доступа к сети интернет через оператора связи МТС:

* APN: internet.mts.ru.
* Имя пользователя: mts
* Пароль: mts.

[[Файл:АГАВАСК01-Настройка-GSM.png|мини|Настройка параметров интерфейса GSM|640x640px|альт=|центр]]

После внесения изменений нажмите кнопку «Сохранить», при этом автоматически будет выполнен переход на главную страницу. На главной странице отображается плашка "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ", сигнализирующая о внесенных в настройки прибора изменениях, но не принятых в работу.

[[Файл:АГАВАСК01-Главная страница-Изменения.png|альт=|центр|мини|639x639пкс|Начальная страница системной утилиты - внесены изменения в настройки, ожидается их применение]]
Для '''принятия внесенных изменений''' необходимо выполнить одно из двух действий:

* нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Применить";
* нажать на кнопку "Применить" в низу главной страницы, при этом подтверждение не запрашивается и изменения сразу применяются.

Для '''отмены внесенных изменений''' необходимо нажать на плашку "НЕ ПРИНЯТЫЕ ИЗМЕНЕНИЯ" и в открывшемся окне нажать кнопку "Вернуть".

===== Интерфейс LAN =====

Интерфейс LAN предназначен для сбора данных с подключаемых устройств и настройки самого Прибора.
[[Файл:АГАВАСК01-Интерфейс LAN.png|альт=|центр|мини|640x640пкс|Иинтерфейс LAN: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «LAN» нажмите кнопку «Изменить».

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

* выбор протокола (по умолчанию установлено в «Статический адрес»)
* задание IP адреса, маски сети и адреса шлюза.

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

[[Файл:АГАВАСК01-Настройка-интерфейса-lan.png|мини|640x640px|Настройка интерфейса lan|альт=|центр]]Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WAN =====
Интерфейс WAN предназначен для подключения к системе AgavaCloud.

[[Файл:АГАВАСК01-Интерфейс WAN.png|альт=|центр|мини|640x640пкс|Интерфейс WAN: IP-адрес, статистика обмена пакетами]]

Для настройки интерфейса «WAN» нажмите кнопку «Изменить».

В открывшемся окне отображен статус устройства, имеется возможность выбора режима (по умолчанию установлен режим «DHCP-клиент») и настройки параметров.

[[Файл:АГАВАСК01-Настройка-интерфейса-Wan.png|мини|640x640px|Настройка интерфейса WAN. По умолчанию включен режим DHCP клиент.|альт=|центр]]

Для настройки статического IP-адреса в поле «Режим» из выпадающего списка выберите пункт «Статический адрес», подтвердите выбор нажатием вновь появившейся кнопки «Изменить режим». Далее в полях «IPv4-адрес», «маска сети IPv4», «IPv4-адрес шлюза» внесите необходимые настройки и нажмите кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WAN-Настройка2.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WAN. Настройка режима "Статический адрес".]]

Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].

===== Интерфейс WIFI (клиент) =====

Интерфейс WIFI в режиме "Клиент" предназначен для подключения к системе AgavaCloud.
[[Файл:АГАВАСК01-Интерфейс WIFI.png|альт=|центр|мини|640x640пкс|Иинтерфейс WIFI: IP-адрес, статистика обмена пакетами]]
Для настройки интерфейса «WIFI» нажмите кнопку «Изменить».

В открывшемся окне отображен статус интерфейса, имеются следующие возможности:

* выбор SSID (точки доступа) из списка обнаруженных;
* выбор режима и алгоритма шифрования;
* ввод ключа (пароля) для подключения к точке доступа.

После внесения изменений, необходимо нажать кнопку «Сохранить».
[[Файл:АГАВАСК01-Интерфейс WIFI-Настройка.png|альт=|центр|мини|640x640пкс|Настройка интерфейса WIFI (клиент)]]
Применение или отмена внесенных изменений на главном экране осуществляется аналогично применению настроек [[Руководство по эксплуатации АГАВА СК-01#Интерфейс 3G-GSM|интерфейса 3G-GSM]].{{Внимание|Тип=Восклицание синий.png|Текст=При применении настроек WIFI будет выполнен перезапуск сетевых интерфейсов Прибора. Если настройка WIFI Прибора осуществляется со смартфона, то соединение смартфона и точки доступа Прибора будет разорвано и необходимо будет повторно подключиться к точке доступа AGAVA-SK01. При настройке WIFI через LAN таких разрывов нет.}}

==== Дополнительная настройка беспроводных подключений ====
Страница "Беспроводная сеть" системной утилиты позволяет выполнить дополнительные настройки беспроводной сети Прибора:

* Включать или отключать беспроводные интерфейсы WIFI (клиент) и WIFI (точка доступа).
* Изменять настройки собственной точки доступа, например пароль или SSID. Последнее актуально при использовании нескольких приборов с покрытием WIFI одной области.
* Просматривать список клиентов, подключенных к точке доступа и отключать их.

Для перехода к странице "Беспроводная сеть" выберите пункт «Беспроводная сеть» в меню «Основные настройки».

[[Файл:АГАВАСК01-Настройка-беспроводной-сети.png|мини|Страница "Беспроводная сеть"|640x640px|альт=|центр]]

===== Настройка режима «Точка доступа» =====
В разделе «Список беспроводных сетей» нажмите кнопку «Изменить». В открывшемся окне на вкладке «Основные настройки» в разделе «Настройка сети», в поле «Режим» из выпадающего списка выберите пункт «Точка доступа», в поле «ESSID» задайте название точки доступа и нажмите кнопку «Сохранить», затем кнопку «Применить».
[[Файл:АГАВАСК01-Настройка-беспроводной-сети-в-режим-работы-точка-доступа.png|мини|686x686px|Настройка беспроводной сети в режим работы точка доступа|альт=|центр]]

=== Использование Прибора с AgavaCloud ===

==== Регистрация Прибора в AgavaCloud ====
После настройки подключения Прибора к сети Internet необходимо зарегистрировать Прибор в своем проекте AgavaCloud. Регистрация выполняется следующим образом:

# Войдите в свой проект AgavaCloud.
# Откройте раздел <code>Устройства</code> вашего проекта.
# Добавьте устройство типа <code>Шлюз АГАВА СК-01</code> и введите в поле <code>Идентификатор</code> 16-значный УИН, указанный на шильдике, находящемся на корпусе Прибора.

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

==== Добавление подчиненных устройств ====
Прибор поддерживает опрос подчиненных устройств следующих типов:

* Устройства с протоколом Modbus-TCP.
* Устройства с протоколом Modbus-RTU.

===== Добавление устройств с протоколом Modbus-RTU =====
Для опроса Прибором устройств с протоколом Modbus-RTU необходимо в проекте AgavaCloud добавить в шлюз соответствующее устройство.

При заполнении настроек устройства необходимо указать адрес последовательного порта:<code>/dev/ttyS1</code>. Остальные настройки устанавливаются в соответствии с параметрами опрашиваемого устройства.

Дальнейшие операции по настройке проекта для передачи данных Прибора в AgavaCloud описаны на [[Система облачной диспетчеризации AgavaCloud|страницах описания AgavaCloud]].

== Обновление программного обеспечения АГАВА СК-01 ==
Прибор поставляется со всем необходимым установленным системным и прикладным программным обеспечением.

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

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

== Правила транспортирования и хранения ==
Прибор должен транспортироваться в упаковке при температуре от -30 °С до +80 °С и относительной влажности воздуха не более 95 % (при 35 °С).

Транспортирование допускается всеми видами закрытого транспорта.

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

Условия хранения прибора в транспортной таре на складе потребителя должны соответствовать условиям 1 по ГОСТ 15150-69.

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

== Техническое обслуживание ==
Прибор специального обслуживания не требует.

Периодически не реже чем раз в 6 месяцев проводить:

* осмотр прибора на внешние повреждения;
* соединения зажимных контактов;
* очистку прибора от пыли и грязи;
* качества крепления на DIN-рейке.

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

== Комплектность ==
{| class="wikitable"
|+
|№ п/п
|Наименование
|Количество,
шт.
|-
|1
|Сетевой шлюз АГАВА СК-01
|1
|-
|2
|Антенна Wi-Fi (2dB)
|1
|-
|3
|Антенна GSM (2dB) *
|1
|-
|4
|Паспорт
|1
|}
<nowiki>*</nowiki> Вариант исполнения с GSM модемом СК-01.1

== Гарантийные обязательства ==
Гарантийный срок эксплуатации – 12 месяцев со дня продажи.

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

Для отправки в ремонт необходимо вложить в тару с сетевым шлюзом АГАВА СК-01 паспорт, акт отказа и отправить по адресу:

620144, г. Екатеринбург, ул. Верещагина, д. 6а, ООО КБ «АГАВА»

Тел: (343) 382-01-92.