XIA Pixie-32 Manuale utente
Pixie-32
User Manual
Version 0.2
July, 2018
Software Revision: 3.5.0
XIA LLC
31057 Genstar Rd
Hayward, CA 94544 USA
Email: [email protected]
Tel: (510) 401-5760; Fax: (510) 401-5761
http://www.xia.com/
Information furnished by XIA LLC is believed to be accurate and reliable. However, no responsibility is
assumed by XIA for its use, or for any infringements of patents or other rights of third parties which may
result from its use. No license is granted by implication or otherwise under any patent or patent rights of
XIA. XIA reserves the right to change hardware or software specifications at any time without notice.
Pixie-32 User Manual Version 0.2
Manual Convention 5
Introduction 5
Hardware Setup 5
Software Installation 5
Getting Started 7
Start Application 7
Configure tab 8
[Boot] 9
[Configure] 9
[Oscilloscope] 9
[Adjust Offsets] 10
Acquire tab 10
[Start] 10
[Stop] 11
[Statistics] 12
[Analysis] 12
Appendix 16
Initialization file format 16
Configuration file format 16
List-mode data format 19
Statistics file format 20
API functions 21
API Function: P32_GetAPIVersion 21
API Function: P32_SysConfig 22
API Function: Pixie_Boot_System 22
API Function: Pixie_Acquire_Data 23
API Function: PIXIE500E_GetNumberModules 25
API Function: PIXIE500E_GetModuleSerialNumber 25
© 2017 XIA LLC 2
Pixie-32 User Manual Version 0.2
Warranty Statement
XIA LLC warrants that this product will be free from defects in materials and
workmanship for a period of one (1) year from the date of shipment. If any such product
proves defective during this warranty period, XIA LLC, at its option, will either repair the
defective products without charge for parts and labor, or will provide a replacement in
exchange for the defective product.
In order to obtain service under this warranty, Customer must notify XIA LLC of the
defect before the expiration of the warranty period and make suitable arrangements for
the performance of the service.
This warranty shall not apply to any defect, failure or damage caused by improper uses or
inadequate care. XIA LLC shall not be obligated to furnish service under this warranty a)
to repair damage resulting from attempts by personnel other than XIA LLC
representatives to repair or service the product; or b) to repair damage resulting from
improper use or connection to incompatible equipment.
THIS WARRANTY IS GIVEN BY XIA LLC WITH RESPECT TO THIS PRODUCT
IN LIEU OF ANY OTHER WARRANTIES, EXPRESSED OR IMPLIED. XIA LLC
AND ITS VENDORS DISCLAIM ANY IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. XIA’S
RESPONSIBILITY TO REPAIR OR REPLACE DEFECTIVE PRODUCTS IS THE
SOLE AND EXCLUSIVE REMEDY PROVIDED TO THE CUSTOMER FOR
BREACH OF THIS WARRANTY. XIA LLC AND ITS VENDORS WILL NOT BE
LIABLE FOR ANY INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL
DAMAGES IRRESPECTIVE OF WHETHER XIA LLC OR THE VENDOR HAS
ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES.
1.1 Contact Information:
XIA LLC
31057 Genstar Rd.
Hayward, CA 94544 USA
Telephone: (510) 401-5760
Downloads: http://support.xia.com
Hardware Support: [email protected]
© 2017 XIA LLC 3
Pixie-32 User Manual Version 0.2
2 Manual Convention
The following conventions are used throughout this manual
Convention
Description
Example
Bold
Bold text denotes items that
you must select or click on in
the software, such as menu
items, and dialog box
options.
...click on the MCA tab.
[Bold]
Bold text within [ ] denotes a
command button.
[Start Run] indicates the command button
labeled Start Run.
monospace
Items in this font denote text
or characters that you enter
from the keyboard, sections
of code, file contents, and
syntax examples.
Setup.exe refers to a file called “setup.exe”
on the host computer.
“window”
Text in quotation refers to
window titles, and quotations
from other sources
“Options” indicates the window accessed via
Tools»Options.
Italics
Italic text denotes a new term
being introduced , or simply
emphasis
peaking time
refers to the length of the slow
filter.
...it is important first to set the energy filter Gap
so that SLOWGAP to at least one unit greater
than
the preamplifier risetime...
© 2017 XIA LLC 4
Pixie-32 User Manual Version 0.2
3 Introduction
3.1 Hardware Setup
Place the Pixie-32 modules into any peripheral PXIe or PXIe/PXI hybrid slot with the
chassis still powered down, then power up the chassis (Pixie-32 modules are not hot
swappable). If using a remote controller, be sure to boot the host computer after powering
up the chassis.
3.2 Software Installation
Currently API library (Pixie32.dll) is distributed as a pre-built DLL for 64-bit Windows.
When the host computer is powered up the first time after installing the controller and
Pixie-32 modules in the chassis, it will detect new hardware and try to find drivers for it.
(A Pixie-32 module will be detected as a new device every time it is installed in a new
slot.) While there is no required order of installation of the driver software, the following
sequence is recommended (users with embedded host computer skip to step 4):
1. If you have a remote controller, first install the driver software for the controller
itself. Otherwise, skip to step 4.
Unless directed otherwise by the manufacturer of the controller, this can be done
with or without the controller and Pixie-32 modules installed in the host computer
and/or chassis. If the modules are installed, ignore attempts by Windows to install
drivers until step 7.
NI controllers come with a multi-CD package called “Device Driver Reference CD”.
For simplicity it is recommended to install the software on these CDs in the default
configuration.
2. Unless already installed, power down the host computer, install the controller in
both the host computer and chassis, and power up the system again (chassis first).
3. Windows will detect new hardware (the controller) and should find the drivers
automatically. Verify in Windows device manager that the controller is properly
installed and has no “resource conflicts”.
4. Unless already installed, power down the host computer and install the Pixie-32
modules in the chassis. Then power up the system again (chassis first). Ignore
attempts by Windows to install drivers until step 7.
5. Install the Pixie-32 software provided by XIA.
(for version X.Y.Z)
Pixie-32_X.Y.Z_setup.exe
Run the setup program and follow the instructions shown on the screen to install the
software to the default folder selected by the installation program, or to a custom
folder. Driver installation is rather lengthy (the PC may pause for extended periods
of time) and may require acknowledgment of unsigned drivers. The installation
© 2017 XIA LLC 5
Pixie-32 User Manual Version 0.2
folder will contain 7 subfolders (Sample, Configuration, Firmware, Drivers, Doc,
DSP, PixieCLib). “Sample” is default location for starting the viewer.
6. Windows will detect new hardware (the Pixie-32 modules) and should find the
drivers automatically. If not, direct it to the “Drivers” directory in the Pixie-32
software distribution installed in step 5. Verify in Windows device manager that the
modules are properly installed as “Pixie32” (along with WinDriver) under Jungo
devices and have no “resource conflicts”.
7. If kernel driver (WinDriver) and device driver (Pixie32) need to be installed
manually, change in “Drivers/amd64” directory (for 64-bit system), and execute
a. wdreg.exe -inf windrvr6.inf install
b. wdreg.exe -inf Pixie32.inf install
8. Display and analysis GUI needs Python and wxPython to be installed:
a. Install Python-2.7 for 64-bit architecture
b. Install wxPython-3.0 for 64-bit architecture
c. Install matplotlib/numpy modules for Python. On console, execute:
i. python -m pip install -U pip setuptools
ii. python -m pip install matplotlib
© 2017 XIA LLC 6
Pixie-32 User Manual Version 0.2
Getting Started
Start Application
The installation script should have placed the following files in the Sample sub-folder: Pixie32.dll, Python
files (wx_pixie32.py, pixie32.py, p32_globals.py, event_frame.py, spectrum_frame.py, stats_frame.py,
oscilloscope_frame.py), initialization file (default p32.ini), parser.exe. The initialization file contains
locations of the FPGA firmware file (p32_firmware_r*.bin, placed in Firmware folder), and of
configuration files for each module (FipRegs_m00.txt in Configuration folder).
The initialization file must have the list of serial numbers, matching those of modules installed in chassis.
To start the Pixie-32 Viewer, open terminal, change into directory containing Python scripts and
Pixie32.dll (usually Sample folder), and execute:
python wx_pixie32.py p32.ini
Note that some operations can be applied to all modules at one (boot, configure, run start, run stop, adjust
offsets), if “All modules” checkbox by the module list is marked. Same operations can be performed on a
single module (checkbox is not marked). Some operations (oscilloscope, reading live statistics) only apply
to one module, selected from the module list. Some operations deal with post-processing data (event
display, reading offline statistics read and parse data from files), and do not depend on module selected in
the module list.
The viewer can be started in offline mode
python wx_pixie32.py --offline p32.ini
This can be used for analysis of already collected data.
Internally modules are addressed by 0-based enumeration, which is normally used by log printouts.
Console window is primary output of error, status, and debug messages from API function calls, and the
GUI. API messages are also recorded in PIXIEmsg.txt file. Verbosity of the output is set via initialization
file.
© 2017 XIA LLC 7
Pixie-32 User Manual Version 0.2
Configure tab
Prior to performing any operations with the instrument, FPGA must be booted with correct firmware file,
and internal FPGA registers initialized with user-provided parameters. Locations of firmware and
© 2017 XIA LLC 8
Pixie-32 User Manual Version 0.2
configuration files are read from the initialization file, and displayed above “Configure” button box.
Actions of clicking buttons are described below.
[Boot]
Load the FPGA firmware to the instrument. After successful booting, the front panel LED will start
blinking. Booting must be performed before any other operations after power up, and every time new
firmware file needs to be loaded. Not necessary in offline mode. Not needed if instrument has been
already booted (just restarting the viewer software).
[Configure]
Read in configuration file, check parameter values, apply them to the hardware. Needed every time after
re-booting FPGA (cold start, or after loading firmware), as well as when parameters have been changed in
the configuration file and need to be applied. Non necessary in offline mode, or if the instrument has been
already booted and configured (just after restarting the viewer software).
[Oscilloscope]
Can be used to check signal quality and DC offsets. Not available during data acquisition.
© 2017 XIA LLC 9
Pixie-32 User Manual Version 0.2
[Adjust Offsets]
Can be used to automatically set baselines to 10% of ADC range. The values of DCOffset parameter for
each are written to file adjust_offsets_m##.txt (where ## is module number), so they can easily be pasted
into configuration file. Not available during data acquisition.
Acquire tab
Once device is booted and configured, it is ready to acquire list-mode data. Data stream consists of header
words and optional captured trace samples. Event is recorded if it passes threshold and no pile-up
conditions. Header structure is described in “List-mode data format” below. The configuration parameters
defining event recording are:
●FastThreshold: trigger threshold, must be adjusted, so the events are recorded with reasonable
dead time.
●TraceMode: when set to 3, trace is captured. With other values, only event headers are recorded.
●QDCEnable: when set to 1, QDC sums (of lengths defined by QDC#Len) are recorded in words
5--8 of event headers. Otherwise (parameter is set to 0), the event header consists of 4 words.
●TraceLength: size of recorded trace in 20-ns samples.
●ExtTrigEnable: when set to 1, external trigger must be provided to capture events.
●PSDEna: when set to 1, PSA trigger parameters must be tuned to trigger properly.
As data is streamed in 2MB buffers to the host, where it is recorded in file, defined by name in the main
panel (File Name: text input box), with extension .b## (## is module number).
It is possible to start/stop run simultaneously for all modules, or just the one selected in the module list.
[Start]
© 2017 XIA LLC 10
Indice
Altri manuali XIA Unità di controllo
Manuali Unità di controllo popolari di altre marche
Festo
Festo Compact Performance CP-FB6-E Manuale elenco delle parti
Elo TouchSystems
Elo TouchSystems DMS-SA19P-EXTME Manuale utente
JS Automation
JS Automation MPC3034A Manuale utente
JAUDT
JAUDT SW GII 6406 Series Guida rapida
Spektrum
Spektrum Air Module System Manuale utente
BOC Edwards
BOC Edwards Q Series Manuale utente
