12.8. [DKSF 48.5 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 — номер реле
P*+Включить все реле
P*-Выключить все реле
PnR

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

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

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 — номер датчика
Hb?Запросить показания датчика влажности, где b — номер датчика
T?Запросить показания всех подключенных датчиков температуры в краткой форме. Признаком подключенности датчика является наличие 1-wire-номера.
H?Запросить показания всех подключенных датчиков влажности в краткой форме. Признаком подключенности датчика является наличие 1-wire-номера.
RB20Перезагрузка устройства. Выполняется через 20 с. после получения команды

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

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

NETPING P1+ SWITCH

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

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

NP DONE fff kkkkkk

NP DONE fff

где:

ff— код исходной команды, выполнение которой подтверждается данным сообщением; например, Р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 Lm=lvl kkkkkk

где:

  • m — номер линии
  • lvl — лог. уровень

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

NP REPLY L1=lvl L2=lvl L3=lvl L4=lvl

где lvl — лог. уровень.

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

NP REPLY Pnstatus

где:

  • status — состояние реле: «+» (включено), «-» (выключено);
  • n — номер реле.

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

NP REPLY P1b P2b P3b P4b P5b P6b P7b P8b

где:

— состояние реле: «+» (включено), «-» (выключено).

Ответ на запрос S? о состоянии вводов

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

где:

  • S1, S2 — группы розеток;
  • in1, in2 — ввод, от которого в данный момент запитана группа розеток;
  • B+|B- «+» или «-»  означает, разрешено или запрещено резервирование ввода для группы;
  • R+|R- «+» или «-»  означает, разрешён или запрещен автовозврат группы на основной ввод;
  • AC1+|AC2+ «+» или «-» означает наличие или отсутствие напряжения на вводах 1 и 2.

Ответ на запрос N?

NP REPLY N=status (address)

где:

  • status — состояние пингера, 0 — молчит, 1 — отвечает;
  • address — IP или доменное имя опрашиваемого узла.

Ответ на запрос Tb?

NP REPLY Tb? SENSOR FAILED — вышел из строя или не подключен;

NP REPLY Tb=tC status SAFE RANGE (t1...t2C) — ответ о показания датчика с указанием статуса.

 где:

  • b — номер термодатчика;
  • tC — текущее показание температуры, °C;
  • status — статус термодатчика: «BELOW», «IN» или «ABOVE»;
  • (t1..t2C) — диапазон нормы.


Ответ на запрос Hb?

NP REPLY Hb? SENSOR FAILED — вышел из строя или не подключен;

NP REPLY Hb=h%status SAFE RANGE (h1..h2) T=tCstatus SAFE RANGE (t1...t2— ответ о показаниях датчика с указанием статуса.

где:

  • h% — текущее показание относительной влажности, в %;
  • tC — текущее показание температуры, в °C;
  • status  статус показаний датчика: «BELOW», «IN» или «ABOVE»;
  • h1..h2 — диапазон нормальной влажности;
  • t1..t2 — диапазон нормальной температуры.