dt_setidle( )

Description | Cautions | Example | Errors | See Also

Name:	int dt_setidle(devh,state)
Inputs:	int devh	Digital Network Interface logical time slot device handle
	unsigned int state	idle state of time slot
Returns:	0 on success -1 on failure
Includes:	srllib.h dtilib.h
Category:	Time Slot Audio
Mode:	synchronous

Description

The dt_setidle( ) function enables or disables transmission of a continuous stream of silence to the network for the audio portion of the specified time slot. Transmitting silence is referred to as "idling" or "inserting idle" on a time slot.

When two Digital Network Interface boards are arranged in drop-and-insert configuration, this function can be used to disable pass-through operation. Transmitting idle overrides voice data being passed between network devices on the selected time slot.

Parameter	Description
devh:	Specifies the valid Digital Network Interface logical time slot device handle returned by a call to dt_open( )
state:	Specifies whether to enable or disable the transmission of silence. The possible values are:
	DTIS_DISABLE - disable idling on the time slot
	DTIS_ENABLE - enable idling on the time slot

The default idle value transmitted is 7FH (T-1 only) or 54H (E-1 only). We recommend you initialize the device idle value to a known state before idling a time slot. The device idle value is set using the dt_setparm( ) function with the parameter DTG_IDLTYP. The values of this parameter can be set as follows:

• IDLE_7F - sets idle value to 7FH (T-1 only)
• IDLE_FF - sets idle value to FFH (T-1 only)
• IDLE_54 - sets idle value to 54H (E-1 only)
• IDLE_D5 - sets idle value to D5H (E-1 only)

Cautions

This function will fail under the following conditions:

• An invalid logical time slot device handle is specified
• The state specified is invalid

Example

#include <windows.h>       /* For Windows applications only */  
#include <srllib.h>  
#include <dtilib.h>  
#include <errno.h>  
main()  
{  
   int devh;               /* Time slot device handle */  
   /*  
    * Open time slot 1 on board 1  
    */  
   if ( ( devh = dt_open( "dtiB1T1", 0 ) ) == -1 ) {  
      printf( "Failed to open device dtiB1T1.  errno = %d\n", errno );  
      exit( 1 );  
   }  
   /*  
    * Set signaling mode to signaling insertion  
    */  
   if ( dt_setsigmod( devh, DTM_SIGINS ) == -1 ) {  
      printf( "Error message = %s.",ATDV_ERRMSGP( devh ) );  
      exit( 1 );  
   }  
   /*  
    * Disable silence transmission  
    */  
   if ( dt_setidle( devh, DTIS_DISABLE ) == -1 ) {  
      printf( "Error message = %s.",ATDV_ERRMSGP( devh ) );  
      exit( 1 );  
   }  
   /*  
    * Go offhook  
    */  
   if ( dt_settssig( devh, DTB_ABIT | DTB_BBIT, DTA_SETMSK ) == -1 ) {  
      printf( "Error message = %s.",ATDV_ERRMSGP( devh ) );  
      exit( 1 );  
   }  
              .  
}

Errors

If the function returns -1, use the SRL Standard Attribute function ATDV_LASTERR( ) to obtain the error code or use ATDV_ERRMSGP( ) to obtain a descriptive error message. See Appendix A - Standard Runtime Library for more information on SRL functions. The error codes returned by ATDV_LASTERR( ) are:

• EDT_BADBRDERR - Digital Network Interface missing or defective
• EDT_BADCMDERR - invalid or undefined command to driver
• EDT_DATTO - data reception timed out
• EDT_FWERR - firmware returned an error
• EDT_INVTS - invalid Digital Network Interface logical time slot device handle
• EDT_NOMEMERR - cannot map or allocate memory in driver
• EDT_PARAMERR - invalid parameter
• EDT_RANGEERR - bad/overlapping physical memory range
• EDT_SIZERR - message too big or too small
• EDT_SKIPRPLYERR - a required reply was skipped
• EDT_SYSTEM - system error. Check the global variable errno for more information about the error.
• EDT_TMOERR - timed out waiting for reply from firmware

Error defines can be found in the file dtilib.h.

See Also

• ATDT_IDLEST( )
• dt_setsigmod( )

Click here to contact Dialogic Customer Engineering