Struct rppal::gpio::OutputPin

pub struct OutputPin { /* private fields */ }

GPIO pin configured as output.

OutputPins are constructed by converting a Pin using Pin::into_output, Pin::into_output_low or Pin::into_output_high. The pin’s mode is automatically set to Mode::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.

Implementations

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 Debug for OutputPin

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

Formats the value using the given formatter.

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 ErrorType for OutputPin

ErrorType trait implementation for embedded-hal v1.0.0.

type Error = Infallible

Error type

impl InputPin for OutputPin

InputPin trait implementation for embedded-hal v1.0.0.

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 InputPin for OutputPin

Unproven InputPin trait implementation for embedded-hal v0.2.7.

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 OutputPin for OutputPin

OutputPin trait implementation for embedded-hal v1.0.0.

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.

impl OutputPin for OutputPin

OutputPin trait implementation for embedded-hal v0.2.7.

type Error = Infallible

Error type

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

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 ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

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 ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

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 ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Pwm for OutputPin

Unproven Pwm trait implementation for embedded-hal v0.2.7.

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.

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)

impl PwmPin for OutputPin

PwmPin trait implementation for embedded-hal v0.2.7.

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 StatefulOutputPin for OutputPin

Unproven StatefulOutputPin trait implementation for embedded-hal v0.2.7.

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 StatefulOutputPin for OutputPin

StatefulOutputPin trait implementation for embedded-hal v1.0.0.

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 ToggleableOutputPin for OutputPin

ToggleableOutputPin trait implementation for embedded-hal v1.0.0.

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

Toggle pin output.

impl ToggleableOutputPin for OutputPin

Unproven ToggleableOutputPin trait implementation for embedded-hal v0.2.7.

type Error = Infallible

Error type

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

Toggle pin output.

impl Eq for OutputPin