Struct FeDevice

pub struct FeDevice { /* private fields */ }

A reference to the frontend device and device information

Implementations

impl FeDevice

pub fn clear(&self) -> Result<()>

Clears frontend settings and event queue

pub fn open_ro(adapter: u32, device: u32) -> Result<FeDevice>

Attempts to open frontend device in read-only mode

Examples found in repository

examples/feinfo.rs (line 19)

fn main() -> Result<()> {
    let mut args = std::env::args().skip(1);

    let adapter = match args.next() {
        Some(v) => v.parse::<u32>().context("adapter number")?,
        None => bail!("adapter number not defined"),
    };

    let device = match args.next() {
        Some(v) => v.parse::<u32>().context("device number")?,
        None => 0,
    };

    let fe = FeDevice::open_ro(adapter, device)?;
    println!("{}", &fe);

    let mut status = FeStatus::default();
    status.read(&fe)?;
    println!("Status: {}", &status);

    Ok(())
}

examples/femon.rs (line 20)

fn main() -> Result<()> {
    let mut args = std::env::args().skip(1);

    let adapter = match args.next() {
        Some(v) => v.parse::<u32>().context("adapter number")?,
        None => bail!("adapter number not defined"),
    };

    let device = match args.next() {
        Some(v) => v.parse::<u32>().context("device number")?,
        None => 0,
    };

    let fe = FeDevice::open_ro(adapter, device)?;
    let mut status = FeStatus::default();

    let delay = Duration::from_secs(1);
    loop {
        status.read(&fe)?;
        println!("{}", &status);
        thread::sleep(delay);
    }
}

pub fn open_rw(adapter: u32, device: u32) -> Result<FeDevice>

Attempts to open frontend device in read-write mode

pub fn set_properties(&self, cmdseq: &[DtvProperty]) -> Result<()>

Sets properties on frontend device

pub fn get_properties(&self, cmdseq: &mut [DtvProperty]) -> Result<()>

Gets properties from frontend device

pub fn get_event(&self, event: &mut FeEvent) -> Result<()>

Returns a frontend events if available

pub fn read_status(&self) -> Result<fe_status>

Returns frontend status

• [FE_NONE]
• [FE_HAS_SIGNAL]
• [FE_HAS_CARRIER]
• [FE_HAS_VITERBI]
• [FE_HAS_SYNC]
• [FE_HAS_LOCK]
• [FE_TIMEDOUT]
• [FE_REINIT]

pub fn read_signal_strength(&self) -> Result<u16>

Reads and returns a signal strength relative value (DVBv3 API)

pub fn read_snr(&self) -> Result<u16>

Reads and returns a signal-to-noise ratio, relative value (DVBv3 API)

pub fn read_ber(&self) -> Result<u64>

Reads and returns a bit error counter (DVBv3 API)

pub fn read_unc(&self) -> Result<u64>

Reads and returns an uncorrected blocks counter (DVBv3 API)

pub fn set_tone(&self, value: u32) -> Result<()>

Turns on/off generation of the continuous 22kHz tone

allowed value’s:

• SEC_TONE_ON - turn 22kHz on
• SEC_TONE_OFF - turn 22kHz off

pub fn set_voltage(&self, value: u32) -> Result<()>

Sets the DC voltage level for LNB

allowed value’s:

• SEC_VOLTAGE_13 for 13V
• SEC_VOLTAGE_18 for 18V
• SEC_VOLTAGE_OFF turns LNB power supply off

Different power levels used to select internal antennas for different polarizations:

• 13V:
  • Vertical in linear LNB
  • Right in circular LNB
• 18V:
  • Horizontal in linear LNB
  • Left in circular LNB
• OFF is needed with external power supply, for example to use same LNB with several receivers.

pub fn diseqc_master_cmd(&self, msg: &[u8]) -> Result<()>

Sets DiSEqC master command

msg is a message no more 6 bytes length

Example DiSEqC commited command:

[0xE0, 0x10, 0x38, 0xF0 | value]

• byte 1 is a framing (master command without response)
• byte 2 is an address (any LNB)
• byte 3 is a command (commited)
• last 4 bits of byte 4 is:
  • xx00 - switch input
  • 00x0 - bit is set on SEC_VOLTAGE_18
  • 000x - bit is set on SEC_TONE_ON

pub fn get_api_version(&self) -> u16

Returns the current API version major - first byte minor - second byte

Trait Implementations

impl AsRawFd for FeDevice

fn as_raw_fd(&self) -> RawFd

Extracts the raw file descriptor.

impl Debug for FeDevice

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for FeDevice

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.