Google Home Developer Console fornisce una pagina Test in cui puoi configurare ed eseguire test sull'integrazione Matter utilizzando Google Home Test Suite. Test Suite è un'applicazione separata integrata in Developer Console che gestisce tutti i test di integrazione.
I dispositivi per l'ID fornitore e l'ID prodotto dell'integrazione devono essere commissionati e disponibili in Google Home app (GHA) per l'account utilizzato con Developer Console per poter essere testati. Per ulteriori informazioni, vedi Accoppiare un dispositivo Matter.
Test Suite può essere eseguito su un insieme di dispositivi che appartengono a una specifica configurazione di progetto Matter. È molto importante eseguire Test Suite sulle integrazioni per assicurarsi che tutto funzioni correttamente.
Nella pagina Test, le integrazioni Matter completate e pronte per il test sono elencate in Pronte per il test.
Le integrazioni Matter che sono state testate sono elencate nella sezione Testate.
Tipo di piani di test
Esistono due tipi di piani di test:
I piani di test di sviluppo vengono utilizzati per testare il controllo dei dispositivi utilizzando Matter. Sono modificabili, ma non possono essere inviati per la certificazione Matter.
I piani di test di certificazione sono specifici per la certificazione Matter e non sono modificabili. Se selezioni questa opzione, verrà creata una nuova versione dell'integrazione con Matter.
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.
Le nuove versioni non vengono mai create da altre versioni numerate. Ad esempio, il primo piano di test creato per un'integrazione creerà la versione v.1 per quell'integrazione. La creazione di un altro piano di test creerà la versione v.2 per l'integrazione, ma questa versione non sarà basata sulla v.1. Questa versione si basa invece sull'istanza senza versione dell'integrazione, come in v.1.
La versione N/D di un'integrazione rappresenta l'istanza senza versione dell'integrazione, che viene gestita nella scheda Sviluppo.
In altre parole, su Matter > Test nella Developer Console:
- Se fai clic su Test per la versione N/D dell'integrazione, viene creata una nuova versione. Il numero di versione sarà di uno superiore a qualsiasi versione numerata 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 Test per una versione numerata dell'integrazione (ad esempio, v.1), non viene creata una nuova versione. La versione v.1 viene invece testata di nuovo.
Per ulteriori informazioni, consulta Controllo delle versioni dell'integrazione.
Creare un piano di test
Le versioni dell'integrazione sono uno snapshot di un'integrazione senza versione. Ciò significa che quando crei un piano di test per la certificazione, e quindi una versione di integrazione, tutti i metadati relativi a questa integrazione devono essere le informazioni che vuoi utilizzare per l'integrazione avviata.
Prima di creare un piano di test per la certificazione, assicurati di aver eseguito le seguenti operazioni:
- Hai creato un profilo aziendale.
- Inserisci l'ID fornitore di produzione (VID) per l'integrazione.
- Configurazione e branding configurati.
Se non hai completato tutte queste operazioni per l'integrazione, una versione dell'integrazione creata per i test di certificazione non può essere certificata. Dovrai creare una nuova versione, ovvero ripetere i passaggi di test, prova sul campo e certificazione.
Dovrai anche creare una nuova versione e ricominciare da capo se vuoi aggiornare il tuo branding prima che una versione di integrazione venga certificata.
Per creare un piano di test:
Nell'elenco dei progetti, fai clic su Apri accanto al progetto su cui vuoi lavorare.
Nel menu di navigazione sul lato sinistro della pagina, vai a Matter > Test.
Fai clic su Test per visualizzare la versione N/D dell'integrazione che vuoi testare. Questa azione crea una nuova versione dell'integrazione.
Seleziona un tipo di test di Test di sviluppo o Test di certificazione.
- Seleziona Test di certificazione se ti stai preparando per la certificazione nell'ecosistema Google.
- Non è possibile utilizzare un test di sviluppo per la certificazione.
Fai clic su Testa. Se visualizzi la schermata di errore Nessun dispositivo trovato, significa che un dispositivo per questa integrazione non è stato ancora commissionato nell'ecosistema. Per ulteriori informazioni, consulta la sezione Risolvere i problemi di accoppiamento.
Nella schermata Configura il test, assegna un nome al test e seleziona i dispositivi che vuoi testare dall'elenco dei dispositivi.
Fai clic sul pulsante Avanti: piano di test.
Nella pagina Crea un piano di test, seleziona nella sezione Suite di test le suite di test che vuoi eseguire.
Se vuoi uscire da Test Suite, fai clic su Torna al 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 del test vengono visualizzati al termine dei test. Lo stato di ogni esecuzione della suite di test viene visualizzato accanto all'esecuzione (Superata, Non riuscita).
Il riquadro Log mostra lo stato di ogni singola esecuzione del test.
Per ripetere il test di un piano dalla pagina Ambiente di test, fai clic su Ripeti il test in alto al termine dell'esecuzione del test.
Al termine:
- Fai clic su Fine per andare alla pagina Cronologia dei test oppure
- Fai clic su Invia per inviare i risultati del test per la certificazione.
Visualizzare e interpretare i risultati del test
Nella pagina Cronologia dei test in 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. Si aprirà la pagina Ambiente di test, in cui vengono visualizzati i risultati del test.
Per un piano di certificazione inviato, fai clic su Risultati nella sezione Salvati per la certificazione per visualizzare il report sui risultati del test.
È possibile accedere ai risultati del test per una versione dell'integrazione anche dalla scheda Test in Developer Console. Fai clic su Visualizza per visualizzare la Cronologia dei test di qualsiasi versione dell'integrazione elencata in questa pagina per accedere alla pagina Cronologia dei test in Test Suite.
Stati della console
Nella fase di test si verificano i seguenti stati di console:
| Sezione | Stato | Descrizione | Requisito | Passaggi successivi |
|---|---|---|---|---|
| Pronto per il test | Pronta | Questa versione dell' integration è pronta per essere testata. | N/A | Testa questa versione di integration. |
| Testata | Pronta | Questa versione della integration è stata testata e può essere inviata per la prova sul campo o la certificazione. |
La versione è stata testata e salvata. Tutti gli scenari di test non riusciti includono giustificazioni che Google deve esaminare. |
Esegui di nuovo il test, se vuoi. |
Risolvere i problemi
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 è probabilmente causato dall'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 saperne di più, consulta Informazioni del dispositivo.
Verifica il VID/PID del dispositivo
Se vuoi iniziare a sviluppare la tua integrazione con Google, devi creare un progetto e un'integrazione su Google Home Console.
Il valore VID/PID del beaconing del dispositivo deve corrispondere al VID/PID inserito nel progetto Developer Console.
- I VID
0xFFF1-0xFFF4sono riservati per i test. Possono essere utilizzati per i test di base per la messa in servizio e il controllo, ma non durante le seguenti fasi di sviluppo:
Utilizzando un'app di progettazione Bluetooth come nRF Connect for Mobile, puoi visualizzare il VID/PID del dispositivo di beaconing nel campo Dati di servizio.
In questo screenshot tratto dalla versione Android di nRF Connect, vedrai che il VID/PID è indicato 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 small endian.
L'app BLE mostra i valori in small endian, ma i valori VID/PID che inserisci nel progetto Developer Console sono in big endian.
Verifica che nel progetto della console Actions siano stati inseriti i valori e il formato corretti in base a ciò che mostra lo sniffer Bluetooth.
Per i valori nello screenshot di esempio, il VID e il PID in Developer Console sarebbero rispettivamente 235A e FEFF.