GxCntUpgradeFirmware

Purpose

Upgrades the board’s firmware.

Syntax

GxCntUpgradeFirmware (nHandle, szFile, nMode, pnStatus)

Parameters

Name
Type
Description
nHandle
SHORT
Handle to a counter board.
szFile
PCSTR
Path and file name of the firmware file. The firmware file extension is JAM.
nMode
SHORT
The upgrading firmware mode can be as follows:
0. GT_FIRMWARE_UPGRADE_MODE_SYNC: the function returns when upgrading firmware is done or in case of an error.
1. GT_ FIRMWARE_UPGRADE_MODE_ASYNC: the function returns immediately. The user can monitor the progress of upgrading firmware using the GxCntUpgradeFirmwareStatus API.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

This function used in order to upgrade the board’s firmware. The firmware file can only obtain by requesting it from Marvin Test Solutions.

Note: Loading an incorrect firmware file to the board can permanently damage the board

Example

The following example loads Upgrades the board’s firmware using synchronous mode:

 

GxCntUpgradeFirmware (nHandle, “C:\\GxCntFw.jam”, GT_LOAD_MODE_SYNC, &nStatus);

 

See Also

GxCntUpgradeFirmwareStatus, GxCntGetErrorString