Ab dem 27. März 2025 empfehlen wir, android-latest-release
anstelle von aosp-main
zu verwenden, um AOSP zu erstellen und Beiträge dazu zu leisten. Weitere Informationen finden Sie unter Änderungen am AOSP.
Berichte zur Signalstärke
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Das Telefonie-Framework meldet die Signalstärke des Mobilfunknetzes mithilfe verschiedener Signalmesstypen. Anhand dieser gemeldeten Signalstärken können Sie dann festlegen, wie die Signalbalken auf Ihrem Gerät angezeigt werden, und die Berichtskriterien für die Signalstärke des Modems anpassen. Ab Android 11 können Sie mehrere Signalmesstypen anpassen, die vom Framework verwendet werden, um die Signalstärke von 4G LTE- und 5G NR-Funknetzwerken (Radio Access Networks, RANs) zu erfassen.
Das Framework verwendet drei Funktionen für die Berichterstellung zur Signalstärke: Berichtskriterien für die Signalstärke, Signalstärkegrenzwerte und Signalpegel.
Diese Funktionen wirken sich darauf aus, wie Android mit der Modemhardware kommuniziert. So wird beispielsweise verhindert, dass das Modem unnötige Signalstärkeberichte sendet, um den Stromverbrauch zu senken und die Systemzuverlässigkeit zu verbessern. Die Funktionen sind so definiert:
- Kriterien für die Berichterstellung zur Signalstärke:Die von Android definierten Bedingungen, die die Berichterstellung zur Signalstärke vom Modem auslösen.
- Grenzwerte für die Signalstärke:Eine Liste mit vier Ganzzahlen, die für die Berichtskriterien für Signalpegel und Signalstärke verwendet werden.
- Signalstärkestufen:Fünf Stufen (
NONE
, POOR
, MODERATE
, GOOD
, GREAT
), die der Signalstärke entsprechen.
Unterstützung mehrerer Signalmesstypen
Auf Geräten mit Android 11 oder höher können die folgenden Signalmesstypen für NGRAN- (5G LTE) und EUTRAN-Netzwerke (4G LTE) angepasst werden. Diese Messungen werden für die Berichtskriterien, Grenzwerte und Funktionen für die Signalstärke verwendet.
- NGRAN (5G NR): SSRSRP, SSRSRQ, SSSINR
- EUTRAN (4G LTE): RSRP, RSRQ, RSSNR
Implementierung
Damit das Gerät die Kriterien für die Berichterstellung zur Signalstärke für jedes RAN festlegen kann, implementieren Sie die Hardwareschnittstelle setSignalStrengthReportingCriteria_1_5
. Für jede RAN werden mehrere Signalmesstypen unterstützt. Wenn für eine RAN keines der Berichtskriterien für einen Messtyp aktiviert ist, werden die Berichtskriterien für diese RAN vom Android-Framework definiert. Wenn die Berichtskriterien eines Messtyps für eine RAN aktiviert sind, werden die Berichtskriterien anderer Messtypen deaktiviert.
Verwenden Sie die folgenden Konfigurationsschlüssel des Mobilfunkanbieters, um die Grenzwerte für die Signalstärke für 4G- und 5G-Netzwerke zu definieren:
Wenn Sie mehrere Messungen für ein RAN auswählen möchten, verwenden Sie die folgenden Konfigurationsschlüssel des Mobilfunkanbieters:
Zertifizierungsstufe
Verwenden Sie den CTS-Test in CarrierConfigManagerTest
(testGetConfig
), um Ihre Implementierung zu validieren.
Verwende VTS für Tests.
setSignalStrengthReportingCriteria_1_5_*
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2025-07-27 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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_*`."]]