43.2. CTI Ports configuration

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

The following command modifies the parameters of a CTI port:

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

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

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:32 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

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

COMMAND EXECUTED

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

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

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

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

CTIP:34  - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:to_ISDN_line
Run     card:BRI4-1<4>
        OPSTATE:UP        LOG:NO        side:TE      LINE:MP   TYPE:NET-PUBLIC
        signalling:DSS1   TEI:STANDARD  HOLD:NO      CT:NO     SS:NO
        mode:Bri          L12-ACT:AUTO  BUS:SHORT    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:NO        side:NT      line:PP   TYPE:USER
        signalling:DSS1   TEI:STANDARD  HOLD:YES     CT:BOTH   SS:NO 
        mode:Bri                        BUS:SHORT    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      OUT-DIAL-TONE:SYS
        SS-PICKUP:GROUP      SS-PRES-CG:YES      NP-CT:NO    CLIP-RULE:PRIVATE
        SS-CF-DND:YES        

[16:24:19] ABILIS_CPX:d p ctipe:32

CTIP:32  - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:to_PBX
Run     card:BRI4-1<2>    
        OPSTATE:UP        LOG:NO        side:NT      line:PP   TYPE:USER
        signalling:DSS1   TEI:STANDARD  HOLD:NO      CT:NO     SS:NO 
        mode:Bri                        BUS:SHORT    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      OUT-DIAL-TONE:SYS
        SS-PICKUP:GROUP      SS-PRES-CG:YES      NP-CT:NO    CLIP-RULE:PRIVATE
        SS-CF-DND:YES        

[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:NO        side:TE      LINE:PP   TYPE:NET-PUBLIC
        signalling:DSS1   TEI:STANDARD  HOLD:NO      CT:NO     SS:NO 
        mode:Bri          L12-ACT:AUTO  BUS:SHORT    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      OUT-DIAL-TONE:SYS
        SS-PICKUP:GROUP      SS-PRES-CG:YES      NP-CT:NO    CLIP-RULE:PRIVATE
        SS-CF-DND:YES        

[16:24:25] ABILIS_CPX:d p ctipe:34

CTIP:34  - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:to_ISDN_line
Run     card:BRI4-1<4>    
        OPSTATE:UP        LOG:NO        side:TE      LINE:PP   TYPE:NET-PUBLIC
        signalling:DSS1   TEI:STANDARD  HOLD:NO      CT:NO     SS:NO 
        mode:Bri          L12-ACT:AUTO  BUS:SHORT    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      OUT-DIAL-TONE:SYS
        SS-PICKUP:GROUP      SS-PRES-CG:YES      NP-CT:NO    CLIP-RULE:PRIVATE
        SS-CF-DND: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)

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

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;

  • ##: 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;

  • 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] <Only for mode: not equal to Pots>

Here is an example of configuration of a POTS port.

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

COMMAND EXECUTED

[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>
        OPSTATE:UP        LOG:NO                               TYPE:USER
        signalling:POTS                 HOLD:YES     CT:ICT    SS:YES
        mode:Pots                                    NUM:18

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

CTIP:101 - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:phone_1
Run     card:POTS-1<1>    
        OPSTATE:UP        LOG:NO                               TYPE:USER
        signalling:POTS                 HOLD:YES     CT:ICT    SS:YES
        mode:Pots                                    NUM:18
        LOOP:NO         TEST:NO         
        CLIP:SYS        CLIP-STD:SYS      CLIP-TAS:SYS    MIN-FLASH:SYS   
        SENSING:SYS     ABF:SYS  HPF:SYS  DEBOUNCE:SYS    MAX-FLASH:SYS   
        COUNTRY:SYS                  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      OUT-DIAL-TONE:SYS
        SS-PICKUP:GROUP SS-PRES-CG:YES                    NP-CT:SYS   
        SS-CF-DND: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)

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;

  • ##: 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;

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

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