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:
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].
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). |
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:
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). |
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].
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 76.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. |