單片機匯編程序編碼規(guī)范

規(guī)則3

頭文件、源文件的頭部，應進行注釋。注釋必須列出：文件名、作者、目的、功能、修改日志等。

規(guī)則4

函數頭部應進行注釋，列出：函數的目的、功能、輸入參數、輸出參數、涉及到的通用變量和寄存器、調用的其他函數和模塊、修改日志等。對一些復雜的函數，在注釋中最好提供典型用法。

規(guī)則5

對重要代碼段的功能、意圖進行注釋，提供有用的、額外的信息。并在該代碼段的結束處加一行注釋表示該段代碼結束。

規(guī)則6

對于所有的常量，變量，數據結構聲明(包括數組、結構、類、枚舉等)，如果其命名不是充分自注釋的，在聲明時都必須加以注釋，說明其含義。

規(guī)則 7

維護代碼時，要更新相應的注釋，刪除不再有用的注釋。保持代碼、注釋的一致性，避免產生誤解。

3.命名

規(guī)則 1

標識符縮寫

形成縮寫的幾種技術：

1) 去掉所有的不在詞頭的元音字母。如screen寫成scrn, primtive寫成prmv。

2) 使用每個單詞的頭一個或幾個字母。如Channel Activation寫成ChanActiv，Release

Indication寫成RelInd。

3) 使用變量名中每個有典型意義的單詞。如Count of Failure寫成FailCnt。

4) 去掉無用的單詞后綴 ing, ed等。如Paging Request寫成PagReq。

5) 使用標準的或慣用的縮寫形式(包括協議文件中出現的縮寫形式)。如BSIC(Base Station

Identification Code)、MAP(Mobile Application Part)。

關于縮寫的準則：

1) 縮寫應該保持一致性。如Channel不要有時縮寫成Chan，有時縮寫成Ch。Length有時縮寫成Len，有時縮寫成len。

2) 在源代碼頭部加入注解來說明協議相關的、非通用縮寫。

3) 標識符的長度不超過12個字符。

規(guī)則2

變量命名約定：前綴> + 主體 ; 注釋

變量命名要考慮簡單、直觀、不易混淆。

前綴是可選項，表示變量類型，由于匯編中變量多是單字節(jié)變量，所以單字節(jié)變量可以不加前綴，對于bit和雙字節(jié)型變量，使用小寫的b和d作為前綴表示。

主體是必選項，可多個單詞(或縮寫)合在一起，每個單詞首字母大寫，其余部分小寫。

規(guī)則3

常量的命名

常量的命名規(guī)則：單詞的字母全部大寫，各單詞之間用下劃線隔開。

規(guī)則4

函數的命名

單詞首字母為大寫，其余均為小寫。函數名應以一個動詞開頭，即函數名應類似一個動詞斷語或祈使句。

例如：Test_Protect， Check_EEPROM， Init_Para

4.可維護性

規(guī)則1

函數和過程中關系較為緊密的代碼盡可能相鄰。

規(guī)則2

每個函數的源程序行數原則上應該少于200行。

對于消息分流處理函數，完成的功能統一，但由于消息的種類多，可能超過200行的限制，不屬于違反規(guī)定。

規(guī)則3

語句嵌套層次不得超過5層。

嵌套層次太多，增加了代碼的復雜度及測試的難度，容易出錯，增加代碼維護的難度。

規(guī)則4

避免相同的代碼段在多個地方出現。

當某段代碼需在不同的地方重復使用時，應根據代碼段的規(guī)模大小使用函數調用或宏調用的方式代替。這樣，對該代碼段的修改就可在一處完成，增強代碼的可維護性。

規(guī)則5

每個函數完成單一的功能，不設計多用途面面俱到的函數。

多功能集于一身的函數，很可能使函數的理解、測試、維護等變得困難。使函數功能明確化，增加程序可讀性，亦可方便維護、測試。

規(guī)則6

在函數的項目維護文檔中，應該指出軟件適用的硬件平臺及版本。

建議1

使用專門的初始化函數對所有的公共變量進行初始化。

5.程序正確性、效率

規(guī)則1

嚴禁使用未經初始化的變量。

引用未經初始化的變量可能會產生不可預知的后果，特別是引用未經初始化的指針經常會導致系統崩潰，需特別注意。

規(guī)則2

防止內存操作越界。

說明：內存操作越界是軟件系統主要錯誤之一，后果往往非常嚴重。

規(guī)則3

注意變量的有效取值范圍，防止表達式出現上溢或下溢。

規(guī)則4

防止易混淆的指令和操作數拼寫錯誤。

規(guī)則5

避免函數中不必要語句，防止程序中的垃圾代碼，預留代碼應以注釋的方式出現。

程序中的垃圾代碼不僅占用額外的空間，而且還常常影響程序的功能與性能，很可能給程序的測試、維護等造成不必要的麻煩。

規(guī)則6

通過對系統數據結構的劃分與組織的改進，以及對程序算法的優(yōu)化來提高空間效率。

這種方式是解決軟件空間效率的根本辦法。

規(guī)則7

循環(huán)體內工作量最小化。

應仔細考慮循環(huán)體內的語句是否可以放在循環(huán)體之外，使循環(huán)體內工作量最小，從而提高程序的時間效率。