7.10. [DKSF72/73.1] SMS команды.

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

В прошивке устройства реализована возможность задания белых списков — номеров, которым разрешено управление устройством. Подробней о белых списках можно прочитать в разделе «7.1. [DKSF72/73.1] Настройка номеров для уведомлений и управления» данного документа.

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

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

NETPING fff community_w kkkkk

где:

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

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

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

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

Коды команд

Код команды	Команда	Ответ	Примечание
Общие команды
RB20	Выполнить перезагрузку устройства		Перезагрузка произойдет через 20 секунд после получения им команды.
Реле
Pn+ Pn-	Включить/выключить реле	NP DONE Pn+ NP DONE Pn-	n — номер реле
PnR	Перезагрузить реле	NP DONE PnR	n — номер реле. Полярность (направление) переключения реле при выполнении сброса должна соответствовать полярности, заданной в настройках модуля «Сторож» (режим сброса). Если реле уже находится в состоянии сброса, команда сброса не имеет эффекта, хотя ответное уведомление об успешном выполнении «NP DONE PnR» будет приходить отправителю
Pn?	Запросить состояние реле	NP REPLY Pnb	n — номер реле n – номер реле; b – состояние реле, возможные состояние реле кодируется символами: «+» (включено), «-» (выключено);
P?	Запросить состояние всех реле в краткой форме	NP REPLY P1b .. Pnb kkkkk	b – состояние реле, возможные состояние реле кодируется символами: «+» (включено), «-» (выключено).
Линии ввода-вывода
Ln+ Ln-	Перевести линию в состояние лог.1 (+) или лог.0 (-).	NP DONE Ln+ NP DONE Ln-	Линия должна быть в режиме «выход».
LnP	Выдать импульс на линию	NP DONE LnP	Линия должно быть в режиме «выход».
Ln?	Запросить состояние линии	NP REPLY Ln=l(mode)	l — логический уровень IO-линии, возможные значения: 0 (логический нуль), 1 (логическая единица). mode — режим работы IO линии, возможные значения: IN (вход), OUT (выход).
L?	Запросить состояние всех IO линий в краткой форме	NP REPLY Ln=l(mode) Ln=l(mode) Ln=l(mode) Ln=l(mode) Ln=l(mode) Ln=l(mode) Ln=l(mode) Ln=l(mode)	l — логический уровень IO-линии, возможные значения: 0 (логический нуль), 1 (логическая единица). mode — режим работы IO линии, возможные значения: IN (вход), OUT (выход).
Пингер
N?	Запросить состояние пингера (на странице «SMS»)	NP REPLY N=status	status - состояние пингера (1 - адрес отвечает, 0 - адрес молчит)
Датчик температуры
Tn?	Запросить показания датчика температуры	NP REPLY Tb=? SENSOR FAILED kkkkk NP REPLY Tb=tC BELOW SAFE RANGE (t1..t2C) kkkkk NP REPLY Tb=tC IN SAFE RANGE (t1..t2C) kkkkk NP REPLY Tb=tC ABOVE SAFE RANGE (t1..t2C) kkkkk	b – номер термодатчика; t – текущее показание температуры, в °C; t1, t2 – границы диапазона «нормы» температуры, в °C; kkkkk – идентификатор запроса (произвольное число). Повторяется в ответе для установления соответствия между запросом и ответом. Необязательный элемент команды. Если идентификатор отсутствует в команде, также отсутствует в ответе.
T?	Запросить состояние всех подключённых датчиков температуры в краткой форме	NP REPLY T2=21C SAFE (10..30C) T5=? T6=39C ABOVE (10..30C) kkkkk	Незадействованные датчики с пустыми 1W адресами пропускаются. BELOW / SAFE / ABOVE – статус датчика температуры; ? – отказавшие или отключённые (но с вписанным адресом) датчики отображаются как T5=? без статуса и указания границ диапазона «нормы» температуры, в °C; kkkkk – идентификатор запроса (произвольное число). Повторяется в ответе для установления соответствия между запросом и ответом. Необязательный элемент команды. Если идентификатор отсутствует в команде, также отсутствует в ответе;
Датчики влажности
Hn?	Запросить показания датчика	NP REPLY Hx=? SENSOR FAILED kkkkk NP REPLY Hx=h% BELOW SAFE RANGE (h1..h2%) T= tC kkkkk NP REPLY Hx=h% IN SAFE RANGE (h1..h2%) T= tC kkkkk NP REPLY Hx=h% ABOVE SAFE RANGE (h1..h2%) T= tC kkkkk	h – текущее показание относительной влажности, в %; h1, h2 – границы диапазона «нормы» относительной влажности, в %; t – текущее показание температуры, в °C; kkkkk – идентификатор запроса (произвольное число). Повторяется в ответе для установления соответствия между запросом и ответом. Необязательный элемент команды. Если идентификатор отсутствует в команде, также отсутствует в ответе.
H?	Запросить показания всех датчиков
Датчик качества электропитания
Vn?	Запросить статус и показания датчика	NP REPLY Vn=220V OK/WARN/BAD/OFF 50Hz OK/WARN/BAD/OFF kkkkk NP REPLY Vn=? SENSOR FAILED kkkkk	n – номер датчика 220V – текущее значение напряжения, В 50Hz – текущее значение частоты, Гц. OK/WARN/BAD/OFF – статус сетевого напряжения и частоты kkkkk – идентификатор запроса (произвольное число от 3 до 9 цифр). Повторяется в ответе для установления соответствия между запросом и ответом. Необязательный элемент команды. Если идентификатор отсутствует в команде, также отсутствует в ответе.
Адаптер аналоговых датчиков (+встроенный аналоговый вход)
AINn?	Запросить показания адаптера	NP REPLY AINn=status	n - номер датчика status - статус датчика, возможные значения: FAIL_1W, B.SAFE!, OK, A.SAFE!, FAIL_AN (отказ адаптера, ниже нормы, в норме, выше нормы, отказ петли/вне рабочего диапазона)
AIN?	Запросить показания всех адаптеров	NP REPLY AIN1=status .. AIN4=status