A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release anziché aosp-main per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.
Report sull'intensità del segnale
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Il framework di telefonia segnala l'intensità del segnale della rete cellulare utilizzando diversi tipi di misurazione del segnale. Puoi quindi utilizzare queste intensità del segnale registrate per controllare la modalità di visualizzazione delle barre del segnale sul dispositivo e personalizzare i criteri di generazione di report sull'intensità del segnale dal modem. A partire da Android
11, puoi personalizzare
diversi tipi di misurazione del segnale che il framework utilizza per segnalare la potenza del segnale
delle reti di accesso radio (RAN) 4G LTE e 5G NR.
Il framework utilizza tre funzioni per generare report sull'intensità del segnale: criteri di generazione di report sull'intensità del segnale, soglie di intensità del segnale e livelli di segnale.
Queste funzioni influiscono sulla modalità di comunicazione di Android con l'hardware del modem, ad esempio impedendo la generazione di report non necessari sulla potenza del segnale da parte del modem per ridurre il consumo di energia e migliorare l'integrità del sistema. Le funzioni sono definite come:
- Criteri di generazione di report sull'intensità del segnale:le condizioni definite da Android per attivare la generazione di report sull'intensità del segnale dal modem.
- Soglie di intensità del segnale:un elenco di quattro numeri interi utilizzati per suggerire criteri di generazione di report sul livello e sull'intensità del segnale.
- Livelli di segnale: cinque livelli (
NONE, POOR, MODERATE, GOOD, GREAT)
che corrispondono all'intensità del segnale.
Supporto di più tipi di misurazione degli indicatori
Per i dispositivi con Android 11 o versioni successive, i seguenti tipi di misurazione del segnale sono personalizzabili per le reti NGRAN (5G LTE) ed EUTRAN (4G LTE). Queste misurazioni vengono utilizzate per i criteri di generazione di report sull'intensità del segnale, le soglie di intensità del segnale e le funzioni dei livelli di segnale.
- NGRAN (5G NR): SSRSRP, SSRSRQ, SSSINR
- EUTRAN (4G LTE): RSRP, RSRQ, RSSNR
Implementazione
Per consentire al dispositivo di impostare i criteri di generazione di report sull'intensità del segnale per ogni RAN,
implementa l'interfaccia hardware
setSignalStrengthReportingCriteria_1_5. Per ogni RAN sono supportati più tipi di misurazione degli indicatori. Se nessuno dei criteri di generazione di report per un tipo di misurazione è attivato per una rete di accesso alla rete, i criteri di generazione di report per quella rete sono definiti dal framework Android. Quando i criteri di generazione di report di un tipo di misurazione sono attivati per un
RAN, i criteri di generazione di report di altri tipi di misurazione vengono disattivati.
Per definire le soglie di intensità del segnale per le reti 4G e 5G, utilizza le seguenti chiavi di configurazione dell'operatore:
Per selezionare più misurazioni per una RAN, utilizza le seguenti chiavi di configurazione dell'operatore:
Convalida
Per convalidare l'implementazione, utilizza il
testGetConfig
test CTS in
CarrierConfigManagerTest.
Utilizza VTS per i test
setSignalStrengthReportingCriteria_1_5_*.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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_*`."]]
