Alpha.Community

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

Диагностика работы модуля

Служебные сигналы

Модуль Modbus RTU Опросчик динамически создает служебные сигналы:

Контроль счетчика кадров

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

Service.Modules.<Имя модуля>.Channels.Channel_<Номер канала>.DataExchangeСounter.<Имя сигнала>

Сигнал Тип Описание сигнала
MinimumUpdatePeriod

uint1

Текущий минимальный период обновления счётчика в секундах. Начальное значение при инициализации работы модуля – 5 секунд.

Устанавливается путем записи в служебный сигнал MinimumUpdatePeriod.Set необходимого значения.

FramesErrorsReceived

uint8

Количество кадров с ошибками, полученных с момент последнего сброса счётчика.
FramesReceived

uint8

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

uint8

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

uint8

Метка времени последнего сброса счётчика в формате Filetime.
LastResetTimestampString

string

Метка времени последнего сброса счётчика в строковом формате.
Reset

bool

Команда ручного сброса счётчика.

Контроль состояния связи

Полный тег служебных сигналов контроля состояния связи:

Service.Modules.<Имя модуля>.Station <номер станции>.<Имя сигнала>

Сигнал Тип Описание сигнала
Enabled

bool

Доступность станции для обмена данными:

  • True – взаимодействие со станцией возможно;
  • False – взаимодействие со станцией невозможно.

Возможность взаимодействия со станцией устанавливается путем записи в служебный сигнал Enabled.Set одного из значений:

  • True – сделать возможным взаимодействие со станцией;
  • False – сделать невозможным взаимодействие со станцией.
ConnectionState

bool

Состояние связи со станцией:

  • True – есть связь;
  • False – нет связи.
ReceivedResponseCount

uint4

Количество принятых ответов.
SentRequestCount

uint4

Количество отправленных запросов.

Контроль и управление основными параметрами модуля

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

Service.Modules.<Имя модуля>

Стандартные служебные сигналы:

Сигнал Тип Описание сигнала
Active

bool

Активность модуля:

  • True – запущен;
  • False – остановлен.

Соответствует значению параметра Активность. Управляется служебным сигналом Active.Set.

FrameLogEnable

bool

Ведение журнала работы:

  • True – ведется;
  • False – не ведётся.

Соответствует значению параметра Вести журнал работы модуля. Управляется служебным сигналом FrameLogEnable.Set.

SystemLogTraceLevel

uint4

Уровень детализации журнала работы:

  • 1 – предупреждения и аварийные сообщения;
  • 2 – информационные сообщения;
  • 3 – отладочные сообщения.

Соответствует значению параметра Уровень трассировки в журнал приложений. Управляется служебным сигналом SystemLogTraceLevel.Set.

Id

string

Идентификатор модуля в конфигурации Alpha.Server.

Статистика

Статистическая информация о работе Alpha.Server отображается на вкладке Статистика сервисного приложения Конфигуратор, а также в сервисном приложении Статистика. Чтобы просмотреть статистическую информацию модуля Modbus RTU Опросчик, запустите сервисное приложение Статистика или Конфигуратор, и подключитесь к Alpha.Server.

Статистика модуля

Чтобы посмотреть статистику работы модуля, выделите в дереве статистики узел модуля Modbus RTU Опросчик.

Параметр Описание
Общие параметры
Идентификатор модуля Идентификатор модуля в конфигурации Alpha.Server.
Имя модуля Название модуля в конфигурации Alpha.Server.
Исполняемый файл

Имя исполняемого файла модуля в каталоге установки Alpha.Server.

Версия

Версия модуля Modbus RTU Опросчик.

Активность

Признак активности модуля (запущен или остановлен).

Вести журнал работы модуля

Ведение журнала сообщений о работе модуля.

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

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

Время старта

Время запуска модуля.

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

Статистика станции

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

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

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

Сигналы статуса доставки Количество обслуживаемых сигналов статуса доставки.

Статистика категории данных

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

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

Статистика нагрузки

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

Параметр Описание
Исходящие изменения

Общее количество изменений

Суммарное количество исходящих изменений сигналов с разными типами данных.

Список протокольных типов

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

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

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

Журнал работы модуля

Модуль Modbus RTU Опросчик ведёт журнал работы, в который записывается информация о работе модуля и обмене данными с подчиненными станциями.

Чтобы Modbus RTU Опросчик вёл журнал работы, в общих параметрах модуля установите параметру Вести журнал работы модуля значение Да или установите сервисному сигналу модуля FrameLogEnable.Set значение true.

Журнал работы модуля сохраняется в файл <имя модуля>.aplog в папке сервера, по умолчанию:

  • в ОС Windows в п апке C:\Program Files\Automiq\Alpha.Server\Logs;
  • в системах Linux в директории /opt/Automiq/Alpha.Server/Logs.

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

Структура кадров модуля

Исходящий и входящий кадры модуля Modbus RTU Опросчик имеют структуру:

Адрес Код функции Данные Контрольная сумма
1 байт 1 байт до 253 байт 2 байта
  • Адрес – номер подчиненной станции в диапазоне от 1 до 255, с которой выполняется обмен данными.
  • Код функции – функция записи или чтения данных сегмента памяти подчиненной станции.
  • Данные (формат и длина поля зависит от кода функции):
    • в исходящем кадре – данные, необходимые для выполнения функции;
    • во входящем кадре – данные, предоставленные подчиненной станцией.
  • Контрольная сумма – проверка отсутствия ошибок в кадре.

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

Индикация байт в поле побайтового представления кадра данных приведена в таблице:

Байт Цвет Описание
0 Голубой Адрес подчиненной станции
1 Светло голубой Код функции
от 2 до N Светло-серый Данные (формат и длина зависит от кода функции)
N+1, N+2 Желтый Контрольная сумма

Кадры функций чтения

Исходящий кадр для функций 01 (0х01) – 04 (0х04) имеет структуру:

Адрес Код функции Начальный адрес Количество Контрольная сумма
1 байт 1 байт 2 байта 2 байта 2 байта
  • Начальный адрес – адрес первого элемента сегмента памяти подчиненной станции, значение которого требуется прочитать.
  • Количество – количество считываемых элементов.

Входящий кадр для функций 01 (0х01) – 04 (0х04) имеет структуру:

Адрес Код функции Число байт Данные Контрольная сумма
1 байт 1 байт 1 байт N байт 2 байта
  • Число байт – количество байт полученных данных.
  • Данные – полученные значения.

Исходящий кадр функции 01 (0х01) Read Coils:

Байт Данные Описание
0 01 Адрес станции – 1
1 01 Код функции – 01 (0х01)
2, 3 00 68 Начальный адрес – 104
4, 5 00 03 Количество – 3
6, 7 FD D7 Контрольная сумма

Входящий кадр функции 01 (0х01) Read Coils:

Байт Данные Описание
0 01 Адрес станции – 1
1 01 Код функции – 01 (0х01)
2 01 Число байт – 1
3 00 Значение – 0
4, 5 51 88 Контрольная сумма

Исходящий кадр функции 20 (0х14) имеет структуру:

Адрес Код функции Число байт Подзапрос Контрольная сумма
Тип ссылки Номер файла Номер записи Длина записи
1 байт 1 байт 1 байт 1 байт 2 байта 2 байта 2 байта 2 байта
  • Число байт –количество байт данных в подзапросе.
  • Подзапрос – группа для чтения, содержащая 7 байт данных для запроса:
    • Тип ссылки –тип ссылки на данные, спецификацией определен код 0х06.
    • Номер файла – номер файла расширенной памяти.
    • Номер записи – адрес регистра внутри файла расширенной памяти.
    • Длина записи – количество регистров для чтения.

Входящий кадр функции 20 (0х14) имеет структуру:

Адрес Код функции Число байт Ответ Контрольная сумма
Число байт Тип ссылки Данные
1 байт 1 байт 1 байт 1 байт 1 байт N байт 2 байта
  • Число байт – общее количество байт полученных данных.
  • Ответ – группа полученных данных:
    • Число байт – количество байт данных ответа.
    • Тип ссылки – тип ссылки на данные, спецификацией определен код 0х06.
    • Данные – полученные значения.

Исходящий кадр функции 20 (0х14) Read File Record:

Байт Данные Описание
0 01 Адрес станции – 1
1 14 Код функции – 20 (0х14)
2 07 Число байт подзапроса – 7
3 06 Тип ссылки – 6
4, 5 00 01 Номер файла – 1
6, 7 00 00 Номер записи – 0
8, 9 00 02 Длина записи – 2
10, 11 45 25 Контрольная сумма

Входящий кадр функции 20 (0х14) Read File Record:

Байт Данные Описание
0 01 Адрес станции – 1
1 14 Код функции – 20 (0х14)
2 06 Число байт – 6
3 05 Число байт ответа – 5
4 06 Тип ссылки – 6
5, 6 00 0A Значение записи 0 – 10
7, 8 00 14 Значение записи 1 – 20
9, 10 51 88 Контрольная сумма

Кадры функций записи

Исходящий кадр для функций 05 (0х05) и 06 (0х06) имеет структуру:

Адрес Код функции Начальный адрес Значение Контрольная сумма
1 байт 1 байт 2 байта 2 байта 2 байта
  • Адрес элемента – адрес элемента сегмента памяти подчиненной станции, значение которого требуется изменить.
  • Значение – устанавливаемое значение.

Если функция выполнена успешно, то входящий кадр содержит копию исходящего кадра.

Исходящий кадр функции 05 (0х05) Write Single Coil:

Входящий кадр функции 05 (0х05) Write Single Coil:

Байт Данные Описание
0 01 Адрес станции – 1
1 05 Код функции – 05 (0х05)
2, 3 00 01 Адрес элемента – 1
4, 5 FF 00 Значение – ON (00 00 соответствует значению OFF)
6, 7 DD FA Контрольная сумма

Исходящий кадр функции 16 (0х10) имеет структуру:

Адрес Код функции Начальный адрес Количество Число байт Значения Контрольная сумма
1 байт 1 байт 2 байта 2 байта 1 байт N байт 2 байта
  • Начальный адрес – адрес первого элемента сегмента памяти подчиненной станции, значение которого требуется изменить.
  • Количество – количество изменяемых элементов.
  • Число байт – количество передаваемых байт устанавливаемых значений.
  • Значения – устанавливаемые значения.

Если функция выполнена успешно, то входящий кадр функции 16 (0х10) имеет структуру:

Адрес Код функции Начальный адрес Количество Контрольная сумма
1 байт 1 байт 2 байта N байт 2 байта
  • Начальный адрес – адрес первого измененного элемента.
  • Количество – количество измененных элементов.

Исходящий кадр функции 16 (0х10) Write Multiple Registers:

Байт Данные Описание
0 01 Адрес станции – 1
1 10 Код функции – 16 (0х10)
2, 3 00 05 Начальный адрес – 5
4, 5 00 04 Количество – 4
6 08 Число байт – 8
7, 8 00 02 Значение 5 – 2
9, 10 23 34 Значение 6 – 9012
11, 12 09 34 Значение 7 – 2356
12, 14 28 5C Значение 8 – 10332
15, 16 73 4A Контрольная сумма

Входящий кадр функции 16 (0х10) Write Multiple Registers:

Байт Данные Описание
0 01 Адрес станции – 1
1 10 Код функции – 16 (0х10)
2, 3 00 05 Начальный адрес – 5
4, 5 00 04 Количество – 4
6, 7 D1 CB Контрольная сумма

Кадры ошибок

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

Адрес Код функции + 0x80 Код ошибки Контрольная сумма
1 байт 1 байт 1 байт 2 байта

В таблице приведены поддерживаемые модулем Modbus RTU Опросчик коды ошибок.

Код Название Описание
01 ILLEGAL FUNCTION (Недопустимая функция) Принятый код функции не может быть обработан подчиненной станцией
02 ILLEGAL DATA ADDRESS (Недопустимый адрес данных) Адрес регистра подчиненной станции, указанный в запросе, недоступен
03 ILLEGAL DATA VALUE (Недопустимое значение данных) Значение, указанное в поле данных запроса, является недопустимым
04 SERVER DEVICE FAILURE (Сбой подчиненной станции) Подчиненная станция не может обработать принятый запрос
06 SERVER DEVICE BUSY (Подчиненная станция занята) Подчиненная станция занята обработкой команды. Опросчик должен повторить запрос, когда подчиненная станция освободится

Исходящий кадр функции 04 (0х04) Read Input Registers:

Байт Данные Описание
0 01 Адрес станции – 1
1 04 Код функции – 04 (0х04)
2, 3 00 01 Начальный адрес – 1
4, 5 00 02 Количество – 2
6, 7 FD D7 Контрольная сумма

Входящий кадр ошибки для функции 04 (0х04) Read Input Registers:

Байт Данные Описание
0 01 Адрес станции – 1
1 84 Код функции+0x80 – 0x84
2 02 Код ошибки – 2
3, 4 C2 C1 Контрольная сумма