rtl-sdr-rs 0.3.2

RTL-SDR USB software defined radio library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at https://mozilla.org/MPL/2.0/.

//! Example demonstrating device enumeration and opening by serial number
//!
//! This example shows how to:
//! - List all available RTL-SDR devices
//! - Get device information (serial numbers, product names, etc.)
//! - Open a device by its serial number
//! - Open the first available device

use rtl_sdr_rs::RtlSdr;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    println!("RTL-SDR Device Enumeration Example");
    println!("===================================\n");

    // Get the number of devices
    let count = RtlSdr::get_device_count()?;
    println!("Found {} RTL-SDR device(s)\n", count);

    if count == 0 {
        println!("No RTL-SDR devices found. Please connect a device and try again.");
        return Ok(());
    }

    // List all devices with their information
    println!("Device List:");
    println!("-----------");
    let devices = RtlSdr::list_devices()?;
    for device in &devices {
        println!("Device #{}:", device.index);
        println!("  Manufacturer: {}", device.manufacturer);
        println!("  Product:      {}", device.product);
        println!("  Serial:       {}", device.serial);
        println!("  VID:PID:      {:04x}:{:04x}", device.vendor_id, device.product_id);
        println!();
    }

    // Example 1: Open the first available device
    println!("Example 1: Opening first available device...");
    match RtlSdr::open_first_available() {
        Ok(mut sdr) => {
            println!("✓ Successfully opened first device");
            println!("  Center Frequency: {} Hz", sdr.get_center_freq());
            println!("  Sample Rate:      {} Hz", sdr.get_sample_rate());
            sdr.close()?;
        }
        Err(e) => {
            println!("✗ Failed to open device: {}", e);
        }
    }
    println!();

    // Example 2: Open device by index
    println!("Example 2: Opening device by index 0...");
    match RtlSdr::open_with_index(0) {
        Ok(mut sdr) => {
            println!("✓ Successfully opened device at index 0");
            println!("  Center Frequency: {} Hz", sdr.get_center_freq());
            sdr.close()?;
        }
        Err(e) => {
            println!("✗ Failed to open device: {}", e);
        }
    }
    println!();

    // Example 3: Open device by serial number
    if !devices.is_empty() {
        let serial = &devices[0].serial;
        println!("Example 3: Opening device by serial number '{}'...", serial);
        match RtlSdr::open_with_serial(serial) {
            Ok(mut sdr) => {
                println!("✓ Successfully opened device with serial '{}'", serial);
                println!("  Center Frequency: {} Hz", sdr.get_center_freq());
                println!("  Sample Rate:      {} Hz", sdr.get_sample_rate());
                sdr.close()?;
            }
            Err(e) => {
                println!("✗ Failed to open device: {}", e);
            }
        }
        println!();
    }

    // Example 4: Get device information without opening
    println!("Example 4: Getting device info for index 0...");
    match RtlSdr::get_device_info(0) {
        Ok(info) => {
            println!("✓ Device information retrieved:");
            println!("  Serial: {}", info.serial);
            println!("  Product: {}", info.product);
        }
        Err(e) => {
            println!("✗ Failed to get device info: {}", e);
        }
    }
    println!();

    // Example 5: Get just the serial number
    println!("Example 5: Getting serial number for index 0...");
    match RtlSdr::get_device_serial(0) {
        Ok(serial) => {
            println!("✓ Serial number: {}", serial);
        }
        Err(e) => {
            println!("✗ Failed to get serial: {}", e);
        }
    }

    Ok(())
}