lcddrive.h

T6963C接口的液晶屏(240*128点阵)底层驱动程序

/****************************************************************************************
* 文件名：LCDDRIVE.H
* 功能：LCD驱动程序，包括底层驱动，刷新显示子程序。
* 功能：图形液晶240*128驱动(型号为SMG240128A)。32K显示存，0000H-7FFFH地址。显示是横向字节，高位
*      在前。
* 说明：图形液晶采用T6963C为LCD控制芯片，内带负压产生器，单5伏供电，并行接口(使用LPC2210驱动)。
* 硬件连接： D0--D7  <===>  D0--D7
*           /WR     <===>  nWE
*           /RD     <===>  nOE
*           /CE     <===>  nCS3_1
*           C/D     <===>  A1
*
*           /RST    <===>  VCC
****************************************************************************************/
#ifndef  LCDDRIVE_H
#define  LCDDRIVE_H

// 定义颜色数据类型(可以是数据结构)
#define  TCOLOR				uint16

// 定义LCM像素数宏                 
#define  GUI_LCM_XMAX		240							/* 定义液晶x轴的点数 */
#define  GUI_LCM_YMAX		128	
						/* 定义液晶y轴的点数 */
// 设置颜色宏定义
#define   BLACK		0x0000      /* 黑色：    0,   0,   0 */
#define   NAVY		0x000F      /* 深蓝色：  0,   0, 128 */
#define   DGREEN	0x03E0		/* 深绿色：  0, 128,   0 */
#define   DCYAN		0x03EF		/* 深青色：  0, 128, 128 */
#define   MAROON	0x7800		/* 深红色：128,   0,   0 */
#define   PURPLE	0x780F		/* 紫色：  128,   0, 128 */
#define   OLIVE		0x7BE0 	    /* 橄榄绿：128, 128,   0 */
#define   LGRAY		0xC618	    /* 灰白色：192, 192, 192 */
#define   DGRAY		0x7BEF		/* 深灰色：128, 128, 128 */
#define   BLUE		0x001F		/* 蓝色：    0,   0, 255 */
#define   GREEN		0x07E0		/* 绿色：    0, 255,   0 */
#define   CYAN	    0x07FF 		/* 青色：    0, 255, 255 */
#define   RED		0xF800		/* 红色：  255,   0,   0 */
#define   MAGENTA	0xF81F		/* 品红：  255,   0, 255 */
#define   YELLOW	0xFFE0		/* 黄色：  255, 255, 0   */
#define   WHITE		0xFFFF      /* 白色：  255, 255, 255 */

// 定义清屏色
#define  GUI_CCOLOR         BLACK

// 液晶模块硬件操作宏
#define   LCD_WriteCommand(command)  TG240128_COM = (uint16)command
#define  LCD_WriteData(dat)  TG240128_DAT = (uint16)dat
#define  LCD_ReadState()	TG240128_COM
#define  LCD_ReadData()		TG240128_DAT

/* 以下为LCM的驱动层，主要负责发送T6963的各种命令，提供设置显示地址等功能，在发送命令前会检测其状态字。带参数命令模式：先参数，后命令；操作模式：先命令，后数据 */
/* T6963C 命令定义 */
#define  LCD_CUR_POS		0x21						/* 光标位置设置(只有设置到有效显示地址并打开显示时才看到) */
#define  LCD_CGR_POS		0x22						/* CGRAM偏置地址设置(可以增加自已的符号) */
#define  LCD_ADR_POS		0x24						/* 地址指针位置(设置读写操作指针) */

#define  LCD_TXT_STP		0x40						/* 文本区首址(从此地址开始向屏幕左上角显示字符) */
#define  LCD_TXT_WID		0x41						/* 文本区宽度(设置显示宽度，N/6或N/8，其中N为x轴的点数) */
#define  LCD_GRH_STP		0x42						/* 图形区首址(从此地址开始向屏幕左上角显示点) */
#define  LCD_GRH_WID		0x43						/* 图形区宽度(设置显示宽度，N/6或N/8，其中N为x轴的点数) */

#define  LCD_MOD_OR			0x80						/* 显示方式：逻辑或 */
#define  LCD_MOD_XOR		0x81						/* 显示方式：逻辑异或 */
#define  LCD_MOD_AND		0x82						/* 显示方式：逻辑与 */
#define  LCD_MOD_TCH		0x83						/* 显示方式：文本特征 */

#define  LCD_DIS_SW			0x90						/* 显示开关：D0=1/0，光标闪烁启用/禁用 */
														/* 			D1=1/0，光标显示启用/禁用 */
														/* 			D2=1/0，文本显示启用/禁用(打开后再使用) */
														/* 			D3=1/0，图形显示启用/禁用(打开后再使用) */
														
#define  LCD_CUR_SHP		0xA0						/* 光标形状选择：0xA0-0xA7表示光标占的行数 */

#define  LCD_AUT_WR			0xB0						/* 自动写设置 */
#define  LCD_AUT_RD			0xB1						/* 自动读设置 */
#define  LCD_AUT_OVR		0xB2						/* 自动读/写结束 */

#define  LCD_INC_WR			0xC0						/* 数据一次写，地址加1 */
#define  LCD_INC_RD			0xC1						/* 数据一次读，地址加1 */
#define  LCD_DEC_WR			0xC2						/* 数据一次写，地址减1 */
#define  LCD_DEC_RD			0xC3						/* 数据一次读，地址减1 */
#define  LCD_NOC_WR			0xC4						/* 数据一次写，地址不变 */
#define  LCD_NOC_RD			0xC5						/* 数据一次读，地址不变 */

#define  LCD_SCN_RD			0xE0						/* 屏读 */

#define  LCD_SCN_CP			0xE8						/* 屏拷贝 */

#define  LCD_BIT_OP			0xF0   					    /* 位操作：D0-D2--定义D0-D7位，D3--1为置位，0为清除 */

/* 定义LCM地址 */
#define  TG240128_COM    	(*((volatile unsigned short *) 0x83000002))
#define  TG240128_DAT    	(*((volatile unsigned short *) 0x83000000))

// 初始化数据结构定义
#define     DATA_END		0xFF00

// 定义初始化数据的结构
typedef  struct
{  uint16  com;				// 命令字
   uint16  dat;				// 数据
   uint16  dly;				// 命令延时控制(如50)

}  STCOM_INI;

/***********************************************************************
* 名称：LCD_FillAll()
* 功能：LCD填充。以图形方式进行填充，起始地址为0x0000。
* 入口参数：dat		要填充的数据
* 出口参数：无
***********************************************************************/
void  LCD_FillAll(uint8 dat);

/****************************************************************************
* 名称：LCD_UpdatePoint()
* 功能：在指定位置上画点，刷新某一点。
* 入口参数： x		指定点所在列的位置
*           y		指定点所在行的位置
* 出口参数：返回值为1时表示操作成功，为0时表示操作失败。
* 说明：操作失败原因是指定地址超出缓冲区范围。
****************************************************************************/
void  LCD_UpdatePoint(uint32 x, uint32 y);



/****************************************************************************
* 名称：GUI_Initialize()
* 功能：初始化GUI，包括初始化显示缓冲区，初始化LCM并清屏。
* 入口参数：无
* 出口参数：无
* 说明：用户根据LCM的实际情况编写此函数。
****************************************************************************/
extern void  GUI_Initialize(void);

/****************************************************************************
* 名称：GUI_FillSCR()
* 功能：全屏填充。直接使用数据填充显示缓冲区。
* 入口参数：dat		填充的数据
* 出口参数：无
* 说明：用户根据LCM的实际情况编写此函数。
****************************************************************************/
extern void  GUI_FillSCR(TCOLOR dat);

/****************************************************************************
* 名称：GUI_ClearSCR()
* 功能：清屏。
* 入口参数：无
* 出口参数：无
* 说明：用户根据LCM的实际情况编写此函数。
****************************************************************************/
extern void  GUI_ClearSCR(void);

/****************************************************************************
* 名称：GUI_Point()
* 功能：在指定位置上画点。
* 入口参数： x		指定点所在列的位置
*            y		指定点所在行的位置
*            color	显示颜色(对于黑白色LCM，为0时灭，为1时显示)
* 出口参数：返回值为1时表示操作成功，为0时表示操作失败。(操作失败原因是指定地址超出有
*          效范围)
* 说明：用户根据LCM的实际情况编写此函数。
****************************************************************************/
extern uint8  GUI_Point(uint32 x, uint32 y, TCOLOR color);

/****************************************************************************
* 名称：GUI_ReadPoint()
* 功能：读取指定点的颜色。
* 入口参数：x		指定点所在列的位置
*           y		指定点所在行的位置
*           ret     保存颜色值的指针
* 出口参数：返回0表示指定地址超出缓冲区范围
* 说明：对于单色，设置ret的d0位为1或0，4级灰度则为d0、d1有效，8位RGB则d0--d7有效，
*      RGB结构则R、G、B变量有效。
****************************************************************************/
extern uint8  GUI_ReadPoint(uint16 x, uint16 y, TCOLOR *ret);

/****************************************************************************
* 名称：GUI_HLine()
* 功能：画水平线。
* 入口参数： x0		水平线起点所在列的位置
*           y0		水平线起点所在行的位置
*           x1      水平线终点所在列的位置
*           color	显示颜色(对于黑白色LCM，为0时灭，为1时显示)
* 出口参数：无
* 说明：对于单色、4级灰度的液晶，可通过修改此函数作图提高速度，如单色LCM，可以一次更
*      新8个点，而不需要一个点一个点的写到LCM中。
****************************************************************************/
extern void  GUI_HLine(uint32 x0, uint32 y0, uint32 x1, uint8 color);

/****************************************************************************
* 名称：GUI_RLine()
* 功能：画垂直线。
* 入口参数： x0		垂直线起点所在列的位置
*           y0		垂直线起点所在行的位置
*           y1      垂直线终点所在行的位置
*           color	显示颜色
* 出口参数：无
* 说明：对于单色、4级灰度的液晶，可通过修改此函数作图提高速度，如单色LCM，可以一次更
*      新8个点，而不需要一个点一个点的写到LCM中。
****************************************************************************/
extern void  GUI_RLine(uint16 x0, uint16 y0, uint16 y1, TCOLOR color);

/****************************************************************************
* 名称：GUI_CmpColor()
* 功能：判断颜色值是否一致。
* 入口参数：color1		颜色值1
*		   color2		颜色值2
* 出口参数：返回1表示相同，返回0表示不相同。
* 说明：由于颜色类型TCOLOR可以是结构类型，所以需要用户编写比较函数。
****************************************************************************/
//extern int  GUI_CmpColor(TCOLOR color1, TCOLOR color2);
#define  GUI_CmpColor(color1, color2)	(color1 == color2)

/****************************************************************************
* 名称：GUI_CopyColor()
* 功能：颜色值复制。
* 入口参数：color1		目标颜色变量
*		   color2		源颜色变量
* 出口参数：无
* 说明：由于颜色类型TCOLOR可以是结构类型，所以需要用户编写复制函数。
****************************************************************************/
//extern void  GUI_CopyColor(TCOLOR *color1, TCOLOR color2);
#define  GUI_CopyColor(color1, color2) 	*color1 = color2

#endif