Struct Pin

pub struct Pin<const P: char, const N: u8, MODE = Input<Floating>> { /* private fields */ }

Generic pin type

• MODE is one of the pin modes (see Modes section).
• P is port name: A for GPIOA, B for GPIOB, etc.
• N is pin number: from 0 to 15.

Implementations

impl<const P: char, const N: u8, MODE> Pin<P, N, MODE>

pub fn into_alternate<const A: u8>(self) -> Pin<P, N, Alternate<A, PushPull>>

Configures the pin to operate alternate mode

pub fn into_alternate_open_drain<const A: u8>( self, ) -> Pin<P, N, Alternate<A, OpenDrain>>

Configures the pin to operate in alternate open drain mode

pub fn into_floating_input(self) -> Pin<P, N, Input<Floating>>

Configures the pin to operate as a floating input pin

pub fn into_pull_down_input(self) -> Pin<P, N, Input<PullDown>>

Configures the pin to operate as a pulled down input pin

pub fn into_pull_up_input(self) -> Pin<P, N, Input<PullUp>>

Configures the pin to operate as a pulled up input pin

pub fn into_open_drain_output(self) -> Pin<P, N, Output<OpenDrain>>

Configures the pin to operate as an open drain output pin Initial state will be low.

pub fn into_open_drain_output_in_state( self, initial_state: PinState, ) -> Pin<P, N, Output<OpenDrain>>

Configures the pin to operate as an open-drain output pin. initial_state specifies whether the pin should be initially high or low.

pub fn into_push_pull_output(self) -> Pin<P, N, Output<PushPull>>

Configures the pin to operate as an push pull output pin Initial state will be low.

pub fn into_push_pull_output_in_state( self, initial_state: PinState, ) -> Pin<P, N, Output<PushPull>>

Configures the pin to operate as an push-pull output pin. initial_state specifies whether the pin should be initially high or low.

pub fn into_analog(self) -> Pin<P, N, Analog>

Configures the pin to operate as an analog input pin

pub fn into_dynamic(self) -> DynamicPin<P, N>

Configures the pin as a pin that can change between input and output without changing the type. It starts out as a floating input

impl<const P: char, const N: u8, MODE> Pin<P, N, MODE>

where MODE: PinMode,

pub fn with_floating_input<R>( &mut self, f: impl FnOnce(&mut Pin<P, N, Input<Floating>>) -> R, ) -> R

Temporarily configures this pin as a floating input.

The closure f is called with the reconfigured pin. After it returns, the pin will be configured back.

pub fn with_pull_down_input<R>( &mut self, f: impl FnOnce(&mut Pin<P, N, Input<PullDown>>) -> R, ) -> R

Temporarily configures this pin as a pulled-down input.

The closure f is called with the reconfigured pin. After it returns, the pin will be configured back.

pub fn with_pull_up_input<R>( &mut self, f: impl FnOnce(&mut Pin<P, N, Input<PullUp>>) -> R, ) -> R

Temporarily configures this pin as a pulled-up input.

The closure f is called with the reconfigured pin. After it returns, the pin will be configured back.

pub fn with_analog<R>( &mut self, f: impl FnOnce(&mut Pin<P, N, Analog>) -> R, ) -> R

Temporarily configures this pin as an analog pin.

The closure f is called with the reconfigured pin. After it returns, the pin will be configured back.

pub fn with_open_drain_output<R>( &mut self, f: impl FnOnce(&mut Pin<P, N, Output<OpenDrain>>) -> R, ) -> R

Temporarily configures this pin as an open drain output.

The closure f is called with the reconfigured pin. After it returns, the pin will be configured back. The value of the pin after conversion is undefined. If you want to control it, use with_open_drain_output_in_state

pub fn with_open_drain_output_in_state<R>( &mut self, state: PinState, f: impl FnOnce(&mut Pin<P, N, Output<OpenDrain>>) -> R, ) -> R

Temporarily configures this pin as an open drain output .

The closure f is called with the reconfigured pin. After it returns, the pin will be configured back. Note that the new state is set slightly before conversion happens. This can cause a short output glitch if switching between output modes

pub fn with_push_pull_output<R>( &mut self, f: impl FnOnce(&mut Pin<P, N, Output<PushPull>>) -> R, ) -> R

Temporarily configures this pin as a push-pull output.

The closure f is called with the reconfigured pin. After it returns, the pin will be configured back. The value of the pin after conversion is undefined. If you want to control it, use with_push_pull_output_in_state

pub fn with_push_pull_output_in_state<R>( &mut self, state: PinState, f: impl FnOnce(&mut Pin<P, N, Output<PushPull>>) -> R, ) -> R

Temporarily configures this pin as a push-pull output.

The closure f is called with the reconfigured pin. After it returns, the pin will be configured back. Note that the new state is set slightly before conversion happens. This can cause a short output glitch if switching between output modes

impl<const P: char, const N: u8, MODE> Pin<P, N, Output<MODE>>

pub fn set_speed(self, speed: Speed) -> Self

Set pin speed

impl<const P: char, const N: u8> Pin<P, N, Output<OpenDrain>>

pub fn internal_pull_up(self, on: bool) -> Self

Enables / disables the internal pull up

pub fn internal_pull_down(self, on: bool) -> Self

Enables / disables the internal pull down

impl<const P: char, const N: u8, const A: u8> Pin<P, N, Alternate<A, PushPull>>

pub fn set_speed(self, speed: Speed) -> Self

Set pin speed

pub fn internal_pull_up(self, on: bool) -> Self

Enables / disables the internal pull up

pub fn internal_pull_down(self, on: bool) -> Self

Enables / disables the internal pull down

impl<const P: char, const N: u8, const A: u8> Pin<P, N, Alternate<A, PushPull>>

pub fn set_open_drain(self) -> Pin<P, N, Alternate<A, OpenDrain>>

Turns pin alternate configuration pin into open drain

impl<const P: char, const N: u8, MODE> Pin<P, N, MODE>

pub fn erase_number(self) -> PEPin<P, MODE>

Erases the pin number from the type

This is useful when you want to collect the pins into an array where you need all the elements to have the same type

pub fn erase(self) -> EPin<MODE>

Erases the pin number and the port from the type

This is useful when you want to collect the pins into an array where you need all the elements to have the same type

impl<const P: char, const N: u8, MODE> Pin<P, N, Output<MODE>>

pub fn set_high(&mut self)

pub fn set_low(&mut self)

pub fn get_state(&self) -> PinState

pub fn set_state(&mut self, state: PinState)

pub fn is_set_high(&self) -> bool

pub fn is_set_low(&self) -> bool

pub fn toggle(&mut self)

impl<const P: char, const N: u8> Pin<P, N, Output<OpenDrain>>

pub fn is_high(&self) -> bool

pub fn is_low(&self) -> bool

impl<const P: char, const N: u8, MODE> Pin<P, N, Input<MODE>>

pub fn is_high(&self) -> bool

pub fn is_low(&self) -> bool

Trait Implementations

impl<const P: char, const N: u8, MODE> Debug for Pin<P, N, MODE>

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

Formats the value using the given formatter.

impl<const P: char, const N: u8> From<Pin<P, N>> for Pin<P, N, Input<PullDown>>

fn from(f: Pin<P, N, Input<Floating>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8> From<Pin<P, N>> for Pin<P, N, Input<PullUp>>

fn from(f: Pin<P, N, Input<Floating>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8> From<Pin<P, N, Alternate<A>>> for Pin<P, N, Input<Floating>>

fn from(f: Pin<P, N, Alternate<A, PushPull>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8> From<Pin<P, N, Alternate<A>>> for Pin<P, N, Analog>

fn from(f: Pin<P, N, Alternate<A, PushPull>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8> From<Pin<P, N, Alternate<A>>> for Pin<P, N, Input<PullDown>>

fn from(f: Pin<P, N, Alternate<A, PushPull>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8> From<Pin<P, N, Alternate<A>>> for Pin<P, N, Input<PullUp>>

fn from(f: Pin<P, N, Alternate<A, PushPull>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8> From<Pin<P, N, Alternate<A>>> for Pin<P, N, Output<OpenDrain>>

fn from(f: Pin<P, N, Alternate<A, PushPull>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8> From<Pin<P, N, Alternate<A>>> for Pin<P, N, Output<PushPull>>

fn from(f: Pin<P, N, Alternate<A, PushPull>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8> From<Pin<P, N, Alternate<A, OpenDrain>>> for Pin<P, N, Input<Floating>>

fn from(f: Pin<P, N, Alternate<A, OpenDrain>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8> From<Pin<P, N, Alternate<A, OpenDrain>>> for Pin<P, N, Analog>

fn from(f: Pin<P, N, Alternate<A, OpenDrain>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8> From<Pin<P, N, Alternate<A, OpenDrain>>> for Pin<P, N, Input<PullDown>>

fn from(f: Pin<P, N, Alternate<A, OpenDrain>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8> From<Pin<P, N, Alternate<A, OpenDrain>>> for Pin<P, N, Input<PullUp>>

fn from(f: Pin<P, N, Alternate<A, OpenDrain>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8> From<Pin<P, N, Alternate<A, OpenDrain>>> for Pin<P, N, Output<OpenDrain>>

fn from(f: Pin<P, N, Alternate<A, OpenDrain>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8> From<Pin<P, N, Alternate<A, OpenDrain>>> for Pin<P, N, Output<PushPull>>

fn from(f: Pin<P, N, Alternate<A, OpenDrain>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8, const B: u8> From<Pin<P, N, Alternate<B>>> for Pin<P, N, Alternate<A, OpenDrain>>

fn from(f: Pin<P, N, Alternate<B, PushPull>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8, const B: u8> From<Pin<P, N, Alternate<B, OpenDrain>>> for Pin<P, N, Alternate<A, PushPull>>

fn from(f: Pin<P, N, Alternate<B, OpenDrain>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8> From<Pin<P, N, Analog>> for Pin<P, N, Input<Floating>>

fn from(f: Pin<P, N, Analog>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8> From<Pin<P, N, Analog>> for Pin<P, N, Alternate<A, PushPull>>

fn from(f: Pin<P, N, Analog>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8> From<Pin<P, N, Analog>> for Pin<P, N, Alternate<A, OpenDrain>>

fn from(f: Pin<P, N, Analog>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8> From<Pin<P, N, Analog>> for Pin<P, N, Input<PullDown>>

fn from(f: Pin<P, N, Analog>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8> From<Pin<P, N, Analog>> for Pin<P, N, Input<PullUp>>

fn from(f: Pin<P, N, Analog>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8> From<Pin<P, N, Analog>> for Pin<P, N, Output<OpenDrain>>

fn from(f: Pin<P, N, Analog>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8> From<Pin<P, N, Analog>> for Pin<P, N, Output<PushPull>>

fn from(f: Pin<P, N, Analog>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8, MODE> From<Pin<P, N, Input<MODE>>> for Pin<P, N, Alternate<A, PushPull>>

fn from(f: Pin<P, N, Input<MODE>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8, MODE> From<Pin<P, N, Input<MODE>>> for Pin<P, N, Alternate<A, OpenDrain>>

fn from(f: Pin<P, N, Input<MODE>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, MODE> From<Pin<P, N, Input<MODE>>> for Pin<P, N, Analog>

fn from(f: Pin<P, N, Input<MODE>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, MODE> From<Pin<P, N, Input<MODE>>> for Pin<P, N, Output<OpenDrain>>

fn from(f: Pin<P, N, Input<MODE>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, MODE> From<Pin<P, N, Input<MODE>>> for Pin<P, N, Output<PushPull>>

fn from(f: Pin<P, N, Input<MODE>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8> From<Pin<P, N, Input<PullDown>>> for Pin<P, N, Input<Floating>>

fn from(f: Pin<P, N, Input<PullDown>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8> From<Pin<P, N, Input<PullDown>>> for Pin<P, N, Input<PullUp>>

fn from(f: Pin<P, N, Input<PullDown>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8> From<Pin<P, N, Input<PullUp>>> for Pin<P, N, Input<Floating>>

fn from(f: Pin<P, N, Input<PullUp>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8> From<Pin<P, N, Input<PullUp>>> for Pin<P, N, Input<PullDown>>

fn from(f: Pin<P, N, Input<PullUp>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, MODE> From<Pin<P, N, Output<MODE>>> for Pin<P, N, Input<Floating>>

fn from(f: Pin<P, N, Output<MODE>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8, MODE> From<Pin<P, N, Output<MODE>>> for Pin<P, N, Alternate<A, PushPull>>

fn from(f: Pin<P, N, Output<MODE>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, const A: u8, MODE> From<Pin<P, N, Output<MODE>>> for Pin<P, N, Alternate<A, OpenDrain>>

fn from(f: Pin<P, N, Output<MODE>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, MODE> From<Pin<P, N, Output<MODE>>> for Pin<P, N, Analog>

fn from(f: Pin<P, N, Output<MODE>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, MODE> From<Pin<P, N, Output<MODE>>> for Pin<P, N, Input<PullDown>>

fn from(f: Pin<P, N, Output<MODE>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, MODE> From<Pin<P, N, Output<MODE>>> for Pin<P, N, Input<PullUp>>

fn from(f: Pin<P, N, Output<MODE>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8> From<Pin<P, N, Output<OpenDrain>>> for Pin<P, N, Output<PushPull>>

fn from(f: Pin<P, N, Output<OpenDrain>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8> From<Pin<P, N, Output>> for Pin<P, N, Output<OpenDrain>>

fn from(f: Pin<P, N, Output<PushPull>>) -> Self

Converts to this type from the input type.

impl<const P: char, const N: u8, MODE> InputPin for Pin<P, N, Input<MODE>>

type Error = Infallible

Error type

fn is_high(&self) -> Result<bool, Self::Error>

Is the input pin high?

fn is_low(&self) -> Result<bool, Self::Error>

Is the input pin low?

impl<const P: char, const N: u8> InputPin for Pin<P, N, Output<OpenDrain>>

type Error = Infallible

Error type

fn is_high(&self) -> Result<bool, Self::Error>

Is the input pin high?

fn is_low(&self) -> Result<bool, Self::Error>

Is the input pin low?

impl<const P: char, const N: u8> IoPin<Pin<P, N>, Pin<P, N, Output<OpenDrain>>> for Pin<P, N, Input<Floating>>

type Error = Infallible

Error type.

fn into_input_pin(self) -> Result<Self, Self::Error>

Tries to convert this pin to input mode.

fn into_output_pin( self, state: PinState, ) -> Result<Pin<P, N, Output<OpenDrain>>, Self::Error>

Tries to convert this pin to output mode with the given initial state.

impl<const P: char, const N: u8> IoPin<Pin<P, N>, Pin<P, N, Output<OpenDrain>>> for Pin<P, N, Output<OpenDrain>>

type Error = Infallible

Error type.

fn into_input_pin(self) -> Result<Pin<P, N, Input<Floating>>, Self::Error>

Tries to convert this pin to input mode.

fn into_output_pin(self, state: PinState) -> Result<Self, Self::Error>

Tries to convert this pin to output mode with the given initial state.

impl<const P: char, const N: u8> IoPin<Pin<P, N>, Pin<P, N, Output>> for Pin<P, N, Input<Floating>>

type Error = Infallible

Error type.

fn into_input_pin(self) -> Result<Self, Self::Error>

Tries to convert this pin to input mode.

fn into_output_pin( self, state: PinState, ) -> Result<Pin<P, N, Output<PushPull>>, Self::Error>

Tries to convert this pin to output mode with the given initial state.

impl<const P: char, const N: u8> IoPin<Pin<P, N>, Pin<P, N, Output>> for Pin<P, N, Output<PushPull>>

type Error = Infallible

Error type.

fn into_input_pin(self) -> Result<Pin<P, N, Input<Floating>>, Self::Error>

Tries to convert this pin to input mode.

fn into_output_pin(self, state: PinState) -> Result<Self, Self::Error>

Tries to convert this pin to output mode with the given initial state.

impl<const P: char, const N: u8> IoPin<Pin<P, N, Input<PullDown>>, Pin<P, N, Output>> for Pin<P, N, Input<PullDown>>

type Error = Infallible

Error type.

fn into_input_pin(self) -> Result<Self, Self::Error>

Tries to convert this pin to input mode.

fn into_output_pin( self, state: PinState, ) -> Result<Pin<P, N, Output<PushPull>>, Self::Error>

Tries to convert this pin to output mode with the given initial state.

impl<const P: char, const N: u8> IoPin<Pin<P, N, Input<PullDown>>, Pin<P, N, Output>> for Pin<P, N, Output<PushPull>>

type Error = Infallible

Error type.

fn into_input_pin(self) -> Result<Pin<P, N, Input<PullDown>>, Self::Error>

Tries to convert this pin to input mode.

fn into_output_pin(self, state: PinState) -> Result<Self, Self::Error>

Tries to convert this pin to output mode with the given initial state.

impl<const P: char, const N: u8> IoPin<Pin<P, N, Input<PullUp>>, Pin<P, N, Output>> for Pin<P, N, Input<PullUp>>

type Error = Infallible

Error type.

fn into_input_pin(self) -> Result<Self, Self::Error>

Tries to convert this pin to input mode.

fn into_output_pin( self, state: PinState, ) -> Result<Pin<P, N, Output<PushPull>>, Self::Error>

Tries to convert this pin to output mode with the given initial state.

impl<const P: char, const N: u8> IoPin<Pin<P, N, Input<PullUp>>, Pin<P, N, Output>> for Pin<P, N, Output<PushPull>>

type Error = Infallible

Error type.

fn into_input_pin(self) -> Result<Pin<P, N, Input<PullUp>>, Self::Error>

Tries to convert this pin to input mode.

fn into_output_pin(self, state: PinState) -> Result<Self, Self::Error>

Tries to convert this pin to output mode with the given initial state.

impl<const P: char, const N: u8> IoPin<Pin<P, N, Output<OpenDrain>>, Pin<P, N, Output<OpenDrain>>> for Pin<P, N, Output<OpenDrain>>

type Error = Infallible

Error type.

fn into_input_pin(self) -> Result<Self, Self::Error>

Tries to convert this pin to input mode.

fn into_output_pin(self, state: PinState) -> Result<Self, Self::Error>

Tries to convert this pin to output mode with the given initial state.

impl<const P: char, const N: u8, MODE> OutputPin for Pin<P, N, Output<MODE>>

type Error = Infallible

Error type

fn set_high(&mut self) -> Result<(), Self::Error>

Drives the pin high

fn set_low(&mut self) -> Result<(), Self::Error>

Drives the pin low

fn set_state(&mut self, state: PinState) -> Result<(), Self::Error>

Drives the pin high or low depending on the provided value

impl<const P: char, const N: u8, MODE> PinExt for Pin<P, N, MODE>

type Mode = MODE

fn pin_id(&self) -> u8

Return pin number

fn port_id(&self) -> u8

Return port number

impl<const P: char, const N: u8, MODE> StatefulOutputPin for Pin<P, N, Output<MODE>>

fn is_set_high(&self) -> Result<bool, Self::Error>

Is the pin in drive high mode?

fn is_set_low(&self) -> Result<bool, Self::Error>

Is the pin in drive low mode?

impl<const P: char, const N: u8, MODE> ToggleableOutputPin for Pin<P, N, Output<MODE>>

type Error = Infallible

Error type

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

Toggle pin output.