Phần cứng
Kiểm traTest tín hiệu Bluetooth
Quét và kết nối thiết bị BLE gần đó qua Web Bluetooth ngay trong trình duyệt. Đọc dịch vụ GATT, đặc tính và đo cường độ tín hiệu RSSI.
Có góp ý? Báo lỗi, đề xuất tính năng, hoặc chia sẻ suy nghĩ — chúng tôi đọc tất cảGiới thiệu về Test tín hiệu Bluetooth
Test thiết bị Bluetooth Low Energy (BLE) trực tiếp trên trình duyệt bằng Web Bluetooth API. Quét thiết bị gần đó, kết nối, đọc dịch vụ GATT và đặc tính, giám sát cường độ tín hiệu (RSSI) khi có sẵn. Hoàn hảo cho nhà phát triển IoT, debug Bluetooth và test phần cứng.
How to use:
- Nhấn 'Quét thiết bị' để khám phá các thiết bị Bluetooth Low Energy gần đó.
- Chọn thiết bị từ hộp thoại chọn thiết bị của trình duyệt.
- Xem thông tin thiết bị bao gồm tên, ID và trạng thái kết nối.
- Khám phá các dịch vụ GATT và đặc tính có sẵn trên thiết bị đã kết nối.
- Giám sát cường độ tín hiệu (RSSI) như một giá trị cố gắng tốt nhất: nó dựa trên watchAdvertisements(), khác với Scanning API requestLEScan() và có thể vẫn không khả dụng nếu chưa bật cờ thử nghiệm, nên đừng coi thanh trực tiếp là chắc chắn.
- Xuất báo cáo thiết bị đã kết nối dưới dạng JSON hoặc CSV, hoặc sao chép vào bộ nhớ tạm, để đính kèm bản kiểm kê BLE có thể tái lập vào phiếu lỗi QA.
- Sử dụng 'Ngắt kết nối' để đóng kết nối khi hoàn tất.
Tương thích trình duyệt
- Chrome 56+ và Edge 79+ (Desktop & Android): hỗ trợ đầy đủ
- Opera và ChromeOS: được hỗ trợ
- Safari và Firefox: không hỗ trợ (không có Web Bluetooth)
- Trình duyệt nhúng trong ứng dụng Android (Facebook, Instagram, TikTok WebView): bị chặn — hãy mở trong Chrome độc lập
- Yêu cầu HTTPS / ngữ cảnh an toàn; trang http:// không thể quét
- Linux cần chrome://flags/#enable-web-bluetooth-new-permissions-backend cùng ngăn xếp BlueZ
- RSSI trực tiếp là cố gắng tốt nhất và có thể cần bật cờ thử nghiệm trong Chrome
Tài liệu tham khảo kỹ thuật
- MDN Web Bluetooth API: https://developer.mozilla.org/en-US/docs/Web/API/Web_Bluetooth_API
- Đặc tả Web Bluetooth: https://webbluetoothcg.github.io/web-bluetooth/
- Trạng thái Chrome Platform: https://chromestatus.com/feature/5264933985976320
Câu Hỏi Thường Gặp
Công cụ sử dụng Web Bluetooth API để quét các quảng bá Bluetooth Năng lượng Thấp (BLE) gần đó và kết nối tới các dịch vụ GATT (Thuộc tính Chung) trên thiết bị được chọn. Nó báo cáo tên thiết bị, mã định danh kiểu MAC do trình duyệt cung cấp, danh sách UUID dịch vụ được quảng bá và Chỉ báo Cường độ Tín hiệu Nhận được (RSSI) tính bằng dBm khi nền tảng cho phép. Khi đã kết nối, bạn có thể duyệt cây dịch vụ và đặc tính, đọc các đặc tính tĩnh như Thông tin Thiết bị (nhà sản xuất, mẫu, phiên bản firmware) và giám sát các giá trị trực tiếp như mức pin. Nó không đo Bluetooth cổ điển (BR/EDR) dùng cho tai nghe cũ, vì Web Bluetooth chỉ hỗ trợ BLE theo đặc tả. Hãy xem nó như một trình kiểm tra BLE di động chứ không phải bộ phân tích giao thức đầy đủ.
Việc ghép nối trong hệ điều hành chỉ xác minh rằng quá trình bắt tay đã hoàn tất. Nó không cho bạn biết gì về chất lượng tín hiệu, các dịch vụ được hỗ trợ hoặc liệu firmware có quảng bá đúng khả năng hay không. Bằng cách quét và kết nối qua công cụ này, bạn có thể xác nhận một vòng theo dõi sức khỏe thực sự hiển thị dịch vụ Nhịp Tim trước khi gỡ lỗi ứng dụng, kiểm tra một beacon phát đúng UUID iBeacon hoặc Eddystone, hoặc xem RSSI giảm khi bạn đi xa ổ khóa thông minh để ước tính phạm vi hiệu quả. Việc kiểm tra cũng giúp khi ứng dụng nhà sản xuất từ chối kết nối — nếu thiết bị xuất hiện ở đây với các dịch vụ mong đợi, vấn đề nằm ở ứng dụng hoặc quyền của nó, không phải radio.
RSSI được báo cáo bằng decibel-milliwatt (dBm) và luôn âm cho tín hiệu nhận được. Hướng dẫn thực địa thô: −30 đến −50 dBm là xuất sắc, thường đạt khi các thiết bị cách nhau trong vòng một mét; −50 đến −70 dBm là tốt và cho kết nối đáng tin cậy cho tai nghe, chuột và vòng theo dõi; −70 đến −85 dBm là yếu và bạn có thể thấy ngắt âm thanh hoặc bỏ thông báo; dưới −90 dBm kết nối có thể sẽ thất bại. Nhớ rằng RSSI là logarit — giảm 10 dBm tương ứng khoảng 10× ít công suất nhận hơn. Tường, cơ thể người, lò vi sóng và Wi-Fi 2,4 GHz đều suy giảm hoặc gây nhiễu. Đối với thiết bị BLE chạy pin, bộ thu trong thiết bị thường yếu hơn trong điện thoại, nên RSSI "tốt" trong công cụ này không đảm bảo nhận tốt theo chiều ngược lại.
Tín hiệu BLE ở 2,4 GHz hoạt động như sóng điện từ với bước sóng khoảng 12,5 cm, nên thay đổi vị trí nhỏ có thể di chuyển bạn giữa các vùng sáng và tối của hiện tượng đa đường — cùng kiểu sóng đứng gây ra vùng chết Wi-Fi. Dao động RSSI 5–10 dBm giữa các vị trí gần nhau là hoàn toàn bình thường trong nhà. Công cụ cũng lấy trung bình qua một cửa sổ nhỏ, và radio trong điện thoại có thể báo cáo giá trị lượng tử hóa (thường là dBm nguyên). Để có đọc số ổn định, giữ thiết bị bất động trong vài giây và trung bình hóa qua nhiều mẫu, hoặc di chuyển chậm theo dõi xu hướng. Nếu giá trị nhảy lung tung mà không ai di chuyển, ăng-ten có thể bị tay che (hiệu ứng "death grip") hoặc nguồn 2,4 GHz khác đang nhảy vào và ra các kênh.
Dịch vụ GATT là nhóm logic các mục dữ liệu liên quan gọi là đặc tính. Mỗi dịch vụ có UUID 16-bit cho hồ sơ tiêu chuẩn (ví dụ 0x180F cho Dịch vụ Pin, 0x180D cho Nhịp Tim, 0x1800 cho Truy cập Chung) hoặc UUID 128-bit cho dịch vụ riêng của nhà sản xuất. Các đặc tính trong dịch vụ hiển thị giá trị đọc được, ghi được hoặc thông báo được — mức pin trả về một byte từ 0 đến 100, trong khi nhịp tim trả về khung nhỏ với cờ và BPM. Đọc một đặc tính cho giá trị hiện tại; đăng ký thông báo cho cập nhật trực tiếp do thiết bị đẩy. Đặc tính được mã hóa yêu cầu ghép nối trước khi phản hồi. Nếu một đặc tính trả về dữ liệu nhị phân khó hiểu, hãy tra UUID của nó trên trang đặc tả Bluetooth SIG để tìm bố cục byte.
Web Bluetooth API chỉ hiển thị các thiết bị đang quảng bá tích cực trong cửa sổ quét, trong phạm vi và khớp với bất kỳ bộ lọc dịch vụ nào bạn cung cấp. Nhiều thiết bị ngừng quảng bá khi đã ghép nối và kết nối với máy chủ, nên loa Bluetooth đang phát nhạc từ điện thoại sẽ không xuất hiện. Thiết bị Bluetooth cổ điển (tai nghe cũ, bàn phím dùng BR/EDR) không bao giờ xuất hiện vì Web Bluetooth chỉ BLE. Một số trình duyệt cũng yêu cầu quyền một lần cho mỗi thiết bị và có thể lọc bỏ thiết bị đã ghép nối ở cấp HĐH. Hãy thử tắt mở thiết bị đích để buộc quảng bá mới, di chuyển gần hơn để loại trừ phạm vi và đảm bảo trình duyệt là Chrome, Edge hoặc Opera trên nền tảng không phải iOS — Safari và Firefox không hỗ trợ Web Bluetooth tại thời điểm viết.
BLE 5.0 giới thiệu PHY 2 Mbps (tốc độ dữ liệu gấp đôi), PHY mã hóa Tầm Xa (S=2 và S=8 sửa lỗi chuyển tiếp cho phạm vi ~4× với thông lượng thấp hơn) và tải trọng quảng cáo mở rộng lên đến 255 byte. BLE 5.1 thêm tìm hướng (AoA/AoD), 5.2 thêm LE Audio với codec LC3 và kênh đồng bộ, và 5.3 tinh chỉnh độ bền kết nối. Web Bluetooth API trừu tượng hóa PHY đang dùng, nên công cụ không thể hiển thị liệu liên kết đang ở 1M, 2M hay PHY mã hóa — thông tin đó chỉ có với bộ phân tích cấp thấp như nRF Sniffer hoặc Ellisys. Những gì bạn có thể suy luận gián tiếp: kết nối ổn định ở khoảng cách cực xa (>30 m tầm nhìn) gợi ý hỗ trợ PHY mã hóa, và trường dữ liệu nhà sản xuất trong gói quảng bá thường ám chỉ phiên bản BLE.
Không có gì được tải lên. Toàn bộ việc quét, kết nối, đọc RSSI và duyệt GATT chạy cục bộ trong trình duyệt qua Web Bluetooth API — không tên thiết bị, ID, UUID dịch vụ, giá trị đặc tính hay mẫu RSSI nào được gửi tới máy chủ của chúng tôi, và các tệp xuất (JSON/CSV) được tạo trên máy bạn và chỉ lưu nơi bạn chọn. Khi bạn chọn một thiết bị trong hộp chọn của trình duyệt, bạn cấp quyền theo nguồn gốc và theo từng thiết bị để trang có thể kết nối lại đúng thiết bị đó; nó không cấp cho trang quyền truy cập toàn bộ phần cứng Bluetooth của bạn. Để xem lại hoặc thu hồi trong Chrome hay Edge, mở chrome://settings/content/bluetoothDevices (hoặc nhấp biểu tượng ổ khóa/cài đặt trên thanh địa chỉ → Cài đặt trang → Thiết bị Bluetooth) và xóa các thiết bị đã lưu của trang này. Xóa dữ liệu trang của nguồn gốc cũng loại bỏ các quyền. Nhờ vậy một máy trạm QA có thể dùng công cụ mà không rò rỉ bản kiểm kê firmware của thiết bị đang thử nghiệm.
Web Bluetooth là một khả năng mạnh — nó có thể đọc và ghi vào các radio gần đó — nên đặc tả chỉ cho phép nó trong ngữ cảnh an toàn. Điều đó nghĩa là trang phải được phục vụ qua HTTPS (hoặc từ localhost khi phát triển); trên một nguồn gốc http:// thuần thì navigator.bluetooth bị giữ lại và nút Quét vẫn bị vô hiệu, đó là hành vi bạn sẽ thấy nếu mở công cụ qua một proxy không an toàn. Ngoài ra, nền tảng bên dưới phải hỗ trợ API: trên Linux, Chrome khóa Web Bluetooth sau cờ thử nghiệm chrome://flags/#enable-web-bluetooth-new-permissions-backend và yêu cầu cài đặt và chạy ngăn xếp BlueZ, vì backend cấp quyền ở đó vẫn đang hoàn thiện. macOS, Windows, Android và ChromeOS hoạt động ngay trong Chrome/Edge. Nếu công cụ báo Web Bluetooth không được hỗ trợ, hãy kiểm tra yêu cầu ngữ cảnh an toàn trước, rồi đến trình duyệt và hệ điều hành, trước khi cho rằng bộ điều hợp bị lỗi.
Sau khi kết nối, ba nút sẽ hoạt động bên cạnh Làm mới: Xuất JSON, Xuất CSV và Sao chép báo cáo. Xuất JSON tải xuống tệp ble-report-<thiết bị>-<dấu thời gian>.json có thể so sánh bằng máy, chứa tên và ID thiết bị, dấu thời gian thu thập, toàn bộ cây dịch vụ/đặc tính kèm UUID và thuộc tính của mỗi đặc tính (Đọc/Ghi/Thông báo/Báo hiệu), mọi mẫu RSSI quan sát được và RSSI nhỏ nhất/lớn nhất/trung bình đã tính — lý tưởng để đính kèm vào phiếu Jira hay GitHub hoặc so sánh hai bản firmware. Xuất CSV tạo tệp thân thiện bảng tính với phần tiêu đề siêu dữ liệu, bản kiểm kê service_uuid / characteristic_uuid / properties và bảng mẫu RSSI có dấu thời gian, để một xưởng sửa chữa dán các hàng đạt/không đạt vào bảng theo lô. Sao chép báo cáo đặt cùng JSON đó vào bộ nhớ tạm để dán nhanh vào chat hay phiếu. Thanh bên cạnh RSSI là số đo chất lượng chuẩn hóa 0–100% suy ra từ dBm thô hiển thị ở huy hiệu (−100 dBm ≈ 0%, −30 dBm ≈ 100%), nên hãy trích giá trị dBm, không phải phần trăm, khi so sánh các thiết bị.
Không — hãy coi mọi đặc tính ghi được là tiềm ẩn nguy hiểm cho đến khi bạn biết đặc tả của nó. Ghi byte tùy ý vào đặc tính riêng của nhà sản xuất có thể thay đổi cài đặt firmware, kích hoạt khôi phục cài đặt gốc, mở khóa cửa, đẩy thiết bị vào chế độ cập nhật firmware (DFU) hoặc tệ nhất là biến thiết bị thành cục gạch khi ghi đè khối cấu hình. Các dịch vụ chuẩn của Bluetooth SIG ghi tài liệu chi tiết bố cục byte; các dịch vụ nhà sản xuất thường không có tài liệu công khai và rất khó đảo ngược. Quy trình an toàn là: đọc mọi thứ trước, chỉ ghi vào đặc tính có tài liệu, sao lưu mọi cài đặt thay đổi và không bao giờ thực hiện thao tác ghi với thiết bị BLE y tế, an ninh hoặc công nghiệp mà bạn không sở hữu.
KếT NốI5
WUTOOLS