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) ..........................14 Required Initial Linux Commands ....................14 White Rabbit ..........................14 Useful Linux Commands ......................15 Direct Network Connection between PZ-TIO and a Windows PC ..........15 PZ-TIO Operation ..........................17 Adjust Parameters ........................17 Data Acquisition Monitoring ...................... 17 User Interface Options ........................
Linux Passwords The PZ-TIO 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 PZ-TIO is connected to external networks.
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.
At this point, all the PZ-TIO really does is allowing a PicoZed to blink an LED or toggle an output pin in sync with a White Rabbit or other PTP master. Legally, we are [probably] only selling a circuit board –...
Version 1.01 PZ-TIO Features The PZ-TIO is designed as a “switchboard” for GPIO signals, synchronized by White Rabbit, to route input signals to output signals and make logical combinations between them in FPGA fabric. It has the following features and capabilities: ...
3 PMOD-style I/O connectors for direct connection to PL pins 1 connector is a 12-pin receptacle 2 connectors are right angle headers (not stuffed by default) 3.3V power from PZ-TIO to peripheral 1 microHDMI 1 microHDMI for buffered 5V TTL input or output signals...
Table 1-1. Specifications for the PZ-TIO System Requirements The system considered here consists of a PZ-TIO, a PicoZed, and a White Rabbit switch (or other PTP master) plus appropriate cabling. Optional connections can be made to external electronics. A PC, smartphone or tablet is required to communicate with the PicoZed, but trigger routing and clock synchronization is fully contained in the combination of PicoZed and PZ-TIO.
Software and Firmware Overview The software of the PicoZed carried by the PZ-TIO 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.
Web server SMB (Samba) file sharing The typical procedure for setup would be to first to power up the PZ-TIO (2.1), then install and configure drivers for the serial port on a USB master PC (2.2). Log on via serial port terminal, find the PZ-TIO’s IP address, and execute a few setup programs (2.5).
Web Interface Any web browser can be used to log in via the network once the PZ-TIO is powered, connected to a network, and its IP address is known. The IP address can be found by ...
The PZ-TIO Linux OS is running Samba, a “Windows interoperability suite of programs for Linux and Unix”. It allows the files in the Linux partition of the PZ-TIO SD card to be shared with Windows networking. By default, only one folder is shared (/var/www) which is the location of the API functions.
The above description of setup and operation of the PZ-TIO assumes both PZ-TIO 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 PZ-TIO to a laptop or desktop Currently /dev/sda1 is not available in Linux...
Page 16
In the properties dialog, set IP address, subnet mask, and gateway as shown above. (The gateway is equal to PZ-TIO’s IP address.) Note: The network will not be able to connect to the internet. The date/time of the PZ-TIO will likely be initialized to 1970.
The C function “monitordaq” is a template demonstrating how to periodically read FPGA status registers and print them to file. At this point, the PZ-TIO is mainly a demonstration unit for the White Rabbit IP core implementation. As such, the main interest if for firmware programmers who want to understand and test the IP core.
3.3.1 Terminal At the most basic level, users can log in to the PZ-TIO 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.
C programs as a cgi script through a browser. The Web Operation page can be reached via a link in the “CGI Current Data” section of the PZ-TIO Home page. It essentially lists the C functions that would normally be called by typing in the terminal;...
Page 20
PZ-TIO Manual Version 1.01 (/var/www/webops). The Web Operation page shows the equivalent links from the PZ-TIO home page to download and display the data. Settings files can currently not be modified through the Web Operation page. As this webpage allows generation and execution of files from any remote user, the webserver has been set up to require authentication to access this webpage.
Convert into “FPGA units”, e.g. number of samples instead of us (where necessary) Apply limits and dependencies, if not ok, give feedback and abort Read data from PROM and verify the current version of the PZ-TIO hardware is supported by the software Write to FPGA registers to apply settings Toggle I2C lines to read PZ-TIO information from PROM.
Version 1.01 5 Web Pages The PZ-TIO web pages are located in /var/www; this is the default directory for the installed lighttpd webserver. Browsing to the PZ-TIO’s IP address will bring up index.html, from which all other pages can be accessed.
Internally, this is a d3 javascript that links to the file RS.csv. The file is generated by executing ./runstats on the PZ-TIO terminal. A similar page reading and displaying the data can be generated by the script cgistats.cgi from the web browser.
The FPGA (PL) registers described below are used to apply settings to the firmware and read back event data. This is generally handled by XIA’s API functions 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’s API function progfippi to convert...
XIA and the modified source code is provided both on the SD card and on XIA’s website. The source code for the Linux kernel built by XIA for the PZ-TIO 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.
10 Hardware Information 10.1 Board Architecture Figure 10-1: Block diagram of the PZ-TIO. Blue lines indicate data connections, green clocks or triggers. Dashed lines are available but currently not implemented (and therefore not fully tested or guaranteed to function). Black dotted lines indicate internal data connections in the Zynq.
Figure 10-2: Pinout of PMOD connectors; here: J101. Signal lines are routed as differential lines, but by default are used as single ended 3.3V TTL signals. The PZ-TIO implements 3 PMOD-style I/O connectors. All signal I/O pins connect to the PicoZed FPGA pins, without buffers or overvoltage protection. Signal lines are routed as differential lines, but by default are used as single ended 3.3V TTL signals.
Version 1.01 10.3 Clocks Figure 10-5: Block diagram of the PZ-TIO clocking. The CLK PLL (and to some degree the PTP PHY) can be programmed to generate different frequencies from any of the input clocks. Default clock paths are shown in darker green. Not shown are Ethernet and related GTX clocks.
10.6.1 Overview The Zynq SoC used as the PZ-TIO’s processor has a number of PTP functions 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.
To start LinuxPTP in the foreground with status messages, type ptp4l -i eth0 -m –q in the PZ-TIO terminal session. If another PTP node is present in the network, the PZ-TIO will try to link with it. The master clock node is determined automatically; for a defined setup we recommend start ptp4l in one PZ-TIO as shown above and wait until it assigns itself as the clock master, then start ptp4l in the second/third PZ-TIO with the added –s...
Gigabit Ethernet The secondary Ethernet PHY operates only at 10/100 Ethernet. 10.7 White Rabbit Hardware Elements The PZ-TIO supports implementation of the White Rabbit IP core in the PicoZed PL as follows: SFP card cage with appropriate connections to FPGA fabric and GTX data pins for the 1Gbps Ethernet connection.
Version 1.01 11 Software Information The PZ-TIO software consists of a number of C routines located in /var/www. 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;...
A RTC chip is present but has never been tested. The USB/UART interface sometimes scrambles the output into special characters. Use of SSH is recommended except for finding out the PZ-TIO’s IP address. The booting process may occasionally hang at the u-boot stage. Manual typing “boot”...
Need help?
Do you have a question about the PZ-TIO and is the answer not in the manual?
Questions and answers