Risoluzione dei problemi relativi a Matter

Edificio

Verifica che il tuo smartphone sia compatibile

Tutti i dispositivi Android O (8.1, livello API 27) e versioni successive sono compatibile con Matter. Segui i passaggi riportati di seguito per verificare se lo smartphone disponga dei 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 tuo computer.
  2. Attiva le Opzioni sviluppatore e USB Debug sul tuo telefono Android.

Verificare i moduli Matter di Google Play Services (GPS)

Per verificare se disponi dell'Google Play services Matter moduli, procedi nel seguente modo:

  1. Configura Android Debug Bridge.
  2. Usa un cavo USB per collegare il tuo smartphone Android alla computer.
  3. Esegui questo comando in un terminale per verificare che sia necessario Matter moduli installati: 
      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 Matter moduli 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 sia necessario Thread moduli 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 dell'esempio seguente, Thread moduli 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 prima che vengano scaricati. 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 ripristinare i dati di fabbrica del dispositivo per forzare il download dei moduli.

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 nella lista consentita, devi abilitare la funzionalità seguendo questa procedura:
    • 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. Ottieni 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. Per trovare l'indirizzo IP del dispositivo, vai a Dispositivo informazioni > 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 la privacy e sicurezza, questa funzione deve essere usata soltanto a scopo di test tecnico.
  • 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 una progetto e un'integrazione nella console Google Home.

Risoluzione dei problemi dello sniffer Bluetooth

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

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

Tramite un'app di ingegneria Bluetooth come nRF Connect per dispositivi mobili, 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 di nel campo Dati dei servizi. Indica un VID di 5A23 e un PID di FFFE — entrambi in formato piccolo endian.

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

Verifica di aver inserito i valori e il formato corretti nelle azioni Progetto della console basato su ciò che mostra lo sniffer Bluetooth.

Per i valori nello screenshot di esempio, il VID e il PID nella Developer Console corrisponderebbe rispettivamente a 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 dal ramo stabile v1.0-branch. Seleziona la release pubblica note per i commit specifici consigliati per l'utilizzo con ogni nuova uscita 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 saperne di più, consulta Creare un test dispositivo Matter certificati.

Verifica l'hub compatibile con Matter

L'hub Matter deve essere uno degli hub supportati da Google, Deve inoltre trovarsi creazione compatibile con Matter.

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

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

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

Assicurati di aver creato un'integrazione con la combinazione VID/PID corretta in Developer Console. Vedi Creare una pratica integrazione per ulteriori informazioni.

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

Se continui a ricevere il messaggio "Impossibile raggiungere il dispositivo" durante la messa in servizio Thread dispositivo e hai esaurito tutte le funzionalità di debug disponibili opzioni, è consigliabile cancellare i Thread preferiti memorizzati sul tuo telefono Android per una configurazione semplice in Impostazioni > App > App di > Google Play Services > Archiviazione e Cache > Gestisci spazio > CANCELLA TUTTI I DATI.

Test

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 prova, ma non viene visualizzata quando tenti di testare il dispositivo con Suite in Developer Console, la causa potrebbe essere utilizzando la stessa combinazione di VID e PID di test in più integrazioni.

Per risolvere i problemi, rimuovi tutti i dispositivi di test da Developer Console ed esegui l'accoppiamento il dispositivo che vuoi testare di nuovo.

Per verificare di aver accoppiato quello corretto, puoi impostare i campi Manufacturer e Informazioni sul modello (CHIP_DEVICE_CONFIG_DEVICE_* valori) per il dispositivo valori univoci nel firmware di test.

Per ulteriori informazioni, consulta Informazioni del dispositivo. informazioni.

Se il problema persiste

Se dopo aver seguito tutti i passaggi per la risoluzione dei problemi il problema persiste, risolto, nessun problema.

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