Bastelprojekt · ESP32 · Bluetooth

Status-Türschild mit ESP32

Ein digitales Türschild fürs Büro: Der Status steht als großes, farbiges Bild auf einem Touch-Display. Umgeschaltet wird mit einem Tipp am Schild oder über eine Webseite auf dem Handy, per Bluetooth und ganz ohne WLAN.

Bauteile ab ca. 20 € ohne Löten 2,8″ oder 4,0″ Android & iPhone
Türschild mit dem Status Mittagspause und einer Kaffeetasse auf gelbem Grund Türschild mit dem Status Besprechung im Hause auf rotem Grund
Beispiel-Status in der Vorschau: 2,8″ (320×240) und 4,0″ (480×320)

Was das Schild kann

Jeder Status ist ein Bild auf der microSD-Karte, zum Beispiel:

Verfügbar Mittagspause Besprechung im Hause Bitte nicht stören Außer Haus Homeoffice Urlaub
  • Ein Tipp genügtAuf dem Handy zeigt jede Kachel einen Status, ein Tipp schaltet das Schild um.
  • Bedienung am SchildLinks tippen = zurück, rechts tippen = weiter, Wischen geht auch.
  • Eigene Bilder & GIFsStatus-Bilder im Browser gestalten oder Fotos und kleine Animationen hochladen.
  • Kein WLANDas WLAN-Modul bleibt aus. Gesteuert wird nur über Bluetooth LE.
  • PIN-KopplungNur gekoppelte Handys können den Status ändern oder Bilder schicken.
  • NachtmodusDisplay schaltet abends und am Wochenende automatisch ab.

Einkaufsliste

Du brauchst nur eines der beiden Boards. ESP32, Display, Touch und SD-Kartenleser sind jeweils schon auf einer Platine vereint.

Kompakt

2,8″-Board ESP32-2432S028

Auflösung
320 × 240
Treiber
ST7789 oder ILI9341
Touch
resistiv, Stift liegt bei
Spitzname
„Cheap Yellow Display“
Bei Amazon ansehen
Besser lesbar

4,0″-Board E32R40T

Auflösung
480 × 320
Treiber
ST7796
Touch
resistiv
Vorteil
vom Flur aus gut lesbar
Bei Amazon ansehen
  • microSD-Karte mit 1–32 GB, FAT32 formatiert
  • USB-Netzteil (ein Handy-Ladegerät reicht) und ein USB-Kabel, das Daten überträgt
  • optional: 3D-Drucker für das Gehäuse, doppelseitiges Klebeband für die Tür

Downloads

  • Tuerschild.inoFirmware für Arduino IDE · beide Boards · 29 KB
    Herunterladen
  • tuerschild-steuerung.htmlHandy-Webseite zum Steuern, als index.html auf den Server legen · 26 KB
    Herunterladen
  • Gehäuse 2,8″ – RahmenSTL zum Slicen · 24 KB
    Herunterladen
  • Gehäuse 2,8″ – DeckelSTL zum Slicen · 109 KB
    Herunterladen
  • Gehäuse als OpenSCADMaße anpassen und neu exportieren · 2 KB
    Herunterladen

Die Firmware muss in einem Ordner liegen, der ebenfalls Tuerschild heißt: Tuerschild/Tuerschild.ino.

1

Arduino IDE installieren

Lade die Arduino IDE 2 für dein Betriebssystem herunter und installiere sie.

2

ESP32-Unterstützung einrichten

  1. Links auf das Board-Symbol klicken (Boardverwalter).
  2. Nach esp32 suchen und „esp32 by Espressif Systems“ (Version 3.x) installieren.

Fehlt der Eintrag, trägst du unter Datei → Einstellungen → „Zusätzliche Boardverwalter-URLs“ ein:

https://espressif.github.io/arduino-esp32/package_esp32_index.json
Geduld: Das Paket ist sehr groß. Die Meldung „Verarbeiten esp32:3.x“ kann unter Windows 10–30 Minuten stehen bleiben, weil der Virenscanner jede Datei prüft. Nicht abbrechen.
3

Bibliotheken installieren

Im Bibliotheksverwalter (Bücher-Symbol) diese drei suchen und installieren. Abhängigkeiten mit „Alle installieren“ bestätigen.

BibliothekAutorVersion
LovyanGFXlovyan03ab 1.1.12
NimBLE-Arduinoh2zero2.x
AnimatedGIFLarry Bankab 2.0
4

Sketch öffnen und anpassen

Lade Tuerschild.ino herunter und öffne Tuerschild/Tuerschild.ino. Der Ordner muss genauso heißen wie die Datei. Oben im Sketch stellst du ein:

#define BOARD            BOARD_E32R40T   // 4,0"-Board
// #define BOARD         BOARD_CYD28     // 2,8"-Board

#define BLE_PIN          123456          // eigene 6-stellige PIN!

#define PANEL_ST7789     1               // nur 2,8": 0 = ILI9341
#define PANEL_INVERT     false           // Farben wie Negativ? umstellen
#define PANEL_BGR        false           // Rot/Blau vertauscht? umstellen
Ändere unbedingt die BLE_PIN. Mit ihr koppelst du später dein Handy.
5

Board einstellen und flashen

Board per USB anschließen und unter Werkzeuge wählen:

BoardESP32 Dev Module
Partition SchemeHuge APP (3MB No OTA/1MB SPIFFS)
Upload Speed921600 (bei Problemen 460800)
Portder neu erschienene COM-Port

Dann auf den Pfeil Hochladen klicken. Das erste Kompilieren dauert einige Minuten.

Kein Port? Die Boards nutzen einen CH340-USB-Chip. Unter Windows ggf. den CH340-Treiber von WCH installieren und ein anderes Kabel probieren.
Hängt bei „Connecting…“? Die BOOT-Taste gedrückt halten, bis der Upload startet.

Werkzeuge → Serieller Monitor (115200 Baud) zeigt beim Start z. B. [START] Display 480x320.

6

microSD-Karte vorbereiten

Karte mit FAT32 formatieren und einsetzen. Der Ordner /img wird automatisch angelegt. Nach dem Neustart zeigt das Schild „Keine Bilder vorhanden“. Display und Karte funktionieren also.

Bilder kannst du auch direkt am PC in /img kopieren: JPG (Baseline) oder GIF in Displaygröße. Die Reihenfolge ist alphabetisch, also am besten mit 01_, 02_ … beginnen.

7

Handy-Webseite bereitstellen

Die Steuerung ist eine einzelne Datei (tuerschild-steuerung.html, auf dem Server als index.html ablegen). Web Bluetooth funktioniert nur über https://. Die Datei muss also auf einem Webserver liegen. Mit Docker und einem Reverse-Proxy wie Pangolin, Traefik oder Nginx Proxy Manager geht das so:

tuerschild-web/
├── docker-compose.yml
├── nginx.conf
└── html/
    └── index.html

docker-compose.yml

services:
  tuerschild:
    image: nginx:alpine
    container_name: tuerschild
    restart: unless-stopped
    volumes:
      - ./html:/usr/share/nginx/html:ro
      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
    networks:
      - pangolin

networks:
  pangolin:
    external: true

nginx.conf

server {
    listen 80;
    server_name _;
    server_tokens off;
    root /usr/share/nginx/html;
    index index.html;
    location / {
        try_files $uri $uri/ /index.html;
        add_header Cache-Control "no-cache";
    }
}

Starten mit docker compose up -d. Im Reverse-Proxy eine HTTP-Ressource mit Ziel tuerschild:80 anlegen und die Anmeldung aktiviert lassen.

Ohne eigenen Server geht es auch kostenlos mit GitHub Pages.
8

Handy verbinden und koppeln

  1. Seite öffnen: Android in Chrome, iPhone in der App Bluefy. Safari kann kein Web Bluetooth.
  2. Auf Verbinden tippen und „Tuerschild“ auswählen.
  3. Das Handy fragt nach der PIN. Gib die Ziffern aus BLE_PIN ein.

Danach sind Handy und Schild gekoppelt. Die Uhrzeit für den Nachtmodus wird bei jeder Verbindung übernommen.

9

Status-Bilder anlegen und umschalten

Im Reiter Setup legt „Alle Vorlagen hochladen“ acht fertige Status auf einmal an. Eigene gestaltest du mit Symbol, zwei Textzeilen und Farben. Fotos werden automatisch auf die Displaygröße zugeschnitten.

Im Reiter Bedienung erscheinen alle Status als Kacheln. Ein Tipp, und das Schild schaltet um. Der aktive Status ist grün umrandet.

Handy-Webseite, Reiter Bedienung mit Status-Kacheln
Bedienung: ein Tipp pro Status
Handy-Webseite, Reiter Setup mit Status-Editor
Setup: Status-Bild gestalten
10

Gehäuse drucken (optional)

Für das 2,8″-Board gibt es ein zweiteiliges Gehäuse aus Rahmen und Steckdeckel, Außenmaß ca. 92 × 56 × 17 mm, Kabelaustritt rechts. Gedruckt wird ohne Stützmaterial in PLA oder PETG mit 0,2 mm Schichthöhe, jeweils mit der flachen Seite aufs Druckbett.

Tipp: Erst nur die unteren 2–3 mm des Rahmens drucken (im Slicer abschneiden) und prüfen, ob das Sichtfenster genau über dem Display liegt. Die Maße lassen sich in der OpenSCAD-Datei anpassen. Alle Dateien unter Downloads.

Fehlerbehebung

ProblemLösung
Display bleibt weißFalscher Treiber: beim 2,8″ PANEL_ST7789 auf 0 stellen, beim 4,0″ BOARD_E32R40T prüfen. Hilft das nicht, freq_write auf 27 MHz senken.
Farben wie ein NegativPANEL_INVERT umstellen
Rot und Blau vertauschtPANEL_BGR umstellen
Bild steht auf dem KopfIn der Webseite unter Setup „Anzeige 180° drehen“
Touch spiegelverkehrt2,8″: TOUCH_INVERT_X; 4,0″: TOUCH_X_MIN und TOUCH_X_MAX tauschen. Rohwerte mit TOUCH_DEBUG 1 anzeigen.
„file truncated“ beim KompilierenIDE schließen, Ordner %LOCALAPPDATA%\arduino\sketches löschen, neu kompilieren. Ggf. Arduino-Ordner vom Virenscanner ausnehmen.
Verbindung bricht sofort abiPhone: Einstellungen → Bluetooth → Tuerschild → „Dieses Gerät ignorieren“, dann neu koppeln. Nötig nach jedem Neu-Flashen mit gelöschtem Speicher.
Upload bricht abAktuelle index.html verwenden, Browser bzw. Bluefy ganz schließen und neu öffnen. Der Serielle Monitor zeigt den Grund ([UP]/[BLE]-Zeilen).
„Keine SD-Karte“Karte mit FAT32 formatieren, fest einstecken, Board neu starten

Technik & Sicherheit

Funk: Das WLAN wird nie gestartet (WiFi.mode(WIFI_OFF)), klassisches Bluetooth ist aus. Es läuft nur Bluetooth LE über NimBLE. Alle Funktionen verlangen eine verschlüsselte, per PIN gekoppelte Verbindung.

Übertragung: Bilder gehen in Paketen zu 180 Bytes mit Bestätigung und Flusskontrolle zum Schild. Eine CRC32-Prüfsumme sichert die Datei. Erst nach erfolgreicher Prüfung ersetzt sie die alte Datei. Ein Statusbild ist in wenigen Sekunden übertragen.

Speicher: Bilder liegen auf der microSD-Karte, Einstellungen und der zuletzt gezeigte Status im Flash. Nach einem Stromausfall erscheint der letzte Status wieder.