ESP32 Bluetooth-Tutorial – Klassisches Bluetooth und BLE mit der DIYables Bluetooth-App

Überblick

Dieses Tutorial zeigt, wie man eine drahtlose Kommunikation zwischen dem ESP32 und der DIYables Bluetooth App mithilfe von Classic Bluetooth oder Bluetooth Low Energy (BLE) implementiert. Der ESP32 verfügt über integrierte Bluetooth-Fähigkeiten, wodurch externe Bluetooth-Module nicht mehr erforderlich sind.

Der ESP32 bietet native Unterstützung für sowohl Classic Bluetooth als auch BLE-Protokolle, wodurch eine direkte Verbindung zur DIYables Bluetooth-App auf Android- und iOS-Geräten ohne zusätzliche Hardwareanforderungen möglich ist.

Wichtige Informationen: Der ESP32 unterstützt zwei Bluetooth-Modi — sowohl Classic Bluetooth als auch BLE (Bluetooth Low Energy). Die DIYables Bluetooth App bietet volle Unterstützung für Classic Bluetooth und BLE auf Android-Plattformen, mit BLE-Unterstützung auf iOS. Benutzer können das geeignete Protokoll basierend auf ihren Plattformanforderungen und Projektspezifikationen auswählen.

ESP32 Bluetooth-Anleitung – Klassisches Bluetooth und BLE mit der DIYables Bluetooth-App

Funktionen

Unterstützung beider Protokolle: Implementiert sowohl Classic Bluetooth als auch BLE-Protokolle für maximale Kompatibilität
Drahtlose Reichweite: Bietet kabellose Kommunikation bis zu 10 Metern
Multiplattform-Kompatibilität: Unterstützt sowohl Android- als auch iOS-Betriebssysteme
Flexible Verbindungsmethoden: Classic Bluetooth verwendet herkömmliches Pairing; BLE bietet automatische Verbindung
Umfassende Widget-Bibliothek: Enthält Schieberegler, Joystick, Monitor, Plotter, Anzeige, Temperaturanzeige, Chat, Tabelle, Rotator und zusätzliche Schnittstellenkomponenten
Optionen zur Energieeffizienz: Der BLE-Modus ist für energiesparende Anwendungen optimiert; Classic Bluetooth bietet breitere Gerätekompatibilität
Einfache Integration: Eine einzige Bibliotheksinstallation verwaltet alle Kommunikationsprotokolle

Erforderliche Hardware

1	×	ESP32 ESP-WROOM-32 Entwicklungsmodul
1	×	(Alternativ) ESP32 Uno-form board
1	×	(Alternativ) ESP32 S3 Uno-form board
1	×	USB-Kabel Typ-A zu Typ-C (für USB-A PC)
1	×	USB-Kabel Typ-C zu Typ-C (für USB-C PC)
1	×	(Empfohlen) Schraubklemmen-Erweiterungsboard für ESP32
1	×	(Empfohlen) Breakout Expansion Board for ESP32
1	×	(Empfohlen) Stromverteiler für ESP32

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)

Offenlegung: Einige der in diesem Abschnitt bereitgestellten Links sind Amazon-Affiliate-Links. Wir können eine Provision für Käufe erhalten, die über diese Links getätigt werden, ohne zusätzliche Kosten für Sie. Wir schätzen Ihre Unterstützung.

Software-Einrichtung

Schnelle Schritte

Befolgen Sie diese Schritte, um die Entwicklungsumgebung zu konfigurieren:

Für die Erstkonfiguration des ESP32 konsultieren Sie den ESP32-Einstiegsleitfaden.
Schließen Sie das ESP32-Board über ein USB-Kabel an den Computer an.
Starten Sie die Arduino-IDE.
Wählen Sie das ESP32-Board und den entsprechenden COM-Port aus.

Board Core installieren

Gehe zu Werkzeuge Board Boards-Verwaltung...
Suche nach "esp32"
Installiere esp32 von Espressif Systems

DIYables Bluetooth-Bibliothek installieren

Greifen Sie auf das Bibliotheken-Symbol in der linken Seitenleiste der Arduino IDE zu.
Suchen Sie nach der "DIYables Bluetooth"-Bibliothek von DIYables und finden Sie sie.
Klicken Sie auf Installieren, um die Bibliothek hinzuzufügen.

Wenn Sie dazu aufgefordert werden, installieren Sie die erforderlichen Bibliotheksabhängigkeiten
Klicken Sie auf Alle installieren, um die Installation abzuschließen

Mobile-Anwendung

Installieren Sie die DIYables Bluetooth-App: Android | iOS

Plattformkompatibilität: Die DIYables Bluetooth-App unterstützt sowohl Classic Bluetooth als auch BLE auf Android-Plattformen, während BLE-Unterstützung auf iOS erfolgt. Die Dual-Modus-Fähigkeit des ESP32 ermöglicht eine Protokollauswahl basierend auf den Anforderungen der Plattform. Android-Geräte unterstützen sowohl Classic Bluetooth als auch BLE-Modi. iOS-Geräte benötigen den BLE-Modus. BLE-Verbindungen werden automatisch hergestellt, ohne manuelle Kopplungsvorgänge.

Starten Sie die DIYables Bluetooth-App
Gewähren Sie bei Aufforderung die folgenden Berechtigungen:

Nahegelegene Geräte Berechtigung (Android 12+) / Bluetooth Berechtigung (iOS) - Erforderlich für das Scannen von Bluetooth-Geräten und die Verbindung
Standort Berechtigung (Nur Android 11 und darunter) - Vom Android-System für das Scannen von Bluetooth-Geräten erforderlich

Stellen Sie sicher, dass Bluetooth in den Geräteeinstellungen aktiviert ist
Tippen Sie auf die Schaltfläche Verbinden auf dem Startbildschirm, um die Gerätesuche zu starten.

DIYables Bluetooth-App – Startbildschirm mit Scan-Schaltfläche

Wählen Sie das ESP32-Gerät aus den Scan-Ergebnissen aus, um eine Verbindung herzustellen.

Beispiele

Der ESP32 unterstützt sowohl Classic Bluetooth als auch BLE-Protokolle. Wählen Sie die passende Implementierung basierend auf den Anforderungen des Projekts aus. Alle Beispiele sind mit ESP32-Hardware kompatibel.

Bluetooth Classic-Beispiele (Nur Android) und BLE-Beispiele (Android und iOS)

ESP32 - Bluetooth Slider - Control slider values
ESP32 - Bluetooth Pin Control - Control digital output pins
ESP32 - Bluetooth Monitor - Wireless serial communication
ESP32 - Bluetooth Plotter - Real-time data visualization
ESP32 - Bluetooth Analog Gauge - Analog gauge display
ESP32 - Bluetooth Temperature - Temperature and humidity monitoring
ESP32 - Bluetooth Joystick - 2D joystick input
ESP32 - Bluetooth Rotator - Rotary control input
ESP32 - Bluetooth Chat - Text message communication
ESP32 - Bluetooth Table - Tabular data display
ESP32 - Bluetooth RTC - Real-time clock synchronization
ESP32 - Bluetooth Multiple Apps - Multiple widget integration

Fehlerbehebung

Symptom	Probable Cause	Resolution
Device not visible during app scanning	Incorrect Bluetooth mode or firmware not running	Verify code uses correct Bluetooth mode (Classic or BLE) and ESP32 is executing
SerialBT.begin() or BLE.begin() fails	Board core or library incompatibility	Install ESP32 board core by Espressif Systems via Boards Manager
Connection established but no data transfer	Outdated DIYables library	Update DIYables Bluetooth library to latest version via Library Manager
Compile error	BluetoothSerial.h or BLEDevice.h not found	DIYables Bluetooth library not installed	Install DIYables Bluetooth library via Library Manager
Compile errors related to board selection	Incorrect board selected or core missing	Select ESP32 board and install esp32 core by Espressif Systems
Connection drops immediately after establishment	Interference or power supply issues	Ensure stable USB power supply and maintain device proximity within 10 metres
Classic Bluetooth fails on iOS	iOS does not support Classic Bluetooth profile	Use BLE mode for iOS device compatibility

Notizen

Für die ESP32-Implementierung verwenden Sie Esp32Bluetooth_ Beispiele für Classic Bluetooth oder Esp32BLE_ Beispiele für BLE. ArduinoBLE_ Beispiele sind für verschiedene Hardware-Plattformen konzipiert (z. B. Arduino Uno R4).
Classic Bluetooth erfordert eine manuelle Kopplung über die Bluetooth-Einstellungen des Geräts, bevor die App verbunden wird (Android nur).
BLE stellt automatische Verbindungen her, ohne manuelle Kopplungsvorgänge, und unterstützt sowohl Android- als auch iOS-Plattformen.
Stellen Sie eine kontinuierliche Stromversorgung sicher (USB oder extern), um eine fortlaufende Bluetooth-Werbung und die Entdeckbarkeit des Geräts zu gewährleisten.
Die iOS-Kompatibilität erfordert den BLE-Modus, da iOS Classic Bluetooth für Zubehörgeräte nicht unterstützt.