210 lines
		
	
	
		
			7.7 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			210 lines
		
	
	
		
			7.7 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/*****************************************************************************
 | 
						|
* | File      	:   EPD_IT8951.h
 | 
						|
* | Author      :   Waveshare team
 | 
						|
* | Function    :   IT8951 Common driver
 | 
						|
* | Info        :
 | 
						|
*----------------
 | 
						|
* |	This version:   V1.0
 | 
						|
* | Date        :   2019-09-17
 | 
						|
* | Info        :
 | 
						|
* -----------------------------------------------------------------------------
 | 
						|
#
 | 
						|
# Permission is hereby granted, free of charge, to any person obtaining a copy
 | 
						|
# of this software and associated documnetation files (the "Software"), to deal
 | 
						|
# in the Software without restriction, including without limitation the rights
 | 
						|
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 | 
						|
# copies of the Software, and to permit persons to  whom the Software is
 | 
						|
# furished to do so, subject to the following conditions:
 | 
						|
#
 | 
						|
# The above copyright notice and this permission notice shall be included in
 | 
						|
# all copies or substantial portions of the Software.
 | 
						|
#
 | 
						|
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 | 
						|
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 | 
						|
# FITNESS OR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 | 
						|
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 | 
						|
# LIABILITY WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 | 
						|
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 | 
						|
# THE SOFTWARE.
 | 
						|
#
 | 
						|
******************************************************************************/
 | 
						|
#ifndef __EPD_IT8951_H_
 | 
						|
#define __EPD_IT8951_H_
 | 
						|
 | 
						|
#include <stdbool.h>
 | 
						|
 | 
						|
#include "../Config/DEV_Config.h"
 | 
						|
 | 
						|
 | 
						|
// INIT mode, for every init or some time after A2 mode refresh
 | 
						|
extern UBYTE INIT_Mode;
 | 
						|
// GC16 mode, for every time to display 16 grayscale image
 | 
						|
extern UBYTE GC16_Mode;
 | 
						|
// A2 mode, for fast refresh without flash
 | 
						|
extern UBYTE A2_Mode;
 | 
						|
 | 
						|
 | 
						|
typedef struct IT8951_Load_Img_Info
 | 
						|
{
 | 
						|
    UWORD    Endian_Type;         //little or Big Endian
 | 
						|
    UWORD    Pixel_Format;        //bpp
 | 
						|
    UWORD    Rotate;              //Rotate mode
 | 
						|
    UDOUBLE  Source_Buffer_Addr;  //Start address of source Frame buffer
 | 
						|
    UDOUBLE  Target_Memory_Addr;  //Base address of target image buffer
 | 
						|
}IT8951_Load_Img_Info;
 | 
						|
 | 
						|
typedef struct IT8951_Area_Img_Info
 | 
						|
{
 | 
						|
    UWORD Area_X;
 | 
						|
    UWORD Area_Y;
 | 
						|
    UWORD Area_W;
 | 
						|
    UWORD Area_H;
 | 
						|
}IT8951_Area_Img_Info;
 | 
						|
 | 
						|
typedef struct IT8951_Dev_Info
 | 
						|
{
 | 
						|
    UWORD Panel_W;
 | 
						|
    UWORD Panel_H;
 | 
						|
    UWORD Memory_Addr_L;
 | 
						|
    UWORD Memory_Addr_H;
 | 
						|
    UWORD FW_Version[8];
 | 
						|
    UWORD LUT_Version[8];
 | 
						|
}IT8951_Dev_Info;
 | 
						|
 | 
						|
/*-----------------------------------------------------------------------
 | 
						|
IT8951 Command defines
 | 
						|
------------------------------------------------------------------------*/
 | 
						|
 | 
						|
//Built in I80 Command Code
 | 
						|
#define IT8951_TCON_SYS_RUN      0x0001
 | 
						|
#define IT8951_TCON_STANDBY      0x0002
 | 
						|
#define IT8951_TCON_SLEEP        0x0003
 | 
						|
#define IT8951_TCON_REG_RD       0x0010
 | 
						|
#define IT8951_TCON_REG_WR       0x0011
 | 
						|
 | 
						|
#define IT8951_TCON_MEM_BST_RD_T 0x0012
 | 
						|
#define IT8951_TCON_MEM_BST_RD_S 0x0013
 | 
						|
#define IT8951_TCON_MEM_BST_WR   0x0014
 | 
						|
#define IT8951_TCON_MEM_BST_END  0x0015
 | 
						|
 | 
						|
#define IT8951_TCON_LD_IMG       0x0020
 | 
						|
#define IT8951_TCON_LD_IMG_AREA  0x0021
 | 
						|
#define IT8951_TCON_LD_IMG_END   0x0022
 | 
						|
 | 
						|
//I80 User defined command code
 | 
						|
#define USDEF_I80_CMD_DPY_AREA     0x0034
 | 
						|
#define USDEF_I80_CMD_GET_DEV_INFO 0x0302
 | 
						|
#define USDEF_I80_CMD_DPY_BUF_AREA 0x0037
 | 
						|
#define USDEF_I80_CMD_VCOM		   0x0039
 | 
						|
 | 
						|
/*-----------------------------------------------------------------------
 | 
						|
 IT8951 Mode defines
 | 
						|
------------------------------------------------------------------------*/
 | 
						|
 | 
						|
//Rotate mode
 | 
						|
#define IT8951_ROTATE_0     0
 | 
						|
#define IT8951_ROTATE_90    1
 | 
						|
#define IT8951_ROTATE_180   2
 | 
						|
#define IT8951_ROTATE_270   3
 | 
						|
 | 
						|
//Pixel mode (Bit per Pixel)
 | 
						|
#define IT8951_2BPP   0
 | 
						|
#define IT8951_3BPP   1
 | 
						|
#define IT8951_4BPP   2
 | 
						|
#define IT8951_8BPP   3
 | 
						|
 | 
						|
//Endian Type
 | 
						|
#define IT8951_LDIMG_L_ENDIAN   0
 | 
						|
#define IT8951_LDIMG_B_ENDIAN   1
 | 
						|
 | 
						|
/*-----------------------------------------------------------------------
 | 
						|
IT8951 Registers defines
 | 
						|
------------------------------------------------------------------------*/
 | 
						|
//Register Base Address
 | 
						|
#define DISPLAY_REG_BASE 0x1000               //Register RW access
 | 
						|
 | 
						|
//Base Address of Basic LUT Registers
 | 
						|
#define LUT0EWHR  (DISPLAY_REG_BASE + 0x00)   //LUT0 Engine Width Height Reg
 | 
						|
#define LUT0XYR   (DISPLAY_REG_BASE + 0x40)   //LUT0 XY Reg
 | 
						|
#define LUT0BADDR (DISPLAY_REG_BASE + 0x80)   //LUT0 Base Address Reg
 | 
						|
#define LUT0MFN   (DISPLAY_REG_BASE + 0xC0)   //LUT0 Mode and Frame number Reg
 | 
						|
#define LUT01AF   (DISPLAY_REG_BASE + 0x114)  //LUT0 and LUT1 Active Flag Reg
 | 
						|
 | 
						|
//Update Parameter Setting Register
 | 
						|
#define UP0SR     (DISPLAY_REG_BASE + 0x134)  //Update Parameter0 Setting Reg
 | 
						|
#define UP1SR     (DISPLAY_REG_BASE + 0x138)  //Update Parameter1 Setting Reg
 | 
						|
#define LUT0ABFRV (DISPLAY_REG_BASE + 0x13C)  //LUT0 Alpha blend and Fill rectangle Value
 | 
						|
#define UPBBADDR  (DISPLAY_REG_BASE + 0x17C)  //Update Buffer Base Address
 | 
						|
#define LUT0IMXY  (DISPLAY_REG_BASE + 0x180)  //LUT0 Image buffer X/Y offset Reg
 | 
						|
#define LUTAFSR   (DISPLAY_REG_BASE + 0x224)  //LUT Status Reg (status of All LUT Engines)
 | 
						|
#define BGVR      (DISPLAY_REG_BASE + 0x250)  //Bitmap (1bpp) image color table
 | 
						|
 | 
						|
//System Registers
 | 
						|
#define SYS_REG_BASE 0x0000
 | 
						|
 | 
						|
//Address of System Registers
 | 
						|
#define I80CPCR (SYS_REG_BASE + 0x04)
 | 
						|
 | 
						|
//Memory Converter Registers
 | 
						|
#define MCSR_BASE_ADDR 0x0200
 | 
						|
#define MCSR  (MCSR_BASE_ADDR + 0x0000)
 | 
						|
#define LISAR (MCSR_BASE_ADDR + 0x0008)
 | 
						|
 | 
						|
 | 
						|
/*
 | 
						|
void EPD_IT8951_SystemRun();
 | 
						|
void EPD_IT8951_Standby();
 | 
						|
void EPD_IT8951_Sleep();
 | 
						|
 | 
						|
UWORD EPD_IT8951_ReadReg(UWORD Reg_Address);
 | 
						|
void EPD_IT8951_WriteReg(UWORD Reg_Address,UWORD Reg_Value);
 | 
						|
UWORD EPD_IT8951_GetVCOM(void);
 | 
						|
void EPD_IT8951_SetVCOM(UWORD VCOM);
 | 
						|
 | 
						|
void EPD_IT8951_LoadImgStart( IT8951_Load_Img_Info* Load_Img_Info );
 | 
						|
void EPD_IT8951_LoadImgAreaStart( IT8951_Load_Img_Info* Load_Img_Info, IT8951_Area_Img_Info* Area_Img_Info );
 | 
						|
void EPD_IT8951_LoadImgEnd(void);
 | 
						|
 | 
						|
void EPD_IT8951_GetSystemInfo(void* Buf);
 | 
						|
void EPD_IT8951_SetTargetMemoryAddr(UDOUBLE Target_Memory_Addr);
 | 
						|
void EPD_IT8951_WaitForDisplayReady(void);
 | 
						|
 | 
						|
 | 
						|
void EPD_IT8951_HostAreaPackedPixelWrite_8bp(IT8951_Load_Img_Info*Load_Img_Info,IT8951_Area_Img_Info*Area_Img_Info);
 | 
						|
 | 
						|
void EPD_IT8951_HostAreaPackedPixelWrite_1bp(IT8951_Load_Img_Info*Load_Img_Info,IT8951_Area_Img_Info*Area_Img_Info, bool Packed_Write);
 | 
						|
 | 
						|
void EPD_IT8951_HostAreaPackedPixelWrite_2bp(IT8951_Load_Img_Info*Load_Img_Info,IT8951_Area_Img_Info*Area_Img_Info, bool Packed_Write);
 | 
						|
 | 
						|
void EPD_IT8951_Display_Area(UWORD X,UWORD Y,UWORD W,UWORD H,UWORD Mode);
 | 
						|
void EPD_IT8951_Display_AreaBuf(UWORD X,UWORD Y,UWORD W,UWORD H,UWORD Mode, UDOUBLE Target_Memory_Addr);
 | 
						|
 | 
						|
void EPD_IT8951_Display_1bp(UWORD X, UWORD Y, UWORD W, UWORD H, UWORD Mode,UDOUBLE Target_Memory_Addr, UBYTE Front_Gray_Val, UBYTE Back_Gray_Val);
 | 
						|
*/
 | 
						|
 | 
						|
void Enhance_Driving_Capability(void);
 | 
						|
 | 
						|
void EPD_IT8951_SystemRun(void);
 | 
						|
 | 
						|
void EPD_IT8951_Standby(void);
 | 
						|
 | 
						|
void EPD_IT8951_Sleep(void);
 | 
						|
 | 
						|
IT8951_Dev_Info EPD_IT8951_Init(UWORD VCOM);
 | 
						|
 | 
						|
void EPD_IT8951_Clear_Refresh(IT8951_Dev_Info Dev_Info,UDOUBLE Target_Memory_Addr, UWORD Mode);
 | 
						|
 | 
						|
void EPD_IT8951_1bp_Refresh(UBYTE* Frame_Buf, UWORD X, UWORD Y, UWORD W, UWORD H, UBYTE Mode, UDOUBLE Target_Memory_Addr, bool Packed_Write);
 | 
						|
void EPD_IT8951_1bp_Multi_Frame_Write(UBYTE* Frame_Buf, UWORD X, UWORD Y, UWORD W, UWORD H,UDOUBLE Target_Memory_Addr, bool Packed_Write);
 | 
						|
void EPD_IT8951_1bp_Multi_Frame_Refresh(UWORD X, UWORD Y, UWORD W, UWORD H,UDOUBLE Target_Memory_Addr);
 | 
						|
 | 
						|
void EPD_IT8951_2bp_Refresh(UBYTE* Frame_Buf, UWORD X, UWORD Y, UWORD W, UWORD H, bool Hold, UDOUBLE Target_Memory_Addr, bool Packed_Write);
 | 
						|
 | 
						|
void EPD_IT8951_4bp_Refresh(UBYTE* Frame_Buf, UWORD X, UWORD Y, UWORD W, UWORD H, bool Hold, UDOUBLE Target_Memory_Addr, bool Packed_Write);
 | 
						|
 | 
						|
void EPD_IT8951_8bp_Refresh(UBYTE *Frame_Buf, UWORD X, UWORD Y, UWORD W, UWORD H, bool Hold, UDOUBLE Target_Memory_Addr);
 | 
						|
 | 
						|
 | 
						|
 | 
						|
#endif
 |