【FreeRTOS学习计划】第三节 数据结构—列表与列表项

已于 2022-02-20 11:20:52 修改
阅读量382 收藏 2
点赞数 2
分类专栏： FreeRTOS学习（从0到1写FreeRTOS内核） 文章标签： 数据结构 学习 单片机 stm32 freertos
于 2022-02-20 11:03:59 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/picassocao/article/details/123020891
版权

本节的目标

我们想从0到1开始实现FreeRTOS，就需要弄懂列表和列表项的操作，因为在FreeRTOS中存在着大量的基础数据结构列表和列表项的操作。
FreeRTOS源码里注释的list和list item翻译过来就是列表和列表项，对应就是C语言中的链表和节点。
本小节的目的就是初始化列表和列表项结构体，FreeRTOS中对将标准的 C 数据类型重新取名，编写列表相关的操作函数，最后实现一个列表的列表项插入实验。

C语言链表

链表是C语言的一种基本的数据结构，在操作系统中使用的非常多。链表是由节点组成，节点和节点直接首尾相连，节点的作用就是可以挂载很多数据。你可以这样想象一下，现在阳台有一个圆形晾衣环（链表）上面有很多衣架（节点），衣架（节点）可以挂衣服（数据）在上面。
链表分为单项链表和双向链表，单项链表比较少用，一般都是用双向链表。

FreeRTOS中列表的实现

FreeRTOS中列表相关操作的都在list.h和list.c中，我们先新建一个list.h在 freertos/source/include和list.c在freertos/source，然后把它们添加入我们的工程里面来。

定义列表和列表项的数据结构

在list.h中定义列表和列表项的数据结构，具体实现代码如下

定义列表项的数据结构

列表项结构体包含：
记录当前列表项所在列表排序位置的辅助值xItemValue
该列表项指向下一个列表项* pxNext
该列表项指向上一个列表项* pxPrevious
该列表项的拥有者* pvOwner
该列表项所在哪一个的列表里面*pvContainer
在这里插入图片描述

/* 列表项结构体定义 */
struct xLIST_ITEM
{
    TickType_t xItemValue;					/* 辅助值，用于帮助列表项做顺序排列 */	
	struct xLIST_ITEM * pxNext;			    /* 指向当前列表项的下一个列表项 */
	struct xLIST_ITEM * pxPrevious;	        /* 指向当前列表项的上一个列表项*/
	void * pvOwner;						   /* 指向拥有该列表项的内核对象，通常是 TCB */
	void * pvContainer;					 /* 指向该列表项所在的列表 */
};
typedef struct xLIST_ITEM ListItem_t;/* 列表项数据类型重定义 */

列表的数据结构

列表结构体包含：
列表的列表项计数器uxNumberOfItems
指向列表的列表项索引*pxIndex
列表的最后一个列表项xListEnd
xListEnd是xMINI_LIST_ITEM结构体，xMINI_LIST_ITEM翻译过来就是精简的列表项。

xMINI_LIST_ITEM结构体包含：
记录当前列表项所在列表排序位置的辅助值xItemValue
该列表项指向下一个列表项* pxNext
该列表项指向上一个列表项* pxPrevious
在这里插入图片描述

/* 列表的根列表项结构体定义 */
typedef struct xLIST
{
  UBaseType_t uxNumberOfItems;    /* 列表的列表项计数器 */
  ListItem_t * pxIndex;           /* 列表的索引列表项指针 */
  MiniListItem_t xListEnd;        /* 列表最后列表项 */
} List_t;

/* mini列表项结构体定义，作为列表结尾的列表项
   因为列表是首尾相连的，头即是尾，尾即是头 */
struct xMINI_LIST_ITEM
{
    TickType_t xItemValue;                        /* 辅助值，用于帮助列表项做升序排列 */
	struct xLIST_ITEM * pxNext;                   /* 指向列表下一个列表项 */
	struct xLIST_ITEM * pxPrevious;               /* 指向列表上一个列表项 */
};
typedef struct xMINI_LIST_ITEM MiniListItem_t;  /* 精简列表项数据类型重定义 */

FreeRTOS 将标准的 C 数据类型重新取名

在 FreeRTOS 中，凡是涉及数据类型的地方，FreeRTOS 都会将标准的 C 数据类型用 typedef重新取一个类型名。这些经过重定义的数据类型放在 portmacro.h。我们需要新建一个portmacro.h在 freertos/source/portable中。

#ifndef PORTMACRO_H
#define PORTMACRO_H

#include "stdint.h"
#include "stddef.h"


/* 数据类型重定义 */
#define portCHAR		char
#define portFLOAT		float
#define portDOUBLE		double
#define portLONG		long
#define portSHORT		short
#define portSTACK_TYPE	uint32_t
#define portBASE_TYPE	long

typedef portSTACK_TYPE StackType_t;
typedef long BaseType_t;
typedef unsigned long UBaseType_t;

#if( configUSE_16_BIT_TICKS == 1 )
	typedef uint16_t TickType_t;
	#define portMAX_DELAY ( TickType_t ) 0xffff
#else
	typedef uint32_t TickType_t;
	#define portMAX_DELAY ( TickType_t ) 0xffffffffUL
#endif

#endif /* PORTMACRO_H */

再新建FreeRTOS用到的三个头文件FreeRTOS.h和FreeRTOSConfig.h存放在文件夹freertos/source、portable.h存放在freertos/source/portable。

FreeRTOS.h

#ifndef INC_FREERTOS_H
#define INC_FREERTOS_H

#include "FreeRTOSConfig.h"
#include "portable.h"

#endif /* INC_FREERTOS_H */

FreeRTOSConfig.h

#ifndef FREERTOS_CONFIG_H
#define FREERTOS_CONFIG_H

#define configUSE_16_BIT_TICKS    0

#endif /* FREERTOS_CONFIG_H */

portable.h

#ifndef PORTABLE_H
#define PORTABLE_H

#include "portmacro.h"

#endif /* PORTABLE_H */

列表有关的操作函数

这样FreeRTOS用到的头文件都基本配置完成了，接下来编写list.c看看列表有关的操作函数怎么实现的。

列表项的初始化

列表项的初始化只需要初始化pvContainer，让列表项当前所在的列表为空就可以了。

/* 列表项初始化 */
void vListInitialiseItem( ListItem_t * const pxItem )
{
  /* 初始化该列表项所在的列表为空，表示列表项还没有插入任何列表 */
  pxItem->pvContainer = NULL;
}

列表的根列表项（列表）初始化

/* 列表的根列表初始化 */
void vListInitialise( List_t * const pxList )
{
	/* 将列表索引指针指向最后一个列表项 */
  pxList->pxIndex = ( ListItem_t * ) &( pxList->xListEnd );
	
	/* 将列表最后一个列表项的辅助排序的值设置为最大，确保该列表项就是列表的最后列表项 */
	pxList->xListEnd.xItemValue = portMAX_DELAY;

	/* 将最后一个列表项的pxNext和pxPrevious指针均指向列表项自身，表示列表为空 */
	pxList->xListEnd.pxNext = ( ListItem_t * ) &( pxList->xListEnd );
	pxList->xListEnd.pxPrevious = ( ListItem_t * ) &( pxList->xListEnd );
	
	/* 初始化列表的列表项计数器的值为0，表示列表为空 */
	pxList->uxNumberOfItems = ( UBaseType_t ) 0U;

}

在这里插入图片描述

将列表项按照升序排列插入到列表

将列表项按照升序排列插入到列表，如果有两个列表项的值相同，则新列表项在旧列表项的后面插入。

/* 将列表项按照升序排列插入到列表 */
void vListInsert( List_t * const pxList, ListItem_t * const pxNewListItem)
{
  ListItem_t *pxIterator;
	
	/* 获取列表项的排序辅助值 */
	const TickType_t xValueOfInsertion = pxNewListItem->xItemValue;
	
	/* 寻找列表项要插入的位置 */
	if( xValueOfInsertion == portMAX_DELAY )
	{
	  pxIterator = pxList->xListEnd.pxPrevious;
	}
	else
	{
	  for( pxIterator = ( ListItem_t * ) &( pxList->xListEnd);
		     pxIterator->pxNext->xItemValue <= xValueOfInsertion;
		     pxIterator = pxIterator->pxNext )
		{
		  /* 没有事情可做，不断迭代只为了找到列表项要插入的位置 */
		}
	}
	
	pxNewListItem->pxNext = pxIterator->pxNext;//①
	pxNewListItem->pxNext->pxPrevious = pxNewListItem;//②
	pxNewListItem->pxPrevious = pxIterator;//③
	pxIterator->pxNext = pxNewListItem;//④
	
	/* 记住该列表项所在的列表 */
	pxNewListItem->pvContainer = ( void * ) pxList;//⑤
	
	/* 列表的列表项计数器++ */
	( pxList->uxNumberOfItems )++;//⑥
}

在这里插入图片描述

将列表项插入到列表的尾部

将列表项插入到列表的尾部（可以理解为头部）就是将一个新的列表项插入到一个空的列表。

/* 将列表项插入到列表的尾部 */
void vListInsertEnd( List_t * const pxList, ListItem_t * const pxNewListItem )
{
    ListItem_t * const pxIndex = pxList->pxIndex;
	pxNewListItem->pxNext = pxIndex;//①
	pxNewListItem->pxPrevious = pxIndex->pxPrevious;//②
	pxIndex->pxPrevious->pxNext = pxNewListItem;//③
	pxIndex->pxPrevious = pxNewListItem;//④
	
	/* 记住该列表项所在的列表 */
	pxNewListItem->pvContainer = ( void * ) pxList;//⑤
	
	/* 列表的列表项计数器++ */
	( pxList->uxNumberOfItems )++;//⑥

}

在这里插入图片描述

将列表项从列表删除

/* 将列表项从列表中删除 */
UBaseType_t uxListRemove( ListItem_t * const pxItemToRemove)
{
  /* 获取列表项所在的列表 */
    List_t * const pxList = ( List_t * ) pxItemToRemove->pvContainer;
	
	pxItemToRemove->pxNext->pxPrevious = pxItemToRemove->pxPrevious;
	pxItemToRemove->pxPrevious->pxNext = pxItemToRemove->pxNext;
	
	/* 调整列表的列表项索引指针 */
	if( pxList->pxIndex == pxItemToRemove )
	{
	  pxList->pxIndex = pxItemToRemove->pxPrevious;
	}
	/* 初始化该列表项所在的列表为空，表示列表项还没有插入任何列表 */
	pxItemToRemove->pvContainer = NULL;
	
	/* 列表的列表项计数器-- */
	( pxList->uxNumberOfItems )--;
	
	/* 返回列表中剩余列表项的个数 */
	return pxList->uxNumberOfItems;
	
}

在这里插入图片描述

列表的列表项插入实验

我们新建一个根列表项（也可以理解为列表）和三个普通列表项，然后将这三个普通列表项按照节点的排序辅助值做升序排列插入到列表中

/*
*************************************************************************
*                             包含的头文件
*************************************************************************
*/
#include "list.h"

/*
*************************************************************************
*                              全局变量
*************************************************************************
*/

/* 定义列表的根列表项 */
struct xLIST       List_Test;//定义列表的根列表项，有根了，列表项才能在此基础上生长

/* 定义列表项 */
struct xLIST_ITEM  List_Item1;
struct xLIST_ITEM  List_Item2;
struct xLIST_ITEM  List_Item3;


/*
************************************************************************
*                                main函数
************************************************************************
*/
int main(void)
{
	
	/* 列表的根列表项初始化 */
	vListInitialise( &List_Test );
	
	/* 列表项1初始化 */
	vListInitialiseItem( &List_Item1 );
	List_Item1.xItemValue = 1;
	
	/* 列表项初始化 */
	vListInitialiseItem( &List_Item2 );
	List_Item2.xItemValue = 2;
	
	/* 列表项初始化 */
	vListInitialiseItem( &List_Item3 );
	List_Item3.xItemValue = 3;
	
	/* 将列表项插入列表，按照升序排列 */
	vListInsert( &List_Test, &List_Item1);
	vListInsert( &List_Test, &List_Item2);
	vListInsert( &List_Test, &List_Item3);
	
	for(;;)
	{
			/*啥事不干*/
	}

}

在这里插入图片描述
实验现象
在这里插入图片描述

参考资料：参考资料：《FreeRTOS 内核实现与应用开发实战—基于RT1052》

PicassoCao
关注
  • 2
    点赞
  • 踩
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
FreeRTOS内核——数据结构链表
qq_53671582的博客
04-17 1091
1.数据结构 1.1 list与list item 也就是c语言中的链表与链表结点 单项链表很少用，多用双向链表 1.1.1 list (List_t) list就是一串链表，具体来说就是这一串链表的头结点。因此，一个list对象就代表着一串链表，通过它可以找到这一串链表中的每一个结点 结构体定义如下： typedef struct xLIST { UBaseType_t uxNumberOfItems; /*链表结点计数器*/ ListItem_t * pxIndex; /*链表结点索引
FreeRTOS内核学习笔记记录（一）——基础数据结构(List.c)
weixin_41673690的博客
03-22 303
FreeRTOS的基础数据结构List.c
FreeRTOS学习，适用于FreeRTOS初学者，FreeRTOS整体知识框架
热门推荐
tyh19820234964的博客
06-21 1万+
一、为什么要学习FreeRTOS逻辑系统与多任务系统2、数据结构-列表与列表项三、任务3.2状态四、机制
【FreeRTOS源码阅读】<1> list.c
nickatcsdn的博客
10-23 903
struct xLIST_ITEM { TickType_t xItemValue; /*< 链表节点的值。 在大多数情况下，它用于按降序对列表进行排序 */ struct xLIST_ITEM * pxNext; /*< 指向链表中下一个 ListItem_t */ struct xLIST_ITEM * pxPrevious; /*< 指向链表中上一个 Lis...
FreeRTOS操作系统——列表与列表项（四）
戚晨夕的博客
01-17 548
FreeRTOS操作系统学习 文章目录FreeRTOS操作系统学习前言一、列表与列表项定义列表和列表项初始化列表和列表项给列表项赋值（ListItem1.xItemValue）打印列表和列表项地址给列表插入列表项列表项的删除1.第一种方法2.采用索引的方法删除末尾插入列表项总结 前言 列表是 FreeRTOS 中的一个数据结构，概念上和链表有点类似，列表被用来跟踪 FreeRTOS中的任务。与列表相关的全部东西都在文件 list.c 和 list.h 中。 列表项就是存放在列表中的项目，FreeRTOS
NXP i.MX RT1052 FreeRTOS实战：列表与列表项
12-01
NXP i.MX RT1052 FreeRTOS实战。NXP i.MX RT1052驱动程序。资源代码可直接编译、运行。
正点原子列表和列表项实验复现资料
最新发布
05-23
【正点原子】列表和列表项实验复现资料
FreeRTOS列表和列表项实验 免费提供
05-23
正点原子列表和列表项实验复现 自己总结的md文件资料
code3列表项实验.zip
04-08
实验分析参考博客
FreeRTOS列表项的插入和删除实验
06-15
"FreeRTOS学习笔记——FreeRTOS 列表和列表项"博客中使用的代码
FreeRTOS 列表与列表项 实验
weixin_59349642的博客
03-02 301
目录列表与列表项相关API函数 列表与列表项 列表是FreeRTOS的一种数据结构，概念和数据结构与算法的链表相似。 跟踪FreeRTOS的任务可以用列表实现。 相关的结构体 1 listFIRST_LIST_INTEGRITY_CHECK_VALUE :检查XXX类型校验值 5 listSECOND_LIST_INTEGRITY_CHECK_VALUE:检查XX类型校验值 1 5 是两种不一样的校验值 用于检查列表的完整性 需要把对应的宏置1 1 5 现在暂时用不到 重点讨论 234
FreeRTOS基础知识
anglebaby331的博客
10-03 432
FreeRTOS任务特性： 简单； 没有使用限制； 支持抢占； 支持优先级； 每个任务都有堆栈，但也导致了RAM使用量增大； 如果使用强化在哪的话必须仔细考虑重入的问题； 协程 FreeRTOS的协程已经不再更新维护，不用考虑了； FreeRTOS任务状态 运行态 就绪态 阻塞态 挂起态 任务优先级 任务优先级决定了任务的执行优先级别，在FreeR...
FreeRTOS高级篇1---FreeRTOS列表和列表项
ba_wang_mao的专栏
03-17 285
FreeRTOS内核调度大量使用了列表（list）和列表项（list item）数据结构。我们如果想一探FreeRTOS背后的运行机制，首先遇到的拦路虎就是列表和列表项。对于FreeRTOS内核来说，列表就是它最基础的部分。我们在这一章集中讲解列表和列表项的结构以及操作函数，在下一章讲解任务创建时，会用到本章的知识点。 列表被FreeRTOS调度器使用，用于跟踪任务，处于就绪、挂起、延时...
FreeRtos学习笔记（11）查找就绪任务中优先级最高任务原理刨析
不咸不要钱
11-02 8526
FreeRtos学习笔记（11）查找就绪任务中优先级最高任务原理刨析 怎么查找就绪任务中优先级最高的？ tasks.c中声明了一个全局变量 uxTopReadyPriority，任务从其他状态进入就绪态时，需要修改 uxTopReadyPriority，将就绪任务优先级信息保存在 uxTopReadyPriority 中。在FreeRtos进行剪裁时，如果最大任务优先级 configMAX_PRIORITIES 不超过32，则任务就绪时会将 uxTopReadyPriority 中任务优先级对应的位置一（
12.FreerRTOS学习笔记-链表的使用
Car12
01-17 667
数据结构的内部数据结构 双向节点的定义 struct xLIst_ITEM { TickType xItemValue; //辅助值，用于节点做顺序排列 struct xList_ITEM *pxNect; // 指向下一个节点 struct xList_ITEM *pxFrevious; //指向上一个节点 void *pvOwner; // 指向拥有该节点的内核对象 void *pvContainer; // 指向该节点所在的对象
FreeRTOS列表和列表项
Zach_z的博客
09-05 4096
FreeRTOS 列表和列表项
FreeRTOS数据结构（一）-链表和链表项
TimeZone
04-28 772
结构体定义 /*链表结构体*/ typedef struct xLIST { listFIRST_LIST_INTEGRITY_CHECK_VALUE /*用于链表完整性检查*/ configLIST_VOLATILE UBaseType_t uxNumberOfItems; /*记录链表项数目*/ ListItem_t * configLIST_VOLATILE ...
链表文件夹C语言,FreeRTOS 笔记之③：数据结构-- 列表和表项（链表和节点）
weixin_39945523的博客
05-22 169
目录1. C语言链表1.1 单向链表1.2 双向链表1.3 链表的操作1.4 链表与数组的对比2. FreeRTOS中链表的实现2.1 实现链表节点2.2 实现链表根节点2.2.1 根节点数据结构2.2.2 链表根节点的初始化2.2.3 将节点插入到链表的尾部2.2.4 将节点按照升序排列插入到链表2.2.5 将节点从链表删除2.2.6 节点带参宏小函数3. 链表节点插入实验在FreeRTOS中存...
FreeRTOS基础及其应用 (入门简化版)
嵌入式系统程序员
11-15 7967
FreeRTOS基础及其应用 本文只是个人整理，可能存在问题. 其目的只是简要介绍系统的基础，只能作为入门资料。 程俊 2020.11.15   目录 一、 为什么要学习 RTOS 4 1.1 前后台系统 4 1.2 多任务系统 4 1.3 学习RTOS的意义 5 二、 操作系统基础 6 2.1 链表 6 2.2 队列 6 2.3 任务 7 2.4 临界区 8 三、 初识 FreeRTOS 8 3.1 FreeRTOS源码 8 3.1.1 Source 文件夹 8 3.1.2 Demo 文件夹 9 3.1.
freertos学习
08-11
你可以参考野火的《Freertos内核实现与应用开发指南》获取更详细的内容。同时，你也可以在野火官方下载中心下载相关的资料查看。<span class="em">1</span><span class="em">2</span><span class="em">3 #### 引用[....

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值