PYNQ RFSoC Workshop

A collection of designs and notebooks for the PYNQ & RFSoC workshop — part of the ZCU111's PYNQ image.

Getting started

On ZCU111 PYNQ SD card images, these notebooks are already included. The steps to get started with this image are:

1. Download the "ZCU111 PYNQ image" file from the PYNQ website.

2. Refer to the PYNQ docs for steps to:

   • burn the image to an SD card, and
   • configure your network interface

3. Navigate to http://<IP address>/lab for the new JupterLab interface. We use features that aren't in the default interface.

4. Attach a SMA loopback cable between the DAC/ADC pair as shown below.

Now you're ready to use the notebooks in the rfsoc_workshop folder, as highlighted below:

Building from source

This step is optional. Only continue if you want to build your own image.

You can recreate this workshop manually if, for example, you want to use it on a different PYNQ image. Clone this repo and manually install the constituent RFSoC overlays:

1. RFSOC-QPSK
2. SDFEC-PYNQ
3. DSP-PYNQ

Run make install to deploy the workshop notebooks to the rfsoc_workshop folder.

Hosting a lab session

Note that there is a make install target that will replace the notebooks with the original copies. Use this to do a soft reset between groups.

FAQ

• Q: Which RFSoC boards are supported?

  • Currently the ZCU111 is the only officially supported board

• Q: Can I run these notebooks on my custom RFSoC board?

  • You can build a PYNQ image for a custom board by following these steps. You will also likely need to rebuild the Overlays used in this lab — for support please raise an issue on the relevant repo (Data Converter, SD-FEC, or DSP)

• Q: Where can I get general support?

  • There is a public forum for PYNQ at https://discuss.pynq.io/, where you can ask (or respond to) questions about this lab and more

• Q: Which version of Vivado was used to build these Overlays?

  • Vivado 2020.1 was used for the latest build of Overlays

• Q: There is erroneous or zero data on the receive path in the "PYNQ & Data Converter" notebook

  • Check that the SMA cable is connected to the correct ports on the daughtercard (as shown in this README)

• Q: The plots do not appear in the "PYNQ & Data Converter" notebook

  • Check that you are using the Jupyter Lab interface. Try navigating to http://<IP address>/lab

License

BSD 3-Clause