rfsoapyfile
A Python 3 script for capturing and recording a SDR stream to a WAV file (or serving it to a HTTP audio stream). The script is threaded for high performance, especially on a Raspberry Pi. The script includes a REST API for controlling the capture and WAV recording remotely.
The script will save the stream in either RF64 or WAV file format. By default the recording uses the WAV format. The SDR specific 'auxi' metadata chunk is added to the file as well.
Dependencies
The script requires the numpy and SoapySDR Python libraries.
Example
$ python soapyfile.py -f 100.1e6 -r 1e6 --pcm16 -g 42 --output out --pause
Usage
$ soapyfile.py --help
usage: soapyfile.py [-h] [-l] [-d DEVICE] [-f FREQUENCY] [-r RATE] [-g GAIN]
[-a] [--iq-swap] [--biastee] [--digital-agc]
[--offset-tune] [--direct-samp DIRECT_SAMP] [--pcm16]
[--rf64] [--notimestamp] [--pause] [--output OUTPUT]
[--packet-size PACKET_SIZE] [--buffer-size BUFFER_SIZE]
[--hostname HOSTNAME] [--port PORT] [--refresh REFRESH]
[--quiet]
optional arguments:
-h, --help show this help message and exit
-l, --list list devices (default: False)
-d DEVICE, --device DEVICE
device name (default: None)
-f FREQUENCY, --frequency FREQUENCY
center frequency (Hz) (default: None)
-r RATE, --rate RATE sampling rate (Hz) (default: None)
-g GAIN, --gain GAIN front end gain (dB) (default: None)
-a, --agc enable AGC (default: False)
--iq-swap swap IQ signals (default: False)
--biastee enable bias tee (default: False)
--digital-agc enable digital AGC (default: False)
--offset-tune enable offset tune (default: False)
--direct-samp DIRECT_SAMP
select I or Q channel: 1 or 2 (default: None)
--pcm16 write 16-bit PCM samples (default: False)
--rf64 write RF64 file (default: False)
--notimestamp do not add timestamp to filename (default: False)
--pause pause recording (default: False)
--output OUTPUT output file name (default: output)
--packet-size PACKET_SIZE
packet size (default: 1024)
--buffer-size BUFFER_SIZE
buffer size in MB (default: 256)
--hostname HOSTNAME REST server hostname (default: 0.0.0.0)
--port PORT REST server port number (default: 8080)
--refresh REFRESH peak meter refresh (sec) (default: 2)
--quiet do not print peak values (default: False)
REST API
The REST API is available off port 8080. Use POST or PUT to change a program or radio setting. Use GET to view it. If a boolean is needed, the following strings are accepted: y, n, yes, no, true, and false.
PUT /quit
stop recording and terminate program, yes or no
PUT /rate
set sampling rate (Hz) but only if recording is paused
PUT /frequency
set center frequency (Hz)
PUT /gain
set gain (dB)
PUT /agc
enable agc, yes or no PUT /pause
pause recording, yes or no PUT /setting/
change named soapy setting GET /rate return sampling rate (Hz) GET /frequency return center frequency (Hz) GET /gain return gain (Hz) GET /agc return AGC setting (yes or no) GET /pause return whether the recording is paused (yes or no) GET /setting return list of available soapy setting names GET /setting/
return value of named soapy setting GET /s16 return 16-bit integer PCM WAV HTTP audio stream GET /f32 return 32-bit floating point PCM WAV HTTP audio stream
2 Jan 24, 2022
17 Nov 17, 2022
6 Nov 19, 2022
364 Oct 31, 2022
52 Dec 29, 2022
1 Oct 27, 2021
1.3k Dec 31, 2022
1 Nov 21, 2021
2 Jan 20, 2022
64 Dec 31, 2022
178 Dec 09, 2022
2 Dec 15, 2021
2 Dec 20, 2022
482 Dec 19, 2022
921 Jan 05, 2023
56 Dec 27, 2022
51 Dec 17, 2022
600 Dec 29, 2022
72 Dec 23, 2022