esp-bsp 0.4.1

Rust Bare Metal Board Support Packages for ESP32 related boards with focus on Embassy Async
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

/// Generic Custom Board Support
/// This part is in concept stage and does not work
pub struct CustomBoardConfig {
    pub spi_sck: u8,       // GPIO pin for SPI SCK
    pub spi_mosi: u8,      // GPIO pin for SPI MOSI
    pub spi_cs: u8,        // GPIO pin for SPI CS
    pub lcd_dc: u8,        // GPIO pin for LCD DC
    pub lcd_reset: u8,     // GPIO pin for LCD Reset
    pub backlight: Option<u8>, // Optional GPIO for backlight
    pub i2c_sda: u8,       // GPIO pin for I2C SDA
    pub i2c_scl: u8,       // GPIO pin for I2C SCL
}

/// Macro for creating SPI instance for custom boards
#[macro_export]
macro_rules! lcd_spi {
    ($peripherals:ident, $config:expr) => {{
        let dma = Dma::new($peripherals.DMA);
        let dma_channel = dma.channel0;

        Spi::new_with_config(
            $peripherals.SPI2,
            esp_hal::spi::master::Config {
                frequency: 40u32.MHz(),
                ..esp_hal::spi::master::Config::default()
            },
        )
        .with_sck($peripherals.gpio[$config.spi_sck])
        .with_mosi($peripherals.gpio[$config.spi_mosi])
        .with_cs($peripherals.gpio[$config.spi_cs])
        .with_dma(dma_channel.configure(false, DmaPriority::Priority0))
    }};
}

/// Macro for creating Display Interface for custom boards
#[macro_export]
macro_rules! lcd_display_interface {
    ($peripherals:ident, $spi:expr, $config:expr) => {{
        let lcd_dc = Output::new($peripherals.gpio[$config.lcd_dc], Level::Low);
        display_interface_spi_dma::new_no_cs(LCD_MEMORY_SIZE, $spi, lcd_dc)
    }};
}

/// Macro for creating Display with Custom Configuration
#[macro_export]
macro_rules! lcd_display {
    ($peripherals:ident, $di:expr, $config:expr, $model:expr, $width:expr, $height:expr, $orientation:expr, $color_order:expr) => {{
        let lcd_reset = Output::new($peripherals.gpio[$config.lcd_reset], Level::Low);

        mipidsi::Builder::new($model, $di)
            .display_size($width, $height)
            .orientation($orientation)
            .color_order($color_order)
            .reset_pin(lcd_reset)
    }};
}

/// Macro for initializing I2C
#[macro_export]
macro_rules! i2c_init {
    ($peripherals:ident, $config:expr) => {{
        I2c::new($peripherals.I2C0, esp_hal::i2c::master::Config::default())
            .with_sda($peripherals.gpio[$config.i2c_sda])
            .with_scl($peripherals.gpio[$config.i2c_scl])
    }};
}

/// Macro for initializing LCD backlight
#[macro_export]
macro_rules! lcd_backlight {
    ($peripherals:ident, $config:expr) => {{
        if let Some(backlight_pin) = $config.backlight {
            let mut backlight = Output::new($peripherals.gpio[backlight_pin], Level::Low);
            backlight.set_high();
            Some(backlight)
        } else {
            None
        }
    }};
}

pub use {
    i2c_init, lcd_display, lcd_display_interface, lcd_backlight,
    lcd_spi,
};