Technical Helpweb

Dialogic® Host Media Processing (HMP) Software

Using Dialogic® Diva® SIPcontrol™ with Dialogic® Host Media Processing (HMP) Software

Introduction:
Dialogic® Diva® SIPcontrol™ software allows an application to control Dialogic® Diva® BRI, Dialogic® Diva® PRI, and Dialogic® Diva® analog cards via an IP call connection. When coupled with Dialogic® HMP software, this allows a powerful "thin blade" functionality for interfacing the Dialogic® HMP IP Calls to the PSTN connections on Dialogic® Diva® Server Cards. This note will provide some helpful hints to establish this configuration.

Installation:
Both Dialogic HMP software and Diva SIPcontrol software have their own installations. The Diva SIPcontrol software will need to detect the Licenses that are enabled inside Dialogic HMP software in order to fully enable itself. This being the case, the following is the recommended install procedure:

1. Install Dialogic HMP software
   
2. Configure the Dialogic HMP software and enable the Licenses
   
3. Install the Dialogic® Diva® SDK software
   
4. Configure the Dialogic® Diva® Server Adapters for the PSTN interface
   
5. Install Diva SIPcontrol Software

1. Inbound call is detected on the PSTN by the Diva Adapter
   
2. CallerID information is processed if available and the routing rules are applied
   
3. Outbound call is made to the HMP stack (CALLERID@127.0.0.1:5060) by default.
   
4. HMP answers the call
   
5. Diva Adapter answers the PSTN Call

1. 1. Dialogic HMP software places an outbound call to the Diva SIPcontrol service with the "number to be called" on the PSTN (Numbertobecalled@127.0.0.1:9803)
   
2. 2. Diva SIPcontrol software detects this call and extracts out the "number to be called"
   
3. 3. Diva Adapter attempts to make a call to the "number to be called"
   
4. PSTN call is conntected
   
5. Diva SIPcontrol software Connects HMP call

1. If there are multiple NICs inside the system that you are using, you may need to use the IP address for the machine rather then the loopback address (ie the call may need to go to NUMBERTOBECALLED@<ip address> rather then NUMBERTOBECALLED@127.0.0.1
   
   
2. By default, Diva SIPcontrol software only supports G.711 on the RTP leg, so make sure you have that selected as one of the coders on the HMP side or else the calls will fail.
   
   
3. You can test inbound and outbound functionality by using one of the Dialogic HMP software demos. No changes should be needed by default on the inbound side; for the outbound side, set the outbound IP address to NUMBERTOBECALLED@127.0.0.1 (or IP address rather then Loopback).
   
   
4. Because the IP call is taking place back-to-back in the same box, you will not be able to capture the call control and RTP via network monitoring tools such as Ethereal or Wireshark. If you are interested in the message contents, you will have to obtain this via tracing on either end.
   
   
5. By default you should not have to modify any of the Diva SIPcontrol software files. If you change the default IP addressing or port usage, you may need to modify this .xml file to get calls to connect. There are 2 .xml files:sipcontrol-0.xml and sipcontrol-xml. . The -0 file is used to control the PSTN->SIP leg and the -1 is the SIP-PSTN side. . If you do make changes to this file , make sure you restart the SIPCONTROL service via control panel.