/****************************************Copyright (c)**************************************************
**                               廣州周立功單片機發展有限公司
**                                     研    究    所
**                                        產品一部 
**
**                                 http://www.zlgmcu.com
**
**--------------文件信息--------------------------------------------------------------------------------
**文   件   名: EMC.h
**創   建   人: 李建明
**最后修改日期: 2006年8月18日
**描        述: MiniARM外部存儲器控制器(EMC)底層驅動頭文件
**              
**--------------歷史版本信息----------------------------------------------------------------------------
** 創建人: 
** 版  本: 
** 日　期: 
** 描　述: 
**-------------------------------------------------------------------------------------------------------
** 修改人: 李建明
** 日　期: 2006/08/22
** 描　述: 添加讀寫等待周期控制
**
**--------------當前版本修訂------------------------------------------------------------------------------
** 修改人: 李建明
** 日　期: 2006/09/01
** 描　述: 添加讀、寫切換周期長度設置
**
**--------------歷史版本信息----------------------------------------------------------------------------
** 修改人: 李建明
** 版  本: 
** 日　期: 2007/03/02
** 描　述: 增加總線寬度檢查
**
**
*******************************************************************************************************/

#define EXBUSCFG_ERR	0x01		// 外部總線配置參數錯誤
#define EXBUSADRR_OV	0x02		// 外部總線地址溢出
#define	EXBUSWIDTH_ER	0x03		// 外部總線寬度不符		// add by LJM,2007/03/02

#ifndef	OPERATE_SUCCESS
#define OPERATE_SUCCESS	0x0			// 操作成功
#endif

/*********************************************************************************************************
** 函數名稱：	int32	ExBusConfig(uint8 bitw,uint8 rdlong,uint8 wrlong,uint8 idcy)
** 功能描述：	配置外部總線的位寬
** 輸　入: 		bitw =8, 配置成8位
**					 =16,配置成16位
**				rdlong , 設置讀等待周期(0~32)
**				wrlong , 設置寫等待周期(0~32)
**				idcy   , 設置讀、寫切換周期(0~16)
**
** 輸　出:		OPERATE_SUCCESS :成功
				-EXBUSCFG_ERR	:總線配置參數錯誤
** 說  明：	
********************************************************************************************************/
extern int32	ExBusConfig(uint8 bitw,uint8 rdlong,uint8 wrlong,uint8 idcy);

/*********************************************************************************************************
** 函數名稱：	int32	ExBusRD08(uint32 addr,uint32 n,uint8 *data)
** 功能描述：	從外部設備讀取 n 個8bit數據
** 輸　入: 		addr - 地址(0x000000~0xFFFFFF)
**				*data- 返回數據的存放地址
**				n    - 讀取的個數
**
** 輸　出:		OPERATE_SUCCESS :成功
				-EXBUSADRR_OV	:地址越界
** 說  明：	
********************************************************************************************************/
extern int32	ExBusRD08(uint32 addr,uint32 n,uint8 *data);

/*********************************************************************************************************
** 函數名稱：	int32	ExBusWR08(uint32 addr,uint32 n,uint8 *data)
** 功能描述：	向外部設備寫入 n 個8bit數據
** 輸　入: 		addr - 地址(0x000000~0xFFFFFF)
**				*data- 待寫數據的存放地址
**				n    - 讀取的個數
**
** 輸　出:		OPERATE_SUCCESS :成功
				-EXBUSADRR_OV	:地址越界
** 說  明：	
********************************************************************************************************/
extern int32	ExBusWR08(uint32 addr,uint32 n,uint8 *data);

/*********************************************************************************************************
** 函數名稱：	int32	ExBusRD016(uint32 addr,uint32 n,uint16 *data)
** 功能描述：	從外部設備讀取 n 個16bit數據
** 輸　入: 		addr - 地址(0x000000~0xFFFFFF)
**				*data- 返回數據的存放地址
**				n    - 讀取的個數
**
** 輸　出:		OPERATE_SUCCESS :成功
				-EXBUSADRR_OV	:地址越界
** 說  明：
********************************************************************************************************/
extern uint32	ExBusRD16(uint32 addr,uint32 n,uint16 *data);

/*********************************************************************************************************
** 函數名稱：	int32	ExBusWR16(uint32 addr,uint32 n,uint16 *data)
** 功能描述：	向外部設備寫入 n 個16bit數據
** 輸　入: 		addr - 地址(0x000000~0xFFFFFF)
**				*data- 待寫數據的存放地址
**				n    - 讀取的個數
**
** 輸　出:		OPERATE_SUCCESS :成功
				-EXBUSADRR_OV	:地址越界
** 說  明：	
********************************************************************************************************/
extern int32	ExBusWR16(uint32 addr,uint32 n,uint16 *data);

//**************************************    THE END    **************************************************/