10.8. [DKSF 544.2 IU] Как управлять устройством при помощи SMS-команд
Устройство имеет возможность удаленного управления с помощью SMS-команд.
Работа с SMS-сообщениями и встроенным GSM-модемом доступна только для устройств NetPing 4/PWR-220 v6.1/GSM3G и NetPing 4/PWR-220 v6.2/GSM3G
Синтаксис SMS-команд
Общий формат текста SMS-команды:
NETPING fff community_w kkkkk
где:
fff — код команды, например, Р1+ (см. ниже);
community_w — пароль, соответствует SNMP community для записи. Задается на странице «НАСТРОЙКИ» веб-интерфейса устройства. Можно применять латинские буквы, цифры, символ «_» без кавычек и пробелов;
kkkkk — идентификатор запроса (произвольное число). Повторяется в ответе для установления соответствия между запросом и ответом. Необязательный элемент команды. Если идентификатор отсутствует в команде, также отсутствует в ответе.
Текст команды нечувствителен к регистру, можно применять строчные и прописные буквы. Элементы команды разделяются пробелами. Недопустимо использование символов: ‘ (апостроф), “ (кавычка), @. Включение этих символов может вызвать сбой прошивки. Выполнение команды подтверждается ответным сообщением (см. ниже).
Коды команд
SMS команды | |||
Команда | Код команды | Ответ | Примечания |
Общие команды | |||
RB20 | Выполнить перезагрузку устройства | Перезагрузка выполняется через 20с. после получения команды | |
Реле | |||
Pn? | Запросить состояние реле n, где n - номер реле | NP REPLY Pnb kkkkk | n – номер реле; b – состояние реле, возможные состояние реле кодируется символами: «+» (включено), «-» (выключено); kkkkk – идентификатор запроса (произвольное число). Повторяется в ответе для установления соответствия между запросом и ответом. Необязательный элемент команды. Если идентификатор отсутствует в команде, также отсутствует в ответе. |
Pn+ Pn- | Включить/выключить реле n, где n - номер реле | NP DONE Pn+ kkkkk NP DONE Pn- kkkkk | |
PnR | Перезагрузить реле n, где n - номер реле | NP DONE PnR kkkkk | Полярность (направление) переключения реле при выполнении сброса должна соответствовать полярности, заданной в настройках модуля «Сторож» (режим сброса). Если реле уже находится в состоянии сброса, команда сброса не имеет эффекта, хотя ответное уведомление об успешном выполнении «NP DONE PnR» будет приходить отправителю |
P? | Запросить состояние всех реле в краткой форме | NP REPLY P1b P2b P3b P4b kkkkk | b – состояние реле, возможные состояние реле кодируется символами: «+» (включено), «-» (выключено). kkkkk – идентификатор запроса (произвольное число). Повторяется в ответе для установления соответствия между запросом и ответом. Необязательный элемент команды. Если идентификатор отсутствует в команде, также отсутствует в ответе. |
Пингер | |||
N? | Запросить состояние пингера | NP REPLY N=status kkkkk | status - состояние пингера (1 - адрес отвечает, 0 - адрес молчит) kkkkk – идентификатор запроса (произвольное число). Повторяется в ответе для установления соответствия между запросом и ответом. Необязательный элемент команды. Если идентификатор отсутствует в команде, также отсутствует в ответе. |
Датчики температуры | |||
Tb? | Запросить показания датчика температуры b, где b - номер термодатчика | 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 | BELOW / SAFE / ABOVE – статус датчика температуры; ? – отказавшие или отключённые (но с вписанным адресом) датчики отображаются как T5=? без статуса и указания границ диапазона «нормы» температуры, в °C; kkkkk – идентификатор запроса (произвольное число). Повторяется в ответе для установления соответствия между запросом и ответом. Необязательный элемент команды. Если идентификатор отсутствует в команде, также отсутствует в ответе; Незадействованные датчики с пустыми 1W адресами пропускаются. |
Датчики влажности | |||
Hx? | Запросить показания датчика влажности x, где x - номер датчика влажности | 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 – идентификатор запроса (произвольное число). Повторяется в ответе для установления соответствия между запросом и ответом. Необязательный элемент команды. Если идентификатор отсутствует в команде, также отсутствует в ответе. |
Аккумулятор | |||
A? | Запросить состояние аккумулятора | NP REPLY A? POWER SCR: V, CHARGING: C kkkkk | V – источник питания устройства, может принимать значения: «220V» (питание от сети 220В), «BATTERY» (питание от аккумулятора); С – статус заряда аккумулятора, может принимать значения: «OK» (достижение полного заряда аккумулятора), «LOW» (низкий заряд аккумулятора), «NO» (не заряжается); kkkkk – идентификатор запроса (произвольное число). Повторяется в ответе для установления соответствия между запросом и ответом. Необязательный элемент команды. Если идентификатор отсутствует в команде, также отсутствует в ответе. |
1-wire датчики качества электропитания | |||
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 цифр). Повторяется в ответе для установления соответствия между запросом и ответом. Необязательный элемент команды. Если идентификатор отсутствует в команде, также отсутствует в ответе. |
IO линии | |||
Ln+ | Перевести линию m в состояние лог.1, где m — номер IO-линии. Линия должна быть в режиме «выход». | NP DONE Ln+ kkkkk | |
Ln- | Перевести линию m в состояние лог.0, где m — номер IO-линии. Линия должно быть в режиме «выход». | NP DONE Ln+ kkkkk | |
LnP | Выдать импульс на линию m, где m — номер IO-линии. Линия должно быть в режиме «выход». | NP DONE LnP kkkkk | |
Ln? | Запросить состояние линии m, где m — номер IO-линии. | NP REPLY Ln=l(mode) kkkkk | 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) kkkkk | l — логический уровень IO-линии, возможные значения: 0 (логический нуль), 1 (логическая единица). mode — режим работы IO линии, возможные значения: IN (вход), OUT (выход). |
Примеры SMS-команд и ответов
Описание | Команда | Ответ |
Включить первое реле | NETPING P1+ SWITCH | NP DONE P1+ |
Не верная команда | NETPING PHT1+ SWITCH | NP WRONG CMD: "PHT1+" |
Не верный community | NETPING P1+ DSDFF NETPING P1+ DSDFF 3321 | NP WRONG PASSWD NP WRONG PASSWD IN 3321 |
С идентификатором | NETPING T1? SWITCH 3321 | NP REPLY Tb=21C BELOW SAFE RANGE (25..30C) 3321 |
Запрос состояния всех линий ввода/вывода | NETPING L? SWITCH | NP REPLY L1=0(out) L2=0(out) L3=1(out) L4=1(in) L5=1(in) L6=1(in) |