This repo contains all the files needed to build and run the RFSoC QPSK demonstrator that was published in IEEE Access and was presented at both FPL and XDF conferences in 2018. The design is a full QPSK transceiver, which transmits and receives randomly-generated pulse-shaped symbols with full carrier and timing synchronisation. PYNQ is used to visualise the data at both the DAC and ADC side of the RFSoC data converters, as well as visualising various DSP stages throughout the transmit and receive signal path.
This repository is only compatible with PYNQ images v2.5 and greater for ZCU111.
Connect to the board with Jupyter Lab in a browser (not Jupyter Notebook) @ http://<IP address>/lab.
Open a terminal in Jupyter Lab. If you are using PYNQ v2.6, run the following command:
pip3 install git+https://github.com/strath-sdr/rfsoc_qpsk --no-depsIf you are using PYNQ v2.5, simply specify the target branch as shown in the command below:
pip3 install git+https://github.com/strath-sdr/rfsoc_qpsk@pynq_v2.5.0 --no-depsThe notebook should now be available in the rfsoc_qpsk/ folder.
Use Chrome if possible — the rendering performance is important.
We use DAC2 from tile 229 to transmit and ADC0 from tile 224 to receive. These correspond to connections J5 and J4 on the HW-FMC-XM500 daughter board respectively. SW6 on the ZCU111 must be set to boot from SD card (as shown in the image below).
All software builds have been tested on Microsoft Windows 10.
- Vivado Design Suite 2020.1
- System Generator for DSP
- MATLAB 2020a
The Tx and Rx IPs are in separate directories in rfsoc_qpsk/boards/sysgen/ that can be opened using the appropriate System Generator dialogue. Due to the large amount of decimation and interpolation in both IPs, simulating the output can take an extraordinarily long time. A less extreme multirate system would simulate much faster!
This project can be built with Vivado from the command line:
cd rfsoc_qpsk/boards/ZCU111/
vivado -mode batch -nojournal -nolog -source write_project.tcl