11.1. GSM-BOX and UMTS-BOX devices activation
Prev Chapter 11. GSM-UMTS BOX Next

11.1. GSM-BOX and UMTS-BOX devices activation

GSM-BOX and UMTS-BOX are devices which allow to use mobile phone SIM cards with the Abilis.

GSM-BOX and UMTS-BOX activation are based on four devices: UG, CELL, CODEC and SIMEMU.

In addition there is a fake device named CELLBOX which acts as a container of all the devices that belongs to a GSM-BOX or UMTS-BOX; easily it permits to activate CELL, CODEC and SIMEMU devices with a single command.

[Tip]Tip

Interesting chapters:

Section 3.7, “UMTS-BOX connection”;

Section 2.10.2, “UMTS-BOX2”;

Section 2.10.3, “GSM Box”;

Section 2.10.6, “Simbox”;

Chapter 12, Simbox.

11.1.1. UG device

The activation of the UG device adds in the Abilis system CTI ports from 201 to 232. Every CTI port corresponds to a SIM card which is managed by a GSM/UMTS modem.

Add the device to the Abilis system with the following command.

[14:12:55] ABILIS_CPX:a dev:ug-1

COMMAND EXECUTED

The device may already exist in the system, but may not yet be active. Set it active with the command:

[14:13:02] ABILIS_CPX:s act dev:ug-1

DEV:GSM-1 ALREADY ACTIVE

[14:17:30] ABILIS_CPX:d dev

---------------- Active ISA/PCI Cards and Physical Resources: -----------------
Card(s)    Run Physical Resource(s)/CTI Port(s)              SlotId  Addr  Irq
-------------------------------------------------------------------------------
ASY-1      Yes Async-1  . . . . . . . . . . . . . . . . . . .     -   3F8    4
ETH-1      Yes Eth100-1 . . . . . . . . . . . . . . . . . . .     9   PCI ( 11)
ETH-2      Yes Eth100-2 . . . . . . . . . . . . . . . . . . .    11   PCI (  9)
BRI4-1     Yes 31..34 . . . . . . . . . . . . . . . . . . . .     6   PCI ( 10)
POTS-1     Yes 101..116 . . . . . . . . . . . . . . . . . . .     8   PCI ( 12)
UG-1       Yes 201..232 . . . . . . . . . . . . . . . . . . .  NONE   PCI (  -)

------------------ Active USB Devices and Physical Resources: -----------------
Device(s)  Run Con Physical Resource(s) or Device(s)       USBPORTID
-------------------------------------------------------------------------------
ADSLUSB-1  Yes Yes Adsl-1  . . . . . . . . . . . . . . . . 0.0.0
ADSLUSB-2  Yes Yes Adsl-2  . . . . . . . . . . . . . . . . 0.1


--------------- Inactive ISA/PCI Cards and Physical Resources: ----------------
Card(s)    Run Physical Resource(s)/CTI Port(s)              SlotId  Addr  Irq
-------------------------------------------------------------------------------
                   *** NO INACTIVE ISA/PCI CARDs PRESENT ***

----------------- Inactive USB Devices and Physical Resources: ----------------
Device(s)  Run Con Physical Resource(s) or Device(s)       USBPORTID
-------------------------------------------------------------------------------
                    *** NO INACTIVE USB DEVICEs PRESENT ***
[Caution]Caution

After adding or setting the device active, you must restart the Abilis to make the device running (use the command warm start to reboot the Abilis).

11.1.1.1. CTI GSM/UMTS port configuration

Use the following command to modify the parameters of a CTI port:

s p ctip:<port_number> <parameter>:<value>

The d p ctip ? or d p ctipe ? commands show all available parameters.

[06:33:10] ABILIS_CPX:d p ctip:201

CTIP:201 DESCR:
Act     card:UG-1<1>
Run     OPSTATE:UP        LOG:NO                               TYPE:NET-PUBLIC
        signalling:CELL
        mode:CELL         VOICE-ROAMING:DISABLED     NUM:*
        PDN-MODE:AUTO     PDN-ROAMING:DISABLED
        PDN-APN:
        RSIM:NO

[06:33:14] ABILIS_CPX:d p ctipe:201

CTIP:202 DESCR:
Act     card:UG-1<2>
Run     OPSTATE:UP        LOG:DS                               TYPE:USER
        signalling:CELL
        mode:CELL         VOICE-ROAMING:DISABLED     NUM:*
        PDN-MODE:AUTO     PDN-ROAMING:DISABLED
        PDN-APN:tre.it
        LOOP:NO           PIN:#         GAIN-IN:SYS      CODEC-GAIN-IN:SYS
        DIALT:5           PIN2:#        GAIN-OUT:SYS     CODEC-GAIN-OUT:SYS
        RSIM:NO
        LCS-GROUP:NONE

Meaning of the most important parameters:

OPSTATE

operative state [DOWN: the port is inoperative (it refuses incoming calls and doesn't allow outgoing calls); UP: the port is fully operative].

LOG

Logging functionalities activation/deactivation.

TYPE

Sets the port type with respect to the customer's network [USER, NET-PUBLIC].

signalling

Selects the port signalling protocol; only the AT-protocol is available for GSM/UMTS devices so a fixed value is used [CELL].

mode

Selects the layer 1 protocol mode; for GSM/UMTS is used a fixed value [CELL].

NUM

Phone number assigned to CTI port. The available values are:

  • *: the Calling Number offered by CTIR is passed transparently to the device;

  • #: the Calling Number is not passed to the device;

  • r*: enforces the presentation restricted: the Calling Number is not passed to the device;

  • nnnn: exactly this number is passed as Calling Number to the device; attributes can be specified as number prefixes

  • nnnn*: the Calling Number received from CTIR is modified by replacing first four digits with nnnn; attributes can be specified as number prefixes

  • nnnn??: similar to nnnn* with the difference that only an exact number of digits as many ? is passed after nnnn;

  • ????: only an exact number of digits as many ? is passed after the nnnn.

VOICE-ROAMING:

Enable/disable roaming for voice [DISABLED, ENABLED]

PDN-ROAMING

Enable/disable roaming for data [DISABLED, ENABLED]

PDN-APN

APN string to be used in the data connection

PDN-MODE

Locks the PDN mode or leaves HC15 to choose the better available [AUTO, GPRS, UMTS]

LOOP

activate Loopback mode [NO, GSM, CODEC].

PIN

PIN of the SIM card.

PIN2

PIN2 of the SIM card.

GAIN-IN

port input gain controlled by the GSM/UMTS module.

GAIN-OUT

port output gain controlled by the GSM/UMTS module.

CODEC-GAIN-IN

GSM/UMTS port input gain controlled by the Audio-codec

CODEC-GAIN-OUT

GSM/UMTS port input gain controlled by the Audio-codec

DIALT

Dialling timeout.

RSIM

SIM remotization activation and method [NO, PERMANENT, DYNAMIC]

LCS-GROUP

Last Calling number Service group identifier [NONE, 1..32]

[Caution]Caution

To activate the changes made on the upper case parameters, execute the initialization command init ctisys; while to set act the changes made on the lowercase parameters a save conf and an Abilis restart are required (i.e. with warm start command).

[Caution]Caution

In order to avoid that the SIM card gets blocked It is ALWAYS better to remove the PIN code and all additional services (e.g.: messagebox)

[Tip]Tip

Typically, the default configuration of CTI GSM/UMTS port already allows the GSM-BOX or UMTS-BOX to work properly.

11.1.2. CELLBOX fake device

CELLBOX device can be activated for every GSM-BOX or UMTS-BOX to add all devices needed for each equipment with a single command: CELL, CODEC and SIMEMU.

Add the device to the Abilis system with the following command.

The device may already exist in the system, but may not yet be active. Set it active with the command s act dev:cellbox-1.

[14:24:03] ABILIS_CPX:a dev:cellbox-1

COMMAND EXECUTED

[14:24:05] ABILIS_CPX:da dev

------------------ Active PCI Cards and Physical Resources: -------------------
Card(s)     Run Physical Resource(s) or CTI Port(s)          SlotId  Addr  Irq
-------------------------------------------------------------------------------
ASY-1       Yes Async-1  . . . . . . . . . . . . . . . . . .      -   3F8    4
ETH100-1    Yes Eth100-1 . . . . . . . . . . . . . . . . . .      9   PCI (  5)
ETH100-2    Yes Eth100-2 . . . . . . . . . . . . . . . . . .      8   PCI ( 10)
BRI4-1      Yes 31..34 . . . . . . . . . . . . . . . . . . .     12   PCI ( 10)
POTS-1      Yes 101..116 . . . . . . . . . . . . . . . . . .     11   PCI (  9)
UG-1        Yes 201..232 . . . . . . . . . . . . . . . . . .   NONE   PCI (  -)

------------------ Active USB Devices and Physical Resources: -----------------
Device(s)   Run Con Physical Resource(s) or CTI Port(s)    USBPORTID
-------------------------------------------------------------------------------
ADSLUSB-1   Yes No  Adsl-1 . . . . . . . . . . . . . . . . 0.0.0
ADSLUSB-2   Yes No  Adsl-2 . . . . . . . . . . . . . . . . 0.1
CELLBOX-1           201..202 . . . . . . . . . . . . . . .
 CELL-1     No  No  .  . . . . . . . . . . . . . . . . . . NONE
 CELL-2     No  No  .  . . . . . . . . . . . . . . . . . . NONE
 CODEC-1    No  No  .  . . . . . . . . . . . . . . . . . . NONE
 SIMEMU-1   No  No  .  . . . . . . . . . . . . . . . . . . NONE


----------------- Inactive PCI Cards and Physical Resources: ------------------
Card(s)     Run Physical Resource(s) or CTI Port(s)          SlotId  Addr  Irq
-------------------------------------------------------------------------------
                     *** NO INACTIVE PCI CARDs PRESENT ***

----------------- Inactive USB Devices and Physical Resources: ----------------
Device(s)   Run Con Physical Resource(s) or CTI Port(s)    USBPORTID
-------------------------------------------------------------------------------
                    *** NO INACTIVE USB DEVICEs PRESENT ***
[Caution]Caution

After adding or setting the device active, you must restart the Abilis to make the device running (use the command warm start to reboot the Abilis).

11.1.3. CELL device

CELL devices must be activated for every SIM card connected to the Abilis CPX.

Add the device to the Abilis system with the following command.The device may already exist in the system, but may not yet be active: set it active with the command s act dev:cell-1.

[14:24:03] ABILIS_CPX:a dev:cell-1

COMMAND EXECUTED

[14:29:07] ABILIS_CPX:a dev:cell-2

COMMAND EXECUTED

[14:48:31] ABILIS_CPX:d dev

------------------ Active PCI Cards and Physical Resources: -------------------
Card(s)     Run Physical Resource(s) or CTI Port(s)          SlotId  Addr  Irq
-------------------------------------------------------------------------------
ASY-1       Yes Async-1  . . . . . . . . . . . . . . . . . .      -   3F8    4
ETH-1       Yes Eth100-1 . . . . . . . . . . . . . . . . . .      9   PCI (  5)
ETH-2       Yes Eth100-2 . . . . . . . . . . . . . . . . . .      8   PCI ( 10)
BRI4-1      Yes 31..34 . . . . . . . . . . . . . . . . . . .     12   PCI ( 10)
POTS-1      Yes 101..116 . . . . . . . . . . . . . . . . . .     11   PCI (  9)
UG-1        Yes 201..232 . . . . . . . . . . . . . . . . . .   NONE   PCI (  -)

------------------ Active USB Devices and Physical Resources: -----------------
Device(s)   Run Con Physical Resource(s) or CTI Port(s)    USBPORTID
-------------------------------------------------------------------------------
ADSLUSB-1   Yes No  Adsl-1 . . . . . . . . . . . . . . . . 0.0.0
ADSLUSB-2   Yes No  Adsl-2 . . . . . . . . . . . . . . . . 0.1
CELLBOX-1           201..202 . . . . . . . . . . . . . . .
 CELL-1     No  No  .  . . . . . . . . . . . . . . . . . . NONE
 CELL-2     No  No  .  . . . . . . . . . . . . . . . . . . NONE


----------------- Inactive PCI Cards and Physical Resources: ------------------
Card(s)     Run Physical Resource(s) or CTI Port(s)          SlotId  Addr  Irq
-------------------------------------------------------------------------------
                     *** NO INACTIVE PCI CARDs PRESENT ***

----------------- Inactive USB Devices and Physical Resources: ----------------
Device(s)   Run Con Physical Resource(s) or CTI Port(s)    USBPORTID
-------------------------------------------------------------------------------
                    *** NO INACTIVE USB DEVICEs PRESENT ***
[Caution]Caution

After adding or setting the device active, you must restart the Abilis to make the device running (use the command warm start to reboot the Abilis).

[Tip]Tip

It is recommended to use the CELLBOX command to add all devices needed with a single instruction

11.1.4. CODEC device

CODEC represents the GSM/UMTS interface that connects GSM/UMTS modems to the Abilis through USB ports. Every device enables the connection of 2 modems. The associations between CELL and CODEC and USBPORTIDs is completely automatic, thus avoiding any error in the assignment.

Add the device to the Abilis system with the following command; the device may already exist in the system, but may not yet be active: set it active with the command s act dev:codec-1. This command associate the CODEC-1 to the CELL-1 and CELL-2 devices.

[15:29:52] ABILIS_CPX:a dev:codec-1

COMMAND EXECUTED

[15:32:31] ABILIS_CPX:d dev
------------------ Active PCI Cards and Physical Resources: -------------------
Card(s)     Run Physical Resource(s) or CTI Port(s)          SlotId  Addr  Irq
-------------------------------------------------------------------------------
ASY-1       Yes Async-1  . . . . . . . . . . . . . . . . . .      -   3F8    4
ETH-1       Yes Eth100-1 . . . . . . . . . . . . . . . . . .      9   PCI (  5)
ETH-2       Yes Eth100-2 . . . . . . . . . . . . . . . . . .      8   PCI ( 10)
BRI4-1      Yes 31..34 . . . . . . . . . . . . . . . . . . .     12   PCI ( 10)
POTS-1      Yes 101..116 . . . . . . . . . . . . . . . . . .     11   PCI (  9)
UG-1        Yes 201..232 . . . . . . . . . . . . . . . . . .   NONE   PCI (  -)

------------------ Active USB Devices and Physical Resources: -----------------
Device(s)   Run Con Physical Resource(s) or CTI Port(s)    USBPORTID
-------------------------------------------------------------------------------
ADSLUSB-1   Yes No  Adsl-1 . . . . . . . . . . . . . . . . 0.0.0
ADSLUSB-2   Yes No  Adsl-2 . . . . . . . . . . . . . . . . 0.1
CELLBOX-1           201..202 . . . . . . . . . . . . . . .
 CELL-1     No  No  .  . . . . . . . . . . . . . . . . . . NONE
 CELL-2     No  No  .  . . . . . . . . . . . . . . . . . . NONE
 CODEC-1    No  No  .  . . . . . . . . . . . . . . . . . . NONE


----------------- Inactive PCI Cards and Physical Resources: ------------------
Card(s)     Run Physical Resource(s) or CTI Port(s)          SlotId  Addr  Irq
-------------------------------------------------------------------------------
                     *** NO INACTIVE PCI CARDs PRESENT ***

----------------- Inactive USB Devices and Physical Resources: ----------------
Device(s)   Run Con Physical Resource(s) or CTI Port(s)    USBPORTID
-------------------------------------------------------------------------------
                    *** NO INACTIVE USB DEVICEs PRESENT ***
[Caution]Caution

After adding or setting the device active, you must restart the Abilis to make the device running (use the command warm start to reboot the Abilis).

[Tip]Tip

It is recommended to use the CELLBOX command to add all devices needed with a single instruction

11.1.5. SIMEMU device

SIMEMU is used to manage the microcontroller which is inside GSM-BOX or UMTS-BOX. Currently it is used only in UMTS-BOX to reset the UMTS modules in case of troubles, in next version it will be used to manage SIM remotization.

Add the device to the Abilis system with the following command; the device may already exist in the system, but may not yet be active: set it active with the command s act dev:simemu-1. This command associate the SIMEMU-1 to the CODEC-1 device.

[15:29:52] ABILIS_CPX:a dev:simemu-1

COMMAND EXECUTED

[15:32:31] ABILIS_CPX:d dev

------------------ Active PCI Cards and Physical Resources: -------------------
Card(s)     Run Physical Resource(s) or CTI Port(s)          SlotId  Addr  Irq
-------------------------------------------------------------------------------
ASY-1       Yes Async-1  . . . . . . . . . . . . . . . . . .      -   3F8    4
ETH-1       Yes Eth100-1 . . . . . . . . . . . . . . . . . .      9   PCI (  5)
ETH-2       Yes Eth100-2 . . . . . . . . . . . . . . . . . .      8   PCI ( 10)
BRI4-1      Yes 31..34 . . . . . . . . . . . . . . . . . . .     12   PCI ( 10)
POTS-1      Yes 101..116 . . . . . . . . . . . . . . . . . .     11   PCI (  9)
UG-1        Yes 201..232 . . . . . . . . . . . . . . . . . .   NONE   PCI (  -)

------------------ Active USB Devices and Physical Resources: -----------------
Device(s)   Run Con Physical Resource(s) or CTI Port(s)    USBPORTID
-------------------------------------------------------------------------------
ADSLUSB-1   Yes No  Adsl-1 . . . . . . . . . . . . . . . . 0.0.0
ADSLUSB-2   Yes No  Adsl-2 . . . . . . . . . . . . . . . . 0.1
CELLBOX-1           201..202 . . . . . . . . . . . . . . .
 CELL-1     No  No  .  . . . . . . . . . . . . . . . . . . NONE
 CELL-2     No  No  .  . . . . . . . . . . . . . . . . . . NONE
 CODEC-1    No  No  .  . . . . . . . . . . . . . . . . . . NONE
 SIMEMU-1   No  No  .  . . . . . . . . . . . . . . . . . . NONE


----------------- Inactive PCI Cards and Physical Resources: ------------------
Card(s)     Run Physical Resource(s) or CTI Port(s)          SlotId  Addr  Irq
-------------------------------------------------------------------------------
                     *** NO INACTIVE PCI CARDs PRESENT ***

----------------- Inactive USB Devices and Physical Resources: ----------------
Device(s)   Run Con Physical Resource(s) or CTI Port(s)    USBPORTID
-------------------------------------------------------------------------------
                    *** NO INACTIVE USB DEVICEs PRESENT ***
[Caution]Caution

After adding or setting the device active, you must restart the Abilis to make the device running (use the command warm start to reboot the Abilis).

[Tip]Tip

It is recommended to use the CELLBOX command to add all devices needed with a single instruction

Prev Up Next
Chapter 11. GSM-UMTS BOX Home 11.2. CTI Routing configuration