Ken Van Hoeylandt
111 lines
3.6 KiB
C
111 lines
3.6 KiB
C
// SPDX-License-Identifier: Apache-2.0
|
|
#pragma once
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
|
|
#include <tactility/device.h>
|
|
#include <tactility/drivers/gpio.h>
|
|
|
|
struct St7701Config {
|
|
uint16_t horizontal_resolution;
|
|
uint16_t vertical_resolution;
|
|
|
|
uint32_t pixel_clock_hz;
|
|
uint32_t hsync_pulse_width;
|
|
uint32_t hsync_back_porch;
|
|
uint32_t hsync_front_porch;
|
|
uint32_t vsync_pulse_width;
|
|
uint32_t vsync_back_porch;
|
|
uint32_t vsync_front_porch;
|
|
bool hsync_idle_low;
|
|
bool vsync_idle_low;
|
|
bool de_idle_high;
|
|
bool pclk_active_neg;
|
|
bool pclk_idle_high;
|
|
|
|
// Number of parallel data lines actually wired (8 or 16). Only the first data_width
|
|
// pin-dataN fields below are used; the rest are ignored.
|
|
uint8_t data_width;
|
|
// Color depth in bpp (16, 18 or 24). Passed to both the RGB timing config and the ST7701
|
|
// vendor config, which uses it to pick its MADCTL/COLMOD bring-up values.
|
|
uint8_t bits_per_pixel;
|
|
// Number of screen-sized frame buffers the driver allocates (0 or 1 = single-buffered).
|
|
uint8_t num_fbs;
|
|
// Non-zero enables the DRAM bounce-buffer DMA path, sized in pixels.
|
|
uint32_t bounce_buffer_size_px;
|
|
uint32_t sram_trans_align;
|
|
uint32_t psram_trans_align;
|
|
|
|
struct GpioPinSpec pin_hsync;
|
|
struct GpioPinSpec pin_vsync;
|
|
struct GpioPinSpec pin_de;
|
|
struct GpioPinSpec pin_pclk;
|
|
// Optional display-enable control pin, GPIO_PIN_SPEC_NONE if unused.
|
|
struct GpioPinSpec pin_disp;
|
|
|
|
struct GpioPinSpec pin_data0;
|
|
struct GpioPinSpec pin_data1;
|
|
struct GpioPinSpec pin_data2;
|
|
struct GpioPinSpec pin_data3;
|
|
struct GpioPinSpec pin_data4;
|
|
struct GpioPinSpec pin_data5;
|
|
struct GpioPinSpec pin_data6;
|
|
struct GpioPinSpec pin_data7;
|
|
struct GpioPinSpec pin_data8;
|
|
struct GpioPinSpec pin_data9;
|
|
struct GpioPinSpec pin_data10;
|
|
struct GpioPinSpec pin_data11;
|
|
struct GpioPinSpec pin_data12;
|
|
struct GpioPinSpec pin_data13;
|
|
struct GpioPinSpec pin_data14;
|
|
struct GpioPinSpec pin_data15;
|
|
|
|
bool disp_active_low;
|
|
bool refresh_on_demand;
|
|
bool fb_in_psram;
|
|
bool double_fb;
|
|
bool no_fb;
|
|
bool bb_invalidate_cache;
|
|
|
|
bool swap_xy;
|
|
bool mirror_x;
|
|
bool mirror_y;
|
|
bool invert_color;
|
|
|
|
// Bit-banged 3-wire command bus (CS/SCL/SDA over plain GPIOs) used to push the vendor
|
|
// bring-up sequence and, depending on flags below, runtime commands. Separate from the
|
|
// RGB pixel bus above - the ST7701 has no MISO line in 3-wire mode.
|
|
struct GpioPinSpec pin_cs;
|
|
struct GpioPinSpec pin_scl;
|
|
struct GpioPinSpec pin_sda;
|
|
bool scl_active_edge;
|
|
|
|
// Optional hardware reset pin for the panel. GPIO_PIN_SPEC_NONE falls back to a software
|
|
// reset sent over the 3-wire bus (see esp_lcd_st7701's panel_st7701_reset()).
|
|
struct GpioPinSpec pin_reset;
|
|
|
|
// See the 'mirror-by-cmd' and 'auto-del-panel-io' binding properties.
|
|
bool mirror_by_cmd;
|
|
bool auto_del_panel_io;
|
|
|
|
// Custom vendor init sequence, flattened as bytes: a run of
|
|
// [cmd, data_len, delay_ms, data_len bytes of data...] entries. NULL/0 falls back to the
|
|
// ST7701 component's own built-in default sequence (see vendor_specific_init_default in
|
|
// esp_lcd_st7701_rgb.c) - not guaranteed to match any particular panel's actual bring-up
|
|
// requirements, so most boards should supply their own via this property.
|
|
const uint8_t* init_sequence;
|
|
uint32_t init_sequence_length;
|
|
|
|
// Optional reference to this display's backlight device, NULL if none.
|
|
struct Device* backlight;
|
|
};
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|