Build PYNQ SD Image for Pynq-ZU

Prerequisites

Required tools:

• Ubuntu 22.04 LTS 64-bit host PC
• Passwordless SUDO privilege for the building user
• Roughly 35GB of free space (build process only, not accounting for Xilinx tools)
• At least 8GB of RAM (more is better)
• AMD PetaLinux 2024.1 and Vivado 2024.1

You can find the instructions to setup the environment here https://pynq.readthedocs.io/en/latest/pynq_sd_card.html#prepare-the-building-environment

Retrieve the Pynq-ZU board git into a NEW directory.

git clone https://github.com/Xilinx/PYNQ-ZU.git <LOCAL_PYNQ-ZU_REPO>
cd <LOCAL_PYNQ-ZU_REPO> && git submodule init && git submodule update

Build SD Image

PYNQ is a submodule and it points to the corresponding branch.

Configure and install build tools, this will take some effort and will be an iterative process. Install on your own any missing tools.

Inside the <LOCAL_PYNQ-ZU_REPO>/ execute

cd pynq/sdbuild
make checkenv

In the root directory (<LOCAL_PYNQ-ZU_REPO>/) run make.

make 2>&1 | tee build.log

Once the build has completed, if successful a SD card image will be available under the directory <LOCAL_PYNQ-ZU_REPO>/sdbuild/output/Pynq-ZU-3.1.1.img.

Use Etcher or Win32DiskImager to write this image to an SD card.

---

Copyright© 202-2025 Advanced Micro Devices