好项目,不私藏!适用于单片机开发的开源轮子
点击上方“小麦大叔”,选择“置顶/星标公众号”
福利干货,第一时间送达
大家好,我是小麦。今天推荐一个适用于单片机裸机开发的开源轮子。
QueueForMcu
基于单片机实现的队列功能模块,主要用于8位、16位、32位非运行RTOS的单片机应用,兼容大多数单片机平台。
开源代码:https://github.com/xiaoxinpro/QueueForMcu
一、特性
动态创建队列对象
动态设置队列数据缓冲区
静态指定队列元素数据长度
采用值传递的方式保存队列数据
二、快速使用
#include "queue.h"#define Q_UART_BUFFER_SIZE 1024QUEUE_HandleTypeDef qUartTx;
QUEUE_DATA_T BufferUartTx[Q_UART_BUFFER_SIZE];int main(void)
{QUEUE_DATA_T temp;//初始化队列Queue_Init(&qUartTx, BufferUartTx, Q_UART_BUFFER_SIZE);while(1){//入队Queue_Push(&qUartTx, 'Q');Queue_Push(&qUartTx, 'u');Queue_Push(&qUartTx, 'e');Queue_Push(&qUartTx, 'u');Queue_Push(&qUartTx, 'e');//出队Queue_Pop(&qUartTx, &temp);Queue_Pop(&qUartTx, &temp);Queue_Pop(&qUartTx, &temp);Queue_Pop(&qUartTx, &temp);Queue_Pop(&qUartTx, &temp);}
}
三、配置说明
目前QueueForMcu只有一个静态配置项,具体如下:
在文件 queue.h
中有一个宏定义 QUEUE_DATA_T
用于指定队列元素的数据长度,默认是 unsigned char
,可以根据需要更改为其他数据类型。
四、数据结构
队列的数据结构为 QUEUE_HandleTypeDef
用于保存队列的状态,源码如下:
typedef struct QUEUE_HandleTypeDef{unsigned int head; //队列头指针unsigned int tail; //队列尾指针unsigned int buffer_length; //队列缓存长度(初始化时赋值)QUEUE_DATA_T * buffer; //队列缓存数组(初始化时赋值)
}QUEUE_HandleTypeDef;
其中 QUEUE_DATA_T
为配置项中自定义的数据类型。
五、创建队列
1、创建队列缓存
由于我们采用值传递的方式保存队列数据,因此我们在创建队列前要手动创建一个队列缓存区,用于存放队列数据。
QUEUE_DATA_T BufferUartTx[1024];
以上代码即创建一个大小为 1024
的队列缓存区。
2、创建队列结构
接下来使用 QUEUE_HandleTypeDef
创建队列结构,用于保存队列的状态:
QUEUE_HandleTypeDef qUartTx;
3、初始化队列
准备好队列缓存和队列结构后调用 Queue_Init
函数来创建队列,该函数原型如下:
void Queue_Init(QUEUE_HandleTypeDef * hqueue, QUEUE_DATA_T * buffer, unsigned int len)
参数说明:
参数名 | 描述 |
---|---|
hqueue | 需要初始化的队列结构,如果二次初始化将清空原队列的内容。 |
buffer | 队列缓存的首地址指针 |
len | 队列长度,不能比队列缓存长度还要大。 |
参考代码:
Queue_Init(&qUartTx, BufferUartTx, Q_UART_BUFFER_SIZE);
六、压入队列
1、单数据压入
将数据压入队列尾部使用 Queue_Push
函数,该函数原型如下:
QUEUE_StatusTypeDef Queue_Push(QUEUE_HandleTypeDef * hqueue, QUEUE_DATA_T data)
参数说明:
参数名 | 描述 |
---|---|
hqueue | 需要压入数据的队列结构。 |
data | 待压入队列的数据。 |
返回值说明:
该函数会返回一个 QUEUE_StatusTypeDef
枚举数据类型,返回值会根据队列状态返回以下几个值:
返回值 | 描述 |
---|---|
QUEUE_OK | 数据压入队列成功。 |
QUEUE_OVERLOAD | 未压入数据到队列中,原因队列已满。 |
参考代码:
Queue_Push(&qUartTx, 'Q');
Queue_Push(&qUartTx, 0x51);
Queue_Push(&qUartTx, 81);
2、多数据压入
若需要将多个数据(数组)压入队列可以使用 Queue_Push_Array
函数,原理上循环调用 Queue_Push
函数来实现的,函数原型如下:
unsigned int Queue_Push_Array(QUEUE_HandleTypeDef * hqueue, QUEUE_DATA_T * pdatas, unsigned int len)
参数说明:
参数名 | 描述 |
---|---|
hqueue | 需要压入数据的队列结构。 |
pdatas | 待压入队列的数组首地址。 |
len | 待压入队列的数组长度。 |
当数组长度大于队列剩余长度时,数组多余的数据将被忽略。
返回值说明:
该函数将返回实际被压入到队列中的数据长度。
当队列中的剩余长度富余时,返回值将等于参数
len
的值。当队列中的剩余长度不足时,返回值为实际被压入到队列的数据长度。
七、弹出队列
1、单数据弹出
将队列头部数据弹出队列使用 Queue_Pop
函数,需要注意的是,弹出的数据将从队列中删除,该函数原型如下:
QUEUE_StatusTypeDef Queue_Pop(QUEUE_HandleTypeDef * hqueue, QUEUE_DATA_T * pdata)
参数说明:
参数名 | 描述 |
---|---|
hqueue | 需要弹出数据的队列结构。 |
pdata | 用于保存弹出数据变量的指针。 |
返回值说明:
该函数会返回一个 QUEUE_StatusTypeDef
枚举数据类型,返回值会根据队列状态返回以下几个值:
返回值 | 描述 |
---|---|
QUEUE_OK | 数据弹出队列成功。 |
QUEUE_VOID | 未弹出数据到队列中,原因队列为空。 |
参考代码:
QUEUE_DATA_T temp;
if(QUEUE_OK = Queue_Pop(&qUartTx, &temp))
{// temp 为队列弹出的数据
}
else
{// 弹出数据失败
}
2、多数据弹出
若需要将多个数据弹出队列可以使用 Queue_Pop_Array
函数,原理上循环调用 Queue_Pop
函数来实现的,需要注意的是,成功弹出的数据将从队列中删除,函数原型如下:
unsigned int Queue_Pop_Array(QUEUE_HandleTypeDef * hqueue, QUEUE_DATA_T * pdatas, unsigned int len)
参数说明:
参数名 | 描述 |
---|---|
hqueue | 需要弹出数据的队列结构。 |
pdatas | 用于保存弹出数据数组的首地址。 |
len | 需要弹出数据数组的长度。 |
当需要弹出数据的长度大于队列中的数据长度时,弹出数组多余的空间将不会被赋值。
返回值说明:
该函数将返回实际从队列中弹出的数据长度。
当队列中的数据长度足够时,返回值将等于参数
len
的值。当队列中的数据长度不足时,返回值为实际从队列中弹出的数据长度。
3、单数据复制
当需要从队列头部获取数据,但又不希望数据从队列中删除时,可以使用 Queue_Peek
函数来实现,该函数的参数与返回值与 Queue_Pop
完全相同。
使用 Queue_Peek
和 Queue_Pop
函数的区别在于:
Queue_Pop
得到队列中的数据后会删除队列中的数据。Queue_Peek
得到队列中的数据后会保留队列中的数据。
4、多数据复制
当需要从队列头部获取多个数据,但又不希望数据从队列中删除时,可以使用 Queue_Peek_Array
函数来实现,该函数的参数与返回值与 Queue_Pop_Array
完全相同。
使用 Queue_Peek_Array
和 Queue_Pop_Array
函数的区别在于:
Queue_Pop_Array
得到队列中的数据后会删除队列中的数据。Queue_Peek_Array
得到队列中的数据后会保留队列中的数据。
八、其他功能
1、清空队列
当需要清空队列数据时,无需弹出所有数据,只需要调用 Queue_Clear
即可快速清空指定队列,在创建队列时会调用此函数来初始化队列,因此对于刚创建完成的队列无需调用清空队列函数。
函数原型:
void Queue_Clear(QUEUE_HandleTypeDef * hqueue)
参数说明:
参数名 | 描述 |
---|---|
hqueue | 需要清空的队列结构。 |
2、获取队列数据数量
当需要获取队列中的数据长度时,调用 Queue_Count
函数,函数原型如下:
unsigned int Queue_Count(QUEUE_HandleTypeDef * hqueue)
参数说明:
参数名 | 描述 |
---|---|
hqueue | 需要获取数据长度的队列结构。 |
返回值说明:
该函数将返回队列中的数据长度。
返回值范围在0到创建队列时的长度之间。
—— The End ——
往期推荐
单片机开发从来不用数据结构?
写烂代码的人离职之后...
难倒高手了,c语言枚举end的作用是什么?
30个单片机常见问题解决办法!一般人我不告诉他们
马斯克的脑机接口,一块树莓派就能做出来?
加入嵌入式技术交流群一起进步
点击上方名片关注我
你点的每个好看,我都认真当成了喜欢
好项目,不私藏!适用于单片机开发的开源轮子相关推荐
- 零基础 Ubuntu 20.04.01 下搭建51单片机开发环境[开源编译器SDCC]
原创首发于CSDN,转载请注明出处,谢谢! 文章目录 为何会在Linux下开发单片机 个人系统环境与所用开发板 安装开源编译器 sdcc STC MCU ISP 闪存工具 stcgal 的安装 单片机 ...
- 吃了这个开源小玩意让单片机开发和Arduino一样高效
吃了这个开源小玩意,让单片机开发和Arduino一样高效(全中文注释) 无论你是一个单片机新手,或者是一位电子 DIY的爱好者,还是说是对嵌入式开发感兴趣的工程师,今天这个开源项目值得你看下去. // ...
- 单片机学c语言还是python好_单片机开发用哪种语言最好?
在过去的几十年中,单片机的规格变化不大,但是语言和支持软件的扩展为应用程序开发开辟了许多途径.多年来,对单片机进行编程涉及到两种语言的选择:C语言和汇编语言.但是随着现在可用于微处理器的新语言,用户在 ...
- iOS开发之开源项目库总汇
iOS.mac开源项目及库汇总 UI 下拉刷新 EGOTableViewPullRefresh – 最早的下拉刷新控件. SVPullToRefresh – 下拉刷新控件. MJRefresh – 仅 ...
- 专为物联网开发的开源操作系统Contiki(转)
专为物联网开发的开源操作系统Contiki(转) (2012-04-19 15:31:09) 原文网址:http://blog.sina.com.cn/s/blog_6de000c201010z7n. ...
- 再搞75块单片机开发板!
大家好,我是张巧龙,还记得当初自己用51开发板点亮了第一颗LED灯吗? 51单片机,yyds!不多说,直接抽奖送75块! 兴趣爱好 如果你对一件事失去了兴趣,我觉得你把这件事坚持做下去的概率很低. 反 ...
- 在linux下也能进行51单片机开发吗?送你一份教程。
点击上方"大鱼机器人",选择"置顶/星标公众号" 福利干货,第一时间送达! 阅读文本大概需要 5 分钟. 0 写在前面 在liunx环境下,没有keil这种ID ...
- 单片机开发不可避免会遇到很多头疼的问题
单片机开发不可避免会遇到很多头疼的问题,例如如何分配CPU的时间.其实到了这个阶段我们要越来越灵活的用单片机,如果什么东西都要自己做,你会累死的.你想一想你要开车,不用什么都自己弄吧,买一辆现成的就可 ...
- 使用VScode的EIDE插件进行51单片机开发
使用VScode的EIDE插件进行51单片机开发 由于Keil C51没有代码提示功能,随着STC系列单片机功能的强大,内部寄存器越来越多,没有代码提示功能会造成编程上的困难.此外,一些复杂的变量名, ...
- 一款简单易上手的ARM单片机开发IDE—STduino
一款简单易上手的ARM单片机开发IDE-STduino 前言 STduino介绍 前言 第一眼看到这个IDE,第一反应就是名字有点像TrueSTUDIO,然后我上网查了一下,当然是没有关系的,只能说是 ...
最新文章
- 如何利用高斯混合模型建立更好、更精确的集群?
- java对于数组的定义_Java中方法的定义与使用,以及对数组的初步了解。
- 在麻省理工读计算机专业,看美国的计算机教育(转载)
- springmvc中的全注解模式
- Linux实验一:常用的Linux命令
- Windows驱动程序的加载
- JavaWeb 项目时 启动一个线程
- linux应用程序启动时加载库错误问题
- quartz mysql数据源_Spring之——quartz集群(MySQL数据源)
- sqlite3 的基本使用 以及封装使用
- C# Winform 实现Ajax效果自定义按钮
- 大数据技术体系(长期更新)
- Linux资源控制-CPU和内存
- 电蚊拍一天用30-50次?
- 【免费领取】趣味测试小程序源码/内置超多趣味测评+可插入流量主广告位微信小程序源码
- 树莓派(十三)——使用flask创建视频流媒体服务器
- 吴磊《星汉灿烂》新角色贯穿主线 演技惊喜引期待
- 第40节 指北针实例
- PADS2007如何打印PCB元件的丝印图
- 【Linux】使用阿里yum源,解决yum下载过慢的问题
热门文章
- Delphi10.4.1开发Linux应用视频重播
- McAfee Endpoint Security安装失败排查步骤
- extjs引入html,ExtJs教程第一集 搭建ext环境后的第一个hello World
- python中,(x for y in z for x in y)这个结构怎么理解?
- 数据库:关于BULK INSERT 学习笔记(1)
- 临渊慕鱼,不如退而结网!
- 台达ms300变频器使用手册中文_台达ms300变频器说明书.doc
- 移动咪咕盒子10款型号刷机固件汇总分享(附刷机教程)
- smartsvn 使用
- Ubuntu系统安装字体方法