MC20开发记录

比眉伴天荒 2023-06-07 10:40 20阅读 0赞

此博文记录一些开发经验，方便自己查看，也方便其他需要的人。

文章会持续更新...

**一、基本认识**

1、首先配置一个工程时，需要配置至少一个任务堆栈，这在文件custom\_task\_cfg.h文件中定义。如：

Task Entry Function | Task Id | Task Stack Size (Bytes)
    TASK_ITEM(proc_main_task, main_task_id, 10*1024, DEFAULT_VALUE1, DEFAULT_VALUE2)
    TASK_ITEM(proc_subtask1, subtask1_id, 10*1024, DEFAULT_VALUE1, DEFAULT_VALUE2)

2、有时候需要使用RIL层的一些功能，而这些功能需要用宏定义打开，在custom\_feature\_def.h。如：

#ifndef __CUSTOM_FEATURE_DEF_H__
    #define __CUSTOM_FEATURE_DEF_H__
    
    /************************************************************************
     * RIL Function on/off
     ************************************************************************/
    #define __OCPU_RIL_SUPPORT__
    #define __OCPU_RIL_SMS_SUPPORT__
    #define __OCPU_RIL_CALL_SUPPORT__
    #define __OCPU_RIL_BT_SUPPORT__
    #define __OCPU_RIL_BLE_SUPPORT__
    
    
    
    /************************************************************************
     * FOTA Feature Definition
     ************************************************************************/
    #define __OCPU_FOTA_APP__
    #define __OCPU_FOTA_BY_FTP__
    //#define __OCPU_FOTA_BY_HTTP__
    
    /************************************************************************
     * Smart Cloud Support
     ************************************************************************/
     #define __OCPU_SMART_CLOUD_SUPPORT__
     #endif  //__CUSTOM_FEATURE_DEF_H__

3、实际上在设置了任务堆栈之后就可以写main.c文件了。

MC20的开发环境支持设置多任务，如第1步中的proc\_main\_task和proc\_subtask1即两个任务函数。可以将这两个函数看做两个线程函数，只不过proc\_main\_task是主线程，程序刚一开始运行走的必然是proc\_main\_task，一旦proc\_main\_task的初始化部分处理完成进入while循环，接下两个函数谁有任务进来就会执行谁。此时，如果两个任务函数都有事情要做，两个任务函数并不是谁先把事情处理完了才会执行另一个，可以当作是同时执行。如果加上调试日志，你会发现日志会是互相不干扰的，每个任务的日志都会打印，现象可能是日志上一句是任务1的日志，下一句是任务2的日志。

在实际应用中，经常会遇到任务1处理的事件a的过程中，需要执行另一个事件b，但是又不能停止执行事件a。这个时候最好的处理方法就是让任务2来处理。在两个任务间传递消息上，MC20提供了Message机制。

介绍两个函数Ql\_OS\_GetMessage和Ql\_OS\_SendMessage。

typedef struct {
        u32  message;
        u32  param1;
        u32  param2;
        u32  srcTaskId;
    } ST_MSG;
    
    /*****************************************************************
    * Function:     Ql_OS_GetMessage 
    * 
    * Description:
    *               This function retrieves a message from the current task's 
    *               message queue. When there is no message in the task's
    *               message queue, the task is in the waiting state..
    * Parameters:
    *               msg: 
    *                   A pointer to ST_MSG.
    * Return:        
    *               Always return QL_RET_OK.
    *****************************************************************/
    s32 Ql_OS_GetMessage(ST_MSG* msg);
    
    /*****************************************************************
    * Function:     Ql_OS_SendMessage 
    * 
    * Description:
    *               Send message between tasks.
    
    * Parameters:
    *               destTaskId: 
    *                   One value of Enum_TaskId.
    *               msgId: 
    *                   User message id, must bigger than 0xFF.
    *               param1:
    *               param2:
    *                   Parameters to send to another task.
    * Return:        
    *               OS_SUCCESS
    *               OS_INVALID_ID
    *               OS_MEMORY_NOT_VALID
    *               OS_Q_FULL
    *****************************************************************/
    s32 Ql_OS_SendMessage(s32 destTaskId, u32 msgId, u32 param1, u32 param2);

即在每个task中使用这个机制实现message处理，如下：

void proc_subtask1(s32 TaskId)
    {
    	
        ST_MSG msg;
        while (1)
        {
            Ql_OS_GetMessage(&msg);//通过此函数来获取其他地方发过来的msg，没有任务的时候会阻塞住。
            switch (msg.message)
           	{
                case MSG_IOT_TASK_START_MQTT://处理事件a
    				  Mqtt_InitConnect_Start();
    				  break;
                case MSG_IOT_TASK_OTA_MQTT://处理事件b
    				  fota_app();
    				  break;
                default:
    				  break;
           	}
        }
    }

**二、GPIO**

GPIO介绍几个函数就行了。需要注意的是，Init函数设置的dir如果为IN，则与pullSel有关，与level无关；dir如果为OUT，则与pullSel无关，与level有关。

/*****************************************************************
    * Function:     Ql_GPIO_Init 
    * 
    * Description:
    *               This function enables the GPIO function of the specified pin,
    *               and initialize the configurations, including direction,
    *               level and pull selection.
    *
    * Parameters:
    *               pinName:
    *                   Pin name, one value of Enum_PinName.
    *               dir:
    *                   The initial direction of GPIO, one value of Enum_PinDirection.
    *               level:
    *                   The initial level of GPIO, one value of Enum_PinLevel. 
    *               pullSel:
    *                   Pull selection, one value of Enum_PinPullSel.
    * Return:        
    *               QL_RET_OK, this function succeeds.
    *               QL_RET_ERR_NOSUPPORTPIN, the input GPIO is invalid. 
    *               QL_RET_ERR_PINALREADYSUBCRIBE, the GPIO is in use in
    *               other place. For example this GPIO has been using as EINT.
    *****************************************************************/
    s32 Ql_GPIO_Init(Enum_PinName       pinName, 
                     Enum_PinDirection  dir, 
                     Enum_PinLevel      level, 
                     Enum_PinPullSel    pullSel
                     );
    
    
    s32 Ql_GPIO_SetLevel(Enum_PinName pinName, Enum_PinLevel level);
    s32 Ql_GPIO_GetLevel(Enum_PinName pinName);
    s32 Ql_GPIO_SetDirection(Enum_PinName pinName, Enum_PinDirection dir);
    s32 Ql_GPIO_GetDirection(Enum_PinName pinName);
    s32 Ql_GPIO_SetPullSelection(Enum_PinName pinName, Enum_PinPullSel pullSel);
    s32 Ql_GPIO_GetPullSelection(Enum_PinName pinName);
    s32 Ql_GPIO_Uninit(Enum_PinName pinName);

**三、GPS**

步骤：

1，给GPS上电；GpsOpen();

2，初始化LBS。

s32 LBSDataInit(void)
    {
    	u8  pdpCntxtId;
    	s32 ret;
    	ret = Ql_GPRS_GetPDPContextId();
    	mprintf("<-- The PDP context id available is: %d (can be 0 or 1)-->\r\n", ret);
    	if (ret >= 0)
    	{
    	    pdpCntxtId = (u8)ret;
    	} else {
        	mprintf("<-- Fail to get PDP context id, try to use PDP id(0) -->\r\n");
    	    pdpCntxtId = 0;
    	}
    
    	ret = RIL_NW_SetGPRSContext(pdpCntxtId);
    	mprintf("<-- Set PDP context id to %d -->\r\n", pdpCntxtId);
    	if (ret != RIL_AT_SUCCESS)
    	{
    	    mprintf("<-- Ql_RIL_SendATCmd error  ret=%d-->\r\n",ret );
    	}
    
    	// Set APN
    	ret = RIL_NW_SetAPN(1, "cmnet", "", "");
    	mprintf("<-- Set APN -->\r\n");
    
    	mprintf("<--Ql_Getlocation-->\r\n");
    	ret = RIL_GetLocation(Callback_Location);
    		if(ret!=RIL_AT_SUCCESS)
    		{
    			mprintf("<-- Ql_Getlocation error  ret=%d-->\r\n",ret );
    		}
    	return ret;
    }
    
    s32 RIL_GetLocation(CB_LocInfo cb_loc)
    {
        s32 ret = RIL_AT_FAILED;
        char strAT[200]; 
        callback_loc = cb_loc;
    	
    	Ql_memset(strAT, 0, sizeof(strAT));
    	Ql_sprintf(strAT, "AT+QLOCCFG=\"ASYNCH\",1\r\n");
    	ret = Ql_RIL_SendATCmd(strAT,Ql_strlen(strAT),NULL,NULL,0);
    	if (RIL_AT_SUCCESS == ret)
    	{
            Ql_memset(strAT, 0, sizeof(strAT));
            Ql_sprintf(strAT, "AT+QCELLLOC=1\n");                
            RIL_LOC_DEBUG(DBG_Buffer,"<-- Send AT:%s, ret = %d -->\r\n",strAT, ret);        
            ret = Ql_RIL_SendATCmd(strAT,Ql_strlen(strAT),NULL,NULL,0);
    	}
    
        return ret;
    }
    
    void Callback_Location(s32 result, ST_LocInfo* loc_info)
    {
            mprintf("\r\n<-- Module location: latitude=%f, longitude=%f -->\r\n", loc_info->latitude, loc_info->longitude);
    	LbsJingdu = loc_info->longitude * 1000000;
            LbsWeidu = loc_info->latitude * 1000000;
            mprintf("LBSJingdu %d,LBSWeidu %d\r\n",LbsJingdu,LbsWeidu);
    
    	Ql_sprintf(Jdbuf,"%.6f",loc_info->longitude);
    	Ql_sprintf(Wdbuf,"%.6f",loc_info->latitude);
    
    	
            Need_Lbs_Data = 2;
    }

3，LBS获取到数据之后开启EPO功能帮助快速定位

s32 Gnss_Epo_Init(u8 *lot,u8 *lat)//传参传的是LBS经纬度
    {
    	s32  ret = RIL_AT_SUCCESS;
    	char strAT[50] = {0};
    	u16  atLength = 0;
    
    	if(g_epo_init_sta==0)
    	{
    	
    		RIL_GPS_EPO_Config_APN("CMNET","","");
                    Ql_Sleep(50);
    
    		SetUtc2Modu();
                    Ql_Sleep(50);
    
    		Ql_memset(strAT, 0x0, sizeof(strAT));
                    atLength = Ql_sprintf(strAT,"AT+QGREFLOC=%s,%s",lat,lot);
    
    		ret = Ql_RIL_SendATCmd(strAT, atLength, NULL, NULL, 0);
                    if(RIL_ATRSP_SUCCESS != ret)
    		{
    			return ret;
    		}
    
                    Ql_Sleep(50);
    			
    		ret = RIL_GPS_EPO_Enable(1);
    		if(RIL_AT_SUCCESS != ret) 
    		{
    		    mprintf("Set EPO status to 1 fail, iRet = %d.\r\n",ret);
    		    return ret;
    		}
    
                    Ql_Sleep(50);
    
    		ret = RIL_GPS_EPO_Aid();
    		if(RIL_AT_SUCCESS != ret) 
    		{
    		    mprintf("EPO aiding fail, iRet = %d.\r\n", ret);
    		    return ret;
    	        }
    
    		mprintf("EPO aiding successful, iRet = %d.\r\n", ret);
                    g_epo_init_sta=1;
    	}
    	
    	return ret;	
    }

4，循环读取GPS数据并解析

s32 RIL_GPS_Read(u8 *item, u8 *rdBuff)
    {
        char strAT[50] = {"\0"};
        u16  atLength = 0;
        s32  ret = -1;
        u8   readBuff[1000];
    
        Ql_memset(strAT, 0x0, sizeof(strAT));
        Ql_memset(readBuff, 0x0, sizeof(readBuff));
    
        if(0 == Ql_strncmp(item, "ALL", Ql_strlen(item)))
        {
            atLength = Ql_sprintf(strAT, "AT+QGNSSRD?");
        }
        else
        {
            atLength = Ql_sprintf(strAT, "AT+QGNSSRD=\"NMEA/%s\"", item);
        }
    
        ret = Ql_RIL_SendATCmd(strAT, atLength, ATResponse_GPSRead_Hdlr, readBuff, 0);
    
        if(RIL_ATRSP_SUCCESS == ret)
        {
            Ql_strcpy((char*)rdBuff,readBuff);
        }
    
        return ret;
    }
    
    while (timeout)
    {
        timeout--;
        times++;
        Ql_Sleep(1000);
        iRet = RIL_GPS_Read("ALL", rdBuff);//RMC GGA
        if (RIL_AT_SUCCESS != iRet)
        {
            mprintf("Read %d information failed.\r\n", iRet);
        }
        else
        {
            mprintf("%s\r\n", rdBuff);
            GpsAnalysis((u8*)rdBuff);
            GPS_package(&gpsx, &my_core_data);
        }
        mprintf("satellitenum %d\r\n",gpsx.satellitenum);
        if(gpsx.useorno != 65 && times > 10 && gpsx.satellitenum < 4) 
        {
            mprintf("gps rssi is too low\r\n");
            return -2;
        }
        if (gpsx.useorno == 65 && NMEA_check_crc(rdBuff))
        {
            temp=(double)(gpsx.latitude);
            fix_gpsbuf[ptTimeout].lat=temp/1000000;
            temp=(double)(gpsx.longitude);
            fix_gpsbuf[ptTimeout].lon=temp/1000000;
            fix_gpsbuf[ptTimeout].speed=gpsx.speed;
            mprintf("fix_gpsbuf[%d].speed=%d\r\n",ptTimeout,fix_gpsbuf[ptTimeout].speed);
            ptTimeout++;
            if(ptTimeout==3)
            {
                iRet=fix_gpslocation();
                if(iRet==0)
                {
                    mprintf("\r\n Gps = %d s \r\n",times);
                    times=0;
                    iRet = GpsClose();
                    if (RIL_AT_SUCCESS != iRet)
                    {
                        mprintf("GpsClose fail, iRet = %d.\r\n", iRet);
                    }
                    else
                    {
                        gpspowersta = 0;
                        mprintf("GPS close ok");
                    }
                    gpsx.useorno=0;
                    return 0;
                    }
                    else
                    {
                        ptTimeout=0;
                        mprintf("Useless gps position!!!!\r\n");
                    }
                }
        }
        if (gpsx.useorno != 65)
        {
            iRet = GpsClose();
            if (RIL_AT_SUCCESS != iRet)
            {
                mprintf("GpsClose fail, iRet = %d.\r\n", iRet);
            }
            else
            {
                gpspowersta = 0;
                mprintf("GPS close ok");
            }
            return -1;
        }
    }

**四、定时器**

Ql\_Timer\_Register和Ql\_Timer\_RegisterFast的区别是，Ql\_Timer\_RegisterFast的定时器更精准，而且使用了这个注册的定时器，无法调用Ql\_SleepEnable使程序休眠下来。直接上代码了：

/**************************************************************
     * User TIMER ID Definition
     **************************************************************/
    #define     TIMER_ID_USER_START    0x100
    
    typedef void(*Callback_Timer_OnTimer)(u32 timerId, void* param);
    
    /*****************************************************************
    * Function:     Ql_Timer_Register 
    * 
    * Description:
    *               Register stack timer,each task only supports 10 timer.
    *
    * Parameters:
    *               timerId:
    *                       [in] The timer id must be bigger than 0xFF.And make sure that the id is
    *                            the only one under opencpu task.Of course, the ID that registered 
    *                            by "Ql_Timer_RegisterFast" also cannot be the same with it.
    *                            
    *              callback_onTimer:
    *                       [out] Notify the application when the time of the timer arrives.
    *               param:
    *                       [in] Used to pass parameters of customers.
    * Return:
    *               QL_RET_OK indicates register ok;
    *               QL_RET_ERR_PARAM indicates the param error.
    *               QL_RET_ERR_INVALID_TIMER indicates that the timer ID is already being used  
    *               or the timer is started or stopped not in the same task with it registered.
    *               QL_RET_ERR_TIMER_FULL indicates all timers are used up.
    *               QL_RET_ERR_INVALID_TASK_ID indicates the task invalid.
    * Notes:
    *               If you register a timer Id in an opencpu task, then you can only start or stop 
    *               the timer in the same task.Otherwise,the timer can not be started or stopped.
    *    
    *****************************************************************/
    s32 Ql_Timer_Register(u32 timerId, Callback_Timer_OnTimer callback_onTimer, void* param);
    
    /*****************************************************************
    * Function:     Ql_Timer_RegisterFast 
    * 
    * Description:
    *               Register GP timer,only support one timer under opencpu task.
    *
    * Parameters:
    *               timerId:
    *                       [in] The timer id must be bigger than 0xFF.And make sure that the id is
    *                            not the same with the ID that registered by "Ql_Timer_Register".
    *
    *              callback_onTimer:
    *                       [out] Notify the application when the time of the timer arrives.
    *               param:
    *                       [in] Used to pass parameters of customers.
    * Return:
    *               QL_RET_OK indicates register ok;
    *               QL_RET_ERR_PARAM indicates the param error.
    *               QL_RET_ERR_INVALID_TIMER indicates that the timer ID is already being used  
    *               or the timer is started or stopped not in the same task with it registered.
    *               QL_RET_ERR_TIMER_FULL indicates all timers are used up.
    *               QL_RET_ERR_INVALID_TASK_ID indicates the task invalid.
    * Notes:
    *               If you register a timer Id in an opencpu task, then you can only start or stop 
    *               the timer in the same task.Otherwise,the timer can not be started or stopped.
    *    
    *****************************************************************/
    s32 Ql_Timer_RegisterFast(u32 timerId, Callback_Timer_OnTimer callback_onTimer, void* param);

**五、CALL和SMS**

通过URC查询SIM卡的状态、GSM和GPRS，如果状态都正常，则可以调用RIL\_Telephony\_Dial拨打电话。

case  MSG_ID_URC_INDICATION:
            switch (msg.param1)
            {
                case URC_GSM_NW_STATE_IND:
                {
                    if(NW_STAT_REGISTERED == msg.param2 || NW_STAT_REGISTERED_ROAMING == msg.param2)        
                    flag_call = 1;
                }
                case URC_SYS_INIT_STATE_IND:
                {
                    if (SYS_STATE_SMSOK == msg.param2)
                    flag_sms = 1;
                }
                case URC_NEW_SMS_IND:
                {
                    mprintf("\r\n<-- New SMS Arrives: index=%d\r\n", msg.param2);
                    Hdlr_RecvNewSMS((msg.param2), TRUE);
                }
                break;
    
                default:
                break;
            }
            break;

s32 RIL_Telephony_Dial(u8 type, char* phoneNumber, s32 *result)
    {
        char strAT[40];
        if (NULL == phoneNumber)
        {
            return -1;
        }
        Ql_memset(strAT, 0x0, sizeof(strAT));
        Ql_sprintf(strAT, "ATD%s;", phoneNumber);
        return Ql_RIL_SendATCmd(strAT, Ql_strlen(strAT), Telephony_Dial_AT_handler, (void* )result, 0);
    }

/******************************************************************************
    * Function:     RIL_SMS_SendSMS_Text
    *  
    * Description:
    *               This function is used to send TEXT message
    *
    * Parameters:    
    *               <pNumber>:
    *                   [In] The pointer of phone number
    *               <uNumberLen>:
    *                   [In] The length of phone number
    *               <eCharset>
    *                   [In] CharSet,it's value is same as 'LIB_SMS_CharSetEnum'
    *               <pMsg>
    *                   [In] The pointer of message content
    *               <uMsgLen>
    *                   [In] The length of message content
    *               <pMsgRef>
    *                   [Out] The pointer of message reference number
    *
    * Return:  
    *                RIL_AT_SUCCESS,send AT successfully.
    *                RIL_AT_FAILED, send AT failed.
    *                RIL_AT_TIMEOUT,send AT timeout.
    *                RIL_AT_BUSY,   sending AT.
    *                RIL_AT_INVALID_PARAM, invalid input parameter.
    *                RIL_AT_UNINITIALIZED, RIL is not ready, need to wait for MSG_ID_RIL_READY
    *                                      and then call Ql_RIL_Initialize to initialize RIL.
    * Note:
    *                1. If you DONOT want to get <pMsgRef> value,please set it to NULL.
    ******************************************************************************/
    s32 RIL_SMS_SendSMS_Text(char* pNumber, u8 uNumberLen, LIB_SMS_CharSetEnum eCharset, u8* pMsg, u32 uMsgLen,u32 *pMsgRef)
    {
        LIB_SMS_PDUParamStruct *pParam = NULL;
        LIB_SMS_SubmitPDUParamStruct *pSubmitParam = NULL;
        LIB_SMS_PDUInfoStruct *pInfo = NULL;
        bool bResult = FALSE;
        char *pPDUStr = NULL;
        u32 uPDUStrLen = 0;
        s32 iResult = 0;
    
        if((NULL == pNumber) || (0 == uNumberLen) || (NULL == pMsg))
        {
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_SendSMS_Text,FAIL! Parameter is NULL.");
            return RIL_AT_INVALID_PARAM;
        }
    
        if(FALSE == LIB_SMS_IS_SUPPORT_CHARSET(eCharset))
        {
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_SendSMS_Text,FAIL! LIB_SMS_IS_SUPPORT_CHARSET FAIL! eCharset:%u",eCharset);
            return RIL_AT_INVALID_PARAM;
        }
    
        pParam = (LIB_SMS_PDUParamStruct*)Ql_MEM_Alloc(sizeof(LIB_SMS_PDUParamStruct));
        if(NULL == pParam)
        {
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_SendSMS_Text,FAIL! Ql_MEM_Alloc FAIL! size:%u",sizeof(LIB_SMS_PDUParamStruct));
            return RIL_AT_FAILED;
        }
    
        pInfo = (LIB_SMS_PDUInfoStruct*)Ql_MEM_Alloc(sizeof(LIB_SMS_PDUInfoStruct));
        if(NULL == pInfo)
        {
            Ql_MEM_Free(pParam);
        
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_SendSMS_Text,FAIL! Ql_MEM_Alloc FAIL! size:%u",sizeof(LIB_SMS_PDUInfoStruct));
            return RIL_AT_FAILED;
        }
    
        //Initialize
        Ql_memset(pParam,0x00,sizeof(LIB_SMS_PDUParamStruct));
        Ql_memset(pInfo,0x00,sizeof(LIB_SMS_PDUInfoStruct));
        pSubmitParam = &((pParam->sParam).sSubmitParam);
    
        //Set <FO>
        (pParam->uFO) = LIB_SMS_DEFAULT_FO_IN_SUBMIT_PDU;
    
        //Set <DA>
        bResult = ConvStringToPhoneNumber(pNumber,uNumberLen,&(pSubmitParam->sDA));
        if(FALSE == bResult)
        {
            Ql_MEM_Free(pParam);
            Ql_MEM_Free(pInfo);
    
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_SendSMS_Text,FAIL! ConvStringToPhoneNumber FAIL!");
            return RIL_AT_FAILED;
        }
    
        //Set <PID>
        (pSubmitParam->uPID) = LIB_SMS_PDU_DEFAULT_PID;
        //Set <DCS>
        LIB_SMS_SET_DEFAULT_DCS_IN_SUBMIT_PDU(eCharset,(pSubmitParam->uDCS));
        //Set <VP>
        ((pSubmitParam->sVP).uRelative) = LIB_SMS_SUBMIT_PDU_DEFAULT_VP_RELATIVE;
    
        //Set <UD>
        ((pSubmitParam->sUserData).uLen) = sizeof((pSubmitParam->sUserData).aUserData);
        bResult = LIB_SMS_ConvCharSetToAlpha(
                eCharset,
                pMsg,
                uMsgLen,
                (pSubmitParam->uDCS),
                ((pSubmitParam->sUserData).aUserData),
                &((pSubmitParam->sUserData).uLen)
            );
        
        if(FALSE == bResult)
        {
            Ql_MEM_Free(pParam);
            Ql_MEM_Free(pInfo);
    
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_SendSMS_Text,FAIL! LIB_SMS_ConvCharSetToAlpha FAIL!");
            return RIL_AT_FAILED;
        }
    
        bResult = LIB_SMS_EncodeSubmitPDU(pParam,pInfo);
        if(FALSE == bResult)
        {
            Ql_MEM_Free(pParam);
            Ql_MEM_Free(pInfo);
    
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_SendSMS_Text,FAIL! LIB_SMS_EncodeSubmitPDU FAIL!");
            return RIL_AT_FAILED;
        }
    
        Ql_MEM_Free(pParam);  //Not need <pParam>,free it directly
        pParam = NULL;
    
        pPDUStr = (char*)Ql_MEM_Alloc((pInfo->uLen) * 2);
        if(NULL == pPDUStr)
        {
            Ql_MEM_Free(pInfo);
            
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_SendSMS_Text,FAIL! Ql_MEM_Alloc FAIL! size:%d",((pInfo->uLen) * 2));
            return RIL_AT_FAILED;
        }
    
        uPDUStrLen = ((pInfo->uLen) * 2);
        bResult = LIB_SMS_ConvHexOctToHexStr((pInfo->aPDUOct),(pInfo->uLen),pPDUStr,(u16*)&uPDUStrLen);    
        if(NULL == pPDUStr)
        {
            Ql_MEM_Free(pInfo);
            Ql_MEM_Free(pPDUStr);
            
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_SendSMS_Text,FAIL! Ql_MEM_Alloc FAIL! size:%d",((pInfo->uLen) * 2));
            return RIL_AT_FAILED;
        }
    
        //Now send SUBMIT-PDU message
        LIB_SMS_CHECK_SUBMIT_PDU_STR_FOR_SEND(pPDUStr,uPDUStrLen,bResult);
        if(FALSE == bResult)
        {
            Ql_MEM_Free(pInfo);
            Ql_MEM_Free(pPDUStr);
        
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_SendSMS_PDU,FAIL! LIB_SMS_CHECK_SUBMIT_PDU_STR_FOR_SEND FAIL!");
            return RIL_AT_INVALID_PARAM;
        }
    
        iResult = CmdSendPDUMsg(pPDUStr,uPDUStrLen,pMsgRef);
    
        DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_SendSMS_PDU,SUCCESS. iResult:%d",iResult);
    
        Ql_MEM_Free(pInfo);
        Ql_MEM_Free(pPDUStr);
    
        return iResult;
    }
    
    
    /******************************************************************************
    * Function:     RIL_SMS_ReadSMS_Text
    *  
    * Description:
    *               Read a TEXT SMS
    *
    * Parameters:    
    *               <uIndex>:
    *                   [In] The SMS index in current SMS storage
    *               <eCharset>:
    *                   [In] Character set enum value
    *               <pTextInfo>
    *                   [In] The pointer of TEXT SMS info
    *
    * Return:  
    *                RIL_AT_SUCCESS,send AT successfully.
    *                RIL_AT_FAILED, send AT failed.
    *                RIL_AT_TIMEOUT,send AT timeout.
    *                RIL_AT_BUSY,   sending AT.
    *                RIL_AT_INVALID_PARAM, invalid input parameter.
    *                RIL_AT_UNINITIALIZED, RIL is not ready, need to wait for MSG_ID_RIL_READY
    *                                      and then call Ql_RIL_Initialize to initialize RIL.
    ******************************************************************************/
    s32 RIL_SMS_ReadSMS_Text(u32 uIndex, LIB_SMS_CharSetEnum eCharset,ST_RIL_SMS_TextInfo* pTextInfo)
    {
        ST_RIL_SMS_PDUInfo *pPDUInfo = NULL;
        LIB_SMS_PDUParamStruct *pSMSParam = NULL;
        s32 iResult = 0;
        bool bResult = FALSE;
    
        if(NULL == pTextInfo)
        {
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_ReadSMS_Text,FAIL! Parameter is NULL.");
            return RIL_AT_INVALID_PARAM;
        }
    
        //Initialize
        Ql_memset(pTextInfo,0x00,sizeof(ST_RIL_SMS_TextInfo));
    
        if(FALSE == LIB_SMS_IS_SUPPORT_CHARSET(eCharset))
        {
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_ReadSMS_Text,FAIL! LIB_SMS_IS_SUPPORT_CHARSET FAIL! eCharset:%d",eCharset);
            return RIL_AT_INVALID_PARAM;
        }
    
        pPDUInfo = (ST_RIL_SMS_PDUInfo*)Ql_MEM_Alloc(sizeof(ST_RIL_SMS_PDUInfo));
        if(NULL == pPDUInfo)
        {
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_ReadSMS_Text,FAIL! Ql_MEM_Alloc FAIL! size:%u",sizeof(ST_RIL_SMS_PDUInfo));
            return RIL_AT_FAILED;
        }
    
        pSMSParam = (LIB_SMS_PDUParamStruct*)Ql_MEM_Alloc(sizeof(LIB_SMS_PDUParamStruct));
        if(NULL == pSMSParam)
        {
            Ql_MEM_Free(pPDUInfo);
        
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_ReadSMS_Text,FAIL! Ql_MEM_Alloc FAIL! size:%u",sizeof(LIB_SMS_PDUParamStruct));
            return RIL_AT_FAILED;
        }
    
        //Initialize
        Ql_memset(pPDUInfo,0x00,sizeof(ST_RIL_SMS_PDUInfo));
        Ql_memset(pSMSParam,0x00,sizeof(LIB_SMS_PDUParamStruct));
    
        iResult = CmdReadPDUMsg(uIndex,pPDUInfo);
        if(iResult != RIL_ATRSP_SUCCESS)
        {    
            Ql_MEM_Free(pPDUInfo);
            Ql_MEM_Free(pSMSParam);
        
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_ReadSMS_Text,FAIL! CmdReadPDUMsg FAIL!");
            return iResult;
        }
    
        //The message of <uIndex> position is NOT exist.
        if(0 == (pPDUInfo->length))
        {
            SMS_SET_INVALID_TEXT_INFO(pTextInfo);
        
            Ql_MEM_Free(pPDUInfo);
            Ql_MEM_Free(pSMSParam);
        
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_ReadSMS_PDU,SUCCESS. NOTE: (pPDUInfo->length) is 0.");
            return RIL_ATRSP_SUCCESS;
        }
    
        //Check the <pPDUInfo>
        if(FALSE == IS_VALID_PDU_INFO(pPDUInfo))
        {
            Ql_MEM_Free(pPDUInfo);
            Ql_MEM_Free(pSMSParam);
        
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_ReadSMS_Text,FAIL! IS_VALID_PDU_INFO FAIL!");
            return RIL_AT_FAILED;
        }
    
        bResult = LIB_SMS_DecodePDUStr((pPDUInfo->data),(pPDUInfo->length),pSMSParam);
        if(FALSE == bResult)
        {
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_ReadSMS_Text,FAIL! LIB_SMS_DecodePDUStr FAIL! PDU length:%u",(pPDUInfo->length));
        
            Ql_MEM_Free(pPDUInfo);
            Ql_MEM_Free(pSMSParam);
        
            return RIL_AT_FAILED;
        }
    
        (pTextInfo->status) = (pPDUInfo->status);
    
        bResult = ConvSMSParamToTextInfo(eCharset,pSMSParam,pTextInfo);
        if(FALSE == bResult)
        {
            Ql_MEM_Free(pPDUInfo);
            Ql_MEM_Free(pSMSParam);
        
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_ReadSMS_Text,FAIL! ConvSMSParamToTextInfo FAIL!");
            return RIL_AT_FAILED;
        }
    
        Ql_MEM_Free(pPDUInfo);
        Ql_MEM_Free(pSMSParam);
    
        DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_ReadSMS_Text,SUCCESS. status:%u",(pTextInfo->status));
    
        return RIL_AT_SUCCESS;
    }
    
    
    /******************************************************************************
    * Function:     RIL_SMS_SendSMS_PDU
    *  
    * Description:
    *               This function is used to send PDU message
    *
    * Parameters:    
    *               <pPDUStr>:
    *                   [In] The pointer of PDU string
    *               <uPDUStrLen>:
    *                   [In] The length of PDU string
    *               <pMsgRef>
    *                   [Out] The pointer of message reference number
    *
    * Return:  
    *                RIL_AT_SUCCESS,send AT successfully.
    *                RIL_AT_FAILED, send AT failed.
    *                RIL_AT_TIMEOUT,send AT timeout.
    *                RIL_AT_BUSY,   sending AT.
    *                RIL_AT_INVALID_PARAM, invalid input parameter.
    *                RIL_AT_UNINITIALIZED, RIL is not ready, need to wait for MSG_ID_RIL_READY
    *                                      and then call Ql_RIL_Initialize to initialize RIL.
    * Note:
    *                1. If you DONOT want to get <pMsgRef> value,please set it to NULL.
    ******************************************************************************/
    s32 RIL_SMS_SendSMS_PDU(char* pPDUStr,u32 uPDUStrLen,u32 *pMsgRef)
    {
        bool bResult = FALSE;
        s32 iResult = 0;
        
        if((NULL == pPDUStr) || (0 == uPDUStrLen))
        {
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_SendSMS_PDU,FAIL! Parameter is NULL.");
            return RIL_AT_INVALID_PARAM;
        }
    
        LIB_SMS_CHECK_SUBMIT_PDU_STR_FOR_SEND(pPDUStr,uPDUStrLen,bResult);
        if(FALSE == bResult)
        {
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_SendSMS_PDU,FAIL! LIB_SMS_CHECK_SUBMIT_PDU_STR_FOR_SEND FAIL!");
            return RIL_AT_INVALID_PARAM;
        }
    
        iResult = CmdSendPDUMsg(pPDUStr,uPDUStrLen,pMsgRef);
    
        DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_SendSMS_PDU,SUCCESS. uPDUStrLen:%u,iResult:%d",uPDUStrLen,iResult);
    
        return iResult;
    }
    
    /******************************************************************************
    * Function:     RIL_SMS_ReadSMS_PDU
    *  
    * Description:
    *               Read a PDU SMS
    *
    * Parameters:    
    *               <index>:
    *                   [In] The SMS index in current SMS storage
    *               <pduInfo>:
    *                   [In] The pointer of 'ST_RIL_SMS_PDUInfo' data
    *
    * Return:  
    *                RIL_AT_SUCCESS,send AT successfully.
    *                RIL_AT_FAILED, send AT failed.
    *                RIL_AT_TIMEOUT,send AT timeout.
    *                RIL_AT_BUSY,   sending AT.
    *                RIL_AT_INVALID_PARAM, invalid input parameter.
    *                RIL_AT_UNINITIALIZED, RIL is not ready, need to wait for MSG_ID_RIL_READY
    *                                      and then call Ql_RIL_Initialize to initialize RIL.
    ******************************************************************************/
    s32 RIL_SMS_ReadSMS_PDU(u32 uIndex, ST_RIL_SMS_PDUInfo* pPDUInfo)
    {
        s32 iResult = 0;
        bool bResult = FALSE;
    
        if(NULL == pPDUInfo)
        {
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_ReadSMS_PDU,FAIL! Parameter is NULL.");
            return RIL_AT_INVALID_PARAM;
        }
    
        //Initialize
        Ql_memset(pPDUInfo,0x00,sizeof(ST_RIL_SMS_PDUInfo));
    
        iResult = CmdReadPDUMsg(uIndex,pPDUInfo);
        if(iResult != RIL_ATRSP_SUCCESS)
        {
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_ReadSMS_PDU,FAIL! CmdReadPDUMsg FAIL!");
            return iResult;
        }
    
        //The message of <uIndex> position is NOT exist.
        if(0 == (pPDUInfo->length))
        {
            SMS_SET_INVALID_PDU_INFO(pPDUInfo);
        
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_ReadSMS_PDU,SUCCESS. NOTE:(pPDUInfo->length) is 0.");
            return RIL_ATRSP_SUCCESS;
        }
    
        //Check the <pPDUInfo>
        if(FALSE == IS_VALID_PDU_INFO(pPDUInfo))
        {
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_ReadSMS_PDU,FAIL! IS_VALID_PDU_INFO FAIL!");
            return RIL_AT_FAILED;
        }
    
        LIB_SMS_CHECK_PDU_STR((pPDUInfo->data),(pPDUInfo->length),bResult);
        if(FALSE == bResult)
        {
            DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_ReadSMS_PDU,WARNING! LIB_SMS_CHECK_PDU_STR FAIL!");
        }
    
        DBG_TRACE(sg_aDbgBuf,"Enter RIL_SMS_ReadSMS_PDU,SUCCESS. status:%u,length:%u",(pPDUInfo->status),(pPDUInfo->length));
    
        return RIL_ATRSP_SUCCESS;
    }

**六、FLASH(UFS)**

FLASH操作教程。

1，使用Ql\_FS\_CreateDir创建根目录，然后确定需要使用到的文件目录。

2，使用Ql\_FS\_Open创建这个文件目录，一般情况下，先用QL\_FS\_READ\_WRITE来判断是否存在这个目录，不存在的情况下，再用QL\_FS\_CREATE\_ALWAYS来创建。

3，存在该文件并且open成功之后，返回的handle是大于0的，然后操作这个handle写入或者读出，大小用的sizeof字节。

4，最后调用Ql\_FS\_Close(handle);关闭文件操作。

#define  MYPATH_ROOT    ((u8 *)"myroot")  
    #define  SYSFILE 		"sys3_config.txt"
    
    void ReadFlashParamsNew(_system_setings* sysset)
    {
        s32 ret;
        s32 handle = -1;
        u8 filePath[100] = {0};
        ret = Ql_FS_CheckDir(MYPATH_ROOT);
        if (ret != QL_RET_OK)
        {
            ret  = Ql_FS_CreateDir(MYPATH_ROOT);
        }
        Ql_sprintf(filePath, "%s\\%s\0", MYPATH_ROOT, SYSFILE);
        handle = Ql_FS_Open(filePath, QL_FS_READ_WRITE);
        if (handle < 0)
        {
    
            handle = Ql_FS_Open(filePath, QL_FS_CREATE_ALWAYS);
            if (handle > 0)
            {
                LoadDefualtCfg();
                Ql_FS_Write(handle, sysset, sizeof(_system_setings), NULL);
                Ql_FS_Close(handle);
            }
        }
        else
        {
            Ql_FS_Read(handle, sysset, sizeof(_system_setings), NULL);
            Ql_FS_Close(handle);
        }
        systemset.SysTime = 0;
    }
    
    void SaveFlashParamsNew(_system_setings* sysset)
    {
        s32 handle = -1;
        s32 ret;
        u8 filePath[100] = {0};
        Ql_sprintf(filePath, "%s\\%s\0", MYPATH_ROOT, SYSFILE);
        handle = Ql_FS_Open(filePath, QL_FS_READ_WRITE);
        Ql_FS_Write(handle, sysset, sizeof(_system_setings), NULL);
        Ql_FS_Close(handle);
    }

**七、TCP**

基本步骤：

1，在连接GSM, GPRS后，通过后面的几个函数注册GPRS，目的是为了激活pdpCntxtId。

Ql\_GPRS\_Register(pdpCntxtId, &callback\_gprs\_func, NULL);

Ql\_GPRS\_Config(pdpCntxtId, &m\_GprsConfig);

Ql\_GPRS\_ActivateEx(pdpCntxtId, TRUE);

2，使用Ql\_SOC\_Register(callback\_soc\_func, NULL)注册socket的回调函数；

static ST\_SOC\_Callback callback\_soc\_func =  
\{  
    callback\_socket\_connect,  
    Callback\_Socket\_Close,  
    callback\_socket\_accept,  
    Callback\_Socket\_read,  
    Callback\_Socket\_Write  
\};

使用SocketId = Ql\_SOC\_Create(pdpCntxtId, SOC\_TYPE\_TCP)获取tcp连接用的套接字。

3，连接TCP。Ql\_SOC\_ConnectEx(m\_SocketId, (u32)m\_ipaddress, port, TRUE);

4，读socket的内容：Ql\_SOC\_Recv(m\_SocketId, buf, len);

5，往socket里面写内容：Ql\_SOC\_Send(m\_SocketId, (u8\*)buf, len);

/**
     * @brief Establish a TCP connection.
     *
     * @param [in] host: @n Specify the hostname(IP) of the TCP server
     * @param [in] port: @n Specify the TCP port of TCP server
     *
     * @return The handle of TCP connection.
       @retval   0 : Fail.
       @retval > 0 : Success, the value is handle of this TCP connection.
     */
     uintptr_t HAL_TCP_Establish(const char *host, uint16_t port)
    {
    	s32 ret;
    	m_SocketId = -1;
    	my_tcp_state=STATE_NW_GET_SIMSTATE;
    	GSM_InitModule();
    	while (my_tcp_state != STATE_GPRS_REGISTER)
    		{
    		   PLATFORM_SOCK_LOG("Search the net....");
    		   GSM_InitModule();
    		   HAL_SleepMs(200);
    		}
    	
        pdpCntxtId = 1;
      
        ret = Ql_GPRS_Register(pdpCntxtId, &callback_gprs_func, NULL);
        if (GPRS_PDP_SUCCESS == ret)
        {
            PLATFORM_SOCK_LOG("<-- Register GPRS callback function -->\r\n");
        }
        else  if (GPRS_PDP_ALREADY == ret)
        {
        	PLATFORM_SOCK_LOG("<--ALREADY to register GPRS-->\r\n");
        }
    	else
    	{
    		PLATFORM_SOCK_LOG("<-- Fail to register GPRS, cause=%d. -->\r\n", ret);
           	return  NULL;
    	}
     
        ret = Ql_GPRS_Config(pdpCntxtId, &m_GprsConfig);
        if (GPRS_PDP_SUCCESS == ret)
        {
            PLATFORM_SOCK_LOG("<-- Configure PDP context -->\r\n");
        }
        else
        {
            PLATFORM_SOCK_LOG("<-- Fail to configure GPRS PDP, cause=%d. -->\r\n", ret);
            return NULL;
        }
    
        PLATFORM_SOCK_LOG("<-- Activating GPRS... -->\r\n");
        ret = Ql_GPRS_ActivateEx(pdpCntxtId, TRUE);
        if (ret == GPRS_PDP_SUCCESS)
        {
            m_GprsActState = 1;
            PLATFORM_SOCK_LOG("<-- Activate GPRS successfully. -->\r\n\r\n");
        }
    	else if (GPRS_PDP_ALREADY == ret)
    	{
    		 m_GprsActState = 1;
    		PLATFORM_SOCK_LOG("<--GPRS callback function has already been registered,ret=%d,pdpCntxtId=%d-->\r\n",ret,pdpCntxtId);
    					                   
    	}
        else
        {
            PLATFORM_SOCK_LOG("<-- Fail to activate GPRS, cause=%d. -->\r\n\r\n", ret);
            return NULL;
        }
    
        ret = Ql_SOC_Register(callback_soc_func, NULL);
        if (SOC_SUCCESS == ret)
        {
            PLATFORM_SOCK_LOG("<-- Register socket callback function -->\r\n");
        }
    	else if (SOC_ALREADY == ret)
        {
            PLATFORM_SOCK_LOG("<-- Register socket callback function -->\r\n");
        }
        else
        {
            PLATFORM_SOCK_LOG("<-- Fail to register socket callback, cause=%d. -->\r\n", ret);
            return NULL;
        }
    
        m_SocketId = Ql_SOC_Create(pdpCntxtId, SOC_TYPE_TCP);
        if (m_SocketId >= 0)
        {
            PLATFORM_SOCK_LOG("<-- Create socket successfully, socket id=%d. -->\r\n", m_SocketId);
        }
        else
        {
            PLATFORM_SOCK_LOG("<-- Fail to create socket, cause=%d. -->\r\n", m_SocketId);
            return NULL;
        }
    
        //6. Connect to server
        {
            //6.1 Convert IP format
            Ql_memset(m_ipaddress, 0, 5);
    		PLATFORM_SOCK_LOG("host=%s",host);
            ret = Ql_IpHelper_ConvertIpAddr(host, (u32*)m_ipaddress);
            if (SOC_SUCCESS == ret)  
            {
                PLATFORM_SOCK_LOG("<-- Convert Ip Address successfully,m_ipaddress=%d,%d,%d,%d -->\r\n", m_ipaddress[0], m_ipaddress[1], m_ipaddress[2], m_ipaddress[3]);
            }
            else
            {
            	 s32 count=0;
                 ret = Ql_IpHelper_GetIPByHostNameEx(pdpCntxtId, 0, host, &count,m_ipaddress);
    			 if(ret == SOC_SUCCESS)
    			      {
    			           PLATFORM_SOCK_LOG("<--Get ip by hostname successfully.-->\r\n");
    			      }
    			  else
    			      {
    			           PLATFORM_SOCK_LOG("<--Get ip by hostname failure:ret=%d-->\r\n",ret);
    			           return NULL;
    			       }
            }
    
            //6.2 Connect to server
            PLATFORM_SOCK_LOG("<-- Connecting to server(IP:%d.%d.%d.%d, port:%d)... -->\r\n", m_ipaddress[0], m_ipaddress[1], m_ipaddress[2], m_ipaddress[3], port);
            ret = Ql_SOC_ConnectEx(m_SocketId, (u32)m_ipaddress, port, TRUE);
            if (SOC_SUCCESS == ret)
            {
                m_SocketConnState = 1;
                PLATFORM_SOCK_LOG("<-- Connect to server successfully -->\r\n");
    			return __LINE__;
            }
            else
            {
                PLATFORM_SOCK_LOG("<-- Fail to connect to server, cause=%d -->\r\n", ret);
                return NULL;
            }
        }
    
        return NULL;
    }

**八、FTP**

从FTP服务器下载升级文件。

步骤：

1，获取SIM卡状态、GSM和GPRS注册状态。

2，设置pdp context。RIL\_NW\_SetGPRSContext(Ql\_GPRS\_GetPDPContextId());

3，设置APN。RIL\_NW\_SetAPN(1, APN, USERID, PASSWD);//APN:“cmnet”；USERID:"";PASSWD:""。

4，打开FTP，通过地址、端口、用户名、密码。RIL\_FTP\_QFTPOPEN(FTP\_SVR\_ADDR, FTP\_SVR\_PORT, FTP\_USER\_NAME, FTP\_PASSWORD, 1);

5，Set local storage：RIL\_FTP\_QFTPCFG(4, (u8\*)"UFS");

6，Set patch on server： ret = RIL\_FTP\_QFTPPATH(FTP\_SVR\_PATH);

7，Download file from ftp-server：

ret = RIL\_FTP\_QFTPGET((u8 \*)FTP\_FILENAME\_DL, 0, FTP\_Callback\_OnUpDown);  
    if (ret < 0)  
    \{  
        APP\_DEBUG("<-- Failed to download, cause=%d -->\\r\\n", ret);  
          
        ret = RIL\_FTP\_QFTPCLOSE();  
        APP\_DEBUG("<-- FTP close connection, ret=%d -->\\r\\n", ret);

ret = RIL\_FTP\_QIDEACT();  
        APP\_DEBUG("<-- Release PDP context, ret=%d -->\\r\\n", ret);  
        return -3;  
    \}