ATDT_BDMODE( )

Description | Cautions | Example | Errors | See Also

Name:	long ATDT_BDMODE(devh)
Inputs:	int devh	Digital Network Interface logical board device handle
Returns:	signaling mode of all Digital Network Interface time slots AT_FAILURE if failure
Includes:	srllib.h dtilib.h
Category:	Extended Attribute
Mode:	synchronous

Description

The ATDT_BDMODE( ) function returns the current mode of every time slot on the specified Digital Network Interface device.

Parameter	Description
devh:	Specifies the valid Digital Network Interface logical board device handle returned by a call to dt_open( )

For T-1 applications, the mode is returned as a long integer where bits 0 to 23 represent the mode of Digital Network Interface time slots 1 to 24.

For E-1 applications, the mode is returned as a long integer where bits 0 to 29 represent the mode of Digital Network Interface time slots 1 to 30.

The following signaling mode defines are provided in dtilib.h:

• DTM_SIGINS - signaling insertion mode (Digital Network Interface board generates signaling to network)

To determine the mode of a time slot, compare the returned value with the provided defines.

Cautions

1. This function will fail if an invalid Digital Network Interface logical board device handle is specified.
2. For returned values to be valid, you must call dt_setsigmod( ) first
3. Wink signaling cannot be transmitted on a voice device channel (see the Voice Software Reference for Linux or Windows).

Example

#include <windows.h>      /* For Windows applications only */  
#include <srllib.h>  
#include <dtilib.h>  
#include <errno.h>  
   
main()  
{  
   int devh;              /* Board device handle */  
   long modebits;         /* Mode of all time slots */  
   int i;                 /* Loop counter */  
   /*  
    * Open board 1 device  
    */  
   if ( ( devh = dt_open( "dtiB1", 0 ) ) == -1 ) {  
      printf( "Cannot open board dtiB1.  errno = %d", errno );  
      exit( 1 );  
   }  
   /*  
    * Get the signaling mode of all E-1 time slots (1 to 30)  
    */  
   
   if ( ( modebits = ATDT_BDMODE( devh ) ) == AT_FAILURE ) {  
      printf( "Error message = %s.",ATDV_ERRMSGP( devh ) );  
      exit( 1 );  
   }  
   /*  
    * Display it  
    */  
for ( i = 0; i < 30; i++ ) {  
      switch( ( modebits >> i ) & 1 ) {  
      case DTM_TRANSP:  
         printf( "Time slot %d on board 1 is in transparent mode\n", i + 1 );  
         break;  
      case DTM_SIGINS:  
         printf( "Time slot %d on board 1 is in insertion mode\n", i + 1 );  
         break;  
      }  
   }  
              .  
              .  
}

Errors

If the function returns AT_FAILURE, 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 command parameter to driver
• EDT_INVBD - invalid Digital Network Interface logical board device handle
• EDT_INVMSG - invalid message
• EDT_NOMEMERR - cannot map or allocate memory in driver
• EDT_RANGERR - bad/overlapping physical memory range
• EDT_SIZEERR - 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_BDSGBIT( )
• ATDT_TSMODE( )
• ATDT_TSSGBIT( )
• dt_setsigmod( )
• dt_settssig( )

Click here to contact Dialogic Customer Engineering