标题: [开源]轻量级环形缓冲区Ring Buffer，非常适合用于MCU嵌入式平台的串口收发 [打印本页]
作者: netube    时间: 2021-1-30 11:53
标题: [开源]轻量级环形缓冲区Ring Buffer，非常适合用于MCU嵌入式平台的串口收发
Ring Buffer是一个基于C语言开发的轻量级环形缓冲区，适用于各嵌入式平台的串口收发等应用场景；

相较于普通的收发缓冲数组，环形缓冲区的操作更加简单，性能更加强大；
使用Ring Buffer提供的函数，可以轻松实现数据的读写、查询、删除等操作，不需要编写复杂的地址记录、读写计数等代码，减少了数据指针溢出、数据被覆盖的风险；
同时Ring Buffer还提供了可自定义分隔关键字的插入、查找等功能，运用在嵌入式的串口收发中可以实现多段数据的储存，段落之间分隔独立，读写缓冲区不再受到硬件时序的阻塞，降低串口对芯片实时响应的要求并提升了数据传输的可靠性；

代码已在GD32F130C8T6 MCU平台上通过编译，已进行过大量数据的串口收发压力测试，暂未发现显性BUG；
项目开源地址：Github



2021.01.19 v1.0.0 发布第一版本
2021.01.24 v1.1.0 增加匹配字符查找函数
2021.01.27 v1.2.0 重制匹配字符查找函数，现已支持8位到32位关键词查询
2021.01.28 v1.3.0 复位函数修改为删除函数、增加关键词插入函数（自适应大小端）
2021.01.30 v1.3.1 修复String读写函数的小概率指针溢出错误
持续更新中，欢迎大家使用，如果有BUG请到Github上及时向我反馈，谢谢

同时我在GD32F130平台上基于Ring Buffer库开发了一款单片机串口收发框架UIO，开发UIO的目的也是为了更好的利用Ring Buffer的特点，在实际使用环形缓冲的过程中不断的优化与改进；
使用UIO后，你可以在单片机中同时缓存好几条串口指令却不需要实时处理，等到单片机忙完其他阻塞任务后再将接收缓存的串口数据逐条读出并逐条处理，从容不迫；
UIO的大部分代码与平台分离，移植简单，同时对硬件串口外设进行封装，在应用层开发的时候非常方便，UIO仍在加紧时间开发并测试，届时将会第一时间开源分享给大家吐槽，敬请期待吧！

欢迎关注我的b站视频账号：bilibili
作者: netube    时间: 2021-1-30 12:12
复制库文件至工程中，在源代码中引用 Ring Buffer 头文件；
新建一个 uint8_t 数组，数组的大小即是环形缓冲区的大小；
新建 Ring Buffer 操作句柄；
初始化 Ring Buffer 操作句柄，将其与刚才新建的数组绑定，转换成环形缓冲区；
这时候我们就可以使用库提供的各种函数对新建的缓冲区进行读写等操作；
函数详细内容请在编程的过程中参考ring_buffer.c内的注释；
作者: netube    时间: 2021-1-30 12:13
在这里我展示了如何新建并初始化Ring Buffer、读写环形缓冲、查询数据长度等基础操作
您可以了解到Ring Buffer的函数命名与参数的风格和基本的使用方法
  1. #include <stdio.h>
  2. #include <ring_buffer.h>

  4. #define Read_BUFFER_SIZE        256

  6. int main()
  7. {
  8.     //新建缓冲区数组与Ring Buff操作句柄
  9.     uint8_t buffer[Read_BUFFER_SIZE] ;
  10.     ring_buffer RB ;

  12.     //初始化Ring Buff操作句柄，绑定缓冲区数组；
  13.     Ring_Buffer_Init(&RB, buffer, Read_BUFFER_SIZE);

  15.     //向环形缓冲区写入一段字节和一个字节
  16.     Ring_Buffer_Write_String(&RB, "hello world", 11);
  17.     Ring_Buffer_Write_Byte(&RB, '!');

  19.     //获取已储存的数据长度，读出环形缓冲区中的数据并打印
  20.     uint32_t num = Ring_Buffer_Get_Lenght(&RB);
  21.     uint8_t get[16] ;
  22.     Ring_Buffer_Read_String(&RB, get, num);
  23.     printf("%s", get);
  24.    
  25.     return 0 ;
  26. }
复制代码
作者: netube    时间: 2021-1-30 12:13
除了基本的读写操作之外，为了更好的利用环形这一特点，我加入了分隔关键词、查询关键词、删除数据等功能
基于这些功能您可以在串口收发中实现多段数据的缓存与准确读取；降低了实时性响应的要求、提升了串口收发的性能
  1. #include <stdio.h>
  2. #include <ring_buffer.h>

  4. #define Read_BUFFER_SIZE        256

  6. //设定一个分隔关键词和关键词的长度（字节）
  7. #define SEPARATE_SIGN       0xCCFB22AA
  8. #define SEPARATE_SIGN_SIZE  4

  10. int main()
  11. {
  12.     //新建缓冲区数组与Ring Buff操作句柄
  13.     uint8_t buffer[Read_BUFFER_SIZE] ;
  14.     ring_buffer RB ;

  16.     //初始化Ring Buff操作句柄，绑定缓冲区数组；
  17.     Ring_Buffer_Init(&RB, buffer, Read_BUFFER_SIZE);

  19.     //记录段落数量
  20.     uint8_t String_Count = 0 ;

  22.     //向环形缓冲区写入三段数据，每段之间插入一个分隔关键词
  23.     Ring_Buffer_Write_String(&RB, "ABCDEFGHIJK\r\n", 13);//写入一段数据
  24.     Ring_Buffer_Insert_Keyword(&RB, SEPARATE_SIGN, SEPARATE_SIGN_SIZE);//插入一个分隔关键词
  25.     String_Count ++ ;//记录段落数量 +1

  27.     Ring_Buffer_Write_String(&RB, "abcdefg\r\n", 9);
  28.     Ring_Buffer_Insert_Keyword(&RB, SEPARATE_SIGN, SEPARATE_SIGN_SIZE);
  29.     String_Count ++ ;

  31.     Ring_Buffer_Write_String(&RB, "1234\r\n", 6);
  32.     Ring_Buffer_Insert_Keyword(&RB, SEPARATE_SIGN, SEPARATE_SIGN_SIZE);
  33.     String_Count ++ ;

  35.     while(String_Count != 0)
  36.     {
  37.         uint8_t get[16] ;
  38.         //获得头指针到关键词高位的距离，距离-1得到第一段数据的长度
  39.         uint8_t lenght = Ring_Buffer_Find_Keyword(&RB, SEPARATE_SIGN, SEPARATE_SIGN_SIZE) - 1 ;
  40.         Ring_Buffer_Read_String(&RB, get, lenght);//读取一段数据，保存到get数组
  41.         printf("%s", get);//打印数据
  42.         Ring_Buffer_Delete(&RB, SEPARATE_SIGN_SIZE);//删除分隔关键词的长度的数据，即删除关键词
  43.         String_Count -- ;//记录段落数量 -1
  44.     }

  46.     return 0 ;
  47. }
复制代码




欢迎光临 (http://www.51hei.com/bbs/) Powered by Discuz! X3.1