librtlsdr-rs 0.2.2

Pure-Rust port of librtlsdr — RTL2832U USB control + tuner drivers, no C library required.
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

//! EEPROM read/write.
//!
//! Ports `rtlsdr_read_eeprom` and `rtlsdr_write_eeprom`.

use crate::constants::EEPROM_ADDR;
use crate::error::RtlSdrError;
use crate::reg::Block;
use crate::usb;

use super::RtlSdrDevice;

impl RtlSdrDevice {
    /// Write data to the device EEPROM.
    ///
    /// Ports `rtlsdr_write_eeprom`.
    pub fn write_eeprom(&self, data: &[u8], offset: u8) -> Result<(), RtlSdrError> {
        if (data.len() + offset as usize) > 256 {
            return Err(RtlSdrError::InvalidParameter(
                "EEPROM write exceeds 256 bytes".to_string(),
            ));
        }

        for (i, &byte) in data.iter().enumerate() {
            let addr_byte = (i as u8).wrapping_add(offset);

            // Read current value first
            let cmd = [addr_byte];
            usb::write_array(&self.handle, Block::Iic, u16::from(EEPROM_ADDR), &cmd)?;
            let mut current = [0u8; 1];
            usb::read_array(
                &self.handle,
                Block::Iic,
                u16::from(EEPROM_ADDR),
                &mut current,
            )?;

            // Only write if different
            if current[0] == byte {
                continue;
            }

            let cmd = [addr_byte, byte];
            let r = usb::write_array(&self.handle, Block::Iic, u16::from(EEPROM_ADDR), &cmd)?;
            if r != cmd.len() {
                return Err(RtlSdrError::RegisterAccess {
                    block: Block::Iic,
                    address: u16::from(addr_byte),
                });
            }

            // Delay for EEPROM write cycle (5ms)
            std::thread::sleep(std::time::Duration::from_millis(5));
        }

        Ok(())
    }

    /// Read data from the device EEPROM.
    ///
    /// Ports `rtlsdr_read_eeprom`.
    pub fn read_eeprom(&self, data: &mut [u8], offset: u8) -> Result<(), RtlSdrError> {
        if (data.len() + offset as usize) > 256 {
            return Err(RtlSdrError::InvalidParameter(
                "EEPROM read exceeds 256 bytes".to_string(),
            ));
        }

        // Set read address
        usb::write_array(&self.handle, Block::Iic, u16::from(EEPROM_ADDR), &[offset])?;

        // Read bytes one at a time (matching C implementation)
        for byte in data.iter_mut() {
            let mut buf = [0u8; 1];
            usb::read_array(&self.handle, Block::Iic, u16::from(EEPROM_ADDR), &mut buf)?;
            *byte = buf[0];
        }

        Ok(())
    }
}