Crate rustradio

source ·
Expand description

This create provides a framework for running SDR (software defined radio) applications.

It’s heavily inspired by GNURadio, except of course written in Rust.

It currently has very few blocks, and is missing tags, and PDU messages.

In addition to the example applications in this crate, there’s also a sparslog project using this framework, that decodes IKEA Sparsnäs electricity meter RF signals.

§Architecture overview

A RustRadio application consists of blocks that are connected by unidirectional streams. Each block has zero or more input streams, and zero or more output streams.

The signal flows through the blocks from “sources” (blocks without any input streams) to “sinks” (blocks without any output streams.

These blocks and streams are called a “graph”, like the mathematical concept of graphs that have nodes and edges.

A block does something to its input(s), and passes the result to its output(s).

A typical graph will be something like:

  [ Raw radio source ]
      [ Filtering ]
      [ Resampling ]
     [ Demodulation ]
     [ Symbol Sync ]
[ Packet assembly and save ]

Or concretely, for sparslog:

     [ RtlSdrSource ]
  [ RtlSdrDecode to convert from ]
  [ own format to complex I/Q    ]
     [ FftFilter ]
      [ RationalResampler ]
      [ QuadratureDemod ]
  [ AddConst for frequency offset ]
   [ ZeroCrossing symbol sync ]
     [ Custom Sparsnäs decoder ]
     [ block in the binary,    ]
     [ not in the framework    ]


Here’s a simple example that creates a couple of blocks, connects them with streams, and runs the graph.

use rustradio::graph::Graph;
use rustradio::blocks::{AddConst, VectorSource, DebugSink};
use rustradio::Complex;
let src = Box::new(VectorSource::new(
        Complex::new(10.0, 0.0),
        Complex::new(-20.0, 0.0),
        Complex::new(100.0, -100.0),
let add = Box::new(AddConst::new(src.out(), Complex::new(1.1, 2.0)));
let sink = Box::new(DebugSink::new(add.out()));
let mut g = Graph::new();





  • Trivial trait for types that have .len().
  • A trait all sample types must implement.

Type Aliases§

  • Complex (I/Q) data.
  • Float type used. Usually f32, but not guaranteed.