freertos学习笔记1（数据类型，变量名，函数名和宏的命名，tab键和空格键）

来源“野火®]《FreeRTOS 内核实现与应用开发实战—基于STM32》.pdf”，以后不再赘述

一、FreeRTOS 中详细的数据类型重定义在 portmacro.h 这个头文件中实现

 

FreeRTOS 中的数据类型重定义

#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 是有符号的还是无符号的

二、变量名

在 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 这个文件中定义。

 

四、宏的命名

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

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

在贯穿 FreeRTOS 的整个代码中，还有几个通用的宏定义我们也要注意下，都是表示 0和 1 的宏

 

五、格式

一个 tab 键盘等于四个空格键。我们在编程的时候最好使用空格键而不是使用 tab 键，当两个编译器的 tab 键设置的大小不一样的时候，代码移植的时候代码的格式就会变乱，而使用空格键则不会出现这种问题。