ATDX_FWVER( )

Description | Cautions | Example | Errors

Name:	long ATDX_FWVER(bddev)
Inputs:	int bddev	valid Dialogic board device handle
Returns:	D/4x Firmware version if successful AT_FAILURE if error
Includes:	srllib.h dxxxlib.h
Category:	Extended Attribute

Description

The ATDX_FWVER( ) function returns the voice firmware version number. On a D/41ESC or a D/xxxSC board the emulated D/4x firmware version is returned.

The function parameter is defined as follows:

Parameter	Description
bddev	specifies the valid board device handle obtained when the board was opened using dx_open( ).

This function returns a 32-bit value in the following format.

	TTTT|MMMM|mmmmmmmm|AAAAAAAA|aaaaaaaa

where each letter represents one bit of data with the following meanings:

Letter	Description
T	Type of Release. Decimal values have the following meanings (example: 0010 for Alpha release):
	0	Production
	1	Beta
	2	Alpha
	3	Experimental
	4	Special
M	Major version number for a production release in BCD format. Example: 0011 for version "3."
m	Minor version number for a production release in BCD format. Example: 00000001 for ".10".
A	Major version number for a non-production release in BCD format. Example: 00000100 for version "4."
a	Minor version number for a non-production release in BCD format. Example: 00000010 for version ".02"

Example: 0000 0010 0001 0101 0000 0000 0000 0000 (Production v2.15)

Cautions

None.

Example

#include <stdio.h>  
#include <srllib.h>  
#include <dxxxlib.h>  
#include <windows.h>  
void GetFwlVersion(char *, long);  
main()  
{  
int bddev;  
char *bdname, FWVersion[50];  
long fwver;  
	bdname = "dxxxB1";  
	/*  
	 * Open board device  
	*/  
	if ((bddev = dx_open(bdname, NULL)) == -1)  
	{  
		/* Handle error */  
	}  
	if ((fwver = ATDX_FWVER(bddev)) == AT_FAILURE)  
	{  
		/* Handle error */  
	}  
	/*  
	 * Parse fw version  
	*/  
	GetFwlVersion(FWVersion, fwver);  
	printf("%s\n", FWVersion");  
} /* end main */

Errors

This function will fail and return AT_FAILURE if an invalid device handle is specified in bddev.

Click here to contact Dialogic Customer Engineering