dt_settssigsim( )

Description | Cautions | Example | Errors | See Also

Name:	int dt_settssigsim(devh,bitmask)
Inputs:	int devh	Digital Network Interface logical time slot device handle
	unsigned short bitmask	signaling bits to simultaneously clear and set
Returns:	0 on success -1 on failure
Includes:	srllib.h dtilib.h
Category:	Time Slot Signaling
Mode:	synchronous

Description

The dt_settssigsim( ) allows simultaneous setting or clearing of transmit signaling bits on a Digital Network Interface time slot. The bitmask parameter specifies which signaling bits to change. To simultaneously set and clear the transmit signaling bits, the chosen values can be logically ORed together.

Parameter	Description
devh:	Specifies the valid Digital Network Interface logical time slot device handle returned by a call to dt_open( )
bitmask:	Specifies which signaling bits to change. All signaling bits may be changed with one function call if the bitmask values are logically ORed together as in the example. The possible values for the bitmask parameter are:
	DTB_AON - "A" signaling bit on
	DTB_AOFF - "A" signaling bit off
	DTB_BON - "B" signaling bit on
	DTB_BOFF - "B" signaling bit off
	DTB_CON - "C" signaling bit on (E-1 only)
	DTB_COFF - "C" signaling bit off (E-1 only)
	DTB_DON - "D" signaling bit on (E-1 only)
	DTB_DOFF - "D" signaling bit off (E-1 only)
	All signaling bits may be changed with one function call if the bitmask values are ORed together

Cautions

This function will fail if an invalid Digital Network Interface logical time slot device handle is specified.

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 );  
   }  
   /*  
    * Set A & C time slot bits while clearing the B bit simultaneously  
    * the D bit is left untouched  
    *  /  
   bitmask = DTB_AON | DTB_CON | DTB_BOFF;  
if ( dt_settssigsim( devh, bitmask) == -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_setsigmod( )

Click here to contact Dialogic Customer Engineering