1. 数据类型

位置：书P12
在 FreeRTOS 中， int 型从不使用， 只使用 short 和 long 型。 在 Cortex-M 内核的 MCU 中， short 为 16 位， long 为 32位。

新定义的数据类型 实际的数据类型（C 标准类型）
portCHAR char
portSHORT short
portLONG long（这个和int一样）
portTickType unsigned short int （无符号short）
unsigned int 用于定义系统时基计数器的值和阻塞时间的 值 。 FreeRTOSConfig.h 头 文 件 中的宏configUSE_16_BIT_TICKS 为 0 时则为 32位。
portBASE_TYPE long 
  1. #define portCHAR char
  2. #define portFLOAT float
  3. #define portDOUBLE double
  4. #define portLONG long
  5. #define portSHORT short
  6. #define portSTACK_TYPE uint32_t        // 无符号整型
  7. #define portBASE_TYPE long
  9. typedef portSTACK_TYPE StackType_t;
  10. typedef long BaseType_t;
  11. typedef unsigned long UBaseType_t;
  13. #if( configUSE_16_BIT_TICKS == 1 )
  14. typedef uint16_t TickType_t;
  15. #define portMAX_DELAY ( TickType_t ) 0xffff
  16. #else
  17. typedef uint32_t TickType_t;
  18. #define portMAX_DELAY ( TickType_t ) 0xffffffffUL

在编程的时候，如果用户没有明确指定 char 的符号类型， 那么编译器会默认的指定char 型的变量为无符号或者有符号。正是因为这个原因，在 FreeRTOS 中，我们都需要明确的指定变量 char 是有符号的还是无符号的。
image.png

2. 变量名称

在 FreeRTOS 中，定义变量的时候往往会把变量的类型当作前缀加在变量上， 这样的好处是让用户一看到这个变量就知道该变量的类型。

  • char 型变量的前缀是 c
  • short 型变量的前缀是 s
  • long 型变量的前缀是 l
  • portBASE_TYPE 类型变量的前缀是 x
  • 比如数据结构，任务句柄， 队列句柄等定义的变量名的前缀也是 x
  • 无符号型的那么会有一个前缀 u
  • 一个指针变量则会有一个前缀 p

因此，当我们定义一个无符号的 char 型变量的时候会加一个 uc 前缀， 当定义一个char 型的指针变量的时候会有一个 pc 前缀。

3. 函数名

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

  1. vTaskPrioritySet()函数的返回值为 void 型， 在task.c 这个文件中定义。
  2. xQueueReceive()函数的返回值为 portBASE_TYPE 型， 在 queue.c 这个文件中定义。
  3. vSemaphoreCreateBinary()函数的返回值为 void 型， 在 semphr.h 这个文件中定义。

    4.宏

    宏均是由大写字母表示，并配有小写字母的前缀， 前缀用于表示该宏在哪个头文件定义。
前缀 宏定义的文件
port (举例, portMAX_DELAY) portable.h
task (举例, taskENTER_CRITICAL()) task.h
pd (举例, pdTRUE) projdefs.h
config(举例, configUSE_PREEMPTION) FreeRTOSConfig.h
err (举例, errQUEUE_FULL) projdefs.h

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

表示 0和 1 的宏，

宏 实际的值
pdTRUE 1
pdFALSE 0
pdPASS 1
pdFAIL 0

5. 格式

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