A partir de 27 de março de 2025, recomendamos usar android-latest-release
em vez de aosp-main
para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.
Relatório de intensidade do sinal
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O framework de telefonia informa a intensidade do sinal da rede celular usando vários
tipos de medição de sinal. Você pode usar essas intensidades de sinal relatadas para
controlar como as barras de sinal são exibidas no dispositivo e personalizar os critérios de
relatório de intensidade de sinal do modem. A partir do Android
11, é possível personalizar
vários tipos de medição de sinal que o framework usa para informar a intensidade
do sinal de redes de acesso por rádio (RANs, na sigla em inglês) 4G LTE e 5G NR.
O framework usa três funções para informar a intensidade do sinal: critérios de
informação da intensidade do sinal, limites de intensidade do sinal e níveis do sinal.
Essas funções afetam a forma como o Android se comunica com o hardware do modem, por
exemplo, impedindo que o modem informe a intensidade de sinal desnecessária para reduzir
o uso de energia e melhorar a integridade do sistema. As funções são definidas como:
- Critérios de relatório de intensidade do sinal:as condições definidas pelo
Android para acionar o relatório de intensidade do sinal do modem.
- Limites de intensidade do sinal:uma lista de quatro números inteiros usados para sugerir
critérios de relatório de nível e intensidade do sinal.
- Níveis de sinal:cinco níveis (
NONE
, POOR
, MODERATE
, GOOD
e GREAT
)
que correspondem à intensidade do sinal.
Suporte a vários tipos de medição de sinal
Para dispositivos com o Android 11 ou mais recente, os
seguintes tipos de medição de sinal
podem ser personalizados para redes NGRAN (5G LTE) e EUTRAN (4G LTE). Essas
medições são usadas para os critérios de relatório de intensidade do sinal, os limites de intensidade
do sinal e as funções de níveis de sinal.
- NGRAN (5G NR): SSRSRP, SSRSRQ, SSSINR
- EUTRAN (4G LTE): RSRP, RSRQ, RSSNR
Implementação
Para permitir que o dispositivo defina os critérios de relatório de intensidade de sinal para cada RAN,
implemente a interface de hardware
setSignalStrengthReportingCriteria_1_5
. Para cada RAN, há suporte para vários tipos de medição de sinal. Se nenhum dos critérios de geração de relatórios de um tipo de medição estiver ativado
para uma RAN, os critérios de geração de relatórios para essa RAN serão definidos pelo framework
do Android. Quando os critérios de um tipo de medição são ativados para uma RAN, os critérios de outros tipos de medição são desativados.
Para definir os limites de intensidade do sinal para redes 4G e 5G, use as
seguintes chaves de configuração da operadora:
Para selecionar várias medições de uma RAN, use as seguintes chaves de configuração
da operadora:
Validação
Para validar sua implementação, use o teste
CTS testGetConfig
em
CarrierConfigManagerTest
.
Use o VTS para testar
setSignalStrengthReportingCriteria_1_5_*
.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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_*`."]]