Struct st7789::ST7789

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

ST7789 driver to connect to TFT displays.

Implementations

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

pub fn new(di: DI, rst: RST, 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
• size_x - x axis resolution of the display in pixels
• size_y - y axis resolution of the display in pixels

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 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, RST)

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

Trait Implementations

impl<DI, RST, PinE> DrawTarget<Rgb565> for ST7789<DI, RST> where
    DI: WriteOnlyDataCommand,
    RST: OutputPin<Error = PinE>, 

type Error = Error<PinE>

Error type to return when a drawing operation fails.

fn draw_pixel(&mut self, pixel: Pixel<Rgb565>) -> Result<(), Self::Error>

Draws a pixel on the display.

fn draw_iter<T>(&mut self, item: T) -> Result<(), Self::Error> where
    T: IntoIterator<Item = Pixel<Rgb565>>, 

Draws an object from an iterator over its pixels.

fn draw_rectangle(
    &mut self,
    item: &Styled<Rectangle, PrimitiveStyle<Rgb565>>
) -> Result<(), Self::Error>

Draws a styled rectangle primitive.

fn draw_image<'a, 'b, I>(
    &mut self,
    item: &'a Image<'b, I, Rgb565>
) -> Result<(), Self::Error> where
    &'b I: IntoPixelIter<Rgb565>,
    I: ImageDimensions, 

Draws an image with known size

fn size(&self) -> Size

Returns the dimensions of the DrawTarget in pixels.

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

Clears the display with the supplied color.

fn draw_line(
    &mut self,
    item: &Styled<Line, PrimitiveStyle<C>>
) -> Result<(), Self::Error>

Draws a styled line primitive.

fn draw_triangle(
    &mut self,
    item: &Styled<Triangle, PrimitiveStyle<C>>
) -> Result<(), Self::Error>

Draws a styled triangle primitive.

fn draw_circle(
    &mut self,
    item: &Styled<Circle, PrimitiveStyle<C>>
) -> Result<(), Self::Error>

Draws a styled circle primitive.