11 releases (7 breaking)

0.8.0 May 24, 2024
0.7.1 May 24, 2023
0.6.0 Jan 12, 2023
0.5.0 Oct 19, 2022
0.1.0 Sep 9, 2021

#50 in Hardware support

Download history 1440/week @ 2024-07-04 1921/week @ 2024-07-11 1937/week @ 2024-07-18 2187/week @ 2024-07-25 1673/week @ 2024-08-01 2378/week @ 2024-08-08 1599/week @ 2024-08-15 1828/week @ 2024-08-22 1971/week @ 2024-08-29 2466/week @ 2024-09-05 1574/week @ 2024-09-12 1915/week @ 2024-09-19 1919/week @ 2024-09-26 1970/week @ 2024-10-03 1866/week @ 2024-10-10 2184/week @ 2024-10-17

8,258 downloads per month
Used in 3 crates

MIT license

120KB
2.5K SLoC

mipidsi

Crates.io Docs.rs Discuss driver on embedded-graphics on Matrix

This crate provides a generic display driver to connect to TFT displays that implement the MIPI Display Command Set.

Uses display_interface to talk to the hardware via transports (currently SPI, I2C and Parallel GPIO).

An optional batching of draws is supported via the batch feature (default on)

NOTES:

  • The name of this crate is a bit unfortunate as this driver works with displays that use the MIPI Display Command Set via any transport supported by display_interface but MIPI Display Serial Interface is NOT supported at this time.

License

Licensed under MIT license (LICENSE or http://opensource.org/licenses/MIT).

Architecture

The Display driver itself contains most of the functionality. Each specific display model implements the Model trait for every color format it supports. Each model can also have different variants which are handled via the Builder struct.

embedded-graphics-core is used to provide the drawing API.

Models

Each supported display model can be used either through the Builder::with_model call or through a shortcut function such as Builder::st7789 if provided. External crates can be used to provide additional models, and can even expand the display constructor pool via trait extension.

Variants that require different screen sizes and window addressing offsets are now supported via the Builder logic as well (see docs).

List of supported models

  • GC9A01
  • ILI9341
  • ILI9342C
  • ILI9486
  • ST7735
  • ST7789
  • ST7796

Migration

See MIGRATION.md document.

Troubleshooting

See TROUBLESHOOTING.md document.

Example

// create a DisplayInterface from SPI and DC pin, with no manual CS control
let di = SPIInterfaceNoCS::new(spi, dc);
// create the ILI9486 display driver in rgb666 color mode from the display interface and use a HW reset pin during init
let mut display = Builder::new(ILI9486Rgb666, di)
    .reset_pin(rst)
    .init(&mut delay)?; // delay provider from your MCU
// clear the display to black
display.clear(Rgb666::BLACK)?;

Minimum Supported Rust Version (MSRV)

This crate is guaranteed to compile on stable Rust 1.75.0 and up. It might compile with older versions but that may change in any new patch release.

Dependencies

~645KB
~11K SLoC