12.8. [DKSF 48.4 IU] Как управлять устройством при помощи SMS-команд

Устройство имеет возможность удалённого управления с помощью SMS-команд.

Синтаксис SMS-команд

Общий формат текста SMS-команды:

NETPING fff community_w kkkkkk

где:

fff – код команды, например, Р1+ (см. ниже).

community_w – пароль, соответствует SNMP community для записи. Задаётся на странице «НАСТРОЙКИ» web-интерфейса устройства. Можно применять латинские буквы, цифры, символ «_» без кавычек и пробелов.

kkkkk – идентификатор запроса (произвольное число от 3 до 9 цифр). Повторяется в ответе для установления соответствия между запросом и ответом. Необязательный элемент команды. Если идентификатор отсутствует в команде, также отсутствует в ответе.

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

Коды команд

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

Код командыОписание
Pn+Включить реле n, где n - номер реле
Pn-Выключить реле n, где n - номер реле
PnR

Перезагрузить реле n, где n - номер реле

Полярность (направление) переключения реле при выполнении сброса должна cоответствовать заданному в настройках модуля «Сторож» (режим сброса). Если реле уже находится в состоянии сброса, команда сброса не имеет эффекта, хотя ответное уведомление об успешном выполнении «NP DONE PnR» будет приходить отправителю.

PnWПеревести реле n в режим управление «Сторож», где n - номер реле
PnSПеревести реле n в режим управление «Расписание», где n - номер реле
PnXПеревести реле n в режим управление «Расписание+Сторож», где n - номер реле
PnLПеревести реле n в режим управление «Выход логики», где n - номер реле
Pn?Запросить состояние реле n, где n - номер реле
P?Запросить состояние всех реле в краткой форме
S?Запросить состояние групп розеток и вводов
Sx=y

Задать основной ввод y для группы розеток x, где y - номер ввода электропитания: 1 или 2; x - номер группы розеток: 1 (розетки 1..4) или 2 (розетки 5..8)

SxB+Разрешить резервирование ввода для группы розеток x, где x - номер группы розеток: 1 (розетки 1..4) или 2 (розетки 5..8)
SxB-Запретить резервирование ввода для группы розеток x, где x - номер группы розеток: 1 (розетки 1..4) или 2 (розетки 5..8)
SxR+Разрешить автоматический возврат на основной ввод для группы розеток x, где x - номер группы розеток: 1 (розетки 1..4) или 2 (розетки 5..8)
SxR-Запретить автоматический возврат на основной ввод для группы розеток x, где x - номер группы розеток: 1 (розетки 1..4) или 2 (розетки 5..8)
SxR

Выполнить возврат на основной ввод для группы розеток x, где x - номер группы розеток: 1 (розетки 1..4) или 2 (розетки 5..8)

Lm+Перевести линию m в состояние лог.1, где m - номер IO линии (1..4)
Lm-Перевести линию m в состояние лог.0, где m - номер IO линии (1..4)
LmPВыдать импульс на линию m, где m - номер IO линии (1..4)
Lm?Запросить состояние линии m, где m - номер IO линии (1..4)
L?Запросить состояние всех IO линий в краткой форме
N?Запросить состояние пингера
KaПередать ИК команду через модуль IRC-TRv2, где a - номер команды
Tb?Запросить показания датчика температуры b, где b - номер термодатчика
H?Запросить показания датчика влажности

Примеры SMS-команд

Команда включения реле 1 устройства:

NETPING P1+ SWITCH

Команда выключения реле 2 устройства:

NETPING P2- SWITCH

Ответные сообщения на SMS-команды

Подтверждение исполнения команды, такой, как переключение реле или изменение состояния дискретной линии вывода:

NP DONE fff kkkkkk

NP DONE fff

где:

fff – код исходной команды, выполнение которой подтверждается данным сообщением. Например, Р1+

kkkkk – идентификатор запроса (произвольное число от 3 до 9 цифр). Повторяется в ответе для установления соответствия между запросом и ответом. Необязательный элемент команды. Если идентификатор отсутствует в команде, также отсутствует в ответе (вторая команда)

 

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

NP WRONG CMD: «исходная команда»

где:

Исходная команда  текст исходной команды, полностью заключённый в кавычки.

 

Неправильный пароль (Community) в исходной команде:

NP WRONG PASSWD IN kkkkkk

NP WRONG PASSWD

где:

kkkkk – идентификатор запроса (произвольное число от 3 до 9 цифр). Повторяется в ответе для установления соответствия между запросом и ответом. Необязательный элемент команды. Если идентификатор отсутствует в команде, также отсутствует в ответе (вторая команда)

Ответные сообщения на SMS-команды запроса статуса/состояния

Ответ на запрос (NETPING Lm? kkkkkk) о состоянии IO линии:

NP REPLY L1=0 kkkkkk

Значение L1=0 приведено для примера. Перед знаком «=» стоит номер линии, после знака «=» логический уровень на линии.

 

Ответ на запрос (L?) о состоянии всех IO линий:

NP REPLY L1=0 L2=1 kkkkkk

Значения L1=0 L2=0 приведены для примера. Перед знаком «=» стоит номер линии, после знака «=» логический уровень на линии

 

Ответ на запрос (NETPING Pn? kkkkkk) о состоянии реле:

NP REPLY Pn+ (0 RESETS, 0 REP.RESETS) kkkkkk

где:

Pn+  состояние реле

n  номер реле

Состояние реле кодируется символами «+» (включено), «-» (выключено), L (управляется логикой). В круглых скобках  общий счётчик сбросов и счётчик повторяющихся безуспешных сбросов, инициированных модулем «Сторож»

Ответ на запрос (NETPING P? kkkkkk) о состоянии всех реле:

NP REPLY P1b P2b P3b P4b P5b P6b P7b P8b kkkkkk

где:

b  состояние реле, возможные состояние реле кодируется символами: «+» (включено), «-» (выключено), «W» (сторож), «S» (расписание), «X» (расписание+сторож), «L» (логика).

Состояние реле кодируется так же, как в SMS-команде управления реле. Счётчики сбросов в ответ не включаются

 

Ответ на запрос (NETPING S? kkkkkk) о состоянии вводов:

NP REPLY S1(1..4) =1 B+ R+ S2(5..8) =2 B+ R- AC1+ AC2+ kkkkkk

где:

S1(1..4)  первая группа розеток, номера 1..4

S2(5..8)  вторая группа розеток, номера 5..8

B+|B-  «+» или «-»  означает разрешено или запрещено резервирование ввода для группы

R+|R-  «+» или «-»  означает разрешён или запрещён автовозврат группы на основной ввод

AC1+|AC2+  «+» или «-» означает наличие или отсутствие напряжения на вводах 1 и 2

 

Ответ на запрос (NETPING N? kkkkkk) о состоянии пингера, встроенного в модуль SMS:

NP REPLY N=1 kkkkkk

где:

N=1 – заданный IP адрес отвечает

N=0 – заданный IP адрес молчит

 

Ответ на запрос (NETPING Tb? kkkkkk) о показаниях термодатчика. Датчик с номером b вышел из строя либо не подключен:

NP REPLY Tb? SENSOR FAILED kkkkkk

 

Ответ на запрос (NETPING Tb? kkkkkk) о показаниях термодатчика:

NP REPLY Tn=tC BELOW/IN/ABOVE SAFE RANGE (t1..t2C) kkkkkk

где:

n  номер термодатчика

tC – текущее показание температуры, °C

BELOW/IN/ABOVE SAFE RANGE (t1..t2C) – статус термодатчика (настроенный диапазон значений в норме температуры)

 

Ответ на запрос (NETPING H? kkkkkk) о показаниях датчика влажности. Датчик вышел из строя либо не подключен:

NP REPLY H? SENSOR FAILED kkkkkk

 

Ответ на запрос (NETPING H? kkkkkk) о показаниях датчика влажности:

NP REPLY H=h% BELOW/IN/ABOVE SAFE RANGE (h1..h2%) T= tC kkkkkk

где:

h% – текущее показание относительной влажности, в %

tC – текущее показание температуры, в °C

BELOW/IN/ABOVE SAFE RANGE (h1..h2%) – статус датчика влажности (настроенный диапазон значений в норме относительной влажности)