À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

Cette page a été traduite par l'API Cloud Translation.

Bluetooth

Android fournit une pile Bluetooth par défaut qui prend en charge le Bluetooth classique et le Bluetooth à basse consommation. À l'aide du Bluetooth, les appareils Android peuvent créer des réseaux personnels pour envoyer et recevoir des données avec les appareils Bluetooth à proximité.

Dans Android 4.3 et versions ultérieures, la pile Bluetooth Android permet d'implémenter le Bluetooth à basse consommation (BLE). Pour utiliser pleinement les API BLE, suivez les exigences HCI Bluetooth d'Android. Les appareils Android dotés d'un chipset qualifié peuvent implémenter le Bluetooth Classic ou les deux (Bluetooth Classic et BLE). Le BLE n'est pas rétrocompatible avec les anciens chipsets Bluetooth.

Dans Android 8.0, la pile Bluetooth est entièrement qualifiée pour le Bluetooth 5. Pour utiliser les fonctionnalités Bluetooth 5 disponibles, l'appareil doit être équipé d'un chipset Bluetooth 5 certifié.

Architecture Android

Une application Bluetooth communique avec le processus Bluetooth via Binder. Le processus Bluetooth utilise JNI pour communiquer avec la pile Bluetooth et permet aux développeurs d'accéder à différents profils Bluetooth. Ce schéma montre la structure générale de la pile Bluetooth :

Diagramme illustrant les couches de la pile Bluetooth Android.

Figure 1 : Architecture Bluetooth Android.

framework d'application: Au niveau du framework d'application se trouve le code de l'application, qui utilise les API android.bluetooth pour interagir avec le matériel Bluetooth. En interne, ce code appelle le processus Bluetooth via le mécanisme Binder IPC.
Application Bluetooth: L'application Bluetooth, située dans packages/modules/Bluetooth/android/app, est fournie sous forme d'application Android et implémente les profils Bluetooth au niveau du framework Android. Cette application appelle la pile Bluetooth via JNI.
JNI: Le code JNI associé à android.bluetooth se trouve dans packages/modules/Bluetooth/android/app/jni. Le code JNI appelle la pile Bluetooth lorsque certaines opérations Bluetooth se produisent, par exemple lorsque des appareils sont détectés.
Pile Bluetooth: La pile Bluetooth par défaut est fournie dans AOSP et se trouve dans packages/modules/Bluetooth/system. La pile implémente la HAL Bluetooth générique et la personnalise avec des extensions et des modifications de configuration.
implémentation par le fournisseur: Les appareils du fournisseur interagissent avec la pile Bluetooth à l'aide du langage HIDL (Hardware Interface Design Language).

HIDL

HIDL définit l'interface entre la pile Bluetooth et l'implémentation du fournisseur. Pour générer les fichiers HIDL Bluetooth, transmettez les fichiers d'interface Bluetooth à l'outil de génération HIDL. Les fichiers d'interface se trouvent dans hardware/interfaces/bluetooth.

Développement de la pile Bluetooth

La pile Bluetooth Android est une pile Bluetooth entièrement qualifiée. La liste de qualification est disponible sur le site Web de Bluetooth SIG sous QDID 169365.

La pile Bluetooth principale se trouve dans packages/modules/Bluetooth. Le développement a lieu dans AOSP, et les contributions sont les bienvenues.

Architecture Android 7.x et versions antérieures

Un service système Bluetooth communique avec la pile Bluetooth via JNI et avec les applications via Binder IPC. Le service système permet aux développeurs d'accéder à différents profils Bluetooth. Ce schéma montre la structure générale de la pile Bluetooth :

Schéma des couches de l'architecture Bluetooth d'Android 7.x et versions antérieures.

Figure 2. Architecture Bluetooth d'Android 7.x et versions antérieures.

framework d'application: Au niveau du framework d'application se trouve le code de l'application, qui utilise les API android.bluetooth pour interagir avec le matériel Bluetooth. En interne, ce code appelle le processus Bluetooth via le mécanisme Binder IPC.
Service système Bluetooth: Le service système Bluetooth, situé dans packages/apps/Bluetooth, est fourni sous forme d'application Android et implémente le service et les profils Bluetooth au niveau du framework Android. Cette application appelle la couche HAL via JNI.
JNI: Le code JNI associé à android.bluetooth se trouve dans packages/apps/Bluetooth/jni. Le code JNI appelle la couche HAL et reçoit des rappels de la couche HAL lorsque certaines opérations Bluetooth se produisent, par exemple lorsque des appareils sont détectés.
HAL: La couche d'abstraction matérielle définit l'interface standard que les API android.bluetooth et le processus Bluetooth appellent et que vous devez implémenter pour que votre matériel Bluetooth fonctionne correctement. Le fichier d'en-tête pour la HAL Bluetooth est hardware/libhardware/include/hardware/bluetooth.h. Examinez également tous les fichiers hardware/libhardware/include/hardware/bt_*.h.
Pile Bluetooth: La pile Bluetooth par défaut vous est fournie et se trouve dans system/bt. La pile implémente la HAL Bluetooth générique et la personnalise avec des extensions et des modifications de configuration.
extensions de fournisseur: Pour ajouter des extensions personnalisées et une couche HCI pour le traçage, vous pouvez créer un module libbt-vendor et spécifier ces composants.

Implémenter la HAL

Le HAL Bluetooth se trouve dans /hardware/libhardware/include/hardware/bluetooth.h. Le fichier bluetooth.h contient l'interface de base pour la pile Bluetooth. Vous devez implémenter ses fonctions.

Les fichiers spécifiques au profil se trouvent dans le même répertoire. Pour en savoir plus, consultez la documentation de référence sur les fichiers HAL.