The Abilis IAX driver provides gateway functionalities between IAX and ISDN networks for audio services only; it is not intended to support full IAX to IAX videoconferencing gateway. The Abilis IAX driver can be interfaced with:
Physical Volp phones with IAX support
Softphone program for PC (e.g. Idefisk, laxtalk, …)
PBX Digium Asterisk
Add the resource to the Abilis system with the following command.
[09:08:14] ABILIS_CPX:a res:ctiiax
RES:CTIIAX ALREADY EXISTSThe CTIIAX resource may already exist in the system, but may not yet be active: set it active with the command:
[09:10:00] ABILIS_CPX:s act res:ctiiax
COMMAND EXECUTED| ![[Caution]](../images/caution.png) | Caution | 
|---|---|
| You must restart the Abilis to make the resource running (use the command warm start to reboot the Abilis) after adding or setting the CTIIAX active. | 
[11:01:39] ABILIS_CPX:s p ctiiax act:yesCOMMAND EXECUTED [11:01:39] ABILIS_CPX:d p ctiiaxRES:CtiIax - Not Saved (SAVE CONF), Not Refreshed (INIT) ---------------------- ------------------------------------------------------------------------ DESCR:Inter-Asterisk_eXchange_Version_2 LOG:NO ACT:YES mxps:2172 sesnum:10 udp-locport:4569 SRCADD:OUT-IP TOS:0-D IPSRC:* IPSRCLIST:# AUTH:MD5 REM-AUTH:MD5 CTIP-TYPE:USER LIFETIME:60 REM-LIFETIME:60 NP-CT:SYS RETR-FREQ:400 TRUNK:NO ROUTING:EN-BLOC RETR-EXCEED:10000 TRUNK-FREQ:40 DIALT:5 RETR-EXCEED-FAST:2000 TRUNK-TS:YES T302:15 PLAY-DTMF:150 CHAN-FREQ:20 ROUTE-BY-SD:NO PLAY-SILENCE:100 DISC-AUDIO:NO PROVIDE-SG:NO DETECT-DTMF:40 CLIP-RULE:PRIVATE CPO:NO DETECT-SILENCE:40 RG-IN:DISABLE CPO-STATE:ACCEPT NETSTATS:NO TRANSFER:IAX CPO-DROP:NO HTML-IN: HTML-OUT:
| ![[Caution]](../images/caution.png) | Caution | 
|---|---|
| Execute the initialization command init res:ctiiax to activate the changes made on the upper case parameters; use save conf and warm start commands to set active the changes made on the lowercase parameters. | 
Use the below command to display the parameters of the resource; the d p ctiiax ? command shows the meaning of parameters.
[11:01:39] ABILIS_CPX:d p ctiiax
RES:CtiIax - Not Saved (SAVE CONF), Not Refreshed (INIT) ----------------------
       ------------------------------------------------------------------------
       DESCR:Inter-Asterisk_eXchange_Version_2
       LOG:NO                  ACT:YES
       mxps:2172               sesnum:10               udp-locport:4569
       SRCADD:OUT-IP                                   TOS:0-D
       IPSRC:*                 IPSRCLIST:#
       AUTH:MD5                REM-AUTH:MD5            CTIP-TYPE:USER
       LIFETIME:60             REM-LIFETIME:60         NP-CT:SYS
       RETR-FREQ:400           TRUNK:NO                ROUTING:EN-BLOC
       RETR-EXCEED:10000       TRUNK-FREQ:40           DIALT:5
       RETR-EXCEED-FAST:2000   TRUNK-TS:YES            T302:15
       PLAY-DTMF:150           CHAN-FREQ:20            ROUTE-BY-SD:NO
       PLAY-SILENCE:100        DISC-AUDIO:NO           PROVIDE-SG:NO
       DETECT-DTMF:40          CLIP-RULE:PRIVATE       CPO:NO
       DETECT-SILENCE:40       RG-IN:DISABLE           CPO-STATE:ACCEPT
       NETSTATS:NO             TRANSFER:IAX            CPO-DROP:NO
       HTML-IN:
       HTML-OUT:Meaning of the most important parameters:
LOGLogging functionalities activation/deactivation.
ACTRuntime CTIIAX activation/deactivation.
sesnumMaximum number of IAX simultaneous sessions.
udp-locportUDP port number on which the incoming IAX (call signalling protocol) call is accepted.
SRCADDSource IP address for outgoing connections
            [R-ID: the source IP address of the outgoing
            datagrams will be set to the current RouterID value;
            OUT-IP: the source IP address of the outgoing
            datagrams will be set on the base of the output IP interface;
            1-126.x.x.x, 128-223.x.x.x: the source IP
            address of the outgoing datagrams will be set to the selected
            value; Ip-nnn: use the current
            IPADD of the specified IP resource].
TOSSets the TOS value for CTIIAX resource.
IPSRCSpecifies which client's IP address is allowed to access and called by IAX server.
IPSRCLISTName of the IP address list (IP/IR/RU/MR) from which the request for access can be accepted.
AUTHAuthentication method offered to authenticating/registering users (incoming calls/registrations).
REM-AUTHAuthentication method when Abilis is authenticating/registering to a peer (outgoing calls/registrations).
LIFETIMEDefault duration of incoming registration; users must register themselves before this time interval expires.
REM-LIFETIMEDefault duration of outgoing registration; Abilis must register before this time interval expires.
CTIP-TYPECTIP type assigned to CTIIAX driver.
NP-CTEnables/disables Net-Public to Net-Public call transfer
            [NO: NP to NP disabled; YES:
            NP to NP enabled, except when both calls are outgoing, which is
            not allowed to avoid the “hang trunk” problem;
            SYS: NP to NP depends on NP-CT in
            CtiSys].
ROUTINGRouting management.
DIALTDialling timeout.
T302Timeout for “empty” setup.
RETR-FREQRetransmission frequency (time interval between a retransmission attempt of a IAX full frame and another one if acknowledgement doesn't arrive).
RETR-EXCEEDRetransmission time limit (maximum time for which a frame can stay unacknowledged).
RETR-EXCEED-FASTRetransmission time limit for NEW and REGREQ messages (these messages are used to setup a call); a shorter timeout for these messages helps in keeping small the time lost in case of peer failure and make a more effective alternative routing.
TRUNKEnables/disables trunking.
TRUNK-FREQTrunk frequency: it represents how much time to wait prior to send the UDP packet. During this time other voice packets coming form the same or other channels can be inserted in the same UDP header thus sensibly reducing the transmisison overhead; of course it adds some delay, but great benefit toward the bandwidth saving.
TRUNK-TSEnables/disables individual timestamps in a meta trunk.
CHAN-FREQChannel frequency for bandwidth optimisation. It represents how many msec of voice are desired to be packed into a single UDP packet; it's a “desire” in the sense that the actual optimisation will depend on the frame length in msec of the coder in use, and the result will be an a approximation by defect.
ROUTE-BY-SDIt allows routing using subaddress called field (SD)
            [NO: the SD is completely ignored;
            YES: the user corresponding to SD is searched:
            if found the call is forwarded to that user, otherwise the
            standard search in CtiIax table is performed;
            USER: the user corresponding to SD is searched:
            if found and the user has parameter
            IAX-ROUTE-BY-SD:YES, the
            call is forwarded to that user, otherwise the standard search in
            CtiIax table is performed].
PROVIDE-SGAllows insertion of IAX USER NAME in subaddress calling
            field [NO: disable insertion of USERNAME in
            calling subaddress; YES: enable insertion of
            USERNAME in calling subaddress; USER: insertion
            of USERNAME in calling subaddress depends on individual user
            configuration]. When it is enabled, either as result of value
            YES or because value is USER
            and the user corresponing to the subaddress content allows it, the
            call sent to CTIR will include in the subaddress calling field the
            IAX USER NAME of the caller.
PLAY-DTMFDuration of a DTMF played from a DTMF FULL FRAME. When CTIIAX has to convert a DTMF FULL FRAME command to CTIR DTMF frame, it produces as many frames as needed to cover the period specified by this parameter. The actual interval must be rounded to the value immediately higher than configured one.
PLAY-SILENCEDuration of a silence played after a
            PLAY-DTMF. When CTIIAX has to convert a DTMF
            FULL FRAME command to CTIR DTMF frame, it produces as many frames
            as needed to cover the perios specified by
            PLAY-DTMF parameter. Before a new DTMF can be
            played, a silence period must elapse, and this is controlled by
            this parameter.
DETECT-DTMFDuration of a DTMF from CTIR in order to allow digit recognition. When CTIIAX received DTMF frames from CTIR, and after it created the most accurate and monotonical timestamp, the DTMF length is measured and for a successful digit recognition it must be of at least the length specified here. If the configured value is not an exact multiple of the frame rate, it must be rounded to the next upper value multiple of frame rate.
DETECT-SILENCEDuration of a silence after a DTMF from CTIR in order to recognise a digit.
TRANSFERUnattended call transfer handling type
            [IAX: the handling respects IAX specifications:
            the original call is dropped; CPX: the handling
            is modified by Abilis: the original call is kept up in case that
            transferred one fails(user busy, not reacheable, etc...)].
Enables/disables Call Path Optimization between two IAX
            users. It is used when
            IAX-CPO:SYS in user service,
            otherwise the value of IAX-CPO is used.
CPO-STATEEarlier state of both call legs in which the Call Path
            Optimization can be ordered [ACCEPT: CPO on
            ACCEPT receiving; RINGING: CPO on RINGING
            receiving; ANSWER: CPO on ANSWER
            receiving].
CPO-DROPEnables/disables call drop on Call Path Optimization (CPO)
            failure. If enabled, the call will drop if CPO will fail. It is
            used when IAX-CPO-DROP:SYS
            in user service, otherwise the value of
            IAX-CPO-DROP is used.
NETSTATSEnables/disables network statistics and checks connection every the specified value of seconds.
HTML-INURL to send to a caller IAX user using the HTML full frame of the IAX protocol.
HTML-OUTURL to send to a called IAX user using the HTML full frame of the IAX protocol.
The following command allows the administrator to change the configuration of the resource:
s p ctiiax   parameter:value... 
| ![[Caution]](../images/caution.png) | Caution | 
|---|---|
| Execute the initialization command init res:ctiiax to activate the changes made on the upper case parameters; use save conf and warm start commands to set active the changes made on the lowercase parameters. |