JLab fADC125 Library  1.2.1
 All Data Structures Files Functions Variables Enumerations Enumerator Macros Groups
Firmware Updating Utilities

Functions

void fa125FirmwareSetDebug (unsigned int debug)
 Set the debugging flags for diagnosing firmware updating problems. More...
 
int fa125FirmwareGVerifyFull ()
 Verify that the firmware has been written correctly to all initialized fADC125s. More...
 
int fa125FirmwareReadMcsFile (char *filename)
 Read in the firmware from selected MCS file. More...
 
void fa125FirmwarePrintFPGAStats ()
 Prints to standard out, the memory size and location of each FPGA firmware. More...
 
void fa125FirmwarePrintPage (int page)
 Prints the selected firmware page to standard out. More...
 
int fa125FirmwareEraseFull (int id)
 Erase the entire contents of the configuration ROM of the selected fADC125. More...
 
int fa125FirmwareGEraseFull ()
 Erase the entire contents of the configuration ROM for all initialized fADC125s. More...
 
int fa125FirmwareWriteFull (int id)
 Write the contents of the read in MCS file to the selected fADC125 Configuration ROM. More...
 
int fa125FirmwareGWriteFull ()
 Write the contents of the read in MCS file to the Configuration ROM of all initialized fADC125s. More...
 
void fa125FirmwarePrintTimes ()
 Print the time it took for each firmware update step to standard out. debug = FA125_FIRMWARE_DEBUG_MEASURE_TIMES Must be selected prior to update. More...
 
int fa125FirmwareGCheckErrors ()
 Print to standard out the results of the firmware update for each initialized fADC125. More...
 

Detailed Description

Function Documentation

int fa125FirmwareEraseFull ( int  id)

Erase the entire contents of the configuration ROM of the selected fADC125.

Parameters
idSlot Number
Returns
OK if successful, otherwise ERROR.

References FA125_FIRMWARE_DEBUG_VERIFY_ERASE, fa125FWstats, fa125ID, and fa125p.

int fa125FirmwareGCheckErrors ( )
int fa125FirmwareGEraseFull ( )

Erase the entire contents of the configuration ROM for all initialized fADC125s.

Returns
OK if successful, otherwise ERROR.

References FA125_FIRMWARE_DEBUG_VERIFY_ERASE, FA125_FIRMWARE_ERROR_ERASE, FA125_FIRMWARE_ERROR_VERIFY_ERASE, fa125FWstats, fa125p, fa125Slot(), and nfa125.

int fa125FirmwareGVerifyFull ( )

Verify that the firmware has been written correctly to all initialized fADC125s.

Returns
OK if successful, otherwise ERROR.

References FA125_FIRMWARE_ERROR_VERIFY_WRITE, fa125Slot(), and nfa125.

int fa125FirmwareGWriteFull ( )

Write the contents of the read in MCS file to the Configuration ROM of all initialized fADC125s.

Returns
OK if successful, otherwise ERROR.

References FA125_FIRMWARE_ERROR_PUSH, FA125_FIRMWARE_ERROR_PUSH_WAIT, FA125_FIRMWARE_ERROR_VERIFY_WRITE, FA125_FIRMWARE_ERROR_WRITE, fa125FWstats, fa125ID, fa125p, fa125Slot(), and nfa125.

void fa125FirmwarePrintFPGAStats ( )

Prints to standard out, the memory size and location of each FPGA firmware.

References MAIN, and NFPGATYPE.

Referenced by fa125FirmwareReadMcsFile().

void fa125FirmwarePrintPage ( int  page)

Prints the selected firmware page to standard out.

Parameters
pageSelected page

References FA125_FIRMWARE_MAX_BYTE_PER_PAGE.

void fa125FirmwarePrintTimes ( )

Print the time it took for each firmware update step to standard out. debug = FA125_FIRMWARE_DEBUG_MEASURE_TIMES Must be selected prior to update.

See Also
fa125FirmwareSetDebug

References fa125FWstats.

int fa125FirmwareReadMcsFile ( char *  filename)

Read in the firmware from selected MCS file.

Parameters
filenameName of file that contains the firmware in MCS format.
Returns
OK if successful, otherwise ERROR.

References FA125_FIRMWARE_DEBUG_MCS_FILE, FA125_FIRMWARE_DEBUG_MCS_SKIPPED_LINES, fa125FirmwarePrintFPGAStats(), MAIN, MCS_MAX_SIZE, and NFPGATYPE.

void fa125FirmwareSetDebug ( unsigned int  debug)

Set the debugging flags for diagnosing firmware updating problems.

Parameters
debugDebug bit flags
See Also
FA125_FIRMWARE_DEBUG_FLAGS
int fa125FirmwareWriteFull ( int  id)

Write the contents of the read in MCS file to the selected fADC125 Configuration ROM.

Parameters
idSlot Number
Returns
OK if successful, otherwise ERROR.

References FA125_FIRMWARE_DEBUG_WRITE_BUFFER, fa125FWstats, fa125ID, and fa125p.