FreeRTOS学习记录（一）：数据、变量、函数特点

2022-04-22

依据：[野火]《FreeRTOS内核实现与应用开发实战指南》

---

目录

数据类型

变量名

函数名

宏

---

数据类型

FreeRTOS对C里的数据类型做了重定义，在portmacro.h文件中

//portmacro.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

变量名

在FreeRTOS 中，定义变量的时候往往会把变量的类型当作前缀加在变量上，这样的 好处是让用户一看到这个变量就知道该变量的类型。比如 char 型变量的前缀是 c，short 型 变量的前缀是 s，long 型变量的前缀是 l， portBASE_TYPE 类型变量的前缀是 x。还有其他 的数据类型，比如数据结构，任务句柄，队列句柄等定义的变量名的前缀也是 x。 如果一个变量是无符号型的那么会有一个前缀 u，如果是一个指针变量则会有一个前缀 p。因此，当我们定义一个无符号的 char 型变量的时候会加一个 uc 前缀，当定义一个 char 型的指针变量的时候会有一个 pc 前缀。

函数名

函数名包含了函数返回值的类型、函数所在的文件名和函数的功能，如果是私有的函 数则会加一个 prv（private）的前缀。特别的，在函数名中加入了函数所在的文件名，这大 大的帮助了用户提高寻找函数定义的效率和了解函数作用的目的，具体的举例如下：

1. vTaskPrioritySet()函数的返回值为 void 型，在task.c 这个文件中定义。

2. xQueueReceive()函数的返回值为 portBASE_TYPE 型，在 queue.c 这个文件中定义。

3. vSemaphoreCreateBinary()函数的返回值为 void 型，在 semphr.h 这个文件中定义。

宏

宏均是由大写字母表示，并配有小写字母的前缀，前缀用于表示该宏在哪个头文件定义

前缀	宏定义文件
port (举例, portMAX_DELAY)	portable.h
task (举例, taskENTER_CRITICAL())	task.h
pd (举例, pdTRUE)	projdefs.h
config(举例, configUSE_PREEMPTION)	FreeRTOSConfig.h
err (举例, errQUEUE_FULL)	projdefs.h

这里有个地方要注意的是信号量的函数都是一个宏定义，但是它的函数的命名方法是 遵循函数的命名方法而不是宏定义的方法。

---

信号量（semaphore）是操作系统用来解决并发中的互斥和同步问题的一种方法。

操作系统——信号量（理解什么是信号量，信号量如何解决同步互斥问题，信号量一些注意点）_五斤w的博客-CSDN博客_信号量

---

在贯穿 FreeRTOS 的整个代码中，还有几个通用的宏定义

宏	值
pdTRUE	1
pdFALSE	0
pdPASS	1
pdFAIL	0

尽量使用空格键，TAB键对于每个编程器来说可能不一样