Tạo dựng
Xác minh rằng điện thoại của bạn tương thích
Tất cả 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 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:
- Cài đặt "adb" trên máy tính của bạn.
- 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 Google Play services Matter mô-đun hay không, hãy làm như sau:
- Thiết lập Cầu gỡ lỗi Android.
- Kết nối điện thoại Android với máy tính bằng cáp USB.
- Chạy lệnh này trong một thiết bị đầu cuối để xác minh rằng các mô-đun cần thiết
Matter đã được cài đặt:
adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"com.google.android.gms.home [v222110900]
- Chạy lệnh này trong một thiết bị đầu cuối để xác minh rằng các mô-đun cần thiết
Thread đã được cài đặt:
adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"com.google.android.gms.threadnetwork [v222106301]
Nếu các mô-đun không xuất hiện, thì có nghĩa là:
- Bạn đang dùng phiên bản đã lỗi thời.Android Hãy đảm bảo rằng đó là Android O (8.1) trở lên.
- Các mô-đun Matter chưa được tải xuống. Hãy đợi ít nhất 24 giờ để các mô-đun này tải xuống. Đảm bảo rằng thiết bị của bạn đã được bật nguồn và đang sạc trong thời gian này để quá trình tải xuống không bị chậm trễ. Nếu bạn chưa nhận được các mô-đun trong vòng 24 giờ, bạn có thể thử đặt lại 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 quá trình tích hợp với Google, bạn phải tạo một dự án và một quá trình tích hợp trên Google Home Console.
Giá trị VID/PID mà thiết bị của bạn đang phát tín hiệu phải khớp với VID/PID đã nhập vào dự án Google Home Developer Console.
- VID
0xFFF1–0xFFF4được dành riêng cho quá trình kiểm thử. Bạn có thể sử dụng các VID này cho quá trình đưa vào hoạt động và kiểm soát 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 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ị ở định dạng little endian, nhưng các giá trị VID/PID bạn nhập vào dự án Developer Console ở định dạng big endian.
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 những gì công cụ theo dõi 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à 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 Google Matter tương thích với
Matter 1.0 và đã được kiểm thử với các bản dựng sử dụng
các cam kết từ nhánh ổn định v1.0-branch. Hãy xem Ghi chú về bản phát hành công khai
để biết các cam kết 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ố về 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 các trung tâm được Google hỗ trợ. Trung tâm này cũng phải ở 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 sử dụng giao thức Thread , do đó cho phép bạn phát triển và kiểm thử các thiết bị Thread. 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 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 > Bánh răng 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
Quá trình đưa vào hoạt động không thành công với thông báo lỗi "Không liên hệ được với Google"
Đảm bảo rằng bạn đã tạo một quá trình 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.
Quá trình đưa vào hoạt động không thành công với thông báo lỗi "Không kết nối được với thiết bị"
Nếu bạn liên tục nhận được thông báo lỗi "Không kết nối được với thiết bị" khi đưa một thiết bị Thread vào hoạt động và đã sử dụng hết tất cả các lựa chọn gỡ lỗi hiện có, bạn có thể muố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 một cách sạch sẽ thông qua Cài đặt > Ứng dụng > Ứng dụng > Dịch vụ Google Play > Bộ nhớ và bộ nhớ đệm > Quản lý dung lượng > XOÁ TOÀN BỘ DỮ LIỆU.
Thử nghiệm
Thiết bị đã đưa vào hoạt động không xuất hiện trong Bộ kiểm thử
Nếu bạn đã ghép nối một thiết bị với Mã nhà cung cấp (VID) và Mã sản phẩm (PID) kiểm thử, nhưng thiết bị đó không xuất hiện khi bạn cố gắng kiểm thử thiết bị bằng Bộ kiểm thử trong Developer Console, thì nguyên nhân có thể là do bạn sử dụng cùng một tổ hợp VID và PID kiểm thử trên nhiều quá trình tích hợp.
Để khắc phục sự cố, hãy xoá tất cả thiết bị kiểm thử khỏi Developer Console rồi ghép nối lại thiết bị mà 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à Kiểu máy (các giá trị CHIP_DEVICE_CONFIG_DEVICE_*) cho thiết bị thành các giá trị riêng biệt trong chương trình cơ sở kiểm thử.
Hãy xem phần 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ố tại đây mà vấn đề của bạn vẫn chưa được giải quyết, đừng lo lắng!
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 của mình. Với dữ liệu đó, hãy kiểm tra trang Hỗ trợ để biết cách chia sẻ vấn đề của bạn một cách hiệu quả nhất với cộng đồng và nhóm hỗ trợ Google Home.