lvgl_esp32_drivers/lvgl_tft/il3820.h

126 lines
3.7 KiB
C
Raw Permalink Normal View History

/**
* @file il3820.h
*
*/
#ifndef IL3820_H
#define IL3820_H
#ifdef __cplusplus
extern "C"
{
#endif
#ifdef LV_LVGL_H_INCLUDE_SIMPLE
#include "lvgl.h"
#else
#include "lvgl/lvgl.h"
#endif
#include "sdkconfig.h"
/* Values for Waveshare 2.9inch e-Paper Module, this values shouldn't be
* swapped to change display orientation */
Update helpers and drivers to handle LVGLv7 and v8 versions (#161) * [lvgl_helpers] Cleanup and misc code cleanup Checks for SPI_HOST_MAX symbol before using it. Rename lvgl_driver_init to lvgl_interface_init because it now only initialize the interface bus for display drivers, we still need to remove the indev drivers from here. Use types defined in spi_types.h for spi host (spi_host_device_t) and spi dma channels (spi_dma_chan_t). Also add a couple of symbols to avoid using magic numbers * [lvgl_helpers] Reduce usage of if defined in lvgl_interface_init * [lvgl_helpers] Fix spi dma channel for ESP-IDF versions <= 4.2 * [examples] Update hello_world to call lvgl_interface_init * Add lvgl_get_display_buffer_size helper This helper will allow us to get the calculated display buffer size instead of using a global symbol. * Implement lvgl_get_display_buffer_size This API will be used to get the calculation of display buffer size. * Delete DISP_BUF_SIZE symbols The same functionality is handled by lvgl_get_display_buffer_size * Move SPI max transfer size calculation to helper Use calculate_spi_max_transfer_size to calculate the SPI max transfer size for the SPI master configuration * Remove SPI_BUS_MAX_TRANSFER_SZ definition Same functionality is now handled in calculate_spi_max_transfer_size * Update display buffer size calculation Use lvgl_get_display_buffer_size helper instead of DISP_BUF_SIZE symbol * Update example to LVGL v8 Add comments about changes from: - LVGL v7 to LVGL v8 - Configuration helpers and display drivers * Update lvgl_helpers.c * Update sh1107 driver * Update EVE driver Check for symbols used in previous implementations before trying to use them and add a fallback temporary implementation when not found. The falback implementation isn't tested with hardware. Symbols: - DISP_BUF_SIZE - SPI_TRANSFER_SIZE * Update uc8151d driver * Update jd79653a driver * Update ra8875 driver * Update il3820.h Check for LV_HOR_RES_MAX and LV_VER_RES_MAX before trying to use them * Update lvgl_helpers.c Check for ESP-IDF version before trying to use spi_dma_chan_t type
2022-01-07 23:22:11 +00:00
#if defined (LV_HOR_RES_MAX)
2021-01-09 21:04:53 +00:00
#define EPD_PANEL_WIDTH LV_HOR_RES_MAX /* 128 */
Update helpers and drivers to handle LVGLv7 and v8 versions (#161) * [lvgl_helpers] Cleanup and misc code cleanup Checks for SPI_HOST_MAX symbol before using it. Rename lvgl_driver_init to lvgl_interface_init because it now only initialize the interface bus for display drivers, we still need to remove the indev drivers from here. Use types defined in spi_types.h for spi host (spi_host_device_t) and spi dma channels (spi_dma_chan_t). Also add a couple of symbols to avoid using magic numbers * [lvgl_helpers] Reduce usage of if defined in lvgl_interface_init * [lvgl_helpers] Fix spi dma channel for ESP-IDF versions <= 4.2 * [examples] Update hello_world to call lvgl_interface_init * Add lvgl_get_display_buffer_size helper This helper will allow us to get the calculated display buffer size instead of using a global symbol. * Implement lvgl_get_display_buffer_size This API will be used to get the calculation of display buffer size. * Delete DISP_BUF_SIZE symbols The same functionality is handled by lvgl_get_display_buffer_size * Move SPI max transfer size calculation to helper Use calculate_spi_max_transfer_size to calculate the SPI max transfer size for the SPI master configuration * Remove SPI_BUS_MAX_TRANSFER_SZ definition Same functionality is now handled in calculate_spi_max_transfer_size * Update display buffer size calculation Use lvgl_get_display_buffer_size helper instead of DISP_BUF_SIZE symbol * Update example to LVGL v8 Add comments about changes from: - LVGL v7 to LVGL v8 - Configuration helpers and display drivers * Update lvgl_helpers.c * Update sh1107 driver * Update EVE driver Check for symbols used in previous implementations before trying to use them and add a fallback temporary implementation when not found. The falback implementation isn't tested with hardware. Symbols: - DISP_BUF_SIZE - SPI_TRANSFER_SIZE * Update uc8151d driver * Update jd79653a driver * Update ra8875 driver * Update il3820.h Check for LV_HOR_RES_MAX and LV_VER_RES_MAX before trying to use them * Update lvgl_helpers.c Check for ESP-IDF version before trying to use spi_dma_chan_t type
2022-01-07 23:22:11 +00:00
#else
/* Fallback to default value */
#define EPD_PANEL_WIDTH 128u
#endif
#if defined (LV_VER_RES_MAX)
2021-01-09 21:04:53 +00:00
#define EPD_PANEL_HEIGHT LV_VER_RES_MAX /* 296 */
Update helpers and drivers to handle LVGLv7 and v8 versions (#161) * [lvgl_helpers] Cleanup and misc code cleanup Checks for SPI_HOST_MAX symbol before using it. Rename lvgl_driver_init to lvgl_interface_init because it now only initialize the interface bus for display drivers, we still need to remove the indev drivers from here. Use types defined in spi_types.h for spi host (spi_host_device_t) and spi dma channels (spi_dma_chan_t). Also add a couple of symbols to avoid using magic numbers * [lvgl_helpers] Reduce usage of if defined in lvgl_interface_init * [lvgl_helpers] Fix spi dma channel for ESP-IDF versions <= 4.2 * [examples] Update hello_world to call lvgl_interface_init * Add lvgl_get_display_buffer_size helper This helper will allow us to get the calculated display buffer size instead of using a global symbol. * Implement lvgl_get_display_buffer_size This API will be used to get the calculation of display buffer size. * Delete DISP_BUF_SIZE symbols The same functionality is handled by lvgl_get_display_buffer_size * Move SPI max transfer size calculation to helper Use calculate_spi_max_transfer_size to calculate the SPI max transfer size for the SPI master configuration * Remove SPI_BUS_MAX_TRANSFER_SZ definition Same functionality is now handled in calculate_spi_max_transfer_size * Update display buffer size calculation Use lvgl_get_display_buffer_size helper instead of DISP_BUF_SIZE symbol * Update example to LVGL v8 Add comments about changes from: - LVGL v7 to LVGL v8 - Configuration helpers and display drivers * Update lvgl_helpers.c * Update sh1107 driver * Update EVE driver Check for symbols used in previous implementations before trying to use them and add a fallback temporary implementation when not found. The falback implementation isn't tested with hardware. Symbols: - DISP_BUF_SIZE - SPI_TRANSFER_SIZE * Update uc8151d driver * Update jd79653a driver * Update ra8875 driver * Update il3820.h Check for LV_HOR_RES_MAX and LV_VER_RES_MAX before trying to use them * Update lvgl_helpers.c Check for ESP-IDF version before trying to use spi_dma_chan_t type
2022-01-07 23:22:11 +00:00
#else
/* Fallback to default value */
#define EPD_PANEL_HEIGHT 296u
#endif
/* 128 = panel width */
#define IL3820_COLUMNS (EPD_PANEL_WIDTH / 8)
#define IL3820_DC_PIN CONFIG_LV_DISP_PIN_DC
#define IL3820_RST_PIN CONFIG_LV_DISP_PIN_RST
#define IL3820_USE_RST CONFIG_LV_DISP_USE_RST
#define IL3820_BUSY_PIN CONFIG_LV_DISP_PIN_BUSY
#define IL3820_BUSY_LEVEL 1
/* IL3820 commands */
#define IL3820_CMD_GDO_CTRL 0x01
#define IL3820_CMD_GDV_CTRL 0x03
#define IL3820_CMD_SDV_CTRL 0x04
#define IL3820_CMD_SOFTSTART 0x0c
#define IL3820_CMD_GSCAN_START 0x0f
#define IL3820_CMD_SLEEP_MODE 0x10
#define IL3820_CMD_ENTRY_MODE 0x11
#define IL3820_CMD_SW_RESET 0x12
#define IL3820_CMD_TSENS_CTRL 0x1a
#define IL3820_CMD_MASTER_ACTIVATION 0x20
#define IL3820_CMD_UPDATE_CTRL1 0x21
#define IL3820_CMD_UPDATE_CTRL2 0x22
#define IL3820_CMD_WRITE_RAM 0x24
#define IL3820_CMD_WRITE_RED_RAM 0x26
#define IL3820_CMD_VCOM_SENSE 0x28
#define IL3820_CMD_VCOM_SENSE_DURATON 0x29
#define IL3820_CMD_PRGM_VCOM_OTP 0x2a
#define IL3820_CMD_VCOM_VOLTAGE 0x2c
#define IL3820_CMD_PRGM_WS_OTP 0x30
#define IL3820_CMD_UPDATE_LUT 0x32
#define IL3820_CMD_PRGM_OTP_SELECTION 0x36
#define IL3820_CMD_OTP_SELECTION_CTRL 0x37
#define IL3820_CMD_DUMMY_LINE 0x3a
#define IL3820_CMD_GATE_LINE_WIDTH 0x3b
#define IL3820_CMD_BWF_CTRL 0x3c
#define IL3820_CMD_RAM_XPOS_CTRL 0x44
#define IL3820_CMD_RAM_YPOS_CTRL 0x45
#define IL3820_CMD_RAM_XPOS_CNTR 0x4e
#define IL3820_CMD_RAM_YPOS_CNTR 0x4f
#define IL3820_CMD_TERMINATE_FRAME_RW 0xff
/* Data entry sequence modes */
#define IL3820_DATA_ENTRY_MASK 0x07
#define IL3820_DATA_ENTRY_XDYDX 0x00
#define IL3820_DATA_ENTRY_XIYDX 0x01
#define IL3820_DATA_ENTRY_XDYIX 0x02
#define IL3820_DATA_ENTRY_XIYIX 0x03
#define IL3820_DATA_ENTRY_XDYDY 0x04
#define IL3820_DATA_ENTRY_XIYDY 0x05
#define IL3820_DATA_ENTRY_XDYIY 0x06
#define IL3820_DATA_ENTRY_XIYIY 0x07
/* Options for display update */
#define IL3820_CTRL1_INITIAL_UPDATE_LL 0x00
#define IL3820_CTRL1_INITIAL_UPDATE_LH 0x01
#define IL3820_CTRL1_INITIAL_UPDATE_HL 0x02
#define IL3820_CTRL1_INITIAL_UPDATE_HH 0x03
/* Options for display update sequence */
#define IL3820_CTRL2_ENABLE_CLK 0x80
#define IL3820_CTRL2_ENABLE_ANALOG 0x40
#define IL3820_CTRL2_TO_INITIAL 0x08
#define IL3820_CTRL2_TO_PATTERN 0x04
#define IL3820_CTRL2_DISABLE_ANALOG 0x02
#define IL3820_CTRL2_DISABLE_CLK 0x01
#define IL3820_SLEEP_MODE_DSM 0x01
#define IL3820_SLEEP_MODE_PON 0x00
/* time constants in ms */
#define IL3820_RESET_DELAY 20
#define IL3820_BUSY_DELAY 1
// normal wait time max 200ms
#define IL3820_WAIT 20
void il3820_init(void);
void il3820_flush(lv_disp_drv_t *drv, const lv_area_t *area, lv_color_t *color_map);
void il3820_fullflush(lv_disp_drv_t *drv, const lv_area_t *area, lv_color_t *color_map);
2021-02-28 23:18:25 +00:00
void il3820_rounder(lv_disp_drv_t * disp_drv, lv_area_t *area);
void il3820_set_px_cb(lv_disp_drv_t * disp_drv, uint8_t * buf, lv_coord_t buf_w, lv_coord_t x, lv_coord_t y, lv_color_t color, lv_opa_t opa);
void il3820_sleep_in(void);
#ifdef __cplusplus
} /* extern "C" */
#endif
#endif /* __IL3820_REGS_H__ */