用函数指针的方式来简化串口指令解析

版权声明：本文为博主原创文章，未经博主允许不得转载。

嵌入式项目常常都会用到串口收发数据，有时候我们需要解析接收到的数据很多人会用到if –else if–else的方式来处理相关命令，也有人会用到switch case的方式，但都够简洁，特别是在多层指令嵌套的情况下，在这里介绍一种我在项目中常用到的方法——使用函数指针。

1.首先定义函数指针类型：

typedef bool (*pFun)(const Message_t message_frame);

2.定义函数数组

static volatile pFun   xCmdSelTab[TOTAL_CMD];

3.对数组进行初始化

void Funtion_Init(void)
{

    xCmdSelTab[INVALID_CMD] = Invalid_cmd;
    xCmdSelTab[FW_VERSION]  = Query_FW_Version;
    xCmdSelTab[CLOSE_ONE_SENSOR] = Close_One_Sensor;
    xCmdSelTab[CLOSE_ALL_SENSOES] = Close_All_Sensor;
    xCmdSelTab[OPEN_ONE_SENSOR] = Open_One_Sensor;
    xCmdSelTab[OPEN_ALL_SENSORS] = Open_All_Sensor; 
    xCmdSelTab[SENSOR_POLARIZE] = Sensor_Polarize; 
}

如上述的Query_FW_Version是查询版本号的函数，具体实现如下

/********************************************
* @Description:Close_One_Sensor
* @param message_frame:
* @return bool
********************************************/
static bool Query_FW_Version(const Message_t message_frame)
{
    Message_t message_tx;
    memcpy((uint8_t *)&message_tx, (uint8_t *)&message_frame, sizeof(message_frame));
    message_tx.data[0]= (FW_VER>>16)&0xff;
    message_tx.data[1]= (FW_VER>>8)&0xff;
    message_tx.data[2]= (FW_VER>>0)&0xff;
    message_tx.data_length =3;
    Ack_to_PC(message_tx) ;     
    return true;    
}

这里可以看到Query_FW_Version函数的定义和第一点提到的typedef bool (*pFun)(const Message_t message_frame) 是一样的。

4.定义解析函数的类型，初始化函数指针数组，实现具体指令函数后，就可以到最后的的执行解析函数了

/**
  * @brief   Ìøתµ½¶ÔÓ¦µÄ¹¦Äܺ¯Êý
  * @param[i]  xFrameRx £º½ÓÊÕµ½µÄÊý¾Ý
  * @retval NONE
  */
bool FuncProcess(const Message_t message_frame)
{
    if(message_frame.cmd>=TOTAL_CMD)
    {
        return false;
    }
    pFun pFn = xCmdSelTab[message_frame.cmd] ;
    if(NULL==pFn){return false;}
    return (pFn)(message_frame);
}



//static uint8_t   message_rx_data_count=0;
//static Message_t message_rx;
void Process_Rx_Data(void)
{
    DataFrame_item_rx   item_rx;
    Message_t message_rx;  
    memset((Message_t*)&message_rx,0,sizeof(message_rx)); 

    /*head 0*/
    if(PopFrame_QList_Rx(&item_rx)==0)
    {
        return;
    }
    if(item_rx.buffer[0]!=((HEAD>>24)&0xff))
    {
        return;
    }

    /*head 1*/    
    if(PopFrame_QList_Rx(&item_rx)==0)
    {
        return;
    }     
    if(item_rx.buffer[0]!=((HEAD>>16)&0xff))
    {
        return;
    }

    /*head 2*/        
    if(PopFrame_QList_Rx(&item_rx)==0)
    {
        return;
    }     
    if(item_rx.buffer[0]!=((HEAD>>8)&0xff))
    {
        return;
    }    

    /*head 3*/     
    if(PopFrame_QList_Rx(&item_rx)==0)
    {
        return;
    }     
    if(item_rx.buffer[0]!=((HEAD>>0)&0xff))
    {
        return;
    }  

    /*DEST_ADDR*/ 
    if(PopFrame_QList_Rx(&item_rx)==0)
    {
        return;
    }     
    if(item_rx.buffer[0]!=DEST_ADDR_DEVICE)
    {
        return;
    } 

    /*command*/     
    if(PopFrame_QList_Rx(&item_rx)==0)
    {
        return;
    }     
    if(item_rx.buffer[0]>=TOTAL_CMD)
    {
        return;
    } 
    message_rx.cmd = item_rx.buffer[0];


    /*data_length*/     
    if(PopFrame_QList_Rx(&item_rx)==0)
    {
        return;
    }     
    if(item_rx.buffer[0]> MAX_SIZE_OF_DATA)
    {
        return;
    }
    message_rx.data_length = item_rx.buffer[0];


    /*data*/     
    for(int i=0;i<message_rx.data_length;i++)
    {
        if(PopFrame_QList_Rx(&item_rx)==0)
        {
            return;
        }
        message_rx.data[i]= item_rx.buffer[0];
    }

    /*check*/         
    if(PopFrame_QList_Rx(&item_rx)==0)
    {
        return;
    }
    uint8_t ret_check=0;
    Check_Sum(message_rx.data, message_rx.data_length,&ret_check);
    if(item_rx.buffer[0]!=ret_check)
    {
        return;
    }

    /*process rx data*/
    FuncProcess(message_rx);
    return ;
}

最后的main函数可以这样写

Void main(void)
{
    While(1)
    {
        Process_Rx_Data();
    }
}

这样Process_Rx_Data函数中把接收到的数据，解析出来后，经过FuncProcess对不同指令进行分发，分发到不同的执行函数中。

核心在于FuncProcess函数中的代码段：

pFun pFn = xCmdSelTab[message_frame.cmd] ;
if(NULL==pFn){return false;}
return (pFn)(message_frame);

实际上xCmdSelTab是一个数组，数据里面每个元素都是一个32位的函数入口地址，xCmdSelTab[FW_VERSION] = Query_FW_Version，就是说xCmdSelTab[FW_VERSION] 里面存了Query_FW_Version函数的入口地址；
当收到查询版本号的指令时:
message_frame.cmd = FW_VERSION，
最后return (pFn)(message_frame)的时候，也就自然地跳到了Query_FW_Version