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


Copyright © 2009 Eurotech Inc. All rights reserved.