En esta página, se proporcionan instrucciones de configuración y calibración para los requisitos de calibración de presencia de los dispositivos que ejecutan Android 14 y versiones posteriores.
Para garantizar que los dispositivos inteligentes de los usuarios funcionen bien juntos, es fundamental que todos los dispositivos del ecosistema Android puedan determinar la proximidad relativa entre ellos. En Android 14, se presentan los requisitos de calibración de presencia que describen el rendimiento aceptable de las tecnologías de radio disponibles que se usan para determinar la proximidad, como la banda ultraancha (UWB), Wi-Fi y Bluetooth de bajo consumo (BLE).
Dispositivo de referencia
Para calibrar tu dispositivo de modo que cumpla con los requisitos de presencia, usa uno de los siguientes dispositivos de referencia para todas las calibraciones.
- Un teléfono Pixel (recomendado)
- Si no usas un teléfono Pixel, usa el mismo dispositivo de marca y modelo 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 factores de forma que no sean teléfonos celulares, para determinar la configuración de calibración adecuada para el dispositivo, considera cómo se posicionaría un usuario que sostiene un teléfono celular (dispositivo de referencia) cuando interactúa con el dispositivo que se está probando (DUT). Por ejemplo, cuando calibres una TV, coloca la TV y el teléfono celular a una distancia adecuada entre sí y orienta el dispositivo móvil de modo que quede frente al centro de la pantalla de la TV.
Pruebas de precisión de la medición de distancia
En el caso de los dispositivos que ejecutan Android 17 y versiones posteriores, el módulo CtsMultiDeviceGenericRangingAccuracyTests incluye casos de prueba que verifican los requisitos de calibración de presencia que se indican en esta página. Este módulo es una prueba automatizada de varios dispositivos del lado del host del Verificador del CTS (CTS-V) que se ejecuta desde una máquina host conectada al DUT y al dispositivo de referencia. El módulo reemplaza las pruebas de presencia manuales en CTS-V. En el caso de los dispositivos que ejecutan Android 16 y versiones anteriores, usa las pruebas de presencia en las versiones de CTS y CTS-V para esa versión de Android.
Para ejecutar las pruebas de precisión de la medición de distancia, haz lo siguiente:
Configura la máquina host y el CTS-V en el DUT y el dispositivo de referencia. Para obtener más información, consulta Cómo configurar pruebas de varios dispositivos del lado del host.
Coloca el DUT y el dispositivo de referencia a 1 metro de distancia, como se describe en Configura pruebas de precisión de medición de distancia y en la configuración de calibración para cada tecnología en esta página.
Conecta ambos dispositivos a la máquina host con cables USB.
Desde el directorio en el que descomprimiste el paquete de CTS-V, inicia la consola del host de CTS-V:
./android-cts-verifier/android-cts-v-host/tools/cts-v-host-tradefedEn la consola del host de CTS-V, ejecuta las pruebas de precisión de la medición de distancia:
run cts-v-host -m CtsMultiDeviceGenericRangingAccuracyTestsLos resultados de la prueba aparecen en la app de CTS-V en el DUT, en Host-side Tests > UWB Tests > CtsMultiDeviceGenericRangingAccuracyTests.
Cada caso de prueba del módulo recopila mediciones con una tecnología, calcula las métricas de exactitud a partir de las mediciones y registra las métricas. Un caso de prueba se aprueba si recopila las mediciones correctamente, incluso si las métricas no cumplen con los objetivos. Para verificar el cumplimiento, compara las métricas registradas con los objetivos que se describen en las siguientes secciones. Si el DUT o el dispositivo de referencia no admiten una tecnología, se omite el caso de prueba para esa tecnología.
Requisitos de UWB
Consulta la sección 7.4.9 del CDD para conocer los requisitos de la UWB.
Configuración de la calibración de UWB
Usa la siguiente configuración para calibrar tu 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 necesitan 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 estar en orientación vertical con la pantalla en sentido contrario a la del otro.
En la Figura 1 y el Video 1, se muestra un ejemplo de configuración de calibración de UWB.
Figura 1: Configuración de referencia para la calibración de UWB.
Video 1: Configuración de referencia para la calibración de UWB.
Verifica el cumplimiento de los requisitos [C-1-6] y [C-1-7] de la sección 7.4.9 del CDD
Para verificar el cumplimiento de la CDD 7.4.9 [C-1-6] y [C-1-7], ejecuta las pruebas de precisión de rango y verifica las métricas registradas por el caso de prueba test_uwb_ranging.
El caso de prueba inicia una sesión de medición de distancia de UWB entre el DUT y el dispositivo de referencia, y toma 1,000 mediciones con cada dispositivo. Para las mediciones de cada dispositivo, el caso de prueba hace lo siguiente:
Calcula el rango de la siguiente manera: rango = medición del percentil 97.5 - medición del percentil 2.5. Para cumplir con el requisito, el rango debe ser menor o igual que 30 cm.
Calcula la medición de la mediana. Para cumplir con el requisito, la mediana debe estar entre 0.75 m y 1.25 m inclusive.
Requisitos de Neighbor Awareness Networking de Wi-Fi
Sección 2.2.1 del CDD En Hardware, se incluyen los requisitos para el cumplimiento de Neighbor Awareness Networking (NAN) por Wi-Fi.
Verifica el cumplimiento de la sección 2.2.1 [7.4.2.5/H-1-1] del CDD
Para verificar el cumplimiento de la CDD 2.2.1 [7.4.2.5/H-1-1], ejecuta las pruebas de precisión de la medición de distancia y verifica las métricas registradas por el caso de prueba test_wifi_rtt_ranging.
El caso de prueba inicia una sesión de medición de distancia de Wi-Fi NAN entre el DUT y el dispositivo de referencia, y toma 100 mediciones de Wi-Fi RTT. Luego, el caso de prueba calcula el porcentaje de mediciones que se encuentran dentro de ±2 m de la distancia real de 1 m. Para cumplir con el requisito de ancho de banda de 80 MHz, al menos el 68% de las mediciones deben estar dentro de ±2 m.
Requisitos de RSSI de BLE
Sección 7.4.3 del CDD Bluetooth incluye requisitos para el cumplimiento de RSSI de BLE.
Configuración de la calibración
Usa la siguiente configuración para calibrar tu dispositivo de modo 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 un trípode que sostenga el dispositivo de referencia y otro que sostenga el dispositivo DUT a 1.5 metros del suelo, con una distancia similar del techo.
Prepara el dispositivo de referencia y el DUT:
- Asegúrate de que ambos dispositivos tengan suficiente carga para completar las pruebas.
- Desconecta ambos dispositivos durante la prueba.
- Quita todas las fundas, los cables conectados y otros accesorios que puedan afectar el rendimiento de la radiofrecuencia (RF).
Coloca cada dispositivo en un trípode con un soporte para dispositivos.
- Los trípodes y los soportes de dispositivos deben tener la menor cantidad posible de metal.
- Se permite un pequeño resorte de metal en los soportes de dispositivos.
Quita los objetos metálicos que se encuentren entre los dos dispositivos.
Figura 2: Configuración de referencia para la calibración de BLE
Verifica el cumplimiento de la sección 7.4.3 [C-10-1] del CDD
Para verificar el cumplimiento de la CDD 7.4.3 [C-10-1], ejecuta las
pruebas de precisión de medición de distancia con los dispositivos ubicados
según la configuración de calibración de BLE y verifica las
métricas registradas por el caso de prueba test_ble_rssi_ranging.
El caso de prueba configura el dispositivo de referencia para que se anuncie en ADVERTISE_TX_POWER_HIGH y recopila 1,000 análisis en el DUT. Luego, el caso de prueba
calcula el rango del 95% medio de las mediciones de RSSI. Para cumplir con el requisito, el rango debe ser menor o igual que 18 dB.
Verifica el cumplimiento del CDD 7.4.3 [C-10-2]
Para verificar el cumplimiento de la CDD 7.4.3 [C-10-2], el proveedor de chips puede medir la uniformidad del canal y, luego, identificar las diferencias entre los núcleos y los canales.
A continuación, se incluyen sugerencias para identificar problemas con núcleos y canales no calibrados, que son dos causas posibles de una gran dispersión de RSSI.
Núcleos sin calibrar
Si la antena Bluetooth de un dispositivo tiene varios núcleos, estos podrían tener calibraciones diferentes. 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 3, que tiene picos regulares (como indican los círculos) debido al análisis en varios núcleos, es probable que haya un problema con los núcleos no calibrados y se requiera una investigación más detallada.
Figura 3: Ejemplo de datos de análisis para un dispositivo con núcleos no calibrados.
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 la calibración incorrecta en diferentes canales y se requiera una investigación más detallada.
Figura 4: Ejemplo de datos de análisis para un dispositivo con canales no calibrados.
Verifica el cumplimiento de los requisitos [C-10-3] y [C-10-4] de la sección 7.4.3 del CDD
Incluso cuando un chip de radio BLE está perfectamente calibrado, 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 de dispositivo). Esto presenta un problema para la interoperabilidad entre dispositivos.
Por ejemplo, considera un caso de uso de desbloqueo de un automóvil. Es posible que un desarrollador de apps quiera destrabar un automóvil cuando el dispositivo esté a menos de 1 metro de distancia. 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 esto no funcione bien con otro dispositivo Android, incluso si ambos dispositivos usan el mismo chip.
Para lograr 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 garantizar que el RSSI de BLE cumpla con el estándar de 1 m a ADVERTISE_TX_POWER_HIGH.
Incluso cuando los chips de radio BLE están perfectamente calibrados, el receptor ideal lee diferentes RSSI según la calidad y la ubicación de la antena en el dispositivo de anuncio. El requisito de Rx garantiza que todos los dispositivos puedan anunciarse con la misma intensidad resultante, en igualdad de condiciones.
Para verificar el cumplimiento del requisito de Rx y Tx, haz lo siguiente:
Coloca el DUT a 1 m del dispositivo de referencia, según la configuración de calibración de BLE. Recomendamos que los dispositivos se orienten de modo que queden paralelos entre sí y con las pantallas en la misma dirección.
Ejecuta las pruebas de precisión de rango y verifica las métricas que registró el caso de prueba
test_ble_rx_tx_offset_precision.El caso de prueba ejecuta las pruebas de Rx y Tx al mismo tiempo, y recopila 1,000 análisis para cada prueba:
- Rx: El DUT realiza un análisis mientras el dispositivo de referencia se anuncia en
ADVERTISE_TX_POWER_HIGH. - Tx: El dispositivo de referencia realiza un análisis mientras el DUT se anuncia en
ADVERTISE_TX_POWER_HIGH.
Para cumplir con el requisito, la mediana de RSSI para las pruebas de Rx y Tx debe estar entre -65 dBm y -45 dBm.
- Rx: El DUT realiza un análisis mientras el dispositivo de referencia se anuncia en
Calibra los dispositivos para compensar el desplazamiento de Rx y la potencia de Tx para garantizar una RSSI mediana de -55 dBm.
Rx: Ajusta el RSSI configurando la propiedad del sistema
bluetooth.hardware.radio.le_rx_path_loss_comp_dben el valor (dB) que compensa el desplazamiento de Rx para garantizar un RSSI de BLE mediano de -55 dBm a 1 m. La pila de Bluetooth ajusta el RSSI para que sea el RSSI más el valor debluetooth.hardware.radio.le_rx_path_loss_comp_db.Para obtener más información, consulta
le_scanning_manager.cc.Tx: Ajusta la potencia de Tx configurando la propiedad del sistema
bluetooth.hardware.radio.le_tx_path_loss_comp_dben el valor (dB) que compensa la potencia de Tx para garantizar un RSSI de BLE mediano de -55 dBm a 1 m. La pila de Bluetooth ajusta la potencia de Tx para que sea la potencia de Tx más el valor debluetooth.hardware.radio.le_tx_path_loss_comp_db.Para obtener más información, consulta
le_advertising_manager.cc.
Requisitos de BLE Channel Sounding
Sección 7.4.3 del CDD Bluetooth incluye requisitos para
la exactitud de la medición de canales (CS) de BLE. El requisito [C-11-2] especifica que los dispositivos que declaran FEATURE_BLUETOOTH_LE_CHANNEL_SOUNDING deben informar el rango con precisión de ±0.5 m en el percentil 90, según se calcula con la función de distribución acumulativa (CDF), a una distancia de 1 m.
Verifica el cumplimiento del CDD 7.4.3 [C-11-2]
Para verificar el cumplimiento de la CDD 7.4.3 [C-11-2], ejecuta las
pruebas de precisión de medición de distancia con los dispositivos ubicados
según la configuración de calibración de BLE y verifica las
métricas registradas por el caso de prueba test_channel_sounding_ranging. Tanto el DUT como el dispositivo de referencia deben admitir BLE CS.
El caso de prueba vincula el DUT y el dispositivo de referencia a través de BLE, inicia una sesión de medición de distancia de CS de BLE entre ellos y toma 100 mediciones de distancia. Luego, el caso de prueba calcula el porcentaje de mediciones que se encuentran dentro de ±0.5 m de la distancia real de 1 m. Para cumplir con el requisito, al menos el 90% de las mediciones deben estar dentro de ±0.5 m.