Struct Attention 

pub struct Attention { /* private fields */ }

Display-attention state machine.

Pure logic driven by a monotonic millisecond clock: no timers, no hardware. Every method that can change state takes now_ms so the whole thing is testable with synthetic time.

Implementations

impl Attention

pub fn new(kind: DisplayKind, config: AttentionConfig, now_ms: u64) -> Self

Start in DisplayState::Active — boot is itself a wake event.

pub fn kind(&self) -> DisplayKind

pub fn state(&self) -> DisplayState

pub fn config(&self) -> AttentionConfig

pub fn set_config(&mut self, config: AttentionConfig)

Replace the timing policy. The new timeout is measured from the existing activity mark, so shortening it below the time already elapsed lapses at the next poll rather than retroactively.

pub fn is_lapsed(&self) -> bool

True once attention has lapsed.

pub fn accepts_redraw(&self) -> bool

Whether the panel can show a redraw right now.

False only for an emissive panel that has been powered off: pushing pixels at a dark panel wastes bus traffic and, on a board that samples its battery on a timer, would otherwise run forever. Persistent panels always accept a redraw — that is how their lapse is rendered.

pub fn held(&self) -> bool

Whether any hold is currently pinning the display awake.

pub fn wake(&mut self, now_ms: u64) -> Option<Transition>

Register user-driven activity.

Returns Transition::Woke when this actually brought the panel back, so the caller can order its redraw and power-on correctly; returns None when the display was already active and only the inactivity timer moved.

pub fn set_hold( &mut self, reason: HoldReason, active: bool, now_ms: u64, ) -> Option<Transition>

Assert or release a hold.

Asserting one also counts as activity, so an event like a pairing window opening both wakes the panel and pins it. Releasing the last hold restarts the inactivity window from that moment, so the user gets a full timeout to read whatever the hold was showing.

pub fn poll(&mut self, now_ms: u64) -> Option<Transition>

Advance time. Returns a transition when one becomes due.

pub fn next_deadline(&self) -> Option<u64>

Absolute monotonic-millisecond deadline for the next poll, if any is pending.

Trait Implementations

impl Clone for Attention

fn clone(&self) -> Attention

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Attention

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

Formats the value using the given formatter.

impl Copy for Attention