A partire dal 2026, tutti i test e l'integrazione di Matter richiederanno l'Interop Test dell'alleanza. Per ulteriori informazioni, consulta la pagina di transizione del laboratorio di test di interoperabilità di Alliance.

Risoluzione dei problemi relativi a Matter

Edificio

Verificare che lo smartphone sia compatibile

Tutti i dispositivi con Android O (8.1, livello API 27) e versioni successive sono compatibili con Matter. Segui i passaggi riportati di seguito per verificare se lo smartphone dispone dei moduli necessari.

Configurare Android Debug Bridge

Android Debug Bridge (adb) deve essere configurato prima della risoluzione dei problemi. Preparazione dell'Hangout:

Verificare i moduli Matter di Google Play Services (GPS)

Per verificare se hai i Google Play services Matter moduli:

Configura Android Debug Bridge.
Usa un cavo USB per collegare il telefono Android al computer.
Esegui questo comando in un terminale per verificare che i moduli necessari Matter siano installati:
```
  adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
  
```
Se vedi un output simile a quello riportato di seguito, significa che hai installato i moduli Matter:
```
com.google.android.gms.home [v222110900]
```
Tieni presente che il numero di versione riportato sopra potrebbe essere diverso da quello del tuo dispositivo.
Esegui questo comando in un terminale per verificare che i moduli necessari Thread siano installati:
```
  adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
  
```
Se vedi un output simile a quello riportato nell'esempio seguente, significa che hai installato i moduli Thread:
```
com.google.android.gms.threadnetwork [v222106301]
```
Tieni presente che il numero di versione sul tuo dispositivo potrebbe essere diverso.

Se i moduli non sono elencati, significa che:

Hai una versione Android obsoleta. Assicurati che sia Android O (8.1) o versioni successive.
I moduli Matter non sono ancora stati scaricati. Attendi almeno 24 ore per il download. Assicurati che il dispositivo sia acceso e in carica durante questo periodo, in modo che il download non venga ritardato. Se non hai ricevuto i moduli entro 24 ore, puoi provare a eseguire un ripristino dei dati di fabbrica del dispositivo per forzare il download dei moduli.

Verificare il VID/PID del dispositivo

Se vuoi iniziare a sviluppare la tua integrazione con Google, devi creare un progetto e un'integrazione nella Google Home Console.

Risoluzione dei problemi di Bluetooth Sniffer

Il valore VID/PID del beaconing del dispositivo deve corrispondere al valore VID/PID inserito nel progetto Google Home Developer Console.

I VID 0xFFF1 - 0xFFF4 sono riservati ai test. Possono essere utilizzati per i test di provisioning e controllo di base, ma non possono essere utilizzati durante le seguenti fasi di sviluppo:

Utilizzando un'app di progettazione Bluetooth come nRF Connect for Mobile, puoi visualizzare il VID/PID del dispositivo di beaconing nel campo Dati del servizio.

In questo screenshot della versione Android di nRF Connect, vedrai che il VID/PID è elencato come 5A23FFFE a partire dal quarto byte del campo Dati del servizio. Questo indica un VID di 5A23 e un PID di FFFE, entrambi in formato little endian.

L'app BLE mostra i valori in little endian, ma i valori VID/PID che inserisci nel progetto Developer Console sono in big endian.

Verifica che i valori e il formato corretti siano stati inseriti nel progetto della Actions Console in base a ciò che mostra lo sniffer Bluetooth.

Per i valori nello screenshot di esempio, il VID e il PID nella Developer Console sarebbero 235A e FEFF, rispettivamente.

Nota: il VID di 235A non deve più essere utilizzato nel progetto e viene utilizzato qui a scopo illustrativo. Assicurati di utilizzare un VID in base alla Matter specifica, o uno dei VID di test come indicato nella pagina Creare un'integrazione Matter.

Verificare che il dispositivo sia stato creato utilizzando un ramo SDK Matter compatibile

Gli hub Matter di Google sono compatibili con Matter 1.0 e sono stati testati con build che utilizzavano commit del ramo stabile v1.0-branch. Consulta le note di rilascio pubbliche per i commit specifici consigliati per l'utilizzo con ogni nuova release dell'hub.

Accoppiamento

Verificare le credenziali del dispositivo

Quando utilizzi il tuo Alliance-assigned VID, assicurati di avere le credenziali corrette sul dispositivo:

Dichiarazione di certificazione (CD).
Certificato di attestazione del dispositivo (DAC) e relativa catena di certificati.

Per saperne di più, consulta Creare certificati di test dei dispositivi Matter.

Verificare l'hub compatibile con Matter

L'Matter hub deve essere uno degli hub supportati da Google. Deve anche essere su una build compatibile con Matter.

Alcuni hub sono anche **router di confine Thread** e ti consentono quindi di sviluppare e testare i dispositivi Thread. Altri hub supportano solo i dispositivi Matter Wi-Fi ed Ethernet Matter, a meno che tu non abbia un altro router di confine nella rete per abilitare la connettività Thread.

La build dell'hub può essere verificata: scorri verso il basso dal bordo superiore > Rotella di configurazione > Informazioni sul dispositivo > Informazioni tecniche > Versione del firmware di Chromecast.

Il provisioning non riesce con il messaggio di errore "Impossibile contattare Google"

Assicurati di aver creato un'integrazione con la combinazione VID/PID corretta in the Developer Console. Per saperne di più, consulta Creare un'integrazione Matter.

Il provisioning non riesce con il messaggio di errore "Impossibile raggiungere il dispositivo"

Se continui a ricevere il messaggio di errore "Impossibile raggiungere il dispositivo" durante il provisioning di un Thread dispositivo, e hai esaurito tutte le opzioni di debug disponibili, puoi cancellare le credenziali Thread preferite memorizzate sullo smartphone Android per una configurazione pulita tramite Impostazioni > App > App > Google Play Services > Spazio di archiviazione e cache > Gestisci spazio > CANCELLA TUTTI I DATI.

Test

Il dispositivo di cui è stato eseguito il provisioning non viene visualizzato nella Test Suite

Se hai accoppiato un dispositivo con un ID fornitore (VID) e un ID prodotto (PID) di test, ma non viene visualizzato quando tenti di testare il dispositivo con la Test Suite in Developer Console, è probabile che tu abbia utilizzato la stessa combinazione di VID e PID di test in più integrazioni.

Per risolvere il problema, rimuovi tutti i dispositivi di test da Developer Console e accoppia il dispositivo che vuoi testare di nuovo.

Per verificare di aver accoppiato quello corretto, puoi impostare le informazioni su produttore e modello (valori CHIP_DEVICE_CONFIG_DEVICE_*) del dispositivo su valori univoci nel firmware di test.

Per saperne di più, consulta Informazioni sul dispositivo.

Se i problemi persistono

Se dopo aver seguito tutti i passaggi per la risoluzione dei problemi qui riportati il problema non è ancora stato risolto, non preoccuparti.

Nei passaggi per la risoluzione dei problemi hai raccolto dati importanti sul dispositivo, sul progetto della console e sull'ambiente. Con questi dati a portata di mano, consulta la pagina dell'assistenza per scoprire il modo migliore per condividere il tuo problema con la community e il team di assistenza di Google Home.