This module contains blocks to read from and write to SigMF (the Signal Metadata Format) recordings in GNU Radio.
Currently gr-sigmf is best described as alpha software. Basic interactions work, but features are not complete and the API should be considered somewhat unstable. We welcome any feature requests or bug reports. Pull requests are fine too, but will be met with more success if you make an issue first.
Data correctness issues will be prioritized over reliability issues, which will in turn be prioritized over new feature development.
Note that gr-sigmf does not yet target version 1.0 of the SigMF
specification. Once a SigMF 1.0 spec is finalized, this OOT module will be
updated soon after.
Dependencies required:
- GNU Radio
- RapidJSON
- Swig (for Python support)
- UHD (for USRP recording and playback tools)
To install dependencies on Ubuntu 18.04 LTS:
$ sudo apt install rapidjson-dev swig gnuradio libuhd-dev
To install from source:
$ git clone [email protected]:skysafe/gr-sigmf.git
$ cd gr-sigmf
$ mkdir build; cd build
$ cmake ..
$ make
$ sudo make install
To make a SigMF recording using an Ettus Research USRP:
$ sigmf-record --sample-rate 10e6 --freq 88.5e6 --gain 30 example.sigmf
Note that the gr-sigmf Python module is named gr_sigmf to avoid conflicts with the
official GNURadio sigmf module. This is
different from the typical GNU Radio OOT module convention, where the Python
module would simply be named sigmf.
- Correctly and completely implement the SigMF Specification.
- Be a "good GNU Radio citizen", and interact in useful ways with the existing
core blocks, existing OOT blocks, and hardware interfaces such as
gr-uhd.
-
A set of blocks for reading and writing SigMF datasets
- sink: Create SigMF datasets
- source: Read SigMF datasets
- annotation_sink: Write SigMF metadata only
- usrp_gps_message_source: Surface gps metadata from a usrp as messages so it can easily be used by a SigMF sink.
-
A set of command line tools for creating/working with SigMF datasets. They include:
- sigmf-record: Create SigMF datasets from NI/Ettus radios
- sigmf-play: Replay SigMF datasets to NI/Ettus radios
- sigmf-archive: Convert SigMF datasets to and from archive files
- sigmf-crop: Extract subsections from SigMF datasets
- sigmf-hash: Verify and calculate hashes for SigMF datasets
- Output metadata via message (for support in applications like 'such samples')
- Make sure that UHD generates/reads stream tags that are nicely handled by SigMF blocks.
- Make waterfall, frequency, and time sinks interact well with stream tags as translated from metadata.
- Build stream tag converter block to convert uhd stream tags to tags with keys that match sigmf keys
- Dynamic control over recording state via message
- Tar archive support
- Multi-channel recording support, if it is introduced into the main spec
- Automatic file rotation?