转载地址:https://blog.csdn.net/zhzht19861011/article/details/500575311.编码标准 FreeRTOS的核心源代码遵从MISRA编码标准指南。这个标准篇幅稍长,你可以在MISRA官方网站花少量钱买到,这里不再复制任何标准。 FreeRTOS源代码不符合MISRA标准的项目如下所示:
- 有两个API函数有多个返回点。MISRA编码标准强制规定:一个函数在其结尾应该有单一的返回点。
- 指针算数运算,在创建任务时,为了兼容8、16、20、24、32位总线,不可避免的使用了指针算数运算。MISRA编码标准强制规定:指针的算术运算只能用在指向数组或数组元素的指针上。
- 默认情况下,跟踪宏为空语句,因此不符合MISRA的规定。MISRA编码标准强制规定:预处理指令在句法上应该是有意义的。
FreeRTOS可以在很多不同编译器中编译,其中的一些编译器比同类有更高级特性。因为这个原因,FreeRTOS不使用任何非C语言标准的特性或语法。一个例外情况是头文件stdint.h。在文件夹FreeRTOS/Source/include下包含一个叫做stdint.readme的文件,如果你的编译器不提供stdint类型定义,可以将stdint.readme文件重命名为stdint.h。 2命名规则 RTOS内核和演示例程源代码使用以下规则: 1> 变量
- uint32_t类型的变量使用前缀ul,这里’u’表示’unsigned’,’l’表示’long’
- uint16_t类型的变量使用前缀us,这里’u’表示’unsigned’,’s’表示’short’
- uint8_t类型的变量使用前缀uc,这里’u’表示’unsigned’,’c’表示’char’
- 非stdint类型的变量使用前缀x,比如基本的Type_t和TickType_t类型,这些类型在移植层定义,定义成符合处理器架构的最高效类型;
- 非stdint类型的无符号变量使用前缀ux,比如UbaseType_t(unsigned BaseType_t)
- size_t类型的变量使用前缀x;
- 枚举类型变量使用前缀e
- 指针类型变量在类型基础上附加前缀p,比如指向uint16_t的指针变量前缀为pus
- 与MISRA指南一致,char类型变量仅被允许保存ASCII字符,前缀为c
- 与MISRA指南一致,char *类型变量仅允许指向ASCII字符串,前缀为pc
2> 函数
- 在文件作用域范围的函数前缀为prv
- API函数的前缀为它们的返回类型,当返回为空时,前缀为v
- API函数名字起始部分为该函数所在的文件名。比如vTaskDelete函数定义在tasks.c,并且该函数返回空。
3> 宏
- 宏的名字起始部分为该宏定义所在的文件名的一部分。比如configUSE_PREEMPTION定义在FreeRTOSConfig.h文件中。
- 除了前缀,宏剩下的字母全部为大写,两个单词间用下划线(’_’)隔开。
|