Bluetooth

Android Bluetooth HAL-Symbol

Android bietet einen standardmäßigen Bluetooth-Stack, der sowohl Classic Bluetooth als auch Bluetooth Low Energy unterstützt. Mithilfe von Bluetooth können Android-Geräte Personal Area Networks erstellen, um Daten mit Bluetooth-Geräten in der Nähe zu senden und zu empfangen.

In Android 4.3 und höher bietet der Android Bluetooth-Stack die Möglichkeit, Bluetooth Low Energy (BLE) zu implementieren. Um die BLE-APIs vollständig zu nutzen, befolgen Sie die Android Bluetooth HCI-Anforderungen . Android-Geräte mit einem qualifizierten Chipsatz können entweder Classic Bluetooth oder sowohl Classic Bluetooth als auch BLE implementieren. BLE ist nicht abwärtskompatibel mit älteren Bluetooth-Chipsätzen.

In Android 8.0 ist der native Bluetooth-Stack vollständig für Bluetooth 5 qualifiziert. Um die verfügbaren Bluetooth 5-Funktionen nutzen zu können, muss das Gerät über einen Bluetooth 5-qualifizierten Chipsatz verfügen.

Android-Architektur

Eine Bluetooth-Anwendung kommuniziert mit dem Bluetooth-Prozess über Binder. Der Bluetooth-Prozess verwendet JNI zur Kommunikation mit dem Bluetooth-Stack und bietet Entwicklern Zugriff auf verschiedene Bluetooth-Profile. Dieses Diagramm zeigt die allgemeine Struktur des Bluetooth-Stacks:

Android Bluetooth-Architektur
Abbildung 1. Android-Bluetooth-Architektur
Anwendungsrahmen
Auf der Ebene des Anwendungsframeworks befindet sich der Anwendungscode, der die android.bluetooth- APIs verwendet, um mit der Bluetooth-Hardware zu interagieren. Intern ruft dieser Code den Bluetooth-Prozess über den Binder IPC-Mechanismus auf.
Bluetooth-Systemdienst
Der Bluetooth-Systemdienst, der sich in packages/apps/Bluetooth , ist als Android-App verpackt und implementiert die Bluetooth-Dienste und -Profile auf der Android-Framework-Schicht. Diese App ruft den nativen Bluetooth-Stack über JNI auf.
JNI
Der mit android.bluetooth verbundene JNI-Code befindet sich in package packages/apps/Bluetooth/jni . Der JNI-Code ruft den Bluetooth-Stack auf, wenn bestimmte Bluetooth-Vorgänge auftreten, beispielsweise wenn Geräte erkannt werden.
Bluetooth-Stack
Der Standard-Bluetooth-Stack wird in AOSP bereitgestellt und befindet sich in system/bt . Der Stack implementiert die generische Bluetooth HAL und passt sie mit Erweiterungen und Konfigurationsänderungen an.
Anbieterimplementierung
Geräte des Herstellers interagieren mit dem Bluetooth-Stack unter Verwendung der Hardware Interface Design Language (HIDL).

HIDL

HIDL definiert die Schnittstelle zwischen dem Bluetooth-Stack und der Herstellerimplementierung. Um die Bluetooth-HIDL-Dateien zu generieren, übergeben Sie die Bluetooth-Schnittstellendateien an das HIDL-Generierungstool. Die Schnittstellendateien befinden sich in hardware/interfaces/bluetooth .

Bluetooth-Stack-Entwicklung

Der Android-Bluetooth-Stack ist ein vollständig qualifizierter Bluetooth-Stack. Die Qualifikationsliste befindet sich auf der Bluetooth SIG-Website unter QDID 169365 .

Der Kern-Bluetooth-Stack befindet sich in system/bt . Entwicklung findet in AOSP statt und Beiträge sind willkommen.

Android 7.x und frühere Architektur

Ein Bluetooth-Systemdienst kommuniziert mit dem Bluetooth-Stack über JNI und mit Anwendungen über Binder IPC. Der Systemdienst bietet Entwicklern Zugriff auf verschiedene Bluetooth-Profile. Dieses Diagramm zeigt die allgemeine Struktur des Bluetooth-Stacks:

Android Bluetooth-Architektur
Abbildung 2. Bluetooth-Architektur von Android 7.x und früher
Anwendungsrahmen
Auf der Ebene des Anwendungsframeworks befindet sich der Anwendungscode, der die android.bluetooth- APIs verwendet, um mit der Bluetooth-Hardware zu interagieren. Intern ruft dieser Code den Bluetooth-Prozess über den Binder IPC-Mechanismus auf.
Bluetooth-Systemdienst
Der Bluetooth-Systemdienst, der sich in packages/apps/Bluetooth , ist als Android-App verpackt und implementiert den Bluetooth-Dienst und die Bluetooth-Profile auf der Android-Framework-Schicht. Diese App ruft die HAL-Schicht über JNI auf.
JNI
Der mit android.bluetooth verbundene JNI-Code befindet sich in package packages/apps/Bluetooth/jni . Der JNI-Code ruft die HAL-Schicht auf und empfängt Rückrufe von der HAL, wenn bestimmte Bluetooth-Vorgänge auftreten, beispielsweise wenn Geräte erkannt werden.
HAL
Die Hardwareabstraktionsschicht definiert die Standardschnittstelle, die dieandroid.bluetooth- APIs und der Bluetooth-Prozess aufrufen und die Sie implementieren müssen, damit Ihre Bluetooth-Hardware ordnungsgemäß funktioniert. Die Header-Datei für die Bluetooth HAL ist hardware/libhardware/include/hardware/bluetooth.h . Überprüfen Sie außerdem alle hardware/libhardware/include/hardware/bt_*.h Dateien.
Bluetooth-Stack
Der Standard-Bluetooth-Stack wird für Sie bereitgestellt und befindet sich in system/bt . Der Stack implementiert die generische Bluetooth HAL und passt sie mit Erweiterungen und Konfigurationsänderungen an.
Anbietererweiterungen
Um benutzerdefinierte Erweiterungen und eine HCI-Schicht für das Tracing hinzuzufügen, können Sie ein libbt-vendor-Modul erstellen und diese Komponenten angeben.

Implementierung der HAL

Die Bluetooth-HAL befindet sich in /hardware/libhardware/include/hardware/bluetooth.h . Die Datei bluetooth.h enthält die Basisschnittstelle für den Bluetooth-Stack, dessen Funktionen Sie implementieren müssen.

Profilspezifische Dateien befinden sich im selben Verzeichnis. Weitere Informationen finden Sie in der HAL-Dateireferenz .