2025년 3월 27일부터 AOSP를 빌드하고 기여하려면 aosp-main
대신 android-latest-release
를 사용하는 것이 좋습니다. 자세한 내용은 AOSP 변경사항을 참고하세요.
신호 강도 보고
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
전화 통신 프레임워크는 다양한 신호 측정 유형을 사용하여 셀룰러 네트워크의 신호 강도를 보고합니다. 이후에는 보고된 신호 강도를 사용하여 신호 막대가 기기에 표시되는 방식을 제어하고 모뎀의 신호 강도 보고 기준을 맞춤설정할 수 있습니다. Android 11부터는 프레임워크에서 4G LTE 및 5G NR 무선 액세스 네트워크(RAN)의 신호 강도를 보고하는 데 사용하는 여러 신호 측정 유형을 맞춤설정할 수 있습니다.
프레임워크에서는 세 가지 신호 강도 보고 기능, 즉 신호 강도 보고 기준, 신호 강도 임계값, 신호 수준을 사용합니다.
이러한 기능은 모뎀에 의한 불필요한 신호 강도 보고를 방지하여 전력 사용량을 줄이고 시스템 상태를 개선하는 등 Android가 모뎀 하드웨어와 통신하는 방식에 영향을 미칩니다. 기능은 다음과 같이 정의됩니다.
- 신호 강도 보고 기준: 모뎀에서 신호 강도 보고를 실행하도록 Android에서 정의한 조건입니다.
- 신호 강도 임계값: 신호 수준 및 신호 강도 보고 기준을 제안하는 데 사용되는 4개의 정수 목록입니다.
- 신호 수준: 신호 강도에 상응하는 다섯 가지 수준(
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에 여러 측정을 선택하려면 다음 이동통신사 구성 키를 사용하세요.
유효성 검사
구현을 검사하려면 CarrierConfigManagerTest
에서 testGetConfig
CTS 테스트를 사용합니다.
setSignalStrengthReportingCriteria_1_5_*
를 테스트하는 데는 VTS를 사용하세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[null,null,["최종 업데이트: 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_*`."]]