{"id":4335,"date":"2026-05-02T07:04:29","date_gmt":"2026-05-02T05:04:29","guid":{"rendered":"https:\/\/g7itchme.wordpress.com\/?p=4335"},"modified":"2026-05-02T07:04:29","modified_gmt":"2026-05-02T05:04:29","slug":"ein-esp32-als-smartes-statusdisplay-fur-den-teltonika-rut240-ein-basteltaugliches-monitoring-projekt","status":"publish","type":"post","link":"https:\/\/technodidact.de\/en\/ein-esp32-als-smartes-statusdisplay-fur-den-teltonika-rut240-ein-basteltaugliches-monitoring-projekt\/","title":{"rendered":"Ein ESP32 als smartes Statusdisplay f\u00fcr den Teltonika RUT240 \u2013 ein basteltaugliches Monitoring-Projekt"},"content":{"rendered":"\n

Autor:<\/strong> DerSchneider<\/p>\n\n\n\n

\n\n\n\n

Einleitung<\/h2>\n\n\n\n

Industrielle LTE-Router wie der Teltonika RUT240 sind wahre Arbeitstiere: Sie versorgen abgelegene Maschinen, Baustellen-Container oder mobile Pop-up-Stores mit zuverl\u00e4ssigem Internet. Doch ihre Bedienoberfl\u00e4che versteckt sich hinter einer Weboberfl\u00e4che \u2013 das ist f\u00fcr schnelle Statuskontrollen oft umst\u00e4ndlich. Genau hier setzt ein kleines, aber feines Do-it-yourself-Projekt an: Ein ESP32 mit einem Display, direkt an den RUT240 angeschlossen, holt die wichtigsten Betriebsdaten aus dem Router und stellt sie \u00fcbersichtlich dar. Zus\u00e4tzlich lassen sich einfache Steuerungsfunktionen realisieren \u2013 etwa ein Neustart des Mobilfunkmoduls per Tastendruck.<\/p>\n\n\n\n

Dieser Artikel beschreibt, wie Sie ein solches System Schritt f\u00fcr Schritt aufbauen, welche Funktionen m\u00f6glich sind und worauf Sie achten m\u00fcssen. Dabei verstehe ich mich nicht nur als Anleitung, sondern auch als Einordnung in die Welt der eingebetteten Systeme und der Smart\u2011IoT\u2011Hacks, die aus der Notwendigkeit entstehen, komplexe Ger\u00e4te zu \u201eentmystifizieren\u201c.<\/p>\n\n\n\n

\n\n\n\n

Historischer Kontext: Von der seriellen Konsole zum REST\u2011API\u2011Display<\/h2>\n\n\n\n

Vor der \u00c4ra der grafischen Webserver waren Router meist nur \u00fcber eine textbasierte serielle Schnittstelle oder Telnet zu konfigurieren. Das Anzeigen von Echtzeitdaten erforderte permanente SSH\u2011Verbindungen oder aufwendige SNMP\u2011Abfragen. Mit dem Aufkommen leistungsf\u00e4higer Mikrocontroller (ESP8266, sp\u00e4ter ESP32) und der Verbreitung von REST\u2011Schnittstellen in Routern der oberen Mittelklasse \u00e4nderte sich das. Die Teltonika\u2011Ger\u00e4te bieten seit der Firmware\u2011Version RUT9XX_R_00.06.06.6 eine umfangreiche JSON\u2011API unter http:\/\/router-ip\/cgi-bin\/status<\/code> \u2013 ein Segen f\u00fcr Bastler.<\/p>\n\n\n\n

Historisch gesehen ist der ESP32 der ideale Partner: Er kann sowohl als Access Point als auch als Client im WLAN agieren, ben\u00f6tigt wenig Strom und hat genug Rechenleistung, um JSON zu parsen und ein Display anzusteuern. Die Kombination aus industriellem Router (robust, zertifiziert) und Hobby\u2011Mikrocontroller (g\u00fcnstig, flexibel) ist ein sch\u00f6nes Beispiel f\u00fcr die Demokratisierung der Netzwerkdiagnose<\/strong> \u2013 man ist nicht l\u00e4nger auf teure Monitoring\u2011Appliances angewiesen.<\/p>\n\n\n\n

\n\n\n\n

Hardware \u2013 was wird ben\u00f6tigt?<\/h2>\n\n\n\n
Komponente<\/th>Empfehlung<\/th>Ungef\u00e4hrer Preis<\/th><\/tr><\/thead>
ESP32\u2011Entwicklungsboard<\/td>ESP32\u2011DevKitC V4 (z.\u202fB. von Espressif)<\/td>10\u202f\u20ac<\/td><\/tr>
Display (I2C)<\/td>0,96\u2033 OLED SSD1306 (128\u00d764 Pixel)<\/td>8\u202f\u20ac<\/td><\/tr>
ODER TFT\u2011Display<\/td>1,3\u2033 IPS SPI (240\u00d7240) mit ST7789<\/td>12\u202f\u20ac<\/td><\/tr>
Taster (optional)<\/td>2\u00d7 Taster, 10\u202fk\u03a9 Pull\u2011down Widerst\u00e4nde<\/td>1\u202f\u20ac<\/td><\/tr>
Verbindungskabel<\/td>Jumper\u2011Kabel (F\u2013F \/ F\u2013M)<\/td>2\u202f\u20ac<\/td><\/tr>
Stromversorgung<\/td>USB\u2011A\u2011auf\u2011Micro\u2011USB\u2011Kabel (vom RUT240\u2011USB\u2011Port)<\/td>\u2013<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Warum gerade der RUT240?<\/strong> Er besitzt einen USB\u2011Host\u2011Port (nur 500\u202fmA, aber f\u00fcr ESP32 ausreichend) und l\u00e4uft mit 12\u202fV \u2013 der ESP32 wird sauber \u00fcber den USB\u2011Port versorgt. Zudem ist die API vollst\u00e4ndig dokumentiert.<\/p>\n\n\n\n

\n\n\n\n

Verdrahtung \u2013 einfach und stabil<\/h2>\n\n\n\n

Die Verbindung zwischen ESP32 und Display erfolgt bei einem I2C\u2011OLED nur \u00fcber vier Leitungen:<\/p>\n\n\n\n

ESP32\u2011Pin<\/th>OLED\u2011Pin<\/th>Funktion<\/th><\/tr><\/thead>
3.3V<\/td>VCC<\/td>Spannung<\/td><\/tr>
GND<\/td>GND<\/td>Masse<\/td><\/tr>
GPIO21<\/td>SDA<\/td>Daten<\/td><\/tr>
GPIO22<\/td>SCL<\/td>Takt<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Taster (z.\u202fB. f\u00fcr \u201eReboot\u201c) werden zwischen GPIO (z.\u202fB. 15) und GND geschaltet \u2013 mit aktiviertem internen Pull\u2011up. Ein kurzer Druck l\u00f6st dann die Aktion aus.<\/p>\n\n\n\n

https:\/\/i.imgur.com\/placeholder.png<\/a>
Verdrahtungsskizze: ESP32 mit OLED und zwei Tastern (Quelle: eigene Darstellung)<\/em><\/p>\n\n\n\n

\n\n\n\n

Software \u2013 Der ESP32 als API\u2011Client<\/h2>\n\n\n\n

1. Grundger\u00fcst (Arduino IDE)<\/h3>\n\n\n\n

Installieren Sie die notwendigen Bibliotheken:<\/p>\n\n\n\n

    \n
  • WiFi.h<\/code>\u00a0(integriert)<\/li>\n\n\n\n
  • HTTPClient.h<\/code><\/li>\n\n\n\n
  • ArduinoJson<\/code>\u00a0(Version 6)<\/li>\n\n\n\n
  • Adafruit_SSD1306<\/code>\u00a0bzw.\u00a0TFT_eSPI<\/code><\/li>\n<\/ul>\n\n\n\n

    2. Verbindung zum WLAN des RUT240 herstellen<\/h3>\n\n\n\n

    Der ESP32 loggt sich wie ein normaler Client in das vom RUT240 bereitgestellte WLAN ein \u2013 oder in ein separates IoT\u2011SSID. Achtung: Der RUT240 erlaubt standardm\u00e4\u00dfig bis zu 10 WLAN\u2011Clients, das reicht.<\/p>\n\n\n\n

    cpp<\/p>\n\n\n\n

    #include <WiFi.h>\nconst char* ssid = \"Mein-Hotspot\";\nconst char* password = \"DeinPasswort\";\n\nvoid setup() {\n  WiFi.begin(ssid, password);\n  while (WiFi.status() != WL_CONNECTED) delay(500);\n}<\/pre>\n\n\n\n
    3. Abfrage der Router\u2011API<\/h3>\n\n\n\n
    Das Status\u2011JSON des RUT240 ist gut strukturiert. Ein Auszug:<\/p>\n\n\n\n
    json<\/p>\n\n\n\n
    {\n  \"mobile\": {\n    \"signal\": {\n      \"rssi\": -71,\n      \"rsrp\": -98,\n      \"rsrq\": -12,\n      \"sinr\": 8\n    },\n    \"operator\": \"Telekom.de\",\n    \"connection_type\": \"LTE\",\n    \"data_usage\": {\n      \"today\": 124.5\n    }\n  },\n  \"wifi\": {\n    \"clients\": 3,\n    \"channel\": 6\n  },\n  \"system\": {\n    \"uptime\": 1234567,\n    \"temperature\": 52.3\n  }\n}<\/pre>\n\n\n\n
    Mit ArduinoJson<\/code> wird das Dokument ausgewertet:<\/p>\n\n\n\n
    cpp<\/p>\n\n\n\n
    HTTPClient http;\nhttp.begin(\"http:\/\/192.168.1.1\/cgi-bin\/status\");\nhttp.setAuthorization(\"admin\", \"admin01\"); \/\/ Anmeldedaten<\/em>\nint httpCode = http.GET();\nif (httpCode == 200) {\n  DynamicJsonDocument doc(2048);\n  deserializeJson(doc, http.getString());\n  int rssi = doc[\"mobile\"][\"signal\"][\"rssi\"];\n  float trafficToday = doc[\"mobile\"][\"data_usage\"][\"today\"];\n  \/\/ ... weitere Daten<\/em>\n}\nhttp.end();<\/pre>\n\n\n\n
    4. Anzeige auf dem OLED<\/h3>\n\n\n\n
    Eine einfache Funktion zeigt die Signalst\u00e4rke als Balkendiagramm und den aktuellen Datenverbrauch:<\/p>\n\n\n\n
    cpp<\/p>\n\n\n\n
    void displaySignal(int rssi, float traffic) {\n  display.clearDisplay();\n  display.setTextSize(1);\n  display.setCursor(0,0);\n  display.print(\"RSSI: \"); display.print(rssi); display.println(\" dBm\");\n  int bars = map(rssi, -110, -50, 0, 5);\n  for (int i=0; i<bars; i++) {\n    display.fillRect(10+i*15, 20, 12, 20*(i+1), WHITE);\n  }\n  display.setCursor(0, 50);\n  display.print(\"Verbr.: \"); display.print(traffic); display.println(\" MB\");\n  display.display();\n}<\/pre>\n\n\n\n
    5. Erweiterte Steuerung: Router\u2011Reboot per Taster<\/h3>\n\n\n\n
    Durch einen HTTP\u2011POST\u2011Aufruf auf \/cgi-bin\/reboot<\/code> (oder die entsprechende JSON\u2011RPC\u2011Schnittstelle) kann der ESP32 einen Neustart ausl\u00f6sen:<\/p>\n\n\n\n
    cpp<\/p>\n\n\n\n
    if (digitalRead(REBOOT_BUTTON) == LOW) {\n  http.begin(\"http:\/\/192.168.1.1\/cgi-bin\/reboot\");\n  http.setAuthorization(\"admin\", \"admin01\");\n  http.POST(\"\");  \/\/ Kann leer sein<\/em>\n  \/\/ Warten, dann ESP32 in Tiefschlaf?<\/em>\n}<\/pre>\n\n\n\n
    Sicherheitshinweis:<\/strong> Die API verwendet Basic\u2011Auth. Da die Kommunikation im lokalen Netzwerk stattfindet, ist das akzeptabel. Wer auf Nummer sicher gehen will, aktiviert auf dem RUT240 HTTPS (unter System \u2192 Administration \u2192 Web Access<\/em>) und nutzt https:\/\/<\/code> im ESP32\u2011Code. Das erfordert allerdings das Einbinden des Zertifikats.<\/p>\n\n\n\n
    \n\n\n\n
    M\u00f6gliche Funktionen im \u00dcberblick<\/h2>\n\n\n\n
    Funktion<\/th>API\u2011Endpoint<\/th>Nutzbare Anzeige \/ Aktion<\/th><\/tr><\/thead>
    Mobilfunk\u2011Signalst\u00e4rke<\/td>\/cgi-bin\/status<\/code> \u2192 mobile.signal<\/td>Balken oder Zahlenwert<\/td><\/tr>
    Verbundene WLAN\u2011Clients<\/td>\/cgi-bin\/status<\/code> \u2192 wifi.clients<\/td>Anzahl und (optional) MACs<\/td><\/tr>
    Datenverbrauch (heute \/ Monat)<\/td>\/cgi-bin\/status<\/code> \u2192 mobile.data_usage<\/td>MB \/ GB<\/td><\/tr>
    Router\u2011Temperatur (CPU\/Modem)<\/td>\/cgi-bin\/status<\/code> \u2192 system.temp<\/td>\u00b0C anzeigen, Warnung bei >70\u00b0C<\/td><\/tr>
    Neustart des Routers<\/td>POST \/cgi-bin\/reboot<\/code><\/td>Taster oder Men\u00fc\u2011Auswahl<\/td><\/tr>
    WLAN\u2011Ein\u2011\/Ausschalten<\/td>\/cgi-bin\/wireless?enable=0\/1<\/code><\/td>Relais auf dem Display<\/td><\/tr>
    SMS senden (bei SIM\u2011f\u00e4hig)<\/td>\/cgi-bin\/sms<\/code> (mit JSON\u2011Payload)<\/td>Texteingabe \u00fcber Taster (umst\u00e4ndlich)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    Besonders n\u00fctzlich ist die kombinierte Anzeige<\/strong> von RSSI und RSRQ \u2013 der RUT240 liefert beide Werte. Aus der Differenz l\u00e4sst sich die Funkstreckenqualit\u00e4t besser beurteilen als allein aus der Empfangsfeldst\u00e4rke.<\/p>\n\n\n\n
    \n\n\n\n
    Kontroversen und Einschr\u00e4nkungen \u2013 eine ehrliche Betrachtung<\/h2>\n\n\n\n
    Kontroverse 1: Sicherheitsrisiko durch \u201eIoT\u2011Hack\u201c<\/strong>
    Kritiker argumentieren, ein zus\u00e4tzlicher ESP32 im gleichen Netzwerk erh\u00f6he die Angriffsfl\u00e4che. Das stimmt teilweise. Wer jedoch die Standard\u2011Credentials des RUT240 \u00e4ndert und den ESP32 ausschlie\u00dflich im WLAN des Routers (nicht im WAN) betreibt, minimiert das Risiko. Alternativ kann der ESP32 per LAN\u2011Kabel (\u00fcber einen FTDI\u2011Adapter an die serielle Konsole?) angebunden werden \u2013 das ist aber aufwendig.<\/p>\n\n\n\n
    Kontroverse 2: \u201eWarum nicht einfach RMS (Teltonika Remote Management) nutzen?\u201c<\/strong>
    RMS ist ein kostenpflichtiger Cloud\u2011Dienst, der weit mehr kann: Fernzugriff, Bulk\u2011Konfiguration, Alarmierung. Aber f\u00fcr den Einzelanwender, der nur gelegentlich den Signalpegel checken m\u00f6chte, ist RMS Overkill. Zudem wird der Datenverkehr \u00fcber die RMS\u2011Cloud geleitet \u2013 ein lokales Display ist sofort, ohne Latenz und ohne monatliche Geb\u00fchren.<\/p>\n\n\n\n
    Einschr\u00e4nkung: API\u2011Dokumentation<\/strong>
    Teltonika ver\u00f6ffentlicht keine vollst\u00e4ndige OpenAPI\u2011Spezifikation. Die vorhandenen Endpoints sind nur teilweise dokumentiert. Man hilft sich mit Netzwerksniffing (z.\u202fB. \u00fcber die Browser\u2011Entwicklertools), indem man die echte WebUI beobachtet. Das ist nicht elegant, bietet aber einen tiefen Einblick in die Router\u2011Interna.<\/p>\n\n\n\n
    Einschr\u00e4nkung: Stromverbrauch<\/strong>
    Der ESP32 zieht im Normalbetrieb etwa 80\u202fmA, das OLED noch einmal 20\u202fmA \u2013 insgesamt 100\u202fmA bei 3,3\u202fV. Der USB\u2011Port des RUT240 liefert maximal 500\u202fmA, das ist unkritisch. Trotzdem sollte man den ESP32 nicht in einer dauerhaft stromlosen Umgebung betreiben, da er die Batterie eines mobilen Routers (sofern vorhanden) merkbar belastet.<\/p>\n\n\n\n
    \n\n\n\n
    Zukunftsperspektiven und Weiterentwicklungen<\/h2>\n\n\n\n
    Das Projekt l\u00e4sst sich in mehrere Richtungen erweitern:<\/p>\n\n\n\n