PIC匯編編程規范

一、程序命名規范

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

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

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

二、程序頭格式

在每個(gè)文件的開(kāi)始要有一個(gè)對該文件總體功能的描述，軟件版本，以及作者及編寫(xiě)時(shí)間。采用模版統一格式。

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

2. 如果程序升級時(shí)應增加如下說(shuō)明。

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

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

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

4) 應對程序升級進(jìn)行簡(jiǎn)單修改說(shuō)明。

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

1.

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

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

;* 文件名 *

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

;* 功能描述：

;* 軟件版本

;* 開(kāi)始編寫(xiě)—完成日期:

;* 作者:

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

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

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

2.變量命名規則

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

3. 標志位命名規則

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

四、程序格式書(shū)寫(xiě)規范

匯編語(yǔ)言的格式為：

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

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

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

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

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

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

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

6. 注釋要求使用中文。

五.程序注釋

A.變量及軟件標志注釋

對于標志寄存器、全局變量和關(guān)鍵的標志位應加注釋?zhuān)f(shuō)明如下：

1. 變量注釋?zhuān)?/P>

l 寫(xiě)清變量在程序中起的作用

l 注明變化時(shí)刻。

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

l 程序升級所涉及到的變量的增加、改變或者刪除。該變量的用途是什么?是否需要初始化? 注釋?xiě)ò姹咎枴?