92 lines
4.5 KiB
C
92 lines
4.5 KiB
C
#ifndef __ESP_LCD_PANEL_IO_I80_HUB75_H__
|
|
#define __ESP_LCD_PANEL_IO_I80_HUB75_H__
|
|
|
|
#include "esp_lcd_panel_io.h"
|
|
|
|
typedef struct esp_lcd_i80_hub75_bus_t *esp_lcd_i80_hub75_bus_handle_t; /*!< Type of LCD intel 8080 bus handle */
|
|
|
|
/**
|
|
* @brief LCD Intel 8080 hub75 bus configuration structure
|
|
*/
|
|
typedef struct {
|
|
int dc_gpio_num; /*!< GPIO used for D/C line */
|
|
int wr_gpio_num; /*!< GPIO used for WR line */
|
|
lcd_clock_source_t clk_src; /*!< Clock source for the I80 LCD peripheral */
|
|
int data_gpio_nums[SOC_LCD_I80_BUS_WIDTH]; /*!< GPIOs used for data lines */
|
|
size_t bus_width; /*!< Number of data lines, 8 or 16 */
|
|
size_t psram_trans_align; /*!< DMA transfer alignment for data allocated from PSRAM */
|
|
size_t sram_trans_align; /*!< DMA transfer alignment for data allocated from SRAM */
|
|
|
|
int max_scan_times; // 每页行最多扫描次数，和全彩显示有关系
|
|
int max_scan_line; // 最多扫描行
|
|
int max_transfer_bytes; // 最多一次发送的数据，也就是一行的数据个数
|
|
} esp_lcd_i80_hub75_bus_config_t;
|
|
|
|
/**
|
|
* @brief Create Intel 8080 bus handle
|
|
*
|
|
* @param[in] bus_config Bus configuration
|
|
* @param[out] ret_bus Returned bus handle
|
|
* @return
|
|
* - ESP_ERR_INVALID_ARG if parameter is invalid
|
|
* - ESP_ERR_NO_MEM if out of memory
|
|
* - ESP_ERR_NOT_FOUND if no free bus is available
|
|
* - ESP_OK on success
|
|
*/
|
|
esp_err_t esp_lcd_new_i80_hub75_bus(const esp_lcd_i80_hub75_bus_config_t *bus_config, esp_lcd_i80_hub75_bus_handle_t *ret_bus);
|
|
|
|
/**
|
|
* @brief Destroy Intel 8080 bus handle
|
|
*
|
|
* @param[in] bus Intel 8080 bus handle, created by `esp_lcd_new_i80_bus()`
|
|
* @return
|
|
* - ESP_ERR_INVALID_ARG if parameter is invalid
|
|
* - ESP_ERR_INVALID_STATE if there still be some device attached to the bus
|
|
* - ESP_OK on success
|
|
*/
|
|
esp_err_t esp_lcd_del_i80_hub75_bus(esp_lcd_i80_hub75_bus_handle_t bus);
|
|
|
|
/**
|
|
* @brief Panel IO configuration structure, for intel 8080 interface
|
|
*/
|
|
typedef struct {
|
|
int cs_gpio_num; /*!< GPIO used for CS line, set to -1 will declaim exclusively use of I80 bus */
|
|
uint32_t pclk_hz; /*!< Frequency of pixel clock */
|
|
size_t trans_queue_depth; /*!< Transaction queue size, larger queue, higher throughput */
|
|
esp_lcd_panel_io_color_trans_done_cb_t on_color_trans_done; /*!< Callback invoked when color data was transferred done */
|
|
void *user_ctx; /*!< User private data, passed directly to on_color_trans_done's user_ctx */
|
|
int lcd_cmd_bits; /*!< Bit-width of LCD command */
|
|
int lcd_param_bits; /*!< Bit-width of LCD parameter */
|
|
struct {
|
|
unsigned int dc_idle_level: 1; /*!< Level of DC line in IDLE phase */
|
|
unsigned int dc_cmd_level: 1; /*!< Level of DC line in CMD phase */
|
|
unsigned int dc_dummy_level: 1; /*!< Level of DC line in DUMMY phase */
|
|
unsigned int dc_data_level: 1; /*!< Level of DC line in DATA phase */
|
|
} dc_levels; /*!< Each i80 device might have its own D/C control logic */
|
|
struct {
|
|
unsigned int cs_active_high: 1; /*!< If set, a high level of CS line will select the device, otherwise, CS line is low level active */
|
|
unsigned int reverse_color_bits: 1; /*!< Reverse the data bits, D[N:0] -> D[0:N] */
|
|
unsigned int swap_color_bytes: 1; /*!< Swap adjacent two color bytes */
|
|
unsigned int pclk_active_neg: 1; /*!< The display will write data lines when there's a falling edge on WR signal (a.k.a the PCLK) */
|
|
unsigned int pclk_idle_low: 1; /*!< The WR signal (a.k.a the PCLK) stays at low level in IDLE phase */
|
|
} flags; /*!< Panel IO config flags */
|
|
} esp_lcd_panel_io_i80_hub75_config_t;
|
|
|
|
/**
|
|
* @brief Create LCD panel IO, for Intel 8080 interface
|
|
*
|
|
* @param[in] bus Intel 8080 bus handle, created by `esp_lcd_new_i80_bus()`
|
|
* @param[in] io_config IO configuration, for i80 interface
|
|
* @param[out] ret_io Returned panel IO handle
|
|
* @return
|
|
* - ESP_ERR_INVALID_ARG if parameter is invalid
|
|
* - ESP_ERR_NOT_SUPPORTED if some configuration can't be satisfied, e.g. pixel clock out of the range
|
|
* - ESP_ERR_NO_MEM if out of memory
|
|
* - ESP_OK on success
|
|
*/
|
|
esp_err_t esp_lcd_new_panel_io_i80_hub75(esp_lcd_i80_hub75_bus_handle_t bus, const esp_lcd_panel_io_i80_hub75_config_t *io_config, esp_lcd_panel_io_handle_t *ret_io);
|
|
|
|
void hub75_send_line(esp_lcd_panel_io_handle_t io, int times, int line);
|
|
void test_init_buf(esp_lcd_i80_hub75_bus_handle_t bus);
|
|
|
|
#endif |