dx_setgtdamp( )

Description | Cautions | Example | Errors | Description

Name:	void dx_setgtdamp(gtd_minampl1, gtd_maxampl1, gtd_minampl2, gtd_maxampl2)
Inputs:	short int gtd_minampl1	Minimum amplitude of the first frequency
	short int gtd_maxampl1	Maximum amplitude of the first frequency
	short int gtd_minampl2	Minimum amplitude of the second frequency
	short int gtd_maxampl2	Maximum amplitude of the second frequency
Returns:	void
Includes:	srllib.h
	dxxxlib.h
Category:	GTD Function

Description

The dx_setgtdamp( ) function sets up the amplitudes to be used by the general tone detection. This function must be called before calling dx_blddt( ), dx_blddtcad( ), dx_bldst( ), or dx_bldstcad( ) followed by dx_addtone( ). Once called, the values set will take effect for all dx_blddt( ), dx_blddtcad( ), dx_bldst( ), and dx_bldstcad( ) function calls.

If this function is not called, then the MINERG firmware parameters that were downloaded remain at the following settings: -42dBm for minimum amplitude and 0dBm for maximum amplitude.

Default Value	Description
GT_MIN_DEF	Default value in dB for minimum GTD amplitude that can be entered for gtd_minampl* parameters.
GT_MAX_DEF	Default value in dB for maximum GTD amplitude that can be entered for gtd_maxampl* parameters.

Parameter	Description
gtd_minampl1	specifies the minimum amplitude in dB of tone 1.
gtd_maxampl1	specifies the maximum amplitude in dB of tone 1.
gtd_minampl2	specifies the minimum amplitude in dB of tone 2.
gtd_maxampl2	specifies the maximum amplitude in dB of tone 2.

Cautions

1. If this function is called, then the amplitudes set will take effect for all tones added afterwards. To reset the amplitudes back to the defaults, then call this function with the defines GT_MIN_DEF and GT_MAX_DEF for minimum and maximum defaults.
2. When using this function in a multi-threaded application, use critical sections or a semaphore around the function call to ensure a thread-safe application. Failure to do so will result in "Bad Tone Template ID" errors.

Example

#include <stdio.h>  
#include <srllib.h>  
#include <dxxxlib.h>  
#include <windows.h>  
#include "voxlib.h"     /* Dialogic voice library header file */  
   
#define TID 1;          /* Tone ID */  
   
.  
.  
.  
/*  
 * Set amplitude for GTD;  
 *     freq1 -30dBm to 0 dBm  
 *     freq2 -30dBm to 0 dBm  
 */  
dx_setgtdamp(-30,0,-30,0);  
   
/*  
 * Build temporary simple dual tone frequency tone of  
 * 950-1050 Hz and 475-525 Hz. using trailing edge detection, and  
 * -30dBm to 0dBm.  
if (dx_blddt(TID1, 1000, 50, 500, 25, TN LEADING) ==-1) {  
  /* Perform system error processing */  
  exit(3);  
}  
   
.  
.  
.

Errors

None.

Click here to contact Dialogic Customer Engineering