基于單片機C語(yǔ)言編程格式

//

2. 文件頭的格式：

/*
* Company Name
* Address
*
* (c) Copyright 20xx, Company Name, City, State
* All Rights Reserved
*
*
* FileName :
* Version :
* Programmer(s) :
* Description :
*
*
*/

3. 函數頭的格式：

/*
* FunctionName :
* Description :
* EntryParameter :
* ReturnValue :
*/

4. 文件結束格式：

/*
* End Of File
*/

5. 文件管理：

對于文件的管理來(lái)說(shuō)，應把每一個(gè)程序模塊分成兩份。一個(gè)是C語(yǔ)言源代碼，一個(gè)對應的頭文件，且放在一個(gè)文件夾中。
例如，關(guān)于LCD1602的驅動(dòng)模塊，應該分為L(cháng)CD1602.C和LCD1602.H,并放在LCD1602文件夾中。LCD1602.C中包含的是驅動(dòng)程序
的源代碼，盡量做到與移植無(wú)關(guān)；LCD1602.H中應該包含函數的申明部分、宏定義、全局變量的申明接管腳定義等，也就是
與移植相關(guān)的部分。
對于main.c函數應該對于config.h頭文件。main.c中為應用程序的主程序部分，負責把各個(gè)模塊聯(lián)系起來(lái)；而config.h頭
文件為整個(gè)系統的配置文件，里邊除了編寫(xiě)不依賴(lài)于編譯器的數據類(lèi)型的定義外，還應該把整個(gè)工程需要的所有程序模塊均包含進(jìn)來(lái)，這樣每一個(gè)程序
模塊中都只需要包含config.h頭文件即可。

6. 命名規則：

A. 函數命名：
函數名均由大寫(xiě)字母開(kāi)頭，單詞之間也應用大寫(xiě)區別，為了移植以后程序模塊的函數名不重復，應在程序模塊的每一個(gè)函數名中加上模塊名。如: LCDWriteData()，LCD表示液晶模塊，WriteData寫(xiě)數據到液晶模塊中。至于下劃線(xiàn)的帶與否，可以用與區分是函數的內部函數與否，也就是說(shuō)，如果帶下劃線(xiàn)，表示為模塊內部函數，應用程序可能不需要調用，模塊內部調用；不帶下劃線(xiàn)表示為應用程序需要調用的函數。
B. 變量命名：
全局變量 -- 大寫(xiě)字母開(kāi)頭，并且加上文件名為變量前綴。
局部變量 -- 小寫(xiě)字母開(kāi)頭，
內部變量 -- 用簡(jiǎn)單字母表示，如：循環(huán)用i,j,k等；指針 - p，字符 - c，字符串 - s。

總結：形式參數 -- 在函數中應也小寫(xiě)開(kāi)頭；
自動(dòng)變量 -- 小寫(xiě)字母；
靜態(tài)變量 -- 大寫(xiě)開(kāi)頭；
外部變量 -- 文件名開(kāi)頭；
函數命名 -- 文件名開(kāi)頭。

7. 注解規則：

對于函數的注解均該應“//”來(lái)表示，而不是“//”。因為前者表示后，如果想把整段代碼注釋掉只要加上后者，但如果一開(kāi)始就用了后者，再想注釋掉整段代碼就比較麻煩了。注解應該對齊，如果一行寫(xiě)不下，可以寫(xiě)在代碼的前面一行，也可以在后面一行繼續編寫(xiě)。

8. 代碼編寫(xiě)格式：

對于代碼的編寫(xiě)格式，將嚴格按照《c語(yǔ)言編程規范》來(lái)編寫(xiě)。

9. 宏的定義：

常數和宏定義要用全大寫(xiě)表示，單詞之間可以用下劃線(xiàn)分割開(kāi)。十六進(jìn)制要用“0x”開(kāi)頭，其后的字母一定要用大寫(xiě)表示。如果是定義的是常量不需要加括號，但是表示的是一個(gè)或更多的語(yǔ)句時(shí)應該加上括號，而要替代的表達式均應加括號。如：

#define KEY_FF (0x0F) // 常量定義，常量后不加括號，表達式加括號
#define KEY_BUF_FULL() (KeyNRd > 0) // 語(yǔ)句應加括號

10. 數據類(lèi)型：

typedef unsigned char Boolean; // Boolean 位變量
typedef unsigned char uint8; // defined for unsigned 8-bits integer variable 無(wú)符號8位整型變量
typedef signed char int8; // defined for signed 8-bits integer variable 有符號8位整型變量
typedef unsigned short uint16; // defined for unsigned 16-bits integer variable 無(wú)符號16位整型變量
typedef signed short int16; // defined for signed 16-bits integer variable 有符號16位整型變量
typedef unsigned int uint32; // defined for unsigned 32-bits integer variable 無(wú)符號32位整型變量
typedef signed int int32; // defined for signed 32-bits integer variable 有符號32位整型變量
typedef float fp32; // single precision floating point variable (32bits) 單精度浮點(diǎn)數（32位長(cháng)度）
typedef double fp64; // double precision floating point variable (64bits) 雙精度浮點(diǎn)數（64位長(cháng)度）

11. 局部變量：

一些程序模塊會(huì )用到局部變量，這些局部變量只用于這個(gè)模塊中，應將這些局部變量隱藏起來(lái)，不讓別的文件看到。則應該在這寫(xiě)變量前加上static關(guān)鍵字實(shí)現。

12. 括號應用：

在多個(gè)運算符存在的條件下，應該應用括號，避免優(yōu)先級的錯誤及閱讀方便。如：

ssY = ssM * ssX + ssB; 應寫(xiě)成 ： ssY = ((ssM * ssX) + ssB);

13. 真假定義：

當定義邏輯對立面時(shí)，基于原始的陳述，以宏的方式，首先定義其中一種邏輯情形，然后再定義相反的另一種情形。

#define TRUE (1)
#define FALSE (!TRUE)