我们知道,代码的命名是需要有规范的,因为不同的程序员风格都不一样,所以需要有一个规范对他们进行约束以保证代码的风格的一致性,这样便于后人阅读,也便于维护。FreeRTOS也不例外,它也有它自己的代码风格。
一、数据类型(Data types)
FreeRTOS在不同的平台下面的文件夹里都有一个独一无二的头文件“portmacro.h”,它里面定义了两个针对平台的数据类型。它们分别是TickType_t和BaseType_t。
二、变量命名规则:
FreeRTOS的变量名称采用前缀来标识变量的类型。对应关系如下
如果是无符号类型,那么变量名称的前面就会多一个’u‘字符,如’uc‘前缀就代表unsigned char类型,依次类推。如果是指针类型,前缀就会多一个’p‘字符,如’pc'前缀就是unsigned char* 类型指针。
三、函数命名规则:
函数的前缀是它们返回的类型和其中定义的文件。例如:
vTaskPrioritySet()返回一个空,在task.c中定义。
xQueueReceive()返回一个BaseType_t类型的变量,在queue.c中定义。
pvTimerGetTimerID()返回一个指向void的指针,在timer .c中定义。
四、格式
一个Tab键等效于4个空格键
五、宏命名:
大多数宏都是用大写字母编写的,并以小写字母作为前缀,表示宏的定义位置。如下表所示:
此外还有通用的宏定义:
为什么要这么定义这些变量名称和类型名称呢?
这是因为FreeRTOS源代码需要在许多不同的编译器上编译,不同的编译器它们在生成警告的方式和时间上各不相同。特别是,不同的编译器希望以不同的方式使用转换。因此,FreeRTOS源代码包含的类型转换比通常的代码需要的多。
网友评论