Struct BeepPattern 

pub struct BeepPattern {
    pub freq_hz: u32,
    pub duty_pct: u8,
    pub on_ms: u32,
    pub off_ms: u32,
    pub cycles: u32,
}

A bounded software-PWM beep description.

The envelope toggles the line on for on_ms then off for off_ms, for cycles. During each on phase the service also drives the carrier a passive buzzer needs: the line toggles at freq_hz with duty_pct high time (carrier_timing). With freq_hz 0 (an active buzzer or an LED) the on phase is a steady high.

Every field is advisory until clamp bounds it; the service always clamps before scheduling, so a value out of range is corrected, never trusted.

Fields

freq_hz: u32

Buzzer carrier frequency in Hz (0 = no carrier, a plain on/off envelope for an active buzzer or LED). Clamped to MAX_CARRIER_HZ.

duty_pct: u8

Carrier duty cycle as a percentage (0..=100). Clamped to 100.

on_ms: u32

Milliseconds the line is held high per cycle.

off_ms: u32

Milliseconds the line is held low between cycles.

cycles: u32

Number of on/off cycles to run.

Implementations

impl BeepPattern

pub fn clamp(self) -> Self

Clamp every field into the safe bounds. duty_pct is capped at 100, freq_hz at MAX_CARRIER_HZ, on_ms/off_ms at MAX_PHASE_MS, cycles at MAX_BEEP_CYCLES. Idempotent: clamping an already-clamped pattern is a no-op.

Trait Implementations

impl Clone for BeepPattern

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for BeepPattern

impl Debug for BeepPattern

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BeepPattern

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for BeepPattern

impl PartialEq for BeepPattern

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for BeepPattern

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for BeepPattern