加入星计划,您可以享受以下权益:

  • 创作内容快速变现
  • 行业影响力扩散
  • 作品版权保护
  • 300W+ 专业用户
  • 1.5W+ 优质创作者
  • 5000+ 长期合作伙伴
立即加入
  • 正文
  • 相关推荐
  • 电子产业图谱
申请入驻 产业图谱

FreeRTOS编码标准及规范

09/18 09:29
441
阅读需 5 分钟
加入交流群
扫码加入
获取工程师必备礼包
参与热点资讯讨论

微信公众号 | strongerHuang

据某研究机构统计,目前全球RTOS市场占有率最高的是FreeRTOS,当然,统计的具体方法我们不得而知,但FreeRTOS的确很活跃。

这里问问大家,你身边使用 FreeRTOS 的朋友或同事多吗?

下面给大家分享一下 FreeRTOS 编码标准及规范。

FreeRTOS编码标准

FreeRTOS V11.0之前的内核版本,符合MISRA C:2004 编码标准。但目前最新的FreeRTOS内核遵循 MISRA C:2012 编码标准。

 

什么是 MISRA C:2012 编码标准?大家可以参看我之前分享的文章:《MISRA C:2012 又是什么标准?》。

MISRA C是由汽车产业软件可靠性协会(MISRA)提出的C语言开发标准。其目的是在增进嵌入式系统的安全性及可移植性,针对C++语言也有对应的标准MISRA C++。

因为 FreeRTOS 使用多种不同的编译器构建,其中不乏相对高级的编译器。因此, FreeRTOS 没有使用 C99 或其他标准,而是采用更加严格的 MISRA C 编码标准。
由于 FreeRTOS V11.0之前的内核版本,采用MISRA C:2004 编码标准,所以使用 PC-Lint 工具进行代码静态分析时,可能存在与 MISRA 标准的一些偏差。

FreeRTOS编码规范

不同的RTOS有不同的命名规范,通常来说,公司如果对代码质量要求高一点,公司内部都会有编码规范。

下面是 FreeRTOS 常见的一些编码规范。

1、变量

uint8_t 类型变量以 uc 为前缀,其中“u”表示“unsigned” ,“c”表示“char ”。

uint16_t 类型变量以 us 为前缀,其中“u”表示“unsigned” ,“s”表示“short”。

uint32_t 类型变量以 ul 为前缀,其中“u”表示“unsigned” ,“l”表示“long”。

比如:

static uint8_t ucHeap[ configTOTAL_HEAP_SIZE ];
static uint32_t ulTotalRunTime = 0UL;

size_t 类型变量以 x 为前缀,比如:

static size_t xFreeBytesRemaining = 0U;

但 size_t 其实大多数情况被定义为 “unsigned int”,因此,size_t 类型变量也有带 ux 前缀。

枚举变量以 e 为前缀。

指针以附加 p 为前缀。

2、函数

静态或私有函数以 prv 为前缀。比如:

static void prvAddNewTaskToReadyList( TCB_t *pxNewTCB )

API 函数返回类型为 void 添加前缀 v。比如:

void vApplicationTickHook( void );

3、宏定义

通常以定义宏的文件为前缀,且前缀为小写。

例如, FreeRTOSConfig.h 中定义。

#define configUSE_PREEMPTION      1

除前缀外,宏定义其他均使用大写字母书写,并使用下划线来分隔单词。

4、数据类型

主要使用 stdint.h 类型和 RTOS 自带的 typedef,但也有个别除外。比如:

    TickType_tBaseType_tStackType_t......

5、缩进

使用四个空格字符进行缩进。

6、注释

通常以 /* */ 方式进行注释,注释始终不会超过第 80 列。

由于时间有限,这里只分享一些主要内容,更多编码规范,还是需要大家自己阅读源码进行了解。


其实你会发现,虽然不同RTOS之间的编码规范不同,但每一款RTOS都会严格遵循自家的编码规范,不但方便自己升级维护,也方便用户阅读源码。

相关推荐

电子产业图谱

作者黄工,从事嵌入式软件开发工作8年有余,高级嵌入式软件工程师,业余维护公众号『strongerHuang』,分享嵌入式软硬件、单片机、物联网等内容。