27 Mart 2025'ten itibaren AOSP'yi derlemek ve AOSP'ye katkıda bulunmak için aosp-main
yerine android-latest-release
kullanmanızı öneririz. Daha fazla bilgi için AOSP'de yapılan değişiklikler başlıklı makaleyi inceleyin.
Sinyal gücü raporlaması
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Telefon çerçevesi, çeşitli sinyal ölçüm türlerini kullanarak hücresel ağ sinyal gücünü bildirir. Ardından, cihazınızda sinyal çubuklarının nasıl gösterileceğini kontrol etmek ve modemden sinyal gücü raporlama ölçütlerini özelleştirmek için bu raporlanan sinyal güçlerini kullanabilirsiniz. Android 11'den itibaren, çerçevenin 4G LTE ve 5G NR radyo erişim ağlarının (RAN'lar) sinyal gücünü bildirmek için kullandığı birden fazla sinyal ölçüm türünü özelleştirebilirsiniz.
Çerçeve, sinyal gücünü bildirmek için üç işlev kullanır: sinyal gücü raporlama ölçütleri, sinyal gücü eşikleri ve sinyal seviyeleri.
Bu işlevler, Android'in modem donanımıyla iletişim şeklini etkiler. Örneğin, güç kullanımını azaltmak ve sistem sağlığını iyileştirmek için modem tarafından gereksiz sinyal gücü raporlamasını önler. İşlevler şu şekilde tanımlanır:
- Sinyal gücü raporlama ölçütleri: Android tarafından modemden sinyal gücü raporlamasını tetiklemek için tanımlanan koşullar.
- Sinyal gücü eşikleri: Sinyal seviyesi ve sinyal gücü raporlama ölçütleri önermek için kullanılan dört tam sayının listesi.
- Sinyal seviyeleri: Sinyal gücüne karşılık gelen beş seviye (
NONE
, POOR
, MODERATE
, GOOD
, GREAT
).
Birden fazla sinyal ölçümü türü için destek
Android 11 veya sonraki sürümleri çalıştıran cihazlarda aşağıdaki sinyal ölçüm türleri NGRAN (5G LTE) ve EUTRAN (4G LTE) ağları için özelleştirilebilir. Bu ölçümler, sinyal gücü raporlama ölçütleri, sinyal gücü eşikleri ve sinyal seviyesi işlevleri için kullanılır.
- NGRAN (5G NR): SSRSRP, SSRSRQ, SSSINR
- EUTRAN (4G LTE): RSRP, RSRQ, RSSNR
Uygulama
Cihazın her RAN için sinyal gücü raporlama ölçütlerini ayarlamasını sağlamak amacıyla setSignalStrengthReportingCriteria_1_5
donanım arayüzünü uygulayın. Her RAN için birden fazla sinyal ölçümü türü desteklenir. Bir ölçüm türüne ait raporlama ölçütlerinden hiçbiri bir RAN için etkinleştirilmezse söz konusu RAN'ın raporlama ölçütleri Android çerçevesi tarafından tanımlanır. Bir ölçüm türünün raporlama ölçütleri bir RAN için etkinleştirildiğinde diğer ölçüm türlerinin raporlama ölçütleri devre dışı bırakılır.
4G ve 5G ağları için sinyal gücü eşiklerini tanımlamak üzere aşağıdaki operatör yapılandırma anahtarlarını kullanın:
Bir RAN için birden fazla ölçüm seçmek üzere aşağıdaki operatör yapılandırma anahtarlarını kullanın:
Doğrulama
Uygulamanızı doğrulamak için CarrierConfigManagerTest
'teki testGetConfig
CTS testini kullanın.
Test için VTS'yi kullanınsetSignalStrengthReportingCriteria_1_5_*
.
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-27 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 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_*`."]]