1/* 2 * Copyright (C) 2012 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17package android.telephony; 18 19import android.os.Parcel; 20import android.os.Parcelable; 21 22/** 23 * Abstract base class for cell phone signal strength related information. 24 */ 25public abstract class CellSignalStrength { 26 27 /** @hide */ 28 public static final int SIGNAL_STRENGTH_NONE_OR_UNKNOWN = 0; 29 /** @hide */ 30 public static final int SIGNAL_STRENGTH_POOR = 1; 31 /** @hide */ 32 public static final int SIGNAL_STRENGTH_MODERATE = 2; 33 /** @hide */ 34 public static final int SIGNAL_STRENGTH_GOOD = 3; 35 /** @hide */ 36 public static final int SIGNAL_STRENGTH_GREAT = 4; 37 /** @hide */ 38 public static final int NUM_SIGNAL_STRENGTH_BINS = 5; 39 /** @hide */ 40 public static final String[] SIGNAL_STRENGTH_NAMES = { 41 "none", "poor", "moderate", "good", "great" 42 }; 43 44 /** @hide */ 45 protected CellSignalStrength() { 46 } 47 48 /** @hide */ 49 public abstract void setDefaultValues(); 50 51 /** 52 * Get signal level as an int from 0..4 53 */ 54 public abstract int getLevel(); 55 56 /** 57 * Get the signal level as an asu value between 0..31, 99 is unknown 58 */ 59 public abstract int getAsuLevel(); 60 61 /** 62 * Get the signal strength as dBm 63 */ 64 public abstract int getDbm(); 65 66 /** 67 * Copies the CellSignalStrength. 68 * 69 * @return A deep copy of this class. 70 * @hide 71 */ 72 public abstract CellSignalStrength copy(); 73 74 @Override 75 public abstract int hashCode(); 76 77 @Override 78 public abstract boolean equals (Object o); 79} 80