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+ SWITCHNP DONE P1+
Не верная командаNETPING PHT1+ SWITCHNP WRONG CMD: "PHT1+"
Не верный community

NETPING P1+ DSDFF

NETPING P1+ DSDFF 3321

NP WRONG PASSWD

NP WRONG PASSWD IN 3321

С идентификаторомNETPING T1? SWITCH 3321NP REPLY Tb=21C BELOW SAFE RANGE (25..30C) 3321
Запрос состояния всех линий ввода/выводаNETPING L? SWITCHNP REPLY L1=0(out) L2=0(out) L3=1(out) L4=1(in) L5=1(in) L6=1(in)