編碼風(fēng)格：μCOS vs FreeRTOS

作者 | strongerHuang

不定期有讀者在問(wèn)：怎么才能寫出漂亮的代碼？哪里有優(yōu)秀的代碼可以參考？怎樣才能提高自己編碼水平？

其實(shí)，我們身邊到處都有優(yōu)秀的代碼可以借鑒，只是你沒(méi)有認(rèn)真去發(fā)現(xiàn)而已。裸機(jī)、RTOS、Linux等各類優(yōu)秀的開(kāi)源代碼相信你一定見(jiàn)到過(guò)，還有一些優(yōu)秀的開(kāi)源庫(kù)你也肯定接觸過(guò)。

想要寫出漂亮、優(yōu)秀的代碼，首先，你的代碼必須要有一套規(guī)范。今天就給大家分享一下我們身邊熟知的RTOS的編碼規(guī)范，以目前（2023-01-10）最新版本的uC/OS-III V3.08.02和 FreeRTOS V10.5.1為例：

編碼標(biāo)準(zhǔn)

uC/OS 和?FreeRTOS 都是遵循 MISRA C 編碼標(biāo)準(zhǔn)，均支持 PC-Lint 靜態(tài)檢查，兩者官方文檔都有說(shuō)明。

提示：

MISRA C 標(biāo)準(zhǔn)，指的是汽車 C 語(yǔ)言開(kāi)發(fā)標(biāo)準(zhǔn)，可以參看之前分享的文章：MISRA C：2012 標(biāo)準(zhǔn)是什么？

1.uC/OS

uC/OS文章明確指出遵循MISRA C:2012標(biāo)準(zhǔn)，也支持?PC-Lint 的靜態(tài)檢查。

2.FreeRTOS

FreeRTOS也明確指出采用 MISRA C編碼標(biāo)準(zhǔn)，但是不支持 C99 之后的標(biāo)準(zhǔn)，也支持 PC-Lint 靜態(tài)檢查。

FreeRTOS在源代碼中有大量說(shuō)明（注釋）對(duì)?PC-Lint?靜態(tài)檢查可能會(huì)引起異常的代碼，這一點(diǎn)在 uC/OS 源代碼中是沒(méi)有的。

比如：

配置文件

兩種RTOS配置文件（也就是所謂的“裁剪”文件）的“內(nèi)容”有點(diǎn)類似，也是進(jìn)行了分類。

不過(guò)，uC/OS的分類和注釋更人性化，更適合初學(xué)者理解。

1.uC/OS

uC/OS的配置文件通常是：os_cfg.h

2.FreeRTOS

FreeRTOS的配置文件通常是：FreeRTOSConfig.h

標(biāo)頭

兩種RTOS標(biāo)頭的“內(nèi)容”有點(diǎn)類似，只是一個(gè)居中，一個(gè)靠左。

1.uC/OS

包含RTOS版本、版權(quán)說(shuō)明、開(kāi)源協(xié)議說(shuō)明等：

2.FreeRTOS

包含RTOS版本、版權(quán)說(shuō)明、開(kāi)源協(xié)議說(shuō)明、網(wǎng)址等，和uC/OS類似。

命名

兩種RTOS命名規(guī)則差別有點(diǎn)大，但都符合常規(guī)代碼命名規(guī)則。

1.文件名

uC/OS以【os_系統(tǒng)文件】方式，顯得更規(guī)范（體現(xiàn)了模塊化）。

FreeRTOS就比較直接，這個(gè)可能是剛才是命名的時(shí)候沒(méi)有長(zhǎng)期規(guī)劃，然后為了兼容，一直沿用至今。（這種更容易引起文件重名）

2.宏

兩者有共同之處：下劃線隔開(kāi)大寫字母，但是開(kāi)頭（前綴）有一定區(qū)別。

以“配置文件”為例：uC/OS以【OS_CFG_】開(kāi)頭，F(xiàn)reeRTOS以【config】開(kāi)頭。

3.數(shù)據(jù)類型

uC/OS定義的數(shù)據(jù)類型，相對(duì)更常見(jiàn)，也更適合新手。

FreeRTOS定義的數(shù)據(jù)類型，更“系統(tǒng)”一點(diǎn)，適合老司機(jī)，對(duì)新手相對(duì)沒(méi)那么友好。

4.函數(shù)名

兩者有點(diǎn)類似，前綴不一樣，后面都是以【大寫字母開(kāi)頭】進(jìn)行區(qū)分。

比如：創(chuàng)建任務(wù)的函數(shù)名：

FreeRTOS的前綴官方有這樣的描述：

靜態(tài)（static）函數(shù)以 prv 為前綴。比如：prvIdleTask 函數(shù)。

API 函數(shù)以其返回類型為前綴，void 類型以?v?為綴。比如：vTaskDelete 函數(shù)。

注釋

//? /* */ 是兩種最常見(jiàn)注釋的方法，但這兩種 RTOS 基本以【/* */】注釋居多。

注釋的位置也是有講究，通常在代碼所在行上一行，或者在代碼所在行（代碼后面）。

這里主要說(shuō)明一下，F(xiàn)reeRTOS在代碼中沒(méi)有相信注釋函數(shù)的功能、參數(shù)、返回值等信息。

還是以“創(chuàng)建任務(wù)”函數(shù)為例：

當(dāng)然，F(xiàn)reeRTOS的函數(shù)注釋信息，在手冊(cè)中有相信描述。

縮進(jìn)

這兩種RTOS縮進(jìn)方式一樣，都是采用 4 空格：

這里要提醒一下，切記不要 Tab 和空格兩者混用，不然代碼就是一片亂。（在不少新手，或者初級(jí)工程中就經(jīng)常出現(xiàn)這種，代碼簡(jiǎn)直不敢看）

單詞縮寫

不同的領(lǐng)域，有不同的縮寫方式。在RTOS中也有一些常見(jiàn)的縮寫單詞，比如：

好了，本文就分享到這里。以上只是列舉了部分典型的編碼風(fēng)格，更多細(xì)節(jié)，大家可以抽時(shí)間自行研究。