Skip to content

QICK Setup

This is a tutorial for setting up a new QICK board that is compatible for this package.

This tutorial is only for ZCU216 hardware!

Hardware and Operating System

Assemble the hardware. Note that all the mode switches should be left, except the 0 should be right(on).

Use the Win32 Disk Imager to write the PYNQ operating system into the SD card. The system image can be downloaded from the following link:

Plug in the SD card and power on the board.

Network Setup

Connect the QICK board to a router via an Ethernet cable. Connect a computer to the same router.

Open the router's configuration page and find the IP address of the QICK board. By default, the QICK board uses DHCP to get an IP address automatically. This IP address can be found on the router configuration page under "Connected Devices", "DHCP Clients" or similar lists.

The IP address is labeled as $IP in the following steps. Now you can access the QICK board via SSH. (password is xilinx)

ssh xilinx@$IP

To enter the root user, use the command

sudo -s

Static IP (optional)

Edit /etc/network/interfaces.d/eth0 by the command (with root):

nano /etc/network/interfaces.d/eth0

Overwrite the whole file with the following content

In the example here, the target IP address is 192.168.1.100, the gateway (IP address of the router) is 192.168.1.1, and the netmask is 255.255.255.0.

You should change these values to your desired configuration.

auto eth0
iface eth0 inet static
address 192.168.1.100
netmask 255.255.255.0
gateway 192.168.1.1

Triple check before saving the file! You will need to redo everything in this tutorial if you made a typo here.

Restart the QICK board (by command reboot) to let the changes take effect.

Install qick

Download the dependency and installation script from the DropBox folder. Open a terminal in the folder to execute the following commands.

Transfer dependency and installation script to the QICK board:

scp install.sh dependency.tar.gz xilinx@$IP:~

Login to the QICK board via ssh: (password is xilinx)

ssh xilinx@$IP

On the QICK board, run the installation script:

sudo chmod +x install.sh && sudo ./install.sh

Wait until the installation is complete. The script will ask you to set up a host name.

Soft Reboot

Sometimes the QICK programs freeze when you run an experiment. This is typically caused by shutting down the board by turning off the power supply. To fix this, restart the board using soft reboot:

Login to the QICK board via ssh: (password is xilinx)

ssh xilinx@$IP

Restart the board from the operating system:

sudo reboot