Struct RetryConfig 

pub struct RetryConfig {
    pub max_retries: u32,
    pub initial_delay: Duration,
    pub max_delay: Duration,
    pub backoff_multiplier: f64,
    pub jitter: bool,
}

Configuration for retry behavior.

Fields

max_retries: u32

Maximum number of retry attempts (0 means no retries).

initial_delay: Duration

Initial delay between retries.

max_delay: Duration

Maximum delay between retries (for exponential backoff).

backoff_multiplier: f64

Backoff multiplier (1.0 = constant delay, 2.0 = double each time).

jitter: bool

Whether to add jitter to delays.

Implementations

impl RetryConfig

pub fn new(max_retries: u32) -> Self

Create a new retry config with custom settings.

pub fn none() -> Self

No retries.

pub fn aggressive() -> Self

Conservative retry settings for unreliable connections.

pub fn for_scan() -> Self

Retry configuration optimized for device scanning.

Scanning often requires multiple attempts due to:

• BLE adapter warm-up
• Devices advertising at intervals (Aranet ~4s)
• RF interference

Uses aggressive, fast retries with short delays.

pub fn for_connect() -> Self

Retry configuration optimized for device connection.

Connections may fail due to:

• Device busy with another central
• Device in low-power mode (slower wake-up)
• Signal strength variations

Uses patient retries with longer delays to allow device recovery.

pub fn for_read() -> Self

Retry configuration optimized for characteristic reads.

Reads may fail due to:

• Transient BLE errors
• Connection instability
• Device processing delay

Uses standard retries suitable for most read operations.

pub fn for_write() -> Self

Retry configuration optimized for characteristic writes.

Writes may fail due to:

• BLE transmission errors
• Device busy processing previous write
• Connection instability

Uses careful retries with moderate delays.

pub fn for_history() -> Self

Retry configuration optimized for history downloads.

History downloads are long-running operations that may fail due to:

• Connection drops during extended transfer
• Device timeout during large transfers
• BLE congestion from repeated reads

Uses persistent retries with longer delays, designed to work with checkpoint-based resumption for large downloads.

pub fn for_reconnect() -> Self

Retry configuration optimized for reconnection attempts.

After a connection loss, the device may need time to:

• Reset its BLE state
• Complete other operations
• Recover from low-power mode

Uses very patient retries with long delays.

pub fn quick() -> Self

Retry configuration for quick, time-sensitive operations.

For operations where speed is more important than reliability, uses minimal retries with very short delays.

pub fn max_retries(self, retries: u32) -> Self

Set maximum number of retries.

pub fn initial_delay(self, delay: Duration) -> Self

Set initial delay.

pub fn max_delay(self, delay: Duration) -> Self

Set maximum delay.

pub fn backoff_multiplier(self, multiplier: f64) -> Self

Set backoff multiplier.

pub fn jitter(self, enabled: bool) -> Self

Enable or disable jitter.

Trait Implementations

impl Clone for RetryConfig

fn clone(&self) -> RetryConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RetryConfig

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

Formats the value using the given formatter.

impl Default for RetryConfig

fn default() -> Self

Returns the “default value” for a type.