Telegram (обновлено: 22 May 2020, 08:45:13)

Telegram


Поддержка Telegram. Отправка уведомлений и управление(только у RTOS прошивок).

С 16.04.2018 Telegram в России заблокирован. Работа опции не возможна

С начала 2020 года Telegram обновил минимальный TLS протокол и на обычной ESP8266 он может не работать. Работает на ESP8266RTOS(если достаточно ОЗУ)


Работа опции аналогична другим опциям уведомлений. Настройка опции находится в общей для этих целей вкладке Notifications.

Обратите внимание, что опция использует достаточно ресурсоёмкую SSL. Для ESP8266 это критично - там ОЗУ должно быть свободно не меньше 28кб для работы опции. По этой причине функций влезает крайне мало.

При установленной опции SMS/Email шаблонов доступна отправка значений датчиков и GPIO/VGPIO по планировщику заданий, а так же по отправке заданной команды. Так же доступно уведомление из функций Logic2 и Термостат. Подробное описание необходимо смотреть в документации данных функций.

Добавление бота в Telegram

Необходимо добавить бота BotFather к себе в контакты и написать ему команду /newbot . Далее вводим имя как бот будет отображаться в списке контактов и в следующей строке его адрес (то же имя). В ответ на сообщения бот выдаст ID и токен через двоеточие - эти данные необходимо будет указать в настройках модуля.

Чтобы узнать свой ID (кому писать сообщение) добавляем бота ShowJsonBot и что нибудь ему пишем. В ответ он выдаст json строку с вашим ID, который нужно указать в настройках модуля в поле Chat id. 

Обязательно добавляем созданного бота в список контактов используя поиск пользователей.

Управление модулем через команды и кнопки (только на RTOS)

Функция управления должна быть включена в шестеренке опции.

Интервал опроса команд - 3 сек.

Поддерживаемые команды (соответствующие опции должны быть установлены в прошивке):

setgpioX Y - управление GPIO, в том числе VGPIO. Включая поддержку обратной связи для вывода состояния удаленных GPIO.

setpwmX Y - управление PWM

settermoX Y Z - Управление термостатом, его параметрами. X - номер термостата, Y - верхняя граница, Z -нижняя граница

gettermo X - Чтение настроек термостата

ontermo X - Включение выбранного термостата

offtermo X - Выключение выбранного термостата

radio XXX - управление радио, можно указать имя, номер или url станции. Имена станции должны быть названы маленькими буквами.

info - вывод полезной информации.

infoX - запрос sms/emeil шаблона по его номеру или имени, указанного в шаблоне.

restart - перезапустить модуль

ver - дата и версия прошивки.

geturl URL - отправка и чтение get запросов. Пример geturl 192.168.0.100/debug

cam - получение картинки из подключенной к esp32 камеры

camtime Х- установка интервала отправки изображения у подключенной к esp32 камеры

caminfo - информация о состоянии и настройках esp32 камеры

После первой команды модулю должно появится меню, через которое так же можно управлять модулем. Меню реализовано через встроенные возможности Telegram. Кнопки так же появляются, если настроены имена у sms/email шаблонов и у Alias.

На каждую команду должен приходить ответ.

Alias (только RTOS)

Функция позволяет создавать свои кнопки. Name - имя кнопки, to - команда (до 30 символов). Например, для управления gpio19 - setgpio19 2.



Сообщения на канал

Для публикации данных на канал требуется установить дополнительную опцию "Текстовый id чата", а в настройках модуля, в поле chat id указать текстовое имя канала включая знак @ маленькими буквами. Бота обязательно добавляем в администраторы канала.

Управление модулем через команды на канале так же работает(на esp32), но вывод меню недоступен - это ограничение Telegram

Список доступа (user list)

Опция позволяет дать нескольким пользователям доступ к управлению модулем. На данный момент уведомления от функций модуля доступны только пользователю, который прописан на вкладке notification. Если требуется отправлять уведомления нескольким пользователям, то создайте канал для этого. 

В дополнительных настройках перед компиляцией  можно задать количество пользователей, которым будет дан доступ к модулю. При установке в  - 0, список доступа будет отключен.

Настройка списка доступа - в подменю Notifications -> User list. Вводить можно только числовые ID пользователей.

Отладка

У ESP32 и ESP8266RTOS в UART можно увидеть сообщения от сервера telegram. Запрос команд не отображает состояние - выводит только ошибки.