Bouw een Telegram Bot op Arduino MKR WiFi 1010: IoT Starter Handleiding

Onderdelen en Benodigdheden

Over dit Project

Dit project demonstreert hoe je Arduino koppelt aan de Telegram Bot API's. Het is gebouwd rond het nieuwe MKR WiFi 1010 bord met een ESP32 module van U-BLOX.

Op dit moment is het project niet meer dan een proof-of-concept, om te laten zien wat er mogelijk is. Je hebt alleen het Arduino bord nodig.

Maar wat is een Telegram bot? Bots zijn simpelweg Telegram-accounts die door software worden bediend – niet door mensen – en ze hebben vaak AI-functies. Ze kunnen alles: leren, spelen, zoeken, uitzenden, herinneren, verbinden, integreren met andere diensten, of zelfs commando's doorgeven aan het Internet of Things.

In ons geval sturen we commando's naar Arduino om een simpel IoT-apparaat te bouwen. Het antwoordt op simpele commando's en zet de ingebouwde LED aan/uit. Ik laat je verbeelding de rest bedenken... (stel je voor dat je een of meer relais aan de I/O pinnen koppelt en de verwarming of airconditioning met je smartphone aan/uit zet).

Stap 1: Wat Je Nodig Hebt

• Arduino MKR WiFi 1010 uit de Arduino winkel: store.arduino.cc
• Arduino IDE 1.8.5 of hoger: arduino.cc
• Een micro-USB kabel om Arduino met je PC te verbinden
• Een internetverbinding, vereist SSID en wachtwoord. Beter je eigen thuissrouter gebruiken om zeker te zijn dat het niet geblokkeerd is.
• Telegram app geïnstalleerd op je smartphone, merk maakt niet uit. Check hier voor PC en Web versies.

Stap 2: De IDE Installeren

Meesten hebben de Arduino IDE al geïnstalleerd, maar deze tutorial is ook voor beginners.

1. Download Arduino IDE 1.8.5 (zip voor 'non administrators' of exe).
2. Start de IDE.
3. Ga naar Tools > Boards > Boards Manager.
4. Zoek "Arduino SAMD boards" wat de MKR WiFi 1010 bevat.
5. Klik op het tabblad of "More info", kies de nieuwste versie en installeer. Dit installeert ook de drivers.
6. Je hebt ook een nieuwe WiFi bibliotheek nodig: Sketch > Include Library > Manage Libraries. Zoek "Wifinina" en installeer.
7. Sluit je nieuwe Arduino bord aan en wacht tot Windows de drivers installeert.
8. Onder Tools > Board kies je MKR WiFi 1010.
9. Een speciale bibliotheek is nodig: ESP8266TelegramBot library door Giancarlo Bacchio. Deze is licht aangepast voor dit bord en zit in de sketch-map.
10. Kies de juiste COM-poort en test het bord met Get Board Info.

Gefeliciteerd, je bent klaar met de IDE!

Stap 3: De Telegram Bot Maken

1. Open de Telegram app en zoek in de zoekbalk naar @BotFather en start een chat.
2. Na /start zie je de help lijst.
3. Typ /newbot.
4. Geef een naam voor je bot (zichtbaar in contactgegevens).
5. BotFather vraagt om een gebruikersnaam. Deze moet 5-32 karakters zijn, hoofdletterongevoelig, alleen Latijnse letters, cijfers en underscores. De gebruikersnaam moet eindigen op 'bot', bijv. 'tetris_bot' of 'TetrisBot'.
6. Als beide geldig zijn, ontvang je een lange string: de TOKEN. Dit is je persoonlijke sleutel om te communiceren met Telegram-servers. Kopieer en bewaar het. Als je het verliest, typ /token bij BotFather voor een nieuwe.

Alle stappen staan beschreven op: core.telegram.org

Geavanceerd (optioneel)

• Typ /help bij BotFather.
• /setuserpic om een afbeelding voor je bot te uploaden.
• /setabouttext voor de "Over" sectie op het profiel.
• /setdescription voor een beschrijving die gebruikers zien als ze een chat openen.

Stap 4: Sketch Aanpassen, Uploaden en Testen

1. Download de bijgevoegde sketch en pak uit. Verander geen namen/mappen tenzij je weet wat je doet.
2. Aanpassen: Open de sketch, ga naar tab arduino_secrets.h:
   • Vul je WiFi netwerknaam (SSID) en wachtwoord in.
   • Vul de Telegram Bot gegevens in: naam, gebruikersnaam en token van @BotFather.
3. Uploaden: Zorg dat het juiste bord geselecteerd is in de IDE, compileer en upload.
4. Testen: BELANGRIJK! De sketch stuurt logs naar de IDE. De processor heeft een native USB poort (zoals Leonardo). Zodra aangesloten, wacht de code tot de Serial Monitor draait. Laat hem aangesloten en open de Serial Monitor. Arduino verbindt met internet, begint te polsen naar de Telegram-server voor nieuwe berichten.
5. Open Telegram op je apparaat, zoek de naam van je bot (niet de gebruikersnaam die op 'bot' eindigt). Open een chat.
6. Eerste commando: /start – Arduino antwoordt met een welkomstbericht.
7. Typ help (zonder slash) – het geeft een lijst met ondersteunde commando's. Probeer ze allemaal.

Als iets niet werkt, controleer de ingevoerde gegevens in de sketch (naam, gebruikersnaam, token...).

Certificaten Als je fouten ervaart bij verbinding met de Telegram-server (log: "Bot not connected"):

1. Open Tools > Wifi101/wifinina updater.
2. Zorg dat je bord aangesloten is, check de poorten links in de updater tool.
3. Klik "Open updater sketch" en upload naar het bord.
4. Na upload, kies de nieuwste firmware voor je bord en klik "update firmware".
5. Na update, in de updater, sectie "SSL certificates", klik "Add domain", voer telegram.org:443 in en druk OK.
6. Klik "Upload certificates to wifi module".
7. Upload deze sketch weer naar het bord.

Stap 5: Verbeteringen

Kijkend naar de code is het heel simpel om nieuwe commando's te implementeren en de gebruiker te beantwoorden.

Nieuwe Commando's

Je kunt een subroutines schrijven voor elk nieuw commando. Elke sub zorgt voor het uitvoeren van het commando en (eventueel) het terugsturen van statusinformatie.

Gebruikers Beperken

Dit project is alleen een demo. Elke Telegram-gebruiker kan verbinden en ongewenste commando's sturen. Dat wil je niet! In de afbeelding zie je 2 verbonden gebruikers. Elke gebruiker heeft een eigen User ID. Met wat codewerk kun je filteren (of een lijst bouwen) voor geautoriseerde gebruikers. Bestudeer de code en probeer de User ID af te vangen. Voer commando's alleen uit van bekende gebruikers.

Hardware

Veel sensoren en relais kunnen aan de I/O pinnen van Arduino worden aangesloten. Let op: dit bord is 3.3V tolerant!!! Gebruik een voltage level shifter waar nodig! Meer info en tips: arduino.cc/en/Guide/MKRWiFi1010

Dat is alles, veel plezier!

Code

MKR1010Bot_V1_02.zip (C/C++)

Telegram Bot sketch – download alleen (geen preview beschikbaar).