CellSignalStrengthNr

Kotlin |Java

class CellSignalStrengthNr : CellSignalStrength, Parcelable

kotlin.Any
↳	android.telephony.CellSignalStrength
	↳	android.telephony.CellSignalStrengthNr

5G NR signal strength related information.

Summary

Inherited constants

From class Parcelable

Int

CONTENTS_FILE_DESCRIPTOR

Descriptor bit used with describeContents(): indicates that the Parcelable object's flattened representation includes a file descriptor.

Int

PARCELABLE_WRITE_RETURN_VALUE

Flag for use with writeToParcel: the object being written is a return value, that is the result of a function such as "Parcelable someFunction()", "void someFunction(out Parcelable)", or "void someFunction(inout Parcelable)". Some implementations may want to release resources at this point.

From class CellSignalStrength

`Int`	`SIGNAL_STRENGTH_GOOD`
`Int`	`SIGNAL_STRENGTH_GREAT`
`Int`	`SIGNAL_STRENGTH_MODERATE`
`Int`	`SIGNAL_STRENGTH_NONE_OR_UNKNOWN`
`Int`	`SIGNAL_STRENGTH_POOR`

Public methods
Int	`describeContents()`
Boolean	`equals(other: Any?)`
Int	`getAsuLevel()` Get the RSRP in ASU.
MutableList<Int!>	`getCsiCqiReport()` Return a list of CSI channel quality indicators (CQI) for all subbands.
Int	`getCsiCqiTableIndex()` Return CSI channel quality indicator (CQI) table index.
Int	`getCsiRsrp()` Reference: 3GPP TS 38.
Int	`getCsiRsrq()` Reference: 3GPP TS 38.
Int	`getCsiSinr()` Reference: 3GPP TS 38.
Int	`getDbm()` Get the SS-RSRP as dBm value -140.
Int	`getLevel()` Retrieve an abstract level value for the overall signal quality.
Int	`getSsRsrp()` Reference: 3GPP TS 38.
Int	`getSsRsrq()` Reference: 3GPP TS 38.
Int	`getSsSinr()` Reference: 3GPP TS 38.
Int	`getTimingAdvanceMicros()` Get the timing advance value for a one way trip from cell to device for NR in microseconds.
Int	`hashCode()`
String	`toString()`

Properties
static Parcelable.Creator<CellSignalStrengthNr!>	`CREATOR` Implement the Parcelable interface

Public methods

describeContents

Added in API level 29

fun describeContents(): Int

Return
`Int`	a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either `0` or `android.os.Parcelable#CONTENTS_FILE_DESCRIPTOR`

equals

Added in API level 29

fun equals(other: Any?): Boolean

Parameters
`obj`	the reference object with which to compare.

Return
`Boolean`	`true` if this object is the same as the obj argument; `false` otherwise.

getAsuLevel

Added in API level 29

fun getAsuLevel(): Int

Get the RSRP in ASU. Asu is calculated based on 3GPP RSRP. Refer to 3GPP 27.007 (Ver 10.3.0) Sec 8.69

Return
`Int`	RSRP in ASU 0..97, 255, or UNAVAILABLE

getCsiCqiReport

Added in API level 31

fun getCsiCqiReport(): MutableList<Int!>

Return a list of CSI channel quality indicators (CQI) for all subbands. If the CQI report is for the entire wideband, a single CQI index is provided. If the CQI report is for all subbands, one CQI index is provided for each subband, in ascending order of subband index. If CQI is not available, the CQI report is empty. Reference: 3GPP TS 138.214 section 5.2.2.1.

Return
`MutableList<Int!>`	the CQIs for all subbands if available or empty list if unavailable. This value cannot be `null`. Value is between 0 and 15 inclusive

getCsiCqiTableIndex

Added in API level 31

fun getCsiCqiTableIndex(): Int

Return CSI channel quality indicator (CQI) table index. There are multiple CQI tables. The definition of CQI in each table is different. Reference: 3GPP TS 138.214 section 5.2.2.1.

Return
`Int`	the CQI table index if available or `UNAVAILABLE` if unavailable. Value is between 1 and 3 inclusive

getCsiRsrp

Added in API level 29

fun getCsiRsrp(): Int

Reference: 3GPP TS 38.133 10.1.6.1. Range: -156 dBm to -31 dBm.

Return
`Int`	CSI reference signal received power, `CellInfo.UNAVAILABLE` means unreported value.

getCsiRsrq

Added in API level 29

fun getCsiRsrq(): Int

Reference: 3GPP TS 38.215. Range: -20 dB to -3 dB.

Return
`Int`	CSI reference signal received quality, `CellInfo.UNAVAILABLE` means unreported value.

getCsiSinr

Added in API level 29

fun getCsiSinr(): Int

Reference: 3GPP TS 38.215 Sec 5.1.*, 3GPP TS 38.133 10.1.16.1 Range: -23 dB to 23 dB

Return
`Int`	CSI signal-to-noise and interference ratio, `CellInfo.UNAVAILABLE` means unreported value.

getDbm

Added in API level 29

fun getDbm(): Int

Get the SS-RSRP as dBm value -140..-44dBm or UNAVAILABLE.

getLevel

Added in API level 29

fun getLevel(): Int

Retrieve an abstract level value for the overall signal quality.

Return
`Int`	Value is between SIGNAL_STRENGTH_NONE_OR_UNKNOWN and SIGNAL_STRENGTH_GREAT inclusive

getSsRsrp

Added in API level 29

fun getSsRsrp(): Int

Reference: 3GPP TS 38.133 10.1.6.1. Range: -156 dBm to -31 dBm.

Return
`Int`	SS reference signal received power, `CellInfo.UNAVAILABLE` means unreported value.

getSsRsrq

Added in API level 29

fun getSsRsrq(): Int

Reference: 3GPP TS 38.215; 3GPP TS 38.133 section 10 Range: -43 dB to 20 dB.

Return
`Int`	SS reference signal received quality, `CellInfo.UNAVAILABLE` means unreported value.

getSsSinr

Added in API level 29

fun getSsSinr(): Int

Reference: 3GPP TS 38.215 Sec 5.1.*, 3GPP TS 38.133 10.1.16.1 Range: -23 dB to 40 dB

Return
`Int`	SS signal-to-noise and interference ratio, `CellInfo.UNAVAILABLE` means unreported value.

getTimingAdvanceMicros

Added in API level 34

fun getTimingAdvanceMicros(): Int

Get the timing advance value for a one way trip from cell to device for NR in microseconds. android.telephony.CellInfo#UNAVAILABLE is reported when there is no active RRC connection. Reference: 3GPP TS 36.213 section 4.2.3. Range: 0 us to 1282 us.

Return
`Int`	the NR timing advance if available or `android.telephony.CellInfo#UNAVAILABLE` if unavailable. Value is between 0 and 1282 inclusive

hashCode

Added in API level 29

fun hashCode(): Int

Return
`Int`	a hash code value for this object.

toString

Added in API level 29

fun toString(): String

Return
`String`	a string representation of the object.

Properties

CREATOR

Added in API level 29

static val CREATOR: Parcelable.Creator<CellSignalStrengthNr!>

Implement the Parcelable interface