# Copyright (c) 2011 The Chromium OS Authors. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.

"""Base class interface for base station emulators."""

# This is essentially all documentation; no code (other than raise
# NotImplementedError()) should go here."""

import cellular


class BaseStationInterface(object):
  """A generic base station emulator."""
  def Start(self):
    raise NotImplementedError()

  def Stop(self):
    raise NotImplementedError()

  def GetAirStateVerifier(self):
    return air_state_verifier.AirStateVerifierPermissive(self)

  def SetBsIpV4(self, ip1, ip2):
    """Sets basestation IPv4 addresses."""
    raise NotImplementedError()

  def SetBsNetmaskV4(self, netmask):
    """Sets basestation netmask."""
    raise NotImplementedError

  def SetFrequencyBand(self, band):
    """Sets the frequency used by the BS.  BS must be stopped.

    Arguments:
      band:  A band number, from the UMTS bands summarized at
        http://en.wikipedia.org/wiki/UMTS_frequency_bands
        Use band 5 for 800MHz C2k/EV-DO,  2 for 1900MHz C2k/EV-DO
    """
    raise NotImplementedError()

  def SetPlmn(self, mcc, mnc):
    """Sets the mobile country and network codes.  BS must be stopped."""
    raise NotImplementedError()

  def SetPower(self, dbm):
    """Sets the output power of the base station.

    Arguments:
      dbm:  Power, in dBm.  See class Power for useful constants.
    """
    raise NotImplementedError()

  def SetUeDnsV4(self, dns1, dns2):
    """Set the DNS values provided to the UE.  Emulator must be stopped."""
    raise NotImplementedError()

  def SetUeIpV4(self, ip1, ip2=None):
    """Set the IP addresses provided to the UE.  Emulator must be stopped."""
    raise NotImplementedError()

  def GetUeDataStatus(self):
    """Gets the data call status of the UE."""
    raise NotImplementedError()

  def PrepareForStatusChange(self):
    """Prepare for a future call to WaitForStatusChange.

    There's a race in WaitForStatusChange; if we tell the modem to
    connect, it might connect before we get around to calling
    PrepareForStatusChange.

    As a special case for 8960, this tells the instrument to make the
    next GetUeStatus call block on a status change.
    """
    raise NotImplementedError()

  def WaitForStatusChange(self,
                          interested=None,
                          timeout=cellular.DEFAULT_TIMEOUT):
    """When UE status changes (to a value in interested), return the value.

    Arguments:
        interested: if non-None, only transitions to these states will
          cause a return
        timeout: in seconds.
    """
    raise NotImplementedError()

  def WaitForSmsReceive(self,
                        timeout=cellular.DEFAULT_TIMEOUT):
    """Return received SMS is received from the UE.

    Arguments:
      timeout:  in seconds.
    """
    raise NotImplementedError()

  def SendSms(self,
              message,
              o_address=cellular.SmsAddress('8960'),
              dcs=0xf0):
    """Sends the supplied SMS message."""
    raise NotImplementedError()

  def SetUeIpV4(self, ip, ip2=None):
    """Sets the IP address assigned to the user equipment.

    Arguments:
      ip:  IP address, as a dotted-quad string.
      ip2:  Secondary IP address.  Not set if not supplied
    """
    raise NotImplementedError()