49.2. CTI Ports

49.2. CTI Ports
	Chapter 49. CTI System

49.2.1. ISDN Ports configuration

When an ISDN device (QPRIX, BRI8, BRI4, BSE, …) is added in the configuration also its related CTI ports are activated (for further information refer to Section 5.5, “Devices”).

The following command modifies the parameters of a CTI port:

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

Here is an example of configuration of a BRI card.

[12:38:14] ABILIS_CPX:s p ctip:31 side:NT line:PP descr:to_PBX

COMMAND EXECUTED

[12:38:14] ABILIS_CPX:s p ctip:33 side:TE line:PP descr:to_ISDN_line

COMMAND EXECUTED

The commands d p ctip ? or d p ctipe ? shows available parameters.

[12:38:14] ABILIS_CPX:d p ctip:31

CTIP:31  - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:to_PBX
Run     card:BRI4-1<1>
        OPSTATE:UP        LOG:DS        side:NT      line:PP   TYPE:USER
        signalling:DSS1   TEI:STANDARD  HOLD:YES     CT:NO     SS:NO 
        mode:Bri                        BUS:SHORT    
        NUM:*                           ADDRBOOK-NUM:NUM
        BCHANS:ALL-BID

[12:38:14] ABILIS_CPX:d p ctip:33

CTIP:33  - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:to_ISDN_line
Run     card:BRI4-1<3>
        OPSTATE:UP        LOG:DS        side:TE      LINE:PP   TYPE:NET-PUBLIC
        signalling:DSS1   TEI:STANDARD  HOLD:NO                SS:NO 
        mode:Bri          L12-ACT:UP    BUS:SHORT    
        NUM:*                           ADDRBOOK-NUM:NUM
        BCHANS:ALL-BID

[16:24:15] ABILIS_CPX:d p ctipe:31

CTIP:31  - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:to_PBX
Run     card:BRI4-1<1>    
        OPSTATE:UP        LOG:DS        side:NT      line:PP   TYPE:USER
        signalling:DSS1   TEI:STANDARD  HOLD:YES     CT:NO     SS:NO 
        mode:Bri                        BUS:SHORT    
        NUM:*                           ADDRBOOK-NUM:NUM
        BCHANS:ALL-BID
        X25:NO   (XTEI:10)   XK:7      XN200:3   xn201:260  XN202:3
                 XT200:1     XT202:2   XT203:10
        Q931:YES (QTEI:0)    QK:1      QN200:3   qn201:260  QN202:3   QT200:1
                 QT202:2     QT203:10  TDISC:90  QT301:180  QT302:15  QT303:4
                 QT304:30    QT305:30  QT308:4   QT310:30   QT313:6   QT316:15
                 DIALT:5     scrst:YES ORCD:0    ICT-T1:500  ICT-T2:500
        SQNRTY1:15           SQDELAY1:30         SQDELAY2:5    
        LCS-GROUP:NONE       BUSY-NOCHAN:NO      OUTDIAL-TONE:SYS
        SS-PICKUP:GROUPS               SS-PRES-CG:YES       NPOO-CT:SYS
        SS-CF-DND:YES                  SS-VM:YES            CLIP-RULE:PRIVATE

[16:24:24] ABILIS_CPX:d p ctipe:33

CTIP:33  - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:to_ISDN_line
Run     card:BRI4-1<3>    
        OPSTATE:UP        LOG:DS        side:TE      LINE:PP   TYPE:NET-PUBLIC
        signalling:DSS1   TEI:STANDARD  HOLD:NO                SS:NO 
        mode:Bri          L12-ACT:UP    BUS:SHORT    
        NUM:*                           ADDRBOOK-NUM:NUM
        BCHANS:ALL-BID
        X25:NO   (XTEI:10)   XK:7      XN200:3   xn201:260  XN202:3
                 XT200:1     XT202:2   XT203:10
        Q931:YES (QTEI:0)    QK:1      QN200:3   qn201:260  QN202:3   QT200:1
                 QT202:2     QT203:10  TDISC:90  QT301:180  QT302:15  QT303:4
                 QT304:30    QT305:30  QT308:4   QT310:30   QT313:6   QT316:15
                 DIALT:5     scrst:YES ORCD:0    ICT-T1:500  ICT-T2:500
        SQNRTY1:15           SQDELAY1:30         SQDELAY2:5    
        LCS-GROUP:NONE       BUSY-NOCHAN:NO      OUTDIAL-TONE:SYS
        SS-PICKUP:GROUPS               SS-PRES-CG:YES       NPOO-CT:SYS
        SS-CF-DND:YES                  SS-VM:YES            CLIP-RULE:PRIVATE

Meaning of the most important parameters:

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

side

Port behaviour [TE: if the port is connected to an ISDN line; NT: if the port is connected to a PBX].

LINE

Line type [MP if the line is Multi-Point; PP if the line is Point-to-Point].

TYPE

Assigned role [USER, NET-PRIVATE, NET-PUBLIC].

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;
##: 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;
nnnn*: the Calling Number received from CTIR is modified by replacing first four digits with nnnn;
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.

SS

Enable/disable supplementary services accessible through "*" as first digit in called number [NO, YES].

SS-PICKUP

Supplementary service. Pickup permissions [NO, GROUP, ANY].

SS-CF-DND

Supplementary service. Call forwarding and Do-Not-Disturb [NO, YES].

SS-PRES-CG

Supplementary service. Calling present [NO, YES].

OUT-DIAL-TONE

Enable/disable the outside dial tone generation [SYS, NO, YES] <Only for mode: equal to E1-ISDN, Bri or Pots>.

LCS-GROUP

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

Tip

Interesting chapters:

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

Section 15.3, “Last Calling Service for UMTSBOX”;

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

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

49.2.2. Analog Ports configuration (POTS)

When a POTS device (POTS, BSE, POTSBOX …) is added in the configuration also its related CTI ports are activated (for further information refer to Section 5.5, “Devices”).

The following command modifies the parameters of a CTI port:

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

Here is an example of configuration of a POTS port.

[20:47:01] ABILIS_CPX:s p ctip:101 num:11 user:11 descr:phone_1

COMMAND EXECUTED

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

[20:47:01] ABILIS_CPX:d p ctip:101

CTIP:101  - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:phone_1
Run     card:POTS-1<1>                  USER:11
        OPSTATE:UP        LOG:NO                               TYPE:USER
        signalling:POTS                 HOLD:YES     CT:ICT    SS:YES
        DEVICE:PHONE                                           AC:NO
        NUM:11                          ADDRBOOK-NUM:NUM


[20:47:59] ABILIS_CPX:d p ctipe:101

CTIP:101 - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:phone_1
Run     card:BSE-1<9>                   USER:11
        OPSTATE:UP        LOG:NO                               TYPE:USER
        signalling:POTS                 HOLD:YES     CT:ICT    SS:YES
        DEVICE:PHONE                                           AC:NO
        NUM:11                          ADDRBOOK-NUM:NUM
        AC-CDO:#                        AC-DLY:60
        LOOP:NO         TEST:NO           
        CLIP:SYS        CLIP-STD:SYS      CLIP-TAS:SYS    CLIP-LEVEL:SYS
        SENSING:SYS     ABF:SYS  HPF:SYS  DEBOUNCE:SYS    MIN-FLASH:SYS   
        COUNTRY:SYS                                       MAX-FLASH:SYS   
        DIALT:5         IN-GAIN-ADJ:SYS                   OUT-GAIN-ADJ:SYS
        AT:SYS          AT-CODE:SYS     AT-DURATION:SYS   BC:SYS
        DT:SYS          DT-CODE:SYS     DT-DURATION:SYS   OUTDIAL-TONE:SYS
        SS-PICKUP:GROUPS                SS-PRES-CG:YES    NPOO-CT:SYS
        SS-CF-DND:YES                   SS-VM:YES

Meaning of the most important parameters:

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

USER

Name of the user assigned to this port. From 1 up to 32 ASCII characters or "#". The user must be present and it must not be already assigned to another port.

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;
##: 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;
nnnn*: the Calling Number received from CTIR is modified by replacing first four digits with nnnn;
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.

SS

Enable/disable supplementary services accessible through "*" as first digit in called number [NO, YES].

SS-PICKUP

Supplementary service. Pickup permissions [NO, GROUP, ANY].

SS-CF-DND

Supplementary service. Call forwarding and Do-Not-Disturb [NO, YES].

SS-PRES-CG

Supplementary service. Calling present [NO, YES].

SS-VM

Supplementary service. Voice Mail [NO, YES].

DEVICE

Device mode [PHONE, HEADSET, CITO, HOTEL-PHONE]. HOTEL-PHONE is used to generate an alarm when ground start is made.

OUT-DIAL-TONE

Enable/disable the outside dial tone generation [SYS, NO, YES] <Only for mode: equal to E1-ISDN, Bri or Pots>.

CLIP

Caller Identification Presentation [NO, YES, EXT, SYS].

MIN-FLASH

Minimal duration of the on-hook transition to detect a FLASH [SYS, 50..1000 ms].

MAX-FLASH

Maximal duration of the on-hook transition to detect a FLASH [SYS, 50..1000 ms].

IN-GAIN-ADJ

Input (Receive) gain adjustment respect to the gain present in the country coefficient file [SYS, MUTE, COUNTRY, -12..+12 dB].

OUT-GAIN-ADJ

Output (Transmit) gain adjustment respect to the gain present in the country coefficient file [SYS, MUTE, COUNTRY, -12..+12 dB].

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

49.2.3. GSM/UMTS/LTE Ports configuration

When a GSM/UMTS/LTE device (UMTS-BOX, CELLKEY, etc.) is added in the configuration also its related CTI ports are activated (for further information refer to Section 5.5, “Devices”).

The following command modifies the parameters of a CTI port:

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

Here is an example of configuration of a UMTS port.

[11:24:30] ABILIS_CPX:s p ctip:501 net-mode:umts descr:SIM_1

COMMAND EXECUTED

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

[11:30:30] ABILIS_CPX:d p ctip:501

CTIP:501 DESCR:SIM_1
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:UMTS     NET-SEL:AUTO       NET:
        PDN-MODE:AUTO     PDN-ROAMING:DISABLED
        PDN-APN:
        HOLD-ENABLE-LIST:#                   DIAL-IN-LIST:#

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, UMTS-GSM].

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

Tip

Interesting chapters:

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

Section 15.3, “Last Calling Service for UMTSBOX”;

Section 52.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 78.10.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.


49.1. CTI System Overview		49.3. CTI Group