Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release, bukan aosp-main, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.
Pelaporan kekuatan sinyal
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Framework telephony melaporkan kekuatan sinyal jaringan seluler menggunakan berbagai
jenis pengukuran sinyal. Kemudian, Anda dapat menggunakan kekuatan sinyal yang dilaporkan ini untuk
mengontrol cara batang sinyal ditampilkan di perangkat dan menyesuaikan kriteria
pelaporan kekuatan sinyal dari modem. Mulai dari Android
11, Anda dapat menyesuaikan
beberapa jenis pengukuran sinyal yang digunakan framework untuk melaporkan kekuatan
sinyal jaringan akses radio (RAN) 4G LTE dan 5G NR.
Framework ini menggunakan tiga fungsi untuk melaporkan kekuatan sinyal: kriteria
pelaporan kekuatan sinyal, nilai minimum kekuatan sinyal, dan level sinyal.
Fungsi ini memengaruhi cara Android berkomunikasi dengan hardware modem, misalnya, mencegah pelaporan kekuatan sinyal yang tidak perlu oleh modem untuk mengurangi
penggunaan daya dan meningkatkan kondisi sistem. Fungsi ditentukan sebagai:
- Kriteria pelaporan kekuatan sinyal: Kondisi yang ditentukan oleh
Android untuk memicu pelaporan kekuatan sinyal dari modem.
- Batas kekuatan sinyal: Daftar empat bilangan bulat yang digunakan untuk menyarankan
kriteria pelaporan level sinyal dan kekuatan sinyal.
- Level sinyal: Lima level (
NONE, POOR, MODERATE, GOOD, GREAT)
yang sesuai dengan kekuatan sinyal.
Dukungan untuk beberapa jenis pengukuran sinyal
Untuk perangkat yang menjalankan Android 11 atau yang lebih tinggi, jenis pengukuran sinyal berikut
dapat disesuaikan untuk jaringan NGRAN (5G LTE) dan EUTRAN (4G LTE). Pengukuran
ini digunakan untuk kriteria pelaporan kekuatan sinyal, nilai minimum
kekuatan sinyal, dan fungsi level sinyal.
- NGRAN (5G NR): SSRSRP, SSRSRQ, SSSINR
- EUTRAN (4G LTE): RSRP, RSRQ, RSSNR
Implementasi
Agar perangkat dapat menetapkan kriteria pelaporan kekuatan sinyal untuk setiap RAN,
terapkan
antarmuka hardware
setSignalStrengthReportingCriteria_1_5. Untuk setiap RAN, beberapa jenis pengukuran sinyal
didukung. Jika tidak ada kriteria pelaporan untuk jenis pengukuran yang diaktifkan
untuk RAN, kriteria pelaporan untuk RAN tersebut ditentukan oleh framework
Android. Jika kriteria pelaporan jenis pengukuran diaktifkan untuk
RAN, kriteria pelaporan jenis pengukuran lainnya akan dinonaktifkan.
Untuk menentukan nilai minimum kekuatan sinyal untuk jaringan 4G dan 5G, gunakan
kunci konfigurasi operator berikut:
Untuk memilih beberapa pengukuran untuk RAN, gunakan kunci konfigurasi
operator berikut:
Validasi
Untuk memvalidasi penerapan Anda, gunakan
pengujian CTS
testGetConfig di
CarrierConfigManagerTest.
Gunakan VTS untuk menguji
setSignalStrengthReportingCriteria_1_5_*.
Konten dan contoh kode di halaman ini tunduk kepada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-27 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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_*`."]]
