13.4. CTI routing configuration

Calls directed to Citobox can't be routed in transparent mode; internal clusters must be created and calls must be routed through packet voice resources.

[Note]Note

DTMF can be simulated by means of subaddress called field (SD). Digital output can be driven using DTMF tones. Configure the SD parameter of the rule which routes calls toward a Citobox CTIP port. Assigning the string DTMF=x (x is the desired dtmf in range 0..9 and A..D) to the SD parameter. The call will not be answered and will remain in ALERTING state. The call with be either dropped on T301 timeout or on abort from caller.

[Tip]Tip

Interesting chapters:

Section 43.6, “CTI Router”;

Section 43.4, “CTI Cluster”;

Section 43.5, “CTI Link”.

13.4.1. CTI Routing table configuration

Assume that:

  • Abilis has the following CTI ports configuration: ports 31 and 32 are toward the PBX, ports 33 and 34 toward the ISDN (grouped as BRI4_ports) and ports 101/102/103/104/105 are used to connect POTS phones.

  • internal clusters clus1 and clus2 are already created.

Type the following command to verify the ctig configuration:

[18:12:13] ABILIS_CPX:d ctig

--------------------------------------+--------------------+-------------------
 [DESCR:]
 ID: PICKUP: SCAN: RULE:              |P1  P2  P3  P4  P5  |P6  P7  P8  P9  ...
                                      |... P62 P63 P64
--------------------------------------+--------------------+-------------------
 PBX_group
 1   NO      R     ST                 |31  32  .   .   .   |.   .   .   .   .
--------------------------------------+--------------------+-------------------
 ISDN_line_group
 2   NO      R     ST                 |33  34  .   .   .   |.   .   .   .   .
--------------------------------------+--------------------+-------------------
 POTS_phones
 3   NO      R     ST                 |101 102 103 104 105 |.   .   .   .   .
--------------------------------------+--------------------+-------------------
...

Let's see some examples of CTIR configuration.

[Tip]Tip

Interesting chapter: Section 43.6, “CTI Router”;

13.4.1.1. CTIR from Citobox to a group of POTS phones

The following routings allow to route calls coming from the external door phone toward the group 3 of pots phones.

[18:22:32] ABILIS_CPX:a ctir pr:1 type:ctov sr:clus1 poo:g3 cdi:* sdi:CITOBOX241 sp:64000

COMMAND EXECUTED

[18:22:56] ABILIS_CPX:a ctir pr:3 type:vtoc poi:241 ds:clus2 cdi:00 sdo:CITOBOX241 sp:64000

COMMAND EXECUTED

[18:23:40] ABILIS_CPX:d ctir

- Not Saved (SAVE CONF), Not Refreshed (INIT) ---------------------------------

---+-----+-----------------+---------+--------------------+--------------------
PR |[DESCR]
   |TYPE |POI/SR   [SR]    |POO/DS   |CDI                 |CDO
ACT|NEXT       |LAST       |EEC |T301|CGI                 |CGO
EDT|SP   |SC   |DJ   |MJ   |FMDJ|FMMJ|SDI                 |SDO
   |SPOUT|SCOUT|DJOUT|MJOUT|LCS |LCST|SGI                 |SGO
   |                                 |RGI                 |RGO
   |FMRLY|FAXSP|MODSP|FMLVL|ECM |UDT |IG  |OG  |SG        |DL  |DH
   |CODERS
   |CODERSOUT
   |TI1 .. TI5
-------------------------------------------------------------------------------
0   DATA  *                 CtiSLink  *                    u*
-------------------------------------------------------------------------------
1   CtoV  GSM1              G3        *                    *
    NO          ANY         NO   Dft  *                    *
    64000 Sys   *     *     Sys  Sys  CITOBOX241           *
-------------------------------------------------------------------------------
...
-------------------------------------------------------------------------------
3   VtoC  241               GSM2      00                   *
    NO          ANY         NO   Dft  *                    *
    64000 Sys   Sys   Sys   Sys  Sys  *                    CITOBOX241
-------------------------------------------------------------------------------
...

The routing PR:3 routes calls coming from port 241 to internal cluster Clus2 introducing the label CITOBOX241 for SDO parameter.

[Tip]Tip

Interesting chapter: Section 43.6, “CTI Router”;

The routing PR:1 accepts calls from internal cluster Clus1 and forwards them to the group of POTS phones G3 only if SDI parameter is equal to CITOBOX241. Using SDO/SDI parameters make the admin sure that the routing PR:1 catches calls generated from PR:3.

Figure 13.1. CTIR from Citobox to pots phones

CTIR from Citobox to pots phones

13.4.1.2. CTIR from Citobox to a remote cluster

Example: there is one Abilis which is connected to a Citobox (ABILIS_CPX1) and to a remote Abilis (ABILIS_CPX2). Let's explain how to route a call from Citobox to a remote pots phone.

The following routing allows to route calls originated by the external door phone unit toward a remote cluster (e.g. Abilis2).

[18:33:54] ABILIS_CPX1:a ctir pr:3 type:vtoc poi:241 ds:Abilis2 cdi:00 sdo:CITOBOX241

COMMAND EXECUTED

[18:34:38] ABILIS_CPX:d ctir

---+-----+-----------------+---------+--------------------+--------------------
PR |[DESCR]
   |TYPE |POI/SR   [SR]    |POO/DS   |CDI                 |CDO
ACT|NEXT       |LAST       |EEC |T301|CGI                 |CGO
EDT|SP   |SC   |DJ   |MJ   |FMDJ|FMMJ|SDI                 |SDO
   |SPOUT|SCOUT|DJOUT|MJOUT|LCS |LCST|SGI                 |SGO
   |                                 |RGI                 |RGO
   |FMRLY|FAXSP|MODSP|FMLVL|ECM |UDT |IG  |OG  |SG        |DL  |DH
   |CODERS
   |CODERSOUT
   |TI1 .. TI5
-------------------------------------------------------------------------------
...
-------------------------------------------------------------------------------
3   VtoC  241               Abilis2   00                   *
    NO          ANY         NO   Dft  *                    *
    6400  Sys   Sys   Sys   Sys  Sys  *                    CITOBOX241
-------------------------------------------------------------------------------
...
-------------------------------------------------------------------------------

Obviously, the remote cluster must be correctly configured.

Add the following rule to the ctir of remote Abilis:

[10:29:28] ABILIS_CPX2:_a ctir pr:4 type:ctov sr:Abilis1 sdi:CITOBOX241 poo:pbx cdo:100

COMMAND EXECUTED

[10:30:02] ABILIS_CPX2:_d ctir

- Not Saved (SAVE CONF), Not Refreshed (INIT) ---------------------------------
Last change: 03/11/2010 10:30:02 CET

---+-----+-----------------+---------+--------------------+--------------------
PR |[DESCR]
   |TYPE |POI/SR   [SR]    |POO/DS   |CDI                 |CDO
ACT|NEXT       |LAST       |EEC |T301|CGI                 |CGO
EDT|SP   |SC   |DJ   |MJ   |FMDJ|FMMJ|SDI                 |SDO
   |SPOUT|SCOUT|DJOUT|MJOUT|LCS |LCST|SGI                 |SGO
   |                                 |RGI                 |RGO
   |FMRLY|FAXSP|MODSP|FMLVL|ECM |UDT |IG  |OG  |SG        |DL  |DH
   |CODERS
   |CODERSOUT
   |TI1 .. TI5
-------------------------------------------------------------------------------
...
-------------------------------------------------------------------------------
4   CtoV  Abilis1           PBX       00                   100
    NO          ANY         NO   Dft  *                    *
    6400  Sys   *     *     Sys  Sys  CITOBOX241           *
-------------------------------------------------------------------------------

This route catch a call incoming from remote cluster Abilis1 and route it to a pots phone whose number is 100. The figure below shows the route of the call:

Figure 13.2. Route of the call from citobox to remote Abilis

Route of the call from citobox to remote Abilis

13.4.1.3. CTIR from Citobox to a mobile phone using UMTS BOX

The following routing is useful to route a call from Citobox to a mobile phone. See the chapter Chapter 11, GSM-UMTS BOX to know how to connect and configure GSM/UMTS BOX.

Assume that ports 201 and 202 toward GSM/UMTS gateway:

[18:12:13] ABILIS_CPX:d ctig
ID: PICKUP: SCAN: RULE:
---------------------------+-------------------------+-------------------------
 [DESCR:]
 ID: SCAN: RULE: PICKUP:   |P1   P2   P3   P4   P5   |P6   P7   P8   P9   ...
                           |...  P62  P63  P64
---------------------------+-------------------------+-------------------------
...
---------------------------+-------------------------+-------------------------
 GSM_group
 3   NO    R     ST        |201  202  .    .    .    |.    .    .    .    .
---------------------------+-------------------------+-------------------------
[Warning]Warning

At this moment GSM or UMTS gateway supports only G.711 coder. Other codecs are supported by transcoding through additional ISDN cards.

Assume to have internal clusters loop1 and loop2:

[11:12:33] ABILIS_CPX:_d cticl

- Not Saved (SAVE CONF), Not Refreshed (INIT) ---------------------------------
Configured Clusters:4         Activated Clusters:16

---------+----------------------+---------+-----+-----------+------------------
CLUS:    |[DESCR:]
[Int]    |CG-IN-REWRITE:        |RG-IN:   |SS:  |LCS-GROUP: |CLIP-RULE:
         |NUM:                  |CPO:
         |NUMx:
---------+----------------------+---------+-----+-----------+------------------
...
-------------------------------------------------------------------------------
loop1     -                      DISABLE   NO    NONE        PRIVATE
[  1]     *                      NO
-------------------------------------------------------------------------------
loop2     -                      DISABLE   NO    NONE        PRIVATE
[  2]     *                      NO
-------------------------------------------------------------------------------

[11:17:43] ABILIS_CPX:_d ctil

Configured Links:4         Activated Links:16

ID: RES:        CLUS:    MAXBW:     MAXCON: GROUP: (GROUP-MAXBW: GROUP-MAXCON:)
-------------------------------------------------------------------------------
  1 Pv-1        loop1         NOMAX   NOMAX   NONE
  2 Pv-2        loop2         NOMAX   NOMAX   NONE
 ...

[15:00:09] ABILIS_CPX:d p pv-5

RES:Pv-5 - PV over IP (Abilis tunnel) (IP) ------------------------------------
Run    DESCR:Internal_Cluster_1
       - Link -----------------------------------------------------------------
       LLOG:DS       LMPX:YES         LC:YES         LCOMP:NO      LCR:NO
       LT1:3000      LT3:9000         LN2:3                        LCRKEY:DFT
       - IP Tunnel ------------------------------------------------------------
       TLOG:NO       MODE:STD         D-TOS:0-N      V-TOS:0-D     C-TOS:0-D
       MPX:YES
                     LOCPORT:3105     REMPORT:3106   CR:NO         CRKEY:DFT
       OUT-IP:AUTO
       LOCIPADD:R-ID (192.168.000.201)  REMIPADD:192.168.000.201

[15:00:15] ABILIS_CPX:d p pv-6

RES:Pv-6 - PV over IP (Abilis tunnel) (IP) ------------------------------------
Run    DESCR:Internal_Cluster_2
       - Link -----------------------------------------------------------------
       LLOG:DS       LMPX:YES         LC:YES         LCOMP:NO      LCR:NO
       LT1:3000      LT3:9000         LN2:3                        LCRKEY:DFT
       - IP Tunnel ------------------------------------------------------------
       TLOG:NO       MODE:STD         D-TOS:0-N      V-TOS:0-D     C-TOS:0-D
       MPX:YES
                     LOCPORT:3106     REMPORT:3105   CR:NO         CRKEY:DFT
       OUT-IP:AUTO
       LOCIPADD:R-ID (192.168.000.201)  REMIPADD:192.168.000.201

Add the following rules to CTI routing table:

[11:22:45] ABILIS_CPX:_a ctir pr:4 type:vtoc poi:241 ds:loop1 sdo:CITOBOX241 sp:64000

COMMAND EXECUTED

[11:23:15] ABILIS_CPX:_a ctir pr:5 type:ctoc sr:loop2 ds:loop1 cdi:* sdi:CITOBOX241 SDO:CITOBOX2412 sp:64000

COMMAND EXECUTED

[11:25:22] ABILIS_CPX:_a ctir pr:6 type:ctov sr:loop2 poo:g3 sdi:CITOBOX2412 cdi:* coders:g.711 sp:64000 cdi:* sc:no dj:0 mj:40

COMMAND EXECUTED

[11:31:02] ABILIS_CPX:_d ctire

- Not Saved (SAVE CONF), Not Refreshed (INIT) ---------------------------------
Last change: 03/11/2010 11:31:02 CET

-------------------------------------------------------------------------------
...
-------------------------------------------------------------------------------
PR:4   DESCR:
   ACT:YES            EDT:NO
   TYPE:VtoC          POI:241                      DS:loop1    EEC:NO
   NEXT:NO            CDI:00                       CDO:*
   LAST:ANY           CGI:*                        CGO:*
   T301:Dft           SDI:*                        SDO:CITOBOX241
   UDT:NO             SGI:*                        SGO:*
   LCS:NO   LCST:Sys  RGI:*                        RGO:*
   IG:Sys       OG:Sys      SG:Sys      DL:Sys       DH:Sys
   FMRLY:Sys    FAXSP:AUTO  MODSP:AUTO  FMLVL:Sys    FMDJ:Sys   FMMJ:Sys
   SP:64000     SC:Sys      DJ:Sys      MJ:Sys                  ECM:Sys
   CODERS:Sys
   TI1:ALL,00:00-23:59                TI2:#  TI3:#  TI4:#  TI5:#
-------------------------------------------------------------------------------
PR:5   DESCR:
   ACT:YES            EDT:NO
   TYPE:CtoC          SR:loop2                     DS:loop1    EEC:NO
   NEXT:NO            CDI:*                        CDO:*
   LAST:ANY           CGI:*                        CGO:*
   T301:Dft           SDI:CITOBOX241               SDO:CITOBOX2412
   UDT:NO             SGI:*                        SGO:*
   LCS:NO   LCST:Sys  RGI:*                        RGO:*
   FMRLY:Sys    FAXSP:AUTO  MODSP:AUTO  FMLVL:Sys    FMDJ:Sys   FMMJ:Sys
   SP:64000     SC:Sys      DJ:*        MJ:*                    ECM:Sys
   CODERS:*
   SPOUT:*      SCOUT:*     DJOUT:*     MJOUT:*
   CODERSOUT:*
   TI1:ALL,00:00-23:59                TI2:#  TI3:#  TI4:#  TI5:#
-------------------------------------------------------------------------------
PR:6   DESCR:
   ACT:YES            EDT:NO
   TYPE:CtoV          SR:loop2                     POO:G3       EEC:NO
   NEXT:NO            CDI:*                        CDO:32999999999
   LAST:ANY           CGI:*                        CGO:*
   T301:Dft           SDI:CITOBOX2412              SDO:*
   UDT:NO             SGI:*                        SGO:*
   LCS:NO   LCST:Sys  RGI:*                        RGO:*
   IG:Sys       OG:Sys      SG:Sys      DL:Sys       DH:Sys
   FMRLY:Sys    FAXSP:AUTO  MODSP:AUTO  FMLVL:Sys    FMDJ:Sys   FMMJ:Sys
   SP:64000     SC:NO       DJ:0        MJ:40                   ECM:Sys
   CODERS:G.711
   TI1:ALL,00:00-23:59                TI2:#  TI3:#  TI4:#  TI5:#

The rule PR:4 route a call incoming from Citobox to internal cluster loop1 adding a label 'CITOBOX241' to SDI parameter. Next rule (PR:5) route the call from internal cluster loop2 to loop1 keeping the SDO parameter equal to SDI one, while rule number 6 accepts calls from internal cluster loop1 and forwards them to GSM/UMTS gateway.

[Tip]Tip

Interesting chapter: Section 43.6, “CTI Router”;

The figure below shows the route of the call.

Figure 13.3. Call routing from Citobox to UMTSBOX

Call routing from Citobox to UMTSBOX