一、程序命名規(guī)范

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

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

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

二、程序頭格式

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

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

2. 如果程序升級時應(yīng)增加如下說明。

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

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

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

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

5) 應(yīng)給出程序增加、更改、刪除項說明，每項總處數(shù)。

1.

程序頭如采用如下統(tǒng)一格式：

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

;* 文件名 *

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

;* 功能描述：

;* 軟件版本

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

;* 作者:

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

1.子程序及標號命名規(guī)則

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

2.變量命名規(guī)則

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

3. 標志位命名規(guī)則

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

四、程序格式書寫規(guī)范

匯編語言的格式為：

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

編程時為了程序結(jié)構(gòu)清楚，要求如下：

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

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

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

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

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

6. 注釋要求使用中文。

五.程序注釋

A.變量及軟件標志注釋

對于標志寄存器、全局變量和關(guān)鍵的標志位應(yīng)加注釋，說明如下：

1. 變量注釋：

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

l 注明變化時刻。

l 當使用復(fù)用變量時，應(yīng)注釋變量生命周期。

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