• Description

• Example

4.1. Opening a Channel on the PBX Integration Board

Description

During initialization of the system, the R4 firmware file is downloaded to the board. Once Firmware is downloaded, the appropriate PBX Signaling Link firmware load file is downloaded to a specified area in memory on the board. The PBXDRVR sub-system then downloads and starts this PBX Signaling Link firmware from its place in memory. The PBX Signaling Link firmware can then begin to synchronize with the PBX (assuming that the board is physically connected to the PBX). This process can take up to 60 seconds to complete. During this time period, the board should not receive any calls from the PBX. Your application should ensure that the board is "alive" before any other functions are accessed.

NOTE:

Failure to ensure that the connection is established (synchronized) causes unpredictable results.

After synchronization is complete, the dx_open( ) function is used to open the channel by using a valid device name to identify the channel you wish to open. The oflags parameter is used to set the attributes of the channel being opened. The attributes determine what types of I/O functions (recording and playback of voice data) can be performed on the open channel.

Example

int  cd;          /* channel descriptor */  
int  sysinit()  
{  
/* open the channel VOXB0C0 */  
if ((cd = dx_open("VOXB0C0",O_RDWR)) == -1)  
          {  
/* process error */  
exit(1);  
          }  
/* wait for 60 seconds for switch */  
Sleep(60000L);  
exit(0);  
}

The dx_close( ) function is used to close a previously opened channel. Once the channel is closed, a process can no longer perform any action on that channel using that device handle. See the Voice Software Reference for more information about the dx_open( ) and dx_close( ) functions.

Click here to contact Dialogic Customer Engineering