dt_setsigmod( )

Description | Cautions | Example | Errors | See Also

Name:	int dt_setsigmod(devh,mode)
Inputs:	int devh	Digital Network Interface logical time slot device handle
	unsigned int mode	transmit mode
Returns:	0 on success -1 on failure
Includes:	srllib.h dtilib.h
Category:	Time Slot Signaling
Mode:	synchronous

Description

The dt_setsigmod( ) function sets the type of signaling that will be performed on the transmitted time slot.

Parameter	Description
devh:	Specifies the valid Digital Network Interface logical time slot device handle returned by a call to dt_open( )
mode:	Specifies the transmit mode. Possible values are:
	DTM_SIGINS - set to signaling insertion

Signaling Insertion

When a time slot is set to signaling insertion , transmit signaling for the selected time slot is inserted by the Digital Network Interface. The Digital Network Interface can insert signaling information over the transmit signaling already on that time slot.

Cautions

This function will fail under the following conditions:

• An invalid Digital Network Interface logical time slot device handle is specified.
• The mode 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 );  
   }  
              .  
              .  
              .  
}

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_BDMODE( )
• ATDT_BDSGBIT( )
• ATDT_TSMODE( )
• ATDT_TSSGBIT( )
• dt_settssig( )

Click here to contact Dialogic Customer Engineering