A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

Bluetooth

O Android oferece uma pilha Bluetooth padrão compatível com o Bluetooth clássico e o Bluetooth de baixa energia. Usando o Bluetooth, os dispositivos Android podem criar redes de área pessoal para enviar e receber dados com dispositivos Bluetooth próximos.

No Android 4.3 e versões mais recentes, a pilha Bluetooth do Android oferece a capacidade de implementar Bluetooth de baixa energia (BLE). Para usar totalmente as APIs BLE, siga os Requisitos de HCI do Bluetooth do Android. Dispositivos Android com um chipset qualificado podem implementar o Bluetooth clássico ou os dois. O BLE não é compatível com versões anteriores de chipsets Bluetooth.

No Android 8.0, a pilha Bluetooth é totalmente qualificada para Bluetooth 5. Para usar os recursos disponíveis do Bluetooth 5, o dispositivo precisa ter um chipset qualificado para Bluetooth 5.

Arquitetura do Android

Um app Bluetooth se comunica com o processo Bluetooth usando o Binder. O processo do Bluetooth usa JNI para se comunicar com a pilha do Bluetooth e oferece aos desenvolvedores acesso a vários perfis do Bluetooth. Este diagrama mostra a estrutura geral da pilha Bluetooth:

Diagrama mostrando as camadas da pilha Bluetooth do Android.

Figura 1. Arquitetura do Bluetooth do Android.

framework de app: No nível do framework do app, há o código do app, que usa as APIs android.bluetooth para interagir com o hardware Bluetooth. Internamente, esse código chama o processo Bluetooth pelo mecanismo Binder IPC.
App Bluetooth: O app Bluetooth, localizado em packages/modules/Bluetooth/android/app, é empacotado como um app Android e implementa os perfis Bluetooth na camada do framework Android. Esse app chama a pilha Bluetooth usando a JNI.
JNI: O código JNI associado a android.bluetooth está localizado em packages/modules/Bluetooth/android/app/jni. O código JNI chama a pilha Bluetooth quando determinadas operações Bluetooth ocorrem, como quando os dispositivos são descobertos.
Pilha Bluetooth: A pilha Bluetooth padrão é fornecida no AOSP e está localizada em packages/modules/Bluetooth/system. A pilha implementa a HAL genérica do Bluetooth e a personaliza com extensões e mudanças de configuração.
implementação do fornecedor: Os dispositivos do fornecedor interagem com a pilha Bluetooth usando a linguagem de design de interface de hardware (HIDL, na sigla em inglês).

HIDL

O HIDL define a interface entre a pilha Bluetooth e a implementação do fornecedor. Para gerar os arquivos HIDL do Bluetooth, transmita os arquivos de interface do Bluetooth para a ferramenta de geração do HIDL. Os arquivos de interface estão localizados em hardware/interfaces/bluetooth.

Desenvolvimento de pilha Bluetooth

A pilha Bluetooth do Android é totalmente qualificada. A lista de qualificação está no site da Bluetooth SIG em QDID 169365.

A pilha Bluetooth principal reside em packages/modules/Bluetooth. O desenvolvimento acontece no AOSP, e as contribuições são bem-vindas.

Arquitetura do Android 7.x e versões anteriores

Um serviço do sistema Bluetooth se comunica com a pilha Bluetooth usando JNI e com apps usando Binder IPC. O serviço do sistema oferece aos desenvolvedores acesso a vários perfis Bluetooth. Este diagrama mostra a estrutura geral da pilha Bluetooth:

Diagrama das camadas de arquitetura do Bluetooth no Android 7.x e versões anteriores.

Figura 2. Arquitetura Bluetooth do Android 7.x e versões anteriores.

framework de app: No nível do framework do app, há o código do app, que usa as APIs android.bluetooth para interagir com o hardware Bluetooth. Internamente, esse código chama o processo Bluetooth pelo mecanismo Binder IPC.
Serviço do sistema Bluetooth: O serviço do sistema Bluetooth, localizado em packages/apps/Bluetooth, é empacotado como um app Android e implementa o serviço e os perfis Bluetooth na camada do framework Android. Esse app chama a camada HAL usando a JNI.
JNI: O código JNI associado a android.bluetooth está localizado em packages/apps/Bluetooth/jni. O código JNI chama a camada HAL e recebe callbacks da HAL quando determinadas operações Bluetooth ocorrem, como quando dispositivos são descobertos.
HAL: A camada de abstração de hardware define a interface padrão que as APIs android.bluetooth e o processo do Bluetooth chamam e que você precisa implementar para que o hardware Bluetooth funcione corretamente. O arquivo de cabeçalho para a HAL do Bluetooth é hardware/libhardware/include/hardware/bluetooth.h. Além disso, revise todos os arquivos hardware/libhardware/include/hardware/bt_*.h.
Pilha Bluetooth: A pilha Bluetooth padrão é fornecida para você e está localizada em system/bt. A pilha implementa o HAL genérico do Bluetooth e o personaliza com extensões e mudanças de configuração.
extensões de fornecedor: Para adicionar extensões personalizadas e uma camada de HCI para rastreamento, crie um módulo libbt-vendor e especifique esses componentes.

Implementar a HAL

O HAL do Bluetooth está localizado em /hardware/libhardware/include/hardware/bluetooth.h. O arquivo bluetooth.h contém a interface básica da pilha Bluetooth, e você precisa implementar as funções dele.

Os arquivos específicos do perfil estão localizados no mesmo diretório. Para mais detalhes, consulte a referência do arquivo HAL.