Struct PowerSchedule 

pub struct PowerSchedule {
    pub active_secs: u64,
    pub saver_secs: u64,
    pub critical_secs: u64,
    pub saver_below: f32,
    pub critical_below: f32,
    pub hysteresis: f32,
}

How often a node samples as its battery drains, in plain seconds.

This is the serializable form of a PowerPlan: a manifest carries the three work intervals as whole seconds and the two state-of-charge thresholds, and plan assembles the pamoja-power governor from them. The thresholds may be omitted from a manifest, in which case they default to entering the saver cadence below 50% charge and the critical cadence below 20%. So may the hysteresis margin, which defaults to five points: a node that fell below a threshold climbs back once the charge is 5% above it, so a charge hovering at the threshold does not switch the cadence every cycle.

Fields

active_secs: u64

Seconds between samples at a healthy charge.

saver_secs: u64

Seconds between samples while conserving.

critical_secs: u64

Seconds between samples when critically low.

saver_below: f32

Enter the saver cadence below this state of charge.

critical_below: f32

Enter the critical cadence below this state of charge.

hysteresis: f32

How far above a threshold the charge must climb to leave the lower cadence.

Implementations

impl PowerSchedule

pub fn new(active_secs: u64, saver_secs: u64, critical_secs: u64) -> Self

Creates a schedule from its three work intervals, with default thresholds.

Arguments

• active_secs - seconds between samples at a healthy charge.
• saver_secs - seconds between samples while conserving.
• critical_secs - seconds between samples when critically low.

Returns

A schedule that enters the saver cadence below 50% charge and the critical cadence below 20%, and leaves each once the charge is five points above it.

pub fn with_thresholds(self, saver_below: f32, critical_below: f32) -> Self

Sets the state-of-charge thresholds for entering each lower cadence.

Arguments

• saver_below - enter the saver cadence when charge is below this.
• critical_below - enter the critical cadence when charge is below this, normally lower than saver_below.

Returns

The updated schedule, for chaining.

pub fn with_hysteresis(self, margin: f32) -> Self

Sets how far above a threshold the charge must climb to leave the lower cadence.

Arguments

• margin - the state of charge added to each threshold on the way back up; 0.0 switches cadence at the thresholds themselves.

Returns

The updated schedule, for chaining.

pub fn plan(&self) -> PowerPlan

Assembles the pamoja-power governor this schedule describes.

Returns

A PowerPlan with this schedule’s intervals, thresholds, and hysteresis.

Trait Implementations

impl Clone for PowerSchedule

fn clone(&self) -> PowerSchedule

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PowerSchedule

impl Debug for PowerSchedule

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PowerSchedule

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for PowerSchedule

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for PowerSchedule

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 PowerSchedule