Struct DedicatedGpioOutput 

pub struct DedicatedGpioOutput<'lt> { /* private fields */ }

A dedicated GPIO output driver.

Due to how the hardware works, DedicatedGpioOutput can drive any number of GPIO pins. To create a driver, you can use the DedicatedGpioOutput::new method, then DedicatedGpioOutput::with_pin to add output drivers.

The method output_level is currently not available on ESP32-S3 due to an LLVM bug. See https://github.com/espressif/llvm-project/issues/120 for details.

Note that the driver must only be used on the core that has created it. Do not send the driver to another core, either directly, or indirectly via a thread that is not pinned to a core.

Examples

use esp_hal::gpio::{
    Level,
    Output,
    OutputConfig,
    dedicated::{DedicatedGpio, DedicatedGpioOutput},
};

// Create a dedicated GPIO driver:
let channels = DedicatedGpio::new(peripherals.GPIO_DEDICATED);
let dedicated_output = DedicatedGpioOutput::new(channels.channel0);

// Add any number of output pin drivers:
let output = Output::new(peripherals.GPIO0, Level::Low, OutputConfig::default());
let mut dedicated_output = dedicated_output.with_pin(output);

// Now you can use the pin.
dedicated_output.set_level(Level::High);

Implementations

impl<'lt> DedicatedGpioOutput<'lt>

pub fn new<CH>(channel: CH) -> Self

where CH: OutputChannel + 'lt,

Creates a new dedicated GPIO output driver.

This function returns an empty driver. You will need to add output drivers to it using the Self::with_pin method.

pub fn with_pin(self, pin: impl OutputDriver + 'lt) -> Self

Adds a new output driver to the GPIO pins.

A dedicated GPIO output driver can control any number of GPIO pins. The pins will be released when the driver is dropped. This function does not change the state of the newly added GPIO pin.

pub fn set_level(&mut self, level: Level)

Changes the current state of the GPIO pins.

Trait Implementations

impl Drop for DedicatedGpioOutput<'_>

Available on crate feature unstable only.

fn drop(&mut self)

Executes the destructor for this type.

impl ErrorType for DedicatedGpioOutput<'_>

Available on crate feature unstable only.

type Error = Infallible

Error type

impl OutputPin for DedicatedGpioOutput<'_>

Available on crate feature unstable only.

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

Drives the pin low.

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

Drives the pin high.

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

Drives the pin high or low depending on the provided value.