/****************************************Copyright (c)**************************************************
**                               Guangzhou ZHIYUAN electronics Co.,LTD.
**                                     
**                                 http://www.zyinside.com
**
**--------------文件信息--------------------------------------------------------------------------------
**文   件   名: IntControl.h
**創   建   人: 李建明
**最后修改日期: 2006年8月23日
**描        述: 用戶中斷管理函數頭文件
**
**--------------當前版本修訂------------------------------------------------------------------------------
** 修改人: 李建明
** 日　期: 2006-08-23
** 描　述: 添加對中斷設置的權限，用戶只允許設置定時器1和外部中斷，
**		   試圖對其余的中斷向量進行設置將返回出錯
**
**--------------當前版本修訂------------------------------------------------------------------------------
** 修改人: 
** 日　期:
** 描　述: 
**
---------------------------------------------------------------------------------------------------------*/

#define	SelIntFIQ	0x01		// 選擇 FIQ 方式
#define SelIntIRQ	0x02		// 選擇 IRQ 方式

#define SETINTFORBID	0xFF	// 中斷設置被禁止

//- 操作返回值 -
#ifndef	OPERATE_SUCCESS
#define OPERATE_SUCCESS	0	// 操作成功
#endif

#ifndef	INT_ERR
#define INT_ERR	0			// 中斷操作參數錯誤
#endif

/*********************************************************************************************************
** 函數名稱：int32 SetIntStyle(int32 ch,int32 style)
** 函數功能：中斷類型設置;
** 入口參數：ch - 中斷號
**			 style - 中斷類型,FIQ or IRQ
**
** 出口參數：OPERATE_SUCCESS,操作成功
**			 <0 , 操作失敗
**
** 說    明：
********************************************************************************************************/
extern int32 SetIntStyle(int32 ch,int32 style);

/*********************************************************************************************************
** 函數名稱：int32 ClrIntFlag(int32 ch)
** 函數功能：清除中斷標志位;
** 入口參數：ch - 中斷號
**
** 出口參數：OPERATE_SUCCESS,操作成功
**			 <0 , 操作失敗
** 說    明：
********************************************************************************************************/
extern int32 ClrIntFlag(int32 ch);

/*******************************************************************************************************
** 函數名稱: int32 SetFIQinterrupt(uint32 ch,void *Function)
** 功能描述: 設置FIQ響應函數，使能相應中斷
** 輸　  入:
			 - ch,	中斷通道號
			 - Function,中斷服務程序（普通C語言函數） 
**
** 出口參數：OPERATE_SUCCESS,操作成功
**			 <0 , 操作失敗

** 作　  者: 李建明
** 日　  期: 2006年8月3日
********************************************************************************************************/
extern int32 SetFIQinterrupt(uint32 ch,void *Function);

/*******************************************************************************************************
** 函數名稱: int32 SetIRQinterrupt(uint32 ch,uint32 PRI,void *Function)
** 功能描述: 設置IRQ響應函數，使能相應中斷
** 輸　  入:
			 - ch,	中斷通道號
**         	 - PRI, 中斷優先級
			 - Function,中斷服務程序（普通C語言函數） 
**
** 出口參數：OPERATE_SUCCESS,操作成功
**			 <0 , 操作失敗

** 作　  者: 李建明
** 日　  期: 2006年8月3日
********************************************************************************************************/
extern int32 SetIRQinterrupt(uint32 ch,uint32 PRI,void *Function);

/*********************************************************************************************************
** 函數名稱：int32 EnableInt(int32 ch)
** 函數功能：使能對應中斷;
** 入口參數：ch - 中斷號
**
** 出口參數：OPERATE_SUCCESS,操作成功
**			 <0 , 操作失敗
** 說    明：
********************************************************************************************************/
extern int32 EnableInt(int32 ch);

/*********************************************************************************************************
** 函數名稱：int32 DisableInt(int32 ch)
** 函數功能：禁止對應中斷;
** 入口參數：ch - 中斷號
**
** 出口參數：OPERATE_SUCCESS,操作成功
**			 <0 , 操作失敗
** 說    明：
********************************************************************************************************/
extern int32 DisableInt(int32 ch);

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