dt_settssig( )

Description | Cautions | Example | Errors | See Also

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

Description

The dt_settssig( ) function sets or clears the transmit for the time slot requested.

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_ABIT - "A" signaling bit
	DTB_BBIT - "B" signaling bit
	DTB_CBIT - "C" signaling bit (E-1 only)
	DTB_DBIT - "D" signaling bit (E-1 only)
action:	Specifies whether the signaling bits in the mask should be set or cleared, (i.e., set to one or set to zero). The possible values are:
	DTA_SETMSK - set bits specified in bitmask and clear all other bits.
	DTA_ADDMSK - set bits specified in bitmask. This will not affect other bits that are currently set.
	DTA_SUBMSK - clear bits in specified bitmask. This will not affect other bits that are currently set.

Cautions

This function will fail under the following conditions:

• An invalid Digital Network Interface logical time slot device handle is specified
• The action 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 );  
   }  
   /*  
    * 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_BDMODE( )
• ATDT_BDSGBIT( )
• ATDT_TSMODE( )
• ATDT_TSSGBIT( )
• dt_setsigmod( )

Click here to contact Dialogic Customer Engineering