Struct Led 

pub struct Led<P, POL = ActiveHigh> { /* private fields */ }

Monochrome LED with compile-time polarity.

Type parameters:

• P: pin type implementing OutputPin and StatefulOutputPin.
• POL: polarity marker, ActiveHigh or ActiveLow (default ActiveHigh).

No internal state cache — is_on() reads the hardware register (ODR) directly and applies the polarity conversion. In the embassy ecosystem OutputPin::Error is Infallible, so unwrapping results is safe.

Examples

use status_led::{Led, ActiveLow};

let mut led = Led::<_, ActiveLow>::new(pin).unwrap();
led.on().unwrap();
led.toggle().unwrap();
assert!(led.is_on().unwrap());

Implementations

impl<P, POL> Led<P, POL>

pub fn from_pin(pin: P) -> Self

Build from an already-configured pin without changing its level.

Prefer this when the HAL already set the pin to a known state (e.g. Output::new(pin, Level::High, Speed::Low) for an active-low LED).

impl<P: OutputPin, POL: Polarity> Led<P, POL>

pub fn new(pin: P) -> Result<Self, P::Error>

Build and force the pin to the logical OFF state.

Safest default — guarantees the LED starts dark regardless of the pin’s reset state.

pub fn on(&mut self) -> Result<(), P::Error>

Turn the LED on (logical ON → physical level determined by polarity).

pub fn off(&mut self) -> Result<(), P::Error>

Turn the LED off (logical OFF → physical level determined by polarity).

pub fn set(&mut self, state: bool) -> Result<(), P::Error>

Set the logical state: true = ON, false = OFF.

impl<P: StatefulOutputPin, POL: Polarity> Led<P, POL>

pub fn is_on(&mut self) -> Result<bool, P::Error>

Read the logical state from the hardware register.

Reads the physical pin level (ODR register on STM32), then converts through the polarity. Requires &mut self because StatefulOutputPin::is_set_high does — in practice the read is a single register access with no side effects.

pub fn is_off(&mut self) -> Result<bool, P::Error>

Inverse of is_on.

pub fn toggle(&mut self) -> Result<(), P::Error>

Toggle the logical state.

Delegates to StatefulOutputPin::toggle. On embassy this is a single bit-band operation (ODR ^= 1 << n) — unconditionally flips the physical pin, which is always correct regardless of polarity.

impl<P, POL: Polarity> Led<P, POL>

pub fn release(self) -> P

Consume the Led and return the underlying pin.

pub fn into_flex(self) -> FlexLed<P>

Convert to a FlexLed, preserving the current polarity.

Trait Implementations

impl<P, POL: Polarity> Debug for Led<P, POL>

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

Formats the value using the given formatter.

impl<P, POL: Polarity> From<Led<P, POL>> for FlexLed<P>

fn from(led: Led<P, POL>) -> Self

Converts to this type from the input type.