Bluetooth

Ikon HAL Bluetooth Android

Android menyediakan stack Bluetooth default yang mendukung Bluetooth Klasik dan Bluetooth Hemat Energi. Dengan menggunakan 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 memberikan kemampuan untuk menerapkan Bluetooth Hemat Energi (BLE). Untuk menggunakan 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 mundur dengan chipset Bluetooth lama.

Di Android 8.0, stack Bluetooth 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:

Diagram yang menunjukkan lapisan tumpukan Bluetooth Android.

Gambar 1. Arsitektur Bluetooth Android.

framework aplikasi
Di tingkat 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 berada di packages/modules/Bluetooth/android/app, dikemas sebagai aplikasi Android dan menerapkan profil Bluetooth di lapisan framework Android. Aplikasi ini memanggil stack Bluetooth 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 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. Daftar kualifikasi ada di situs Bluetooth SIG di bagian QDID 169365.

Stack Bluetooth inti berada di packages/modules/Bluetooth. Pengembangan dilakukan di AOSP, dan kontribusi sangat 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:

Diagram lapisan arsitektur Bluetooth Android 7.x dan yang lebih rendah.

Gambar 2. Arsitektur Bluetooth Android 7.x dan yang lebih lama.

framework aplikasi
Di tingkat 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 berada 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 berada 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
Hardware abstraction layer menentukan antarmuka standar yang dipanggil oleh android.bluetooth API dan proses Bluetooth, dan yang harus Anda terapkan agar hardware Bluetooth Anda 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 mengimplementasikan 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.

Menerapkan 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.