Enum ControlSpec 

pub enum ControlSpec {
    Setpoint {
        setpoint: f32,
        hysteresis: f32,
        cooling: bool,
        safe_band: f32,
    },
    Level {
        empty: f32,
        warn_within: u32,
    },
    Surge {
        rising: bool,
        limit: f32,
    },
    Monitor,
}

How a profile turns each reading into control output and alerts.

This is the policy half of a profile’s manifest: the tunable rule a community can publish and share, with no code to write. Profile::controller assembles it into a live Controller. In a manifest it is tagged by kind:

{ "kind": "setpoint", "setpoint": 5.0, "hysteresis": 0.5, "cooling": true, "safe_band": 3.0 }

Variants

Setpoint

Hold a reading near setpoint by switching an output on and off.

Fields

setpoint: f32

The target reading, such as 5 C for a vaccine fridge.

hysteresis: f32

Half the deadband width around the setpoint, which stops the output chattering at the threshold.

cooling: bool

Whether the output cools (switches on above the band) or heats (switches on below it). An irrigation valve that adds water is a “heater”.

safe_band: f32

How far the reading may stray from the setpoint before an Alert::OutOfRange fires.

Level

Watch a falling level and warn before it reaches empty.

Fields

empty: f32

The level treated as empty, such as a dry tank.

warn_within: u32

Warn once the level is estimated to reach empty within this many more samples.

Surge

Warn when a reading changes faster than limit per sample.

Fields

rising: bool

Watch a rapid rise (true) or a rapid fall (false).

limit: f32

The largest safe change per sample.

Monitor

Report readings only, with no control output and no alerts.

Trait Implementations

impl Clone for ControlSpec

fn clone(&self) -> ControlSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ControlSpec

impl Debug for ControlSpec

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ControlSpec

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ControlSpec

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ControlSpec

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 ControlSpec