Montag, 20. April 2009

Use of Dialogic® Diva® softIP-SIP with chan_capi

What is Diva softIP

The product Dialogic® Diva® softIP is Diva software which can be used for all Diva applications that have been developed for any of the many interfaces Diva supports. For Linux these interfaces are CAPI, extended CAPI, TTY and the Diva API.

NOTE: The Diva API is offered by the Dialogic® Diva® SDK.

In a pure IP/SIP environment the Diva softIP product replaces the Diva Media Board. In a hybrid environment softIP will be used together with a Diva Media Board.

NOTE: A Diva Media Board can be one of the following: Diva Analog, Diva BRI, Diva PRI or Diva V-xPRI Media Boards.

The beauty of softIP is that there is no need to change the application, except if it is required to access IP/SIP functionality directly from the application. This can be the case if you e.g. want to extract the email address from the SIP message.

Compared to a Diva Media Board, which exposes Analog, ISDN BRI, ISDN PRI or E1/T1 interfaces towards the network and the IDI interface towards the user application, Diva softIP exposes an IP/SIP/RTP/sRTP/T.38 interface towards the network and continues to expose the IDI interface towards the user.

From the point of view of user application this is no difference between one API interface which is connected to a Diva Media Board (hardware) and one which is connected to Diva softIP (software).

From the application point of view adding Diva softIP to the system (application) is the same as to add a Diva Media Board (hardware). For this reason in the remainder of the document Diva softIP is referred to as a “virtual board”.

NOTE: Also the Diva softIP (software) needs hardware in order to access the Ethernet (IP) network. It simply uses the Network Interface Card (NIC) also called Ethernet Card as its way into IP. In terms of application architecture you can see a Diva Media Board being replaced by Diva softIP plus and Ethernet board.

Diva softIP signaling features

  • The available number of channels depends on the quantity of activated softIP licenses.

    • To ensure compatibility with existing application the available channels are presented to the application as a number of “virtual softIP boards”, each one with 30 channels or less.

    • It is possible to join multiple “virtual softIP boards” and Diva media boards to one virtual board with the added number of channels.

  • Signaling features

    • IP/UDP/SIP

      • HOLD/RETRIEVE with REINVITE (mapped to CAPI ETSI HOLD/RETRIEVE)

      • REFER in active state (mapped to CAPI ETSI call deflection)

      • Consultation call transfer with REFER (mapped to CAPI consultation call transfer)

      • Call deflection in non active state (send 302 to network, mapped to CAPI ETSI call deflection)

      • REGISTER as client

      • NOTIFY MWI (Message Waiting Indication) as server

      • Rx REFER and processing

      • Rx INVITE with Replaces header and processing

      • Remote-Party-ID processing

      • P-Asserted-Identity (under development)

      • old diversion-header

softIP media processing features

  • Media processing features

    • RTP G.711 aLaw and uLaw

    • DTMF detection and transmission

    • Fax calling tone detection and transmission

    • Line interconnect and conferencing

      • Conferencing AGC (Active talker evaluation)

      • Between IP peers

      • Between E.1/T.1/S0 and IP peers

        • Line interconnect between Diva Media Boards (hardware) and Diva softIP

          • Uses PCI/PCIe BUS master DMA of the Diva hardware for the transport of data between the Diva hardware and Diva softIP.

    • T.38 up to V.34 (33600 Bps)

      • MR/MMR/T.6

      • Intelligent fax processing

      • Super/Ultra fine and Color fax

      • Polling

      • More documents

Acceleration of softIP by Diva hardware

It is possible to offload media processing tasks from the host to Diva media boards (hardware). In the case that all available Diva softIP channels are offloaded to Diva media boards (hardware) then the Diva softIP media processing part is not used.

To offload softIP media processing to Diva media boards it is necessary to change the configuration of the Diva media board to “Resource Board Mode”. In this case the TDM interface (BRI/PRI/E1/T1) of the Diva media board is deactivated and the Diva board can be used by the softIP signaling and media control part for media processing and streaming.

Using a Diva board for media processing, softIP can use all media processing features provided by the Diva board. This depends on the Diva hardware and the available CODEC licenses of the Diva Media Board (mainly used on Diva V-xPRI media boards):

  • G.168 Echo cancellation with up to 256 ms tail length

  • G.729, G.726 32 kbps, GSM-FR, iLBC

  • Extended tone detection

    • Human talker detection, MF detection, ...

  • Tone generation

  • Suppression of ambient noises

  • DTMF clamping (suppression)

  • Receive AGC (Automatic Gain Control)

  • Transmit AGC

  • Digital gain control

  • Clear channel fax

    • Up to V.34 (33600)

    • MR/MMR/T.6

    • Intelligent fax processing

    • Super/Ultra fine and Color fax

    • Polling

    • More documents

The Structure of Diva softIP

Diva softIP is built using two parts

  • SIP signaling and media control part

  • media processing and streaming part

The SIP signaling and media control part always runs in user mode.

The Media processing and streaming part can run in user mode (default) or in kernel mode.

Due to the “isolation” by the IDI interface Diva softIP uses the same Diva CAPI/TTY drivers as the Diva boards.

The Media processing and streaming part uses, if in kernel mode, the same Diva kernel mode streaming driver as the Diva board.

Diva softIP Licensing

Diva softIP uses licenses that are locked to the specific host (PC hardware). You need to activate the PPC (proof of purchase code) on the Dialogic Activation web page. In order to identify your PC you need to use the provided “softIP System DUID” (see licenses manager of the Diva WEB configuration manager). This then allows you to request the license file (LIC). The file will be sent to the email address you have specified.

Diva softIP Configuration

Once the license is applied “virtual softIP boards” will appear in the “Board configuration”.
After clicking on the softIP symbol you will proceed to the softIP configuration.

You need to edit the mapping table. This table allows to establish a mapping between the Calling and Called party numbers and SIP addresses and to create registrar entries.

Use of a Diva Media Board (HW) in Resourceboard-mode with softIP

Please use the configuration tool of the Diva media board to change the board configuration to “resourceboard”-mode.

After the configuration has been changed to resourceboard mode the ISDN BRI/PRI or E1/T1 interface of the Diva board is deactivated and the board resources are available for softIP (for media processing). The number of available media processing resources is equal to the number of supported channels. As a result of offload to the Diva board the softIP symbols in the board configuration will disappear, if media processing for all available softIP channels are moved to Diva hardware boards.

In case the Diva board (hardware) provides multiple ports (interfaces) you can change the configuration on a per port basis.

The provided Diva board media processing resources depend on the type of Diva board in use and/or on the installed licenses (Fax, Modem, G.729 and other CODECs).

softIP T.38 support

Diva softIP media processing provides support for T.38 in a fully transparent way. The application does not need to be changed. Applications that have been developed for Diva CAPI, Diva API and Diva TTY FAX CLASS 1 or FAX CLASS 2 can be used without any changes.

All Fax T.30 features that have been available on the Diva boards are available if using T.38 (V.34, ECM, MR/MMR/T.6, Ultra and Super fine resolutions, Color fax, non standard paper formats). Global Diva softIP fax T.30 configuration options can be used in the same way as when using Diva media boards (hardware).

Clear channel fax support with Diva softIP

The use of with softIP with a Diva board (hardware) for media processing allows using clear channel fax. The used Diva media board (hardware) needs to offer fax support.

Support for clear channel fax is provided fully transparent to the application. The application does not need to be changed. Applications that have been developed for Diva CAPI, Diva API and Diva TTY FAX CLASS 1 or FAX CLASS 2 can be used without any changes.

All available Diva fax T.30 features are available if using clear channel fax (V.34, ECM, MR/MMR/T.6, Ultra and Super fine resolutions, Color fax, non standard paper formats). Global Diva board fax T.30 configuration options can be used in the same way as if using ISDN BRI/PRI or E1/T1 interfaces.

Use of softIP with Chan_capi

From the point of view of Chan_capi softIP channels are available via one or more CAPI controllers each one with 1 to 30 channels.

No changes in Chan_capi are necessary to support softIP. All Chan_capi media commands can be used for softIP. The “receivefax” and “sendfax” Chan_capi commands can be used to receive and send fax documents using T.38 and/or clear channel fax.

Diva boards (provided by) and softIP can be installed and used by Chan_capi in one system. Chan_capi can use native bridging (line interconnect) and conferencing (chat) commands for interconnecting media streams (phone calls) between softIP and Diva boards (hardware).

The configuration of Chan_capi for softIP is provided in the Diva WEB configuration tool.

Diva softIP configuration and sip.conf

When activating SIP support (sip.conf) please ensure that softIP and sip.conf are using different ports to prevent IP port conflicts between sip.conf softIP SIP. Otherwise sip.conf may activate functionality that is then provided by softIP.

Diva softIP and G.168 echo cancellation

In IP networks it is the standard procedure to cancel echo at the gateway between the PSTN and the IP network. But certain gateways do not support G.168 echo cancellation. In this case it is necessary to cancel the echo in the IP network.

If Diva softIP is used with a Diva board (hardware) in resourceboard mode then it is possible to activate G.168 echo cancellation with a tail length of 256 ms to suppress echo in the IP network. Please use the Diva configuration tool to activate the echo tail length of 256 ms

Keine Kommentare:

Kommentar veröffentlichen