The telephony sensor provides information on the mobile phone capabilities of the device, connected cell towers and neighboring towers.

Settings

Aware_Preferences.STATUS_TELEPHONY: true or false to activate or deactivate sensor.

aware-broadcasts

  • Telephony.ACTION_AWARE_TELEPHONY: broadcasted when the telephony  profile is updated.
  • Telephony.ACTION_AWARE_CDMA_TOWER: broadcasted when connected to a CDMA tower (CDMA devices only).
  • Telephony.ACTION_AWARE_GSM_TOWER: broadcasted when connected to a GSM tower (GSM devices only).
  • Telephony.ACTION_AWARE_GSM_TOWER_NEIGHBOR: broadcasted when neighbor GSM towers are detected (GSM devices only).

aware-providers

Telephony Data

Contains the telephony profiles.

Telephony_Data.CONTENT_URI
content://com.aware.provider.telephony/telephony

Table field Field type Description
_id INTEGER primary key, auto incremented
timestamp REAL unixtime milliseconds since 1970
device_id TEXT AWARE device UUID
data_enabled INTEGER current data connection state, one of the TelephonyManager constants
imei_meid_esn TEXT unique device ID, SHA1 one-way hashed for privacy
software_version TEXT the telephony software version
line_number TEXT phone number, SHA1 one-way hashed for privacy
network_country_iso_mcc TEXT ISO country code of the current registered operator’s MCC (Mobile Country Code)
network_operator_code TEXT numeric name (MCC+MNC) of current registered operator. MNC is Mobile Network Code
network_operator_name TEXT  the name of current registered operator
network_type INTEGER  the radio technology currently in use for data, one of the TelephonyManager constants.
phone_type INTEGER  the phone type, indicates the radio used to transmit voice calls, one of the TelephonyManager constants.
sim_state INTEGER  the device SIM card status, one of the TelephonyManager constants.
sim_operator_code TEXT  MCC+MNC (Mobile Country Code + Mobile Network Code) of the SIM provider
sim_operator_name TEXT  contains the Service Provider Name (SPN)
sim_serial TEXT  SIM serial number if available, SHA1 one-way hashed for privacy
subscriber_id TEXT  unique network subscriber ID, the IMSI for GSM, SHA1 one-way hashed for privacy

GSM Data

Contains the GSM tower profile.

GSM_Data.CONTENT_URI
content://com.aware.provider.telephony/gsm

Table field Field type Description
_id INTEGER primary key, auto incremented
timestamp REAL unixtime milliseconds since 1970
device_id TEXT AWARE device UUID
cid INTEGER GSM tower Cell ID
lac INTEGER GSM tower Location Area Code
psc INTEGER GSM tower Primary Scrambling Code (9 bits format)
signal_strength INTEGER received signal strength. For GSM, it is in “asu” ranging from 0 to 31 (dBm = -113 + 2*asu), 0 means “-113 dBm or less” and 31 means “-51 dBm or greater”. For UMTS, it is the Level index of CPICH RSCP defined in TS 25.125
bit_error_rate INTEGER GSM bit error rate (0-7, 99) as defined in TS27.007 8.5

GSM Neighbors Data

Contains the GSM tower neighbors profiles.

GSM_Neighbors_Data.CONTENT_URI
content://com.aware.provider.telephony/gsm_neighbor

Table field Field type Description
_id INTEGER primary key, auto incremented
timestamp REAL unixtime milliseconds since 1970
device_id TEXT AWARE device UUID
cid INTEGER GSM tower Cell ID
lac INTEGER GSM tower Location Area Code
psc INTEGER GSM tower Primary Scrambling Code (9 bits format)
signal_strength INTEGER received signal strength. For GSM, it is in “asu” ranging from 0 to 31 (dBm = -113 + 2*asu), 0 means “-113 dBm or less” and 31 means “-51 dBm or greater”. For UMTS, it is the Level index of CPICH RSCP defined in TS 25.125

CDMA Data

Contains the CDMA tower profile.

CDMA_Data.CONTENT_URI
content://com.aware.provider.telephony/cdma

Table field Field type Description
_id INTEGER primary key, auto incremented
timestamp REAL unixtime milliseconds since 1970
device_id TEXT AWARE device UUID
base_station_id INTEGER CDMA base station identification number, -1 if unknown
double_base_station_latitude REAL Latitude is a decimal number as specified in 3GPP2 C.S0005-A v6.0.(http://www.3gpp2.org/public_html/specs/C.S0005-A_v6.0.pdf) It is represented in units of 0.25 seconds and ranges from -1296000 to 1296000, both values inclusive (corresponding to a range of -90 to +90 degrees). Integer.MAX_VALUE is considered invalid value
double_base_station_longitude REAL Longitude is a decimal number as specified in 3GPP2 C.S0005-A v6.0. (http://www.3gpp2.org/public_html/specs/C.S0005-A_v6.0.pdf) It is represented in units of 0.25 seconds and ranges from -2592000 to 2592000, both values inclusive (corresponding to a range of -180 to +180 degrees). Integer.MAX_VALUE is considered invalid value
network_id INTEGER CDMA network identification number, -1 if unknown
system_id INTEGER CDMA system identification number, -1 if unknown
signal_strength INTEGER CDMA RSSI value in dBm
cdma_ecio INTEGER  CDMA Ec/Io value in dB*10
evdo_dbm INTEGER  EVDO RSSI value in dBm
evdo_ecio INTEGER  EVDO Ec/Io value in dB*10
evdo_snr INTEGER  EVDO signal to noise ratio. Valid values are 0-8, 8 is the highest

 

Telephony