PIC匯編編程規范

一、程序命名規范

程序文件名由兩部分構成：一部分為產品型號或功能描述，一部分為軟件版本號。產品型號用字母描述，可為英文或中文拼音。軟件版本號為4位，前一位固定為字母”V”，后3位為數字，編寫軟件版本號應按照從小到大的順序遞增。開發階段版本號從001開始;中試之后版本號從100開始。

例如：光電感煙探測器JTY-GD-G3程序 GDG3V001

電子差定溫探測器JTW-ZCD-G3N程序 GWG3NV101

二、程序頭格式

在每個文件的開始要有一個對該文件總體功能的描述，軟件版本，以及作者及編寫時間。采用模版統一格式。

1. 在功能描述中，除了對軟件實現的功能做簡要描述外，還應包括使用的單片機，晶振頻率，以及主要I/O口實現的功能。

2. 如果程序升級時應增加如下說明。

1) 程序升級后的版本號：例如“版本號:Ver105”

2) 程序升級的修改作者：例如“更改人：×××”

3) 程序升級的修改日期：例如“更改日期:01 12 17”

4) 應對程序升級進行簡單修改說明。

5) 應給出程序增加、更改、刪除項說明，每項總處數。

1.

程序頭如采用如下統一格式：

;****************

;* 文件名 *

;****************

;* 功能描述：

;* 軟件版本

;* 開始編寫—完成日期:

;* 作者:

三、子程序、標號及變量命名規則(推薦)

1.子程序及標號命名規則

子程序命名應使用相關含義英文。子程序入口標號應使用子程序名相關含義、常用的英語單詞(拼音)或單詞(拼音)縮寫。如果一個英語單詞表述不清，應使用多個英語單詞縮寫表示。程序里邊的標號應與執行該分支功能相關含義、常用的英語單詞(拼音)或單詞(拼音)縮寫，如果沒有確切含義，應優先選用子程序入口標號前面字母縮寫加兩位序號。

2.變量命名規則

標志寄存器使用相關含義、常用的英語單詞英文+ Flag;暫用寄存器使用：暫存對象英文縮寫+Temp;計數寄存器使用暫存對象英文縮寫+ Numb;其它寄存器：與存放對象相關含義、常用的英語單詞(拼音)或單詞(拼音)縮寫。

3. 標志位命名規則

標志對象相關含義、常用的英語單詞(拼音)縮寫。

四、程序格式書寫規范

匯編語言的格式為：

[標號] 指令助記符> [操作數] ;[注釋]

編程時為了程序結構清楚，要求如下：

1. 四個部分之間以tab鍵分隔(tab鍵定義為8個空格)，而不使用空格。

2. 對于相同的部分要求上下對齊。

3. 標號后必須跟冒號(：)

4. 雖然標號中的字母大小寫表示不同的含義，但不允許用同樣的字符定義兩個不同的標號。

5. 操作數的第一個字母要求大寫，其余字符小寫;如果操作數為常量，要求第一個大寫的字符為“C“。

6. 注釋要求使用中文。

五.程序注釋

A.變量及軟件標志注釋

對于標志寄存器、全局變量和關鍵的標志位應加注釋，說明如下：

1. 變量注釋：

l 寫清變量在程序中起的作用

l 注明變化時刻。

l 當使用復用變量時，應注釋變量生命周期。

l 程序升級所涉及到的變量的增加、改變或者刪除。該變量的用途是什么?是否需要初始化? 注釋應包括版本號。