Verifikasi dan debug

Untuk memverifikasi dan men-debug stack Bluetooth, gunakan alat yang disediakan dalam AOSP dan pengujian Bluetooth Special interest Group (SIG).

Menguji dan memverifikasi

Untuk menguji stack Bluetooth, AOSP menyediakan berbagai pengujian unit, pengujian CTS, dan alat untuk Bluetooth Profile Tuning Suite.

Pengujian unit di AOSP

AOSP menyertakan pengujian fungsional dan unit untuk stack Bluetooth default. Pengujian ini berada di /packages/modules/Bluetooth/system/test/. Untuk menjalankan pengujian AOSP, lakukan hal berikut:

  1. Hentikan runtime Android: 
    adb shell stop
  2. Dari direktori pengujian, jalankan file shell yang dapat dieksekusi dan sertakan opsi jika Anda ingin menjalankan pengujian atau rangkaian pengujian tertentu: 
    ./run_unit_tests.sh TEST_GROUP_NAME TEST_NAME OPTIONS
  3. Setelah pengujian selesai, aktifkan kembali runtime Android: 
    adb shell start

Daftar nama pengujian dapat ditemukan di /packages/modules/Bluetooth/system/test/README.md.

Suite Tuning Profil

Bluetooth SIG menyediakan Bluetooth Profile Tuning Suite (PTS), sebuah alat pengujian untuk interoperabilitas protokol dan profil. Untuk informasi selengkapnya, lihat situs Bluetooth Profile Tuning Suite.

Uji CTS

Compatibility Test Suite (CTS) mencakup pengujian untuk stack Bluetooth. Semuanya tersedia di cts/apps/CtsVerifier/src/com/android/cts/verifier/bluetooth.

Opsi proses debug

AOSP menyediakan berbagai metode untuk men-debug stack Bluetooth perangkat, termasuk log dan laporan bug. Metode ini mungkin tidak berfungsi untuk masalah yang tidak dapat direproduksi atau untuk masalah audio, yang dapat dipengaruhi oleh beberapa bagian platform dan perangkat.

Proses debug dengan laporan bug

Untuk memeriksa status layanan Bluetooth menggunakan dumpsys, gunakan perintah berikut:

adb shell dumpsys bluetooth_manager

Secara default, semua pesan log adalah trace level 2. Untuk mengetahui lebih lanjut tingkat logging dan mengubah tingkat logging untuk berbagai profil, lihat di system/bt/conf/bt_stack.conf.

Untuk mengekstrak log snoop dari laporan bug, gunakan skrip btsnooz.

  1. Dapatkan btsnooz.py.
  2. Ekstrak versi teks laporan bug.
  3. Jalankan btsnooz.py pada versi teks laporan bug: 
    btsnooz.py BUG_REPORT.txt > BTSNOOP.log

Proses debug dengan log

Di Android 4.4 dan yang lebih baru, Anda dapat mengumpulkan log BTSnoop secara manual, yang menyerupai format snoop di RFC 1761. Log ini menangkap paket Host Controller Interface (HCI). Untuk sebagian besar perangkat Android, log disimpan di data/misc/bluetooth/logs.

Untuk alasan privasi, BTSnoop "dalam memori" yang selalu aktif hanya mencatat informasi dan peristiwa non-pribadi ke dalam log. Untuk mencatat semua data ke dalam log, pengguna harus mengaktifkan pengintaian HCI Bluetooth dengan melakukan langkah berikut:

  1. Aktifkan Opsi developer di perangkat.
  2. Pada menu Opsi developer, aktifkan tombol Aktifkan log snoop Bluetooth HCI.
  3. Mulai ulang Bluetooth agar pencatatan log diterapkan.