pi-packetizer
is a server program for packetizing data on Raspberry Pi peripheral interfaces into the Metis format, which itself is based on the HPSDR USB data protocol. Currently, it supports a single receiver on the I2S interface. The goal is to use the Raspberry Pi in conjunction with a FPGA-based software-defined radio (SDR) front-end, similar to the Radioberry, but with more flexible interchip communication interfaces, and custom SDR gateware.
Future plans for the packetizer include:
- Adding transmit support on I2S
- Supporting multiple receivers via SPI
This work is largely based on Pavel Demin’s HPSDR implementations for the Red Pitaya.
There are a few other utilities bundled with ~pi-packetizer.
cmod-server
allows the Raspberry Pi to control the Cmod SDR. It facilitates this control by acting as both a CAT command server, and a sound server listening for tones to transmit. cmod-server
’s responsibilities are to:
- Control the Si5351 PLL chip over I2C, in response to CAT commands as well as the frequency of the tones (if in transmit mode);
- Change the frequency of the DDS in the Cmod over SPI;
- Use CAT to control the transmit/receive state of the radio and corresponding behaviour of the Si5351 chip; and
- Emulate the required CAT command functionality of an FT-891 radio so that a minimum set of supported CAT commands is implemented to support functioning of programs such as WSJT-X.
CAT commands are usually sent by client programs (such as WSJT-X) via a virtual serial device (pseudo terminal), though it is possible for the server to listen on an actual serial port if desired. The settings are 115200 bps, 8N1, no flow control. If using a pseudo terminal (pty), a shell script setup-serial.sh
is provided that uses socat
to create ptys; one of these can be used for cmod-server
.
The sound sound server listens on an ALSA audio device for frequency tones. When the Cmod SDR is in transmit mode, it determines the frequency of the tones, and adjusts the frequency of the Si5351 chip, which is intended to be used as the (FSK) source. The ALSA device can be physical or virtual, but cmod-server
is intended to be used with a virtual (loopback) sound device so that client programs can output the message signal to the loopback device and cmod-server
will intercept this message signal for determining the frequency to transmit. For this purpose, the ALSA snd-aloop
kernel module should be used and is expected to be loaded.
cmod-server
is invoked as follows:
cmod-server <serial device> <ALSA device>
For example,
cmod-server /dev/pts/1 hw:2,1
will cause cmod-server
to listen for CAT commands on /dev/pts/1
and use the ALSA device hw:2,1
, where card 2 is assumed to be the loopback device. The cards available to ALSA can be found by running
cat /proc/asound/cards
If you need to change the default sound card, use
pactl list short sinks
pactl set-default-sink alsa_output.platform-snd_aloop.0.analog-stereo