/rfsoc_qpsk

Primary LanguageVHDLBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

RFSoC QPSK Transceiver

Introduction

This repo contains all the files needed to build and run the RFSoC QPSK demonstrator that 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.

Quick Start

This repository is only compatible with PYNQ images v2.4 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 and run:

pip3 install --upgrade git+https://github.com/strath-sdr/rfsoc_qpsk.git

Note: If using PYNQ image v2.5, include --no-dependencies as this image already has all the neccessary packages.

The notebook should now be available in the rfsoc_qpsk/ folder. Use Chrome if possible — the rendering performance is important.

ZCU111 Setup

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).

Using the Project Files

All software builds have been tested on Ubuntu 16.04

Requirements

  • Vivado Design Suite 2018.3
  • System Generator for DSP
  • MATLAB 2017b

System Generator

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!

Vivado

This project can be built with Vivado from the command line:

cd rfsoc_qpsk/boards/ZCU111/
source <Xilinx_dir>/Vivado/2018.3/settings64.sh
vivado -mode batch -nojournal -nolog -source write_project.tcl

License

BSD 3-Clause