Xác minh và gỡ lỗi

Để xác minh và gỡ lỗi ngăn xếp Bluetooth, hãy sử dụng các công cụ được cung cấp trong các bài kiểm tra AOSP và Bluetooth Special Interest Group (SIG).

Kiểm tra và xác minh

Để kiểm tra ngăn xếp Bluetooth, AOSP cung cấp kết hợp các bài kiểm tra đơn vị, kiểm tra CTS và các công cụ cho Bộ điều chỉnh cấu hình Bluetooth.

Kiểm tra đơn vị trong AOSP

AOSP bao gồm các bài kiểm tra chức năng và đơn vị cho ngăn xếp Bluetooth mặc định. Các thử nghiệm này được đặt trong /packages/modules/Bluetooth/system/test/ . Để chạy kiểm tra AOSP, hãy làm như sau:

  1. Dừng thời gian chạy Android:
    adb shell stop
  2. Từ thư mục kiểm tra, hãy chạy tệp thực thi shell và bao gồm các tùy chọn nếu bạn muốn chạy một bộ kiểm tra hoặc bộ kiểm tra cụ thể:
    ./run_unit_tests.sh TEST_GROUP_NAME TEST_NAME OPTIONS
  3. Khi quá trình kiểm tra kết thúc, hãy bật lại thời gian chạy Android:
    adb shell start

Danh sách tên kiểm tra có thể được tìm thấy trong /packages/modules/Bluetooth/system/test/README.md .

Bộ thử nghiệm Android Comms

Bộ kiểm tra Android Comms (ACTS) thực hiện kiểm tra tự động các ngăn xếp kết nối, chẳng hạn như Wi-Fi, Bluetooth và dịch vụ di động. Công cụ kiểm tra yêu cầu adb và python và có thể tìm thấy công cụ này trong tools/test/connectivity/acts .

Các bài kiểm tra ACTS cho Bluetooth và Bluetooth Low Energy lần lượt được tìm thấy trong tools/test/connectivity/acts_tests/tests/google/bt/tools/test/connectivity/acts_tests/tests/google/ble/ .

Bộ điều chỉnh hồ sơ

Bluetooth SIG cung cấp Bộ điều chỉnh cấu hình Bluetooth (PTS), một công cụ kiểm tra khả năng tương tác giữa giao thức và cấu hình. Để biết thêm thông tin, hãy xem trang web Bộ điều chỉnh cấu hình Bluetooth .

AOSP cung cấp các công cụ bổ sung để bổ sung cho Bluetooth PTS. Các công cụ này nằm trong tools/test/connectivity/acts_tests/tests/google/bt/pts/ .

Kiểm tra CTS

Bộ kiểm tra khả năng tương thích (CTS) bao gồm các kiểm tra cho ngăn xếp Bluetooth. Chúng được đặt trong cts/apps/CtsVerifier/src/com/android/cts/verifier/bluetooth .

Tùy chọn gỡ lỗi

AOSP cung cấp các phương pháp khác nhau để gỡ lỗi ngăn xếp Bluetooth của thiết bị, bao gồm nhật ký và báo cáo lỗi. Các phương pháp này có thể không hiệu quả đối với các sự cố không thể tái tạo hoặc đối với các sự cố âm thanh có thể bị ảnh hưởng bởi nhiều phần của nền tảng và thiết bị.

Gỡ lỗi bằng báo cáo lỗi

Để kiểm tra trạng thái dịch vụ Bluetooth bằng dumpsys , hãy sử dụng lệnh sau:

adb shell dumpsys bluetooth_manager

Theo mặc định, tất cả thông báo nhật ký đều ở cấp độ theo dõi 2. Để tìm hiểu thêm về các cấp độ ghi nhật ký và thay đổi cấp độ ghi nhật ký cho các cấu hình khác nhau, hãy xem trong system/bt/conf/bt_stack.conf .

Để trích xuất nhật ký rình mò từ báo cáo lỗi, hãy sử dụng tập lệnh btsnooz .

  1. Nhận btsnooz.py .
  2. Trích xuất phiên bản văn bản của báo cáo lỗi.
  3. Chạy btsnooz.py trên phiên bản văn bản của báo cáo lỗi:
    btsnooz.py BUG_REPORT.txt > BTSNOOP.log

Gỡ lỗi bằng nhật ký

Trong Android 4.4 trở lên, bạn có thể thu thập nhật ký BTSnoop theo cách thủ công, giống với định dạng snoop trong RFC 1761. Các nhật ký này ghi lại các gói Giao diện điều khiển máy chủ (HCI). Đối với hầu hết các thiết bị Android, nhật ký được lưu trữ trong data/misc/bluetooth/logs .

Vì lý do riêng tư, BTSnoop "trong bộ nhớ" luôn bật chỉ ghi lại các thông tin và sự kiện phi cá nhân. Để ghi lại tất cả dữ liệu, người dùng cần bật Bluetooth HCI snoop bằng cách thực hiện như sau:

  1. Bật tùy chọn Nhà phát triển trên thiết bị.
  2. Trong menu Tùy chọn nhà phát triển , hãy kích hoạt nút chuyển đổi Bật nhật ký snoop Bluetooth HCI .
  3. Khởi động lại Bluetooth để việc đăng nhập có hiệu lực.