This app is a Telegram Bot. With this app you are able to get the following information from the Toon on Telegram:
- current measured temperature
- current thermostat temperature
- current active program
- program state (on/off/temporary)
- next program
- energy usage
With some commands you can also change the following:
- thermostat temperature
- program
- program state (on/off)
If you have a smokedetector you can enable an alarm which will be send to a specified Telegram ChatId. This can also be a Telegram group.
You can get the ChatId by sending a unknown command (example /blabla) to your Bot from the Telegram chat or group.
When a random character is sent from Telegram, it returns a message with the possible commands. The app will poll Telegram with a configurable interval. So a respons from Toon will arrive after this interval.
On the Tile it shows:
- name and username of the bot
- last received command
- status
When clicking on the Tile you get a screen with the last received commands. But when a token is not defined you get a popup about this token.
There is also a refresh button to trigger a manual update from Telegram. Use this also when the status is showing an error on the Tile. It will trigger getting the updates again.
You can change the following settings:
- token of Telgram bot (it won't work without; instructions are on the page)
- refresh interval (interval in seconds to get new message from Telegram)
- alarm ChatId (ChatId where the smokedetector alarm will be send)
- refresh of messages on/off (switch off receiving messages from Telegram)
- icon in systray
- enable or disable security
- enable or disable smokedetector alarm
(if you don't like adding the token by the keyboard you can save the configuration one time and add the token by login on the Toon and add the token in /mnt/data/tsc/toonbot.userSettings.json)
Before you can use this app, you have to create a Telegram Bot first. It is very easy to create a bot. See instructions on the configuration screen (or here https://core.telegram.org/bots#6-botfather ).
You can also control the Toon with more people from a Telegram group. Just add the Bot to a group.
If you change the display name of your bot (with BotFarther) it will be visible after restart of Toon GUI (TSC menu).
If you choose a long username and display name when creating a bot, it will probably not fit on the Tile. Is is also visible on the screen after clicking in the Tile (or use the systray icon).
You can not change the username after creating the Bot (just create a new bot). You can only change the display name.
It is also possible to define the commands in your bot. Go to BotFather and give the command /setcommands.
Paste the following (and change it if needed) and Enter:
Code: Select all
info - Vraag Toon gegevens op
energie - Vraag energie verbruik op
prog_c - Activeer programma Comfort
prog_t - Activeer programma Thuis
prog_w - Activeer programma Weg
prog_s - Activeer programma Slapen
auto_a - Zet auto programma aan
auto_u - Zet auto programma uit
therm_20 - Thermostaat op 20 graden
Example of Telegram messages: Normaly everybody who can find your Bot can communicate with it. This means they can control your Toon !!
With V1.2.0 security is added. This means you can choose that only messages from configured users or groups are processed. Messages from other users are displayed but ignored.
You can add at most 24 users or groups. This can be done on the messages screen. Users which are not in the list will show a +-sign. Click on this to add the user. If the user is not on the screen you can ask the user to sent a message (which is denied) to the ToonBot first. On the Instellingen screen (Beheer toegang) you can remove users or groups.
Even if you see the name of the user or group, access is based on chat id. So if a user or group change name makes no differences.
You or others can also use groups (for the family for example) and see the commands other group members are using. But you can also deny (I recommend) your bot to join groups.
First make your own group(s) if needed and add your bot to the group. Then:
- Open a session with BotFather.
- Enter /setjoingroups.
- Enter the name of the bot. @example_bot.
- Enter Disable
So again, DON'T forget to add the security !
V1.0.0
Initial release
V1.0.1
- fixed last update time sometimes wrong
- fixed refresh after Telegram request failure
V1.0.2
- debug logging switched off by default
V1.1.0
- changed bot commands to make it possible to use the commands in /setcommands in BotFather
V1.2.0
- improved security so processing of messages can be restricted
V1.3.0
- added command for energy usage
V1.4.0
- added smokedetector alarm
Known issues
Empty thumbnail icon when adding to Tile. Has no influence on app functionality. Is fixed when using firmware 5.25.8 or later.