XIA Pixie-16 MZ-TrigIO User manual

Pixie-16 MZ-TrigIO
User Manual
Version 0.51
October 18, 2019
Hardware Revisions: A
Software Revision: 0x1002
Firmware Revision and Variants:
0x0001 (standard)
XIA LLC
31057 Genstar Rd
Hayward, CA 94544 USA
Email: [email protected]
Tel: [phone]; Fax: [phone]
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-16 MZ-TrigIO Manual Version 0.51
© 2019 XIA LLC 2
Contents
Safety ............................................................................................................................................................ 4
Specific Precautions .................................................................................................................................. 4
Power Source ........................................................................................................................................ 4
User Adjustments/Disassembly ............................................................................................................ 4
Voltage Ratings ..................................................................................................................................... 4
Servicing and Cleaning ......................................................................................................................... 4
Linux Passwords ................................................................................................................................... 4
Linux Backup ........................................................................................................................................ 4
Warranty Statement ...................................................................................................................................... 5
Contact Information: ................................................................................................................................. 5
Manual Conventions ..................................................................................................................................... 6
1 Introduction ........................................................................................................................................... 7
1.1 Pixie-16 MZ-TrigIO Features ....................................................................................................... 7
1.2 Specifications ................................................................................................................................ 8
1.3 System Requirements .................................................................................................................... 9
1.3.1 Drivers and Software ............................................................................................................ 9
1.3.2 Input Signals ......................................................................................................................... 9
1.3.3 Power Requirements ............................................................................................................. 9
1.3.4 Connectors and Cabling ...................................................................................................... 10
1.4 Software and Firmware Overview .............................................................................................. 10
1.5 Support ........................................................................................................................................ 10
2 Setup ................................................................................................................................................... 11
2.1 Power .......................................................................................................................................... 11
2.2 Serial Port (USB-UART) ............................................................................................................ 11
2.3 SSH login .................................................................................................................................... 12
2.4 Web Interface .............................................................................................................................. 12
2.5 SMB (Samba) .............................................................................................................................. 13
2.6 Required Initial Linux Commands .............................................................................................. 13
2.7 Useful Linux Commands ............................................................................................................ 13
2.8 Direct Network Connection between Pixie-16 MZ-TrigIO and a Windows PC ........................ 14
3 Pixie-16 MZ-TrigIO Operation........................................................................................................... 16
3.1 Adjust Parameters ....................................................................................................................... 16
3.2 Data Acquisition Monitoring ...................................................................................................... 17
3.3 User Interface Options ................................................................................................................ 17
3.3.1 Terminal .............................................................................................................................. 17
3.3.2 Terminal and Webpages ...................................................................................................... 17
3.3.3 Terminal, SMB and Windows programs ............................................................................ 18
3.3.4 Webpage-Only Operation ................................................................................................... 18
3.3.5 On-board ROOT Graphical User Interface ......................................................................... 19
4 API functions ...................................................................................................................................... 20
4.1 progfippi ...................................................................................................................................... 20
4.2 runstats, cgistats .......................................................................................................................... 20
4.3 clockprog..................................................................................................................................... 21
4.1 monitordaq .................................................................................................................................. 21

Pixie-16 MZ-TrigIO Manual Version 0.51
© 2019 XIA LLC 3
5 Web Pages........................................................................................................................................... 22
5.1 index.html ................................................................................................................................... 22
5.2 rspage.html, cgistats.cgi .............................................................................................................. 23
6 Parameters in the Settings Files .......................................................................................................... 24
6.1 System Parameters ...................................................................................................................... 24
6.2 Local Control .............................................................................................................................. 25
6.3 Trigger Control Parameters ......................................................................................................... 26
7 Data Formats ....................................................................................................................................... 28
7.1 Status Files (RS.csv) ................................................................................................................... 28
8 Registers Visible to Linux .................................................................................................................. 30
8.1 Input/Output Registers ................................................................................................................ 30
8.2 Output Registers .......................................................................................................................... 32
9 Linux Configuration ........................................................................................................................... 34
9.1 Licensing Information ................................................................................................................. 34
9.2 Software Information .................................................................................................................. 34
10 Board Architecture .............................................................................................................................. 38
10.1 Connections ................................................................................................................................. 38
10.1.1 Backplane Connections ....................................................................................................... 38
10.1.2 Front Panel Connections ..................................................................................................... 39
10.1.3 Zynq SOM Connections ...................................................................................................... 40
10.1.4 Custom Connections ........................................................................................................... 40
10.2 Power .......................................................................................................................................... 40
10.3 Clocks ......................................................................................................................................... 41
10.4 IEEE 1588 Precision Timing Protocol ........................................................................................ 41
10.4.1 Overview ............................................................................................................................. 41
10.4.2 PTP Stack Software: LinuxPTP .......................................................................................... 42
10.4.3 PTP PHY Control Software: ptp-mii-tool ........................................................................... 43
10.4.4 PTP Clock PLL Control Software: clockprog .................................................................... 43
10.4.5 Reduced General Purpose Functionality ............................................................................. 44
11 Hardware Information ......................................................................................................................... 45
11.1 Jumpers ....................................................................................................................................... 45
12 Information for Programmers ............................................................................................................. 46
12.1 Software Information .................................................................................................................. 46
12.1.1 File structure ....................................................................................................................... 46
12.1.2 Parameter Definitions ......................................................................................................... 47
12.1.3 FPGA registers .................................................................................................................... 47
12.1.4 Status Registers  cgi vs file vs page .................................................................................. 47
12.1.5 Other Notes ......................................................................................................................... 47
12.2 Firmware Information ................................................................................................................. 47
13 Daughter Card Options ....................................................................................................................... 48
13.1 Daughter Card MZTIO_MEZZ01 .............................................................................................. 48

Pixie-16 MZ-TrigIO Manual Version 0.51
© 2019 XIA LLC 4
Safety
Please take a moment to review these safety precautions. They are provided both for your
protection and to prevent damage to the Pixie module and connected equipment. This
safety information applies to all operators and service personnel.
Specific Precautions
Power Source
The Pixie-16 MZ-TrigIO module is powered through an AC/DC wall adapter or a PXI
backplane. The default adapter has a variety of AC plug attachments for different localities.
Please remember to shut down the Linux OS before removing the power plug from the
Pixie-16 MZ-TrigIO or powering down the PXI chassis.
User Adjustments/Disassembly
To avoid personal injury, and/or damage, always disconnect power before accessing the
modle ineio. Thee ae a few jumpers related to clocking on the board that
experienced users may want to use.
Voltage Ratings
Signals on the inputs and outputs must not exceed ± 3.3V. Please review the pinout in the
appendix before making any connections.
Daughtercards
Daughtercards can be used as alternatives to front panel and rear inputs, which requires
caution to avoid conflicts from FPGA outputs and standard connector inputs.
Servicing and Cleaning
To avoid personal injury, and/or damage to the Pixie module or connected equipment, do
not attempt to repair or clean the inside of these units.
Linux Passwords
The Pixie-16 MZ-TrigIO Linux OS comes with default user IDs and passwords for 1) SSH
login, 2) SMB file sharing, and 3) Web Operations as described below. Users should
immediately change these passwords, especially when the Pixie-16 MZ-TrigIO is
conneced o eenal neok. Don le hacke ake over your Pixie-16 MZ-TrigIO!
Linux Backup
The Pixie-16 MZ-TrigIO Lin OS i oed on a emoable SD cad. SD cad file
systems can become corrupted, which would crash the Linux system and make the Pixie-
16 MZ-TrigIO unable to operate. Therefore periodic backup of the SD card is
recommended, for example using Win32DiskImager. (Byte for byte copy is required).
Note that all Linux passwords are stored on the SD card.

Pixie-16 MZ-TrigIO Manual Version 0.51
© 2019 XIA LLC 5
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
MERCHANTABILITYOR 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.
Contact Information:
XIA LLC
31057 Genstar Rd.
Hayward, CA 94544 USA
Telephone: [phone]
Downloads: http://support.xia.com
Hardware Support: [email protected]
Software Support: [email protected]

Pixie-16 MZ-TrigIO Manual Version 0.51
© 2019 XIA LLC 6
Manual Conventions
The following conventions are used throughout this manual
Convention
Description
Example
»
The » symbol leads you
through nested menu items
and dialog box options.
The sequence
File»Page Setup»Options directs you to pull
down the File menu, select the Page Setup
item, and choose Options from the sub menu.
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 efe o a file called ep.ee
on the host computer.
window
Text in quotation refers to
window titles, and quotations
from other sources
Opion indicae he indo acceed ia
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...
<Key>
<Shift-Alt-
Delete> or
<Ctrl+D>
Angle brackets denote a key
on the keybord (not case
sensitive).
A hyphen or plus between
two or more key names
denotes that the keys should
be pressed simultaneously
(not case sensitive).
<W> indicates the W key
<Ctrl+W> represents holding the control key
while pressing the W key on the keyboard
Bold italic
Warnings and cautionary text.
CAUTION: Improper connections or settings
can result in damage to system components.
CAPITALS
CAPITALS denote DSP
parameter names
SLOWLEN is the length of the slow energy
filter
SMALL CAPS
SMALL CAPS are used for
panels/windows/graphs in the
GUI.
go o he MCADISPLAY panel and o ee

Pixie-16 MZ-TrigIO Manual Version 0.51
© 2019 XIA LLC 7
1 Introduction
The Pixie-16 MZ-TrigIO is a Zynq System on Module
1
(SoM) combined with an
input/output carrier board. The Zynq is a combination of an FPGA (Programmable Logic,
PL) with an ARM processor (Processing System, PS). The PL captures the ADC data and
applies digital pulse processing. The PS runs a basic Linux OS with gcc, webserver, etc; it
has USB and Ethernet peripherals and 1GB of memory.
The Pixie-16 MZ TrigIO carrier board is primarily a 6U breakout board for the Pixie-16
custom PXI chassis backplane. It connects ~48 lines from the backplane to one of the SOM
headers. Another ~48 lines from the second SOM header connect to front panel I/O via
LVDS I/O buffers and RJ-45 connectors for CAT-5 cables. The backplane and front panel
connecion ae alo conneced o 0.1 heade o allo diec acce ia cable o com
signal I/O via daughtercards. The SOM can be accessed via USB/UART on its native
connectors (via cabling though an empty slot) but mainly via a PTP
2
compatible 10/100M
Ethernet port on the front panel.
Besides being operated in the Pixie-16 PXI chassis, the Pixie-16 MZ TrigIO can also be
operated as a standalone desktop unit. The front panel LVDS connectors can be directly
used in desktop mode; the backplane connections are only available with custom
daughtercards or cables. When operated in a standard 6U PXI chassis, connectors J3 and
J4 have to be removed and no backplane I/O is available.
1.1 Pixie-16 MZ-TrigIO Features
The Pixie-16 MZ-TrigIO is designed to route signals from the backplane (rear connectors)
to the front panel (front connectors) and make logical combinations between them in FPGA
fabric. It has the following features and capabilities:
 Ethernet programmable trigger/coincidence control module for the Pixie-16
 48+ Pixie-16 backplane trigger connections to local Zynq processor
 48 front panel LVDS connections to local Zynq processor
 MicroZed Zynq processor with embedded Linux, acting as a standalone PC with
built-in SD card drive, USB host, 10/100 Ethernet, webserver, etc
 1588 PTP and SyncE clock synchronization
 Open source user access to software and firmware
 Use as standalone desktop unit or in 6U PXI chassis
 Custom I/O standards via daughtercards
1
Model Avnet MicroZed 7020
2
IEEE 1588 Precision Time Protocol

Pixie-16 MZ-TrigIO Manual Version 0.51
© 2019 XIA LLC 8
1.2 Specifications
Front Panel I/O
LVDS
Input/Output (48x)
12 RJ-45 connectors for general purpose LVDS I/O with CAT-5 cables
4 signal pairs each
programmable input or output direction for each signal individually
Vio H/L: +/- 100 mV
Ethernet
1 RJ-45 connector for 10/100M Ethernet
PTP and SyncE compatible
Clock Input/Output
1 MMCX coaxial connector
jumper selectable input or output
3.3V signaling standard
Power
(desktop mode only)
12V DC in.
AC adapter requirements: 12V, 10W
Barrel Plug 2.1mm I.D. x 5.5mm O.D., center positive
Rear Panel I/O
PXI J1
Used only for power, 3.3V and 5V
5V ~ 1A
3.3V ~1 A
PXI J2 (part)
PXIe XJ4
Used only for PXI clock
input to PXI_CLKIN (if located in PXI slot 2)
output from PXI_CLK
typically 50 MHz in Pixie-16 chassis, 10 MHz default chassis
PXI J3
18 backplane 3.3V trigger signals (Pixie-16 EB_Data and EB_Control)
1 clock output to right neighbor
PXI J4
34 backplane 3.3V trigger signals (Pixie-16 TriggerAll and Control)
On-Board I/O
Zynq Processor
1 USB 2.0
1 USB-UART
1 RJ45 Ethernet (10/100/1000M)
1 SD card slot
Other I/O
6 34-pin 0.1 heade fo cable o daghecad,
connecting to front/rear I/O signals (no cable drivers)
Embedded Processing
Processor
Xilinx Zynq
Data Interfaces
10/100/1000 Ethernet
USB 2.0 (host)
USB-UART

Pixie-16 MZ-TrigIO Manual Version 0.51
© 2019 XIA LLC 9
Memory
1 GB of DDR3 SDRAM
128 Mb of QSPI Flash
16 GB micro SD card (removable)
Operating System
Linux (Xillinux  based on Ubuntu 15)
Operates from Linux partition on SD card
Digital Controls
Trigger Routing
and Coincidence
Firmware demo code to
- control connections between backplane and front panel
- compute multiplicity
- test for coincidence
FPGA register
programming
C software to
- program FPGA registers that enable or disable connections.
- read FPGA status registers
Time
synchronization
C software (LinuxPTP) to operate IEEE 1588 PTP timers and adjust local
clock to network clock master
C software to define PTP timed triggers
Table 1-1. Specifications for the Pixie-16 MZ-TrigIO
1.3 System Requirements
The system considered here consists of a Pixie-16 MZ-TrigIO and Pixie-16 pulse processor
system for radiation detectors in a PXI chassis. Optional connections can be made to
external electronics. A PC, smartphone or tablet is required to communicate with the Pixie-
16 MZ-TrigIO, but trigger routing and coincidence logic is fully contained in the Pixie-16
MZ-TrigIO itself.
1.3.1 Drivers and Software
The Pixie-16 MZ-TrigIO operates with an embedded Linux system that includes all
software and drivers to communicate with external devices via Ethernet or USB. It can
- Make status information available via webserver
- Read and write USB drives for data exchanges
- Share files over a Windows network
1.3.2 Input Signals
The Pixie-16 MZ-TrigIO is designed for fast rising, exponentially decaying signals. Step
pulses and short non-exponential pulses can be accommodated with specific parameter
settings. Staircase type signals from reset preamplifiers generally need to be AC coupled.
Input signals must not exceed ± 3.3V. The LVDS signaling standard is +/- 100 mV.
1.3.3 Power Requirements
The Pixie-16 MZ-TrigIO consumes roughly 10 W It requires following currents
In PXI mode from the backplane:
3.3V up to 1.0 A
5.0V up to 1.0 A
In desktop mode from the DC adapter
12V up to 1.0 A

Pixie-16 MZ-TrigIO Manual Version 0.51
© 2019 XIA LLC 10
1.3.4 Connectors and Cabling
The Pixie-16 MZ-TrigIO uses 12 RJ-45 connectors for the LVDS signal I/O. These
connectors are not capable of Ethernet connections.
The Pixie-16 MZ-TrigIO uses 1 RJ-45 connector for the Ethernet connection. Please verify
labels on the board to ensure using the correct connector for Ethernet.
A MMCX connectors are used for clock input/outputs. MMCX to BNC adapter cables are
provided with the module.
1.4 Software and Firmware Overview
The software of the Pixie-16 MZ-TrigIO consists of a small set of C programs (API
functions) applying settings to the PL, reading data from the PL, and storing it on the SD
card (or network drives). The API functions are called from the Linux command line or as
CGI scripts from a web page. Results can be viewed or downloaded via the web page, or
copied over the network. Configuration parameters are stored in an .ini file that can be
edited by the user to adjust parameter settings.
Firmware code for the PL on-board pulse processing functions is loaded to the PL as part
of the powerup boot sequence.
Users may modify the API functions (source code and gcc compiler is included in the Linux
environment on the SD card). Applications can be executed from the SD card or a mounted
USB drive.
More sophisticated graphical user interfaces can be developed, providing control buttons
and data analysis functions. Please contact XIA for details.
1.5 Support
A unique benefit of dealing with a small company like XIA is that the technical support for
our sophisticated instruments is often provided by the same people who designed them.
Our customers are thus able to get in-depth technical advice on how to fully utilize our
products within the context of their particular applications.
Please read through the following sections before contacting us. Contact information is
listed in the first few pages of this manual.