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键对于每个编程器来说可能不一样
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)