如要驗證藍牙堆疊並進行偵錯,請使用 Android 開放原始碼計畫提供的工具和藍牙特殊興趣群組 (SIG) 測試。
測試並驗證
為測試藍牙堆疊,Android 開放原始碼計畫提供了單元測試、CTS 測試,以及藍牙設定檔調整套件的工具。
Android 開放原始碼計畫中的單元測試
Android 開放原始碼計畫提供預設藍牙堆疊的功能和單元測試。這些測試位於
/packages/modules/Bluetooth/system/test/
。如要執行 Android 開放原始碼計畫測試,請按照下列步驟操作:
- 停止 Android 執行階段:
adb shell stop
- 請在測試目錄中執行殼層執行檔。如果您想執行特定測試或測試套件,請加入以下選項:
./run_unit_tests.sh TEST_GROUP_NAME TEST_NAME OPTIONS
- 測試完成後,請重新啟用 Android 執行階段:
adb shell start
您可以在
/packages/modules/Bluetooth/system/test/README.md
中找到測試名稱清單。
設定檔調整套件
藍牙 SIG 提供藍牙設定檔調整套件 (PTS),這是用於通訊協定和設定檔互通性的測試工具。詳情請參閱 藍牙設定檔調整套件網站。
CTS 測試
Compatibility Test Suite (CTS) 包含藍牙堆疊的測試。這些位於
cts/apps/CtsVerifier/src/com/android/cts/verifier/bluetooth
。
偵錯選項
Android 開放原始碼計畫提供不同的裝置藍牙堆疊偵錯方式,包括記錄和錯誤報告。這些方法可能不適用於無法重現的問題,或可能受平台和裝置多個部分影響的問題。
使用錯誤報告進行偵錯
如要使用 dumpsys
檢查藍牙服務狀態,請使用下列指令:
adb shell dumpsys bluetooth_manager
根據預設,所有記錄訊息都是追蹤層級 2。如要進一步瞭解記錄層級,並變更不同設定檔的記錄層級,請查看
system/bt/conf/bt_stack.conf
的說明。
如要從錯誤報告中擷取窺探記錄,請使用 btsnooz
指令碼。
- 取得
btsnooz.py
。 - 擷取錯誤報告的文字版本。
- 在文字版本的錯誤報告上執行
btsnooz.py
:btsnooz.py BUG_REPORT.txt > BTSNOOP.log
使用記錄進行偵錯
在 Android 4.4 以上版本中,您可以手動收集 BTSnoop 記錄,這類似 RFC 1761 的窺探格式。這些記錄檔會擷取主機控制器介面 (HCI) 封包。
大多數 Android 裝置的記錄都儲存在 data/misc/bluetooth/logs
中。
基於隱私考量,BTSnoop 一律開啟「記憶體內」功能,只會記錄非個人資訊和事件。如要記錄所有資料,使用者必須按照下列步驟啟用藍牙 HCI 窺探功能:
- 在裝置上啟用「開發人員選項」。
- 在「開發人員選項」選單中,啟用「啟用藍牙 HCI 窺探記錄」切換鈕。
- 請重新啟動藍牙,讓記錄功能生效。