12.1. UMTS-BOX devices activation

12.1. UMTS-BOX devices activation
	Chapter 12. UMTS BOX

UMTS-BOX is a device which allows to use mobile phone SIM cards with the Abilis.

UMTS-BOX activation are based on four devices: CELL32, CELL, CODEC and CONTROL.

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

Tip

Interesting chapters:

Section 3.7, “UMTS-BOX connection”;

Section 2.9.3, “UMTS-BOX2”;

12.1.1. CELL32 device

The activation of the CELL32 device adds in the Abilis system CTI ports from 501 to 532. Every CTI port corresponds to a SIM card which is managed by a UMTS modem.

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

[14:12:55] ABILIS_CPX:a dev:cell32-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:cell32-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 Eth-1  . . . . . . . . . . . . . . . . . . . .     9   PCI ( 11)
ETH-2      Yes Eth-2 . .  . . . . . . . . . . . . . . . . . .    11   PCI (  9)
BRI4-1     Yes 31..34 . . . . . . . . . . . . . . . . . . . .     6   PCI ( 10)
POTS-1     Yes 101..116 . . . . . . . . . . . . . . . . . . .     8   PCI ( 12)
CELL32-1   Yes 501..532 . . . . . . . . . . . . . . . . . . .  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
	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).

12.1.1.1. CTI 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:501

CTIP:501 DESCR:
Act     card:CELL32-1<1>                USER:#
Run     OPSTATE:UP        LOG:DS                               TYPE:NET-PUBLIC
        signalling:CELL                 HOLD:NO      
        VOICE-ROAMING:DISABLED     
        NUM:*                           ADDRBOOK-NUM:NUM
        CDO:#                           
        NET-MODE:AUTO     NET-SEL:AUTO       NET:
        PDN-MODE:AUTO     PDN-ROAMING:DISABLED
        PDN-APN:
        HOLD-ENABLE-LIST:#                   DIAL-IN-LIST:#


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

CTIP:501 DESCR:
Act     card:CELL32-1<1>                USER:#
Run     OPSTATE:UP        LOG:DS                               TYPE:NET-PUBLIC
        signalling:CELL                 HOLD:NO      
        VOICE-ROAMING:DISABLED     
        NUM:*                           ADDRBOOK-NUM:NUM
        CDO:#                           
        NET-MODE:AUTO     NET-SEL:AUTO       NET:
        PDN-MODE:AUTO     PDN-ROAMING:DISABLED
        PDN-APN:
        HOLD-ENABLE-LIST:#                   DIAL-IN-LIST:#
        LOOP:NO           PIN:#         GAIN-IN:SYS      CODEC-GAIN-IN:SYS
        DIALT:5           PIN2:#        GAIN-OUT:SYS     CODEC-GAIN-OUT:SYS
        LCS-GROUP:NONE    BUSY-NOCHAN:NO

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 UMTS devices so a fixed value is used [CELL].

HOLD

Activate HOLD/RETRIEVE feature [NO, YES]

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 isn't passed to the device;
r*: enforces the presentation restricted: the Calling Number isn't 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]

ADDRBOOK-NUM

Address book phone number assigned to this port. "#" or "NUM" or from 1 up to 20 digits ['0'..'9'], optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] and/or PI [a, r, m, q] and/or SI [y, v, w, z] attributes or 'macro'. (E.g.: 0'NUM' or 123'NUM.s2' or 'NUM'99)

SIM-SEL

SIM selection method [SIM-A, SIM-B, AUTO]

NET-MODE

Locks the AcT (Access Technology) mode or leaves the module to choose the better available [AUTO, GSM, UMTS, LTE]

NET-SEL

Method to select the network to be used [AUTO, MANUAL, PREFERRED]

NET

Network operator name or code. From 0 up to 16 alphanumeric extended characters. Case is preserved. Spaces are allowed. Strings holding spaces must be written between quotation marks. For GSMBOX use only network operator code.

PDN-ROAMING

Enable/disable roaming for data [DISABLED, ENABLED]

PDN-APN

APN string to be used in the AT+CGDCONT command. From 0 up to 63 alphanumeric extended characters. Case is preserved. Spaces are allowed. Strings holding spaces must be written between quotation marks.

PDN-MODE

Enforce the mode or allow to choose the better available [AUTO, GPRS, UMTS, LTE]

HOLD-ENABLE-LIST

List of remote numbers allowed to hold the call, valid for incoming and outgoing calls with those numbers. "#" or "*" or the name of an IN/INR/RU/MR list. Numbers can be specified in the list in any of the three formats: u + INT-PREFIX + COUNTRY-CODE + number (e.g. u00391111) u + number (e.g. u1111), for numbers in same COUNTRY-CODE of CTISYS i + COUNTRY-CODE + number (e.g. i391111)

DIAL-IN-LIST

List of remote numbers to be enabled to the DIAL-IN service. When these numbers calls they will receive a DIALTONE and they can dial any number via DTMF. "#" or "*" or the name of an IN/INR/RU/MR list. Numbers can be in list in the same way as for HOLD-ENABLE-LIST.

LOOP

activate Loopback mode [NO, GSM, CODEC].

PIN

PIN of the SIM card.

PIN2

PIN2 of the SIM card.

GAIN-IN

Input gain adjustment [SYS, MUTE, -84..+6 dB]

GAIN-OUT

Output gain adjustment [SYS, MUTE, -84..+6 dB]

CODEC-GAIN-IN

Audio-codec input gain adjustment [SYS, MUTE, -126..+32 dB]

CODEC-GAIN-OUT

Audio-codec output gain adjustment [SYS, MUTE, -59..+5 dB]

DIALT

Dialling timeout [1..15 sec]

LCS-GROUP

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

BUSY-NOCHAN

Return BUSY cause instead of NOCHAN [NO, IN, OUT, BOTH]

	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
	In order to avoid that the SIM card gets blocked it's ALWAYS better to remove the PIN code and all additional services (e.g.: messagebox). Interesting chapter: Section 75.9.2, “How does Abilis manage the PIN code of a SIM card?”

	Tip
	Typically, the default configuration of a CTI UMTS port already allows the UMTS-BOX to work properly.

12.1.2. CELLBOX fake device

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

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: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 Eth-1  . . . . . . . . . . . . . . . . . . .      9   PCI (  5)
ETH-2       Yes Eth-2  . . . . . . . . . . . . . . . . . . .      8   PCI ( 10)
BRI4-1      Yes 31..34 . . . . . . . . . . . . . . . . . . .     12   PCI ( 10)
POTS-1      Yes 101..116 . . . . . . . . . . . . . . . . . .     11   PCI (  9)
CELL32-1    Yes 501..532 . . . . . . . . . . . . . . . . . .   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           501..502 . . . . . . . . . . . . . . .
 CELL-1     No  No  .  . . . . . . . . . . . . . . . . . . NONE
 CELL-2     No  No  .  . . . . . . . . . . . . . . . . . . NONE
 CODEC-1    No  No  .  . . . . . . . . . . . . . . . . . . NONE
 CONTROL-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
	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).

12.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 Eth-1  . . . . . . . . . . . . . . . . . . .      9   PCI (  5)
ETH-2       Yes Eth-2  . . . . . . . . . . . . . . . . . . .      8   PCI ( 10)
BRI4-1      Yes 31..34 . . . . . . . . . . . . . . . . . . .     12   PCI ( 10)
POTS-1      Yes 101..116 . . . . . . . . . . . . . . . . . .     11   PCI (  9)
CELL32-1    Yes 501..532 . . . . . . . . . . . . . . . . . .   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           501..502 . . . . . . . . . . . . . . .
 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
	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
	It's recommended to use the CELLBOX command to add all devices needed with a single instruction.

12.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 associates 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 Eth-1  . . . . . . . . . . . . . . . . . . .      9   PCI (  5)
ETH-2       Yes Eth-2  . . . . . . . . . . . . . . . . . . .      8   PCI ( 10)
BRI4-1      Yes 31..34 . . . . . . . . . . . . . . . . . . .     12   PCI ( 10)
POTS-1      Yes 101..116 . . . . . . . . . . . . . . . . . .     11   PCI (  9)
CELL32-1    Yes 501..532 . . . . . . . . . . . . . . . . . .   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           501..502 . . . . . . . . . . . . . . .
 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
	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
	It's recommended to use the CELLBOX command to add all devices needed with a single instruction.

12.1.5. CONTROL device

CONTROL is used to manage the microcontroller which is inside UMTS-BOX. Currently it's used only in UMTS-BOX to reset the UMTS modules in case of troubles.

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:control-1. This command associates the CONTROL-1 to the CODEC-1 device.

[15:29:52] ABILIS_CPX:a dev:control-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 Eth-1  . . . . . . . . . . . . . . . . . . .      9   PCI (  5)
ETH-2       Yes Eth-2  . . . . . . . . . . . . . . . . . . .      8   PCI ( 10)
BRI4-1      Yes 31..34 . . . . . . . . . . . . . . . . . . .     12   PCI ( 10)
POTS-1      Yes 101..116 . . . . . . . . . . . . . . . . . .     11   PCI (  9)
CELL32-1    Yes 501..532 . . . . . . . . . . . . . . . . . .   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           501..502 . . . . . . . . . . . . . . .
 CELL-1     No  No  .  . . . . . . . . . . . . . . . . . . NONE
 CELL-2     No  No  .  . . . . . . . . . . . . . . . . . . NONE
 CODEC-1    No  No  .  . . . . . . . . . . . . . . . . . . NONE
 CONTROL-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
	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
	It's recommended to use the CELLBOX command to add all devices needed with a single instruction.