Struct ST7789 

pub struct ST7789<DI, RST, BL>
where
    DI: WriteOnlyDataCommand,
    RST: OutputPin,
    BL: OutputPin,
{ /* private fields */ }

ST7789 driver to connect to TFT displays.

Implementations

impl<DI, RST, BL, PinE> ST7789<DI, RST, BL>

where DI: WriteOnlyDataCommand, RST: OutputPin<Error = PinE>, BL: OutputPin<Error = PinE>,

pub fn new( di: DI, rst: Option<RST>, bl: Option<BL>, size_x: u16, size_y: u16, ) -> Self

Creates a new ST7789 driver instance

Arguments

• di - a display interface for talking with the display
• rst - display hard reset pin
• bl - backlight pin
• size_x - x axis resolution of the display in pixels
• size_y - y axis resolution of the display in pixels

pub fn set_offset(&mut self, offset_x: u16, offset_y: u16)

pub fn init( &mut self, delay_source: &mut impl DelayUs<u32>, ) -> Result<(), Error<PinE>>

Runs commands to initialize the display

Arguments

• delay_source - mutable reference to a delay provider

pub fn hard_reset( &mut self, delay_source: &mut impl DelayUs<u32>, ) -> Result<(), Error<PinE>>

Performs a hard reset using the RST pin sequence

Arguments

• delay_source - mutable reference to a delay provider

pub fn set_backlight( &mut self, state: BacklightState, delay_source: &mut impl DelayUs<u32>, ) -> Result<(), Error<PinE>>

pub fn orientation(&self) -> Orientation

Returns currently set orientation

pub fn set_orientation( &mut self, orientation: Orientation, ) -> Result<(), Error<PinE>>

Sets display orientation

pub fn set_pixel( &mut self, x: u16, y: u16, color: u16, ) -> Result<(), Error<PinE>>

Sets a pixel color at the given coords.

Arguments

• x - x coordinate
• y - y coordinate
• color - the Rgb565 color value

pub fn set_pixels<T>( &mut self, sx: u16, sy: u16, ex: u16, ey: u16, colors: T, ) -> Result<(), Error<PinE>>

where T: IntoIterator<Item = u16>,

Sets pixel colors in given rectangle bounds.

Arguments

• sx - x coordinate start
• sy - y coordinate start
• ex - x coordinate end
• ey - y coordinate end
• colors - anything that can provide IntoIterator<Item = u16> to iterate over pixel data

pub fn set_scroll_offset(&mut self, offset: u16) -> Result<(), Error<PinE>>

Sets scroll offset “shifting” the displayed picture

Arguments

• offset - scroll offset in pixels

pub fn release(self) -> (DI, Option<RST>, Option<BL>)

Release resources allocated to this driver back. This returns the display interface and the RST pin deconstructing the driver.

pub fn set_tearing_effect( &mut self, tearing_effect: TearingEffect, ) -> Result<(), Error<PinE>>

Configures the tearing effect output.

Trait Implementations

impl<DI, RST, BL, PinE> DrawTarget for ST7789<DI, RST, BL>

where DI: WriteOnlyDataCommand, RST: OutputPin<Error = PinE>, BL: OutputPin<Error = PinE>,

type Error = Error<PinE>

Error type to return when a drawing operation fails.

type Color = Rgb565

The pixel color type the targetted display supports.

fn draw_iter<T>(&mut self, item: T) -> Result<(), Self::Error>

where T: IntoIterator<Item = Pixel<Rgb565>>,

Draw individual pixels to the display without a defined order.

fn fill_contiguous<I>( &mut self, area: &Rectangle, colors: I, ) -> Result<(), Self::Error>

where I: IntoIterator<Item = Self::Color>,

Fill a given area with an iterator providing a contiguous stream of pixel colors.

fn fill_solid( &mut self, area: &Rectangle, color: Self::Color, ) -> Result<(), Self::Error>

Fill a given area with a solid color.

fn clear(&mut self, color: Rgb565) -> Result<(), Self::Error>

where Self: Sized,

Fill the entire display with a solid color.

impl<DI, RST, BL, PinE> OriginDimensions for ST7789<DI, RST, BL>

where DI: WriteOnlyDataCommand, RST: OutputPin<Error = PinE>, BL: OutputPin<Error = PinE>,

fn size(&self) -> Size

Returns the size of the bounding box.