Bluetooth

Ikon HAL Bluetooth Android

Android menyediakan stack Bluetooth default yang mendukung Bluetooth Klasik dan Bluetooth Hemat Energi. Dengan Bluetooth, perangkat Android dapat membuat jaringan area pribadi untuk mengirim dan menerima data dengan perangkat Bluetooth di sekitar.

Di Android 4.3 dan yang lebih baru, stack Bluetooth Android menyediakan kemampuan untuk mengimplementasikan Bluetooth Hemat Energi (BLE). Untuk memanfaatkan BLE API sepenuhnya, ikuti Persyaratan HCI Bluetooth Android. Perangkat Android dengan chipset yang memenuhi syarat dapat menerapkan Bluetooth Klasik atau Bluetooth Klasik dan BLE. BLE tidak kompatibel dengan chipset Bluetooth versi lama.

Di Android 8.0, stack Bluetooth native sepenuhnya memenuhi syarat untuk Bluetooth 5. Untuk menggunakan fitur Bluetooth 5 yang tersedia, perangkat harus memiliki chipset yang memenuhi syarat Bluetooth 5.

Arsitektur Android

Aplikasi Bluetooth berkomunikasi dengan proses Bluetooth melalui Binder. Proses Bluetooth menggunakan JNI untuk berkomunikasi dengan stack Bluetooth dan memberi developer akses ke berbagai profil Bluetooth. Diagram ini menunjukkan struktur umum stack Bluetooth:

Arsitektur Bluetooth Android
Gambar 1. Arsitektur Bluetooth Android
Framework aplikasi
Pada level framework aplikasi adalah kode aplikasi, yang menggunakan android.bluetooth API untuk berinteraksi dengan hardware Bluetooth. Secara internal, kode ini memanggil proses Bluetooth melalui mekanisme IPC Binder.
Aplikasi Bluetooth
Aplikasi Bluetooth, yang terletak di packages/modules/Bluetooth/android/app, dikemas sebagai aplikasi Android dan mengimplementasikan profil Bluetooth di lapisan framework Android. Aplikasi ini memanggil stack Bluetooth native melalui JNI.
JNI
Kode JNI yang terkait dengan android.bluetooth terletak di packages/modules/Bluetooth/android/app/jni. Kode JNI memanggil stack Bluetooth saat operasi Bluetooth tertentu terjadi, seperti saat perangkat ditemukan.
Stack Bluetooth
Stack Bluetooth default disediakan di AOSP dan terletak di packages/modules/Bluetooth/system. Stack ini mengimplementasikan HAL Bluetooth generik dan menyesuaikannya dengan ekstensi dan perubahan konfigurasi.
Implementasi vendor
Perangkat vendor berinteraksi dengan stack Bluetooth menggunakan Hardware Interface Design Language (HIDL).

HIDL

HIDL menentukan antarmuka antara stack Bluetooth dan implementasi vendor. Untuk membuat file HIDL Bluetooth, teruskan file antarmuka Bluetooth ke alat pembuatan HIDL. File antarmuka terletak di hardware/interfaces/bluetooth.

Pengembangan stack Bluetooth

Stack Bluetooth Android adalah stack Bluetooth yang sepenuhnya memenuhi syarat. Listingan kualifikasi ada di situs Bluetooth SIG di bagian QDID 169365.

Stack Bluetooth inti berada di packages/modules/Bluetooth. Pengembangan dilakukan di AOSP, dan kontribusi sangatlah diharapkan.

Arsitektur Android 7.x dan yang lebih lama

Layanan sistem Bluetooth berkomunikasi dengan stack Bluetooth melalui JNI dan dengan aplikasi melalui Binder IPC. Layanan sistem memberi developer akses ke berbagai profil Bluetooth. Diagram ini menunjukkan struktur umum stack Bluetooth:

Arsitektur Bluetooth Android
Gambar 2. Arsitektur Bluetooth Android 7.x dan yang lebih lama
Framework aplikasi
Pada level framework aplikasi adalah kode aplikasi, yang menggunakan android.bluetooth API untuk berinteraksi dengan hardware Bluetooth. Secara internal, kode ini memanggil proses Bluetooth melalui mekanisme IPC Binder.
Layanan sistem Bluetooth
Layanan sistem Bluetooth, yang terletak di packages/apps/Bluetooth, dikemas sebagai aplikasi Android dan mengimplementasikan layanan dan profil Bluetooth di lapisan framework Android. Aplikasi ini memanggil lapisan HAL melalui JNI.
JNI
Kode JNI yang terkait dengan android.bluetooth terletak di packages/apps/Bluetooth/jni. Kode JNI memanggil lapisan HAL dan menerima callback dari HAL saat operasi Bluetooth tertentu terjadi, seperti saat perangkat ditemukan.
HAL
Lapisan abstraksi hardware menentukan antarmuka standar yang API android.bluetooth dan proses Bluetooth panggil dan yang harus Anda terapkan agar hardware Bluetooth berfungsi dengan benar. File header untuk HAL Bluetooth adalah hardware/libhardware/include/hardware/bluetooth.h. Selain itu, tinjau semua file hardware/libhardware/include/hardware/bt_*.h.
Stack Bluetooth
Stack Bluetooth default disediakan untuk Anda dan terletak di system/bt. Stack ini menerapkan HAL Bluetooth generik dan menyesuaikannya dengan ekstensi dan perubahan konfigurasi.
Ekstensi vendor
Untuk menambahkan ekstensi kustom dan lapisan HCI untuk pelacakan, Anda dapat membuat modul libbt-vendor dan menentukan komponen ini.

Mengimplementasikan HAL

HAL Bluetooth terletak di /hardware/libhardware/include/hardware/bluetooth.h. File bluetooth.h berisi antarmuka dasar untuk stack Bluetooth, dan Anda harus menerapkan fungsinya.

File khusus profil berada di direktori yang sama. Untuk mengetahui detailnya, lihat Referensi File HAL.