Pixie-32 User Manual
Version 0.2
S32 status = P32_SysConfig (char *config_filename);
Description:
Read configuration file, pass variables to C-library.
Must
be called prior booting or accessing
hardware.
Calling Parameters:
config_filename
configuration file name (relative or absolute path). This text file should contain at
least 5 lines, being:
●
FPGA firmware file path (relative or absolute). Usually
../Firmware/pixie32.bin
●
FPGA parameters file path base name. Usually
../Configuration/FipRegs
. With this path,
library is expecting to find files
../Configuration/FipRegs_m##.txt,
where ## is module
number
●
Cassis number (in 0 to 3 range, decimal)
●
Debug printout verbosity level, decimal integer. Bit 0 set prints debug messages during
boot (if bit 0 is not set, only errors during boot will be reported). Bit 1 set prints debug
messages during data acquisition (if bit 1 is not set, only errors will be reported). Normally
1. 3 for debugging and highest verbosity.
○
Bit 2 is a switch to user-provided interrupt service routine: when bit 2 is set,
pointer to this ISR is passed via Pixie_Acquire_Data(0x1500)
●
Serial number of module 0, decimal integer
●
Serial number of module 1, if present,
●
... and so on, for all the modules in the chassis.
Devices are enumerated according to order in which they are entered in the configuration file.
Also, it is always possible to match device number (ModNum) and device serial number use
PIXIE500E_GetModuleSerialNumber(ModNum).
There should not be empty lines. (Though, first 4 lines can have comments after '#')
Return Parameters:
Status
is a code which indicates an error in opening or structure of the configuration file (negative
status
value), or number of modules that are expected to be installed (positive
status
value).
API Function: Pixie_Boot_System
Syntax
S32 status =
Pixie_Boot_System (uint16 Boot_Pattern, uint8 ModNum);
Description:
Use this function to boot one or all Pixie-32 modules in the chassis. Before booting the modules, it
scans all PXIe crate slots and finds the address for each slot where a Pixie-32 module is installed.
If number of located modules matches the list of serial numbers recorded in the configuration file,
FPGA can be booted and/or initialized, using files defined in the configuration file. Expects that
P32_SysConfig has already been executed. This function has to be called before any hardware
access (i.e. calling Pixie_Acquire_Data()).
Calling Parameters:
© 2017 XIA LLC
24
