Struct Device 

pub struct Device { /* private fields */ }

High-level owned HackRF device handle.

Implementations

impl Device

pub fn list() -> impl MaybeFuture<Output = Result<Vec<DeviceDescriptor>>>

List visible normal-mode HackRF devices without claiming them.

pub fn builder() -> DeviceBuilder

Start building and opening a HackRF.

pub fn open() -> impl MaybeFuture<Output = Result<Self>>

Open and configure the first visible HackRF.

pub fn open_serial(serial: u128) -> impl MaybeFuture<Output = Result<Self>>

Open and configure a HackRF by its exact 128-bit serial.

pub fn info(&self) -> &DeviceInfo

Return metadata collected while opening the device.

pub fn config(&self) -> &Config

Return the configuration last successfully applied by this driver.

pub fn configure<'a>( &'a mut self, config: &'a Config, ) -> impl MaybeFuture<Output = Result<()>> + 'a

Apply a complete validated RX configuration.

pub fn set_frequency_hz( &mut self, frequency_hz: u64, ) -> impl MaybeFuture<Output = Result<()>> + '_

Change the center frequency while stopped or receiving.

pub fn set_sample_rate_hz( &mut self, sample_rate_hz: u32, ) -> impl MaybeFuture<Output = Result<()>> + '_

Change the complex sample rate while stopped or receiving.

The driver also requests a baseband filter bandwidth equal to this rate.

pub fn set_lna_gain_db( &mut self, gain_db: u8, ) -> impl MaybeFuture<Output = Result<()>> + '_

Set RX IF/LNA gain in dB.

pub fn set_vga_gain_db( &mut self, gain_db: u8, ) -> impl MaybeFuture<Output = Result<()>> + '_

Set baseband/VGA gain in dB.

pub fn set_amp_enable( &mut self, enabled: bool, ) -> impl MaybeFuture<Output = Result<()>> + '_

Enable or disable the RF amplifier.

pub fn set_bias_tee( &mut self, enabled: bool, ) -> impl MaybeFuture<Output = Result<()>> + '_

Enable or disable antenna-port bias power.

HackRF firmware disables this when reception stops. A later stream start automatically reapplies the last successful setting.

pub fn rx_stream(&self) -> Result<RxStream>

Claim the device’s single owned receive stream.

The stream starts dormant. The device remains usable for live setters while reception is active. Dropping the stream releases the claim.

pub fn shutdown(&mut self) -> impl MaybeFuture<Output = Result<()>> + '_

Put the transceiver in off mode and close the logical device session.

Returns Error::Busy while a receive stream is running. A stopped but still-owned stream does not prevent shutdown, but cannot be restarted.

Trait Implementations

impl Debug for Device

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

Formats the value using the given formatter.

impl Drop for Device

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.