Telegram
Поддержка Telegram. Отправка уведомлений и управление(только у RTOS прошивок).
С 16.04.2018 Telegram в России заблокирован. Работа опции не возможна. Разблокирован 19.06.2020.
С начала 2020 года Telegram обновил минимальный TLS протокол и на обычной ESP8266 он может не работать. Работает на ESP8266RTOS(если достаточно ОЗУ)
Работа опции аналогична другим опциям уведомлений. Настройка опции находится в общей для этих целей вкладке Notifications.
Обратите внимание, что опция использует достаточно ресурсоёмкую SSL. Для ESP8266 это критично - там ОЗУ должно быть свободно не меньше 28кб для работы опции. По этой причине функций влезает крайне мало.
При установленной опции SMS/Email шаблонов доступна отправка значений датчиков и GPIO/VGPIO по планировщику заданий, а так же по отправке заданной команды. Так же доступно уведомление из функций Logic2 и Термостат. Подробное описание необходимо смотреть в документации данных функций.Необходимо добавить бота BotFather к себе в контакты и написать ему команду /newbot . Далее вводим имя как бот будет отображаться в списке контактов и в следующей строке его адрес (то же имя). В ответ на сообщения бот выдаст ID и токен через двоеточие - эти данные необходимо будет указать в настройках модуля.
Чтобы узнать свой ID (кому писать сообщение) добавляем бота ShowJsonBot и что нибудь ему пишем. В ответ он выдаст json строку с вашим ID, который нужно указать в настройках модуля в поле Chat id.
Обязательно добавляем созданного бота в список контактов используя поиск пользователей.
Функция управления должна быть включена в шестеренке опции.
Интервал опроса команд - 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 камеры;
valdes X Y - установка переменной X конструктора кода в значение Y.
После первой команды модулю должно появится меню, через которое так же можно управлять модулем. Меню реализовано через встроенные возможности Telegram. Кнопки так же появляются, если настроены имена у sms/email шаблонов и у Alias.
На каждую команду должен приходить ответ.Функция позволяет создавать свои кнопки. Name - имя кнопки, to - команда (до 30 символов). Например, для управления gpio19 - setgpio19 2.
Для публикации данных на канал требуется установить дополнительную опцию "Текстовый id чата", а в настройках модуля, в поле chat id указать текстовое имя канала включая знак @ маленькими буквами. Бота обязательно добавляем в администраторы канала.
Управление модулем через команды на канале так же работает(на esp32), но вывод меню недоступен - это ограничение Telegram
Опция позволяет дать нескольким пользователям доступ к управлению модулем. На данный момент уведомления от функций модуля доступны только пользователю, который прописан на вкладке notification. Если требуется отправлять уведомления нескольким пользователям, то создайте канал для этого.
В дополнительных настройках перед компиляцией можно задать количество пользователей, которым будет дан доступ к модулю. При установке в - 0, список доступа будет отключен.
Настройка списка доступа - в подменю Notifications -> User list. Вводить можно только числовые ID пользователей.
У ESP32 и ESP8266RTOS в UART можно увидеть сообщения от сервера telegram. Запрос команд не отображает состояние - выводит только ошибки.