Khắc phục vấn đề

Tòa nhà

Xác minh rằng điện thoại của bạn tương thích

Tất cả thiết bị Android O (8.1, API cấp 27) trở lên đều tương thích với Matter. Hãy làm theo các bước bên dưới để kiểm tra xem điện thoại của bạn có các mô-đun cần thiết hay không.

Thiết lập Cầu gỡ lỗi Android

Bạn phải thiết lập Cầu gỡ lỗi Android (adb) trước khi khắc phục sự cố. Cách thiết lập:

  1. Cài đặt "adb" trên máy tính.
  2. Bật Tuỳ chọn cho nhà phát triển và Gỡ lỗi qua USB trên điện thoại Android.

Xác minh các mô-đun Matter của Dịch vụ Google Play (GPS)

Để kiểm tra xem bạn có các mô-đun Google Play services Matter hay không, hãy làm như sau:

  1. Thiết lập Cầu gỡ lỗi Android.
  2. Hãy sử dụng cáp USB để kết nối điện thoại Android với máy tính.
  3. Chạy lệnh này trong thiết bị đầu cuối để xác minh rằng các mô-đun Matter cần thiết đã được cài đặt:
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
      
    
    Nếu thấy kết quả tương tự như bên dưới, tức là bạn đã cài đặt các mô-đun Matter:
    com.google.android.gms.home [v222110900]
    Xin lưu ý rằng số phiên bản ở trên có thể khác với thiết bị của bạn.
  4. Chạy lệnh này trong thiết bị đầu cuối để xác minh rằng các mô-đun Thread cần thiết đã được cài đặt:
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
      
    
    Nếu kết quả tương tự như trong ví dụ sau, tức là bạn đã cài đặt các mô-đun Thread:
    com.google.android.gms.threadnetwork [v222106301]
    Xin lưu ý rằng số phiên bản trên thiết bị của bạn có thể khác.

Nếu các mô-đun không được liệt kê thì có nghĩa là:

  1. Bạn có một phiên bản Android đã lỗi thời. Hãy đảm bảo đó là Android O (8.1) trở lên.
  2. Các mô-đun Matter chưa được tải xuống. Chờ ít nhất 24 giờ để tải xuống. Hãy đảm bảo thiết bị của bạn đã bật nguồn và sạc trong thời gian này để quá trình tải xuống không bị trì hoãn. Nếu không nhận được mô-đun trong vòng 24 giờ, bạn có thể thử đặt lại dữ liệu của thiết bị về trạng thái ban đầu để buộc các mô-đun tải xuống.

Xác minh VID/PID của thiết bị

Nếu muốn bắt đầu phát triển công cụ tích hợp với Google, bạn phải tạo một dự án và công cụ tích hợp trên Google Home Console.

Khắc phục sự cố Bluetooth Sniffer

Giá trị VID/PID mà thiết bị của bạn đang hiển thị phải khớp với VID/PID được nhập vào dự án Google Home Developer Console của bạn.

  • VID 0xFFF10xFFF4 được dành riêng cho mục đích thử nghiệm. Các API này có thể được dùng cho các hoạt động kiểm thử kiểm soát và vận hành cơ bản, nhưng không thể sử dụng trong các giai đoạn phát triển sau đây:

Khi sử dụng một ứng dụng kỹ thuật Bluetooth như nRF Connect for Mobile, bạn có thể xem VID/PID của thiết bị báo hiệu trong trường Dữ liệu dịch vụ.

Trong ảnh chụp màn hình phiên bản Android của nRF Connect, bạn sẽ thấy VID/PID được liệt kê là 5A23FFFE bắt đầu từ byte thứ tư của trường Dữ liệu dịch vụ. Điều này cho thấy VID của 5A23 và PID của FFFE – cả hai đều ở định dạng endian nhỏ.

Ứng dụng BLE hiển thị các giá trị theo thứ tự Endian nhỏ,nhưng các giá trị VID/PID mà bạn nhập vào dự án Developer Console lại ở dạng endian lớn.

Xác thực rằng bạn đã nhập các giá trị và định dạng phù hợp vào dự án Bảng điều khiển Actions dựa trên nội dung mà công cụ phát hiện Bluetooth đang hiển thị.

Đối với các giá trị trong ảnh chụp màn hình ví dụ, VID và PID trong Developer Console sẽ lần lượt là 235AFEFF.

Xác minh rằng thiết bị được tạo bằng một nhánh SDK Matter tương thích

Trung tâm Matter của Google tương thích với Matter 1.0 và đã được kiểm thử với các bản dựng có sử dụng cam kết từ nhánh v1.0-branch ổn định. Xem Ghi chú phát hành công khai để biết các thay đổi cụ thể được đề xuất sử dụng với từng bản phát hành mới của trung tâm.

Tính năng ghép nối

Xác minh thông tin xác thực cho thiết bị của bạn

Khi bạn sử dụng VID do Alliance chỉ định của chính mình, hãy đảm bảo rằng bạn có thông tin đăng nhập chính xác trên thiết bị:

  • Tuyên bố chứng nhận (CD).
  • Chứng chỉ chứng thực thiết bị (DAC) và chuỗi chứng chỉ tương ứng.

Để biết thêm thông tin, hãy xem bài viết Tạo chứng chỉ kiểm thử thiết bị theo chuẩn Matter.

Xác minh Hub tương thích với Matter

Trung tâm Matter của bạn phải là một trong những trung tâm được Google hỗ trợ. Ứng dụng này cũng phải hoạt động trên một bản dựng tương thích với Matter.

Một số trung tâm cũng là Bộ định tuyến đường viền luồng, do đó cho phép bạn phát triển và kiểm thử các thiết bị Thread (Luồng). Các trung tâm khác chỉ hỗ trợ các thiết bị Matter Wi-Fi và Ethernet, trừ phi bạn có một bộ định tuyến biên khác trong mạng để bật tính năng kết nối qua Thread.

Bản dựng trung tâm có thể được xác minh bằng cách: Trượt ngón tay xuống từ cạnh trên > Bánh xe cấu hình > Thông tin thiết bị > Thông tin kỹ thuật > Phiên bản chương trình cơ sở Chromecast

Không thể uỷ quyền với thông báo lỗi "Không thể liên hệ với Google"

Đảm bảo bạn đã tạo chế độ tích hợp với tổ hợp VID/PID chính xác trong Developer Console. Hãy xem bài viết Tạo quá trình tích hợp Matter để biết thêm thông tin.

Không xác thực được với thông báo lỗi "Không kết nối được với thiết bị"

Nếu vẫn nhận được thông báo lỗi "Không thể truy cập vào thiết bị" khi uỷ quyền cho thiết bị Thread và đã dùng hết tất cả tuỳ chọn gỡ lỗi có sẵn, bạn nên xoá thông tin xác thực Thread ưu tiên đã lưu trữ trên điện thoại Android để thiết lập sạch thông qua phần Cài đặt > Ứng dụng > Ứng dụng ứng dụng > Dịch vụ Google Play > Bộ nhớ và bộ nhớ đệm > Quản lý dung lượng > XÓA TẤT CẢ DỮ LIỆU.

Kiểm thử

Thiết bị đã chỉ định không xuất hiện trong Bộ thử nghiệm

Nếu bạn đã ghép nối một thiết bị với Mã nhà cung cấp kiểm thử (VID) và Mã sản phẩm (PID), nhưng mã này không xuất hiện khi bạn cố gắng kiểm thử thiết bị bằng Bộ thử nghiệm trong Developer Console, thì có thể là do việc sử dụng cùng một tổ hợp VID và PID kiểm thử trên nhiều chế độ tích hợp.

Để khắc phục sự cố, hãy xoá mọi thiết bị thử nghiệm khỏi Developer Console và ghép nối thiết bị bạn muốn kiểm thử lại.

Để xác thực rằng bạn đã ghép nối đúng thiết bị, bạn có thể đặt thông tin Nhà sản xuất và Kiểu máy (giá trị CHIP_DEVICE_CONFIG_DEVICE_*) của thiết bị thành các giá trị duy nhất trong chương trình cơ sở kiểm thử.

Hãy xem bài viết Thông tin thiết bị để biết thêm thông tin.

Nếu mọi thứ vẫn không ổn

Nếu sau khi làm theo tất cả các bước khắc phục sự cố ở đây, vấn đề của bạn vẫn chưa được giải quyết, thì không sao cả!

Trong các bước khắc phục sự cố, bạn đã thu thập được dữ liệu quan trọng về thiết bị, dự án bảng điều khiển và môi trường của mình. Khi có dữ liệu đó, hãy xem trang Hỗ trợ để biết cách chia sẻ vấn đề của bạn tốt nhất với cộng đồng và nhóm hỗ trợ Google Home.