sky-ili9341

Async-ready ILI9341 TFT display driver for embedded Rust.

Features

• Blocking and async SPI interfaces (embedded-hal 1.0 / embedded-hal-async)
• Builder pattern for flexible configuration (orientation, color order, inversion, offsets)
• Correct MADCTL implementation per ILI9341 datasheet — no hardcoded BGR
• Optimized drawing with 512-byte buffered SPI writes and fast rectangle fills
• embedded-graphics-core DrawTarget support (optional graphics feature)
• defmt logging support (optional defmt feature)
• Board presets Made for SkyRizz E32
• no_std — works on any embedded target (ESP32, nRF52, STM32, RP2040, etc.)

Cargo Features

Feature	Default	Description
graphics	✅	Enables embedded-graphics-core DrawTarget implementation
async	❌	Enables async interface, builder, and display types via embedded-hal-async
defmt	❌	Enables defmt::Format derives for error and option types

Quick Start

use sky_ili9341::{Builder, SpiInterface, Orientation, ColorOrder};

let di = SpiInterface::new(spi, dc);
let mut display = Builder::new(di)
    .orientation(Orientation::Landscape)
    .color_order(ColorOrder::Bgr)
    .init(&mut reset_pin, &mut delay)
    .unwrap();

display.clear_screen(0x0000).unwrap(); // Black

Board Presets

Skip manual configuration for popular boards:

use sky_ili9341::{Builder, SpiInterface, presets};

// SkyRizz E32 Board (primary reference board)
let di = SpiInterface::new(spi, dc);
let mut display = Builder::with_options(di, presets::skyrizz_e32())
    .init(&mut reset, &mut delay)
    .unwrap();

Available presets:

• skyrizz_e32() — SkyRizz E32 Board 2.4" 240×320 (primary reference board)
• esp_wrover_kit() — ESP-WROVER-KIT v4.1
• esp32_2432s028r() — "Cheap Yellow Display" (CYD) 2.8"
• m5stack() — M5Stack Core
• m5stack_core2() — M5Stack Core2
• esp32_s2_kaluga() — ESP32-S2-Kaluga-1
• generic_240x320() — Generic ILI9341 with default settings

Async (Embassy)

Enable the async feature for non-blocking SPI transfers — ideal for ESP32 with embassy where DMA runs in the background:

use sky_ili9341::{AsyncBuilder, AsyncSpiInterface, Orientation};

let di = AsyncSpiInterface::new(spi, dc);
let mut display = AsyncBuilder::new(di)
    .orientation(Orientation::Landscape)
    .init(&mut reset_pin, &mut delay)
    .await
    .unwrap();

display.clear_screen(0xF800).await.unwrap(); // Red

Using with embedded-graphics

The graphics feature (on by default) implements DrawTarget:

use embedded_graphics_core::prelude::*;
use embedded_graphics_core::pixelcolor::Rgb565;

display.clear(Rgb565::BLACK).unwrap();

Supported Targets

Any chip with embedded-hal 1.0 SPI support:

• ESP32 family (ESP32, ESP32-S2, ESP32-S3, ESP32-C3, ESP32-C6) via esp-hal
• nRF52 family (nRF52840, nRF52832) via nrf-hal or embassy-nrf
• STM32 family via stm32-hal or embassy-stm32
• RP2040/RP2350 via rp-hal or embassy-rp

License

Licensed under MIT License.