Setting up the PYNQ board

Obtaining the PYNQ Board

The lab contains PYNQ-Z2 boards at each workstation. You do not need to buy your own board.

If you want to purchase your own Pynq-Z2 board, you can do so online at several distributors:

Imaging the SD card

The PYNQ runs Linux off of an external micro SD card that you must provide. The SD card must have a valid system image in order for Linux to run. We have provided a working system image here (unzip it after you download it), but you must image this to your own SD card. The micro SD card must be at least 16GB and class 10 or better. The official PYNQ documentation has a guide to writing the SD card image that you should follow.

Note: If you run into issues using Win32DiskImager, another alternative is to use http://etcher.io.

Connecting the PYNQ Board to a TV or Monitor

The PYNQ video signal comes from the HDMI port labeled HDMI Out located on the topside of the board. This should already be connected to a dedicated monitor in the lab. If you work remotely, you will need to find an HDMI-compatible display to use.

You can verify that your PYNQ board is imaged correctly, and connected to the display correctly by powering it on, and after it has booted (about 1 min), you should see something like this on your display:

Connect the PYNQ to Your Network

You can skip the rest of this page if only plan to work in the lab and not work remotely.

You will need to connect your PYNQ to a network with internet access. The PYNQ board does not have WiFi, so you will need a physical Ethernet connection. This can be done three ways:

  • Connect the PYNQ directly to your home router or switch (this is how it is setup in the lab).
  • Connect the PYNQ directly to the Ethernet port on your computer. This can be done if you aren’t using the Ethernet port for your computer’s internet connection, ie. you are using WiFi or have an extra ethernet port.
  • If you don’t have an extra Ethernet port on your computer, you can buy a USB-to-Ethernet adapter such as the one here. Make sure to buy one that is compatible with your computer.

Internet Sharing

If you used Option #1 above and connected the PYNQ directly to your home network, you can skip this section. Otherwise, if you connected the PYNQ to your computer, follow the steps in this section to share your internet connection with the PYNQ board.

Windows

  • Right-click network icon in System Tray and select Open Network & Internet settings
  • Click Ethernet or Wi-Fi in the left-hand menu (it doesn’t matter which you select).
  • Click Change adapter options in the right-hand menu.
  • The pop-up window lists all of your network adapters:
    • If you have a USB-to-Ethernet adapter, identify which adapter it is. You can unplug it and plug it back in to verify.
    • Next, find the adapter that your computer uses to connect to the internet. This may be the WiFi adapter if you use WiFi, or the Ethernet adapter if you use a physical Ethernet connection. Right-click on this adapter and open the Properties.
  • In the adapter pop-up window, click the Sharing tab. Check the box for Allow other network users to connect through this computer’s Internet connection.
  • Use the Home Networking connection drop-box box to select the USB-to-Ethernet adapter that you identified in the earlier step. Click OK and close the Windows.

Mac

https://support.apple.com/en-ca/guide/mac-help/mchlp1540/mac

Ubuntu Linux

Find the PYNQ IP Address

Next you will need to determine what IP address your PYNQ board was given. Make sure you insert the imaged SD card into your PYNQ board and power it on before proceeding.

If you use option 1 or 2 below, keep in mind that as you look for the PYNQ IP address, the PYNQ boards tend to have MAC addresses that start with 00:05:6b:.

Option 1: Retrieve from router. You can only use this technique if you used option #1 above, and your PYNQ is connected directly to your home router or switch

Your PYNQ should be given an IP address on your home network. This is likely something like 192.168.x.x and you may be able to find it using the DHCP list on your router’s configuration webpage, or if you have a newer router, such as a Netgear Orbi or Google Nest, you can use the appropriate mobile app to view devices on your home network and get the IP address.

Option 2: Use ARP.

ARP (Address Resolution Protocol) allows you to view IP addresses and MAC addresses of computers on your network.

In Windows, Linux, or Mac, you should be able to run arp -a in the terminal to view a list of IP/MAC pairs. They are usually grouped by network device, so if you have the PYNQ connected to your computer via USB-to-Ethernet adapter, the PYNQ should be in it’s own category.

Option 3: Connect to the PYNQ board using UART

The PYNQ Serial page describes how to get a command prompt on the PYNQ board using the USB connection. From there you can run ifconfig to view the network adapters on the PYNQ board and their IP addresses. The Ethernet adapter on the PYNQ is named eth0 (ignore the eth0:1 entry).