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 quy trình kiểm thử của AOSP và Bluetooth Đặc biệt dành cho Nhóm quan tâm (SIG).

Kiểm tra và xác minh

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

Kiểm thử đơn vị trong AOSP (Dự án nguồn mở Android)

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

  1. Dừng môi trườ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à bao gồm các tuỳ chọn nếu bạn muốn chạy một bộ kiểm thử hoặc bộ kiểm thử cụ thể:
    ./run_unit_tests.sh TEST_GROUP_NAME TEST_NAME OPTIONS
  3. Khi kiểm thử hoàn tất, hãy bật lại Android Runtime:
    adb shell start

Bạn có thể xem danh sách tên kiểm thử trong /packages/modules/Bluetooth/system/test/README.md.

Bộ công cụ tinh chỉnh hồ sơ

Bluetooth SIG cung cấp Bộ điều chỉnh hồ sơ Bluetooth (PTS), một công cụ kiểm tra khả năng tương tác của giao thức và hồ sơ. Để biết thêm thông tin, hãy truy cập 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 kiểm thử cho ngăn xếp Bluetooth. Các cơ sở này nằm ở 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 hiệu quả đối với những vấn đề không tái tạo được hoặc các vấn đề về âm thanh có thể chịu ảnh hưởng của 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 của dịch vụ Bluetooth bằng dumpsys, hãy dùng lệnh sau:

adb shell dumpsys bluetooth_manager

Theo mặc định, tất cả thông điệp nhật ký đều là dấu vết cấp 2. Để tìm hiểu thêm về cấp độ ghi nhật ký và thay đổi cấp độ ghi nhật ký cho các hồ sơ, hãy xem trong 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 thu thập 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 luôn bật, "trong bộ nhớ" chỉ ghi lại các sự kiện và thông tin không phải là thông tin cá nhân. Để ghi nhật ký tất cả dữ liệu, người dùng cần bật Bluetooth HCI snoop 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ý snoop Bluetooth HCI.
  3. Hãy khởi động lại Bluetooth để tính năng ghi nhật ký có hiệu lực.