單片機開發之C語言編程基本規范

tainqing · 發表于 2017-10-14 11:20:06

為了提高源程序的質量和可維護性，從而最終提高軟件產品生產力，特編寫此規范。本標準規定了程序設計人員進行程序設計時必須遵循的規范。本規范主要針對單片機編程語言和08編譯器而言，包括排版、注釋、命名、變量使用、代碼可測性、程序效率、質量保證等內容。
1．基本規則
格式清晰、注釋簡明扼要、命名規范易懂、函數模塊化、程序易讀易維護、功能準確實現、代碼空間效率和時間效率高、適度的可擴展性、單片機編程規范－標識符命名
2．標識符命名 2.1 命名基本原則
（1）命名清晰明了，有明確含義，使用完整單詞或約定俗成的縮寫。通常，較短的單詞可通過去掉元音字母形成縮寫；較長的單詞可取單詞的頭幾個字母形成縮寫。即"見名知意"。（2）命名風格要自始至終保持一致。
（3）命名中若使用特殊約定或縮寫，要有注釋說明。
（4）同一軟件產品內模塊之間接口部分的標識符名稱之前加上模塊標識。
2.2 宏和常量命名
宏和常量用全部大寫字母來命名，詞與詞之間用下劃線分隔。對程序中用到的數字均應用有意義的枚舉或宏來代替。
2.3 變量命名
變量名用小寫字母命名，每個詞的第一個字母大寫。類型前綴（u8\s8 etc.）全局變量另加前綴g_。
局部變量應簡明扼要。局部循環體控制變量優先使用i、j、k等；局部長度變量優先使用len、num等；臨時中間變量優先使用temp、tmp等。
2.4 函數命名
函數名用小寫字母命名，每個詞的第一個字母大寫，并將模塊標識加在最前面。
2.5 文件命名
一個文件包含一類功能或一個模塊的所有函數，文件名稱應清楚表明其功能或性質。
每個.c文件應該有一個同名的.h文件作為頭文件。
3．注釋 3.1 注釋基本原則
有助于對程序的閱讀理解，說明程序在"做什么"，解釋代碼的目的、功能和采用的方法。
一般情況源程序有效注釋量在30％左右。
注釋語言必須準確、易懂、簡潔。
邊寫代碼邊注釋，修改代碼同時修改相應的注釋，不再有用的注釋要刪除。
匯編和C中都用"//"，取消";"  不使用段注釋" /*  */ "（調試時可用）
3.2 文件注釋
文件注釋必須說明文件名、函數功能、創建人、創建日期、版本信息等相關信息。
修改文件代碼時，應在文件注釋中記錄修改日期、修改人員，并簡要說明此次修改的目的。所有修改記錄必須保持完整。
文件注釋放在文件頂端，用"/*……*/"格式包含。
注釋文本每行縮進4個空格；每個注釋文本分項名稱應對齊。
/***********************************************************
文件名稱：
作者：
版本：
說明：
修改記錄：
***********************************************************/
3.3 函數注釋
3.3.1 函數頭部注釋
函數頭部注釋應包括函數名稱、函數功能、入口參數、出口參數等內容。如有必要還可增加作者、創建日期、修改記錄（備注）等相關項目。
函數頭部注釋放在每個函數的頂端，用"/*……*/"的格式包含。其中函數名稱應簡寫為Name()，不加入、出口參數等信息。
/***********************************************************
函數名稱：
函數功能：
入口參數：
出口參數：
備注：
***********************************************************/
3.3.2 代碼注釋
代碼注釋應與被注釋的代碼緊鄰，放在其上方或右方，不可放在下面。如放于上方則需與其上面的代碼用空行隔開。一般少量注釋應該添加在被注釋語句的行尾，一個函數內的多個注釋左對齊；較多注釋則應加在上方且注釋行與被注釋的語句左對齊信盈達嵌入式企鵝要妖氣嗚嗚吧久零就要。
函數代碼注釋用"//…//"的格式。
通常，分支語句（條件分支、循環語句等）必須編寫注釋。其程序塊結束行"｝"的右方應加表明該程序塊結束的標記"end of ……", 尤其在多重嵌套時。
3.4 變量、常量、宏的注釋
同一類型的標識符應集中定義，并在定義之前一行對其共性加以統一注釋。對單個標識符的注釋加在定義語句的行尾。
全局變量一定要有詳細的注釋，包括其功能、取值范圍、哪些函數或過程存取它以及存取時的注意事項等。
注釋用"//…//"的格式。
4．函數 4.1 函數設計原則
函數的基本要求：
1）封裝性
1) 正確性：程序要實現設計要求的功能。
2) 穩定性和安全性：程序運行穩定、可靠、安全。
3) 可測試性：程序便于測試和評價。
4) 規范／可讀性：程序書寫風格、命名規則等符合規范。
5) 擴展性：代碼為下一次升級擴展留有空間和接口。
6) 全局效率：軟件系統的整體效率高。
7) 局部效率：某個模塊／子模塊/函數的本身效率高。
編制函數的基本原則：
1) 單個函數的規模盡量限制在200行以內（不包括注釋和空行）。一個函數只完成一個功能。
2) 函數局部變量的數目一般不超過5～10個。
3) 函數內部局部變量定義區和功能實現區（包含變量初始化）之間空一行。
4) 函數名應準確描述函數的功能。通常使用動賓詞組為執行某操作的函數命名。
5) 函數的返回值要清楚明了，尤其是出錯返回值的意義要準確無誤。
6) 不要把與函數返回值類型不同的變量，以編譯系統默認的轉換方式或強制的轉換方式作為返回值返回。
7) 減少函數本身或函數間的遞歸調用。
8) 盡量不要將函數的參數作為工作變量。
4.2 函數定義
1) 函數若沒有入口參數或者出口參數，應用void明確申明。
2) 函數名稱與出口參數類型定義間應該空一格且只空一格。
3) 函數名稱與括號()之間無空格。
4) 函數形參必須給出明確的類型定義。
5) 多個形參的函數，后一個形參與前一個形參的逗號分割符之間添加一個空格。
6) 函數體的前后花括號"｛｝" 各獨占一行。
4.3 局部變量定義
1) 同一行內不要定義過多變量。
2) 同一類的變量在同一行內定義，或者在相鄰行定義。
3) 先定義data型變量，再定義idtata型變量，再定義xdata型變量.（？）
4) 數組、指針等復雜類型的定義放在定義區的最后。
5) 變量定義區不做較復雜的變量賦值。
4.4 功能實現區規范
1) 一行只寫一條語句。
2) 注意運算符的優先級，并用括號明確表達式的操作順序，避免使用默認優先級信盈達嵌入式企鵝要妖氣嗚嗚吧久零就要。
3) 各程序段之間使用一個空行分隔，加以必要的注釋。程序段指能完一個較具體的功能的一行或多行代碼。程序段內的各行代碼之間相互依賴性較強。(1、2、3方式)
4) 不要使用難懂的技巧性很高的語句。
5) 源程序中關系較為緊密的代碼應盡可能相鄰。
6) 完成簡單功能、關系非常密切的一條或幾條語句可編寫為函數或定義為宏。
5．單片機編程規范－排版
5.1 縮進
代碼的每一級均往右縮進4個空格的位置。不使用Tab鍵
5.2 分行
每行語句（？？？？？超過80個字符）要分成多行書寫；長表達式要在低優先級操作符處劃分新行，操作符放在新行之首，劃分出的新行要進適當的縮進，使排版整齊，語句可讀。避免把注釋插入分行中。
5.3 空行
1) 文件注釋區、頭文件引用區、函數間應該有且只有一行空行。
2) 相鄰函數之間應該有且只有一行空行。
3) 函數體內相對獨立的程序塊之間可以用一行空行或注釋來分隔。
4) 函數注釋和對應的函數體之間不應該有空行。
5) 文件末尾有且只有一行空行。
5.4 空格
1) 函數語句尾部或者注釋之后不能有空格。
2) 括號內側（即左括號后面和右括號前面）不加空格，多重括號間不加空格。
3) 函數形參之間應該有且只有一個空格（形參逗號后面加空格）。
4) 同一行中定義的多個變量間應該有且只有一個空格（變量逗號后面加空格）。
5) 表達式中，若有多個操作符連寫的情況，應使用空格對它們分隔：
6) 在兩個以上的關鍵字、變量、常量進行對等操作時，它們之間的操作符前后均加一個空格；在兩個以上的關鍵字、變量、常量進行非對等操作時，其前后均不應加空格；
7) 逗號只在后面加空格；
8) 雙目操作符，如比較操作符, 賦值操作符"="、"+="，算術操作符"+"、"%"，邏輯操作符"&&"、"&"，位操作符"<<"、"^"等，前后均加一個空格；
9) 單目操作符，如"!"、"~"、"++"、"-"、"&"（地址運算符）等，前后不加空格；
10) "->"、"."前后不加空格；
11) if、for、while、switch等關鍵字與后面的括號間加一個空格；
5.5 花括號
1)  if、else if、else、for、while語句無論其執行體是一條語句還是多條語句都必須加花括號，且左右花括號各獨占一行。
2)  do{}while()結構中，"do"和"{"均各占一行，"}"和"while();"共同占用一行。
if ( ) do
{ {
} }while( );
else
{
}
嵌套越少越好，{}不準超過3層
5.6 switch語句
1) 每個case和其判據條件獨占一行。
2) 每個case程序塊需用break結束。特殊情況下需要從一個case塊順序執行到下一個case塊的時候除外，但需要花括號在交界處明確注釋如此操作的原因，以防止出錯。
3) case程序塊之間空一行，且只空一行。
4) 每個case程序塊的執行語句保持4個空格的縮進。
5) 一般情況下都應該包含default分支。
Switch ( )
{
case x:
break;
case x:
break;
default:
break;
}
6．程序結構 6.1 基本要求
1) 有main()函數的.c文件應將main()放在最前面，并明確用void聲明參數和返回值。
2) 對由多個.c文件組成的模塊程序或完整監控程序，建立公共引用頭文件，將需要引用的庫頭文件、標準寄存器定義頭文件、自定義的頭文件、全局變量等均包含在內，供每個文件引用。通常，標準函數庫頭文件采用尖角號< >標志文件名，自定義頭文件采用雙撇號″″標志文件名。
3) 每個.c文件有一個對應的.h文件，.c文件的注釋之后首先定義一個唯一的文件標志宏，并在對應的.h文件中解析該標志。
在.c文件中：
#define FILE_FLAG
在.h文件中：&
6．程序結構 6.1 基本要求
1) 有main()函數的.c文件應將main()放在最前面，并明確用void聲明參數和返回值。
2) 對由多個.c文件組成的模塊程序或完整監控程序，建立公共引用頭文件，將需要引用的庫頭文件、標準寄存器定義頭文件、自定義的頭文件、全局變量等均包含在內，供每個文件引用。通常，標準函數庫頭文件采用尖角號< >標志文件名，自定義頭文件采用雙撇號″″標志文件名。
3) 每個.c文件有一個對應的.h文件，.c文件的注釋之后首先定義一個唯一的文件標志宏，并在對應的.h文件中解析該標志。
在.c文件中：
#define FILE_FLAG
在.h文件中：
#ifdef FILE_FLAG
#define XXX
#else
#define XXX extern
#endif
4)  對于確定只被某個.c文件調用的定義可以單獨列在一個頭文件中、單獨調用。

xiaobing86203 · 發表于 2017-10-14 12:38:19

搞單片機的，電氣都是高手啊；比只編PLC強多了

TM-2017 · 發表于 2017-10-14 14:58:23

學習力

TM-2017 · 發表于 2017-10-14 14:58:47

學習了

余罪HN · 發表于 2017-10-14 16:58:35

大學里可惜沒好好學

韓寒11 · 發表于 2017-10-14 21:42:52

單片機是一種集成電路芯片，是采用超大規模集成電路技術把具有數據處理能力的中央處理器CPU、隨機存儲器RAM、只讀存儲器ROM、多種I/O口和中斷系統、定時器/計數器等功能(可能還包括顯示驅動電路、脈寬調制電路、模擬多路轉換器、A/D轉換器等電路)集成到一塊硅片上構成的一個小而完善的微型計算機系統，在工業控制領域廣泛應用

tainqing · 發表于 2017-11-12 16:03:57

余罪HN 發表于 2017-10-14 16:58
$ Q3 V3 X8 Q5 n. l/ m9 t大學里可惜沒好好學

現在想學習也不晚啊，知識和技術都是給想學和愿意學習的人的！qq1175589091

余罪HN · 發表于 2017-11-13 09:35:54

tainqing 發表于 2017-11-12 16:03! T: y& S( D- x. q$ v" ]3 h
現在想學習也不晚啊，知識和技術都是給想學和愿意學習的人的！qq1175589091

現在用不到呀。。。我從事的是鍛造加工這一塊的。。學英語比較靠譜，都是出口的，客戶都是老外。。。不過知識給想學的人這點沒錯

vibecoo · 發表于 2019-4-4 15:55:37

學習

咚咚嚨咚嗆 · 發表于 2019-4-23 17:23:09

學習了，多謝樓主

		自動登錄	找回密碼
密碼			注冊會員