Android Open Source - satstat Cell Tower Gsm

• Back to Location/Network  ↑

From Project

Back to project page satstat.

License

The source code is released under:

GNU General Public License

Java Source Code

package com.vonglasow.michael.satstat.data;
//from  w w  w .ja  v a2 s.c o  m
public class CellTowerGsm extends CellTower {
  public static String ALT_ID = "pci";
  public static String FAMILY = "gsm";
  public static int MAX_2G_CID = 65535;
  
  private int cid;
  private int lac;
  private int mcc;
  private int mnc;
  private int psc;
  
  public CellTowerGsm(int mcc, int mnc, int lac, int cid, int psc) {
    super();
    this.setMcc(mcc);
    this.setMnc(mnc);
    this.setLac(lac);
    this.setCid(cid);
    this.setPsc(psc);
  }
  
  /**
   * Returns the alternate cell identity in text form.
   * <p>
   * For UMTS networks this string has the following form:
   * <p>
   * {@code gsm:psc-nnn}
   * <p>
   * The first is a string which uniquely identifies the network family.
   * It is followed by a colon, the string {@code psc} to denote an alternate
   * cell identity, a dash and the primary scrambling code (PSC) with no
   * leading zeroes.
   * <p> 
   * A result is only returned for UMTS (3G) cells with a valid PSC. In all
   * other cases, {@code null} is returned. 
   */
  public String getAltText() {
    return getAltText(this.psc);
  }

  /**
   * Converts a PSC to an alternate identity string, or {@code null} if the
   * PSC is invalid. 
   */
  public static String getAltText(int psc) {
    if ((psc == CellTower.UNKNOWN) || (psc == Integer.MAX_VALUE))
      return null;
    return String.format("%s:%s-%d", FAMILY, ALT_ID, psc);
  }
  
  public int getCid() {
    return this.cid;
  }
  
  public int getLac() {
    return this.lac;
  }
  
  public int getMcc() {
    return this.mcc;
  }
  
  public int getMnc() {
    return this.mnc;
  }

  public int getPsc() {
    return this.psc;
  }

  /**
   * Returns the cell identity in text form.
   * <p>
   * For GSM-like networks this string has the following form:
   * <p>
   * {@code gsm:mcc-mnc-lac-cid}
   * <p>
   * The first is a string which uniquely identifies the network family.
   * It is followed by a colon and a sequence of country code, network code,
   * Local Area Code and Cell ID, separated by dashes and with no leading
   * zeroes. 
   */
  @Override
  public String getText() {
    return getText(mcc, mnc, lac, cid);
  }
  
  /**
   * Converts a MCC/MNC/LAC/CID tuple to an identity string, or
   * {@code null} if CID is invalid.
   */
  public static String getText(int mcc, int mnc, int lac, int cid) {
    int iMcc = ((mcc == -1) || (mcc == Integer.MAX_VALUE)) ? CellTower.UNKNOWN : mcc;
    int iMnc = ((mnc == -1) || (mnc == Integer.MAX_VALUE)) ? CellTower.UNKNOWN : mnc;
    int iLac = ((lac == -1) || (lac == Integer.MAX_VALUE)) ? CellTower.UNKNOWN : lac;
    if ((cid == -1) || (cid == Integer.MAX_VALUE))
      return null;
    else
      return String.format("%s:%d-%d-%d-%d", FAMILY, iMcc, iMnc, iLac, cid);
  }
  
  /**
   * Sets signal strength dBm based on ASU.
   * <p>
   * ASU can be converted into dBm with the formula:
   * {@code dBm = -113 + 2 * asu}. The reporting range is from -113 dBm to
   * -51 dBm (0 to 31). Values outside this range will be ignored. Refer to
   * 3GPP TS 27.007 (Ver 10.3.0) Sec 8.69
   */
  // or 3GPP TS 27.007 8.5
  public void setAsu(int asu){
    if ((asu >= 0) || (asu <= 31))
      this.setDbm(-113 + 2 * asu);
  }
  
  public void setCid(int cid) {
    if ((cid != Integer.MAX_VALUE) && (cid != -1))
      this.cid = cid;
    else
      this.cid = CellTower.UNKNOWN;
    if (this.cid > MAX_2G_CID)
      this.generation = 3;
  }
  
  /**
   * Sets signal strength dBm based on CPICH RSCP.
   * <p>
   * RSCP is Received Signal Code Power. This value can be converted into dBm
   * with the formula: {@code dBm = rscp - 116}. The reporting range for
   * CPICH RSCP is from -120 dBm to -25 dBm (-5 to 91, with the two extremes
   * indicating any RSCP outside the reporting range). Values outside this
   * range will be ignored. Refer to 3GPP TS 25.133 (Ver 10.2.0) 9.1.1.3.
   * <p>
   * Note: It seems that at least on some devices
   * {@link android.telephony.NeighboringCellInfo#getRssi()} returns RSCP in
   * dBm rather than the index specified in the document. This method
   * attempts to guess the unit and set signal strength to the correct value
   * in either case. See
   * http://stackoverflow.com/questions/26620378/android-neighboringcellinfo-getrssi-returning-weird-data-for-umts-cells
   */
  public void setCpichRscp(int rscp){
    if ((rscp >= -5) && (rscp <= 91))
      this.setDbm(rscp - 116);
      else if ((rscp >= -121) && (rscp <=-25))
        this.setDbm(rscp);
  }
  
  public void setLac(int lac) {
    if ((lac != Integer.MAX_VALUE) && (lac != -1))
      this.lac = lac;
    else
      this.lac = CellTower.UNKNOWN;
  }
  
  public void setMcc(int mcc) {
    if ((mcc != Integer.MAX_VALUE) && (mcc != -1))
      this.mcc = mcc;
    else
      this.mcc = CellTower.UNKNOWN;
  }
  
  public void setMnc(int mnc) {
    if ((mcc != Integer.MAX_VALUE) && (mcc != -1))
      this.mnc = mnc;
    else
      this.mnc = CellTower.UNKNOWN;
  }
  
  public void setPsc(int psc) {
    if ((psc != Integer.MAX_VALUE) && (psc != -1)) {
      this.psc = psc;
      this.generation = 3;
    } else
      this.psc = CellTower.UNKNOWN;
  }
}

Java Source Code List

• Back to Location/Network  ↑