/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
* Copyright (C), 2005, TopBond Tech. Co., Ltd.
* File name:       GPRS.H
* Module name:     GPRS自動(dòng)撥號(hào)上網(wǎng)模塊
* Author/Date:     WuHuan  06/02/14 
* Version:         Ver 1.0
* Description:     GPRS自動(dòng)撥號(hào)上網(wǎng)系列函數(shù)的頭文件
* Others:          如有改動(dòng)，請(qǐng)?jiān)谙旅娴臍v史記錄登記，謝謝合作!

------------------History-----------------------------
* Modifier/Date:    //修訂人及修訂日期
* Modify Reason:    //修訂原因
* Modification:     //修訂的內(nèi)容和位置的簡(jiǎn)要說(shuō)明
------------------------------------------------------
* Modifier/Date:    //修訂人及修訂日期
* Modify Reason:    //修訂原因
* Modification:     //修訂的內(nèi)容和位置的簡(jiǎn)要說(shuō)明
------------------------------------------------------
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
#if !defined( _GPRS_H )
#define _GPRS_H

enum PPPGPRSState { POWERON=0, PPPINIT, ATE0, ATCGATT, ATCGATT_1,
		    ATCGDCONT, ATD99, PPPLINK, PPPLINKUP, PPPTERM };

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
**
**  函    數(shù) ：PPP_Running( );
**  
**  功能描述 ：實(shí)現(xiàn)GPRS自動(dòng)撥號(hào)上網(wǎng)，不斷調(diào)用該函數(shù)，可保證GPRS一直在線；
**  
**  參    數(shù) ：無(wú)；
**    
**  返 回 值 ：返回進(jìn)行GPRS撥號(hào)上網(wǎng)狀態(tài)；
**    
**      0    ： GPRS模塊上電操作； 
**      1    ： 初始化PPP網(wǎng)絡(luò)相關(guān)參數(shù)；
**      2    ： 發(fā)送“ATE0”指令操作；
**      3    ： 發(fā)送“AT+CGATT?”指令，用于檢查模塊是否附著到GPRS網(wǎng)絡(luò)；
**      4    ： 發(fā)送“AT+CGATT=1”指令，用于設(shè)置模塊附著到GPRS網(wǎng)絡(luò)；
**      5    ： 發(fā)送“AT+CGDCONT=1,"IP","CMNET "”，設(shè)置GPRS通訊參數(shù)；
**      6    ： 發(fā)送“ATD*99***1#”，撥號(hào)到GPRS節(jié)點(diǎn)服務(wù)器；
**      7    ： 進(jìn)行PPP配置、協(xié)商；
**      8    ： 表明GPRS上網(wǎng)、PPP配置成功，應(yīng)用程序可進(jìn)行TCP/IP通訊；
**      9    ： 斷開(kāi)GPRS網(wǎng)絡(luò)，關(guān)閉PPP網(wǎng)絡(luò)，同時(shí)關(guān)閉了GPRS模塊電源。
** 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
PPPGPRSState  PPP_Running( );


/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
**
**  函    數(shù) ：PPP_Restart( );
**
**  功能描述 ：重新啟動(dòng)PPP配置。該函數(shù)主要針對(duì)在進(jìn)行TCP/IP數(shù)據(jù)通訊過(guò)程
**             中出現(xiàn)異常時(shí)的應(yīng)用，可通過(guò)調(diào)用該函數(shù)重新啟動(dòng)GPRS操作。
**    
**  參    數(shù) ：無(wú)；
**    
**  返 回 值 ：無(wú)；
**       
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
void PPP_Restart( );


/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
**
**  函    數(shù) ：IsTimeOut( );
**
**  功能描述 ：檢查函數(shù)的運(yùn)行是否超時(shí)
**    
**  參    數(shù) ：無(wú)；
**    
**  返 回 值 ： 
**       0   ：沒(méi)有超時(shí)；
**       1   ：已經(jīng)超時(shí)；
**         
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
int IsTimeOut( );


/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
**
**  函    數(shù) ：GPRSPowerOn( );
**
**  功能描述 ：GPRS模塊上電；
**    
**  參    數(shù) ：無(wú)；
**    
**  返 回 值 ：返回GPRS模塊的上電狀態(tài)； 
**       0   ：已經(jīng)上電；
**       1   ：還未上電；
**        
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
int   GPRSPowerOn( );


/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
**
**  函    數(shù) ：PPPInit( );
**
**  功能描述 ：初始化PPP網(wǎng)絡(luò)相關(guān)參數(shù)；
**    
**  參    數(shù) ：不填參數(shù)而使用缺省值；
**    
**  返 回 值 ： 
**       0   ：初始化成功;
**      -1   : 初始化失敗；
**        
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
int   PPPInit( );


/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
**
**  函    數(shù) ：SendATCmd( );
**
**  功能描述 ：發(fā)送AT指令并獲取GPRS模塊的響應(yīng)值；
**    
**  參    數(shù) ：無(wú)；
**    
**  返 回 值 ：返回獲取AT指令的狀態(tài)；
**       0   ：獲取到正確的AT響應(yīng)；
**       1   : 已發(fā)送AT指令并進(jìn)入接受響應(yīng)的狀態(tài)；
**      -1   : 未接受到正確的響應(yīng)值；
**      
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
int   SendATCmd( );


/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
**
**  函    數(shù) ：PPPLinkUp( );
**
**  功能描述 ：作為PPP的客戶端，啟動(dòng)PPP連接，進(jìn)行PPP認(rèn)證，并檢查PPP狀態(tài)；
**    
**  參    數(shù) ：無(wú)；
**    
**  返 回 值 ：
**       0   ：PPP打開(kāi)、PPP認(rèn)證成功，進(jìn)入網(wǎng)絡(luò)層協(xié)議狀態(tài)；
**       1   ：處于PPP連接、認(rèn)證狀態(tài)中；
**      -1   ：PPP打開(kāi)、PPP認(rèn)證失敗。
**         
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
int   PPPLinkUp( );


/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
**
**  函    數(shù) ：PPPPolling( );
**
**  功能描述 ：獲取PPP的狀態(tài)；
**    
**  參    數(shù) ：無(wú)；
**    
**  返 回 值 ：檢查PPP的狀態(tài)；
**       0   ：表明GPRS上網(wǎng)、PPP配置成功，應(yīng)用程序可進(jìn)行TCP/IP通訊；
**       -1  : PPP處于關(guān)閉狀態(tài)，可再重新建立PPP連接。
**         
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
int   PPPPolling( );


/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
**
**  函    數(shù) ：PPPTermNet( );
**
**  功能描述 ：斷開(kāi)GPRS網(wǎng)絡(luò)，關(guān)閉PPP網(wǎng)絡(luò)，同時(shí)關(guān)閉了GPRS模塊電源；
**    
**  參    數(shù) ：無(wú)；
**    
**  返 回 值 ： 
**       0   ：執(zhí)行動(dòng)作成功；
**       1   : 正處于執(zhí)行狀態(tài)；
**         
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
int   PPPTermNet( );


/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
**
**  函    數(shù) ：GPRSPowerIsOn( );
**
**  功能描述 ：檢查GPRS的上電狀態(tài)；
**    
**  參    數(shù) ：無(wú)；
**    
**  返 回 值 ：
**       0   ：GPRS沒(méi)有上電；
**       1   ：GPRS已經(jīng)上電；
**         
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
int   GPRSPowerIsOn( );


/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
**
**  函    數(shù) ：EnableIGT( );
**
**  功能描述 ：給GPRS模塊上電，產(chǎn)生高電位脈沖，啟動(dòng)GPRS模塊；
**    
**  參    數(shù) ：無(wú)；
**    
**  返 回 值 ： 
**       0   ：動(dòng)作執(zhí)行完畢；
**
**         
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
int   EnableIGT( );


/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
**
**  函    數(shù) ：DisableIGT( );
**
**  功能描述 ：產(chǎn)生低電位脈沖，啟動(dòng)GPRS模塊；
**    
**  參    數(shù) ：無(wú)；
**    
**  返 回 值 ： 
**       0   ：動(dòng)作執(zhí)行完畢；
**       
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
int   DisableIGT( );


#endif

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
**
**  函    數(shù) ：
**
**  功能描述 ：
**    
**  參    數(shù) ：
**    
**  返 回 值 ： 
**    
**
**         
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */