ILI9486 driver for Rust

This crate contains a driver for the ILI9486 LCD controller.

See the full example for usage, or check out the documentation.

Usage

This crate is not yet published, but you can stil try it out.

Add the following to your Cargo.toml:

ili9486-driver = {git = "https://github.com/chrismoos/ili9486-driver", branch = "master"}

Tasks

GPIO 8-bit Parallel Interface
GPIO 16-bit Parallel Interface (Needs testing)
GPIO 18-bit Parallel Interface (Needs testing)
Serial Interface (3-wire)
Serial Interface (4-wire), (Needs testing)

I/O Pin

To facilitate both read and writes on the same pin, there is a local implementation of the IoPin concept in this crate, which will be eliminated later once this issue on embedded-hal is resolved.

For now, there is a shim, OutputOnlyIoPin that you can use to create an IoPin from a single OutputPin:

let pa5 = OutputOnlyIoPin::new(gpioa.pa5.into_push_pull_output(&mut gpioa.crl));

Devices

Tested on the following devices:

STM32F1xx

Benchmark

The Fill Screen benchmark draws a rectangle covering the whole screen with a solid color:

let mut start = elapsed_millis();
Rectangle::new(Point::new(0, 0), Point::new(320, 480))
    .into_styled(
        PrimitiveStyleBuilder::new()
            .fill_color(Rgb888::CYAN)
            .build(),
    )
    .draw(&mut lcd_driver)
    .unwrap();
let screen_fill_rect = elapsed_millis() - start;

Results

Device	Interface	Color Mode	Fill Screen (ms)	Pixel Rate/s
STM32F103RB (72Mhz)	GPIO 8-Bit	RGB 5-6-5	250ms	1,228,800

Example

Setup the LCD with the 8-bit parallel interface, and draw some text and an image. See this whole example here.

let parallel_gpio =
    GPIO8ParallelInterface::new(pa5, pa6, pa7, pa8, pa9, pa10, pc7, pb10, pb6, pb8, pb7, pb9)
        .unwrap();
let mut lcd_driver = ILI9486::new(&mut delay, PixelFormat::Rgb565, parallel_gpio, pb5).unwrap();

// reset
lcd_driver.write_command(0x01, &[]).unwrap();
lcd_driver.write_command(0x11, &[]).unwrap();

lcd_driver.write_command(0x20, &[]).unwrap();

// MADCTL settings
lcd_driver.write_command(0x36, &[0b10001000]).unwrap();

lcd_driver.clear_screen().unwrap();

// turn on display
lcd_driver.write_command(0x13, &[]).unwrap();
lcd_driver.write_command(0x29, &[]).unwrap();
lcd_driver.write_command(0x38, &[]).unwrap();

let t = Text::new("Hello Rust (and ILI9486 display)!", Point::new(64, 175))
    .into_styled(TextStyle::new(Font6x8, Rgb888::GREEN));

t.draw(&mut lcd_driver).unwrap();

let tga = Tga::from_slice(include_bytes!("../test/rust-rle-bw-topleft.tga")).unwrap();

let image: Image<Tga, Rgb888> = Image::new(
    &tga,
    Point::new(
        (320 / 2 - (tga.width() / 2)) as i32,
        ((350 / 2 - (tga.height() / 2)) + 64) as i32,
    ),
);

image.draw(&mut lcd_driver).unwrap();

SPI

An experimental 4-wire SPI interface is available, add the following to your Cargo.toml:

[dependencies.display-interface-spi]
git = "https://github.com/chrismoos/display-interface"
branch = "rw-interface"

See below or check out the full SPI example:

let mut gpiob = dp.GPIOB.split(&mut rcc.apb2);

let pins = (
    gpiob.pb13.into_alternate_push_pull(&mut gpiob.crh),
    gpiob.pb14.into_floating_input(&mut gpiob.crh),
    gpiob.pb15.into_alternate_push_pull(&mut gpiob.crh),
);

let cs = gpiob.pb10.into_push_pull_output(&mut gpiob.crh);
let dc = gpiob.pb9.into_push_pull_output(&mut gpiob.crh);
let rst = gpiob.pb8.into_push_pull_output(&mut gpiob.crh);

let spi_mode = Mode {
    polarity: Polarity::IdleLow,
    phase: Phase::CaptureOnFirstTransition,
};
let spi = Spi::spi2(dp.SPI2, pins, spi_mode, 100.khz(), clocks, &mut rcc.apb1);

let display_spi = SPIInterface::new(spi, dc, cs);

let mut lcd_driver = ILI9486::new(
    &mut delay,
    PixelFormat::Rgb565,
    display_spi,
    OutputOnlyIoPin::new(rst),
)
.unwrap();

Building examples

stm32f1xx

$  cargo build --example hello_world --features=examples,stm32f1xx,stm32f1xx-hal

stm32f4xx

$ cargo build --example stm32f4xx_hello_world --features=examples,stm32f4xx,stm32f4xx-hal,stm32f407 --target=thumbv7em-none-eabihf

License

This project uses the Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0).

adoble / ili9486-driver