4.6. [DKSF 707.3 IU] Какие SMS-команды и SMS-уведомления поддерживает устройство?

NetPing SMS может принимать различные SMS-команды и отправлять SMS-уведомления при наступлении различных событий. Уведомления рассылаются на телефонные номера, указанные на странице «НАСТРОЙКИ GSM» web-интерфейса устройства.

В прошивке устройства NetPing SMS существует лимит отправки SMS-сообщений до 120 сообщений в час.

Формат SMS-команды

Запрос значения SNMP переменной (SNMP GET запрос):

np snmp variable? password

Установка SNMP переменной (SNMP SET команда):

np snmp variable=value password

где:

np snmp – префикс команды;

variable – короткое имя SNMP переменной, заданное на странице «ПЕРЕМЕННЫЕ» web-интерфейса устройства;

value – значение для записи в SNMP переменную. Поддерживаются только целые числа. Допустимо указание текстового значения из словаря;

password – значение параметра «Community», указанного со странице «НАСТРОЙКИ» web-интерфейса любого устройства NetPing

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

Формат SMS-ответа

Ответ на запрос значения SNMP переменной:

NP SNMP REPLY variable=value

Ответ на установку SNMP переменной:

NP SNMP DONE variable=value

где:

variable – короткое имя SNMP переменной, заданной на странице «ПЕРЕМЕННЫЕ» web-интерфейса устройства;

value – значение SNMP переменной и его расшифровка из словаря (если применимо)

Примеры ответных сообщений:

NP SNMP DONE heater=off(0)

NP SNMP REPLY t4=28

SMS-сообщения об ошибке

Параметр password в SMS-команде не соответствует значению «Community» на странице «НАСТРОЙКИ» web-интерфейса устройства NetPing. Пароль проверяется с учётом регистра:

NP SNMP ERR Wrong password, access denied

 

<переменная> отсутствует в таблице SNMP переменных на странице «ПЕРЕМЕННЫЕ» web-интерфейса устройства:

NP SNMP ERR Unknown variable '<переменная>'

 

<переменная> ссылается на хост, отсутствующий в таблице хостов (агентов) на странице «АГЕНТЫ» web-интерфейса устройства:

NP SNMP ERR Unknown agent '<хост>' for var '<переменная>'

 

Устройство не смогло получить IP адрес агента по его доменному имени <fqdn>:

NP SNMP ERR DNS failed for '<fqdn>'

Получение IP адреса незавершено, невозможно, или DNS сервер не знает такого хоста.

Процедура определения IP адресов для доменного имени запускается при сохранении любых изменений в таблице хостов (агентов) на странице «АГЕНТЫ» web-интерфейса устройства. То есть, IP адреса определяются заранее для всех вписанных в таблицу хостов и хранятся «про запас». Повторный запрос производится про окончанию периода жизни записи в кеше DNS.

 

Нет ответа от <fqdn_or_ip> после трёх попыток выполнить SNMP операцию. Таймаут выполнения SNMP операции – 2 секунды:

NP SNMP ERR No reply for '<переменная>' from '<fqdn_or_ip>'

 

Поле <ошибка snmp> выставляется на основе кода ошибки из SNMP reply PDU:

NP SNMP ERR Reply '<ошибка snmp>’ for ‘<исходная операция>’

Поле <ошибка snmp> может иметь вид:

  • Too big data – слишком большой запрос, нет ресурсов для его обработки;
  • No such OID 'id' – у агента нет такого OID;
  • Bad value – значение не может быть записано в OID, либо не соответствует тип или размер;
  • Read only – агент отказал в записи;
  • Unknown error – другие ошибки

Например:

NP SNMP ERR Reply ‘Read only’ for ‘temp4=25’

 

Ошибка возникает при попытке прочитать нецелочисленное значение. На данный момент можно читать только целочисленные переменные:

NP SNMP ERR Non-integer value returned for ‘<переменная>’

где:

<переменная> – короткое имя переменной, указанное в SMS-команде

 

<значение>, указанное в SMS-команде variable=value не может быть проинтерпретировано как целое число, и не удалось найти соответствия этому значению в словаре для переменной, если было задано текстовое значение:

NP SNMP ERR Bad value '<значение>' in sms

Поименованные значения (словарь) задаются в таблице переменных на странице «ПЕРЕМЕННЫЕ» web-интерфейса устройства.

Пример словаря:

flip(-1), off(0), on(1), unknown(255)

 

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

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

где:

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

SMS-уведомления

SMS-уведомления имеют вид:

np_name (q) информация 

где:

np_name – имя устройства для идентификации SMS-сообщений. Задаётся на странице «НАСТРОЙКИ» web-интерфейса устройства. Если имя устройства не задано, то применяется имя «NETPING»;

 последовательный номер сообщений. Номер энергонезависим  не обнуляется при отключении питания. Служит для регистрации пропущенных (потерянных) сообщений;

Информация  информационная часть SMS-уведомлений

Информационная часть SMS-уведомлений

Сообщения об изменении состояния собственного Ethernet интерфейса устройства:

ETHERNET LINK STATUS: UP

ETHERNET LINK STATUS: DOWN

 

Сообщение о потери и восстановлении связи проверяемого узла в сети (смотреть модуль «Пингер» на странице «НАСТРОЙКИ GSM» web-интерфейса устройства):

PINGER STATUS: OK (IP/HOST)

PINGER STATUS: FAILED (IP/HOST)