13.3. CTI port configuration

Assuming that the cti port #241 has been added by the activation of citobox device, type d p ctip:241 ? to view a short description of the most important parameters in the citobox section.

....

---------- CITOBOX ------------------------------------------------------------
MORE-BUTTONS: Digital input lines of additional buttons [1..8]. Line values
           can be joined using ',' character or grouped using '-' character.
Lx-ON:     DTMF code to set digital output [0..9, *, #, A..D] or empty
Lx-OFF:    DTMF code to reset digital output [0..9, *, #, A..D] or empty
Lx-PULSE:  DTMF code to make a pulse on digital output [0..9, *, #, A..D] or
           empty
Lx-PULSE-T: Pulse duration on digital output [1..4294967295 ms]
Lx-PULSE-GAP: Gap duration on digital output [1..65535 ms]
CITO-GAIN-IN: Input gain adjustment [SYS, MUTE, -126..+32 dB]
CITO-GAIN-OUT: Output gain adjustment [SYS, MUTE, -59..+5 dB]
CITO-ES:   Echo suppressor activation [SYS, NO, YES]
CITO-ES-RISE-OUT: Echo suppressor output line rise time [SYS, 0..1000 ms]
CITO-ES-FALL-OUT: Echo suppressor output line fall time [SYS, 0..1000 ms]
CITO-ES-THR-OUT: Echo suppressor output line threshold [SYS, -126..0 dB]
[Tip]Tip

Interesting chapter: Section 43.2, “CTI Ports configuration”.

Example: additional ring buttons are connected to inputs 1,2,3,4, where the number assigned to the CTIP is 999901 (used as calling number) and where DTMF 5 is used to drive an output which generates a 1 second pulse used to open the door.

[11:58:52] ABILIS_CPX:_s ctip:241 more-buttons:1,2,3,4 num:999901 l1-pulse:5

COMMAND EXECUTED

[12:00:00] ABILIS_CPX:_d p ctip:241

CTIP:241 - Not Saved (SAVE CONF)---------------------------------------------
Act     DESCR:
        card:CB-1<1>
        OPSTATE:UP        LOG:NO                               TYPE:USER
        signalling:CITO
        mode:CITO                                    NUM:999901
        MORE-BUTTONS:1,2,3,4
        L1-ON:   L1-OFF:   L1-PULSE:5  L1-PULSE-T:1000       L1-PULSE-GAP:250
        L2-ON:   L2-OFF:   L2-PULSE:   L2-PULSE-T:1000       L2-PULSE-GAP:250
        L3-ON:   L3-OFF:   L3-PULSE:   L3-PULSE-T:1000       L3-PULSE-GAP:250
        L4-ON:   L4-OFF:   L4-PULSE:   L4-PULSE-T:1000       L4-PULSE-GAP:250
        CITO-GAIN-IN:SYS         CITO-GAIN-OUT:SYS
        CITO-ES:SYS
        CITO-ES-RISE-OUT:SYS     CITO-ES-FALL-OUT:SYS     CITO-ES-THR-OUT:SYS

[12:00:00] ABILIS_CPX:_d p ctip:241 ?

...
---------- CITOBOX ------------------------------------------------------------
MORE-BUTTONS: Digital input lines of additional buttons [1..8]. Line values
           can be joined using ',' character or grouped using '-' character.
Lx-ON:     DTMF code to set digital output [0..9, *, #, A..D] or empty
Lx-OFF:    DTMF code to reset digital output [0..9, *, #, A..D] or empty
Lx-PULSE:  DTMF code to make a pulse on digital output [0..9, *, #, A..D] or
           empty
Lx-PULSE-T: Pulse duration on digital output [1..4294967295 ms]
Lx-PULSE-GAP: Gap duration on digital output [1..65535 ms]
CITO-GAIN-IN: Input gain adjustment [SYS, MUTE, -126..+32 dB]
CITO-GAIN-OUT: Output gain adjustment [SYS, MUTE, -59..+5 dB]
CITO-ES:   Echo suppressor activation [SYS, NO, YES]
CITO-ES-RISE-OUT: Echo suppressor output line rise time [SYS, 0..1000 ms]
CITO-ES-FALL-OUT: Echo suppressor output line fall time [SYS, 0..1000 ms]
CITO-ES-THR-OUT: Echo suppressor output line threshold [SYS, -126..0 dB]

Initialize the CTISYS resource with the command init res:ctisys and save the configuration.

A Citobox section is present in CTISYS:

[20:36:20] ABILIS_CPX:d p ctisys citobox

RES:CtiSys --------------------------------------------------------------------
Run    DESCR:CTI_System_general_properties
       - CITOBOX defaults -----------------------------------------------------
       CITO-GAIN-IN:0            CITO-GAIN-OUT:0
       CITO-ES:NO
       CITO-ES-RISE-OUT:20       CITO-ES-FALL-OUT:200      CITO-ES-THR-OUT:-12

[20:37:39] ABILIS_CPX:_d p ctisys citobox ?

D P [RES:]CTISYS [<section>]      Display parameter(s) of the CtiSys resource

<section>      Display only parameters of the specified section      <Optional>
               [ROUTER, LCS, CALL, ADDRBOOK, EEC, DSP, AUDIO, POTS,
               CELL, CITOBOX, HDLC, TONES, CLOCK]

CtiSys resource parameter(s):

CITO-GAIN-IN: Input gain adjustment [MUTE, -126..+32 dB]
CITO-GAIN-OUT: Output gain adjustment [MUTE, -59..+5 dB]
CITO-ES:   Echo suppressor activation [NO, YES]
CITO-ES-RISE-OUT: Echo suppressor output line rise time [0..1000 ms]
CITO-ES-FALL-OUT: Echo suppressor output line fall time [0..1000 ms]
CITO-ES-THR-OUT: Echo suppressor output line threshold [-126..0 dB]