GxSmuGetCalibrationInfo

Applies To

GX3104, GX3116e

Purpose

Returns the calibration information.

Syntax

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

Parameters

Name
Type
Description
nHandle
SHORT
Handle to a GX3104 or GX3116e board.
pszCalibrationInfo
PSTR
Buffer to contain the returned board’s calibration information (null terminated) string.
nInfoMaxLen
SHORT
Size of the buffer to contain the calibration summary 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. “GX3104”

Serial Number: serial number, e.g. 999

Control Number: Marvin Test Solutions control number, e.g. “AD-AA-000”

Calibration Date: Mon Oct 09 09:46:20 2017

Recommended Interval: 1 year

Next Calibration Date: Tue Oct 09 09:46:20 2018

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];

SHORT  nDaysUntilExpire;

 

GxSmuGetCalibrationInfo(nHandle, szCalibrationInfo, 1024, &nDaysUntilExpire, &nStatus);

 

szCalibrationInfo string printout:

 

Model: GX3104

Serial Number: 31040999

Control Number: XY-ZX-999

Production Calibration Date: Mon Oct 09 09:46:20 2017

Calibration Date: Mon Oct 09 09:46:20 2017

Recommended Interval: 1 year

Next Calibration Date: Tue Oct 09 09:46:20 2018

Status: Current (364 days until expire)

 

See Also

GxSmuInitialize, GxSmuGetBoardSummary, GxSmuGetErrorString