com.airs.handlers

Class CellHandler

java.lang.Object

PhoneStateListener

com.airs.handlers.CellHandler

All Implemented Interfaces:

Handler

public class CellHandler
extends PhoneStateListener
implements Handler

Class to read cellular sensors, specifically the CR, CD, CS, CB, CI, CL, CC sensor

See Also:

Handler

Constructor Summary

Constructors

Constructor and Description
CellHandler(Context nors) Constructor, allocating all necessary resources for the handler Here, arming the semaphore Then, seeing if the GSM properties are supported (the sensors only work under GSM!) Then, seeing if airplane mode is switched on (not sensors are discovered when in airplane mode)

Method Summary

Methods

Modifier and Type	Method and Description
byte[]	Acquire(String sensor, String query) Method to acquire sensor data
void	destroyHandler() Method to release all handler resources Here, we release all semaphores and remove the phone state listener
void	Discover() Method to discover sensor symbols supported by a handler
void	History(String sensor) Method to view historical chart of the given sensor symbol
void	onCellLocationChanged(CellLocation location) Called when the cell identifier or LAC changed - read the new value and release appropriate semaphore
void	onDataConnectionStateChanged(int state) Called when the data connection state has changed (e.g., being disconnected)
void	onSignalStrengthsChanged(SignalStrength signalStrength) Called when the signal strength has changed
String	Share(String sensor) Method to share the current value of the given sensor

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CellHandler

public CellHandler(Context nors)

Constructor, allocating all necessary resources for the handler Here, arming the semaphore Then, seeing if the GSM properties are supported (the sensors only work under GSM!) Then, seeing if airplane mode is switched on (not sensors are discovered when in airplane mode)

Parameters:

nors - Reference to the calling Context

Method Detail

Acquire

public byte[] Acquire(String sensor,
             String query)

Method to acquire sensor data

Specified by:

Acquire in interface Handler

Parameters:

sensor - String of the sensor symbol

query - String of the query to be fulfilled - not used here

See Also:

Handler.Acquire(java.lang.String, java.lang.String)

Share

public String Share(String sensor)

Description copied from interface: Handler

Method to share the current value of the given sensor

Specified by:

Share in interface Handler

Parameters:

sensor - String of the sensor to be shared

Returns:

human-readable String representation of last value

History

public void History(String sensor)

Method to view historical chart of the given sensor symbol

Specified by:

History in interface Handler

Parameters:

sensor - String of the symbol for which the history is being requested

See Also:

Handler.History(java.lang.String)

Discover

public void Discover()

Description copied from interface: Handler

Method to discover sensor symbols supported by a handler

Specified by:

Discover in interface Handler

destroyHandler

public void destroyHandler()

Method to release all handler resources Here, we release all semaphores and remove the phone state listener

Specified by:

destroyHandler in interface Handler

See Also:

Handler.destroyHandler()

onDataConnectionStateChanged

public void onDataConnectionStateChanged(int state)

Called when the data connection state has changed (e.g., being disconnected)

Parameters:

state - new state that has been detected

See Also:

PhoneStateListener

onSignalStrengthsChanged

public void onSignalStrengthsChanged(SignalStrength signalStrength)

Called when the signal strength has changed

Parameters:

signalStrength - strength of the newly detected signal. First, we get the ASU by calling getGsmSignalStrength(), then we calculate the dBm through dBm = -113 + 2* ASU

See Also:

PhoneStateListener

onCellLocationChanged

public void onCellLocationChanged(CellLocation location)

Called when the cell identifier or LAC changed - read the new value and release appropriate semaphore

Parameters:

location - Reference to the new CellLocation that has been detected

See Also:

PhoneStateListener