PYNQ remote HelloWorld [RFSoC4x2]

Riley_P · February 3, 2026, 9:29pm

Hello,
I am still working on getting pynq.remote to work with the RFSoC4x2 and have a few questions. I was able to prepare the boot device and log into the board with the default settings. I am now at step 3: installing and running PYNQ-HelloWorld. I am unsure where to find the correct files so that it runs properly on the RFSoC4x2.

I can set the board to RFSoC4x2 but cannot download the notebooks and overlay files. From what I know about working with this board, I figure using the ZCU104 files will mess something up.
I run:

BOARD=RFSoC4x2 pip install --no-build-isolation pynq-helloworld
pynq get-notebooks pynq-helloworld -d RFSoC4x2

but get issues with the get-notebooks command stating it cannot find the proper notebooks. I have tried moving the RFSoC4x2 board files from the RFSoC-PYNQ repository into the PYNQ repository but it seems like the notebooks do not exist.

Is it okay to build it with the ZCU104 board command and expect it to work properly? If not, what are the next best steps?

Thank you!

joshgoldsmith · February 9, 2026, 11:52am

Hi @Riley_P

Glad to hear you got the 4x2 remote image working.

The PYNQ-HelloWorld repo doesn’t natively support the RFSoc4x2 board directly (you can see all supported board here). That means you’ll need to build the Vivado design for the 4x2 board yourself.

The best one to work from is the ZCU104 design as it’s a ZU+ architecture (same as the RFSoC).

You’ll need to update the tcl file in boards/ZCU104/resizer/resizer.tcl to change the Vivado version and device/board part to match the RFSoC4x2.

github.com/Xilinx/PYNQ-HelloWorld

boards/ZCU104/resizer/resizer.tcl

9728edf2e


      
             set script_folder [file dirname $script_path]
             return $script_folder
          }
          }
          variable script_folder
          set script_folder [_tcl::get_script_folder]
          
          ################################################################
          # Check if script is running in correct Vivado version.
          ################################################################
          set scripts_vivado_version 2020.2
          set current_vivado_version [version -short]
          
          if { [string first $scripts_vivado_version $current_vivado_version] == -1 } {
             puts ""
             catch {common::send_msg_id "BD_TCL-109" "ERROR" "This script was generated using Vivado <$scripts_vivado_version> and is being run in <$current_vivado_version> of Vivado. Please run the script in Vivado <$scripts_vivado_version> then open the design in Vivado <$current_vivado_version>. Upgrade the design by running \"Tools => Report => Report IP Status...\", then run write_bd_tcl to create an updated script."}
          
             return 1
          }
          
          ################################################################

github.com/Xilinx/PYNQ-HelloWorld

boards/ZCU104/resizer/resizer.tcl

9728edf2e


      
          create_project resizer resizer -part xczu7ev-ffvc1156-2-e
          set_property BOARD_PART xilinx.com:zcu104:part0:1.1 [current_project]

Then you should be able to run the Makefile to build the bitstream (or you can just run the tcl file directly in Vivado)

Once you have the bitstream/XSA file, you can use the notebooks in pynq_helloworld/notebooks/edge (you’ll need to point Overlay() to the correct filepath of your ovelray file)

Once we have full remote support for RFSoC, there will be natively supported overlays available. For now, it’s a bit of a manual job unfortunately.

Topic		Replies	Views
PYNQ.remote tutorials for RFSoC4x2 Support	0	46	January 23, 2026
RFSoC 4x2 PYNQ remote Build Support	3	48	February 20, 2026
RFSoC4x2 PYNQ.remote issue Support	3	78	January 25, 2026
Building pynq.remote image checkenv error [RFSoC 4x2] Support	4	93	January 16, 2026
RFSoC PYNQ on custom boards Support	17	221	May 27, 2025

PYNQ remote HelloWorld [RFSoC4x2]

Related topics