Skip to content
QiTASC.com /
Handover Box Steps
/
Handover Box Steps










Handover Boxes Steps

A Handover Box may contain one or more attenuators whose strength in decibels (dB) can be set and adjusted. The following steps can be used to control a Handover Box and its attenuators.

To use Handover Boxes in the custom languages, refer to the Attenuator Built-ins.

Handover Boxes
Handover Box Configuration
Set Attenuators
Fade Attenuator
Variable Handover

Handover Box Configuration

Syntax 

1
2
3
4
5
6
7
8
9
HandoverBoxes {
    <boxName> {
        type = <String>
        host = <String>
        port = <Number>

    }
...
}

Parameters

  • boxName - The name assigned to the Handover Box configuration

  • type - The type of Handover Box

    • Must be one of either "jfw", "mts" or rohdeSchwarz

  • host - The IP address or host name of the box

    • It is addressed via Ethernet using TCP

  • port - The box's port number

    • Default is set to 3001

Example 

1
2
3
4
5
6
7
HandoverBoxes {
    exampleBox {
        type = "jfw"
        host = "192.168.1.1"
        port = 3001
    }
}

Set Attenuators

This step sets one or more attenuators to the specified strength in decibels (dB).

Syntax 

1
2
on handover box <boxName Name> set attenuator <attenuator Number> to
    <dbValue Number>

Parameters

  • boxName - The name assigned to the Handover Box in the configuration

  • attenuator - The number that identifies the attenuator being set

  • dbValue - The strength in decibels the attenuator is being set to

    • Must be between 0 and 95

Example 

1
2
3
And on handover box box1 set attenuator 1 to 4

And on handover box box2 set attenuator1 to 0 and attenuator2 to 95

Fade Attenuator

This step allows a single attenuator to fade in strength over a certain period of time.

Syntax 

1
2
on handover box <boxName Name> fade attenuator <attenuator Number> from
    <startValue Number> to <endValue Number> in <duration Number> seconds
Parameters

  • boxName - The name assigned to the Handover Box in the configuration

  • attenuator - The number that identifies the attenuator being set

  • startValue - The strength in decibels the attenuator starts at

    • Must be between 0 and 95

  • endValue - The strength in decibels the attenuator ends at

    • Must be between 0 and 95

  • duration - The duration of the fade in seconds

    • Must be between 1 and 9999

Example 

1
And on handover box box2 fade attenuator 1 from 0 to 95 in 8 seconds

Variable Handover

This step simulates the handover between cells by decreasing one attenuator strength level while increasing the value of the second one.

Syntax 

1
2
3
on handover box <boxName Name> handover attenuator <attenuator1 Number> to
    <dbValue1 Number> and attenuator <attenuator2 Number> to <dbValue Number2> in
    <Duration Number> seconds

Parameters

  • boxName - The name assigned to the Handover Box in the configuration

  • attenuator1 - The first attenuator being used in the handover

  • dbValue1 - The strength in decibels that attenuator1 reaches at the end of the handover

    • Must be between 0 and 95

  • attenuator2 - The second attenuator being used in the handover

  • dbValue2 - The strength in decibels that attenuator2 reaches at the end of the handover

    • Must be between 0 and 95

  • duration - The duration of the handover in seconds

    • Must be between 1 and 9999

Example 

1
2
And on handover box box1 handover attenuator 1 to 0
and attenuator 2 to 95 in 8 seconds

In the example above, attenuator 1 starts at a strength level of 95 dB and reaches 0 by the end of the handover. attenuator 2 starts at a strength level of 0 dB and reaches 95.