Calibrazione della presenza

Questa pagina fornisce istruzioni di configurazione e calibrazione per i requisiti di calibrazione della presenza per i dispositivi con Android 14 e versioni successive.

Per garantire che gli smart device degli utenti funzionino bene insieme, è fondamentale che tutti i dispositivi dell'ecosistema Android possano determinare la vicinanza relativa tra i dispositivi. Android 14 introduce i requisiti di calibrazione della presenza che delineano le prestazioni accettabili delle tecnologie radio disponibili utilizzate per determinare la prossimità, come Ultra Wideband (UWB), Wi-Fi e Bluetooth Low Energy (BLE).

Dispositivo di riferimento

Per calibrare il dispositivo in modo che soddisfi i requisiti di presenza, utilizza uno dei seguenti dispositivi di riferimento per tutte le calibrazioni.

  • (Consigliato) Uno smartphone Pixel
  • Se non utilizzi uno smartphone Pixel, utilizza lo stesso modello di dispositivo di quello in fase di test.

Fattori di forma

La calibrazione della presenza è importante per i dispositivi Android di tutti i fattori di forma. Per i formati diversi dai cellulari, per determinare la configurazione di calibrazione appropriata per il dispositivo, considera come si posizionerebbe un utente che tiene in mano un cellulare (dispositivo di riferimento) quando interagisce con il dispositivo in fase di test (DUT). Ad esempio, quando calibri una TV, posiziona la TV e il cellulare a una distanza appropriata l'uno dall'altro e orienta il dispositivo mobile in modo che sia rivolto verso il centro anteriore dello schermo della TV.

Test di precisione del rilevamento della distanza

Per i dispositivi con Android 17 e versioni successive, il modulo CtsMultiDeviceGenericRangingAccuracyTests include scenari di test che verificano i requisiti di calibrazione della presenza in questa pagina. Questo modulo è un test multidevice lato host CTS Verifier (CTS-V) automatico che viene eseguito da un computer host connesso al DUT e al dispositivo di riferimento. Il modulo sostituisce i test di presenza manuali in CTS-V. Per i dispositivi con Android 16 e versioni precedenti, utilizza i test di presenza nelle release CTS e CTS-V per quella versione di Android.

Per eseguire i test di accuratezza del rilevamento:

  1. Configura la macchina host e CTS-V sul DUT e sul dispositivo di riferimento. Per maggiori dettagli, consulta Configura i test multi-dispositivo lato host.

  2. Posiziona il DUT e il dispositivo di riferimento a 1 metro di distanza, come descritto in Configura i test di accuratezza del rilevamento della distanza e nella configurazione della calibrazione per ogni tecnologia in questa pagina.

  3. Collega entrambi i dispositivi alla macchina host utilizzando i cavi USB.

  4. Dalla directory in cui hai decompresso il pacchetto CTS-V, avvia la console host CTS-V:

    ./android-cts-verifier/android-cts-v-host/tools/cts-v-host-tradefed
  5. Nella console host CTS-V, esegui i test di accuratezza del rilevamento della distanza:

    run cts-v-host -m CtsMultiDeviceGenericRangingAccuracyTests
    

    I risultati del test vengono visualizzati nell'app CTS-V sul DUT in Test lato host > Test UWB > CtsMultiDeviceGenericRangingAccuracyTests.

Ogni scenario di test nel modulo raccoglie le misurazioni utilizzando una tecnologia, calcola le metriche di accuratezza dalle misurazioni e le registra. Uno scenario di test viene superato se raccoglie correttamente le misurazioni, anche se le metriche non raggiungono i target. Per verificare la conformità, confronta le metriche registrate con i target descritti nelle sezioni seguenti. Se il DUT o il dispositivo di riferimento non supportano una tecnologia, lo scenario di test per quella tecnologia viene ignorato.

Requisiti UWB

Consulta la sezione 7.4.9 del CDD per i requisiti UWB.

Configurazione della calibrazione UWB

Utilizza la seguente configurazione per calibrare il dispositivo in modo che soddisfi i requisiti UWB.

Requisiti generali per la configurazione

  • Sono necessari due dispositivi con hardware UWB, uno come DUT e uno come dispositivo di riferimento.

  • Sono necessari due treppiedi per sostenere i dispositivi.

  • Il DUT e il dispositivo di riferimento devono essere posizionati a 1 metro di distanza l'uno dall'altro in un ambiente con linea di visuale in una camera non riflettente. Entrambi i dispositivi devono essere posizionati in orientamento verticale con lo schermo rivolto verso l'esterno.

Un esempio di configurazione della calibrazione UWB è mostrato nella Figura 1 e nel Video 1.

Configurazione di riferimento per la calibrazione BLE

Figura 1. Configurazione di riferimento per la calibrazione UWB.

Video 1. Configurazione di riferimento per la calibrazione UWB.

Verifica la conformità alle sezioni 7.4.9 [C-1-6] e [C-1-7] del CDD

Per verificare la conformità con il CDD 7.4.9 [C-1-6] e [C-1-7], esegui i test di accuratezza del rilevamento della distanza e controlla le metriche registrate dallo scenario di test test_uwb_ranging.

Lo scenario di test avvia una sessione di misurazione della distanza UWB tra il DUT e il dispositivo di riferimento ed esegue 1000 misurazioni con ogni dispositivo. Per le misurazioni di ogni dispositivo, lo scenario di test esegue le seguenti operazioni:

  1. Calcola l'intervallo come: intervallo = misurazione del 97,5° percentile - misurazione del 2,5° percentile. Per soddisfare il requisito, l'intervallo deve essere inferiore o uguale a 30 cm.

  2. Calcola la misurazione mediana. Per soddisfare il requisito, la mediana deve essere compresa tra 0,75 m e 1,25 m inclusi.

Requisiti di Neighbor Awareness Networking (NAN) Wi-Fi

Sezione 2.2.1 del CDD. Hardware include i requisiti per la conformità alla tecnologia Wi-Fi Neighbor Awareness Networking (NAN).

Verifica la conformità al CDD 2.2.1 [7.4.2.5/H-1-1]

Per verificare la conformità al CDD 2.2.1 [7.4.2.5/H-1-1], esegui i test di accuratezza del rilevamento e controlla le metriche registrate dallo scenario di test test_wifi_rtt_ranging.

Lo scenario di test avvia una sessione di misurazione della distanza Wi-Fi NAN tra il DUT e il dispositivo di riferimento e acquisisce 100 misurazioni Wi-Fi RTT. Lo scenario di test calcola quindi la percentuale di misurazioni che rientrano in un intervallo di ±2 m rispetto alla distanza effettiva di 1 m. Per soddisfare il requisito di larghezza di banda di 80 MHz, almeno il 68% delle misurazioni deve rientrare nell'intervallo di ±2 m.

Requisiti per l'RSSI BLE

Sezione 7.4.3 del CDD. Bluetooth include i requisiti per la conformità BLE RSSI.

Configurazione della calibrazione

Utilizza la seguente configurazione per calibrare il dispositivo in modo che soddisfi i requisiti BLE RSSI.

Requisiti generali per la configurazione

  • Per risultati ottimali, utilizza una camera anecoica per ridurre al minimo le interferenze con le misurazioni.

    Se non utilizzi una camera anecoica, configura un treppiede che sostiene il dispositivo di riferimento e un altro che sostiene il DUT a 1,5 metri da terra, con una distanza simile dal soffitto.

  • Prepara il dispositivo di riferimento e il dispositivo DUT:

    • Assicurati che entrambi i dispositivi siano sufficientemente carichi per completare i test.
    • Scollega entrambi i dispositivi durante il test.
    • Rimuovi tutte le cover, i cavi collegati e altri accessori che potrebbero influire sulle prestazioni della radiofrequenza (RF).
  • Collega ogni dispositivo a un treppiede con un supporto per dispositivi.

    • I treppiedi e i supporti per i dispositivi devono contenere meno metallo possibile.
    • Una piccola molla di metallo nei supporti per dispositivi non è un problema.
  • Rimuovi eventuali oggetti metallici tra i due dispositivi.

Configurazione di riferimento per la calibrazione BLE

Figura 2. Configurazione di riferimento per la calibrazione BLE.

Verifica la conformità al CDD 7.4.3 [C-10-1]

Per verificare la conformità con il CDD 7.4.3 [C-10-1], esegui i test di accuratezza del rilevamento con i dispositivi posizionati in base alla configurazione di calibrazione BLE e controlla le metriche registrate dallo scenario di test test_ble_rssi_ranging.

Lo scenario di test imposta il dispositivo di riferimento in modo che trasmetta l'annuncio a ADVERTISE_TX_POWER_HIGH e raccoglie 1000 scansioni sul DUT. Lo scenario di test calcola quindi l'intervallo del 95% centrale delle misurazioni RSSI. Per soddisfare il requisito, l'intervallo deve essere inferiore o uguale a 18 dB.

Verifica la conformità al CDD 7.4.3 [C-10-2]

Per verificare la conformità con il CDD 7.4.3 [C-10-2]: il fornitore del chip può misurare l'uniformità del canale e identificare le differenze tra core e canali.

Di seguito sono riportati alcuni suggerimenti su come identificare i problemi relativi a core e canali non calibrati, che sono due possibili cause di un'ampia diffusione dell'RSSI.

Core non calibrati

Se l'antenna Bluetooth di un dispositivo ha più core, questi potrebbero avere calibrazioni diverse. Esegui alcune misurazioni (per almeno 1 minuto) e controlla i dati della scansione. Se vedi un pattern simile a quello mostrato nella Figura 3, che presenta picchi regolari (come indicato dai cerchi) dovuti alla scansione su più core, è probabile che si sia verificato un problema con i core non calibrati e che siano necessarie ulteriori indagini.

Esempio di dati di scansione per un dispositivo con core non calibrati

Figura 3. Esempio di dati di scansione per un dispositivo con core non calibrati.

Canali non calibrati

Le trasmissioni su BLE classico avvengono su tre canali. Ogni canale potrebbe avere differenze associate. I canali vengono ruotati a intervalli fissi. Esegui alcune misurazioni (per almeno 1 minuto) e controlla i dati della scansione. Se vedi un pattern simile a quello mostrato nella Figura 4, è probabile che si sia verificato un problema di calibrazione errata su canali diversi e che siano necessarie ulteriori indagini.

Esempio di dati di scansione per un dispositivo con canali non calibrati

Figura 4. Esempio di dati di scansione per un dispositivo con canali non calibrati.

Verifica la conformità con CDD 7.4.3 [C-10-3] e [C-10-4]

Anche quando un chip radio BLE è perfettamente calibrato, l'RSSI osservato da un determinato dispositivo dipende dalla qualità e dalla posizione dell'antenna su quel particolare prodotto (modello del dispositivo). Questo rappresenta un problema per l'interoperabilità tra i dispositivi.

Ad esempio, considera un caso d'uso di apertura dell'auto. Uno sviluppatore di app potrebbe voler sbloccare un'auto quando il dispositivo si trova entro 1 metro dall'auto. Lo sviluppatore sceglie una soglia di -60 dBm in base alle sue osservazioni con uno smartphone in suo possesso, ma a causa delle differenze nella qualità e nel posizionamento dell'antenna, questa soglia potrebbe non funzionare bene con un altro dispositivo Android, anche se entrambi i dispositivi utilizzano lo stesso chip.

Per l'interoperabilità tra tutti i dispositivi dell'ecosistema, devi misurare l'offset Rx per ogni dispositivo e regolare l'RSSI riportato sul dispositivo per assicurarti che l'RSSI BLE soddisfi lo standard di 1 m a ADVERTISE_TX_POWER_HIGH.

Anche quando i chip radio BLE sono perfettamente calibrati, il ricevitore ideale legge un RSSI diverso a seconda della qualità e della posizione dell'antenna sul dispositivo di advertising. Il requisito Rx garantisce che tutti i dispositivi siano in grado di trasmettere con la stessa intensità risultante, a parità di condizioni.

Per verificare la conformità al requisito Rx e Tx:

  1. Posiziona il DUT a 1 m di distanza dal dispositivo di riferimento, seguendo la configurazione della calibrazione BLE. Ti consigliamo di orientare i dispositivi in modo che siano paralleli tra loro e con gli schermi rivolti nella stessa direzione.

  2. Esegui i test di accuratezza del rilevamento della distanza e controlla le metriche registrate dallo scenario di test test_ble_rx_tx_offset_precision.

    Lo scenario di test esegue i test Rx e Tx contemporaneamente e raccoglie 1000 scansioni per ogni test:

    • Rx: il DUT esegue la scansione mentre il dispositivo di riferimento trasmette a ADVERTISE_TX_POWER_HIGH.
    • Tx: il dispositivo di riferimento esegue la scansione mentre il DUT trasmette a ADVERTISE_TX_POWER_HIGH.

    Per soddisfare il requisito, l'RSSI mediano per i test Rx e Tx deve essere compreso tra -65 dBm e -45 dBm.

  3. Calibra i dispositivi per compensare l'offset Rx e la potenza Tx per garantire un RSSI mediano di -55 dBm.

    • Rx: regola l'RSSI impostando la proprietà di sistema bluetooth.hardware.radio.le_rx_path_loss_comp_db sul valore (dB) che compensa l'offset Rx per garantire un RSSI BLE mediano di -55 dBm a 1 m. Lo stack Bluetooth regola l'RSSI in modo che sia l'RSSI più il valore di bluetooth.hardware.radio.le_rx_path_loss_comp_db.

      Per maggiori dettagli, vedi le_scanning_manager.cc.

    • Tx: regola la potenza Tx impostando la proprietà di sistema bluetooth.hardware.radio.le_tx_path_loss_comp_db sul valore (dB) che compensa la potenza Tx per garantire un RSSI BLE mediano di -55 dBm a 1 m. Lo stack Bluetooth regola la potenza di trasmissione in modo che sia pari alla potenza di trasmissione più il valore di bluetooth.hardware.radio.le_tx_path_loss_comp_db.

      Per maggiori dettagli, vedi le_advertising_manager.cc.

Requisiti di BLE Channel Sounding

Sezione 7.4.3 del CDD. Bluetooth include i requisiti per l'accuratezza del Bluetooth Low Energy Channel Sounding (CS). Il requisito [C-11-2] specifica che i dispositivi che dichiarano FEATURE_BLUETOOTH_LE_CHANNEL_SOUNDING devono segnalare l'intervallo con precisione entro ±0,5 m al 90° percentile, calcolato con la funzione di distribuzione cumulativa (CDF), a una distanza di 1 m.

Verifica la conformità al CDD 7.4.3 [C-11-2]

Per verificare la conformità al CDD 7.4.3 [C-11-2], esegui i test di accuratezza del rilevamento con i dispositivi posizionati in base alla configurazione di calibrazione BLE e controlla le metriche registrate dallo scenario di test test_channel_sounding_ranging. Sia il DUT sia il dispositivo di riferimento devono supportare BLE CS.

Lo scenario di test associa il DUT e il dispositivo di riferimento tramite BLE, avvia una sessione di rilevamento della distanza BLE CS tra i due dispositivi ed esegue 100 misurazioni della distanza. Lo scenario di test calcola quindi la percentuale di misurazioni che rientrano in un intervallo di ±0,5 m rispetto alla distanza effettiva di 1 m. Per soddisfare il requisito, almeno il 90% delle misurazioni deve rientrare nell'intervallo ±0,5 m.