ATDT_BDSGBIT( )

Description | Cautions | Example | Errors | See Also

Name:	char * ATDT_BDSGBIT(devh)
Inputs:	int devh	Digital Network Interface logical board device handle
Returns:	pointer to signaling bit states of all device time slots AT_FAILUREP if failure
Includes:	srllib.h dtilib.h
Category:	Extended Attribute
Mode:	synchronous

Description

The ATDT_BDSGBIT( ) function returns the current state of the transmit and receive bits for all time slots on the Digital Network Interface device specified in devh.

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 returned value is a pointer to a 24-byte buffer. Bytes 0 to 23 represent T-1 time slots 1 to 24.

For E-1 applications, the returned value is a pointer to a 30-byte buffer. Bytes 0 to 29 represent E-1 time slots 1 to 30.

The following symbols represent each signaling bit and are defined in dtilib.h:

• DTSG_RCVA - "A" receive signaling bit
• DTSG_RCVB - "B" receive signaling bit
• DTSG_RCVC - "C" receive signaling bit (E-1 only)
• DTSG_RCVD - "D" receive signaling bit (E-1 only)
• DTSG_XMTA - "A" transmit signaling bit
• DTSG_XMTB - "B" transmit signaling bit
• DTSG_XMTC - "C" transmit signaling bit (E-1 only)
• DTSG_XMTD - "D" transmit signaling bit (E-1 only)

To determine the state of the signaling bits, perform a logical AND operation on the byte buffer and the defines, as demonstrated in the example below.

Cautions

1. This function will fail if an invalid Digital Network Interface logical board device handle is specified. AT_FAILUREP will be returned.
2. The transmit signaling bits are only valid when the device is in signaling insertion mode.

Example

#include <windows.h>            /* For Windows applications only */  
#include <srllib.h>  
#include <dtilib.h>  
#include <errno.h>  
   
main()  
{  
   int devh;                    /* Board device handle */  
   char *sigbits;               /* Pointer to signaling bits array */  
   int i;                       /* Loop counter */  
   int arcv, brcv, axmt, bxmt;  /* Bit mask values */  
   
   /*  
    * Open board 1 device  
    */  
   if ( ( devh = dt_open( "dtiB1", 0 ) ) == -1 ) {  
      printf( "Cannot open board dtiB1.  errno = %d", errno );  
      exit( 1 );  
   }  
   
   /*  
    * Get current transmit and receive signaling bits of all time slots  
    */  
   if ( ( sigbits = ATDT_BDSGBIT( devh ) ) == AT_FAILUREP ) {  
      printf( "Error message = %s.",ATDV_ERRMSGP( devh ) );  
      exit( 1 );  
   }  
   
   /*  
    * Display it  
    */  
   for ( i = 0; i < 24; i++ ) {  
      arcv = ( sigbits[ i ] & DTSG_RCVA ) ? 1 : 0;  
      brcv = ( sigbits[ i ] & DTSG_RCVB ) ? 1 : 0;  
      axmt = ( sigbits[ i ] & DTSG_XMTA ) ? 1 : 0;  
      bxmt = ( sigbits[ i ] & DTSG_XMTB ) ? 1 : 0;  
      printf( "tslot #%d arcv = %d, brcv = %d, axmt = %d, bxmt = %d\n",  
              i + 1, arcv, brcv, axmt, bxmt );  
   }  
               .  
               .  
               .  
}

Errors

If the function returns AT_FAILUREP, 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_INVBD - invalid Digital Network Interface logical board device handle
• EDT_INVMSG - invalid message
• EDT_NOMEMERR - cannot map or allocate memory in driver
• 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_TSMODE( )
• ATDT_TSSGBIT( )
• dt_setsigmod( )
• dt_settssig( )

Click here to contact Dialogic Customer Engineering