In this post we’re going to setup a virtual machine with the tools for building PYNQ and we are going to build PYNQ release v2.6 (tool version 2020.1) for the Ultra96 board. We’re going to start with the virtual machine that we setup in the previous post How to Install PetaLinux 2020.1. That VM has Vitis 2020.1 and PetaLinux 2020.1 installed, both of which we will need to build PYNQ. If you want to avoid issues along the way, I highly recommend that you follow that post and recreate the same VM with exactly the same tool versions and OS.
Step 1: Setup passwordless sudo privilege for your username
In a terminal on your VM, follow these steps to enable passwordless sudo privilege for your user.
- Edit the sudoers file with nano by running this command in the terminal:
sudo nano /etc/sudoers
- At the end of the file, add this new line:
jeff ALL=(ALL) NOPASSWD: ALL(replace
jeffwith your user name).
- Press Ctrl-O to save the changes, accept the filename then Ctrl-X to exit nano.
Step 2: Download an eval license for the HDMI IP core
We’re going to get a license that is node-locked to our VM, so we’re going to start by getting the right information to identify our host (the VM).
- Run Vivado License Manager 2020.1 on the VM by clicking on “Activities” and then searching with the keyword “license”.
- Click on “View Host Information”.
- The License Manager will show you the information that you can use to identify the VM when
requesting a node-locked host. Write down the values of these two items:
- Host name - for example, mine is
ubuntu18044, I specified this when creating the VM)
- Network Interface Card (NIC) ID - a 12 digit hexadecimal number corresponding to the MAC
address of the VM’s Ethernet interface (eg.
- Host name - for example, mine is
- On the VM, open Firefox and visit the Xilinx Product Licensing Site. You will have to log in using your Xilinx account details.
- On the Product Licensing page, on the “Create New Licenses” tab, click “Search Now” to search for the HDMI IP evaluation license. Type “HDMI” as the search term and click on the “LogiCORE, HDMI, Evaluation License”.
- The HDMI IP license will be added to the list of “Certificate Based Licenses” and it will already be ticked.
- If you also need an evaluation license for the Vitis tools, tick off “Vivado Design Suite: 30-day Evaluation License” to add it to the license.
- Click “Generate Node-Locked License”, this allows you to create a license file containing all of the licenses that you ticked above.
- Under “System Information”, click on the Host ID dropdown and select “Add a host”. Enter the host information that you got earlier from the Vivado License Manager (ie. host name and NIC ID).
- Click “Next”. Review your license choices, it should contain the licenses that you ticked off, and the host information you entered. Click “Next” if everything is as you expected.
- Read and accept the license agreement, click “Accept”.
A license file called
Xilinx.lic will be emailed to you. Open your email on the VM, and copy
the license file into the
~/.Xilinx directory on the VM. As this is a node-locked license, you
can only use it on this VM.
Step 3: Clone and setup the Ultra96 PYNQ repository
- We’ll keep all of our PYNQ related stuff inside a directory in home called
~/pynq. Create this directory and clone the Ultra96 PYNQ Git repository into it with these commands:
git clone https://github.com/Avnet/Ultra96-PYNQ.git
git checkout -b image_v2.6.0 origin/image_v2.6.0
- In Firefox, open the list of Ultra96 PYNQ Releases, scroll down to the v2.6 release and then from the list of assets, download the Ultra96 BSP for the board version that is appropriate for you (v1 or v2). I’ll download the BSP for the Ultra96 v2 because that’s the board that I want to build PYNQ for.
ultra96v2_bsp.zipfile should end up in the
~/Downloadsdirectory. In the terminal window type the following command to extract the contents of the file into the
unzip ~/Downloads/ultra96v2_bsp.zip -d ~/Downloads
- The table below shows the files that you just extracted into
~/Downloads/ultra96v2and where they now need to be copied:
|Where to put it
Use the following commands to copy each of the extracted files to where they need to go:
cp ~/Downloads/ultra96v2/sensors96b_v2.bsp ~/pynq/Ultra96-PYNQ/Ultra96/.
cp ~/Downloads/ultra96v2/sensors96b.bit ~/pynq/Ultra96-PYNQ/Ultra96/sensors96b/.
cp ~/Downloads/ultra96v2/sensors96b.hwh ~/pynq/Ultra96-PYNQ/Ultra96/sensors96b/.
- Setup the soft links that ensure that the PYNQ build scripts refer to the board spec and BSP for the version of the Ultra96 that you are using (v1 or v2). Run the following commands:
ln -s specs/Ultra96_v2.spec Ultra96.spec
ln -s petalinux_bsp_v2 petalinux_bsp
Note that if you are using the Ultra96v1, then you need to replace the
_v1 in the
Step 4: Clone the PYNQ repository and setup the build environment
- Clone the PYNQ repository into the
git clone https://github.com/Xilinx/PYNQ.git
git checkout origin/image_v2.6.0
- The PYNQ repository contains a script that installs all of the PYNQ dependencies. Run the script with these commands:
- Reboot the VM. If you don’t reboot at this point, you will end up with an error in the steps below due to QEMU and CrossTool not being on the path.
- Source the setting scripts for Vitis and PetaLinux 2020.1. Note that the location of the settings files will depend on where you installed Vitis and PetaLinux, so you may need to change the paths before running the commands below:
- Turn PetaLinux WebTalk OFF:
petalinux-util --webtalk off
- When the script completes successfully, run the following command to make sure that all of the dependencies are installed. If it outputs a list of packages and NO error messages, then it’s a success.
Step 5: Build the PYNQ image for Ultra96
You should expect the build process to last for several hours. One reason why it takes so long is that by default it will build the PYNQ images for three extra boards: PYNQ-Z1, PYNQ-Z2 and ZCU104. According to this forum post, we have to build PYNQ for the PYNQ-Z2 but we can remove the other two boards from the repository to save on build time:
git rmto remove the PYNQ-Z1 and ZCU104 board files, and then locally commit the changes. Note that we need to locally commit the changes, because the build process uses the most recent git commit and ignores any uncommited changes to the repository.
git config --global user.email "[email protected]"
git rm -r Pynq-Z1
git rm -r ZCU104
git commit -m "removed board files for pynq-z1 and zcu104"
maketo launch the build. The build script expects you to pass a variable called
BOARDDIRwhose value is the path to the board files for which you want to build PYNQ. In our case, this path must be set to the location of our Ultra96 PYNQ repository:
~/pynq/Ultra96-PYNQ. Run the following commands to launch the build:
Step 6: Write PYNQ image to SD card
If the build completes successfully, you will find an SD card image here:
- Insert a blank SD card into a USB card reader that your VM can access
- Find the SD card’s device name by running the
dmesgcommand in the terminal. The SD card should be found at the end of the log, and it’s device name should be something like
Xis a letter such as a,b,c,d, etc. In the following commands, I will assume that the SD card is
/dev/sdX, but you will need to replace the
Xwith the right letter for your SD card.
- Use the following command to write the PYNQ image to the SD card:
sudo dd if=~/pynq/PYNQ/sdbuild/output/Ultra96-2.6.img of=/dev/sdX status=progress bs=4M
When you run the above command, you must be absolutely certain that you are using the correct
device name for the SD card. If you don’t use the correct device name, you risk writing over
something else - such as your main hard drive. If you’re not sure, try running
before and after plugging in the SD card, and watch for the change.
Time to boot PYNQ!
Now all that is left to do is to plug the SD card into the Ultra96 and power it up. We’ll go through how to use PYNQ for Ultra96 in a future post, but for now you can read about it in the documentation.