Teltonika

Teltonika RUT950 Modbus

ООО «Цифровой Ангел»

25.06.2021 15:45:50

115419, Москва, Орджоникидзе, 11с3

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

Modbus TCP

Modbus TCP предоставляет пользователям возможность устанавливать или получать системные параметры. Демон Modbus действует как подчиненное устройство. Это означает, что он принимает соединения от мастера (клиента) и отправляет ответ или устанавливает какой-либо системный параметр в соответствии с заданным запросом.

На рисунке ниже приведен пример раздела окна Modbus TCP, а в таблице ниже приведена информация о полях, содержащихся в этом окне.

Поле	Имя	Описание
Enable	yes \| no; Default: none	Включает или выключает Modbus TCP.
Port	integer [0..65535]; default: 502	TCP-порт, используемый для связи Modbus.
Device ID	integer [0..255]; default: 1	Идентификатор ведомого устройства Modbus. При значении 0 он будет отвечать на запросы, адресованные любому идентификатору.
Allow Remote Access	yes \| no; default: no	Разрешает удаленные подключения Modbus, добавив исключение в брандмауэр устройства на порт, указанный в поле выше.
Enable custom register block	yes \| no; default: no	Разрешить пользовательский блок регистрации

Получить параметры

Параметры Modbus хранятся в регистрах. Каждый регистр содержит 2 байта информации. Для упрощения, количество регистров для хранения чисел составляет 2 (4 байта), а количество регистров для хранения текстовой информации составляет 16 (32 байта). Номера регистров и соответствующие системные значения описаны в таблице ниже:

Запрашиваемое значение	Номер регистра	Число регистров	Представление
System uptime	1	2	32 bit unsigned integer
Mobile signal strength (RSSI in dBm)	3	2	32 bit integer
System temperature (in 0.1 °C)	5	2	32 bit integer
System hostname	7	16	Text
GSM operator name	23	16	Text
Router serial number	39	16	Text
LAN MAC address	55	16	Text
Router name	71	16	Text
Currently active SIM card slot	87	16	Text
Network registration info	103	16	Text
Network type	119	16	Text
Current WAN IP address	139	16	32 bit unsigned integer
Mobile data received today (SIM1)	185	2	32 bit unsigned integer
Mobile data sent today (SIM1)	187	2	32 bit unsigned integer
Mobile data received this week (SIM1)	189	2	32 bit unsigned integer
Mobile data sent this week (SIM1)	191	2	32 bit unsigned integer
Mobile data received this month (SIM1)	193	2	32 bit unsigned integer
Mobile data sent this month (SIM1)	195	2	32 bit unsigned integer
Mobile data received last 24h (SIM1)	197	2	32 bit unsigned integer
Mobile data sent last 24h (SIM1)	199	2	32 bit unsigned integer
Active SIM card	205	1	32 bit unsigned integer
Mobile data received last week (SIM1)	292	2	32 bit unsigned integer
Mobile data sent last week (SIM1)	294	2	32 bit unsigned integer
Mobile data received last month (SIM1)	296	2	32 bit unsigned integer
Mobile data sent last month (SIM1)	298	2	32 bit unsigned integer
Mobile data received today (SIM2)	300	2	32 bit unsigned integer
Mobile data sent today (SIM2)	302	2	32 bit unsigned integer
Mobile data received this week (SIM2)	304	2	32 bit unsigned integer
Mobile data sent this week (SIM2)	306	2	32 bit unsigned integer
Mobile data received this month (SIM2)	308	2	32 bit unsigned integer
Mobile data sent this month (SIM2)	310	2	32 bit unsigned integer
Mobile data received last 24h (SIM2)	312	2	32 bit unsigned integer
Mobile data sent last 24h (SIM2)	314	2	32 bit unsigned integer
Mobile data received last week (SIM2)	316	2	32 bit unsigned integer
Mobile data sent last week (SIM2)	318	2	32 bit unsigned integer
Mobile data received last month(SIM2)	320	2	32 bit unsigned integer
Mobile data sent last month (SIM2)	322	2	32 bit unsigned integer
Digital non-isolated input (4 PIN connector)	324	1	32 bit unsigned integer
Digital open collector output (4 PIN connector)	325	1	32 bit unsigned integer

Установить параметры

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

Значение для установки	Номер регистра	Значение регистра	Описание
Switch WiFi (ON/OFF*)	210	1 \| 0	Включает\выключает WiFi
Switch mobile data connection (ON/OFF*)	211	1 \| 0	Включение или отключение мобильной передачи данных
Switch SIM card	212	1 \| 2 \| 0	Меняет активный слот для SIM-карты 1 - переключиться на SIM1 2 - переключиться на SIM2 0 - переключиться с SIM-карты, противоположной используемой в данный момент (SIM1 → SIM2 или SIM2 → SIM1
Change APN	213	APN code	Изменения APN. Количество входных регистров может варьироваться в зависимости от длины APN, но самый первый байт команды set APN обозначает номер SIM-карты, для которой устанавливается APN. Этот байт должен быть установлен в: 1 - установить APN для SIM1 2 - установить APN для SIM2
Reboot	220	1	перезагрузить роутер

* Все команды ВКЛ / ВЫКЛ принимают только значения 0 и 1, которые представляют собой следующее:

1 - ВКЛ
0 - ВЫКЛ
Modbus TCP Master
Ведущее устройство Modbus может запрашивать данные от подчиненных устройств Modbus. Раздел Modbus TCP Master используется для настройки ведомых устройств Modbus TCP. Чтобы добавить нового ведомого, введите пользовательское имя, идентификатор ведомого, IP-адрес и порт и нажмите кнопку «Добавить»:

Кнопка	Описание
Edit	Перенаправляет вас на страницу конфигурации ведомого
Delete	Удаляет ведомую конфигурацию
Alarms	Перенаправляет вас на страницу конфигурации сигналов тревоги ведомого
Clone	Создает идентичную конфигурацию подчиненного

Вы можете создать максимум 10 подчиненных конфигураций.

Конфигурация ведомого устройства

На рисунке ниже приведен пример конфигурации ведомого устройства, а в таблице ниже представлена информация о полях, содержащихся в этом разделе:

Поле	Значение	Описание
Enabled	yes \| no; default: no	Включает или выключает связь с ведомым устройством.
Name	string; default: none	Имя ведомого устройства, используется для упрощения управления.
Slave ID	integer [0..255]; default: none	Ведомый ID. Каждому ведомому устройству в сети назначается уникальный идентификатор в диапазоне от 1 до 255. Когда мастер запрашивает данные у ведомого устройства, первый отправляемый им байт - это идентификатор ведомого устройства. При значении 0 ведомое устройство будет отвечать на запросы, адресованные любому идентификатору.
IP address	ip; default: none	IP-адрес подчиненного устройства.
Port	integer [0..65535]; default: none	TCP-порт Modbus ведомого устройства.
Period	integer [1..6400]; default: none	Интервал, с которого запросы отправляются на ведомое устройство.
Timeout	integer [1..30]; default: none	Maximum response wait time.

Запрос настроек

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

На рисунке ниже приведен пример раздела конфигурации запросов, а в таблице ниже представлена информация, содержащаяся в полях этого раздела:

Поле	Значение	Описание
Name	string; default: Unnamed Parameter	Имя запроса. Используется для облегчения управления.
Data type	8bit INT \| 8bit UINT \| 16bit INT, high byte first \| 16bit INT, low byte first \| 16bit UINT, high byte first \| 16bit UINT, low byte first \| 32bit float, Byte order 1,2,3,4 \| 32bit float, Byte order 4,3,2,1 \| 32bit float, Byte order 2,1,4,3 \| 32bit float, Byte order 3,4,1,2; default: 16bit INT, high byte first	Как считанные данные будут храниться.
Function	1 \| 2 \| 3 \| 4 \| 5 \| 6 \| 15 \| 16; default: 3	Функциональный код определяет тип регистра, к которому обращается запрос Modbus. Коды представляют эти функции: 1 - читать статус катушки 2 - прочитать состояние ввода 3 - читать регистры холдинга 4 - читать входные регистры 5 - сила одиночной катушки 6 - предустановленный одиночный регистр 15 - сила нескольких катушек 16 - форсировать несколько регистров
First Register	integer [1..65536]; default: 1	Первый номер регистра Modbus, с которого будут считываться данные. Примечание. RUT9XX Modbus Master использует номера регистров, значение которых на +1 больше значения адреса.
Number of Registers	integer [1..2000]; default: none	Количество регистров Modbus, которые будут прочитаны во время запроса.
Enabled	yes \| no; default: no	Включает или выключает запрос.
Test	- (interactive button)	Генерирует запрос Modbus в соответствии с заданными параметрами для проверки конфигурации запроса. Прежде чем использовать кнопку «Тест», вы должны сохранить конфигурацию.
Delete	- (interactive button)	Удаляет запрос.
Add	- (interactive button)	Добавляет новую конфигурацию запроса.

Конфигурация тревоги

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

Поле	Значение	Описание
Enabled	yes \| no; default: no	Включает и выключает тревогу
Function code	Read Coil Status (1) \| Read Input Status (2) \| Read Holding Registers (3) \| Read Input Registers (4); default: Read Coil Status (1)	Функция Modbus, используемая в запросе Modbus.
Register	integer [0..65535]; default: none	Номер катушки Modbus / вход / удерживающий регистр / входной регистр, который будет считан.
Condition	More than \| Less than \| Equal to \| Not Equal to; default: Equal to	Когда значение будет получено, оно будет сравниваться со значением, указанным в следующем поле. Сравнение будет сделано в соответствии с условием, указанным в этом поле.
Value	various; default: none	Значение, с которым будут сравниваться прочитанные данные.
Action	SMS \| Trigger output \| Modbus Request; default: SMS	Действие, которое будет выполнено, если условие выполнено. Возможные действия: SMS - отправляет и отправляет SMS-сообщение указанному получателю (-ям). Триггерный выход - изменяет состояние указанного выхода (ов). Запрос Modbus - отправляет запрос Modbus указанному ведомому.
SMS: Message	string; default: none	Текст сообщения смс.
SMS: Phone number	phone number; default: none	Номер телефона получателя.
Trigger output: Output	Open collector output \| Relay output \| Both; default: Open collector output	Какие выходные данные будут запущены.
Trigger output: I/O Action	Turn On \| Turn Off \| Invert; default: Turn On	Действие, которое будет выполнено для указанного вывода.
Modbus Request: IP address	ip \| host; default: none	IP-адрес slave Modbus.
Modbus Request: Port	integer [0..65535]; default: none	Modbus slave порт.
Modbus Request: Timeout	integer [1..30]; default: 5	Максимальное время ожидания ответа.
Modbus Request: ID	integer [1..255]; default: none	Modbus slave ID.
Modbus Request: Modbus function	Read Coil Status (1) \| Read Input Status (2) \| Read Holding Registers (3) \| Read Input Registers (4) \| Force Single Coil (5) \| Preset Single Register (6) \| Force Multiple Coils (15) \| Force Multiple Registers (16); default: Force Single Coil (5)	Функциональный код определяет тип регистра, к которому обращается запрос Modbus.
Modbus Request: First register	integer [0..65535]; default: none	Начинается чтение из регистра, указанного в этом поле.
Modbus Request: Number of registers	integer [0..65535]; default: none	Количество регистров, которые будут считаны из первого регистра.

Данные Modbus на сервер

Функция Modbus Data to Server предоставляет вам возможность настроить отправителей, которые передают данные, собранные от подчиненных устройств Modbus, на удаленные серверы. Чтобы добавить нового отправителя данных, введите адрес сервера, укажите период отправки данных и нажмите кнопку «Добавить»:

Конфигурация отправителя данных

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

Включено	Да\| Нет; По умолчанию: нет	Включает или выключает отправителя данных
Name	string; По умолчанию: none	Имя отправителя данных. используется для облегчения управления
Protocol	HTTP(S); По умолчанию: HTTP(S)	Протокол отправки данных
JSON format	json string; По умолчанию: {"ID":"%i", "TS":"%t","ST":"%s","VR":"%a"}	Предоставляет возможность полностью настроить сегмент JSON
Segment count	1 \| 2 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10; По умолчанию: 1	Максимальное количество сегментов в одной строке JSON, отправленной на сервер
URL	host \| ip; По умолчанию: none	Адрес сервера, на который будут отправляться данные. , Важное примечание: при использовании HTTPS не забудьте добавить префикс https: // перед URL
Period	integer [1..6400]; По умолчанию: none	Частота отправки данных (в секундах)
Data filtering	All data \| By slave ID \| By slave IP; По умолчанию: All data	Какие данные этот отправитель передаст на сервер
Retry on fail	yes \| no; По умолчанию: no	Указывает, должен ли отправитель данных повторить неудачные попытки
Custom header	string; По умолчанию: no	Добавляет пользовательские заголовки в HTTP-запросы

Оборудование

4G-роутер Teltonika RUT950
Код: 37922 Под заказ Срок поставки: уточняйте

37 422 ₽
Без НДС
Оптовая цена по запросу

Профессиональный 4G LTE сотовый маршрутизатор с двумя SIM-картами, беспроводной режим IEEE 802.11b/g/n. В комплекте с внешними антеннами.