Module dpi

Available on crate feature unstable only.

LCD - RGB/Digital Parallel Interface Mode

Overview

The LCD_CAM peripheral Dpi driver provides support for the DPI (commonly know as RGB) format/timing. The driver mandates DMA (Direct Memory Access) for efficient data transfer.

Examples

A display

The following example shows how to setup and send a solid frame to a DPI display.

let lcd_cam = LcdCam::new(peripherals.LCD_CAM);

let config = dpi::Config::default()
    .with_frequency(Rate::from_mhz(1))
    .with_clock_mode(ClockMode {
        polarity: Polarity::IdleLow,
        phase: Phase::ShiftLow,
    })
    .with_format(Format {
        enable_2byte_mode: true,
        ..Default::default()
    })
    .with_timing(FrameTiming {
        horizontal_active_width: 480,
        horizontal_total_width: 520,
        horizontal_blank_front_porch: 10,

        vertical_active_height: 480,
        vertical_total_height: 510,
        vertical_blank_front_porch: 10,

        hsync_width: 10,
        vsync_width: 10,

        hsync_position: 0,
    })
    .with_vsync_idle_level(Level::High)
    .with_hsync_idle_level(Level::High)
    .with_de_idle_level(Level::Low)
    .with_disable_black_region(false);

let mut dpi = Dpi::new(lcd_cam.lcd, channel, config)?
    .with_vsync(peripherals.GPIO3)
    .with_hsync(peripherals.GPIO46)
    .with_de(peripherals.GPIO17)
    .with_pclk(peripherals.GPIO9)
    // Blue
    .with_data0(peripherals.GPIO10)
    .with_data1(peripherals.GPIO11)
    .with_data2(peripherals.GPIO12)
    .with_data3(peripherals.GPIO13)
    .with_data4(peripherals.GPIO14)
    // Green
    .with_data5(peripherals.GPIO21)
    .with_data6(peripherals.GPIO8)
    .with_data7(peripherals.GPIO18)
    .with_data8(peripherals.GPIO45)
    .with_data9(peripherals.GPIO38)
    .with_data10(peripherals.GPIO39)
    // Red
    .with_data11(peripherals.GPIO40)
    .with_data12(peripherals.GPIO41)
    .with_data13(peripherals.GPIO42)
    .with_data14(peripherals.GPIO2)
    .with_data15(peripherals.GPIO1);

let color: u16 = 0b11111_000000_00000; // RED
for chunk in dma_buf.chunks_mut(2) {
    chunk.copy_from_slice(&color.to_le_bytes());
}

let transfer = dpi.send(false, dma_buf).map_err(|e| e.0)?;
transfer.wait();

Structs

• Config
  Configuration settings for the RGB/DPI interface.
• Dpi
  Represents the RGB LCD interface.
• DpiTransfer
  Represents an ongoing (or potentially finished) transfer using the RGB LCD interface
• Format
  Controls how the peripheral should treat data received from the DMA.
• FrameTiming
  The timing numbers for the driver to follow.

Enums

• ConfigError
  Errors that can occur when configuring the DPI peripheral.