Risoluzione dei problemi relativi a Matter

Edificio

Verificare la compatibilità dello smartphone

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 sullo smartphone sono presenti 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 sullo smartphone Android.

Verificare i moduli Matter di Google Play Services (GPS)

Per verificare se hai i 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 i moduli Matter necessari siano installati: 
      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 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.
  4. Esegui questo comando in un terminale per verificare che i moduli Thread necessari siano installati: 
      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 dell'esempio seguente, 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:

  1. Hai una versione obsoleta di Android. Assicurati che sia Android O (8.1) o versioni successive.
  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 di tempo, 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.

Log del dispositivo hub Fuchsia

Per attivare 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) Google. Puoi trovarli in minuscolo sotto il dispositivo.
  2. Una volta inserita nella lista consentita, devi attivare 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 un Google Nest Hub (2nd gen), vai a Informazioni sul dispositivo > Informazioni tecniche > Versione Fuchsia
      4. Tocca 7 volte "Versione Fuchsia". In questo modo verranno attivate le opzioni sviluppatore
      5. Torna al menu di primo livello
      6. Tocca "Opzioni sviluppatore".
      7. Tocca "Log dei partner".
    • La funzionalità verrà attivata per 24 ore. Dopodiché, riattiva la funzionalità di logging dal passaggio 5 in poi.
  3. Ottieni l'indirizzo IP del tuo hub:
    • Dall'hub, se è dotato di schermo:
      1. Scorri verso il basso dalla parte superiore dello schermo.
      2. Tocca l'icona Impostazioni .
      3. Trova l'indirizzo IP del dispositivo: su un Nest Hub (2nd gen), vai a Informazioni sul dispositivo > Informazioni tecniche > Indirizzo IP
    • Da Google Home app (GHA) sullo smartphone:
      1. Tocca il dispositivo per visualizzare la relativa pagina dei dettagli
      2. Tocca l'icona Impostazioni per visualizzare la pagina delle impostazioni.
      3. Trova l'indirizzo IP del dispositivo: vai a Informazioni sul dispositivo > Informazioni tecniche > Indirizzo IP
  4. Per recuperare i log dall'hub, invia una richiesta HTTP GET all'hub da un computer connesso 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 hanno 20-30 minuti di eventi passati.
      • Idealmente, i log vengono estratti utilizzando questo metodo immediatamente dopo aver completato una procedura di test per assicurarsi che il buffer contenga contenuti pertinenti al test (in modo simile alle segnalazioni di bug di Android).

Disattivare l'oscuramento dei log Android

  • Per motivi di privacy e sicurezza, questa funzionalità deve essere utilizzata solo a scopo di test di ingegneria.
  • Non utilizzare questa opzione con dispositivi o utenti di produzione.
  • Passaggi:
    1. Invia gli Account Google degli utenti che avranno i log non oscurati al tuo TAM Google.
    2. Dopo aver ricevuto la conferma che il tuo account è stato aggiunto alla lista consentita, riavvia lo smartphone.

Verificare il VID/PID del dispositivo

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

Risoluzione dei problemi relativi a Bluetooth Sniffer

Il valore VID/PID trasmesso dal tuo 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 controllo e messa in servizio di base, ma non possono essere utilizzati durante le seguenti fasi di sviluppo:

Utilizzando un'app di ingegneria Bluetooth come nRF Connect per dispositivi mobili, puoi vedere il VID/PID del dispositivo beacon nel campo Dati di servizio.

In questo screenshot della versione Android di nRF Connect, vedrai che VID/PID è indicato come 5A23FFFE a partire dal quarto byte del campo Service Data. 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 inseriti nel progetto Developer Console sono in big endian.

Verifica che nel progetto Console di Actions siano stati inseriti i valori e il formato corretti in base a quanto mostrato dallo sniffer Bluetooth.

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

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

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 sulla release pubblica per i commit specifici consigliati per l'utilizzo 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).
  • Il certificato di attestazione del dispositivo (DAC) e la relativa catena di certificati.

Per ulteriori informazioni, vedi Creare certificati di test del dispositivo Matter.

Verificare l'hub compatibile con Matter

L'hub Matter deve essere uno degli hub supportati da Google. Inoltre, deve essere 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 Wi-Fi ed Ethernet Matter, a meno che non abbia un altro router di confine nella tua rete per attivare la connettività Thread.

Puoi verificare la build dell'hub: Scorri verso il basso dal bordo superiore > Ruota di configurazione > Informazioni del dispositivo > Informazioni tecniche > Versione del firmware di Chromecast

La messa in servizio non riesce con 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 riesce con 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 Thread preferite memorizzate sullo smartphone Android per una configurazione pulita tramite Impostazioni > App > App "App" > Google Play Services > Spazio di archiviazione e cache > Gestisci spazio > LIMPIA TUTTI I DATI.

Test

Il dispositivo commissionato non viene visualizzato nella suite di test

Se hai accoppiato un dispositivo con un ID fornitore (VID) e un ID prodotto (PID) di prova, ma non viene visualizzato quando provi a testare il dispositivo con Test Suite in Developer Console, è probabile che sia dovuto all'utilizzo della stessa combinazione di VID e PID di prova in più integrazioni.

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

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 la sezione Informazioni sul dispositivo.

Se i problemi persistono

Se dopo aver seguito tutti i passaggi per la risoluzione dei problemi descritti qui il problema persiste, non preoccuparti.

Durante la procedura di risoluzione dei problemi, hai raccolto dati importanti sul tuo dispositivo, sul progetto console e sull'ambiente. Una volta raccolti questi dati, consulta la pagina di assistenza per scoprire come condividere al meglio il problema con la community e il team di assistenza di Google Home.