/**
 * @file tdd_disp_ili9341.h
 * @brief ILI9341 LCD display driver header file
 *
 * This file contains the register definitions, command definitions, and function
 * declarations for the ILI9341 LCD display controller. The ILI9341 is a 262,144-color
 * single-chip SOC driver for a TFT liquid crystal display with resolution of up to
 * 240x320, supporting parallel and serial peripheral interface (SPI).
 *
 * @copyright Copyright (c) 2021-2025 Tuya Inc. All Rights Reserved.
 *
 */

#ifndef __TDD_DISP_ILI9341_H__
#define __TDD_DISP_ILI9341_H__

#include "tuya_cloud_types.h"
#include "tdd_disp_type.h"

#ifdef __cplusplus
extern "C" {
#endif

/***********************************************************
************************macro define************************
***********************************************************/
/* ILI9341 commands */
#define ILI9341_NOP     0x00
#define ILI9341_SWRESET 0x01
#define ILI9341_RDDID   0x04
#define ILI9341_RDDST   0x09

#define ILI9341_RDDPM      0x0A // Read display power mode
#define ILI9341_RDD_MADCTL 0x0B // Read display MADCTL
#define ILI9341_RDD_COLMOD 0x0C // Read display pixel format
#define ILI9341_RDDIM      0x0D // Read display image mode
#define ILI9341_RDDSM      0x0E // Read display signal mode
#define ILI9341_RDDSR      0x0F // Read display self-diagnostic result (ILI9341)

#define ILI9341_SLPIN  0x10 // Enter Sleep Mode
#define ILI9341_SLPOUT 0x11 // Sleep out
#define ILI9341_PTLON  0x12
#define ILI9341_NORON  0x13

#define ILI9341_INVOFF  0x20
#define ILI9341_INVON   0x21
#define ILI9341_GAMSET  0x26 // Gamma set
#define ILI9341_DISPOFF 0x28
#define ILI9341_DISPON  0x29
#define ILI9341_CASET   0x2A // Column Address Set
#define ILI9341_RASET   0x2B // Row Address Set
#define ILI9341_RAMWR   0x2C
#define ILI9341_RGBSET  0x2D // Color setting for 4096, 64K and 262K colors
#define ILI9341_RAMRD   0x2E

#define ILI9341_PTLAR   0x30
#define ILI9341_VSCRDEF 0x33 // Vertical scrolling definition (ILI9341)
#define ILI9341_TEOFF   0x34 // Tearing effect line off
#define ILI9341_TEON    0x35 // Tearing effect line on
#define ILI9341_MADCTL  0x36 // Memory lcd_data access control
#define ILI9341_IDMOFF  0x38 // Idle mode off
#define ILI9341_IDMON   0x39 // Idle mode on
#define ILI9341_COLMOD  0x3A
#define ILI9341_RAMWRC  0x3C // Memory write continue (ILI9341)
#define ILI9341_RAMRDC  0x3E // Memory read continue (ILI9341)

#define ILI9341_RAMCTRL   0xB0 // RAM control
#define ILI9341_RGBCTRL   0xB1 // RGB control
#define ILI9341_PORCTRL   0xB2 // Porch control
#define ILI9341_FRCTRL1   0xB3 // Frame rate control
#define ILI9341_PARCTRL   0xB5 // Partial mode control
#define ILI9341_DSIPCTRL  0xB6 // Display Function Control
#define ILI9341_GCTRL     0xB7 // Gate control
#define ILI9341_GTADJ     0xB8 // Gate on timing adjustment
#define ILI9341_DGMEN     0xBA // Digital gamma enable
#define ILI9341_VCOMS     0xBB // VCOMS setting
#define ILI9341_LCMCTRL   0xC0 // LCM control
#define ILI9341_IDSET     0xC1 // ID setting
#define ILI9341_VDVVRHEN  0xC2 // VDV and VRH command enable
#define ILI9341_VRHS      0xC3 // VRH set
#define ILI9341_VDVSET    0xC4 // VDV setting
#define ILI9341_VCMOFSET  0xC5 // VCOMS offset set
#define ILI9341_FRCTR2    0xC6 // FR Control 2
#define ILI9341_CABCCTRL  0xC7 // CABC control
#define ILI9341_REGSEL1   0xC8 // Register value section 1
#define ILI9341_REGSEL2   0xCA // Register value section 2
#define ILI9341_PWMFRSEL  0xCC // PWM frequency selection
#define ILI9341_PWCTRL1   0xD0 // Power control 1
#define ILI9341_VAPVANEN  0xD2 // Enable VAP/VAN signal output
#define ILI9341_CMD2EN    0xDF // Command 2 enable
#define ILI9341_PVGAMCTRL 0xE0 // Positive voltage gamma control
#define ILI9341_NVGAMCTRL 0xE1 // Negative voltage gamma control
#define ILI9341_DGMLUTR   0xE2 // Digital gamma look-up table for red
#define ILI9341_DGMLUTB   0xE3 // Digital gamma look-up table for blue
#define ILI9341_GATECTRL  0xE4 // Gate control
#define ILI9341_SPI2EN    0xE7 // SPI2 enable
#define ILI9341_PWCTRL2   0xE8 // Power control 2
#define ILI9341_EQCTRL    0xE9 // Equalize time control
#define ILI9341_PROMCTRL  0xEC // Program control
#define ILI9341_PROMEN    0xFA // Program mode enable
#define ILI9341_NVMSET    0xFC // NVM setting
#define ILI9341_PROMACT   0xFE // Program action
/***********************************************************
***********************typedef define***********************
***********************************************************/

/***********************************************************
********************function declaration********************
***********************************************************/
/**
 * @brief Sets the initialization sequence for the ILI9341 display
 * 
 * @param init_seq Pointer to the initialization sequence array
 * 
 * @return OPERATE_RET Returns OPRT_OK on success, or OPRT_INVALID_PARM if init_seq is NULL
 */
OPERATE_RET tdd_disp_spi_ili9341_set_init_seq(const uint8_t *init_seq);

/**
 * @brief Registers an ILI9341 TFT display device using the SPI interface with the display management system.
 *
 * This function configures and registers a display device for the ILI9341 series of TFT LCDs 
 * using the SPI communication protocol. It copies configuration parameters from the provided 
 * device configuration and uses a predefined initialization sequence specific to ILI9341.
 *
 * @param name Name of the display device (used for identification).
 * @param dev_cfg Pointer to the SPI device configuration structure.
 *
 * @return Returns OPRT_OK on success, or an appropriate error code if registration fails.
 */
OPERATE_RET tdd_disp_spi_ili9341_register(char *name, DISP_SPI_DEVICE_CFG_T *dev_cfg);

#ifdef __cplusplus
}
#endif

#endif /* __TDD_DISP_ILI9341_H__ */