public class SignalStrength extends Object implements Parcelable
Parcelable.ClassLoaderCreator<T>, Parcelable.Creator<T>
Modifier and Type | Field and Description |
---|---|
static Parcelable.Creator<SignalStrength> |
CREATOR
Parcelable.Creator |
static int |
INVALID |
static int |
NUM_SIGNAL_STRENGTH_BINS |
static int |
SIGNAL_STRENGTH_GOOD |
static int |
SIGNAL_STRENGTH_GREAT |
static int |
SIGNAL_STRENGTH_MODERATE |
static String[] |
SIGNAL_STRENGTH_NAMES |
static int |
SIGNAL_STRENGTH_NONE_OR_UNKNOWN |
static int |
SIGNAL_STRENGTH_POOR |
CONTENTS_FILE_DESCRIPTOR, PARCELABLE_ELIDE_DUPLICATES, PARCELABLE_WRITE_RETURN_VALUE
Constructor and Description |
---|
SignalStrength()
Empty constructor
|
SignalStrength(boolean gsmFlag)
This constructor is used to create SignalStrength with default
values and set the isGsmFlag with the value passed in the input
|
SignalStrength(int gsmSignalStrength,
int gsmBitErrorRate,
int cdmaDbm,
int cdmaEcio,
int evdoDbm,
int evdoEcio,
int evdoSnr,
boolean gsmFlag)
Constructor
|
SignalStrength(int gsmSignalStrength,
int gsmBitErrorRate,
int cdmaDbm,
int cdmaEcio,
int evdoDbm,
int evdoEcio,
int evdoSnr,
int lteSignalStrength,
int lteRsrp,
int lteRsrq,
int lteRssnr,
int lteCqi,
boolean gsmFlag)
Constructor
|
SignalStrength(int gsmSignalStrength,
int gsmBitErrorRate,
int cdmaDbm,
int cdmaEcio,
int evdoDbm,
int evdoEcio,
int evdoSnr,
int lteSignalStrength,
int lteRsrp,
int lteRsrq,
int lteRssnr,
int lteCqi,
int tdScdmaRscp,
boolean gsmFlag)
Constructor
|
SignalStrength(Parcel in)
Construct a SignalStrength object from the given parcel.
|
SignalStrength(SignalStrength s)
Copy constructors
|
Modifier and Type | Method and Description |
---|---|
protected void |
copyFrom(SignalStrength s) |
int |
describeContents()
|
boolean |
equals(Object o)
Indicates whether some other object is "equal to" this one.
|
void |
fillInNotifierBundle(Bundle m)
Set intent notifier Bundle based on SignalStrength
|
int |
getAsuLevel()
Get the signal level as an asu value between 0..31, 99 is unknown
|
int |
getCdmaAsuLevel()
Get the cdma signal level as an asu value between 0..31, 99 is unknown
|
int |
getCdmaDbm()
Get the CDMA RSSI value in dBm
|
int |
getCdmaEcio()
Get the CDMA Ec/Io value in dB*10
|
int |
getCdmaLevel()
Get cdma as level 0..4
|
int |
getDbm()
Get the signal strength as dBm
|
int |
getEvdoAsuLevel()
Get the evdo signal level as an asu value between 0..31, 99 is unknown
|
int |
getEvdoDbm()
Get the EVDO RSSI value in dBm
|
int |
getEvdoEcio()
Get the EVDO Ec/Io value in dB*10
|
int |
getEvdoLevel()
Get Evdo as level 0..4
|
int |
getEvdoSnr()
Get the signal to noise ratio.
|
int |
getGsmAsuLevel()
Get the gsm signal level as an asu value between 0..31, 99 is unknown
|
int |
getGsmBitErrorRate()
Get the GSM bit error rate (0-7, 99) as defined in TS 27.007 8.5
|
int |
getGsmDbm()
Get Gsm signal strength as dBm
|
int |
getGsmLevel()
Get gsm as level 0..4
|
int |
getGsmSignalStrength()
Get the GSM Signal Strength, valid values are (0-31, 99) as defined in TS
27.007 8.5
|
int |
getLevel()
Retrieve an abstract level value for the overall signal strength.
|
int |
getLteAsuLevel()
Get the LTE signal level as an asu value between 0..97, 99 is unknown
Asu is calculated based on 3GPP RSRP.
|
int |
getLteCqi() |
int |
getLteDbm()
Get LTE as dBm
|
int |
getLteLevel()
Get LTE as level 0..4
|
int |
getLteRsrp() |
int |
getLteRsrq() |
int |
getLteRssnr() |
int |
getLteSignalStrength() |
int |
getTdScdmaAsuLevel()
Get the TD-SCDMA signal level as an asu value.
|
int |
getTdScdmaDbm() |
int |
getTdScdmaLevel()
Get TD-SCDMA as level 0..4
Range : 25 to 120
INT_MAX: 0x7FFFFFFF denotes invalid value
Reference: 3GPP TS 25.123, section 9.1.1.1
|
int |
hashCode()
Returns a hash code value for the object.
|
void |
initialize(int gsmSignalStrength,
int gsmBitErrorRate,
int cdmaDbm,
int cdmaEcio,
int evdoDbm,
int evdoEcio,
int evdoSnr,
boolean gsm)
Initialize gsm/cdma values, sets lte values to defaults.
|
void |
initialize(int gsmSignalStrength,
int gsmBitErrorRate,
int cdmaDbm,
int cdmaEcio,
int evdoDbm,
int evdoEcio,
int evdoSnr,
int lteSignalStrength,
int lteRsrp,
int lteRsrq,
int lteRssnr,
int lteCqi,
boolean gsm)
Initialize all the values
|
boolean |
isGsm() |
static SignalStrength |
makeSignalStrengthFromRilParcel(Parcel in)
Make a SignalStrength object from the given parcel as passed up by
the ril which does not have isGsm. isGsm will be changed by ServiceStateTracker
so the default is a don't care.
|
static SignalStrength |
newFromBundle(Bundle m)
Create a new SignalStrength from a intent notifier Bundle
This method is used by PhoneStateIntentReceiver and maybe by
external applications.
|
void |
setGsm(boolean gsmFlag) |
String |
toString()
Returns a string representation of the object.
|
void |
validateInput()
Validate the individual signal strength fields as per the range
specified in ril.h
Set to invalid any field that is not in the valid range
Cdma, evdo, lte rsrp & rsrq values are sign converted
when received from ril interface
|
void |
writeToParcel(Parcel out,
int flags)
|
public static final int SIGNAL_STRENGTH_NONE_OR_UNKNOWN
public static final int SIGNAL_STRENGTH_POOR
public static final int SIGNAL_STRENGTH_MODERATE
public static final int SIGNAL_STRENGTH_GOOD
public static final int SIGNAL_STRENGTH_GREAT
public static final int NUM_SIGNAL_STRENGTH_BINS
public static final String[] SIGNAL_STRENGTH_NAMES
public static final int INVALID
public static final Parcelable.Creator<SignalStrength> CREATOR
Parcelable.Creator
public SignalStrength()
public SignalStrength(boolean gsmFlag)
gsmFlag
- true if Gsm Phone,false if Cdma phonepublic SignalStrength(int gsmSignalStrength, int gsmBitErrorRate, int cdmaDbm, int cdmaEcio, int evdoDbm, int evdoEcio, int evdoSnr, int lteSignalStrength, int lteRsrp, int lteRsrq, int lteRssnr, int lteCqi, int tdScdmaRscp, boolean gsmFlag)
public SignalStrength(int gsmSignalStrength, int gsmBitErrorRate, int cdmaDbm, int cdmaEcio, int evdoDbm, int evdoEcio, int evdoSnr, int lteSignalStrength, int lteRsrp, int lteRsrq, int lteRssnr, int lteCqi, boolean gsmFlag)
public SignalStrength(int gsmSignalStrength, int gsmBitErrorRate, int cdmaDbm, int cdmaEcio, int evdoDbm, int evdoEcio, int evdoSnr, boolean gsmFlag)
public SignalStrength(SignalStrength s)
s
- Source SignalStrengthpublic SignalStrength(Parcel in)
public static SignalStrength newFromBundle(Bundle m)
m
- Bundle from intent notifierpublic void initialize(int gsmSignalStrength, int gsmBitErrorRate, int cdmaDbm, int cdmaEcio, int evdoDbm, int evdoEcio, int evdoSnr, boolean gsm)
gsmSignalStrength
- gsmBitErrorRate
- cdmaDbm
- cdmaEcio
- evdoDbm
- evdoEcio
- evdoSnr
- gsm
- public void initialize(int gsmSignalStrength, int gsmBitErrorRate, int cdmaDbm, int cdmaEcio, int evdoDbm, int evdoEcio, int evdoSnr, int lteSignalStrength, int lteRsrp, int lteRsrq, int lteRssnr, int lteCqi, boolean gsm)
gsmSignalStrength
- gsmBitErrorRate
- cdmaDbm
- cdmaEcio
- evdoDbm
- evdoEcio
- evdoSnr
- lteSignalStrength
- lteRsrp
- lteRsrq
- lteRssnr
- lteCqi
- gsm
- protected void copyFrom(SignalStrength s)
public static SignalStrength makeSignalStrengthFromRilParcel(Parcel in)
public void writeToParcel(Parcel out, int flags)
writeToParcel
in interface Parcelable
out
- The Parcel in which the object should be written.flags
- Additional flags about how the object should be written.
May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE
.public int describeContents()
describeContents
in interface Parcelable
Parcelable.CONTENTS_FILE_DESCRIPTOR
public void validateInput()
public void setGsm(boolean gsmFlag)
true
- - Gsm, Lte phones
false - Cdma phones
Used by voice phone to set the isGsm
flagpublic int getGsmSignalStrength()
public int getGsmBitErrorRate()
public int getCdmaDbm()
public int getCdmaEcio()
public int getEvdoDbm()
public int getEvdoEcio()
public int getEvdoSnr()
public int getLteSignalStrength()
public int getLteRsrp()
public int getLteRsrq()
public int getLteRssnr()
public int getLteCqi()
public int getLevel()
public int getAsuLevel()
public int getDbm()
public int getGsmDbm()
public int getGsmLevel()
public int getGsmAsuLevel()
public int getCdmaLevel()
public int getCdmaAsuLevel()
public int getEvdoLevel()
public int getEvdoAsuLevel()
public int getLteDbm()
public int getLteLevel()
public int getLteAsuLevel()
public boolean isGsm()
public int getTdScdmaDbm()
public int getTdScdmaLevel()
public int getTdScdmaAsuLevel()
public int hashCode()
Object
HashMap
.
The general contract of hashCode
is:
hashCode
method
must consistently return the same integer, provided no information
used in equals
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.
equals(Object)
method, then calling the hashCode
method on each of
the two objects must produce the same integer result.
Object.equals(java.lang.Object)
method, then calling the hashCode
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.
As much as is reasonably practical, the hashCode method defined by
class Object
does return distinct integers for distinct
objects. (This is typically implemented by converting the internal
address of the object into an integer, but this implementation
technique is not required by the
JavaTM programming language.)
hashCode
in class Object
Object.equals(java.lang.Object)
,
System.identityHashCode(java.lang.Object)
public boolean equals(Object o)
Object
The equals
method implements an equivalence relation
on non-null object references:
x
, x.equals(x)
should return
true
.
x
and y
, x.equals(y)
should return true
if and only if
y.equals(x)
returns true
.
x
, y
, and z
, if
x.equals(y)
returns true
and
y.equals(z)
returns true
, then
x.equals(z)
should return true
.
x
and y
, multiple invocations of
x.equals(y)
consistently return true
or consistently return false
, provided no
information used in equals
comparisons on the
objects is modified.
x
,
x.equals(null)
should return false
.
The equals
method for class Object
implements
the most discriminating possible equivalence relation on objects;
that is, for any non-null reference values x
and
y
, this method returns true
if and only
if x
and y
refer to the same object
(x == y
has the value true
).
Note that it is generally necessary to override the hashCode
method whenever this method is overridden, so as to maintain the
general contract for the hashCode
method, which states
that equal objects must have equal hash codes.
equals
in class Object
o
- the reference object with which to compare.Object.hashCode()
,
HashMap
public String toString()
Object
toString
method returns a string that
"textually represents" this object. The result should
be a concise but informative representation that is easy for a
person to read.
It is recommended that all subclasses override this method.
The toString
method for class Object
returns a string consisting of the name of the class of which the
object is an instance, the at-sign character `@
', and
the unsigned hexadecimal representation of the hash code of the
object. In other words, this method returns a string equal to the
value of:
getClass().getName() + '@' + Integer.toHexString(hashCode())
public void fillInNotifierBundle(Bundle m)
m
- intent notifier Bundle