nandortoth/rtlsdr-manager

.NET Core library to manage RTL-SDR devices

RTL-SDR Manager Library for .NET Core

Installation

RTL-SDR Manager Library is available via NuGet package manager. You can easily install it via the usual ways.

# dotnet CLI
dotnet add package RtlSdrManager

# nuget CLI
nuget install RtlSdrManager

Usage

Handling RTL-SDR device:

// Initialize the Manager instance.
var manager = RtlSdrDeviceManager.Instance;

// Open a managed device and set some parameters.
manager.OpenManagedDevice(0, "my-rtl-sdr");
manager["my-rtl-sdr"].CenterFrequency = new Frequency {MHz = 1090};
manager["my-rtl-sdr"].SampleRate = new Frequency {MHz = 2};
manager["my-rtl-sdr"].TunerGainMode = TunerGainModes.AGC;
manager["my-rtl-sdr"].AGCMode = AGCModes.Enabled;
manager["my-rtl-sdr"].MaxAsyncBufferSize = 512 * 1024;
manager["my-rtl-sdr"].DropSamplesOnFullBuffer = true;
manager["my-rtl-sdr"].ResetDeviceBuffer();

Asynchronous sample reading from the device:

// Start asynchronous sample reading.
manager["my-rtl-sdr"].StartReadSamplesAsync();

Read samples from the buffer:

// Dequeue from the buffer.
if (!manager["my-rtl-sdr"].AsyncBuffer.TryDequeue(out var data))
{
    Thread.Sleep(100);
    continue;
}

// Use the sample
Console.WriteLine(data);

Using KerberosSDR related functions:

// Enable KerberosSDR mode.
manager["my-rtl-sdr"].KerberosSDRMode = KerberosSDRModes.Enabled;

// Using frequency dithering and configuring GPIO directly.
manager["my-rtl-sdr"].FrequencyDitheringMode = FrequencyDitheringModes.Enabled;
manager["my-rtl-sdr"].SetGPIO(1, GPIOModes.Enabled);

Release Notes

v0.2.1 - January 10, 2020

• Implement KerberosSDR related features (frequency dithering, direct GPIO control)
• Implement Bias Tee settings
• Minor fixes in the documentation

v0.2.0 - June 10, 2018

• Bugfix in DeviceInfo handling
• Implement singleton pattern for RtlSdrDeviceManager

v0.1.3 - June 9, 2018

• First public NuGet package

v0.1.2 - June 3, 2018

• Handling crystal frequencies (RTL2832, IC)
• Support tuner bandwidth selection (Automatic, Manual)
• Support direct sampling (I-ADC, Q-ADC)
• Support offset tuning mode for zero-IF tuners

v0.1.1 - May 12, 2018

• First public release of the RTL-SDR Manager
• Supports most of the imporant functions of RTL-SDR device

rtlsdr-manager's Issues

SamplesAvailable Never Called

I'm trying to get a basic WPF reading samples from my RTL dongle. The app connects to the radio fine, but my assigned SamplesAvailable function never fires after I start async sample reading.

The relevant code (taken almost verbatim from the Demo1.cs example)

Debug.WriteLine("Initializing radio");

// Create & connect to the device
rtlManager.OpenManagedDevice(Convert.ToUInt16(fRadioList.SelectedIndex), rtlName);

// Set samplerate
rtlManager[rtlName].SampleRate = new Frequency { Hz = rfSampleRate };

// Set frequency
rtlManager[rtlName].CenterFrequency = new Frequency { Hz = 151700000 };

// Set Buffer
rtlManager[rtlName].MaxAsyncBufferSize = 512 * 1024;
rtlManager[rtlName].DropSamplesOnFullBuffer = true;
rtlManager[rtlName].ResetDeviceBuffer();

// Set gain mode
rtlManager[rtlName].TunerGainMode = TunerGainModes.Manual;

// Set gain
Debug.WriteLine(String.Format("Setting initial RTL gain to {0} dB", rtlManager[rtlName].SupportedTunerGains[fRadioGain.SelectedIndex]));
rtlManager[rtlName].TunerGain = rtlManager[rtlName].SupportedTunerGains[fRadioGain.SelectedIndex];

// Start
Debug.WriteLine("Connecting to RTL device: " + fRadioList.Text);
rtlManager[rtlName].StartReadSamplesAsync(16384);

// Assign sample callback
rtlManager[rtlName].SamplesAvailable += (sender, args) =>
{
    sampleCallback(rtlManager[rtlName].GetSamplesFromAsyncBuffer(args.SampleCount), args.SampleCount);
    Debug.WriteLine($"{args.SampleCount} samples recieved");
};

My sampleCallback function is never called, and the debug print inside the SamplesAvailable function also never prints. However the app runs fine with no errors or exceptions so I'm led to believe the callback just isn't being called for some reason.

Unable to load DLL 'librtlsdr' or one of its dependencies: The specified module could not be found. (0x8007007E)

Hi, i'm trying to use the RtlSdrManager from nuget and from the demo in VS2019 and 2022, in a .net CORE 3.1 console app, but when is called any function from the manager, it throws the following exception:
"Unable to load DLL 'librtlsdr' or one of its dependencies: The specified module could not be found. (0x8007007E)"