از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
گزارش قدرت سیگنال
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
چارچوب تلفنی قدرت سیگنال شبکه سلولی را با استفاده از انواع مختلف اندازه گیری سیگنال گزارش می کند. سپس می توانید از این قدرت سیگنال گزارش شده برای کنترل نحوه نمایش نوارهای سیگنال در دستگاه خود و سفارشی کردن معیارهای گزارش قدرت سیگنال از مودم استفاده کنید. با شروع از Android 11، می‌توانید چندین نوع اندازه‌گیری سیگنال را سفارشی کنید که این چارچوب برای گزارش قدرت سیگنال شبکه‌های دسترسی رادیویی 4G LTE و 5G NR (RAN) استفاده می‌کند.
این چارچوب از سه عملکرد برای گزارش قدرت سیگنال استفاده می‌کند: معیارهای گزارش قدرت سیگنال، آستانه‌های قدرت سیگنال و سطوح سیگنال. این عملکردها بر نحوه برقراری ارتباط Android با سخت افزار مودم تأثیر می گذارد، به عنوان مثال، از گزارش غیرضروری سیگنال قدرت توسط مودم برای کاهش مصرف انرژی و بهبود سلامت سیستم جلوگیری می کند. توابع به صورت زیر تعریف می شوند:
- معیارهای گزارش قدرت سیگنال: شرایطی که اندروید برای شروع گزارش قدرت سیگنال از مودم تعریف می کند.
- آستانه‌های قدرت سیگنال: فهرستی از چهار عدد صحیح که برای پیشنهاد سطح سیگنال و معیارهای گزارش قدرت سیگنال استفاده می‌شود.
- سطوح سیگنال: پنج سطح (
NONE سطح، POOR ، MODERATE ، GOOD ، GREAT ) که با قدرت سیگنال مطابقت دارد.
پشتیبانی از انواع مختلف اندازه گیری سیگنال
برای دستگاه‌های دارای Android 11 یا بالاتر، انواع اندازه‌گیری سیگنال زیر برای شبکه‌های NGRAN (5G LTE) و EUTRAN (4G LTE) قابل تنظیم هستند. این اندازه‌گیری‌ها برای معیارهای گزارش قدرت سیگنال، آستانه‌های قدرت سیگنال، و توابع سطوح سیگنال استفاده می‌شوند.
- NGRAN (5G NR): SSRSRP، SSRSRQ، SSSINR
- EUTRAN (4G LTE): RSRP، RSRQ، RSSNR
پیاده سازی
برای فعال کردن دستگاه برای تنظیم معیارهای گزارش قدرت سیگنال برای هر RAN، رابط سخت افزاری setSignalStrengthReportingCriteria_1_5 را پیاده سازی کنید. برای هر RAN، چندین نوع اندازه گیری سیگنال پشتیبانی می شود. اگر هیچ یک از معیارهای گزارش برای یک نوع اندازه گیری برای یک RAN فعال نباشد، معیارهای گزارش برای آن RAN توسط چارچوب Android تعریف می شود. هنگامی که معیارهای گزارش یک نوع اندازه‌گیری برای یک RAN فعال می‌شود، معیارهای گزارش‌دهی سایر انواع اندازه‌گیری غیرفعال می‌شوند.
برای تعریف آستانه قدرت سیگنال برای شبکه های 4G و 5G، از کلیدهای پیکربندی حامل زیر استفاده کنید:
برای انتخاب چندین اندازه گیری برای یک RAN، از کلیدهای پیکربندی حامل زیر استفاده کنید:
اعتبار سنجی
برای تأیید اعتبار پیاده سازی خود، از تست testGetConfig CTS در CarrierConfigManagerTest استفاده کنید. از VTS برای آزمایش setSignalStrengthReportingCriteria_1_5_* استفاده کنید.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],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_*`."]]
