ATDT_DNLDVER( )

Description | Cautions | Example | Errors | See Also

Name:	long ATDT_DNLDVER(devh)
Inputs:	int devh	Digital Network Interface logical board device handle
Returns:	version of firmware used by the device AT_FAILURE if failure
Includes:	srllib.h dtilib.h
Category:	Extended Attribute
Mode:	synchronous

Description

The ATDT_DNLDVER( ) function returns the firmware version downloaded to the device specified in devh. This number is returned in the standard version numbering format.

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

Version Numbering

A version number consists of two parts that provide:

1. The release TYPE (Example: Production or Beta
2. The release NUMBER, which consists of different elements depending on the type of release, for example:
   • 1.00 Production
   • 1.00 Beta 5

   NOTE:

   The examples above are shown in the convention used to display version numbers.

This function returns the version number as a long integer (32 bits) in BCD (binary coded decimal) format.

Figure 11 shows the format of the version number returned. Each section in the diagram represents a nibble (4 bits).

Figure 11. Firmware Version Number Format

Nibble 1 returns the type of release in BCD numbers. A converted value of 0 indicates a Production release and a converted value of 1 indicates a Beta release.

Nibbles 2, 3, and 4 return the Production Release Number.

NOTE:

Nibbles 2 through 4 are used in all version numbers. Nibbles 5 through 8 only contain values if the release is not a production release.

Nibbles 5, 6, 7, and 8 return the Internal Release Number used for pre-production product releases. Nibbles 5 and 6 hold the product's Beta number. Nibbles 7 and 8 hold additional information used for internal releases.

Table 2 displays a breakdown of the values returned by each nibble in the long integer.

Table 2. ATDT_DNLDVER( ) Return Values

Nibble (4 bits)
1	2	3 & 4	5 & 6	7 & 8
TYPE	PRODUCTION RELEASE NUMBER		INTERNAL NUMBER
Production	Major Release No.	Minor Release No.	N/A	N/A
Beta	Major Release No.	Minor Release No.	Beta Number	N/A

Major and Minor Release Numbers

Major and minor release numbers distinguish major revisions from minor revisions to Production releases. The major number converts to a single digit integer that increments with each major revision to the release. The minor number converts to a two digit integer that increments with each minor revision to the release.

In decimal number format, the major number is the number before the decimal point, and the minor number is the number after the decimal point.

The following list gives examples of each type of release. The values used in these examples have been converted from the binary coded decimal numbers returned in the long integer and are displayed according to the convention.

• 1.00 Production
• 1.00 Beta 5

Cautions

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

Example

#include <windows.h>      /* For Windows applications only */  
#include <stdio.h>  
#include <srllib.h>  
#include <dtilib.h>  
#include <errno.h>  
   
void main()  
{  
   int bdev;  
   long version;  
   
   if ((bdev = dt_open("dtiB1", 0)) == -1) {  
      printf("Error in dt_open\n");  
   }  
   
   /* Get the version number */  
   version = ATDT_DNLDVER(bdev);  
   
   if (version == AT_FAILURE) {  
      printf("ERROR in getting version #\n");  
   }  
   else {  
      /* display the version # */  
      printf("DTI version number is %x.%02x ",  
         (int) ((version >>24)&0x0F), ((version >> 16)&0xFF));  
   
      // check for the download type  
      switch (version >> 28) {  
      case 0:  
         printf("beta %02x \n", ((version >> 16)&0xFF));  
   
case 1:  
         printf("production\n");  
      } // end switch  
   }  
   
   dt_close(bdev);  
   printf("\nend of prog\n");  
}

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_ROMVER( )

Click here to contact Dialogic Customer Engineering