Struct TM1637

pub struct TM1637<const N: usize, T, CLK, DIO, DELAY> { /* private fields */ }

TM1637 7-segment display driver.

Type parameters

• N: Number of positions on the display. 4 or 6.
• T: Operating mode. Async or Blocking.
• CLK: Clock.
• DIO: Data input/output.
• DELAY: Delay provider.

Implementations

impl<const N: usize, CLK, DIO, DELAY, ERR> TM1637<N, Async, CLK, DIO, DELAY>

where CLK: OutputPin<Error = ERR>, DIO: OutputPin<Error = ERR> + ConditionalInputPin<ERR>, DELAY: DelayNs,

pub async fn init(&mut self) -> Result<(), Error<ERR>>

Initialize the display.

Clear the display and set the brightness level.

pub async fn on(&mut self) -> Result<(), Error<ERR>>

Turn the display on.

pub async fn off(&mut self) -> Result<(), Error<ERR>>

Turn the display off.

pub async fn clear(&mut self) -> Result<(), Error<ERR>>

Clear the display.

pub async fn set_brightness( &mut self, brightness: Brightness, ) -> Result<(), Error<ERR>>

Set TM1637::brightness and write the brightness level to the display.

pub async fn display( &mut self, position: usize, bytes: impl Iterator<Item = u8>, ) -> Result<(), Error<ERR>>

Write the given bytes to the display starting from position.

Brightness level will not be written to the device on each call. Make sure to call TM1637::set_brightness or TM1637::init to set the brightness level.

pub async fn display_slice( &mut self, position: usize, bytes: &[u8], ) -> Result<(), Error<ERR>>

Write the given bytes slice to the display starting from position.

See TM1637::display.

pub fn options( &mut self, ) -> DisplayOptions<'_, N, Async, CLK, DIO, DELAY, impl DoubleEndedIterator<Item = u8> + ExactSizeIterator, NotFlipped>

High-level API for static or animated display operations.

Example

Scroll the text “Error” with a dot on the first position from right to left with a delay of 700ms.

use tm1637_embedded_hal::{mock::Noop, options::{ScrollDirection, ScrollStyle}, TM1637Builder};

let mut tm = TM1637Builder::new(Noop, Noop, Noop).build_blocking::<4>();

tm.options()
    .str("Error")
    .dot(1)
    .scroll()
    .delay_ms(700)
    .direction(ScrollDirection::RightToLeft)
    .style(ScrollStyle::Circular)
    .finish()
    .run();

pub fn circles( &mut self, ) -> CirclesDisplayOptions<'_, N, Async, CLK, DIO, DELAY>

High-level API for animated circles (loading spinner).

impl<const N: usize, CLK, DIO, DELAY, ERR> TM1637<N, Blocking, CLK, DIO, DELAY>

where CLK: OutputPin<Error = ERR>, DIO: OutputPin<Error = ERR> + ConditionalInputPin<ERR>, DELAY: DelayNs,

pub fn init(&mut self) -> Result<(), Error<ERR>>

Initialize the display.

Clear the display and set the brightness level.

pub fn on(&mut self) -> Result<(), Error<ERR>>

Turn the display on.

pub fn off(&mut self) -> Result<(), Error<ERR>>

Turn the display off.

pub fn clear(&mut self) -> Result<(), Error<ERR>>

Clear the display.

pub fn set_brightness( &mut self, brightness: Brightness, ) -> Result<(), Error<ERR>>

Set TM1637::brightness and write the brightness level to the display.

pub fn display( &mut self, position: usize, bytes: impl Iterator<Item = u8>, ) -> Result<(), Error<ERR>>

Write the given bytes to the display starting from position.

Brightness level will not be written to the device on each call. Make sure to call TM1637::set_brightness or TM1637::init to set the brightness level.

pub fn display_slice( &mut self, position: usize, bytes: &[u8], ) -> Result<(), Error<ERR>>

Write the given bytes slice to the display starting from position.

See TM1637::display.

pub fn options( &mut self, ) -> DisplayOptions<'_, N, Blocking, CLK, DIO, DELAY, impl DoubleEndedIterator<Item = u8> + ExactSizeIterator, NotFlipped>

High-level API for static or animated display operations.

Example

Scroll the text “Error” with a dot on the first position from right to left with a delay of 700ms.

use tm1637_embedded_hal::{mock::Noop, options::{ScrollDirection, ScrollStyle}, TM1637Builder};

let mut tm = TM1637Builder::new(Noop, Noop, Noop).build_blocking::<4>();

tm.options()
    .str("Error")
    .dot(1)
    .scroll()
    .delay_ms(700)
    .direction(ScrollDirection::RightToLeft)
    .style(ScrollStyle::Circular)
    .finish()
    .run();

pub fn circles( &mut self, ) -> CirclesDisplayOptions<'_, N, Blocking, CLK, DIO, DELAY>

High-level API for animated circles (loading spinner).

impl<const N: usize, T, CLK, DIO, DELAY> TM1637<N, T, CLK, DIO, DELAY>

pub const fn new( clk: CLK, dio: DIO, delay: DELAY, brightness: Brightness, delay_us: u32, ) -> Self

Create a new TM1637 instance.

pub const fn builder( clk: CLK, dio: DIO, delay: DELAY, ) -> TM1637Builder<CLK, DIO, DELAY>

Create a new TM1637Builder instance.

See TM1637Builder::new for default values.

pub const fn num_positions(&self) -> usize

Get the number of positions on the display.

pub const fn brightness(&self) -> Brightness

Get the brightness level.

pub const fn delay_us(&self) -> u32

Get the delay in microseconds.

pub const fn clk(&self) -> &CLK

Get a reference to the clock pin.

pub fn clk_mut(&mut self) -> &mut CLK

Get a mutable reference to the clock pin.

pub const fn dio(&self) -> &DIO

Get a reference to the data input/output pin.

pub fn dio_mut(&mut self) -> &mut DIO

Get a mutable reference to the data input/output pin.

pub const fn delay(&self) -> &DELAY

Get a reference to the delay provider.

pub fn delay_mut(&mut self) -> &mut DELAY

Get a mutable reference to the delay provider.

pub fn into_parts(self) -> (CLK, DIO, DELAY)

Split the TM1637 instance into its parts.

Trait Implementations

impl<const N: usize, T: Clone, CLK: Clone, DIO: Clone, DELAY: Clone> Clone for TM1637<N, T, CLK, DIO, DELAY>

fn clone(&self) -> TM1637<N, T, CLK, DIO, DELAY>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<const N: usize, T: Debug, CLK: Debug, DIO: Debug, DELAY: Debug> Debug for TM1637<N, T, CLK, DIO, DELAY>

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

Formats the value using the given formatter.

impl<const N: usize, T, CLK, DIO, DELAY> Format for TM1637<N, T, CLK, DIO, DELAY>

where CLK: Format, DIO: Format, DELAY: Format, Brightness: Format, PhantomData<T>: Format,

fn format(&self, f: Formatter<'_>)

Writes the defmt representation of self to fmt.