SDR receiver for HPSDR

Introduction

This version of the Red Pitaya SDR receiver emulates a Hermes module with eight receivers. It may be useful for projects that require eight receivers compatible with the programs that support the HPSDR/Metis communication protocol.

The HPSDR/Metis communication protocol is described in the following documents:

Hardware

The FPGA configuration consists of eight identical digital down-converters (DDC). Their structure is shown in the following diagram:

The main problem in emulating the HPSDR hardware with Red Pitaya is that the Red Pitaya ADC sample rate is 125 MSPS and the HPSDR ADC sample rate is 122.88 MSPS.

To address this problem, this version contains a set of FIR filters for fractional sample rate conversion.

The resulting I/Q data rate is configurable and three settings are available: 48, 96, 192 kSPS.

The tunable frequency range covers from 0 Hz to 61.44 MHz.

The projects/sdr_receiver_hpsdr directory contains two Tcl files: block_design.tcl, rx.tcl. The code in these files instantiates, configures and interconnects all the needed IP cores.

The projects/sdr_receiver_hpsdr/filters directory contains the source code of the R scripts used to calculate the coefficients of the FIR filters.

The projects/sdr_receiver_hpsdr/server directory contains the source code of the UDP server (sdr-receiver-hpsdr.c) that receives control commands and transmits the I/Q data streams to the SDR programs.

Software

This SDR receiver should work with most of the programs that support the HPSDR/Metis communication protocol:

PowerSDR mRX PS that can be downloaded from this link
QUISK with the hermes/quisk_conf.py configuration file
CW Skimmer Server and RTTY Skimmer Server
ghpsdr3-alex client-server distributed system
openHPSDR Android Application that is described in more details at this link
Java desktop application based on openHPSDR Android Application
Spark SDR with support of audio and WSJT Digi modes.

Getting started

Download SD card image zip file (more details about the SD card image can be found at this link).
Copy the contents of the SD card image zip file to a micro SD card.
Optionally, to start the application automatically at boot time, copy its start.sh file from apps/sdr_receiver_hpsdr to the topmost directory on the SD card.
Install the micro SD card in the Red Pitaya board and connect the power.
Install and run one of the HPSDR programs.

Running CW Skimmer Server and Reverse Beacon Network Aggregator

Install CW Skimmer Server.
Copy HermesIntf.dll to the CW Skimmer Server program directory (C:\Program Files (x86)\Afreet\SkimSrv).
Install Reverse Beacon Network Aggregator.
Start CW Skimmer Server, configure frequencies and your call sign.
Start Reverse Beacon Network Aggregator.

Building from source

The installation of the development machine is described at this link.

The structure of the source code and of the development chain is described at this link.

Setting up the Vitis and Vivado environment:

source /opt/Xilinx/Vitis/2023.1/settings64.sh

Cloning the source code repository:

git clone https://github.com/pavel-demin/red-pitaya-notes
cd red-pitaya-notes

Building sdr_receiver_hpsdr.bit:

make NAME=sdr_receiver_hpsdr bit

Building SD card image zip file:

source helpers/build-all.sh