PIC单片机汇编编程规范
PIC单片机汇编编程规范是对PIC单片机汇编语言的编程规范的总结,涵盖了程序命名规范、程序头格式、子程序、标号及变量命名规则、程序格式书写规范、程序注释等方面。
一、程序命名规范
程序文件名由两部分构成:一部分为产品型号或功能描述,一部分为软件版本号。产品型号用字母描述,可为英文或中文拼音。软件版本号为4位,前一位固定为字母”V”,后3位为数字,编写软件版本号应按照从小到大的顺序递增。开发阶段版本号从001开始;中试之后版本号从100开始。
二、程序头格式
程序头格式规定了每个文件的开始要有一个对该文件总体功能的描述,软件版本,以及作者及编写时间。采用模板统一格式。程序头应包含程序升级后的版本号、修改作者、修改日期、程序升级进行简单修改说明、程序增加、更改、删除项说明等信息。
三、子程序、标号及变量命名规则
子程序命名应使用相关含义英文,子程序入口标号应使用子程序名相关含义、常用的英语单词(拼音)或单词(拼音)缩写。如果一个英语单词表述不清,应使用多个英语单词缩写表示。程序里的标号应与执行该分支功能相关含义、常用的英语单词(拼音)或单词(拼音)缩写,如果没有确切含义,应优先选用子程序入口标号前面字母缩写加两位序号。
变量命名规则规定了标志寄存器使用相关含义、常用的英语单词英文+ Flag;暂用寄存器使用暂存对象英文缩写+Temp;计数寄存器使用暂存对象英文缩写+ Numb;其它寄存器:与存放对象相关含义、常用的英语单词(拼音)或单词(拼音)缩写。
四、程序格式书写规范
汇编语言的格式为:[标号] <指令助记符> [操作数];[注释]。编程时为了程序结构清楚,要求如下:四个部分之间以 tab 键分隔(tab 键定义为 8 个空格),而不使用空格。对于相同的部分要求上下对齐。标号后必须跟冒号(:)。虽然标号中的字母大小写表示不同的含义,但不允许用同样的字符定义两个不同的标号。操作数的第一个字母要求大写,其余字符小写;如果操作数为常量,要求第一个大写的字符为“C“。注释要求使用中文。
五、程序注释
程序注释分为变量及软件标志注释、子程序注释、程序分支、I/O注释等几个方面。
变量及软件标志注释要求对标志寄存器、全局变量和关键的标志位加注释,说明变量在程序中起的作用、变化时刻、使用复用变量时的生命周期、程序升级所涉及到的变量的增加、改变或者删除。
子程序注释要求在子程序前加注释,注释应包括功能说明、入口条件、出口信息、影响资源、执行时间等信息。
程序分支、I/O注释要求对程序执行的分支功能加注释,对关键I/O口的使用加注释。