一文带你快速理解FreeRTOS代码规范

其内核代码文件就这几个，非常简洁:

• croutine.c/croutine.h: 协程，在8位/16位平台下效率比较高，在32位平台建议使用任务task

• event_groups.c / event_groups.h:顾名思义，这个是事件组的实现

• heap_x.c：内核堆实现，FreeRTOS提供了heap_1.c ～ heap_5.c 5种堆管理器，各有优缺点，需要根据应用进行选择。

• list.c/list.h：链表实现，主要为调度器提供数据结构算法支持服务。比如任务链表。

• port.c/portmacro.h：硬件相关层级可移植抽象，主要包括SysTick中断，上下文切换，中断管理，具体实现很大程度上取决于平台（单片机体系硬件内核和编译器工具集）。通常以汇编语言实现。

• queue.c/queue.h/semphr.h：信号量、互斥体实现

• tasks.c/task.h:任务管理器实现

• timers.c/timers.h：软件定时器实现

• FreeRTOS.h：选编译配置文件，用于汇总所有源文件的编译选择控制

• FreeRTOSConfig.h：FreeRTOS内核配置，Tick时钟和irq中断配置

接下来整理一下，相关的代码规范，具体就体现在上述文件的编码中。

变量

变量有严格的前缀标识变量类型属性：

• c – char 字符型变量

• s – short 短型变量

• l – long  长整型变量

• x – portBASE_TYPE 在 portmacro.h 中定义，便于移植的数据类型转定义

• u – unsigned 无符号整型

• p - pointer 指针

举例：

//x表示portBASE_TYPE, u 表示无符号型
PRIVILEGED_DATA static volatile TickType_t xTickCount = ( TickType_t ) configINITIAL_TICK_COUNT;
PRIVILEGED_DATA static volatile UBaseType_t uxTopReadyPriority = tskIDLE_PRIORITY;

//比如在list.h 中
struct xLIST_ITEM
{
    configLIST_VOLATILE TickType_t xItemValue;
    //指针以p打头
    struct xLIST_ITEM * configLIST_VOLATILE pxNext; 
    struct xLIST_ITEM * configLIST_VOLATILE pxPrevious; 
    void * pvOwner; 
    struct xLIST * configLIST_VOLATILE pxContainer; 
};

对于C语言的基本数据类型，做了可移植转定义：

#define portCHAR          char
#define portFLOAT         float
#define portDOUBLE        double
#define portLONG          long
#define portSHORT         short
#define portSTACK_TYPE    uint32_t
#define portBASE_TYPE     long

函数

前缀：

• v ：void 无返回类型

• x ：返回portBASE_TYPE

• prv ：私有函数，模块内使用

//ux 表示无符号portBASE_TYPE 返回值
//List表示该函数所属文件
//Remove函数名
UBaseType_t uxListRemove( ListItem_t * const pxItemToRemove ) PRIVILEGED_FUNCTION;

//又比如prv 表示模块内函数
static TickType_t prvGetNextExpireTime( BaseType_t * const pxListWasEmpty ) PRIVILEGED_FUNCTION;

宏

定义宏所属文件，也即在哪个文件内定义的：

• port：比如portable.h中portMAX_DELAY

• task：比如task.h中task_ENTER_CRITICAL

• pd ：例如projdefs.h中定义的pdTRUE

• config：例如 FreeRTOSConfig.h中定义的configUSE_PREEMPTION

• err：例如 projdefs.h中定义的errQUEUE_FULL

至于这么严格的代码规范是否值得推崇，这个见仁见智，个人比较喜欢Linux代码风格，对于过于复杂的代码规范，在实际开发中个人觉得有时候会让人不爽。

—END—

往期精彩推荐，点击即可阅读

▲Linux驱动相关专辑 

▲手把手教信号处理专辑

▲单片机相关专辑