Page 1
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.
SMB (Samba) ..........................13 Required Initial Linux Commands ....................13 Useful Linux Commands ......................13 Direct Network Connection between Pixie-16 MZ-TrigIO and a Windows PC ......14 Pixie-16 MZ-TrigIO Operation......................16 Adjust Parameters ........................16 Data Acquisition Monitoring ...................... 17 User Interface Options ........................
Page 3
Pixie-16 MZ-TrigIO Manual Version 0.51 Web Pages............................22 index.html ........................... 22 rspage.html, cgistats.cgi ......................23 Parameters in the Settings Files ......................24 System Parameters ........................24 Local Control ..........................25 Trigger Control Parameters ......................26 Data Formats ............................28 Status Files (RS.csv) ........................28 Registers Visible to Linux ........................
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 .
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.
Pixie-16 MZ-TrigIO Manual Version 0.51 Manual Conventions The following conventions are used throughout this manual Convention Description Example The » symbol leads you The sequence » through nested menu items File»Page Setup»Options directs you to pull and dialog box options.
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.
Pixie-16 MZ-TrigIO Manual Version 0.51 1.2 Specifications Front Panel I/O LVDS 12 RJ-45 connectors for general purpose LVDS I/O with CAT-5 cables Input/Output (48x) 4 signal pairs each programmable input or output direction for each signal individually Vio H/L: +/- 100 mV...
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.
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.
Web server SMB (Samba) file sharing The typical procedure for setup would be to first to power up the Pixie-16 MZ-TrigIO (2.1), then install and configure drivers for the serial port on a USB master PC (2.2). Log on via...
2.4 Web Interface Any web browser can be used to log in via the network once the Pixie-16 MZ-TrigIO is powered, connected to a network, and its IP address is known. The IP address can be found...
This is the directory visible via the web server. Data created by execution of XIA API functions can be read via the web browser from this directory. For convenience, it contains a elea e of all XIA SW f nctions and is used as the default working directory. (Not required for web operations page) Apply settings to FPGA: ./progfippi...
The above description of setup and operation of the Pixie-16 MZ-TrigIO assumes both Pixie-16 MZ-TrigIO and the user device (PC, tablet, smartphone) are connected to a local network with DHCP server and gateway. Instead, it is possible to directly connect the Pixie-16 MZ-TrigIO to a laptop or desktop with a standard Ethernet cable (no crossover cable required).
Page 15
In the properties dialog, set IP address, subnet mask, and gateway as shown above. (The gateway is equal to Pixie-16 MZ-TrigIO IP add e .) Note: The network will not be able to connect to the internet. The date/time of the Pixie- 16 MZ-TrigIO will likely be initialized to 1970.
Version 0.51 3 Pixie-16 MZ-TrigIO Operation Basic operation of the Pixie-16 MZ-TrigIO uses a combination of terminal commands and web interface. The former controls all parameter settings (and possible DAQ monitoring) and requires login to the system. The latter displays data and is accessible to anyone. This provides a measure of security in instrument control while making it convenient to view data.
3.3.1 Terminal At the most basic level, users can log in to the Pixie-16 MZ-TrigIO with a terminal program and execute the C programs to set up and read status (e.g. ./progfippi and ./runstats). Settings are modified by editing the settings file settings.ini with a basic text editor like VI.
Linux permissions for data write access for the webserver (/var/www/webops). The Web Operation page shows the equivalent links from the Pixie-16 MZ-TrigIO home page to download and display the data. Settings files can currently not be modified through the Web Operation page.
A further alternative to the terminal entry and execution of the C programs is available on Pixie-16 MZ-TrigIO systems with the Ubuntu 15 operating system, which comes with the ROOT software package installed. A ROOT GUI can be developed that can configure the Pixie-16 MZ-TrigIO (./progfippi etc), view ADC traces, read the status information...
, e.g. n mbe of ample in ead of (where necessary) Apply limits and dependencies, if not ok, give feedback and abort Read data from PROM and verify the current version of the Pixie-16 MZ-TrigIO hardware is supported by the software Write to FPGA registers to apply settings Toggle I2C lines (0x002) to set LVDS direction etc.
Pixie-16 MZ-TrigIO Manual Version 0.51 4.3 clockprog Programs the clock PLL that buffers PTP or external clocks for FPGA and backplane. A number of modes are hardcoded in the program; others can be added with the CDCE813-Q1 data sheet and TI ClockPro utility as a reference.
Version 0.51 5 Web Pages The Pixie-16 MZ-TrigIO web pages are located in /var/www; this is the default directory for the installed lighttpd webserver. Browsing to the Pixie-16 MZ-TrigIO IP address will bring up index.html, from which all other pages can be accessed.
The rspage contains a table showing the Run Status information: the inputs from front and rear, version numbers, temperatures. Internally, this is a d3 javascript that links to the file RS.csv. The file is generated by executing ./runstats on the Pixie-16 MZ-TrigIO terminal.
Pixie-16 MZ-TrigIO Manual Version 0.51 6 Parameters in the Settings Files The ini files contain the parameter settings for the data acquisition. There are two files, defaults.ini and settings.ini. The file defaults.ini should be considered read-only; it contains defaults for all parameters. The file settings.ini contains a subset of most relevant parameters, which will overwrite the defaults.
Pixie-16 MZ-TrigIO Manual Version 0.51 6.2 Local Control Local Control parameters are intended for settings that affect the local logic in the FPGA. Examples include which reset signals to use for internal counters (PTP, Pixie-16 backplane, external) or what to count. Currently all parameters are unused.
Pixie-16 MZ-TrigIO Manual Version 0.51 6.3 Trigger Control Parameters Trigger Control parameters define the routing of backplane and front panel signals. Parameter Name Type Description FRONT_A_OUTENA 16 bits Bit pattern to enable outputs from the FPGA to the 16 LVDS buffers at the front panel.
Page 27
Pixie-16 MZ-TrigIO Manual Version 0.51 0 TriggerAll [15:00] 1 - TriggerAll [15:00] & coinc mask 2 - TriggerAll [15:00] & multiplicity mask 3 coincidence test bit 3 (all 16 lines) 4 coincidence test 11 (all 16 lines) 5 test signal, periodic toggle...
Pixie-16 MZ-TrigIO Manual Version 0.51 7 Data Formats 7.1 Status Files (RS.csv) Status files contain comma separated values. The first row lists the column headers. The columns are Name of local result/status ParameterL Value of local result/status LocalLogic Name of trigger status/result...
Page 29
Pixie-16 MZ-TrigIO Manual Version 0.51 RunTime is a result computed by the .runstats routine, converting the number of clock cycles in the RUNTICKS counter into seconds. TriggerRate is a is a result computed by the .runstats routine, dividing the number of pulses counted in NUMTRIGGERS by the runtime.
The FPGA (PL) registers described below are used to apply settings to the firmware and read back event da a. Thi i gene all handled b XIA API f nc ions and users do not need to go in depth to understand this functionality. The primary way to set registers is by specifying parameters in the .ini file and call XIA API f nc ion progfippi to convert...
Page 31
Pixie-16 MZ-TrigIO Manual Version 0.51 EBDATA_ 0x104 Bit pattern to enable outputs to the 16 OUTENA backplane trigger signals. FRONT_A_ 0x108 Inputs are bitwise ANDed (masked) with this COINC_MASK pattern before being used in the coincidence test. FRONT_B_ 0x109 COINC_MASK...
Pixie-16 MZ-TrigIO Manual Version 0.51 2 - TriggerAll [15:00] & multiplicity mask 3 coincidence test bit 3 (all 16 lines) 4 coincidence test 11 (all 16 lines) 5 test signal, periodic toggle FRONT_B_ 0x129 Defines the signal to output on Front B panel...
Page 33
Pixie-16 MZ-TrigIO Manual Version 0.51 12 - masked sum of EB_DATA >= threshold 13-15 - unused unused 0x006- unused 0x009 NUMTRIG_L 0x00A Number of pulses on TriggerAll[7] (low, high) NUMTRIG_H 0x00B Reset by writing to 0x009 TriggerAll[7] is the Pixie-16 chassis fast trigger.
A small portion of the software is modified by XIA and the modified source code i p o ided bo h on he SD ca d and on XIA website. The source code for the Linux kernel built by XIA for the Pixie-16 MZ-TrigIO and for the full collection of Ubuntu Linux programs is too large for the SD card or to host by XIA, but we can provide it upon request.
Page 35
(visible) in a small FAT partition. FPGA configuration updates have to be copied to that partition. Notes for the particular configuration of Ubuntu 15 for Pixie-16 MZ-TrigIO: Installed Lighttpd web server The default webpage is in /var/www. Need to modify /etc/lighttpd/lighttpd.conf as follows: add mod_cgi under server.modules and...
Page 36
Pixie-16 MZ-TrigIO Manual Version 0.51 Set up lighttpd for authentication for web ops 1) Modify /etc/lighttpd/lighttpd.conf file server.modules += ( "mod_auth" ) auth.debug = 2 auth.backend = "plain" auth.backend.plain.userfile = "/var/www/webopspasswords" auth.require = ( "/webops/" => "method" => "basic", "realm" => "Password protected area", "require"...
Page 37
Pixie-16 MZ-TrigIO Manual Version 0.51 (white: data files created by webops, blue: links, green: webop specific html page) Zync temperature For kernel 2.x (Xillinux), temperature in Celsius can be read from file /sys/devices/amba.0/f8007100.ps7-xadc/temp For kernel 4.x, raw files are /sys/devices/soc0/amba/f8007100.adc/iio:device0, which is difficult to open/read from a program because of the colon.
Pixie-16 MZ-TrigIO Manual Version 0.51 10 Board Architecture The P16 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 the FPGA fabric of a Zynq SOM .
Pixie-16 MZ-TrigIO Manual Version 0.51 16 EB_Da a line [31:16] in J3 (bussed to slots in the same PCI backplane segment) 2 Con ol line [5:4] ( i h p ll p , b ed o all lo in he PXI backplane,...
Pixie-16 MZ-TrigIO Manual Version 0.51 10.1.3 Zynq SOM Connections The MicroZed Zynq SOM itself has connections for Ethernet, USB, SD card, PMOD, and USB/UART. These signals are not brought out to the front panel. Instead, cables can be connected and brought out through an empty PXI slot. There is a PROM/thermometer (TMP116) on the P16 MZ TrigIO module that is connected to the same I2C bus as the front panel buffer direction control chips.
With suitable network configurations, this can achieve sub-nanosecond precision. 10.4.1 Overview The Zynq SoC used as the Pixie-16 MZ-TrigIO p oce o ha a n mbe of PTP f nc ion built into its standard Ethernet controller. With suitable Linux kernel options and PTP stack software (see below), the Zynq PTP clock can be synchronized to other PTP nodes in the network with a precision of ~1500 ns.
Pixie-16 MZ-TrigIO Manual Version 0.51 Figure 10-1: Block diagram of the PTP clocking and triggering of the Pixie-16 MZ-TrigIO. Clocks in red. Refer to jumper settings for the MMCX (JP601) in section 11. Frequencies marked with * can be varied with suitable modification of the PLL via the clockprog utility.
Pixie-16 MZ-TrigIO Manual Version 0.51 in the Pixie-16 MZ-TrigIO terminal session. If another PTP node is present in the network, the Pixie-16 MZ-TrigIO will try to link with it. The master clock node is determined automatically; for a defined setup we recommend start ptp4l in one Pixie-16 MZ-TrigIO as shown above and wait until it assigns itself as the clock master, then start ptp4l in the second/third Pixie-16 MZ-TrigIO with the added –s option to force it to clock slave mode.
Pixie-16 MZ-TrigIO Manual Version 0.51 ./clockprog m where m stands for one of the following mode numbers: Mode clockprog function Report the register values P og am he c en egi e al e in o he PLL EEPROM o make hem the new power-up defaults.
Version 0.51 11 Hardware Information 11.1 Jumpers Pixie-16 MZ-TrigIO boards have the following internal jumpers JP500-JP503 When a shunt is connecting pin 1 and pin 2 in each jumpers JP501 and JP503, the boa d 3.3V and 5.0V po e plane a e connec ed o he PXI backplane power.
They include the API functions listed in section 4, plus a number of support code files for reading parameters from the settings file or utilities for I2C I/O. All code is provided as open source; users are free to modify and expand the functions. XIA appreciates feedback and new ideas.
Pixie-16 MZ-TrigIO Manual Version 0.51 12.1.2 Parameter Definitions In PixieNetConfig.h e define he c fo he pa ame e in he ini file. The struct element is named the same as the line in he ini file. Pi ieNe Config.cpp con ain...
Each of the 8 channels of the MZTIO_MEZZ01 connects to either an even or an odd signal on the 34pin daughter card header of the Pixie-16 MZ-TrigIO. Each channel can either be an input from the coaxial connector to the header of an output from the header to the coaxial connector.
Page 49
Pixie-16 MZ-TrigIO Manual Version 0.51 The MZTIO_MEZZ01 requires 3.3V power from the Pixie-16 MZ-TrigIO; therefore jumpers JP504 JP505 must be set. The MZTIO_MEZZ01 can also be used as an adapter for 34-line flat cable to SMB or LEMO coaxial connectors. Please contact XIA for more details.
Need help?
Do you have a question about the Pixie-16 MZ-TrigIO and is the answer not in the manual?
Questions and answers