Gx3722GetCalibrationInfo

Purpose

Returns the calibration information.

Syntax

Gx3722GetCalibrationInfo (nHandle, pszCalibrationInfo, nInfoMaxLen, pnDaysUntilExpire, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Handle to a GX3722 board.
pszCalibrationInfo
PSTR
Buffer to contain the returned board’s calibration information (null terminated) string.
nInfoMaxLen
SHORT
Size of the buffer to contain the error string.
pnDaysUntilExpire
PSHORT
Returns the number of days until or from expiration, if number is > 0 then calibration is current otherwise past due.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The returned board’s calibration information has the following fields:

Model: model number, e.g. “GX3722”.

Serial Number: serial number, e.g. 216.

Control Number: Marvin Test Solutions control number, e.g. “*ZZ-CH-CB-0”.

Production Calibration Date: Wed Oct 24 12:30:25 2010.

Calibration Date: Wed Oct 24 12:31:58 2010.

Recommended Interval: 1 year.

Next Calibration Date: Fri Oct 24 12:31:58 2011.

Status: calibration status can be either “Expired” followed by the number of days past expiration or “Current” followed by number of days until expire.

Calibration License: can be either “Installed” with the calibration license number or “Not Installed”.

Example

The following example returns the board’s calibration information string:

 

SHORT  nStatus;

char   szCalibrationInfo[1024];

BOOL   bExpired;

 

Gx3748GetCalibrationInfo(nHandle, szCalibrationInfo, sizeof szCalibrationInfo, &bExpired, &nStatus);

 

szCalibrationInfo string printout:

 

Model: Gx3722

Serial Number: 5678

Control Number: ZZ-AB-CD-000

Production Calibration Date: Wed Jul 31 16:47:40 2019

Calibration Date: Wed Jul 31 16:47:40 2019

Recommended Interval: 1 year

Next Calibration Date: Fri Jul 31 16:47:40 2020

Status: Current (364 days until expire)

 

See Also

Gx3722Initialize, Gx3722GetBoardSummary, GxFpgaGetErrorString