Struct GPIO

pub struct GPIO(gpio_t);

Available on riot_module_periph_gpio only.

A Rust representation of RIOT’s gpio_t, representing a single pin in no particular configuration.

Tuple Fields

0: gpio_t

Implementations

impl GPIO

pub fn from_c(gpio: gpio_t) -> Option<Self>

Create a GPIO from a gpio_t

This is as safe as any device acquisition from C is – RIOT’s drivers are (hopefully) written in such a way that concurrent writes to adjacent pins don’t interfere, and those to the same device are “just” racy.

(This also means that it is completely possible to have two objects for the same pin configured in different states, changing the mode while the other is around. The underlying operating system operates this, but interactions with a reconfigured pin will obviously not have the intended effect).

pub fn from_port_and_pin(port: u32, pin: u32) -> Option<Self>

Create a GPIO from its port and pin numbers

use riot_wrappers::gpio::GPIO;
let pin_c8 = GPIO::from_port_and_pin(3, 8);

See .from_c() for safety constraints.

pub fn configure_as_output( self, mode: OutputMode, ) -> Result<OutputGPIO, NumericError>

pub fn configure_as_input( self, mode: InputMode, ) -> Result<InputGPIO, NumericError>

pub fn configure_as_inout( self, mode: InOutMode, ) -> Result<InOutGPIO, NumericError>

pub fn to_c(&self) -> gpio_t

Get a gpio_t from a configured pin

This is typically useful when populating a RIOT mechanism that works on a pre-configured pin.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 1 byte