Notification module

Настройка модуля уведомлений

Модуль уведомлений (алармов, Alarm) предназначен для быстрой настройки отправки СМС и email в случае изменения параметров контроллера или подключённых устройств: показаний подключённого датчика температуры, сработки пожарной сигнализации, обнаружении протечки и т.п.

Предварительная настройка для отправки email

На уровне Linux для отправки email используется утилита sSMTP. Чтобы начать отправлять почту, нужно отредактировать её конфигурационный файл /etc/ssmtp/ssmtp.conf.

Электронные письма будут отправляться с одного из ваших почтовых ящиков, от которого потребуются:

• логин — например, robot@contactless.ru,
• пароль,
• адрес и порт SMTP сервера. Для ящиков на Gmail это smtp.gmail.com:587, для Mail.Ru — smtp.mail.ru:465).

Для ящика на сервере Google

Очистите содержимое файла /etc/ssmtp/ssmtp.conf и добавьте туда строки:

mailhub=smtp.gmail.com:587
UseTLS=Yes
UseSTARTTLS=Yes
AuthUser=robot@contactless.ru
AuthPass=qwerty12345
# Не забудьте добавить пустую пустую строку в конце файла

Обязательно оставьте пустую строку в конце файла — после строки с AuthPass=.

Для отправки писем через Google Mail необходимо разрешить отправку писем от недоверенных приложений для вашего Google-аккаунта

Для ящика на сервере mail.ru

Очистите содержимое файла /etc/ssmtp/ssmtp.conf и добавьте туда строки:

mailhub=smtp.mail.ru:465
FromLineOverride=YES
UseTLS=Yes
AuthUser=robot@contactless.ru
AuthPass=qwerty12345
# Не забудьте добавить пустую пустую строку в конце файла

В файл /etc/ssmtp/revaliases добавьте строку:

root:robot@contactless.ru:smtp.mail.ru:465

Проверка настроек

Чтобы проверить, что отправка email заработала, выполните в консоли команду:

echo 'Test message to check sSMTP new configuration' | ssmtp -v ivanov@gmail.com
# вместо ivanov@gmail.com подставьте адрес другого своего ящика (например того, куда собираетесь получать уведомления с контроллера)

Дополнительную информацию можно получить на сайтах askubuntu.com и wiki.archlinux.org.

Предварительная настройка для отправки SMS

Убедитесь, что вы настроили модем вставили SIM-карту и подключили GSM антенну.

Перед настройкой в веб-интерфейсе можете протестировать отправку SMS из консоли.

Настройка модуля уведомлений

1. Зайдите на страницу Settings → Configs → Alarm Configuraion веб-интерфейса.
2. Добавьте получателей уведомлений в разделе Recipients:
   • нажмите кнопку + Recipient;
   • В выпадающем списке Recipient N выберите один из типов: E-mail recipient или SMS recipient;
   • введите почтовый адрес или номер телефона. Для email можно также указать тему письма.
3. Настройте проверяемый параметр и условие в разделе Alarms:
   • нажмите кнопку + Item;
   • в появившемся разделе в выпадающем списке выберите один из четырёх типов уведомлений:
     1. Expected Value Alarm — уведомление, если значение перестанет равняться заданному.
     2. Minimum Value Alarm — уведомление, если значение станет меньше заданного.
     3. Maximum Value Alarm — уведомление, если значение станет больше заданного.
     4. Minimum&Maximum Value Alarm — уведомление, если значение выйдет из заданного диапазона.
   • в Alarm name введите произвольное название для уведомления;
   • в Cell введите параметр, за которым нужно следить. Параметр задаётся в виде Device/Control, где названия Device и Control для каждого параметра можно найти в веб-интерфейсе в разделе Settings → MQTT Channels. Например, для датчика 1-Wire, подключённого к внешнему modbus-сенсору WB-MS, эта строка будет выглядеть как wb-ms-thls-v2_101/External Sensor 2;
   • в Alarm activation message введите текст сообщения, которое будет отправлено. В него в произвольном месте можно ввести две фигурные скобки {}, вместо которых в сообщение будет подставлено новое значение отслеживаемого параметра.
   • в зависимости от типа уведомления, заполните поля Minimum Value, Maximum Value, Expected Value;
   • некоторые дополнительные настройки станут доступны, если нажать на кнопку Properties и отметить их.
4. Нажмите Save в самом верху страницы:
   • если вы забыли указать какой-то обязательный параметр, кнопка Save будет неактивна, а рядом с параметром красным будет написана ошибка, которую нужно исправить;
   • если всё в порядке, уведомления сразу начнут работать.

Как настроить уведомления с более сложными условиями

Модуль уведомлений предназначен для быстрой настройки простых уведомлений. Если вам нужны более сложные сценарии уведомлений, их можно запрограммировать через движок правил. Чтобы отправить сообщение, из правила нужно вызвать функцию

Notify.sendEmail(to, subject, text); //отправляет почту указанному адресату (to), с указанной темой (subject) и содержимым (text)

или

Notify.sendSMS(to, text); //отправляет SMS на указанный номер (to) с указанным содержимым (text)