The BRI/2 uses SpringwareTM voice functions to perform analog voice processing. Since the BRI/2 also uses the Euro-ISDN protocol, which is a digital protocol, the following analog functions are not supported (the equivalent ISDN functions are also listed):
Table 1. Analog Call Control Functions Not Supported
Analog Call Control Functions |
ISDN Call Control Functions |
dx_open( ) -- opens a voice channel with an associated loop start interface. |
cc_Open( ) -- opens an ISDN call control device. |
dx_close( ) -- closes a voice channel with an associated loop start interface. |
cc_Close( ) -- closes an ISDN call control device. |
dx_dial( ) -- sends digits (DTMFs or MFs) to the network to make a call. |
cc_MakeCall( ) -- makes a call on an ISDN line (sends a SETUP message to the network). |
dx_wtring( ) -- Synchronously waits for an inbound ring event. |
cc_WaitCall( ) -- enables an ISDN call control device to process an incoming call |
dx_setevtmsk( ) -- enables detection of asynchronous ring events. |
cc_WaitCall( ) -- enables an ISDN call control device to process an incoming call. |
dx_sethook( ) -- used to place a loop start interface offhook to answer or make a call. |
cc_AcceptCall( ) -- indicates to the remote end that the ISDN call control device is "ringing". cc_AnswerCall( ) -- accepts a connection request on an ISDN call control device. |
dx_sethook( ) -- used to place a loop start interface onhook to disconnect a call. |
cc_DropCall( ) -- Disconnects a call on an ISDN call control device. cc_ReleaseCall( ) -- Releases all driver and firmware resources associated with a disconnected call on an ISDN call control device. |
An existing application written for any analog Dialogic voice processing product may be used with the BRI/2, however the call control (call processing) portion of the application will require changes. The following analog voice functions are supported on the BRI/2. Refer to the Voice Software Reference: Programmer's Guide for information on using Voice Functions.
Table 2. Supported Springware Functions
Function |
Description |
ATDX_ANSRSIZ( ) |
returns the duration of the answer |
ATDX_BDNAMEP( ) |
returns a pointer |
ATDX_BDTYPE( ) |
returns the device type |
ATDX_BUFDIGS( ) |
returns the number of uncollected digits |
ATDX_CHNAMES( ) |
returns a pointer to an array |
ATDX_CHNUM( ) |
returns the channel number |
ATDX_CONNTYPE( ) |
returns the connection |
ATDX_CPTERM( ) |
returns last Call Analysis termination |
ATDX_CRTNID( ) |
returns the tone identifier |
ATDX_DTNFAIL( ) |
returns character for dial tone |
ATDX_FRQDUR( ) |
can be used to return the duration of a SIT tone |
ATDX_FRQDUR2( ) |
can be used to return the duration of a SIT tone |
ATDX_FRQDUR3( ) |
can be used to return the duration of a SIT tone |
ATDX_FRQHZ( ) |
return frequency of answered signal |
ATDX_FRQHZ2( ) |
return frequency of second detected tone |
ATDX_FRQHZ3( ) |
return frequency of third detected tone |
ATDX_FRQOUT( ) |
returns percentage of a single tone frequency |
ATDX_HOOKST( ) |
returns the current hook state |
ATDX_LINEST( ) |
returns a bitmapped representation of activity |
ATDX_LONGLOW( ) |
returns duration of the longer silence |
ATDX_PHYADDR( ) |
returns the physical address |
ATDX_SHORTLOW( ) |
returns duration of shorter silence |
ATDX_SIZEHI( ) |
returns duration of initial non |
ATDX_TERMMSK( ) |
returns a bitmap |
ATDX_TONEID( ) |
returns the user |
ATDX_TRCOUNT( ) |
returns number of bytes transferred |
dx_addspddig( ) |
sets a DTMF digit to adjust speed |
dx_addtone( ) |
adds the tone |
dx_addvoldig( ) |
sets a DTMF digit to immediately adjust volume |
dx_adjsv( ) |
adjusts speed or volume |
dx_blddt( ) |
defines a simple dual frequency tone |
dx_blddtcad( ) |
defines a simple dual frequency cadence tone |
dx_bldst( ) |
defines a simple single frequency tone |
dx_bldstcad( ) |
defines a simple single frequency cadence tone |
dx_bldtngen( ) |
sets up tone generation template |
dx_chgdur( ) |
alters standard definition of duration component |
dx_chgfreq( ) |
changes the standard definition |
dx_chgrepcnt( ) |
changes the standard definition |
dx_clrcap( ) |
clears all the fields in a DX_CAP structure |
dx_clrdigbuf( ) |
causes the digits present in the firmware digit buffer |
dx_clrsvcond( ) |
clears any speed or volume adjustment conditions |
dx_clrtpt( ) |
clears all DV_TPT fields |
dx_deltones( ) |
removes all user |
dx_dial( ) |
dials an ASCIIZ string |
dx_distone( ) |
disables detection of TONE ON |
dx_enbtone( ) |
enables detection of TONE ON |
dx_fileclose( ) |
closes the file associated with the handle |
dx_fileopen( ) |
opens the file specified by filep |
dx_fileread( ) |
turns number of bytes read by application. |
dx_filelseek( ) |
moves file pointer associated with handle |
dx_filewrite( ) |
writes count byes from buffer into file associated with handle |
dx_getcursv( ) |
returns the specified channel's current speed |
dx_getdig( ) |
initiates the collection of digits |
dx_getevt( ) |
used to synchronously monitor channels |
dx_getsvmt( ) |
returns contents of Speed or Volume Modification Table |
dx_initcallp( ) |
initializes and activates PerfectCall Call Analysis |
dx_play( ) |
plays recorded voice data |
dx_playf( ) |
synchronously plays voice data |
dx_playiottdata( ) |
plays back recorded voice data from multiple sources |
dx_playtone( ) |
plays tone defined by TN_GEN template |
dx_playvox( ) |
plays voice data stored in a single VOX file |
dx_playwav( ) |
plays voice data stored in a single WAVE file |
dx_rec( ) |
records voice data from a single channel |
dx_recf( ) |
permits voice data to be recorded |
dx_reciottdata( ) |
records voice data to multiple destinations |
dx_recvox( ) |
records voice data to a single VOX file |
dx_recwav( ) |
records voice data to a single WAVE file |
dx_setdigbuf( ) |
sets the digit buffering mode |
dx_setdigtyp( ) |
controls the types of digits |
dx_setevtmsk( ) |
enables detection of Call Status Transition (CST) event |
dx_setgtdamp( ) |
sets up the amplitudes |
dx_setsvcond( ) |
sets adjustments and adjustment conditions |
dx_setsvmt( ) |
updates the speed or volume |
dx_setuio( ) |
allows an application to install a user I/O routine |
dx_stopch( ) |
forces termination of currently active I/O functions |
r2_creatfsig( ) |
defines and enables leading edge detection |
r2_playbsig( ) |
plays a specified backward R2MF signal |
Click here to contact Dialogic Customer Engineering
Copyright 2000, Dialogic Corporation