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.

Configura Android Debug Bridge

È necessario configurare Android Debug Bridge (adb) prima di procedere alla 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 Matter Google Play services, procedi nel seguente modo:

  1. Configura Android Debug Bridge.
  2. Usa un cavo USB per collegare il tuo smartphone 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 visualizzi 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 riportato 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 visualizzi un output simile a quello nell'esempio seguente, hai installato i moduli Thread: 
    com.google.android.gms.threadnetwork [v222106301]
    Tieni presente che il numero di versione sul dispositivo potrebbe essere diverso.

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, in modo che il download non subisca ritardi. Se non hai ricevuto i moduli entro 24 ore, puoi provare a eseguire un ripristino dei dati di fabbrica del dispositivo per forzarne il download.

Log dispositivo hub Fuchsia

Per abilitare un hub per il recupero dei log locali:

  1. Invia un'email con il numero di serie e il modello dei tuoi dispositivi al tuo Technical Account Manager (TAM) di Google. Puoi trovarli in lettere minuscole sotto il dispositivo.
  2. Dopo aver inserito la funzionalità nella lista consentita, segui questi passaggi:
    • Dall'hub:
      1. Scorri verso il basso dalla parte superiore dello schermo.
      2. Tocca l'icona Impostazioni
      3. Trova la versione Fuchsia: su Google Nest Hub (2nd gen), vai a Informazioni del dispositivo > Informazioni tecniche > Versione Fuchsia
      4. Tocca 7 volte "Versione Fucsia". In questo modo verranno attivate le opzioni sviluppatore
      5. Torna al menu di primo livello
      6. Tocca "Opzioni sviluppatore".
      7. Tocca "Partner Logging" (Registrazione partner).
    • La funzionalità verrà attivata per 24 ore. In seguito, riattiva la funzionalità di logging dal passaggio 5 in poi.
  3. Recupera l'indirizzo IP dell'hub:
    • Dall'hub, se dispone di uno schermo:
      1. Scorri verso il basso dalla parte superiore dello schermo.
      2. Tocca l'icona Impostazioni
      3. Trova l'indirizzo IP del dispositivo: su Nest Hub (2nd gen), vai a Informazioni del dispositivo > Informazioni tecniche > Indirizzo IP
    • Da Google Home app (GHA) sul tuo smartphone:
      1. Tocca il dispositivo per visualizzare la relativa pagina dei dettagli.
      2. Tocca l'icona Impostazioni per aprire la pagina delle impostazioni
      3. Per trovare l'indirizzo IP del dispositivo, vai a Informazioni sul dispositivo > Informazioni tecniche > Indirizzo IP.
  4. Per recuperare i log dall'hub, dovrai inviare una richiesta HTTP GET all'hub da un computer collegato alla stessa rete Wi-Fi.
    • Prendi nota della porta e del percorso dell'endpoint: 
      curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
    • La connessione può essere mantenuta aperta per un solo minuto, ma i dati recuperati dal buffer di solito comprendono 20-30 minuti di eventi passati.
      • Idealmente, i log vengono estratti con questo metodo immediatamente dopo aver completato una procedura di test per garantire che nel buffer siano presenti contenuti pertinenti per il test (in modo simile alle segnalazioni di bug di Android).

Disattiva l'oscuramento dei log di Android

  • Per motivi di privacy e sicurezza, questa funzionalità deve essere utilizzata solo a scopo di test ingegneristico.
  • Non utilizzare questa opzione con utenti o dispositivi di produzione.
  • Passaggi:
    1. Invia al tuo TAM di Google gli Account Google degli utenti che avranno i log non oscurati.
    2. Dopo la conferma dell'aggiunta del tuo account alla lista consentita, riavvia il telefono.

Verifica il VID/PID del tuo 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 relativi allo sniffer Bluetooth

Il valore VID/PID che il tuo dispositivo sta eseguendo il beaconing deve corrispondere al VID/PID inserito nel tuo progetto Google Home Developer Console.

  • I VID 0xFFF1 - 0xFFF4 sono riservati ai test. Possono essere utilizzati per i test di base della messa in servizio e del controllo, ma non è possibile utilizzarli durante le seguenti fasi di sviluppo:

Utilizzando un'app di progettazione del Bluetooth come nRF Connect for Mobile, puoi vedere il VID/PID del dispositivo di beaconing nel campo Dati di 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 di servizio. Questo indica un VID pari a 5A23 e un PID pari a 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 di aver inserito i valori e il formato corretti nel progetto Actions Console in base a quanto visualizzato dallo sniffer Bluetooth.

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

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

Gli hub Matter di Google sono 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

Verifica 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 saperne di più, consulta Creare certificati di test dei 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 e quindi ti consentono di sviluppare e testare i 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 il 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 saperne di più, 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, ti consigliamo di cancellare le credenziali di Thread preferite memorizzate sul telefono Android per una configurazione pulita 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 è dovuto probabilmente all'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 ulteriori informazioni, consulta Informazioni del dispositivo.

Se il problema persiste

Se dopo avere seguito tutti i passaggi per la risoluzione dei problemi il tuo problema non è ancora risolto, non c'è problema.

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