Khắc phục vấn đề

Tòa nhà

Xác minh điện thoại của bạn có tương thích hay không

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 dưới đây để 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à tính năng Gỡ lỗi qua USB trên điện thoại Android.

Xác minh mô-đun Vấn đề 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. 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 một cửa sổ dòng lệnh để 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, thì tức là bạn đã cài đặt các mô-đun Matter: 
    com.google.android.gms.home [v222110900]
    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 một thiết bị đầu cuối để xác minh rằng bạn đã cài đặt các mô-đun Thread cần thiết:
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
    Nếu bạn thấy kết quả tương tự như trong ví dụ sau, thì bạn đã cài đặt các mô-đun Thread:
    com.google.android.gms.threadnetwork [v222106301]
    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ó trong danh sách, thì có nghĩa là:

  1. Bạn đang dùng phiên bản Android đã lỗi thời. Hãy đảm bảo mã này có 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. Đảm bảo thiết bị của bạn đang 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 chưa nhận được các mô-đun trong vòng 24 giờ, bạn có thể thử đặt lại dữ liệu về trạng thái ban đầu của thiết bị để buộc các mô-đun tải xuống.

Nhật ký thiết bị trung tâm Fuchsia

Cách bật một trung tâm truy xuất nhật ký cục bộ:

  1. Gửi email kèm theo Số sê-ri và Mã thiết bị của bạn đến Technical Account Manager (TAM) của Google. Bạn có thể tìm thấy những thông tin này bằng chữ cái nhỏ bên dưới thiết bị.
  2. Sau khi nằm trong danh sách cho phép, bạn phải bật tính năng này bằng cách làm theo các bước sau:
    • Trên trung tâm:
      1. Vuốt xuống từ đầu màn hình
      2. Nhấn vào biểu tượng Cài đặt
      3. Tìm Phiên bản Fuchsia: Trên Google Nest Hub (2nd gen), hãy chuyển đến Thông tin thiết bị > Thông tin kỹ thuật > Phiên bản Fuchsia
      4. Nhấn vào "Phiên bản màu hoa vân anh" 7 lần. Thao tác này sẽ bật các tuỳ chọn cho nhà phát triển
      5. Quay lại trình đơn cấp cao nhất
      6. Nhấn vào "Tuỳ chọn cho nhà phát triển"
      7. Nhấn vào "Ghi nhật ký đối tác"
    • Tính năng này sẽ được bật trong 24 giờ. Sau đó, hãy bật lại tính năng ghi nhật ký từ bước 5 trở đi.
  3. Lấy địa chỉ IP của trung tâm:
    • Trên trung tâm điều khiển (nếu có màn hình):
      1. Vuốt xuống từ đầu màn hình
      2. Nhấn vào biểu tượng Cài đặt
      3. Tìm địa chỉ IP của thiết bị: Trên Nest Hub (2nd gen), chuyển đến phần Thông tin thiết bị > Thông tin kỹ thuật > Địa chỉ IP
    • Từ Google Home app (GHA) trên điện thoại:
      1. Nhấn vào thiết bị để mở trang chi tiết về thiết bị
      2. Nhấn vào biểu tượng Cài đặt để mở trang cài đặt
      3. Tìm địa chỉ IP của thiết bị: chuyển đến phần Thông tin thiết bị > Thông tin kỹ thuật > Địa chỉ IP
  4. Để truy xuất nhật ký từ trung tâm, bạn sẽ tạo một yêu cầu GET HTTP tới trung tâm từ một máy tính trên cùng một mạng Wi-Fi.
    • Lưu ý cổng và đường dẫn của điểm cuối: 
      curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
    • Kết nối chỉ có thể được giữ mở trong một phút, nhưng dữ liệu được truy xuất từ vùng đệm thường có 20 đến 30 phút của các sự kiện trước đó.
      • Tốt nhất là bạn nên trích xuất nhật ký bằng phương thức này ngay sau khi hoàn tất quy trình kiểm thử để đảm bảo vùng đệm chứa nội dung liên quan đến kiểm thử (tương tự như báo cáo lỗi trên Android).

Tắt tính năng loại bỏ nhật ký Android

  • Vì lý do bảo mật và quyền riêng tư, bạn chỉ nên sử dụng tính năng này cho mục đích kiểm thử kỹ thuật.
  • Không sử dụng lựa chọn này với người dùng hoặc thiết bị phát hành chính thức.
  • Các bước:
    1. Gửi Tài khoản Google của những người dùng sẽ có nhật ký chưa bị loại bỏ nội dung nhạy cảm đến TAM của Google.
    2. Sau khi xác nhận rằng tài khoản của bạn đã được thêm vào danh sách cho phép, hãy khởi động lại điện thoại.

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

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

Khắc phục sự cố với tính năng Bluetooth Sniffer

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

  • Các VID 0xFFF1 – 0xFFF4 được dành riêng cho mục đích thử nghiệm. Bạn có thể sử dụng các phiên bản này 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:

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

Trong ảnh chụp màn hình này từ 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 biết VID là 5A23 và PID là FFFE – cả hai đều ở định dạng little endian.

Ứng dụng BLE hiển thị các giá trị bằng endian nhỏ, nhưng giá trị VID/PID 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 đúng giá trị và định dạng vào dự án Actions Console dựa trên nội dung mà trình quan sát Bluetooth hiển thị.

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

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

Các trung tâm Matter của Google tương thích với Matter 1.0 và đã được kiểm thử bằng các bản dựng sử dụng các thay đổi từ nhánh ổn định v1.0-branch. Hãy 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 mỗi bản phát hành trung tâm mới.

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 riêng mình, hãy đảm bảo rằng bạn có thông tin xác thực 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ỉ của chứng chỉ đó.

Để 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ị Matter.

Xác minh Trung tâm 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ợ. Phiên bản này cũng phải nằm 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 biên Thread, nhờ đó, bạn có thể phát triển và kiểm thử các thiết bị Thread. Các trung tâm khác chỉ hỗ trợ 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 khả năng kết nối Thread.

Bạn có thể xác minh bản dựng trung tâm bằng cách: Vuốt ngón tay xuống từ cạnh trên cùng > 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ở của Chromecast

Không uỷ quyền được kèm theo thông báo lỗi "Không thể liên hệ với Google"

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

Không uỷ quyền được kèm theo thông báo lỗi "Không thể kết nối với thiết bị"

Nếu liên tục nhận được thông báo lỗi "Không thể kết nối với thiết bị" khi đưa thiết bị Thread vào hoạt động và đã sử dụng hết tất cả cá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 lại thông qua 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 > XOÁ MỌI DỮ LIỆU.

Thử nghiệm

Thiết bị được uỷ quyền không xuất hiện trong Bộ kiểm thử

Nếu bạn đã ghép nối thiết bị với Mã nhà cung cấp (VID) thử nghiệm và Mã sản phẩm (PID), nhưng thiết bị 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ì nguyên nhân có thể là do việc sử dụng cùng một tổ hợp VID và PID thử nghiệm trên nhiều chế độ tích hợp.

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

Để 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à Mẫu (giá trị CHIP_DEVICE_CONFIG_DEVICE_*) cho thiết bị thành các giá trị duy nhất trong phần mềm thử nghiệm.

Hãy xem phần Thông tin thiết bị để biết thêm thông tin.

Nếu vẫn gặp vấn đề

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

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