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ó trong AOSP và các bài kiểm thử của Nhóm đặc biệt về Bluetooth (SIG).

Kiểm thử và xác minh

Để kiểm thử ngăn xếp Bluetooth, AOSP cung cấp một số bài kiểm thử đơn vị, bài kiểm thử CTS và các công cụ cho Bộ điều chỉnh hồ sơ Bluetooth (PTS).

Kiểm thử đơn vị trong AOSP

AOSP bao gồm các bài kiểm thử đơn vị và chức năng cho ngăn xếp Bluetooth mặc định. Các bài kiểm thử này nằm trong /packages/modules/Bluetooth/system/test/. Để chạy các bài kiểm thử 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 thử, hãy chạy tệp thực thi shell và thêm các tuỳ chọn nếu bạn muốn chạy một bài kiểm thử hoặc bộ kiểm thử cụ thể:

    ./run_unit_tests.sh TEST_GROUP_NAME TEST_NAME OPTIONS

  3. Khi các bài kiểm thử hoàn tất, hãy bật lại thời gian chạy Android:

    adb shell start

Bạn có thể tìm thấy danh sách tên bài kiểm thử trong /packages/modules/Bluetooth/system/test/README.md.

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

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

Bài kiểm thử CTS

Bộ kiểm tra tính tương thích (CTS) bao gồm các bài kiểm thử cho ngăn xếp Bluetooth. Các bài kiểm thử này nằm trong cts/apps/CtsVerifier/src/com/android/cts/verifier/bluetooth.

Tuỳ chọn gỡ lỗi

AOSP cung cấp nhiều phương thức gỡ lỗi ngăn xếp Bluetooth của thiết bị, bao gồm cả nhật ký và báo cáo lỗi. Các phương thức này có thể không hoạt động đối với những vấn đề không thể tái tạo hoặc đối với các vấn đề về â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ả cá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 hồ sơ khác nhau, hãy xem system/bt/conf/bt_stack.conf.

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

  1. Tải 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, tương tự như định dạng theo dõi trong RFC 1761. Các nhật ký này ghi lại các gói Giao diện trình kiểm soát 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 bảo mật, BTSnoop "trong bộ nhớ" luôn bật chỉ ghi lại các sự kiện và thông tin không mang tính cá nhân. Để ghi lại tất cả dữ liệu, người dùng cần bật tính năng theo dõi HCI Bluetooth bằng cách làm như sau:

  1. Bật Tuỳ chọn cho nhà phát triển trên thiết bị.

  2. Trong trình đơn Tuỳ chọn cho nhà phát triển, hãy kích hoạt nút bật/tắt Bật nhật ký theo dõi HCI Bluetooth.

  3. Khởi động lại Bluetooth để nhật ký có hiệu lực.