Khắc phục vấn đề

Tòa nhà

Xác minh đ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 dưới đây để kiểm tra xem điện thoại của bạn có các mô-đun cần thiết.

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

Bạn nên 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à USB Gỡ lỗi trên điện thoại Android của bạn.

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

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

  1. Thiết lập Cầu gỡ lỗi Android.
  2. Hãy dùng cáp USB để kết nối điện thoại Android với của bạn.
  3. Chạy lệnh này trong cửa sổ dòng lệnh để xác minh rằng Matter mô-đun đã đượ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ư dưới đây, Matter mô-đun đã được cài đặt:
    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 cửa sổ dòng lệnh để xác minh rằng Thread mô-đun đã được cài đặt:
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
      
    
    Nếu thấy kết quả tương tự như trong ví dụ sau, bạn có Thread mô-đun đã được cài đặt:
    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ó trong danh sách, thì có nghĩa là:

  1. Phiên bản Android của bạn đã lỗi thời. Hãy đảm bảo mã này Android O (8.1) trở lên.
  2. Chưa tải các mô-đun Matter xuống. Chờ ít nhất 24 giờ để tải xuống. Đảm bảo bạn đã bật nguồn thiết bị và sạc trong thời gian này, để quá trình tải xuống không bị trì hoãn. Nếu bạn chưa nhận đượ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 thiết bị để buộc tải mô-đun 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 có Số sê-ri và kiểu máy của thiết bị tới 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. Khi đã được đưa vào 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:
    • Từ 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), 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 hoa vân anh" 7 lần. Thao tác này sẽ bật 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ý của đố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:
    • Từ trung tâm, 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), hãy chuyển đế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ị để hiện trang thông tin 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 Thiết bị thông tin > Thông tin kỹ thuật > Địa chỉ IP
  4. Để truy xuất nhật ký từ trung tâm, bạn sẽ thực hiện yêu cầu GET HTTP tới trung tâm từ một máy tính sử dụng cùng 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 có thể được giữ mở chỉ trong 1 phút, nhưng dữ liệu được truy xuất từ vùng đệm thường có 20-30 phút của các sự kiện trong quá khứ.
      • 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 thành 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 của Android).

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

  • Dành cho quyền riêng tư và bảo mật, chỉ nên sử dụng tính năng này cho mục đích thử nghiệm 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ị 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ý đã loại bỏ dữ liệu cho TAM của bạn.
    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 hoạt động tích hợp với Google, bạn phải tạo một dự án và một công cụ tích hợp trên Google Home Console.

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

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 đượ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. Những cookie này có thể dùng để các thử nghiệm vận hành và kiểm soát cơ bản, nhưng không thể sử dụng chúng trong quá trình các giai đoạn phát triển sau:

Sử dụng một ứng dụng kỹ thuật Bluetooth, chẳng hạn như nRF Connect cho thiết bị di động, 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 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ụ. Biểu đồ này cho biết VID là 5A23 và PID là FFFE — cả ở định dạng nhỏ bé đuôi dài.

Ứ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 của mình là ở endian lớn.

Kiểm tra để đảm bảo bạn đã nhập đúng giá trị và định dạng vào Hành động Dự án trên bảng điều khiển dựa trên nội dung mà trình theo dõi Bluetooth đang 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à 235AFEFF.

Xác minh rằng thiết bị của bạn đã được tạo bằng 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 thử nghiệm với các bản dựng sử dụng cam kết từ nhánh ổn định v1.0-branch. Xem Bản phát hành công khai các lưu ý để biết các thay đổi cụ thể nên dùng với mỗi bản phát hành mới trên trung tâm.

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

Xác minh thông tin đăng nhập 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 đăng nhập chính xác trên thiết bị:

  • Bản khai báo chứng chỉ (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 bài kiểm thử thiết bị theo chuẩn Matter chứng chỉ.

Xác minh Thiết bị trung tâm theo chuẩn Matter

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

Một số trung tâm còn là Bộ định tuyến đường viền luồng từ đó hỗ trợ bạn phát triển và kiểm thử 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 của bạn để bật kết nối Thread.

Bạn có thể xác minh bản dựng trung tâm bằng cách: Trượt ngón tay xuống từ cạnh trên cùng > Vòng xoay 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 do lỗi "Không thể liên hệ với Google" thông báo lỗi

Đảm bảo rằng bạn đã tạo chế độ tích hợp với tổ hợp VID/PID chính xác trong Developer Console. Xem bài viết Tạo vấn đề tích hợp để biết thêm thông tin.

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

Nếu bạn tiếp tục nhận được thông báo "Không thể kết nối với thiết bị" khi vận hành Thread thiết bị và đã dùng hết tất cả bản gỡ lỗi hiện có , bạn có thể muốn xoá Thread ưa thích đã lưu trữ thông tin đăng nhập trên điện thoại Android của bạn để thiết lập sạch qua Cài đặt > Ứng dụng > Chiến dịch Quảng cáo ứng dụng > Dịch vụ Google Play > Lưu trữ và bộ nhớ đệm > Quản lý không gian > XÓA TẤT CẢ DỮ LIỆU.

Thử nghiệm

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

Nếu bạn đã ghép nối thiết bị với Mã nhà cung cấp (VID) và Mã sản phẩm (PID) thử nghiệm, nhưng nó không xuất hiện khi bạn cố gắng kiểm tra thiết bị bằng công cụ Kiểm tra SuiteDeveloper Console, nguyên nhân có thể là do 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 rồi ghép nối thiết bị bạn muốn kiểm tra lại.

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

Xem Thông tin thiết bị để biết thêm của bạn.

Nếu mọi thứ vẫn xảy ra

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

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ị của mình, dự án trên Play Console và môi trường. Khi có dữ liệu đó, hãy kiểm tra Trang hỗ trợ, để biết cách chia sẻ tốt nhất vấn đề của bạn với và nhóm hỗ trợ Google Home.