17.1. UMTS-BOX device activation

17.1. UMTS-BOX device activation
	Chapter 17. UMTS BOX

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

UMTS-BOX activation is 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.9, “UMTS-BOX connection”;

Section 2.14.4, “UMTS-BOX2”;

17.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:cell32-1 ALREADY ACTIVE

[14:17:30] ABILIS_CPX:d dev

--------------- Active Watchdog and MFxx Resources (read only): ---------------
Device(s)   Run Physical Resource(s)                         SlotId  Addr  Irq
-------------------------------------------------------------------------------
MF          Yes Mf . . . . . . . . . . . . . . . . . . . . .      -  AC00   19
MFIO        No  MfIo . . . . . . . . . . . . . . . . . . . .      -  AC00   19

------------------ Active PCI Devices and Physical Resources: -----------------
Device(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 ( 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
-------------------------------------------------------------------------------
DSLUSB-1   Yes Yes Dsl-1  . . . . . . . . . . . . . . . . 0.0.0


-------------- Inactive Watchdog and MFxx Resources (read only): --------------
Device(s)   Run Physical Resource(s)                         SlotId  Addr  Irq
-------------------------------------------------------------------------------
                     *** NO INACTIVE WATCHDOGs PRESENT ***                     

----------------- Inactive PCI Devices and Physical Resources: ----------------
Device(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 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).

17.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

State changes log and alarm generation [NO, D, S, A, L, T, ALL] [+E] (D: Debug Log; S: System Log; A: Alarm view; L: Local audible alarm; T: SNMP traps; +E: Extended Log of state changes, see ref. manual).

TYPE

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

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 this port, in the format [aaaa]nnn[,m] where:

'aaaa': optional attribute(s) 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].
'nnn': number, max 20 characters ['0'..'9', '?' '*'] or #. The '*' is allowed only alone or as the last character. Any number of '?' are allowed, but only alone or at the end of the sequence. (E.g. # or * or 1234* or ????? or 5678??? or 555345).
'm': optional value in the range [-1, +1], corresponding to the increment/decrement to be applied at any step, when setting the number of a group of ports. It is allowed only when 'nnn' is a sequence of digits and it is no longer than 9 digits. (E.g. ne01,+1 or ieq60100,-1).

See also HELP ISDN ATTRIBUTES and HELP ISDN VALUES.

VOICE-ROAMING:

Enable/disable roaming for voice [DISABLED, ENABLED].

ADDRBOOK-NUM

Address book phone number assigned to this port. # or NUM or max 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).

See also HELP ISDN ATTRIBUTES and HELP ISDN VALUES.

SIM-SEL

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

	Note
	Only for CELLBOX devices.

NET-MODE

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

NET-SEL

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

NET

Network operator name or code. Max 16 ASCII characters. Spaces require double quotes (E.g. "aaa bbb"). 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. Max 63 ASCII characters. Spaces require double quotes (E.g. "aaa bbb").

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 call 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 the list in the same way as for HOLD-ENABLE-LIST.

LOOP

Loopback type [NO, GSM, CODEC].

DIALT

Dialling timeout [1..15 sec].

PIN

PIN of the SIM card. # or from 4 to 8 digits [0..9]

PIN2

PIN2 of the SIM card. # or from 4 to 8 digits [0..9]

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, -126..+32 dB].

LCS-GROUP

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

Tip

Interesting chapters:

Section 84.18, “How to configure Last Calling Service”;

Section 17.3, “Last Calling Service for UMTSBOX”;

Section 61.5.6, “Last Calling Service for a SIP user”.

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 87.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.

17.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 Watchdog and MFxx Resources (read only): ---------------
Device(s)   Run Physical Resource(s)                         SlotId  Addr  Irq
-------------------------------------------------------------------------------
MF          Yes Mf . . . . . . . . . . . . . . . . . . . . .      -  AC00   19
MFIO        No  MfIo . . . . . . . . . . . . . . . . . . . .      -  AC00   19

------------------ Active PCI Devices and Physical Resources: -----------------
Device(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
-------------------------------------------------------------------------------
DSLUSB-1    Yes No  Dsl-1  . . . . . . . . . . . . . . . . 0.0.0
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 Watchdog and MFxx Resources (read only): --------------
Device(s)   Run Physical Resource(s)                         SlotId  Addr  Irq
-------------------------------------------------------------------------------
                     *** NO INACTIVE WATCHDOGs PRESENT ***                     

----------------- Inactive PCI Devices and Physical Resources: ----------------
Device(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).

17.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 Watchdog and MFxx Resources (read only): ---------------
Device(s)   Run Physical Resource(s)                         SlotId  Addr  Irq
-------------------------------------------------------------------------------
MF          Yes Mf . . . . . . . . . . . . . . . . . . . . .      -  AC00   19
MFIO        No  MfIo . . . . . . . . . . . . . . . . . . . .      -  AC00   19

------------------ Active PCI Devices and Physical Resources: -----------------
Device(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
-------------------------------------------------------------------------------
DSLUSB-1    Yes No  Dsl-1  . . . . . . . . . . . . . . . . 0.0.0
CELLBOX-1           501..502 . . . . . . . . . . . . . . .
 CELL-1     No  No  .  . . . . . . . . . . . . . . . . . . NONE
 CELL-2     No  No  .  . . . . . . . . . . . . . . . . . . NONE


-------------- Inactive Watchdog and MFxx Resources (read only): --------------
Device(s)   Run Physical Resource(s)                         SlotId  Addr  Irq
-------------------------------------------------------------------------------
                     *** NO INACTIVE WATCHDOGs PRESENT ***                     

----------------- Inactive PCI Devices and Physical Resources: ----------------
Device(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.

17.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 Watchdog and MFxx Resources (read only): ---------------
Device(s)   Run Physical Resource(s)                         SlotId  Addr  Irq
-------------------------------------------------------------------------------
MF          Yes Mf . . . . . . . . . . . . . . . . . . . . .      -  AC00   19
MFIO        No  MfIo . . . . . . . . . . . . . . . . . . . .      -  AC00   19

------------------ Active PCI Devices and Physical Resources: -----------------
Device(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
-------------------------------------------------------------------------------
DSLUSB-1    Yes No  Dsl-1  . . . . . . . . . . . . . . . . 0.0.0
CELLBOX-1           501..502 . . . . . . . . . . . . . . .
 CELL-1     No  No  .  . . . . . . . . . . . . . . . . . . NONE
 CELL-2     No  No  .  . . . . . . . . . . . . . . . . . . NONE
 CODEC-1    No  No  .  . . . . . . . . . . . . . . . . . . NONE


-------------- Inactive Watchdog and MFxx Resources (read only): --------------
Device(s)   Run Physical Resource(s)                         SlotId  Addr  Irq
-------------------------------------------------------------------------------
                     *** NO INACTIVE WATCHDOGs PRESENT ***                     

----------------- Inactive PCI Devices and Physical Resources: ----------------
Device(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.

17.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 Watchdog and MFxx Resources (read only): ---------------
Device(s)   Run Physical Resource(s)                         SlotId  Addr  Irq
-------------------------------------------------------------------------------
MF          Yes Mf . . . . . . . . . . . . . . . . . . . . .      -  AC00   19
MFIO        No  MfIo . . . . . . . . . . . . . . . . . . . .      -  AC00   19

------------------ Active PCI Devices and Physical Resources: -----------------
Device(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
-------------------------------------------------------------------------------
DSLUSB-1    Yes No  Dsl-1  . . . . . . . . . . . . . . . . 0.0.0
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 Watchdog and MFxx Resources (read only): --------------
Device(s)   Run Physical Resource(s)                         SlotId  Addr  Irq
-------------------------------------------------------------------------------
                     *** NO INACTIVE WATCHDOGs PRESENT ***                     

----------------- Inactive PCI Devices and Physical Resources: ----------------
Device(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.