/****************************************Copyright (c)**************************************************
**                               廣州周立功單片機發展有限公司
**                                     研    究    所
**                                        產品一部 
**
**                                 http://www.zlgmcu.com
**
**--------------文件信息--------------------------------------------------------------------------------
**文   件   名: HardDriverCtr.h
**創   建   人: 陳明計
**最后修改日期: 2004年4月23日
**描        述: PPP協議硬件層頭文件
**              
**--------------歷史版本信息----------------------------------------------------------------------------
** 創建人: 陳明計
** 版  本: 1.00
** 日　期: 2004年4月23日
** 描　述: 原始版本
**
**--------------當前版本修訂------------------------------------------------------------------------------
** 修改人: 
** 日　期: 
** 描　述: 
**
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/

#define NOT_INIT_NET_HARD   0x0001              /* 硬件初始化失敗     */
#define NOT_FIND_NET_HARD   0x0002              /* 未發現硬件        */
#define NET_HARD_CLOSE      0x0004              /* 硬件鏈接關閉      */
#define NET_HARD_RING       0x0008              /* 硬件發現振鈴信號   */
#define NET_HARD_OPEN       0x0010              /* 硬件鏈接已經被打開 */

#define NO_ERR          0                       /* 沒有錯誤 */
#define TIME_OUT        1                       /* 超時 */
#define NO_HARD         2                       /* 沒有硬件 */

typedef struct _NET_HARD_DRIVES_SOCKET          /* 硬件接口 */
{
    uint8       (* Putch)(char Data);
/*********************************************************************************************************
** 函數名稱: Putch
** 功能描述: 發送一個字節
** 輸　入: Data:發送的數據
** 輸　出: NO_ERR:沒有錯誤
**        TIME_OUT:超時
**        NO_HARD:沒有硬件
********************************************************************************************************/
    uint8       (* Getch)(uint8 *Rt);
/*********************************************************************************************************
** 函數名稱: Getch
** 功能描述: 接收一個字節
** 輸　入: Rt:字符指針，返回的數據存儲在這個指針指向的變量中
** 輸　出: NO_ERR:沒有錯誤
**        TIME_OUT:超時
**        NO_HARD:沒有硬件
********************************************************************************************************/
    uint8       (* Write)(uint8 *Buf, uint16 NByte);
/*********************************************************************************************************
** 函數名稱: Write
** 功能描述: 發送多個字節
** 輸　入: Buf:存儲健要發送的數據
**        NByte:將要發送的字節數目
** 輸　出: NO_ERR:沒有錯誤
**        TIME_OUT:超時
**        NO_HARD:沒有硬件
********************************************************************************************************/
    uint16      (* Read)(uint8 *Buf, uint16 NByte);
/*********************************************************************************************************
** 函數名稱: Read
** 功能描述: 發送多個字節
** 輸　入: Buf:存儲健要發送的數據
**        NByte:將要發送的字節數目
** 輸　出: NO_ERR:沒有錯誤
**        TIME_OUT:超時
**        NO_HARD:沒有硬件
********************************************************************************************************/
    uint16      (* GetReceiveNByte)(void);
/*********************************************************************************************************
** 函數名稱: GetReceiveNByte
** 功能描述: 獲取已經收到的字節數目
** 輸　入: 無
**
** 輸　出: 字節數目
********************************************************************************************************/
    uint8       (* Open)(void);
/*********************************************************************************************************
** 函數名稱: Open
** 功能描述: 建立硬件連接
** 輸　入: 無
**
** 輸　出: 無
********************************************************************************************************/
    uint8       (* Close)(void);
/*********************************************************************************************************
** 函數名稱: Close
** 功能描述: 關閉硬件連接
** 輸　入: 無
**
** 輸　出: 無
********************************************************************************************************/
    uint16      (* GetFlag)(void);
/*********************************************************************************************************
** 函數名稱: GetFlag
** 功能描述: 獲取硬件當前狀態
** 輸　入: 無
**
** 輸　出: NOT_INIT_NET_HARD   硬件初始化失敗
**        NOT_FIND_NET_HARD   未發現硬件
**        NET_HARD_CLOSE      硬件鏈接關閉
**        NET_HARD_RING       硬件發現振鈴信號
**        NET_HARD_OPEN       硬件鏈接已經被打開 
********************************************************************************************************/
    uint8       (* InputISRHook)(uint8 Data);
/*********************************************************************************************************
** 函數名稱: InputISRHook
** 功能描述: 由用戶接收中斷調用,當前無用
** 輸　入: 收到的數據
**
** 輸　出: NO_ERR:沒有錯誤
**        TIME_OUT:超時
**        NO_HARD:沒有硬件
********************************************************************************************************/
    uint8       (* ThisLayerUp)(void);
/*********************************************************************************************************
** 函數名稱: ThisLayerUp
** 功能描述: 當硬件連同時調用此函數
** 輸　入: 無
**
** 輸　出: 暫時沒有
**
**
********************************************************************************************************/
    uint8       (* ThisLayerDown)(void);
/*********************************************************************************************************
** 函數名稱: ThisLayerDown
** 功能描述: 由用戶掛斷連接時調用
** 輸　入: 無
**
** 輸　出: 暫時沒有
********************************************************************************************************/
}NetHardDrivesSocket;

/*********************************************************************************************************
**                            End Of File
********************************************************************************************************/