Calibración de presencias

En esta página, se proporcionan instrucciones de configuración y calibración para los requisitos de calibración de presencia de dispositivos que ejecutan Android 14 y versiones posteriores.

Segundo plano

Para garantizar que los dispositivos inteligentes de los usuarios funcionen bien en conjunto, es fundamental que todos los dispositivos del ecosistema de Android puedan determinar la proximidad relativa entre ellos. En Android 14, se introducen requisitos de calibración de presencias que describen el rendimiento aceptable de las tecnologías de radio disponibles, como UWB, Wi-Fi y BLE, que se usan para determinar la proximidad. En esta página, se describen los estándares de calibración que deben seguir los dispositivos para garantizar la interoperabilidad entre dispositivos del ecosistema.

Dispositivo de referencia

Para calibrar tu dispositivo y que cumpla con los requisitos de presencia, usa uno de los siguientes dispositivos de referencia para todas las calibraciones.

  • (Recomendado) Un teléfono Pixel
  • Si no usas un teléfono Pixel, usa el mismo modelo y marca que el dispositivo que se está probando.

Factores de forma

La calibración de presencia es importante para los dispositivos Android de todos los factores de forma. En el caso de otros factores de forma que no sean teléfonos celulares, para determinar la configuración de calibración adecuada del dispositivo, considera cómo se posicionaría un usuario que sostiene un teléfono celular (dispositivo de referencia) cuando interactúe con el dispositivo en prueba (DUT). Por ejemplo, cuando calibres una TV, colócalas a una distancia adecuada entre sí y orienta el dispositivo móvil de modo que apunte hacia el centro frontal de la pantalla de la TV.

Requisitos de UWB

En esta sección, se describe cómo calibrar tu dispositivo para que cumpla con los siguientes requisitos de UWB en el CDD.

UWB 7.4.9

Si las implementaciones de dispositivos incluyen hardware UWB, tienen las siguientes características:

  • [C-1-6] DEBE garantizar que las mediciones de distancia estén dentro de +/-15 cm para el 95% de las mediciones en el entorno de línea de visión a 1 m de distancia en una cámara no reflectante.
  • [C-1-7] DEBE garantizar que la mediana de las mediciones de distancia a 1 m del dispositivo de referencia esté dentro de [0.75 m, 1.25 m], donde la distancia de verdad fundamental se mide desde el borde superior del DUT sostenido hacia arriba y con una inclinación de 45 grados.

Configuración de calibración de UWB

Usa la siguiente configuración para calibrar el dispositivo de modo que cumpla con los requisitos de UWB.

Requisitos generales de configuración

  • Se requieren dos dispositivos con hardware de UWB: uno como DUT y otro como dispositivo de referencia.

  • Se requieren dos trípodes para sostener los dispositivos.

  • El DUT y el dispositivo de referencia deben colocarse a 1 metro de distancia en un entorno de línea de visión en una cámara no reflectante. Ambos dispositivos deben colocarse en orientación vertical con la pantalla mirando hacia afuera.

En la Figura 1 y el video 1, se muestra un ejemplo de configuración de calibración de UWB.

Configuración de referencia para la calibración BLE

Figura 1: Configuración de referencia para la calibración de UWB.

Video 1: Configuración de referencia para la calibración de UWB.

Requisitos [C-1-6] y [C-1-7]

Para verificar el cumplimiento de los requisitos [C-1-6] y [C-1-7], ejecuta el caso de prueba de CTS para varios dispositivos RangingMeasurementTest#test_distance_measurement_accuracy para la medición de distancia. Esta es una prueba manual del CTS.

run cts -m CtsUwbMultiDeviceTestCase_RangingMeasurementTests -t RangingMeasurementTest#test_distance_measurement_accuracy

Si tienes más de dos dispositivos conectados a la máquina host de CTS, especifica el ID del DUT y el ID del dispositivo de referencia en el comando run cts.

run cts -m CtsUwbMultiDeviceTestCase_RangingMeasurementTests -t RangingMeasurementTest#test_distance_measurement_accuracy --shard-count 2
-s DUT_ID -s REFERENCE_DEVICE_ID

El caso de prueba de CTS multidispositivo inicia una sesión de medición de UWB entre el DUT y el dispositivo de referencia, y realiza 1,000 mediciones con el DUT. Luego, la prueba procesa automáticamente las mediciones y determina si el dispositivo aprueba o no con lo siguiente:

  1. Ordena las 1,000 mediciones de forma ascendente.
  2. Calcula el rango como [rango = medición 975 - medición 25].
  3. Informa el rango en la prueba del CTS multidispositivo. Para aprobar, el rango debe ser inferior a 30 cm.
  4. Informa el valor de mediana (500ª) en la prueba de CTS para varios dispositivos. Para pasar, el valor debe estar dentro de [0.75 m, 1.25 m].

Requisitos de la red Wi-Fi para reconocimiento de vecinos

En esta sección, se describe cómo calibrar el dispositivo para que cumpla con los requisitos de Wi-Fi Neighbor Awareness Networking (NAN) en el CDD(se incluye una instantánea aquí):

2.2.1. Hardware

Si los dispositivos admiten el protocolo Wi-Fi de Neighbor Awareness Networking (NAN) declarando PackageManager.FEATURE_WIFI_AWARE y la ubicación de Wi-Fi (tiempo de ida y vuelta de Wi-Fi: RTT) declarando PackageManager.FEATURE_WIFI_RTT, entonces:

  • [7.4.2.5/H-1-1] DEBE informar el rango con precisión dentro de +/- 1 metro con un ancho de banda de 160 MHz en el percentil 68 (como se calcula con la función de distribución acumulativa), +/- 2 metros con un ancho de banda de 80 MHz en el percentil 68, +/- 4 metros con un ancho de banda de 40 MHz en el percentil 68 y distancias de +/- 8 metros con un ancho de banda de 20 MHz en el percentil 68 a 10 cm, 1 m, 3 m y 5 m, como se observa con la API de Android WifiRttManager#startRanging.

  • [7.4.2.5/H-SR] SE RECOMIENDA ENFATICAMENTE informar el rango con precisión dentro de +/- 1 metro con un ancho de banda de 160 MHz en el percentil 90 (como se calcula con la función de distribución acumulativa), +/- 2 metros con un ancho de banda de 80 MHz en el percentil 90, +/- 4 metros con un ancho de banda superior a 40 MHz en el percentil 90 y +/- 8 metros con un ancho de banda de 20 MHz en el percentil 90 a distancias de 10 cm, como se observa con la API de Android WifiRttManager#startRanging.

Requisito [7.4.2.5/H-1-1]

Para verificar el cumplimiento del requisito [7.4.2.5/H-1-1], haz lo siguiente:

  1. Instala (si no está instalada) y abre la app de CTS Verifier (CTS-V) en el DUT y en el dispositivo de referencia. La prueba CTS-V para este requisito se encuentra en Presence Test > NAN Accuracy Test.

  2. Coloca el DUT a la distancia de prueba de 10 cm del dispositivo de referencia, sin nada entre los dos dispositivos.

  3. En la pantalla de prueba del dispositivo de referencia, asegúrate de que la casilla de verificación Es dispositivo de referencia esté marcada y, luego, presiona Iniciar publicación.

  4. Selecciona la distancia de prueba de 10 cm en la actividad CTS-V del DUT y presiona Iniciar prueba. Luego, el verificador de CTS realiza 100 mediciones de rango y calcula y registra el rango de las mediciones en los registros de CTS-V. Cuando se complete la prueba, verifica si el rango calculado está dentro del rango esperado en la app del verificador del CTS en el DUT.

  5. Repite los pasos del uno al cuatro para las otras distancias de prueba de 1 m, 3 m y 5 m. La prueba se aprueba si los rangos de todas las distancias de prueba están dentro del rango esperado. De lo contrario, las distancias de prueba para las que falló la prueba se muestran en la pantalla CTS-V.

Requisitos de RSSI de BLE

En esta sección, se describe cómo calibrar el dispositivo para que cumpla con estos requisitos de RSSI de BLE tomados de la CDD:

7.4.3 Bluetooth

Si las implementaciones de dispositivos declaran FEATURE_BLUETOOTH_LE, hacen lo siguiente:

  • [C-10-1] DEBEN tener mediciones de RSSI dentro de +/-9 dBm para el 95% de las mediciones a 1 m de distancia de un dispositivo de referencia que transmite a ADVERTISE_TX_POWER_HIGH en un entorno de línea de visión.
  • [C-10-2] DEBEN incluir correcciones de RX/TX para reducir las desviaciones por canal, de modo que las mediciones en cada uno de los 3 canales, en cada una de las antenas (si se usan varias), estén dentro de +/-3 dBm entre sí para el 95% de las mediciones.
  • [C-10-3] DEBE medir y compensar el desplazamiento de Rx para garantizar que el RSSI promedio de BLE sea de -55 dBm ± 10 dBm a 1 m de distancia de un dispositivo de referencia que transmite en ADVERTISE_TX_POWER_HIGH.
  • [C-10-4] DEBE medir y compensar el desfase de Tx para garantizar que el RSSI promedio de BLE sea de -55 dBm ± 10 dBm cuando se escanea desde un dispositivo de referencia ubicado a 1 m de distancia y transmitiendo a ADVERTISE_TX_POWER_HIGH.

Configuración de calibración

Usa la siguiente configuración para calibrar el dispositivo y que cumpla con los requisitos de RSSI de BLE.

Requisitos generales de configuración

  • Para obtener resultados óptimos, usa una cámara anecoica para minimizar la interferencia con las mediciones. Si no usas una cámara anecoica, configura los dos trípodes que sostienen el dispositivo de referencia y el DUT a 1.5 metros del suelo, con una distancia similar al techo.
  • Se requieren dos trípodes conectados a los soportes para dispositivos.
  • Usa trípodes que tengan la menor cantidad posible de metal.
  • Usa soportes para dispositivos que tengan la menor cantidad de metal posible. Un pequeño resorte de metal es adecuado.
  • No DEBE haber objetos metálicos a menos de 1 m del DUT y del dispositivo de referencia.
  • El dispositivo de referencia y todos los DUT DEBEN tener suficiente carga para completar las pruebas.
  • Durante la prueba, SE DEBEN desconectar el dispositivo de referencia y el DUT actual.
  • El dispositivo de referencia y los DUT NO DEBEN tener fundas, cables conectados ni ningún otro elemento que pueda afectar el rendimiento de la radiofrecuencia (RF).

Configuración de referencia para la calibración de BLE

Figura 2: Configuración de referencia para la calibración de BLE

Requisito [C-10-1]

Para verificar el cumplimiento del requisito [C-10-1]:

  1. Instala (si no está instalada) y abre la app de CTS Verifier (CTS-V) en el DUT y en el dispositivo de referencia. La prueba CTS-V para este requisito se encuentra en Presence Test > BLE RSSI Precision Test.

  2. Coloca el DUT a la distancia de prueba de 1 m del dispositivo de referencia, según la configuración de calibración de BLE.

  3. Presiona Comenzar publicidad en el dispositivo de referencia y, luego, sigue las instrucciones de la pantalla del DUT para ingresar el ID de dispositivo específico del dispositivo de referencia, que se muestra en el dispositivo de referencia después de que comienza la publicidad. Presiona Start Test en el DUT.

  4. Cuando se completa la recopilación de datos (1,000 análisis recopilados en el DUT), la prueba se aprueba o falla automáticamente, según el rango calculado. Para aprobar, el rango debe ser menor o igual que 18 dBm.

Requisito [C-10-2]

Para verificar el requisito [C-10-2]. El proveedor de chips puede identificar las diferencias entre núcleos y canales. A continuación, se incluyen sugerencias para identificar problemas con núcleos y canales no calibrados, que son dos posibles causas de una gran propagación de RSSI.

Núcleos no calibrados

Si la antena BT de un dispositivo tiene varios núcleos, es posible que estos tengan diferentes calibraciones. Toma algunas mediciones (al menos 1 minuto) y revisa los datos del análisis. Si ves un patrón similar al que se muestra en la Figura 3, que tiene picos regulares (como lo indican los círculos) debido al escaneo en varios núcleos, es probable que haya un problema con los núcleos no calibrados y se requiera una investigación adicional.

Ejemplo de datos de análisis de un dispositivo con núcleos no calibrados

Figura 3: Ejemplo de datos de análisis para un dispositivo con núcleos sin calibrar

Canales no calibrados

Las transmisiones en BLE clásico se realizan en tres canales. Cada canal puede tener diferencias asociadas. Los canales se rotan en intervalos fijos. Toma algunas mediciones (al menos 1 minuto) y verifica los datos del análisis. Si ves un patrón similar al que se muestra en la Figura 4, es probable que haya un problema con una calibración incorrecta en diferentes canales y se requiera una investigación adicional.

Ejemplo de datos de análisis de un dispositivo con canales no calibrados

Figura 4: Ejemplo de datos de análisis de un dispositivo con canales no calibrados

Requisitos [C-10-3] y [C-10-4]

Incluso cuando un chip de radio BLE está calibrado perfectamente, el RSSI que observa un dispositivo en particular depende de la calidad de la antena y de su ubicación en ese producto en particular (modelo del dispositivo). Esto presenta un problema para la interoperabilidad entre dispositivos.

Por ejemplo, considera un caso de uso de desbloqueo de automóviles. Un desarrollador de apps podría querer desbloquear un automóvil cuando el dispositivo esté a 1 metro de él. El desarrollador elige un umbral de -60 dBm en función de sus observaciones con un teléfono que tiene, pero debido a las diferencias en la calidad y la ubicación de la antena, es posible que no funcione bien con otro dispositivo Android, incluso si ambos dispositivos usan el mismo chip.

Para la interoperabilidad entre todos los dispositivos del ecosistema, debes medir el desplazamiento de Rx de cada dispositivo y ajustar el RSSI informado en el dispositivo para asegurarte de que el RSSI de BLE cumpla con el estándar de 1 m en ADVERTISE_TX_POWER_HIGH.

Incluso cuando los chips de radio BLE están calibrados de forma perfecta, el receptor ideal lee diferentes RSSI según la calidad y la ubicación de la antena en el dispositivo de publicidad. El requisito de Rx garantiza que todos los dispositivos puedan mostrar anuncios con la misma intensidad resultante, en igualdad de condiciones.

Para dispositivos con Android 14 y versiones posteriores, sigue estos pasos para verificar el cumplimiento del requisito de Rx y Tx:

  1. Instala (si no lo habías instalado antes) y abre la app del verificador de CTS (CTS-V) tanto en el DUT como en el dispositivo de referencia. La prueba CTS-V para este requisito se encuentra en Presence Test > BLE Rx/Tx Offset Precision Test.

  2. Coloca el DUT a la distancia de prueba de 1 m del dispositivo de referencia, según la configuración de calibración de BLE. Te recomendamos que los dispositivos estén orientados de modo que sean paralelos entre sí y las pantallas estén orientadas en la misma dirección.

  3. Presiona Iniciar publicidad en el dispositivo de referencia y, luego, sigue las instrucciones en la pantalla del DUT para ingresar el ID de dispositivo específico del dispositivo de referencia, que se muestra en el dispositivo de referencia después de que comienza la publicidad.

  4. Presiona Iniciar prueba en el DUT. En esta prueba, para verificar el requisito de Rx, el dispositivo de referencia realiza análisis en segundo plano al mismo tiempo que se inicia la publicidad.

    Cuando se completa la recopilación de datos (1,000 análisis recopilados en ambos dispositivos), la prueba se aprueba si la mediana calculada (medición 500) de las pruebas Rx y Tx está entre -65 dBm y -45 dBm. La prueba falla si la mediana calculada para la prueba de Rx o Tx no está dentro del rango aceptado.

  5. Calibra los dispositivos para compensar el offset de Rx y la potencia de Tx para asegurar un RSSI promedio de -55 dBm:

    • Rx: Ajusta el RSSI mediante la configuración de la propiedad del sistema bluetooth.hardware.radio.le_rx_path_loss_comp_db en el valor (dB) que compensa el desplazamiento de Rx para garantizar una RSSI de BLE mediana de -55 dBm a 1 m. La pila de Bluetooth ajusta el RSSI para que sea RSSI más el valor de bluetooth.hardware.radio.le_rx_path_loss_comp_db. Para obtener más información, consulta le_scanning_manager.cc.

    • Tx: Para ajustar la potencia de Tx, establece la propiedad del sistema bluetooth.hardware.radio.le_tx_path_loss_comp_db en el valor (dB) que compensa la potencia de Tx para garantizar una RSSI BLE mediana de -5 5 dBm a 1 m. La pila de Bluetooth ajusta la potencia de Tx para que sea la potencia de Tx más el valor de bluetooth.hardware.radio.le_tx_path_loss_comp_db. Para obtener más información, consulta le_advertising_manager.cc.