CellSignalStrengthNr
public
final
class
CellSignalStrengthNr
extends CellSignalStrength
implements
Parcelable
java.lang.Object | ||
↳ | android.telephony.CellSignalStrength | |
↳ | android.telephony.CellSignalStrengthNr |
5G NR signal strength related information.
Summary
Inherited constants |
---|
Fields | |
---|---|
public
static
final
Creator<CellSignalStrengthNr> |
CREATOR
Implement the Parcelable interface |
Public methods | |
---|---|
int
|
describeContents()
Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. |
boolean
|
equals(Object obj)
Indicates whether some other object is "equal to" this one. |
int
|
getAsuLevel()
Get the RSRP in ASU. |
List<Integer>
|
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.133 10.1.6.1. |
int
|
getCsiRsrq()
Reference: 3GPP TS 38.215. |
int
|
getCsiSinr()
Reference: 3GPP TS 38.215 Sec 5.1.*, 3GPP TS 38.133 10.1.16.1 Range: -23 dB to 23 dB |
int
|
getDbm()
Get the SS-RSRP as dBm value -140..-44dBm or |
int
|
getLevel()
Retrieve an abstract level value for the overall signal quality. |
int
|
getSsRsrp()
Reference: 3GPP TS 38.133 10.1.6.1. |
int
|
getSsRsrq()
Reference: 3GPP TS 38.215; 3GPP TS 38.133 section 10 Range: -43 dB to 20 dB. |
int
|
getSsSinr()
Reference: 3GPP TS 38.215 Sec 5.1.*, 3GPP TS 38.133 10.1.16.1 Range: -23 dB to 40 dB |
int
|
getTimingAdvanceMicros()
Get the timing advance value for a one way trip from cell to device for NR in microseconds. |
int
|
hashCode()
Returns a hash code value for the object. |
String
|
toString()
Returns a string representation of the object. |
Inherited methods | |
---|---|
Fields
CREATOR
public static final Creator<CellSignalStrengthNr> CREATOR
Implement the Parcelable interface
Public methods
describeContents
public int describeContents ()
Describe the kinds of special objects contained in this Parcelable
instance's marshaled representation. For example, if the object will
include a file descriptor in the output of writeToParcel(android.os.Parcel, int)
,
the return value of this method must include the
CONTENTS_FILE_DESCRIPTOR
bit.
Returns | |
---|---|
int |
a bitmask indicating the set of special object types marshaled
by this Parcelable object instance.
Value is either 0 or CONTENTS_FILE_DESCRIPTOR |
equals
public boolean equals (Object obj)
Indicates whether some other object is "equal to" this one.
The equals
method implements an equivalence relation
on non-null object references:
- It is reflexive: for any non-null reference value
x
,x.equals(x)
should returntrue
. - It is symmetric: for any non-null reference values
x
andy
,x.equals(y)
should returntrue
if and only ify.equals(x)
returnstrue
. - It is transitive: for any non-null reference values
x
,y
, andz
, ifx.equals(y)
returnstrue
andy.equals(z)
returnstrue
, thenx.equals(z)
should returntrue
. - It is consistent: for any non-null reference values
x
andy
, multiple invocations ofx.equals(y)
consistently returntrue
or consistently returnfalse
, provided no information used inequals
comparisons on the objects is modified. - For any non-null reference value
x
,x.equals(null)
should returnfalse
.
An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.
Parameters | |
---|---|
obj |
Object : the reference object with which to compare. |
Returns | |
---|---|
boolean |
true if this object is the same as the obj
argument; false otherwise. |
getAsuLevel
public int getAsuLevel ()
Get the RSRP in ASU. Asu is calculated based on 3GPP RSRP. Refer to 3GPP 27.007 (Ver 10.3.0) Sec 8.69
Returns | |
---|---|
int |
RSRP in ASU 0..97, 255, or UNAVAILABLE |
getCsiCqiReport
public List<Integer> getCsiCqiReport ()
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.
Returns | |
---|---|
List<Integer> |
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
public int getCsiCqiTableIndex ()
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.
Returns | |
---|---|
int |
the CQI table index if available or
UNAVAILABLE if unavailable.
Value is between 1 and 3 inclusive |
getCsiRsrp
public int getCsiRsrp ()
Reference: 3GPP TS 38.133 10.1.6.1. Range: -156 dBm to -31 dBm.
Returns | |
---|---|
int |
CSI reference signal received power, CellInfo.UNAVAILABLE means unreported
value. |
getCsiRsrq
public int getCsiRsrq ()
Reference: 3GPP TS 38.215. Range: -20 dB to -3 dB.
Returns | |
---|---|
int |
CSI reference signal received quality, CellInfo.UNAVAILABLE means unreported
value. |
getCsiSinr
public int getCsiSinr ()
Reference: 3GPP TS 38.215 Sec 5.1.*, 3GPP TS 38.133 10.1.16.1 Range: -23 dB to 23 dB
Returns | |
---|---|
int |
CSI signal-to-noise and interference ratio, CellInfo.UNAVAILABLE means
unreported value. |
getDbm
public int getDbm ()
Get the SS-RSRP as dBm value -140..-44dBm or UNAVAILABLE
.
Returns | |
---|---|
int |
getLevel
public int getLevel ()
Retrieve an abstract level value for the overall signal quality.
Returns | |
---|---|
int |
Value is between SIGNAL_STRENGTH_NONE_OR_UNKNOWN and SIGNAL_STRENGTH_GREAT inclusive |
getSsRsrp
public int getSsRsrp ()
Reference: 3GPP TS 38.133 10.1.6.1. Range: -156 dBm to -31 dBm.
Returns | |
---|---|
int |
SS reference signal received power, CellInfo.UNAVAILABLE means unreported
value. |
getSsRsrq
public int getSsRsrq ()
Reference: 3GPP TS 38.215; 3GPP TS 38.133 section 10 Range: -43 dB to 20 dB.
Returns | |
---|---|
int |
SS reference signal received quality, CellInfo.UNAVAILABLE means unreported
value. |
getSsSinr
public int getSsSinr ()
Reference: 3GPP TS 38.215 Sec 5.1.*, 3GPP TS 38.133 10.1.16.1 Range: -23 dB to 40 dB
Returns | |
---|---|
int |
SS signal-to-noise and interference ratio, CellInfo.UNAVAILABLE means
unreported value. |
getTimingAdvanceMicros
public int getTimingAdvanceMicros ()
Get the timing advance value for a one way trip from cell to device for NR in microseconds.
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.
Returns | |
---|---|
int |
the NR timing advance if available or
CellInfo.UNAVAILABLE if unavailable.
Value is between 0 and 1282 inclusive |
hashCode
public int hashCode ()
Returns a hash code value for the object. This method is
supported for the benefit of hash tables such as those provided by
HashMap
.
The general contract of hashCode
is:
- Whenever it is invoked on the same object more than once during
an execution of a Java application, the
hashCode
method must consistently return the same integer, provided no information used inequals
comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application. - If two objects are equal according to the
equals
method, then calling thehashCode
method on each of the two objects must produce the same integer result. - It is not required that if two objects are unequal
according to the
equals
method, then calling thehashCode
method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.
Returns | |
---|---|
int |
a hash code value for this object. |
toString
public String toString ()
Returns a string representation of the object.
Returns | |
---|---|
String |
a string representation of the object. |