Pynq-z2 PYNQ remote image build error

Support
1

Escalation Report
Date: September 18, 2025

Title: pynqremote Build Failure for PYNQ-Z2 on PYNQ v3.1 Due to XRT Incompatibility

  1. PYNQ Version
    PYNQ OS: 3.1

  2. Target Board
    PYNQ-Z2 (Machine Type: zynq-generic-7z020)

  3. Detailed Error Description
    When attempting to build a pynqremote image for the PYNQ-Z2 board using the PYNQ v3.1 sdbuild environment, the build fails with a fatal dependency error related to the Xilinx Runtime (XRT) during the Petalinux image creation stage.

The core of the issue is that the build system requires XRT, but the XRT recipe explicitly marks itself as incompatible with the Zynq-7000 series SoC (zynq-generic-7z020).

Key Error Log:

Code snippet

ERROR: Nothing RPROVIDES ‘xrt’
(but /workspace/sdbuild/build/Pynq-Z2/petalinux_project/components/yocto/layers/meta-petalinux/recipes-core/images/petalinux-image-minimal.bb RDEPENDS on or otherwise requires it)

xrt was skipped: incompatible with machine zynq-generic-7z020 (not in COMPATIBLE_MACHINE)

NOTE: Runtime target ‘xrt’ is unbuildable, removing…
Missing or unbuildable dependency chain was: [‘xrt’]

ERROR: Required build target ‘petalinux-image-minimal’ has no buildable providers.
Missing or unbuildable dependency chain was: [‘petalinux-image-minimal’, ‘xrt’]

Summary: There were 2 ERROR messages, returning a non-zero exit code.
[ERROR] Command bitbake petalinux-image-minimal -c do_image_complete failed
make: *** [Makefile:428: /workspace/sdbuild/build/Pynq-Z2.remote_rootfs.tar.gz] Error 255
4. Steps to Reproduce
Set up the PYNQ v3.1 sdbuild Docker environment as per the official documentation.

Navigate to the sdbuild directory within the container.

Execute the following command:

Bash

make pynqremote BOARDS=Pynq-Z2
The build process will fail with the errors listed above.

  1. Action Requested
    We request an investigation into whether there is a viable method to support pynqremote builds for Zynq-7000 based boards in PYNQ v3.1.

Specifically, we are seeking guidance on:

Is there a recommended workaround or patch to resolve this XRT dependency conflict for the PYNQ-Z2?

Can the build recipes be modified to use a compatible version of XRT, or to make the XRT dependency optional for platforms where it is not supported?

2

Hi @boxstar

Currently, only Zynq UltraScale+ platforms are compatible with PYNQ.remote.

1 Like