zlg7290.h

键盘与LED驱动芯片ZLG7290的c51驱动程序

/******************************************************************************

	ZLG7290.h
	数码管显示与键盘管理芯片ZLG7290的标准80C51驱动程序头文件
	Copyright (c) 2006，SHP,JYL,CZH
    2007-01-02

*******************************************************************************/

#ifndef _ZLG7290_H_
#define _ZLG7290_H_

#define  uchar unsigned char      /*宏定义*/
#define  uint  unsigned int

/******************************************************************************

  定义ZLG7290在I2C总线协议中的从机地址，这是7位纯地址，
  不含读写位。0x70 >> 1 ---> 0x38

*******************************************************************************/
#define ZLG7290_I2C_ADDR        0x38

/******************************************************************************

   定义ZLG7290内部寄存器地址（子地址）


*******************************************************************************/
#define ZLG7290_SystemReg		0x00		/* 系统寄存器         */
#define ZLG7290_Key			    0x01		/* 键值寄存器         */
#define ZLG7290_RepeatCnt		0x02		/* 连击次数寄存器     */
#define ZLG7290_FunctionKey		0x03		/* 功能键寄存器       */
#define ZLG7290_CmdBuf			0x07		/* 命令缓冲区起始地址 */
#define ZLG7290_CmdBuf0			0x07		/* 命令缓冲区0        */
#define ZLG7290_CmdBuf1			0x08		/* 命令缓冲区1        */
#define ZLG7290_FlashOnOff		0x0C		/* 闪烁控制寄存器     */
#define ZLG7290_ScanNum			0x0D		/* 扫描位数寄存器     */
#define ZLG7290_DpRam			0x10		/* 显示缓存起始地址   */
#define ZLG7290_DpRam0			0x10		/* 显示缓存0          */
#define ZLG7290_DpRam1			0x11		/* 显示缓存1          */
#define ZLG7290_DpRam2			0x12		/* 显示缓存2          */
#define ZLG7290_DpRam3			0x13		/* 显示缓存3          */
#define ZLG7290_DpRam4			0x14		/* 显示缓存4          */
#define ZLG7290_DpRam5			0x15		/* 显示缓存5          */
#define ZLG7290_DpRam6			0x16		/* 显示缓存6          */
#define ZLG7290_DpRam7			0x17		/* 显示缓存7          */


/** 说明：C语言规定，如果在定义函数时省略关键词“extern”，则隐含为外部函数 **/
/******************************************************************************
函数： ZLG7290_WriteReg()
功能： 向ZLG7290的某个内部寄存器写入数据
参数： RegAddr：ZLG7290的内部寄存器地址
       dat：    要写入的数据
返回： 0：正常
       1：访问ZLG7290时出现异常
*******************************************************************************/
extern bit ZLG7290_WriteReg(uchar RegAddr, uchar dat);

/******************************************************************************
函数： ZLG7290_ReadReg()
功能： 从ZLG7290的某个内部寄存器读出数据
参数： RegAddr：ZLG7290的内部寄存器地址
       *dat：   保存读出的数据
返回： 0：正常
       1：访问ZLG7290时出现异常
*******************************************************************************/
extern bit ZLG7290_ReadReg(uchar RegAddr, uchar *dat);

/******************************************************************************
函数： ZLG7290_cmd()
功能： 向ZLG7290发送控制命令
参数： cmd0：写入CmdBuf0寄存器的命令字（第1字节）
       cmd1：写入CmdBuf1寄存器的命令字（第2字节）
返回： 0：正常
       1：访问ZLG7290时出现异常
*******************************************************************************/
extern bit ZLG7290_cmd(uchar cmd0, uchar cmd1);

/******************************************************************************
函数： ZLG7290_SegOnOff()
功能： 段寻址，单独点亮或熄灭数码管（或LED）中的某一段
参数： seg：取值0～63，表示数码管（或LED）的段号
       b：  0表示熄灭，1表示点亮
返回： 0：正常
       1：访问ZLG7290时出现异常

说明： 在每一位数码管中，段号顺序按照“a,b,c,d,e,f,g,dp”进行
*******************************************************************************/
/*extern bit ZLG7290_SegOnOff(uchar seg, bit b);*/

/******************************************************************************
函数： ZLG7290_Download()
功能： 下载数据并译码
参数： addr： 取值0～7，显示缓存DpRam0～DpRam7的编号
       dp：   是否点亮该位的小数点，0－熄灭，1－点亮
       flash：控制该位是否闪烁，0－不闪烁，1－闪烁
       dat：  取值0～31，表示要显示的数据
返回： 0：正常
       1：访问ZLG7290时出现异常

说明： 显示数据具体的译码方式请参见ZLG7290的数据手册
*******************************************************************************/
extern bit ZLG7290_Download(uchar addr, bit dp, bit flash, uchar dat);

/******************************************************************************
  闪烁控制指令（Fn应当是字节型）
  Fn的8个位分别控制数码管的8个位是否闪烁，0－不闪烁，1－闪烁
*******************************************************************************/
#define ZLG7290_Flash(Fn) 	ZLG7290_cmd(0x70,(Fn))

#endif  /*_ZLG7290_H_*/

/************************************** end ***********************************/