החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.
דיווח על עוצמת האות
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מסגרת הטלפונייה מדווחת על עוצמת האות ברשת הסלולרית באמצעות סוגים שונים של מדידות אותות. לאחר מכן תוכלו להשתמש בעוצמות האות המדווחות כדי לקבוע איך מוצגות עמודות האות במכשיר ולהתאים אישית את הקריטריונים לדיווח על עוצמת האות מהמודם. החל מגרסה 11 של Android, אפשר להתאים אישית כמה סוגים של מדידות אותות שבהם המערכת משתמשת כדי לדווח על עוצמת האות של רשתות גישה לרדיו (RAN) מסוג 4G LTE ו-5G NR.
במסגרת הזו נעשה שימוש בשלוש פונקציות לדיווח על עוצמת האות: קריטריונים לדיווח על עוצמת האות, ערכי סף של עוצמת האות ורמות האות.
הפונקציות האלה משפיעות על האופן שבו Android מתקשרת עם חומרת המודם. לדוגמה, הן מונעות מהמודם לדווח על עוצמת האות שלא לצורך, כדי לצמצם את צריכת החשמל ולשפר את תקינות המערכת. הפונקציות מוגדרות כך:
- קריטריונים לדיווח על עוצמת האות: התנאים שמוגדרים ב-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_*.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[[["התוכן קל להבנה","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-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_*`."]]
