Risoluzione dei problemi relativi a Matter

In fase di creazione

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 controllare se lo smartphone ha i moduli necessari.

Configurare Android Debug Bridge

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

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

Verificare i moduli Matter di Google Play Services (GPS)

Per verificare se disponi dei moduli Google Play services Matter:

  1. Configura Android Debug Bridge.
  2. Usa un cavo USB per collegare lo 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 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 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 a quello dell'esempio seguente, significa che i moduli Thread sono installati: 
    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:

  1. Hai una versione di Android obsoleta. Assicurati che sia Android O (8.1) o superiore.
  2. 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, per evitare ritardi nel download. 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. Le puoi trovare in lettere minuscole sotto il dispositivo.
  2. Una volta inserita la funzionalità nella lista consentita, devi abilitare la funzionalità seguendo 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 "Versione Fucsia" 7 volte. Verranno attivate le opzioni sviluppatore
      5. Torna al menu di primo livello
      6. Tocca "Opzioni sviluppatore".
      7. Tocca "Registrazione partner"
    • La funzionalità sarà attivata per 24 ore. Dopodiché, riattiva la funzionalità di logging a partire dal passaggio 5.
  3. Individua l'indirizzo IP del tuo hub:
    • Dall'hub, se è presente 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 pagina dei dettagli del dispositivo.
      2. Tocca l'icona Impostazioni per visualizzare la pagina delle impostazioni
      3. Trova l'indirizzo IP del dispositivo: vai a Informazioni del dispositivo > Informazioni tecniche > Indirizzo IP
  4. Per recuperare i log dall'hub, dovrai effettuare una richiesta GET HTTP all'hub da un computer sulla 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 includono 20-30 minuti di eventi passati.
      • Idealmente, i log vengono estratti utilizzando questo metodo subito dopo aver completato una procedura di test per verificare che il buffer contenga contenuti pertinenti al test (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 per test tecnici.
  • Non utilizzare questa opzione con dispositivi di produzione o utenti.
  • Passaggi:
    1. Invia al tuo TAM Google gli Account Google degli utenti che avranno log non oscurati.
    2. Dopo aver confermato che l'account è stato aggiunto alla lista consentita, riavvia lo smartphone.

Verifica il VID/PID del dispositivo

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

Risoluzione dei problemi dello sniffer Bluetooth

Il valore del VID/PID su cui il dispositivo sta beacon deve corrispondere al valore VID/PID immesso nel progetto Google Home Developer Console.

  • I VID 0xFFF1: 0xFFF4 sono riservati per i test. Possono essere utilizzati per la messa in servizio di base e i test di controllo, ma non durante le seguenti fasi di sviluppo:

Con un'app di ingegneria Bluetooth come nRF Connect for Mobile, puoi visualizzare 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 5A23 e un PID di FFFE, entrambi in formato piccolo endian.

L'app BLE visualizza i valori in Littendian, ma i valori VID/PID inseriti nel progetto Developer Console sono in big endian.

Verifica di aver inserito i valori e il formato corretti nel progetto della console Azioni in base a ciò che viene visualizzato lo 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 dispositivo sia stato creato utilizzando un ramo compatibile con l'SDK Matter

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

Accoppiamento

Verifica le credenziali del tuo dispositivo

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

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

Per maggiori informazioni, consulta Creare certificati di test dei dispositivi Matter.

Verifica l'hub compatibile con Matter

L'hub Matter deve essere uno degli hub supportati da Google. Deve inoltre trovarsi in una build compatibile con Matter.

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

Per verificare la build dell'hub: Scorri il dito verso il basso dal bordo superiore > Rotellina della 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, vedi 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 tuo smartphone Android per una configurazione pulita tramite Impostazioni > App > App di app > Google Play Services > Spazio di archiviazione e cache > Gestisci spazio > CANCELLA TUTTI I DATI.

Test in corso

Il dispositivo commissionato non viene visualizzato 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 tenti di testare il dispositivo con la Test Suite in Developer Console, è probabile che il problema sia dovuto all'utilizzo della stessa combinazione 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 nuovamente.

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

Per ulteriori informazioni, consulta la sezione Informazioni del dispositivo.

Se il problema persiste

Se dopo aver seguito tutti i passaggi per la risoluzione dei problemi il problema persiste, non c'è problema.

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