A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release
en lugar de aosp-main
para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.
Informes de intensidad de la señal
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
El framework de telefonía informa la intensidad de la señal de la red celular con varios tipos de medición de señal. Luego, puedes usar estas intensidades de señal informadas para controlar cómo se muestran las barras de señal en tu dispositivo y personalizar los criterios de informes de intensidad de señal desde el módem. A partir de Android 11, puedes personalizar varios tipos de medición de señal que usa el framework para informar la intensidad de la señal en redes de acceso de radio (RAN) 4G LTE y 5G NR.
El framework usa tres funciones para informar la intensidad de la señal: criterios de informes de intensidad de la señal, umbrales de intensidad de la señal y niveles de señal.
Estas funciones afectan la forma en que Android se comunica con el hardware del módem, por ejemplo, evitando que el módem informe la intensidad de la señal innecesaria para reducir el uso de energía y mejorar el estado del sistema. Las funciones se definen de la siguiente manera:
- Criterios de informes de intensidad de la señal: Son las condiciones que define Android para activar los informes de intensidad de la señal desde el módem.
- Umbral de intensidad de la señal: Es una lista de cuatro números enteros que se usan para sugerir criterios de informes de nivel de señal y de intensidad de la señal.
- Niveles de señal: Son cinco niveles (
NONE
, POOR
, MODERATE
, GOOD
y GREAT
) que corresponden a la intensidad de la señal.
Compatibilidad con varios tipos de medición de indicadores
En dispositivos con Android 11 o versiones posteriores, los siguientes tipos de medición de señal se pueden personalizar para redes NGRAN (5G LTE) y EUTRAN (4G LTE). Estas mediciones se usan para los criterios de informes de intensidad de la señal, los umbrales de intensidad de la señal y las funciones de niveles de señal.
- NGRAN (5G NR): SSRSRP, SSRSRQ, SSSINR
- EUTRAN (4G LTE): RSRP, RSRQ, RSSNR
Implementación
Para permitir que el dispositivo establezca los criterios de informes de intensidad de señal para cada RAN, implementa la interfaz de hardware setSignalStrengthReportingCriteria_1_5
. Para cada RAN, se admiten varios tipos de medición de indicadores. Si no se habilita ninguno de los criterios de informes para un tipo de medición en una RAN, el framework de Android define los criterios de informes para esa RAN. Cuando se habilitan los criterios de informes de un tipo de medición para una RAN, se inhabilitan los criterios de informes de otros tipos de medición.
Para definir los umbrales de intensidad de la señal para las redes 4G y 5G, usa las siguientes claves de configuración del operador:
Para seleccionar varias mediciones de una RAN, usa las siguientes claves de configuración del operador:
Validación
Para validar tu implementación, usa la prueba de CTS de testGetConfig
en CarrierConfigManagerTest
.
Usa VTS para probar setSignalStrengthReportingCriteria_1_5_*
.
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-07-27 (UTC)"],[],[],null,["# Signal strength reporting\n\nThe telephony framework reports cellular network signal strength using various\nsignal measurement types. You can then use these reported signal strengths to\ncontrol how signal bars are displayed on your device and customize the signal\nstrength reporting criteria from the modem. Starting from Android\n11, you can customize\nmultiple signal measurement types that the framework uses to report the signal\nstrength of 4G LTE and 5G NR radio access networks (RANs).\n\nThe framework uses three functions for reporting signal strength: signal\nstrength reporting criteria, signal strength thresholds, and signal levels.\nThese functions affect how Android communicates with the modem hardware, for\nexample, preventing unnecessary signal strength reporting by the modem to reduce\npower usage and improve system health. The functions are defined as:\n\n- **Signal strength reporting criteria:** The conditions defined by Android to trigger signal strength reporting from the modem.\n- **Signal strength thresholds:** A list of four integers used for suggesting signal level and signal strength reporting criteria.\n- **Signal levels:** Five levels (`NONE`, `POOR`, `MODERATE`, `GOOD`, `GREAT`) that correspond to signal strength.\n\nSupport for multiple signal measurement types\n---------------------------------------------\n\nFor devices running Android 11 or higher, the\nfollowing signal measurement types\nare customizable for NGRAN (5G LTE) and EUTRAN (4G LTE) networks. These\nmeasurements are used for the signal strength reporting criteria, signal\nstrength thresholds, and signal levels functions.\n\n- **NGRAN (5G NR):** SSRSRP, SSRSRQ, SSSINR\n- **EUTRAN (4G LTE):** RSRP, RSRQ, RSSNR\n\nImplementation\n--------------\n\nTo enable the device to set the signal strength reporting criteria for each RAN,\nimplement the\n[`setSignalStrengthReportingCriteria_1_5`](https://android.googlesource.com/platform/hardware/interfaces/+/refs/heads/android16-release/radio/1.5/IRadio.hal#68)\nhardware interface. For each RAN, multiple signal measurement types are\nsupported. If none of the reporting criteria for a measurement type is enabled\nfor a RAN, the reporting criteria for that RAN is defined by the Android\nframework. When the reporting criteria of a measurement type is enabled for a\nRAN, the reporting criteria of other measurement types are disabled.\n\nTo define the signal strength thresholds for 4G and 5G networks, use the\nfollowing carrier config keys:\n\n- [`KEY_5G_NR_SSRSRP_THRESHOLDS_INT_ARRAY`](https://developer.android.com/reference/android/telephony/CarrierConfigManager#KEY_5G_NR_SSRSRP_THRESHOLDS_INT_ARRAY)\n- [`KEY_5G_NR_SSRSRQ_THRESHOLDS_INT_ARRAY`](https://developer.android.com/reference/android/telephony/CarrierConfigManager#KEY_5G_NR_SSRSRQ_THRESHOLDS_INT_ARRAY)\n- [`KEY_5G_NR_SSSINR_THRESHOLDS_INT_ARRAY`](https://developer.android.com/reference/android/telephony/CarrierConfigManager#KEY_5G_NR_SSSINR_THRESHOLDS_INT_ARRAY)\n- [`KEY_LTE_RSRQ_THRESHOLDS_INT_ARRAY`](https://developer.android.com/reference/android/telephony/CarrierConfigManager#KEY_LTE_RSRQ_THRESHOLDS_INT_ARRAY)\n- [`KEY_LTE_RSSNR_THRESHOLDS_INT_ARRAY`](https://developer.android.com/reference/android/telephony/CarrierConfigManager#KEY_LTE_RSSNR_THRESHOLDS_INT_ARRAY)\n\nTo select multiple measurements for a RAN, use the following carrier config\nkeys:\n\n- [`KEY_PARAMETERS_USED_FOR_LTE_SIGNAL_BAR_INT`](https://android.googlesource.com/platform/frameworks/base/+/refs/heads/android16-release/telephony/java/android/telephony/CarrierConfigManager.java#2379)\n- [`KEY_PARAMETERS_USE_FOR_5G_NR_SIGNAL_BAR_INT`](https://android.googlesource.com/platform/frameworks/base/+/refs/heads/android16-release/telephony/java/android/telephony/CarrierConfigManager.java#2461)\n\nValidation\n----------\n\nTo validate your implementation, use the\n[`testGetConfig`](https://android.googlesource.com/platform/cts/+/112b1be/tests/tests/telephony/src/android/telephony/cts/CarrierConfigManagerTest.java#70)\nCTS test in\n[`CarrierConfigManagerTest`](https://android.googlesource.com/platform/cts/+/112b1be/tests/tests/telephony/src/android/telephony/cts/CarrierConfigManagerTest.java).\nUse [VTS](/docs/core/tests/vts) for testing\n`setSignalStrengthReportingCriteria_1_5_*`."]]