SDR receiver compatible with HPSDR

Introduction

This SDR receiver emulates two Hermes modules with eight receivers. It may be useful for projects that require sixteen receivers compatible with the programs that support the HPSDR/Metis communication protocol.

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

This application requires that the Zmod Digitizer is connected to the ZMOD A connector of the Eclypse Z7 board.

Hardware

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

HPSDR receiver

The I/Q data rate is configurable and four settings are available: 48, 96, 192, 384 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 script 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

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 Eclypse Z7 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).
In the SkimSrv directory, rename HermesIntf.dll to HermestIntf_XXXX.dll where XXXX are the last four digits of the MAC address of the Eclypse Z7 board.
Make a copy of the SkimSrv directory and rename the copy to SkimSrv2.
In the SkimSrv2 directory, rename SkimSrv.exe to SkimSrv2.exe and rename HermestIntf_XXXX.dll to HermestIntf_FFXX.dll.
Install Reverse Beacon Network Aggregator.
Start SkimSrv.exe and SkimSrv2.exe, configure frequencies and your call sign.
Start Reverse Beacon Network Aggregator.

Building from source

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/eclypse-z7-notes
cd eclypse-z7-notes

Building sdr_receiver_hpsdr.bit:

make NAME=sdr_receiver_hpsdr bit

Building SD card image zip file:

source helpers/build-all.sh