initial commit
This commit is contained in:
commit
d01b53242e
|
|
@ -0,0 +1,64 @@
|
||||||
|
# Arduino Telegram Bot - README
|
||||||
|
|
||||||
|
## Übersicht
|
||||||
|
|
||||||
|
Dieses Projekt implementiert einen Telegram-Bot auf einem ESP8266-Mikrocontroller, der mit einem Telegram-Konto verbunden ist und Nachrichten basierend auf einem externen Eingang (z.B. einem Taster) sendet. Das Setup verwendet die ESP8266WiFi-Bibliothek, um den ESP8266 mit einem WLAN-Netzwerk zu verbinden, und die UniversalTelegramBot-Bibliothek, um den Bot zu steuern.
|
||||||
|
|
||||||
|
## Funktionen
|
||||||
|
|
||||||
|
- **Telegram Bot Integration:** Der ESP8266 ist mit einem Telegram-Bot verbunden, der Nachrichten an einen vordefinierten Chat sendet.
|
||||||
|
- **Eingangserkennung:** Ein GPIO-Pin wird als Eingang verwendet, um ein externes Signal (z.B. ein Tastendruck) zu erfassen. Wenn ein Signal erkannt wird, sendet der Bot eine Nachricht an den definierten Telegram-Chat.
|
||||||
|
- **Prellschutz:** Der Code enthält einen einfachen Mechanismus, um Prellen des Tasters zu vermeiden.
|
||||||
|
|
||||||
|
## Komponenten
|
||||||
|
|
||||||
|
- **ESP8266 Mikrocontroller** (z.B. NodeMCU)
|
||||||
|
- **Taster** oder andere Eingangsquelle, die an den definierten GPIO-Pin angeschlossen ist
|
||||||
|
- **WLAN Netzwerk** mit Zugangsdaten
|
||||||
|
- **Telegram Bot Token** und **Chat ID**
|
||||||
|
|
||||||
|
## Bibliotheken
|
||||||
|
|
||||||
|
Die folgenden Bibliotheken werden verwendet:
|
||||||
|
|
||||||
|
- `ESP8266WiFi.h`: Ermöglicht die WLAN-Verbindung des ESP8266.
|
||||||
|
- `WiFiClientSecure.h`: Bietet sichere (SSL) Verbindungen für den ESP8266.
|
||||||
|
- `UniversalTelegramBot.h`: Ermöglicht die Steuerung eines Telegram-Bots.
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
1. **Arduino IDE vorbereiten:**
|
||||||
|
- Installiere die Arduino IDE, falls noch nicht geschehen.
|
||||||
|
- Installiere das ESP8266 Board-Paket über den Board-Manager.
|
||||||
|
- Installiere die benötigten Bibliotheken (`ESP8266WiFi`, `WiFiClientSecure`, `UniversalTelegramBot`) über den Bibliotheks-Manager der Arduino IDE.
|
||||||
|
|
||||||
|
2. **Telegram Bot erstellen:**
|
||||||
|
- Erstelle einen neuen Bot über den [@BotFather](https://t.me/BotFather) auf Telegram und notiere dir den generierten Bot Token.
|
||||||
|
|
||||||
|
3. **Projektkonfiguration:**
|
||||||
|
- Ersetze die Platzhalter `WIFISSID`, `WFIPASS`, `TOKEN`, und `chatID` im Code durch die tatsächlichen Werte für dein WLAN und den Telegram Bot.
|
||||||
|
|
||||||
|
4. **Verkabelung:**
|
||||||
|
- Verbinde den Taster (oder einen anderen Eingang) mit dem entsprechenden GPIO-Pin des ESP8266 (z.B. GPIO0, D1 auf einem NodeMCU).
|
||||||
|
|
||||||
|
## Nutzung
|
||||||
|
|
||||||
|
1. **Upload:** Lade den Sketch auf deinen ESP8266 hoch.
|
||||||
|
2. **Verbindung:** Der ESP8266 verbindet sich mit dem angegebenen WLAN und startet den Telegram-Bot.
|
||||||
|
3. **Eingabe Erkennen:** Drücke den angeschlossenen Taster, um eine Nachricht ("Ding Dong") an den konfigurierten Telegram-Chat zu senden.
|
||||||
|
4. **Nachrichtenüberprüfung:** Der ESP8266 überprüft regelmäßig auf neue Nachrichten im Bot-Chat, die in der Konsole angezeigt werden.
|
||||||
|
|
||||||
|
## Anpassungen
|
||||||
|
|
||||||
|
- **Eingabepin:** Der Eingabepin kann in der `inputPin`-Variable definiert und an die spezifischen Anforderungen angepasst werden.
|
||||||
|
- **Bot-Konfiguration:** Anpassungen an der Frequenz der Nachrichtenüberprüfung (`BOT_MTBS`) und anderen Bot-Einstellungen können vorgenommen werden.
|
||||||
|
|
||||||
|
## Fehlersuche
|
||||||
|
|
||||||
|
- **Verbindung fehlgeschlagen:** Überprüfe WLAN-SSID und Passwort.
|
||||||
|
- **Keine Nachrichten gesendet:** Überprüfe den Status des GPIO-Pins und stelle sicher, dass der Bot korrekt eingerichtet ist.
|
||||||
|
- **Sicherheitswarnungen:** Stelle sicher, dass das Root-Zertifikat für Telegram korrekt eingebunden ist.
|
||||||
|
|
||||||
|
## Lizenz
|
||||||
|
|
||||||
|
Dieses Projekt steht unter der MIT-Lizenz - siehe die [LICENSE.md]
|
||||||
|
|
@ -0,0 +1,112 @@
|
||||||
|
#include <ESP8266WiFi.h>
|
||||||
|
#include <WiFiClientSecure.h>
|
||||||
|
#include <UniversalTelegramBot.h>
|
||||||
|
|
||||||
|
// Wifi network station credentials
|
||||||
|
#define WIFI_SSID WIFISSID
|
||||||
|
#define WIFI_PASSWORD WIFIPASS
|
||||||
|
|
||||||
|
#define BOT_TOKEN BOTTOKEN
|
||||||
|
|
||||||
|
const String CHAT_ID = CHATID;
|
||||||
|
const unsigned long BOT_MTBS = 1000; // mean time between scan messages
|
||||||
|
|
||||||
|
// GPIO Pin Definition
|
||||||
|
const int inputPin = 0;
|
||||||
|
|
||||||
|
// Initiale Zustandsvariablen
|
||||||
|
bool lastState = LOW;
|
||||||
|
bool again = true;
|
||||||
|
int count = 0;
|
||||||
|
X509List cert(TELEGRAM_CERTIFICATE_ROOT);
|
||||||
|
WiFiClientSecure secured_client;
|
||||||
|
UniversalTelegramBot bot(BOT_TOKEN, secured_client);
|
||||||
|
unsigned long bot_lasttime; // last time messages' scan has been done
|
||||||
|
bool Start = false;
|
||||||
|
|
||||||
|
void handleNewMessages(int numNewMessages)
|
||||||
|
{
|
||||||
|
Serial.println("handleNewMessages");
|
||||||
|
Serial.println(String(numNewMessages));
|
||||||
|
|
||||||
|
for (int i = 0; i < numNewMessages; i++)
|
||||||
|
{
|
||||||
|
String chat_id = bot.messages[i].chat_id;
|
||||||
|
String text = bot.messages[i].text;
|
||||||
|
|
||||||
|
String from_name = bot.messages[i].from_name;
|
||||||
|
if (from_name == "")
|
||||||
|
from_name = "Guest";
|
||||||
|
|
||||||
|
if (text == "/send_test_action")
|
||||||
|
{
|
||||||
|
bot.sendChatAction(chat_id, "typing");
|
||||||
|
delay(4000);
|
||||||
|
bot.sendMessage(chat_id, "Did you see the action message?");
|
||||||
|
}
|
||||||
|
|
||||||
|
if (text == "/start")
|
||||||
|
{
|
||||||
|
String welcome = "Willkommen beim Klingelbot";
|
||||||
|
bot.sendMessage(chat_id, welcome);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
void setup()
|
||||||
|
{
|
||||||
|
Serial.begin(115200);
|
||||||
|
|
||||||
|
pinMode(inputPin, INPUT_PULLUP);
|
||||||
|
// Set WiFi to station mode and disconnect from an AP if it was Previously
|
||||||
|
// connected
|
||||||
|
WiFi.mode(WIFI_STA);
|
||||||
|
WiFi.disconnect();
|
||||||
|
delay(100);
|
||||||
|
|
||||||
|
// attempt to connect to Wifi network:
|
||||||
|
Serial.print("Connecting to Wifi SSID ");
|
||||||
|
Serial.print(WIFI_SSID);
|
||||||
|
Serial.print(" ");
|
||||||
|
WiFi.begin(WIFI_SSID, WIFI_PASSWORD);
|
||||||
|
secured_client.setTrustAnchors(&cert); // Add root certificate for api.telegram.org
|
||||||
|
while (WiFi.status() != WL_CONNECTED)
|
||||||
|
{
|
||||||
|
Serial.print(".");
|
||||||
|
delay(500);
|
||||||
|
}
|
||||||
|
Serial.println();
|
||||||
|
|
||||||
|
Serial.print("WiFi connected. IP address: ");
|
||||||
|
Serial.println(WiFi.localIP());
|
||||||
|
}
|
||||||
|
|
||||||
|
void loop()
|
||||||
|
{
|
||||||
|
if (millis() - bot_lasttime > BOT_MTBS)
|
||||||
|
{
|
||||||
|
int numNewMessages = bot.getUpdates(bot.last_message_received + 1);
|
||||||
|
|
||||||
|
while (numNewMessages)
|
||||||
|
{
|
||||||
|
Serial.println("got response");
|
||||||
|
handleNewMessages(numNewMessages);
|
||||||
|
numNewMessages = bot.getUpdates(bot.last_message_received + 1);
|
||||||
|
}
|
||||||
|
delay(100); // Kurze Pause, um Prellen zu vermeiden
|
||||||
|
bot_lasttime = millis();
|
||||||
|
}
|
||||||
|
if (digitalRead(inputPin) == LOW) {
|
||||||
|
if (again) {
|
||||||
|
bot.sendMessage(CHAT_ID, "Ding Dong");
|
||||||
|
again = false;
|
||||||
|
} else {
|
||||||
|
count ++;
|
||||||
|
Serial.println (count);
|
||||||
|
if (count >20) {
|
||||||
|
again = true;
|
||||||
|
count=0;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
Loading…
Reference in New Issue