com.esf.device.modem.service
Interface IModemService

All Superinterfaces:

ICellularModemService, IUsbModemService

All Known Subinterfaces:

I3gModemService, IEvdoModemService, IMC572xModemService

public interface IModemService

extends IUsbModemService, ICellularModemService

Defines generic modem service

Author:

ilya.binshtok

Field Summary

static java.lang.String	NEW_CONFIGURATION_TOPIC Modem driver publishes EventAdmin Event on this topic after it receives and processes new configuration event from configuration manager.
static java.lang.String	SERVICE_NAME service name of this interface for the bundle activator (com.esf.device.modem.service.IModemService)

Method Summary

void	applyNewConfiguration(java.util.Properties prop)
void	connect() Establishes connection with service provider by starting PPP session
void	disconnect() Terminates connection with service provider by stopping PPP session
long	getCallRxCounter() Reports number of bytes received during a call
long	getCallTxCounter() Reports number of bytes tarnsmitted during a call
java.lang.String	getIPaddress() Reports IP address assigned to cellular interface
java.lang.String	getNetworkTechnology() Reports network technology (e.g. evdo, 3g)
java.lang.String	getPeerIPaddress() Reports IP address of the peer
java.lang.String	getPowerMode() Answers modem's power mode.
java.lang.String	getServiceType() Reports Service Type
int	getSignalStrength() Reports signal strength in dBm
boolean	isConnected() Answers if connection to the service provider is established
boolean	isConnecting() Reports if modem connection is in progress
boolean	isRoaming() Reports roaming status
void	reset() resets the modem and tries to restore the state of the modem driver.
void	turnOff() Turns modem off
void	turnOn() Turns modem on

Methods inherited from interface com.esf.device.modem.service.IUsbModemService

getProductID, getUsbPortAddress, getVendorID

Methods inherited from interface com.esf.device.modem.service.ICellularModemService

disable, enable, getManufacturer, getModel, getRevisionID, getSerialNumber, isEnabled, isOn

Field Detail

SERVICE_NAME

public static final java.lang.String SERVICE_NAME

service name of this interface for the bundle activator (com.esf.device.modem.service.IModemService)

NEW_CONFIGURATION_TOPIC

public static final java.lang.String NEW_CONFIGURATION_TOPIC

Modem driver publishes EventAdmin Event on this topic after it receives and processes new configuration event from configuration manager. This event to be picked up by application (business logic) code to make a decision whether to restart modem connection.

See Also:

Constant Field Values

Method Detail

applyNewConfiguration

public void applyNewConfiguration(java.util.Properties prop)
                           throws java.lang.Exception

Throws:

java.lang.Exception

getNetworkTechnology

public java.lang.String getNetworkTechnology()

Reports network technology (e.g. evdo, 3g)

Returns:

- network technology as String

turnOn

public void turnOn()
            throws java.lang.Exception

Turns modem on

Throws:

java.lang.Exception

turnOff

public void turnOff()
             throws java.lang.Exception

Turns modem off

Throws:

java.lang.Exception

reset

public void reset()
           throws java.lang.Exception

resets the modem and tries to restore the state of the modem driver. (e.g. PPP connection, status thread)

Throws:

java.lang.Exception

connect

public void connect()
             throws java.lang.Exception

Establishes connection with service provider by starting PPP session

Throws:

java.lang.Exception

disconnect

public void disconnect()
                throws java.lang.Exception

Terminates connection with service provider by stopping PPP session

Throws:

java.lang.Exception

isConnected

public boolean isConnected()
                    throws java.lang.Exception

Answers if connection to the service provider is established

Returns:

boolean
true - connection is established
false - connection is not established

Throws:

java.lang.Exception

isConnecting

public boolean isConnecting()
                     throws java.lang.Exception

Reports if modem connection is in progress

Returns:

boolean
true - modem connection is in progress
false - modem is not connecting

Throws:

java.lang.Exception

getPowerMode

public java.lang.String getPowerMode()
                              throws java.lang.Exception

Answers modem's power mode. (e.g. ONLINE, OFFLINE, LPM)

Returns:

modem power mode

Throws:

java.lang.Exception

getIPaddress

public java.lang.String getIPaddress()
                              throws java.lang.Exception

Reports IP address assigned to cellular interface

Returns:

dotted-decimal IP address
null - if no IP address is assigned

Throws:

java.lang.Exception

getPeerIPaddress

public java.lang.String getPeerIPaddress()
                                  throws java.lang.Exception

Reports IP address of the peer

Returns:

dotted-decimal IP address
null - if no IP address is assigned

Throws:

java.lang.Exception

getSignalStrength

public int getSignalStrength()
                      throws java.lang.Exception

Reports signal strength in dBm

Returns:

signal strength

Throws:

java.lang.Exception

isRoaming

public boolean isRoaming()
                  throws java.lang.Exception

Reports roaming status

Returns:

true - modem is roaming false - modem is not roaming

Throws:

java.lang.Exception

getServiceType

public java.lang.String getServiceType()
                                throws java.lang.Exception

Reports Service Type

Returns:

service indication

Throws:

java.lang.Exception

getCallTxCounter

public long getCallTxCounter()
                      throws java.lang.Exception

Reports number of bytes tarnsmitted during a call

Returns:

number of bytes transmitted

Throws:

java.lang.Exception

getCallRxCounter

public long getCallRxCounter()
                      throws java.lang.Exception

Reports number of bytes received during a call

Returns:

number of bytes received

Throws:

java.lang.Exception