Materiali e note tecniche di accoppiamento rapido

Questa pagina descrive le informazioni utili di cui i partner hanno bisogno per la pianificazione dei progetti di accoppiamento rapido e per l'integrazione del sistema.

Materiali e procedura di accoppiamento rapido

Questa sezione fornisce link a informazioni generali sul marketing e sulla procedura.

Marketing, branding e messaggistica

Visita il nostro Partner Marketing Hub per indicazioni su branding e messaggistica. I nuovi partner devono richiedere l'accesso, mentre i partner esistenti possono già accedere ai contenuti tramite il loro account del dominio partner.

Ciclo di vita del progetto di accoppiamento rapido

Consulta la pagina Ruoli e responsabilità dell'integratore di sistemi per una descrizione di alto livello del ciclo di vita del progetto e delle responsabilità dei partner che integrano l'accoppiamento rapido in un prodotto.

Procedura di certificazione

I dispositivi che implementano l'accoppiamento rapido devono essere certificati prima che un prodotto possa essere commercializzato con questa funzionalità. Le Linee guida per la certificazione dell'accoppiamento rapido descrivono come prepararsi alla certificazione ed eseguire i test di autovalutazione pre-certificazione.

Le Domande frequenti sulla certificazione trattano una serie di domande comuni, inclusa una descrizione generale di quando è richiesta la certificazione completa (o la ricertificazione) .

Anche i dispositivi che implementano o utilizzano le estensioni di accoppiamento rapido, come il cambio audio, devono essere certificati. Il cambio audio ha Linee guida per la certificazione separate che descrivono i passaggi del test di autovalutazione e la preparazione per la certificazione di laboratori di terze parti.

I laboratori di terze parti possono certificare l'accoppiamento rapido e il cambio audio in sequenza. Consulta la pagina Spedizione di dispositivi a laboratori di terze parti per scoprire quali laboratori offrono quali servizi di certificazione.

Note tecniche

Questa sezione descrive alcune note tecniche sull'implementazione per aiutare i partner nello sviluppo e nell'integrazione.

Come pubblicizzare altri protocolli insieme all'accoppiamento rapido

Alcuni dispositivi potrebbero voler supportare funzionalità aggiuntive oltre all'accoppiamento rapido, come l'Assistente Google o Eddystone, che richiedono spazio pubblicitario aggiuntivo. La rotazione dei dati pubblicitari è l'opzione migliore in questi casi. Tuttavia, gli annunci di accoppiamento rapido devono comunque essere pubblicizzati entro l'intervallo pubblicitario in base alla modalità rilevabile e non rilevabile.

La rotazione degli annunci viene testata durante la fase di test di terze parti della procedura di certificazione. Assicurati di verificare eventuali schemi di rotazione con l'app di convalida dell'accoppiamento rapido prima della certificazione per evitare potenziali ritardi, nuovi test e costi.

Abbrevia l'intervallo di connessione BLE

Per migliorare il rendimento della creazione della connessione GATT, il fornitore deve rendere l'intervallo di connessione il più breve possibile. Il valore ottimale previsto è 7,5 ms, che viene applicato alla maggior parte dei cercatori.

Stato della connessione dell'annuncio BLE e delle cuffie

Se le cuffie con accoppiamento rapido pubblicizzano l'ID modello o i dati dell'account dipende dalla modalità rilevabile BR/EDR delle cuffie, non dallo stato di connessione o disconnessione. Fai riferimento alle specifiche del servizio di accoppiamento rapido dai link riportati di seguito:

• "Quando il dispositivo del fornitore è in modalità rilevabile BR/EDR (ovvero in modalità di accoppiamento), deve pubblicizzare i dati dell'ID modello di accoppiamento rapido tramite BLE." - link
• "Quando non è rilevabile (ovvero non in modalità di accoppiamento), il fornitore deve pubblicizzare i dati dell'account di accoppiamento rapido" - link

TxPower

Come definito nelle specifiche, il cercatore stima la distanza in base all'RSSI in base al livello di TxPower specificato. La distanza stimata è il fattore chiave per determinare se mostrare o meno la notifica.

La procedura per determinare TxPower è la seguente:

1. Misura l'output effettivo del dispositivo utilizzando uno smartphone Android a 1 metro di distanza, quindi aggiungi 41 dBm.
2. Includi questo valore nell'annuncio BLE.
3. Includi questo valore con le informazioni sullo smartphone di test nel report di autovalutazione.

Nota: il valore di TxPower memorizzato nella Device Console consente ai partner di aggiornare il valore di TxPower nei dispositivi spediti. L'invio di un valore di TxPower alla Device Console non è obbligatorio e qualsiasi valore nella Device Console sostituisce tutte le impostazioni di TxPower del dispositivo.

Misura e imposta TxPower con l'app di convalida

L'app di convalida fornisce un test per regolare manualmente TxPower al livello corretto su un dispositivo in test. I partner possono utilizzare questo test per determinare il livello di TxPower corretto sul dispositivo in test prima della diagnostica automatica o della certificazione.

Nota: al termine del test, ricordati di impostare il livello di TxPower sul dispositivo in test e nella Device Console.

Procedura di misurazione di TxPower

Per misurare TxPower con l'app di convalida:

1. Apri l'app di convalida sul dispositivo in test.
2. Apri il menu con tre puntini nella parte superiore dell'app:

   

3. Posiziona il dispositivo in test a 1 metro di distanza dallo smartphone e tocca il pulsante "AVVIA".

   

4. Seleziona il dispositivo in test dall'elenco dei dispositivi.

   

   1. Puoi aggiornare l'elenco dei dispositivi toccando il pulsante "ANNULLA" e selezionando di nuovo il pulsante "AVVIA".
5. Regola la linea rossa (che rappresenta TxPower) finché non tocca appena la parte superiore della regione gialla.

   

   1. Utilizza il pulsante "-1" per spostare la linea rossa verso la regione gialla.
   2. Utilizza il pulsante "+1" per allontanare la linea rossa dalla regione gialla.
   3. Le interferenze sul segnale potrebbero rendere instabile la linea rossa. Se la linea rossa si comporta in modo irregolare, prova a spostarti in un'area con meno interferenze sul segnale.
6. Salva il valore di TxPower e aggiornalo sia nel dispositivo in test sia nella Device Console.

   

Notifiche batteria

Come definito nelle specifiche, il fornitore può includere le informazioni sulla batteria nell'annuncio. Il cercatore decide se mostrare o nascondere la notifica della batteria in base al tipo, ovvero 0b0011 per mostrare la notifica della batteria o 0b0100 per nasconderla. Di seguito sono riportate alcune linee guida su quando includere le informazioni sulla batteria nell'annuncio e sul tipo da utilizzare:

1. Includi le informazioni sulla batteria nell'annuncio con la notifica della batteria 0b0011 per almeno 8 secondi quando la custodia è aperta e entrambi gli auricolari sono inseriti.
2. Includi le informazioni sulla batteria nell'annuncio con la notifica della batteria 0b0100 per almeno 5 secondi quando la custodia è chiusa ed entrambi gli auricolari sono inseriti.
3. Per mostrare o nascondere le notifiche della batteria in modo reattivo, l'annuncio deve riflettere lo stato reale entro 2 secondi.
4. Esistono due modi per nascondere la notifica della batteria:
   1. Smetti di includere le informazioni sulla batteria nell'annuncio. Il cercatore nasconde la notifica dopo un po' di tempo (attualmente impostato su 20 secondi).
   2. Includi le informazioni sulla batteria nell'annuncio con la notifica della batteria 0b0100. Il cercatore nasconde la notifica immediatamente dopo aver ricevuto l'annuncio.
5. È facoltativo includere le informazioni sulla batteria nell'annuncio se è inserito un solo auricolare quando la custodia è aperta o chiusa.
6. È facoltativo includere le informazioni sulla batteria nell'annuncio quando gli auricolari vengono rimossi dalla custodia o inseriti nella custodia.
7. Per evitare il monitoraggio, il fornitore deve includere solo i dati grezzi della batteria nell'annuncio quando necessario (non sempre).

L'implementazione deve essere descritta nel risultato del test di autovalutazione per la certificazione.

Come attivare la registrazione dell'accoppiamento rapido

Prima di eseguire il debug, assicurati di aver attivato il log di esame HCI Bluetooth sul dispositivo. Inoltre, per evitare che i log chiave di accoppiamento rapido vengano oscurati per motivi di sicurezza, unisciti al gruppo Google di test dei partner di accoppiamento rapido ([e-mail]) con i tuoi account Google di test.

Per acquisire i messaggi di accoppiamento rapido nei log di debug, esegui:

$ adb logcat -G 16M
$ adb shell setprop log.tag.NearbyMessages VERBOSE
$ adb shell setprop log.tag.NearbyDiscovery VERBOSE
$ adb shell setprop log.tag.FastPair VERBOSE

Google consiglia di eseguire i comandi precedenti in ogni sequenza di avvio.

Nota: i log VERBOSE potrebbero essere rimossi nelle build di produzione.

Come estrarre un log di debug

Esegui $ adb bugreport per generare un file zip che deve contenere tutti i dati. La generazione del file zip potrebbe richiedere alcuni minuti.

A seconda della versione di Android, esegui uno dei seguenti comandi per ottenere btsnoop_hic.log:

• Per Android 8.x e versioni successive: shell $ adb pull data/misc/bluetooth/logs logs
• Per Android 7.x: shell $ adb pull sdcard/btsnoop_hci.log

Nota: Google consiglia di lasciare lo smartphone accanto al dispositivo Bluetooth per alcuni minuti prima di tentare di scaricare il file zip del report sui bug.