Testare un'integrazione Matter

Google Home Developer Console fornisce una pagina Test in cui puoi configurare ed eseguire test sull'integrazione di Matter utilizzando Google Home Test Suite. Test Suite è un'applicazione separata integrata in Developer Console che gestisce tutti i test di integrazione.

Per poter essere testati, i dispositivi per l'ID fornitore e l'ID prodotto dell'integrazione devono essere messi in servizio e disponibili in Google Home app (GHA) per l'account utilizzato con il Developer Console. Per ulteriori informazioni, consulta Accoppiare un dispositivo Matter.

Test Suite può essere eseguito su un insieme di dispositivi che appartengono a una configurazione del progetto Matter specifica. È molto importante eseguire Test Suite sulle tue integrazioni per assicurarti che tutto funzioni correttamente.

Nella pagina Test, le Matter integrazioni complete e pronte per il test sono elencate in Pronto per il test.

Le integrazioni Matter che sono state testate sono elencate nella sezione Testato.

Tipi di piani di test

Esistono due tipi di piani di test:

  • I piani di test di sviluppo vengono utilizzati per testare i dispositivi di controllo utilizzando Matter. Sono modificabili, ma non possono essere inviati per la certificazione Matter.

  • I piani di test Certificazione sono specifici per la certificazione Matter e non sono modificabili. Se selezioni questa opzione, verrà creata una nuova versione dell'integrazioneMatter.

Utilizza Test Suite in Developer Console per inviare i risultati del test per la certificazione. Se vuoi eseguire Test Suite a scopo di test durante lo sviluppo, consulta la pagina Google Home Test Suite per la versione autonoma.

Versioni delle integrazioni

Quando crei un piano di test per la certificazione, viene creata una nuova versione dell'integrazione. Questa versione numerata è elencata in tutti gli elenchi di integrazione in Developer Console a partire dalla scheda Test.

Non vengono mai create nuove versioni da altre versioni numerate. Ad esempio, il primo piano di test che crei per un'integrazione creerà la versione v.1 per quell'integrazione. La creazione di un altro piano di test comporterà la creazione della versione v.2 per quell'integrazione, ma questa versione non sarà basata sulla v.1. Questa versione, invece, si basa sull'istanza non versione dell'integrazione, come la v.1.

La versione N/A di un'integrazione rappresenta l'istanza non versione dell'integrazione, gestita nella scheda Sviluppa.

In altre parole, in Matter > Test in Developer Console:

  • Se fai clic su Testa per la versione N/A dell'integrazione, viene creata una nuova versione. Il numero della versione sarà superiore a quello di tutte le versioni con numero esistente.
    • Se non esistono versioni numerate, viene creata la versione v.1.
    • Se esiste la versione v.1, viene creata la versione v.2. Se esiste la versione v.2, viene creata la versione v.3 e così via.
  • Se fai clic su Testa per una versione numerata dell'integrazione (ad esempio v.1), non viene creata una nuova versione. Viene invece nuovamente testata la versione v.1.

Per ulteriori informazioni, consulta la sezione Controllo delle versioni dell'integrazione.

Creare un piano di test

Le versioni delle integrazioni sono uno snapshot di un'integrazione non versione. Ciò significa che quando crei un piano di test per la certificazione e, di conseguenza, una versione di integrazione, tutti i metadati relativi a quell'integrazione devono essere le informazioni che vuoi utilizzare per l'integrazione lanciata.

Prima di creare un piano di test per la certificazione, assicurati di aver eseguito quanto segue:

  1. Hai creato un profilo dell'azienda.
  2. È stato inserito l'ID fornitore (VID) di produzione per l'integrazione.
  3. Configurazione e branding configurati.

Se non hai completato tutti questi passaggi per l'integrazione, una versione dell'integrazione creata per i test di certificazione non può essere certificata. Dovrai creare una nuova versione, il che significa ripetere i passaggi di test, prova sul campo e certificazione.

Dovrai anche creare una nuova versione e ricominciare se vuoi aggiornare il branding prima che una versione dell'integrazione venga certificata.

Per creare un piano di test:

Vai a Developers Console

  1. Nell'elenco dei progetti, fai clic su Apri accanto al progetto con cui vuoi lavorare.

  2. Nel menu di navigazione a sinistra della pagina, vai a Matter > Test.

  3. Fai clic su Testa per la versione N/D dell'integrazione che vuoi testare. Questa azione crea una nuova versione dell'integrazione.

  4. Seleziona un tipo di test tra Test di sviluppo o Test di certificazione. Creazione di un nuovo piano di test

    • Seleziona Test di certificazione se ti stai preparando per la certificazione nell'ecosistema Google.
    • Un test di sviluppo non può essere utilizzato per la certificazione.
  5. Fai clic su Testa. Se viene visualizzata la schermata di errore Nessun dispositivo trovato, significa che non è stato ancora commissionato un dispositivo per questa integrazione nell'ecosistema. Per ulteriori informazioni, consulta la sezione Risoluzione dei problemi relativi all'accoppiamento.

  6. Nella schermata Configura il test, assegna un nome al test e seleziona i dispositivi che vuoi testare dall'elenco.

  7. Fai clic sul pulsante Passaggio successivo: piano di test.

  8. Nella pagina Crea un piano di test, seleziona le suite di test che vuoi eseguire nella sezione Suite di test.

Creare un piano di test Se vuoi uscire da Test Suite, fai clic su Torna a Developer Center.

Esegui il piano di test

In Test Suite, nella pagina Crea un piano di test, fai clic su Esegui test. Viene visualizzata la pagina Ambiente di test, con lo stato e i log di tutti i test.

I risultati dei test vengono visualizzati al termine dei test. Accanto a ogni esecuzione della suite di test viene visualizzato lo stato (Superato, Non superato).

Il riquadro Log mostra lo stato di ogni singola esecuzione del test.

Risultati del test Per ripetere un piano di test dalla pagina Ambiente di test, fai clic su Ripeti in alto dopo il completamento dell'esecuzione del test.

Al termine:

Visualizzare e interpretare i risultati dei test

Nella pagina Cronologia test di Test Suite, puoi visualizzare i risultati dei test precedenti per un piano di sviluppo o un piano di test di certificazione non inviato facendo clic su Esegui di nuovo il test per il piano di test desiderato nella sezione Piani di test. Viene visualizzata la pagina Ambiente di test, che mostra i risultati del test.

Cronologia dei test

Per un piano di certificazione inviato, fai clic su Risultati nella sezione Salvato per la certificazione per visualizzare il report sui risultati dei test.

È possibile accedere ai risultati dei test anche per una versione di integrazione dalla scheda Test in Developer Console. Fai clic su Visualizza per la Cronologia dei test di qualsiasi versione di integrazione elencata in quella pagina per accedere alla pagina Cronologia dei test in Test Suite.

Stati della console

Nella fase di test vengono rilevati i seguenti stati della console:

Sezione Stato Descrizione Requisito Passaggi successivi
Pronto per il test Pronto Questa versione di integration è pronta per essere testata. N/D Testa questa versione di integration.
Testata Pronto Questa versione del integration è stata testata e può essere presentata per la sperimentazione sul campo o la certificazione.

La versione è stata testata e salvata.

Tutti i casi di test non riusciti includono giustificazioni per la revisione da parte di Google.

Esegui nuovamente il test, se vuoi.

Risoluzione dei problemi

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.

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 valore VID/PID inserito nel progetto 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.