ESP32 Bluetooth Tabellen-Beispiel - Strukturierte Datenanzeige-Interface Tutorial
Überblick
Das Bluetooth Tabellen-Beispiel bietet eine strukturierte Schlüssel-Wert-Datenanzeige, die über die DIYables Bluetooth STEM App zugänglich ist. Entwickelt für ESP32 Boards mit Unterstützung für sowohl BLE (Bluetooth Low Energy) als auch Classic Bluetooth Verbindungen. Definieren Sie benannte Zeilen und aktualisieren Sie deren Werte in Echtzeit — perfekt für Dashboards, Sensorstatus-Panels, Systemmonitore und jede Anwendung, die eine organisierte Datendarstellung erfordert.
Dieses Beispiel unterstützt zwei Bluetooth-Modi:
- ESP32 BLE (Bluetooth Low Energy): Funktioniert sowohl auf Android als auch iOS
- ESP32 Classic Bluetooth: Funktioniert nur auf Android. iOS unterstützt kein Classic Bluetooth. Verwenden Sie BLE, wenn Sie iOS-Unterstützung benötigen.

Features
- Strukturierte Zeilen: Bis zu 20 benannte Attributzeilen
- Echtzeit-Updates: Aktualisieren Sie einzelne Zeilenwerte ohne Aktualisierung der gesamten Tabelle
- Benannte Attribute: Jede Zeile hat eine beschreibende Bezeichnung (z.B. "Temperatur", "Status")
- Dynamische Werte: Senden Sie jeden String-Wert für jede Zeile
- Tabellenstruktur-Sync: App fordert Tabellenkonfiguration bei Verbindung an
- BLE & Classic Bluetooth: Wählen Sie den Bluetooth-Modus, der zu Ihrem Projekt passt
- Plattformübergreifend: BLE-Modus funktioniert sowohl auf Android als auch iOS; Classic Bluetooth funktioniert auf Android
- Stromsparende Option: BLE-Modus verbraucht weniger Strom als Classic Bluetooth
Benötigte Hardware
Oder Sie können die folgenden Kits kaufen:
| 1 | × | DIYables ESP32 Starter-Kit (ESP32 enthalten) | |
| 1 | × | DIYables Sensor-Kit (30 Sensoren/Displays) | |
| 1 | × | DIYables Sensor-Kit (18 Sensoren/Displays) |
ESP32 Code
Schnelle Schritte
Befolgen Sie diese Anweisungen Schritt für Schritt:
- Neu bei ESP32? Beginnen Sie mit unserem Tutorial zur Einrichtung der Umgebung für ESP32 in der Arduino IDE, um zuerst die Grundlagen zu lernen.
- Verbinden Sie das ESP32 Board mit Ihrem Computer über ein USB-Kabel.
- Starten Sie die Arduino IDE auf Ihrem Computer.
- Wählen Sie das entsprechende ESP32 Board und COM-Port aus.
- Navigieren Sie zum Libraries Icon in der linken Leiste der Arduino IDE.
- Suchen Sie "DIYables Bluetooth", dann finden Sie die DIYables Bluetooth Library von DIYables
- Klicken Sie auf den Install Button, um die Library zu installieren.

- Sie werden aufgefordert, einige andere Library-Abhängigkeiten zu installieren
- Klicken Sie auf Install All Button, um alle Library-Abhängigkeiten zu installieren.

Wählen Sie je nach Ihren Anforderungen einen der beiden Bluetooth-Modi unten:
ESP32 Classic Bluetooth Code (funktioniert nur mit der App auf Android)
Hinweis: Classic Bluetooth wird auf iOS NICHT unterstützt. Wenn Sie iOS-Unterstützung benötigen, verwenden Sie den BLE Code unten.
- Gehen Sie in der Arduino IDE zu File Examples DIYables Bluetooth Esp32Bluetooth_Table Beispiel, oder kopieren Sie den obigen Code und fügen Sie ihn in den Editor der Arduino IDE ein
- Klicken Sie auf den Upload Button in der Arduino IDE, um den Code auf den ESP32 zu laden
- Öffnen Sie den Serial Monitor
- Überprüfen Sie das Ergebnis im Serial Monitor. Es sieht folgendermaßen aus:
ESP32 BLE Code (funktioniert mit der App sowohl auf Android als auch iOS)
- Gehen Sie in der Arduino IDE zu File Examples DIYables Bluetooth Esp32BLE_Table Beispiel, oder kopieren Sie den obigen Code und fügen Sie ihn in den Editor der Arduino IDE ein
- Klicken Sie auf den Upload Button in der Arduino IDE, um den Code auf den ESP32 zu laden
- Öffnen Sie den Serial Monitor
- Überprüfen Sie das Ergebnis im Serial Monitor. Es sieht folgendermaßen aus:
Mobile App
- Wenn Sie den ESP32 Classic Bluetooth Code verwenden, müssen Sie den ESP32 mit Ihrem Android-Telefon koppeln, bevor Sie die App öffnen:
- Gehen Sie zu den Einstellungen > Bluetooth Ihres Telefons
- Stellen Sie sicher, dass Bluetooth eingeschaltet ist
- Ihr Telefon scannt nach verfügbaren Geräten
- Finden und tippen Sie auf "ESP32_Table" in der Liste der verfügbaren Geräte
- Bestätigen Sie die Kopplungsanfrage (keine PIN erforderlich)
- Warten Sie, bis "Gekoppelt" unter dem Gerätenamen angezeigt wird
- Wenn Sie den ESP32 BLE Code verwenden, ist keine Kopplung erforderlich. Fahren Sie einfach mit dem nächsten Schritt fort.
- Öffnen Sie die DIYables Bluetooth App
- Beim ersten Öffnen der App werden Berechtigungen angefordert. Bitte gewähren Sie folgende:
- Nearby Devices Berechtigung (Android 12+) / Bluetooth Berechtigung (iOS) - erforderlich zum Scannen und Verbinden mit Bluetooth-Geräten
- Location Berechtigung (nur Android 11 und niedriger) - von älteren Android-Versionen zum Scannen nach BLE-Geräten erforderlich
- Stellen Sie sicher, dass Bluetooth auf Ihrem Telefon eingeschaltet ist
- Tippen Sie auf dem Startbildschirm auf den Connect Button. Die App scannt nach BLE- und Classic Bluetooth-Geräten.

- Finden und tippen Sie auf Ihr Gerät in den Scanergebnissen, um sich zu verbinden:
- Für Classic Bluetooth: tippen Sie auf "ESP32_Table"
- Für BLE: tippen Sie auf "ESP32BLE_Table"
- Nach der Verbindung kehrt die App automatisch zum Startbildschirm zurück. Wählen Sie die Table App aus dem App-Menü.

Hinweis: Sie können auf das Einstellungssymbol auf dem Startbildschirm tippen, um Apps auf dem Startbildschirm ein-/auszublenden. Weitere Details finden Sie im DIYables Bluetooth App Benutzerhandbuch.
- Die Tabelle wird mit den Attributnamen und ihren aktuellen Werten gefüllt

Schauen Sie nun zurück zum Serial Monitor in der Arduino IDE. Sie werden sehen:
- Beobachten Sie, wie sich die Tabellenwerte in Echtzeit in der App aktualisieren
Kreative Anpassung - Code an Ihr Projekt anpassen
Tabellenzeilen definieren
Fügen Sie Attributzeilen zur Tabelle hinzu (maximal 20 Zeilen):
Zeilenwerte aktualisieren
Aktualisieren Sie einzelne Zeilenwerte nach Attributnamen oder Index:
Datenanfragen von der App verarbeiten
Wenn die App sich verbindet oder eine Aktualisierung anfordert:
Tabelle löschen und neu aufbauen
Verbindungsereignisse verarbeiten
Verwendung der Tabelle
App-Interface
Das Tabelleninterface in der DIYables Bluetooth App zeigt:
- Attribut-Spalte: Zeilenbeschriftungen definiert durch addRow()
- Wert-Spalte: Aktuelle Werte aktualisiert durch sendValueUpdate()
- Auto-Refresh: Werte aktualisieren sich in Echtzeit, sobald sie ankommen
Tabellen-Limits
- Maximum 20 Zeilen pro Tabelle (MAX_TABLE_ROWS = 20)
- Attributnamen sollten prägnant aber beschreibend sein
- Werte werden als Strings angezeigt
Programmierbeispiele
Sensor Dashboard
Systemstatus Monitor
GPIO-Pin Status Tabelle
Analog Sensor Array
Erweiterte Programmiertechniken
Bedingte Formatierung mit Emojis
Event-gesteuerte Updates
Hardware-Integrationsideen
BME280 Wetterstation Tabelle
Verbinden Sie einen BME280 Sensor zur Anzeige von Temperatur, Feuchtigkeit und Luftdruck in der Tabelle.
Multi-Sensor Dashboard
Verbinden Sie mehrere Sensoren (DHT22, BMP280, LDR, MQ-135) und zeigen Sie alle Messwerte als Zeilen an.
Geräteinformations-Panel
Zeigen Sie ESP32 Systeminformationen an: Chip-Modell, Flash-Größe, freier Heap, Betriebszeit und MAC-Adresse.
BLE vs Classic Bluetooth - Was wählen?
| Feature | BLE (Esp32BLE_Table) | Classic Bluetooth (Esp32Bluetooth_Table) |
|---|---|---|
| iOS Unterstützung | ? Ja | ? Nein |
| Android Unterstützung | ? Ja | ? Ja |
| Stromverbrauch | Niedrig | Höher |
| Reichweite | ~30-100m | ~10-100m |
| Datenrate | Niedriger | Höher |
| Kopplung erforderlich | Nein (Auto-Verbindung) | Ja (Manuelle Kopplung) |
| Am besten für | Batteriebetrieb, plattformübergreifend | Hoher Durchsatz, nur Android |
Problembehandlung
Häufige Probleme
1. Kann das Gerät in der App nicht finden
- Stellen Sie sicher, dass der ESP32 eingeschaltet ist und der Sketch hochgeladen wurde
- Für BLE: Stellen Sie sicher, dass Bluetooth und Standort Ihres Telefons aktiviert sind
- Für Classic Bluetooth: Koppeln Sie das Gerät zuerst in den Bluetooth-Einstellungen des Telefons
- Überprüfen Sie, dass das korrekte Partition Scheme ausgewählt ist (Huge APP)
2. Tabelle zeigt keine Daten
- Stellen Sie sicher, dass sendTableStructure() im onDataRequest Callback aufgerufen wird
- Überprüfen Sie, dass Zeilen mit addRow() hinzugefügt werden, bevor Updates gesendet werden
- Überprüfen Sie den Serial Monitor auf die Nachricht "App requested table data"
3. Werte werden nicht aktualisiert
- Überprüfen Sie, dass der Attributname in sendValueUpdate() genau dem entspricht, was mit addRow() hinzugefügt wurde
- Überprüfen Sie, dass Ihr Update-Intervall Timer funktioniert
- Stellen Sie sicher, dass Bluetooth noch verbunden ist
4. Fehlende Zeilen in der Tabelle
- Maximum 20 Zeilen werden unterstützt
- Überprüfen Sie getRowCount(), um zu verifizieren, dass alle Zeilen hinzugefügt wurden
- Zeilen müssen vor dem Senden der Tabellenstruktur hinzugefügt werden
5. Verbindung bricht häufig ab
- Gehen Sie näher zum ESP32 (Entfernung reduzieren)
- Für BLE: Überprüfen Sie auf Interferenzen von anderen BLE-Geräten
- Für Classic Bluetooth: Stellen Sie eine stabile Stromversorgung zum ESP32 sicher
6. Sketch zu groß / nicht genug Speicherplatz
- Gehen Sie in der Arduino IDE zu Tools > Partition Scheme und wählen Sie "Huge APP (3MB No OTA/1MB SPIFFS)" oder "No OTA (Large APP)"
- Das Standard-Partition Scheme bietet nur ~1.2MB für App-Code, was nicht genug für Bluetooth Libraries ist
- Diese Einstellung gibt ~3MB durch Verzicht auf die OTA (Over-the-Air Update) Partition
Debug-Tipps
Fügen Sie umfassendes Debugging hinzu:
Projektideen
Überwachungs-Dashboards
- Wetterstation-Anzeige (Temperatur, Feuchtigkeit, Luftdruck, Wind)
- Server-/Netzwerkstatus-Monitor
- Pflanzenpflege-Dashboard (Bodenfeuchtigkeit, Licht, Temperatur)
- Aquarium-Monitor (Temperatur, pH, TDS)
Systeminformationen
- ESP32 Systemdiagnose-Tabelle
- WiFi-Verbindungsdetails
- Speichernutzungs-Tracker
- Batteriestatus-Anzeige
Datenprotokollierung
- Sensor Min/Max/Durchschnitts-Tracker
- Ereigniszähler-Anzeige
- Timing-Statistiken (Antwortzeit, Betriebszeit)
- I/O-Pin Zustandszusammenfassung
Hausautomatisierung
- Raum-für-Raum Temperaturanzeige
- Gerätestatus-Übersicht
- Energieverbrauchs-Zusammenfassung
- Sicherheitssensor-Status
Integration mit anderen Bluetooth Apps
Kombination mit Bluetooth Plotter
Zeigen Sie Werte in der Tabelle an und visualisieren Sie Trends im Plotter:
Kombination mit Bluetooth Monitor
Verwenden Sie die Tabelle für strukturierte Daten und den Monitor für Log-Nachrichten:
Nächste Schritte
Nach der Beherrschung des Bluetooth Tabellen-Beispiels versuchen Sie:
- Bluetooth Monitor - Für freiformige Textprotokollierung
- Bluetooth Plotter - Für die Visualisierung von Datentrends
- Bluetooth Temperature - Für dedizierte Temperaturanzeige
- Multiple Bluetooth Apps - Kombination von Tabelle mit anderen Anzeigen
Support
Für zusätzliche Hilfe:
- Überprüfen Sie die API Reference Dokumentation
- Besuchen Sie DIYables Tutorials
- Arduino Community Foren