PIC匯編編程規(guī)范
一、程序命名規(guī)范
程序文件名由兩部分構(gòu)成:一部分為產(chǎn)品型號(hào)或功能描述,一部分為軟件版本號(hào)。產(chǎn)品型號(hào)用字母描述,可為英文或中文拼音。軟件版本號(hào)為4位,前一位固定為字母”V”,后3位為數(shù)字,編寫軟件版本號(hào)應(yīng)按照從小到大的順序遞增。開發(fā)階段版本號(hào)從001開始;中試之后版本號(hào)從100開始。
例如:光電感煙探測(cè)器JTY-GD-G3程序 GDG3V001
電子差定溫探測(cè)器JTW-ZCD-G3N程序 GWG3NV101
二、程序頭格式
在每個(gè)文件的開始要有一個(gè)對(duì)該文件總體功能的描述,軟件版本,以及作者及編寫時(shí)間。采用模版統(tǒng)一格式。
1. 在功能描述中,除了對(duì)軟件實(shí)現(xiàn)的功能做簡(jiǎn)要描述外,還應(yīng)包括使用的單片機(jī),晶振頻率,以及主要I/O口實(shí)現(xiàn)的功能。
2. 如果程序升級(jí)時(shí)應(yīng)增加如下說明。
1) 程序升級(jí)后的版本號(hào):例如“版本號(hào):Ver105”
2) 程序升級(jí)的修改作者:例如“更改人:×××”
3) 程序升級(jí)的修改日期:例如“更改日期:01 12 17”
4) 應(yīng)對(duì)程序升級(jí)進(jìn)行簡(jiǎn)單修改說明。
5) 應(yīng)給出程序增加、更改、刪除項(xiàng)說明,每項(xiàng)總處數(shù)。
1.
程序頭如采用如下統(tǒng)一格式:
;****************
;* 文件名 *
;****************
;* 功能描述:
;* 軟件版本
;* 開始編寫—完成日期:
;* 作者:
三、子程序、標(biāo)號(hào)及變量命名規(guī)則(推薦)
1.子程序及標(biāo)號(hào)命名規(guī)則
子程序命名應(yīng)使用相關(guān)含義英文。子程序入口標(biāo)號(hào)應(yīng)使用子程序名相關(guān)含義、常用的英語單詞(拼音)或單詞(拼音)縮寫。如果一個(gè)英語單詞表述不清,應(yīng)使用多個(gè)英語單詞縮寫表示。程序里邊的標(biāo)號(hào)應(yīng)與執(zhí)行該分支功能相關(guān)含義、常用的英語單詞(拼音)或單詞(拼音)縮寫,如果沒有確切含義,應(yīng)優(yōu)先選用子程序入口標(biāo)號(hào)前面字母縮寫加兩位序號(hào)。
2.變量命名規(guī)則
標(biāo)志寄存器使用相關(guān)含義、常用的英語單詞英文+ Flag;暫用寄存器使用:暫存對(duì)象英文縮寫+Temp;計(jì)數(shù)寄存器使用暫存對(duì)象英文縮寫+ Numb;其它寄存器:與存放對(duì)象相關(guān)含義、常用的英語單詞(拼音)或單詞(拼音)縮寫。
3. 標(biāo)志位命名規(guī)則
標(biāo)志對(duì)象相關(guān)含義、常用的英語單詞(拼音)縮寫。
四、程序格式書寫規(guī)范
匯編語言的格式為:
[標(biāo)號(hào)] 指令助記符> [操作數(shù)] ;[注釋]
編程時(shí)為了程序結(jié)構(gòu)清楚,要求如下:
1. 四個(gè)部分之間以tab鍵分隔(tab鍵定義為8個(gè)空格),而不使用空格。
2. 對(duì)于相同的部分要求上下對(duì)齊。
3. 標(biāo)號(hào)后必須跟冒號(hào)(:)
4. 雖然標(biāo)號(hào)中的字母大小寫表示不同的含義,但不允許用同樣的字符定義兩個(gè)不同的標(biāo)號(hào)。
5. 操作數(shù)的第一個(gè)字母要求大寫,其余字符小寫;如果操作數(shù)為常量,要求第一個(gè)大寫的字符為“C“。
6. 注釋要求使用中文。
五.程序注釋
A.變量及軟件標(biāo)志注釋
對(duì)于標(biāo)志寄存器、全局變量和關(guān)鍵的標(biāo)志位應(yīng)加注釋,說明如下:
1. 變量注釋:
l 寫清變量在程序中起的作用
l 注明變化時(shí)刻。
l 當(dāng)使用復(fù)用變量時(shí),應(yīng)注釋變量生命周期。
l 程序升級(jí)所涉及到的變量的增加、改變或者刪除。該變量的用途是什么?是否需要初始化? 注釋應(yīng)包括版本號(hào)。
晶振相關(guān)文章:晶振原理
評(píng)論