RTL-SDR

An RTL-SDR library written in Rust!

What is RTL-SDR?

RTL-SDR is a family of low-cost (~$30) USB software-defined radio (SDR) receivers that can tune a wide range of frequencies which are then processed in software (thus the 'software' in SDR).

They can receive all kinds of signals such as FM radio (see the simple_fm example in this project), aircraft radio and position data (like what you see on adsb-exchange), weather satellite imagery, and more!

rtl-sdr.com has a great page with much more explanation.

Getting Started

You can run the example FM radio receiver with the following command on Mac:

cargo run --example simple_fm | play -r 32k -t raw -e s -b 16 -c 1 -V1 -

and similarly on Linux:

cargo run --example simple_fm | aplay -r 32k -f S16_LE

The example is thoroughly documented to clearly show how to use this library, and hopefully make the FM demodulation process understandable too!

Build Options

This library includes the RTL-SDR Blog modifications to the original Osmocom library as a feature. Enable it in cargo with the --features rtl_sdr_blog flag.

Contributing

Contributions to this project are welcome! Check out the Issues page to see what's on the roadmap that you could help with, or open a new Issue.

Acknowledgments

This library originated as a port of the Osmocom rtl-sdr library, with modifications from the RTL-SDR Blog fork.

A library for extracting #[no_mangle] pub extern "C" functions (https://docs.rust-embedded.org/book/interoperability/rust-with-c.html#no_mangle)

A library for extracting #[no_mangle] pub extern "C" functions In order to expose a function with C binary interface for interoperability with other p

0 Feb 17, 2022

Comments

Linux -> Kernel module unload required
Hi,

thank you for the exciting project.

I would just like to add that there are issues on Linux when the rtl* kernel modules are loaded. The kernel modules take over the RTL-SDR device so that the USB device can no longer be accessed.

The USB error is as follows:

thread 'main' panicked at 'Unable to open SDR device!: Usb(Busy)'

The module can be temporarily unloaded as follows:

sudo rmmod rtl2832_sdr sudo rmmod dvb_usb_rtl28xxu sudo rmmod rtl2832 sudo rmmod rtl8xxxu

Regards, Jiri
opened by ramtej 1
`RtlSdr` Integration Tests

Want to create integration tests for RtlSdr which validate the entire device state before/after operations, with expected values extracted from a real device using a modified version of the original Osmocom library.

This depends on Create In-Memory DeviceHandle to be able to run the library with an in-memory fake device instead of the real thing.

opened by ccostes 0
Create In-Memory DeviceHandle

Want to create a DeviceHandle implementation which uses an in-memory store for all device reads and writes instead of a real device. The goal is to use this for integration tests to verify the device state before and after some operation.
good first issue

opened by ccostes 0