回调函数

1、函数指针

学习回调函数,其实就是函数指针的应用,关于函数指针在之前的文章《指针与函数》中有详细的讲解,这里不再展开详解,重新贴一下之前文章中函数指针的示例代码

#include <stdio.h>
void MyFun1(int x);
void MyFun2(int x);
void MyFun3(int x);
typedef void (*FunType)(int); /* ②. 定义一个函数指针类型FunType,与①函数类型一致 */
void CallMyFun(FunType fp, int x);
int main(int argc, char *argv[])
{
    CallMyFun(MyFun1, 10); /* ⑤. 通过CallMyFun函数分别调用三个不同的函数 */
    CallMyFun(MyFun2, 20);
    CallMyFun(MyFun3, 30);
}
void CallMyFun(FunType fp, int x) /* ③. 参数fp的类型是FunType。*/
{
    fp(x); /* ④. 通过fp的指针执行传递进来的函数,注意fp所指的函数是有一个参数的。 */
}
void MyFun1(int x) /* ①. 这是个有一个参数的函数,以下两个函数也相同。 */
{
    printf("MyFun1:%d\n", x);
}
void MyFun2(int x)
{
    printf("MyFun2:%d\n", x);
}
void MyFun3(int x)
{
    printf("MyFun3:%d\n", x);
}

运行结果如下

建议看懂这个示例代码再往下看本篇文章,如果对示例代码有疑问,请移步之前的文章《指针与函数》。

2、为什么需要回调函数

这里先说一下软件分层的问题,软件分层的一般原则是:上层可以直接调用下层的函数,下层则不能直接调用上层的函数。这句话说来简单,在现实中,下层常常要反过来调用上层的函数。

比如你在拷贝文件时,在界面层调用一个拷贝文件函数。界面层是上层,拷贝文件函数是下层,上层调用下层,理所当然。但是如果你想在拷贝文件时还要更新进度条,问题就来了。

一方面,只有拷贝文件函数才知道拷贝的进度,但它不能去更新界面的进度条。另外一方面,界面知道如何去更新进度条,但它又不知道拷贝的进度。怎么办?

常见的做法,就是界面设置一个回调函数给拷贝文件函数,拷贝文件函数在适当的时候调用这个回调函数来通知界面更新状态。

上面主要说的一个大型软件分层理念,作为嵌入式开发程序员,特别是单片机的开发中,由于和硬件结合紧密且需要快速响应,软件结构大部分是面向过程开发的,回调函数使用频率并不高。但在软件中使用回调函数,可以让软件更加模块化。

上图形象展示了回调函数的作用,上面说到了软件分层,在嵌入式代码中我们一般将和硬件交互的代码称为硬件层,业务逻辑代码称为应用层代码,对于优秀的的嵌入式代码,一般要求硬件层和应用层代码分开。

一般的回调函数代码结构如下

typedef void (*ReceiveFarmDataFun)();

static CallbackReceive_t HandlerCompleted;

/*用来注册回调函数的功能函数*/
void CallbackRegister (CallbackFunc_t callback_func) {
     HandlerCompleted = callback_func;
}

3、串口应用

在嵌入式应用中,串口通信是很经典且常用的外设,举一个简单的栗子,接收的串口数据帧头是@,帧尾是*。中间数据不可能出现@和*。那么一般情况下代码如下编写。

/*串口中断函数*/
uint8_t receive_flg = 0;
uint8_t receive_data[100];
uint8_t USART1_data = 0;
uint8_t USART1_data_len = 0;
uint8_t USART1_receive_sta = 0;
void USART1_IRQHandler(void)
{
  uint8_t data_tmp;
  if(USART_GetFlagStatus(USART1, USART_FLAG_RXNE))
  {
    data_tmp = USART_ReceiveData(USART1);
    if((data_tmp == '*')&&(USART1_receive_sta == 1))
    {
      receive_flg = 1;
      USART1_receive_sta = 0;
      receive_data[USART1_data_len++] = data_tmp;
    }
    if(receive_flg == 0){
      if(data_tmp == '@')
      {
        USART1_receive_sta = 1;
        USART1_data_len = 0;
      }
      if(USART1_receive_sta)
        receive_data[USART1_data_len++] = data_tmp;
      if(USART1_data_len > (100-1))
      {
        receive_flg = 0;
        USART1_receive_sta = 0;
      }
    }
    USART_ClearFlag(USART1, USART_FLAG_RXNE);
  }
}
/*应用层代码,简单化->在main函数*/
void main()
{
    /*省略其他代码*/
    while(1)
    {
        if(receive_flg == 1)//通过检查receive_data判断是否接收到函数
        {
          /*通过receive_data数组处理数据*/
          receive_flg = 0;
        }
    }
}

这样实现功能是没有问题的,在我接触到很多的项目中的确是类似的架构,但是它的移植性较差。

还有一种情况,那就是如果你接到需求把硬件层封装给客户使用,不让客户看到源码,封装成库,起到"保护通讯协议"的目的,那么你要告诉客户,需要判断receive_flg变量,然后读取receive_data数组的内容???

不得不说,你这样干是可以的,但是大部分公司不会这样干的。这时候可以使用回调函数来解决这个问题。

/*开放给客户的头文件*/
/* Includes ------------------------------------------------------------------*/
#include <stdio.h>
typedef void (*ReceiveFarmDataFun)(uint8_t *buff,uint32_t bufferlen);
extern void CallbackRegister (CallbackFunc_t callback_func);

/*封装的函数*/
static CallbackReceive_t HandlerCompleted;
void CallbackRegister (CallbackFunc_t callback_func) {
     HandlerCompleted = callback_func;
}
uint8_t receive_flg = 0;
uint8_t receive_data[100];
uint8_t USART1_data = 0;
uint8_t USART1_data_len = 0;
uint8_t USART1_receive_sta = 0;
void USART1_IRQHandler(void)
{
  uint8_t data_tmp;
  if(USART_GetFlagStatus(USART1, USART_FLAG_RXNE))
  {
    data_tmp = USART_ReceiveData(USART1);
    if((data_tmp == '*')&&(USART1_receive_sta == 1))
    {
      receive_flg = 1;
      USART1_receive_sta = 0;
      HandlerCompleted(receive_data,USART1_data_len);
    }
    if(receive_flg == 0){
      if(data_tmp == '@')
      {
        USART1_receive_sta = 1;
        USART1_data_len = 0;
      }
      if(USART1_receive_sta)
        receive_data[USART1_data_len++] = data_tmp;
      if(USART1_data_len > (100-1))
      {
        receive_flg = 0;
        USART1_receive_sta = 0;
      }
    }
    USART_ClearFlag(USART1, USART_FLAG_RXNE);
  }
}

那么客户拿到的有用信息如下

typedef void (*ReceiveFarmDataFun)(uint8_t *buff,uint32_t bufferlen);
extern void CallbackRegister (CallbackFunc_t callback_func);

客户可以写如下代码

void uartdatadeal(uint8_t *buff,uint32_t bufferlen)
{
    /*buff指针存储了串口数据,bufferlen存储数据长度*/
    /*客户的应用层代码*/
}
void main()
{
    /*省略其他代码*/
    CallbackRegister (uartdatadeal);
    while(1)
    {
    }
}

这样的话,就可以解决上述问题,客户只要注册一下串口接收的函数,当接收到有效数据后,就可以跳转到用户的代码,而你可以将自己的硬件层封装起来。

看到这里可能有嵌入式大佬意识到某些问题了,这样写代码,数据处理的函数就等于在中断里了,这是不合理的啊。

是的,是有这个问题,所以给客户的库文件必须说明这一点,让客户自行选择,客户不想在中断中执行,可以再按照我们一开始的逻辑写啊,如下

void uartdatadeal(uint8_t *buff,uint32_t bufferlen)
{
    /*buff指针存储了串口数据,bufferlen存储数据长度*/
    receive_flg = 1;
}
void main()
{
    /*省略其他代码*/
    CallbackRegister (uartdatadeal);
    while(1)
    {
        if(receive_flg == 1)
        {
            /*处理数据*/
           receive_flg = 0;         
        }
    }
}

事实上,芯片/模块厂家写SDK经常这样做,一些大型的开源库也会这样用,典型的如lwip库。

4、后记

读到这里的同学可能觉得这完全是“脱裤子放屁”啊,这属于“炫技”啊,没什么用啊。诚然在很多应用中,特别是一些单片机项目中,代码量不大,使用类似receive_flg全局变量控制,代码结构也清晰啊。

并且项目不需封装库给客户,一个单片机软件开发工程师可以吃透整个项目的代码,根本不需要这样的“骚操作”。

关于回调函数,我的态度是:回调函数可以使我们的代码更高效且更易于维护,降低耦合。明智地使用它们很重要,否则过度使用回调(函数指针)会使代码难以进行排查和调试

 

点击查看本文所在的专辑:C语言进阶专辑

posted @ 2022-04-16 16:51  Fireflycjd  阅读(436)  评论(0编辑  收藏  举报