Risoluzione dei problemi relativi a Matter

Costruiamo

Verifica che il tuo smartphone sia compatibile

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

Configurare Android Debug Bridge

È necessario configurare Android Debug Bridge (adb) prima della risoluzione dei problemi. Preparazione dell'Hangout:

  1. Installa "adb" sul computer.
  2. Attiva le Opzioni sviluppatore e il debug USB sul tuo telefono Android.

Verificare i moduli Matter di Google Play Services (GPS)

Per verificare se hai i moduli Google Play services Matter, procedi nel seguente modo:

  1. Configura Android Debug Bridge.
  2. Utilizza un cavo USB per collegare il telefono Android al computer.
  3. Esegui questo comando in un terminale per verificare che siano installati i moduli Matter necessari: 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
    Se vedi un output simile al seguente, significa che i moduli Matter sono installati: 
    com.google.android.gms.home [v222110900]
    Tieni presente che il numero di versione indicato sopra potrebbe essere diverso dal tuo dispositivo.
  4. Esegui questo comando in un terminale per verificare che siano installati i moduli Thread necessari: 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
    Se vedi un output simile al seguente, significa che i moduli Thread sono installati: 
    com.google.android.gms.threadnetwork [v222106301]
    Tieni presente che il numero di versione indicato sopra potrebbe essere diverso dal tuo dispositivo.

Se i moduli non sono elencati, significa che:

  1. Hai una versione obsoleta di Android. Assicurati che sia Android O (8.1) o superiore.
  2. I moduli Matter non sono stati ancora scaricati. Attendi almeno 24 ore per il download. Assicurati che il dispositivo sia acceso e in carica durante questo periodo di tempo, in modo che il download non subisca ritardi. Se non hai ricevuto i moduli entro 24 ore, puoi provare a ripristinare i dati di fabbrica del dispositivo per forzare il download dei moduli.

Verifica il VID/PID del dispositivo

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

Risoluzione dei problemi dello sniffer Bluetooth

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

  • I VID 0xFFF1 - 0xFFF4 sono riservati per i test. Possono essere utilizzati per i test di base per la messa in servizio e il controllo, ma non 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 di servizio.

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

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

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

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

Verifica che il tuo dispositivo sia stato creato utilizzando un ramo compatibile con l'SDK Matter

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

Accoppiamento

Verificare le credenziali del dispositivo

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

  • Dichiarazione di certificazione (CD).
  • Device Attestation Certificate (DAC) e la relativa catena di certificati.

Per ulteriori informazioni, consulta Creare certificati di test per i dispositivi Matter.

Verificare l'hub compatibile con Matter

L'hub Matter deve essere uno degli hub supportati da Google. Inoltre, deve trovarsi su una build compatibile con Matter.

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

La build dell'hub può essere verificata tramite: Fai scorrere un dito verso il basso dal bordo superiore > Ruota di configurazione > Informazioni sul dispositivo > Informazioni tecniche > Versione firmware di Chromecast

La messa in servizio non va a buon fine e viene visualizzato il messaggio di errore "Impossibile contattare Google"

Assicurati di aver creato un'integrazione con la combinazione VID/PID corretta in Developer Console. Per ulteriori informazioni, consulta Creare un'integrazione Matter.

La messa in servizio non va a buon fine e viene visualizzato il messaggio di errore "Impossibile raggiungere il dispositivo"

Se continui a ricevere il messaggio di errore "Impossibile raggiungere il dispositivo" durante la messa in servizio di un dispositivo Thread e hai esaurito tutte le opzioni di debug disponibili, potresti cancellare le credenziali di Thread preferite memorizzate sul tuo telefono Android per eseguire la configurazione in Impostazioni > App > App app > Google Play Services > Spazio di archiviazione e cache > Gestisci spazio > CANCELLA TUTTI I DATI.

Test

Il dispositivo commissionato non compare nel Test Suite

Se hai accoppiato un dispositivo con un ID fornitore (VID) e un ID prodotto (PID) di test, ma questo non viene visualizzato quando provi a testare il dispositivo con il Test Suite in Developer Console, il problema è probabilmente causato dall'utilizzo della 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 sul produttore e sul modello (valori CHIP_DEVICE_CONFIG_DEVICE_*) del dispositivo su valori univoci nel firmware di test.

Per saperne di più, consulta Informazioni del dispositivo.

Se il problema persiste

Se dopo aver seguito tutti questi passaggi il problema persiste, non c'è problema.

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