Struct rppal::gpio::OutputPin

pub struct OutputPin { /* fields omitted */ }

GPIO pin configured as output.

OutputPins are constructed by converting a Pin using Pin::into_output. The pin's mode is automatically set to Output.

An OutputPin can be used to change a pin's output state.

The embedded-hal digital::OutputPin and PwmPin trait implementations for OutputPin can be enabled by specifying the optional hal feature in the dependency declaration for the rppal crate.

The unproven embedded-hal digital::InputPin, digital::StatefulOutputPin, digital::ToggleableOutputPin and Pwm trait implementations for OutputPin can be enabled by specifying the optional hal-unproven feature in the dependency declaration for the rppal crate.

Methods

impl OutputPin

pub fn pin(&self) -> u8

Returns the GPIO pin number.

Pins are addressed by their BCM numbers, rather than their physical location.

pub fn is_set_low(&self) -> bool

Returns true if the pin's output state is set to Low.

pub fn is_set_high(&self) -> bool

Returns true if the pin's output state is set to High.

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

Sets the pin's output state.

pub fn set_low(&mut self)

Sets the pin's output state to Low.

pub fn set_high(&mut self)

Sets the pin's output state to High.

pub fn toggle(&mut self)

Toggles the pin's output state between Low and High.

pub fn set_pwm(&mut self, period: Duration, pulse_width: Duration) -> Result<()>

Configures a software-based PWM signal.

period indicates the time it takes to complete one cycle.

pulse_width indicates the amount of time the PWM signal is active during a single period.

Software-based PWM is inherently inaccurate on a multi-threaded OS due to scheduling/preemption. If an accurate or faster PWM signal is required, use the hardware Pwm peripheral instead. More information can be found here.

If set_pwm is called when a PWM thread is already active, the existing thread will be reconfigured at the end of the current cycle.

pub fn set_pwm_frequency(
    &mut self,
    frequency: f64,
    duty_cycle: f64
) -> Result<()>

Configures a software-based PWM signal.

set_pwm_frequency is a convenience method that converts frequency to a period and duty_cycle to a pulse width, and then calls set_pwm.

frequency is specified in hertz (Hz).

duty_cycle is specified as a floating point value between 0.0 (0%) and 1.0 (100%).

pub fn clear_pwm(&mut self) -> Result<()>

Stops a previously configured software-based PWM signal.

The thread responsible for emulating the PWM signal is stopped at the end of the current cycle.

pub fn reset_on_drop(&self) -> bool

Returns the value of reset_on_drop.

pub fn set_reset_on_drop(&mut self, reset_on_drop: bool)

When enabled, resets the pin's mode to its original state and disables the built-in pull-up/pull-down resistors when the pin goes out of scope. By default, this is set to true.

Note

Drop methods aren't called when a process is abnormally terminated, for instance when a user presses Ctrl + C, and the SIGINT signal isn't caught. You can catch those using crates such as simple_signal.

Trait Implementations

impl Eq for OutputPin

impl PartialEq<OutputPin> for OutputPin

fn eq(&self, other: &OutputPin) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'a> PartialEq<&'a OutputPin> for OutputPin

fn eq(&self, other: &&'a OutputPin) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'a> PartialEq<OutputPin> for &'a OutputPin

fn eq(&self, other: &OutputPin) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl Drop for OutputPin

fn drop(&mut self)

Resets the pin's mode and disables the built-in pull-up/pull-down resistors if reset_on_drop is set to true (default).

impl Debug for OutputPin

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

Formats the value using the given formatter.

impl OutputPin for OutputPin

fn set_low(&mut self)

Drives the pin low

fn set_high(&mut self)

Drives the pin high

impl StatefulOutputPin for OutputPin

fn is_set_high(&self) -> bool

Is the pin in drive high mode?

fn is_set_low(&self) -> bool

Is the pin in drive low mode?

impl ToggleableOutputPin for OutputPin

fn toggle(&mut self)

Toggle pin output.

impl InputPin for OutputPin

fn is_high(&self) -> bool

Is the input pin high?

fn is_low(&self) -> bool

Is the input pin low?

impl PwmPin for OutputPin

type Duty = f64

Type for the duty methods

fn disable(&mut self)

Disables a PWM channel

fn enable(&mut self)

Enables a PWM channel

fn get_duty(&self) -> Self::Duty

Returns the current duty cycle

fn get_max_duty(&self) -> Self::Duty

Returns the maximum duty cycle value

fn set_duty(&mut self, duty: Self::Duty)

Sets a new duty cycle

impl Pwm for OutputPin

type Duty = f64

Type for the duty methods

type Channel = ()

Enumeration of channels that can be used with this Pwm interface

type Time = Duration

A time unit that can be converted into a human time unit (e.g. seconds)

fn disable(&mut self, _channel: Self::Channel)

Disables a PWM channel

fn enable(&mut self, _channel: Self::Channel)

Enables a PWM channel

fn get_period(&self) -> Self::Time

Returns the current PWM period

fn get_duty(&self, _channel: Self::Channel) -> Self::Duty

Returns the current duty cycle

fn get_max_duty(&self) -> Self::Duty

Returns the maximum duty cycle value

fn set_duty(&mut self, _channel: Self::Channel, duty: Self::Duty)

Sets a new duty cycle

fn set_period<P>(&mut self, period: P) where
    P: Into<Self::Time>, 

Sets a new PWM period