49.1. CTISIP resource

49.1. CTISIP resource
	Chapter 49. SIP - Session Initiation Protocol

The Abilis SIP driver provides gateway functionalities between SIP and ISDN networks for audio services only; it is not intended to support full SIP to SIP videoconferencing gateway. The Abilis SIP driver can be interfaced with:

Physical Volp telephones with SIP support;
Softphone program for PC;
PBX Digium Asterisk.

49.1.1. Activating the CTISIP resource

Add the resource to the Abilis system with the following command.

[09:08:14] ABILIS_CPX:a res:ctisip

RES:CTISIP ALREADY EXISTS

The CTISIP 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:ctisip

COMMAND EXECUTED

	Caution
	After adding or setting the CTISIP active, you must restart the Abilis to make the resource running (use the command warm start to reboot the Abilis).

[11:01:39] ABILIS_CPX:s p ctisip act:yes

COMMAND EXECUTED

	Caution
	Execute the initialization command init res:ctisip to activate the changes made on the upper case parameters. Use the command save conf and restart Abilis (i.e. with warm start command) to set act the changes made on the lowercase parameters.

49.1.2. CTISIP resource parameters

Use the command d p ctisip to show the parameters of the resource and use the command d p ctisip ? to display the meaning of the parameters.

[11:02:19] ABILIS_CPX:d p res:ctisip

       LOG:NO                  ACT:YES                 mxps:2172
       sesnum:10               non-invite-sesnum:50    tcp-sesnum:0
       tcp-locport:5060        UDP-PORT-BASE:6000      SIP-TOS:0-N
       udp-locport:5060        UDP-PORT-RANGE:200      RTP-TOS:0-D
       SRCADD:OUT-IP                 
       EXTERNAL-IP:OUT-IP                 
       IPSRC:127.000.000.001   IPSRCLIST:PrivateIpAdd
       SUB-LIFETIME:180        max-sub:100             CTIP-TYPE:USER
       AUTH:DIGEST             KEEPALIVE:90            NPOO-CT:SYS
       LIFETIME:120            DISC-AUDIO:NO           ROUTING:EN-BLOC
       REM-AUTH:DIGEST         T1:500                  DIALT:5
       REM-LIFETIME:120        T2:4                    T302:15
       AUTH-TOUT:4             T4:5                    ROUTE-BY-SD:NO
       AUTH-TOUT-INVITE:4      CHAN-FREQ:20            PROVIDE-SG:NO
       DTMF-MODE:RFC2833       T38:YES                 CLIP-RULE:PRIVATE
       PLAY-DTMF:100           T38-G711:NO             RG-IN:DISABLE
       PLAY-SILENCE:100        T38-PACKING:1           CPO-RTP:NO
       DETECT-DTMF:40          T38-REDUND:REDUNDANCY   CPO-SIGNALLING:NO
       DETECT-SILENCE:40       T38-REDUND-PCK:1        RCC-DISABLE:NO
       DOMAIN:
       UA:AUTO (Abilis CPX - Ver. 8.0.3/STD - Build 3961.10 - Branch 8.0)
       wdir:C:\APP\SIP\

Meaning of the most important parameters:

LOG: Logging functionalities activation/deactivation.
ACT: Runtime CTISIP activation/deactivation.

sesnum: Maximum number of SIP simultaneous sessions.
non-invite-sesnum: Number of SIP sessions/dialogs initiated by NON-INVITE methods: i.e. Register, Subscribe and Notify.
tcp-sesnum: Number of reserved TCP sessions available for SIP channels; this value must not be greater than sesnum [0..254, AUTO: inherit value from sesnum].
tcp-locport: Local TCP port of SIP protocol.
udp-locport: Local UDP port of SIP protocol.
UDP-PORT-BASE: Base local UDP port usable for RTP/RTCP sessions; this feature is required to assign high priority to RTP/RTCP packets.
UDP-PORT-RANGE: Range of permitted local UDP ports usable for RTP/RTCP sessions; this value must not be lower than (sesnum * 2 + 50).
SIP-TOS: Sets the TOS value for SIP protocol.
RTP-TOS: Sets the TOS value for RTP protocol.
SRCADD: Source 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].
EXTERNAL-IP: Abilis external IP address. [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]. When OUT-IP or R-ID are set, the address must be determined at the call start and must not change until call end.
IPSRC: Specifies which client's IP address is allowed to access and called by SIP server; a client is accepted if it also satisfies SIP-IP-PERMIT specified in User table.
IPSRCLIST: Name of the IP address list (IP/IR/RU/MR) from which the request for access can be accepted; a client is accepted if it also satisfies SIP-IP-PERMIT specified in User table.
SUB-LIFETIME: Expiration time of incoming subscriptions.
max-sub: Maximum number of subscriptions that CTISIP may handle independently from the event type, the subscriber and the monitored resource.
AUTH: Authentication method offered to authenticating/registering users (incoming calls/registrations).
REM-AUTH: Authentication method when Abilis is authenticating/registering to a peer (outgoing calls/registrations).
LIFETIME: Default duration of incoming registration; users must register themselves before this time interval expires.
REM-LIFETIME: Default duration of outgoing registration; Abilis must register before this time interval expires.
AUTH-TOUT: SIP NOT-INVITE authentication timeout for incoming/outgoing calls initiated by REGISTER method.
AUTH-TOUT-INVITE: SIP INVITE authentication timeout for incoming/outgoing calls initiated by INVITE method.
KEEPALIVE: Session keepalive time; when this session inactivity timer expires a RE-INVITE or UPDATE message is sent.
CTIP-TYPE: CTIP type assigned to CTISIP driver.
NPOO-CT: Enable/disable Net-Public to Net-Public call transfer when both calls are outgoing (outgoing to outgoing) [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].
ROUTING: Routing management [PREFIX, EN-BLOC].
DIALT: Dialing timeout.
T302: Timeout for “empty” setup.
ROUTE-BY-SD: It 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 CTISIP table is performed; USER: the user corresponding to SD is searched: if found and the user has parameter SIP-ROUTE-BY-SD:YES, the call is forwarded to that user, otherwise the standard search in CTISIP table is performed].
PROVIDE-SG: Allows insertion of SIP 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 SIP USER NAME of the caller.
DTMF-MODE: DTMF mode used by CTISIP in outgoing DTMF [INBAND: the outband DTMF received from CTIR is not dropped, only the audio stream is passed; INFO: the outband DTMF received from CTIR is sent using INFO message; RFC2833: the outband DTMF received from CTIR is sent using RFC2833 payload].
PLAY-DTMF: Duration of a DTMF played from a DTMF FULL FRAME. When CTISIP 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-SILENCE: Duration of a silence played after a PLAY-DTMF. When CTISIP 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-DTMF: Duration of a DTMF from CTIR in order to allow digit recognition. When CTISIP 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-SILENCE: Duration of a silence after a DTMF from CTIR in order to recognise a digit.
T1: SIP T1 time; Round Trip Time (RTT) estimate.
T2: SIP T2 time; maximum retransmission interval for NON-INVITE requests and INVITE responses.
T4: SIP T4 time; maximum duration that a message can remain in the network.
CHAN-FREQ: Channel 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.C
CPO-RTP: Enables/disables Call Path Optimization between two SIP users. It is used when SIP-CPO:SYS in user service, otherwise the value of SIP-CPO is used.
DOMAIN: Domain for local users. If Abilis has clients in the public side you can also specify a FQDN.

The following command allows the administrator to change the configuration of the resource:

s p ctisip parameter:value...

	Caution
	To activate the changes made on the upper case parameters, execute the initialization command init res:ctisip; 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).


Chapter 49. SIP - Session Initiation Protocol		49.2. CTISIP tables