Struct microbit::display::nonblocking::Display

pub struct Display<T> where
    T: Instance,  { /* fields omitted */ }

Non-blocking interface to the on board 5x5 LED display

Implementations

impl<T> Display<T> where
    T: Instance, 

pub fn new(timer: T, pins: DisplayPins) -> Display<T>

Create and initialise the display driver

DisplayPins can be used from Board::display_pins or the display_pins! macro can be used is manually.

pub fn free(self) -> (T, DisplayPins)

Release the timer and pins

pub fn handle_display_event(&mut self)

Update the LED display and timer state

Call this in an interrupt handler for the timer you’re using. This method takes care of updating the LED display and clearing the timer’s event registers

This must be called from within a critical section.

pub fn show<R>(&mut self, image: &R) where
    R: Render, 

Show a new image

This must be called from within a critical section.

Example

display.show(&GreyscaleImage::new(&[
    [0, 7, 0, 7, 0],
    [7, 0, 7, 0, 7],
    [7, 0, 0, 0, 7],
    [0, 7, 0, 7, 0],
    [0, 0, 7, 0, 0],
]));

pub fn clear(&mut self)

Clear the display

This must be called from within a critical section.

pub fn show_frame(&mut self, frame: &MicrobitFrame)

Show a new frame

This is similar to show but accepts a MicrobitFrame instead. This may be useful if performance is a concern as calling set on the frame can be done outside the critical section.

This must be called from within a critical section.

Example

FRAME = MicrobitFrame::default();
FRAME.set(&GreyscaleImage::new(&[
    [0, 7, 0, 7, 0],
    [7, 0, 7, 0, 7],
    [7, 0, 0, 0, 7],
    [0, 7, 0, 7, 0],
    [0, 0, 7, 0, 0],
]));

// only this needs to be in a critical section
display.show_frame(&FRAME);