Skip to content
Open-sourcing the PYNQ & RFSoC lab materials from WWSC 2019.
Jupyter Notebook Shell Makefile
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
notebooks Initial commit Jul 3, 2019
scripts Initial commit Jul 3, 2019
.gitignore Initial commit Jul 3, 2019
LICENSE Initial commit Jul 3, 2019
Makefile Initial commit Jul 3, 2019
README.md Add an FAQ to README (#1) Jul 11, 2019

README.md

PYNQ RFSoC Workshop

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

Getting started

These notebooks are already included in the ZCU111's v2.4.1 PYNQ image. The steps to get started with this image are:

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

  2. Refer to the PYNQ docs for steps to:

  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 2018.3 was used for all 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

You can’t perform that action at this time.