def execute_external_handover(self):
"""
This function performs an external handover.
:raise TestEquipmentException: call to ExecuteExternalHandover2G driver function failed
"""
(err, msg) = W.ExecuteExternalHandover(self.get_root())
self.__error_check(err, msg)
def set_band(self, band):
"""
Sets the band.
:type band: str
:param band: the band to use. Possible values:
- "TGSM380": not supported
- "TGSM410": not supported
- "GSM450"
- "GSM480"
- "GSM710": not supported
- "GSM750"
- "TGSM810"
- "GSM850"
- "PGSM"
- "EGSM"
- "RGSM"
- "TGSM": not supported
- "DCS"
- "PCS"
"""
agilent_band = self.AGILENT_8960_BANDS.get(band)
if (agilent_band is None) or (agilent_band == "UNSUPPORTED"):
msg = "Band %s is not supported" % (str(band))
self.get_logger().error(msg)
raise TestEquipmentException(
TestEquipmentException.INVALID_PARAMETER, msg)
(err, msg) = W.SetBand(self.get_root(), agilent_band)
self.__error_check(err, msg)
def set_periodic_location_update_timer(self, period):
"""
Sets the periodic location update timer
:type period: integer
:param period: timer value in decihours (0 to 255)
"""
(err, msg) = W.SetPeriodicLocationUpdateTimer(self.get_root(), period)
self.__error_check(err, msg)
def set_paging_multiframe(self, mrf):
"""
Sets paging multiframe
:type mrf: integer
:param mrf: number of multiframes paging subchannels (2 to 9)
"""
(err, msg) = W.SetPagingMultiframe(self.get_root(), mrf)
self.__error_check(err, msg)
def set_ca_table(self, ca_table):
"""
Sets the CA table
:type ca_table: array
:param ca_table: the CA table to set
"""
(err, msg) = W.SetCaTable(self.get_root(), ca_table)
self.__error_check(err, msg)
def set_tch_arfcn(self, arfcn):
"""
Sets the traffic channel ARFCN
:type arfcn: integer
:param arfcn: the TCH arfcn to set
"""
(err, msg) = W.SetTchArfcn(self.get_root(), arfcn)
self.__error_check(err, msg)
def set_pdtch_arfcn(self, arfcn):
"""
Sets the packet data traffic channel ARFCN
:type arfcn: integer
:param arfcn: the ARFCN of the downlink and uplink PDTCH to set.
"""
(err, msg) = W.SetPdtchArfcn(self.get_root(), arfcn)
self.__error_check(err, msg)
def set_bcch_arfcn(self, arfcn):
"""
Sets broadcast control channel ARFCN
:type arfcn: integer
:param arfcn: the ARFCN value to set
"""
(err, msg) = W.SetBchArfcn(self.get_root(), arfcn)
self.__error_check(err, msg)
def set_mcc(self, code):
"""
Sets the mobile country code.
:type code: integer
:param code: the mobile country code to set. An integer from 0 to 999.
"""
(err, msg) = W.SetMCCode(self.get_root(), code)
self.__error_check(err, msg)
def set_lac(self, lac):
"""
Sets the local area code.
:type lac: long
:param lac: local area code to set.
"""
(err, msg) = W.SetLAC(self.get_root(), lac)
self.__error_check(err, msg)
def set_ms_tx_level(self, tx_level):
"""
Sets the mobile station Tx level
:type tx_level: integer
:param tx_level: value of the Tx level to set
"""
(err, msg) = W.SetMSTxLevel(self.get_root(), tx_level)
self.__error_check(err, msg)
def get_lac(self):
"""
Gets the local area code.
:rtype: long
:return: the local area code.
"""
(err, lac, msg) = W.GetLAC(self.get_root())
self.__error_check(err, msg)
return lac
def set_mnc(self, code):
"""
Sets the mobile network code.
:type code: integer
:param code: the mobile network code to set.
An integer from 0 to 999 when band is set to PCS or GSM850.
An integer from 0 to 99 for other bands.
"""
(err, msg) = W.SetMNCode(self.get_root(), code)
self.__error_check(err, msg)
def set_frequency_hopping_state(self, state):
"""
Sets frequency hopping state
:type state: str
:param state: the desired state. Possible values:
- "ON"
- "OFF"
"""
(err, msg) = W.SetFrequencyHoppingState(self.get_root(), state)
self.__error_check(err, msg)
def get_tx_power(self):
"""
Gets Tx power
:rtype: str
:return: the str representation of TX power or "NA" if the value
wasn't available when queried
"""
(err, power, msg) = W.GetTxPower(self.get_root())
self.__error_check(err, msg)
return power
def set_dtm_state(self, state):
"""
Sets DTM state
:raise TestEquipmentException: call to SetDtmState driver function failed
:type state: str
:param state: the desired state:
- "ON"
- "OFF"
"""
(err, msg) = W.SetDtmState(self.get_root(), state)
self.__error_check(err, msg)
def set_cell_service(self, service):
"""
Sets the cell service
:type service: str
:param service: the cell service to set. Possible values:
- "GSM"
- "GPRS"
- "EGPRS"
"""
(err, msg) = W.SetServingCell(self.get_root(), service)
self.__error_check(err, msg)
def set_cell_power(self, power):
"""
Sets the power level of the broadcast channel of the cell in dBm
:type power: double
:param power: the cell power to set. Possible values:
- "GSM"
- "GPRS"
- "EGPRS"
"""
(err, msg) = W.SetCellPower(self.get_root(), power)
self.__error_check(err, msg)
def set_channel_mode(self, chan_mode):
"""
Sets the channel mode
:type chan_mode: str
:param chan_mode: channel mode to use. Possible values are:
- "FRSP"
- "EFRS"
- "HRSP"
"""
(err, msg) = W.SetChannelMode(self.get_root(), chan_mode)
self.__error_check(err, msg)
def set_dtx(self, state):
"""
Wraps to 2G SetDtx function
:type state: str
:param state: str representation of the desired state.
Possible values:
- "ON"
- "OFF"
:rtype: integer
:return: error code of the driver function
:raise TestEquipmentException: call to SetDtx
driver function failed
"""
(err, msg) = W.SetDtx(self.get_root(), state)
self.__error_check(err, msg)
def is_dut_registered(self, dut_imsi):
"""
Test if DUT is synchronized with equipment
:type dut_imsi : str
:param dut_imsi : IMSI retrieved from CDK.
:rtype: boolean
:return:
- true if the DUT is synchronized with the equipment
- false otherwise
"""
dut_imsi = dut_imsi.replace('\n', '')
dut_imsi = dut_imsi.replace('"', '')
(err, imsi, msg) = W.GetReportedIMSI(self.get_root())
self.__error_check(err, msg)
imsi = imsi.replace('"', '') # pylint: disable=E1101
return imsi == dut_imsi
def set_ba_table(self, ba_table, bch_band):
"""
Sets the CA table
:type ba_table: array
:param ba_table: the BA table to set
:type bch_band: str
:param bch_band: str representation of the BCH band. Possible values:
- "DCS"
- "EGSM"
- "GSM450"
- "GSM480"
- "GSM750"
- "GSM850"
- "PCS"
- "PGSM"
- "DCS"
- "RGSM"
- "TGSM810" => BECAREFUL (not supported for the moment)
"""
(err, msg) = W.SetBaTable(self.get_root(), ba_table, bch_band)
self.__error_check(err, msg)
def set_cell_off(self):
"""
Turns off the cell
"""
(err, msg) = W.SetCellOff(self.get_root())
self.__error_check(err, msg)
def init_orfs_measurement(self):
"""
Inits ORFS measurement
"""
(err, msg) = W.InitOrfsMeasurement(self.get_root())
self.__error_check(err, msg)
def set_cell_on(self, mimo=None):
"""
Turns on the cell
"""
(err, msg) = W.SetCellActive(self.get_root())
self.__error_check(err, msg)