在单片机领域，一直有一个怪现象，就是：每个程序员写的程序，都只有自己看得懂。原因何在？盖因每个程序员写程序时，都按自己的习惯来写，大家没有统一的规范。如此以来，造成诸多弊端：
1、 可读性极差。读懂别人的一个程序，比自己写一个程序的时间还长。
2、 可维护性极差。程序越写越长，越改越烂，像懒婆娘的裹脚布，又长又臭又粘。
3、 可移植性极差。今天你写程序用的子程序，明天我写程序时，这些子程序又得重写一遍。众多的程序员在程序的苦海中重复着低级劳动¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬……
4、 开发周期长。客户怨声载道，老板的MONEY不禁使唤……
……
在此，特发出倡议：让我们共同来制定一个程序编写规范，大家都用这种规范来写程序，并逐步推动其成为一种行业标准。
（以上摘自于匠人手记，下面是作者自编的汇编程序格式规范）
1、程序的开头：
在开头部分，我们应该说明以下几个关键点：
a、程序编写人 b、程序编写时间 c、程序实现的功能
;//////////////////////////////////////////////////////
;程序编写人： 王筝 QQ:408864998
;程序编写时间： 2008年12月11日星期四
;程序实现的功能： 本程序实现P2口的流水灯，低电平点亮
;//////////////////////////////////////////////////////
2、子程序的注释
严格来说，所有的程序，每条指令，都必须写上注释。但在实际中，有的同学想节省时间，但也不能代表不需要写注释，可以只对子程序进行注释。子程序的注释，主要包括下面几个关键点：
a、子程序的名称 b、子程序实现的功能 c、输入 d、输出
;///////////////显示子程序///////////////////
;输入："A"
;输出: "P2口"
;实现的功能:把A的数输出到P2口显示
display: mov shuchu,a ;p2口输出要显示的灯
ret
3、主程序
主程序是方便大家把程序模块化，从主程序反应的信息，一定是整个程序的整体，因此主程序一定是调用子程序或者判断，主程序指令最好不要超过20条。
;/////////主程序////////////////////////////
start: mov a,#01h ;初始化
main: call display ;显示
call delay ;延时
call zuoyi ;左移
ljmp main ;循环
4、初始化的定义
在单片机的主程序前，必须要对所有的I/O口，以及用到的资源进行定义，定义的名称应该通俗易懂，方便大家进行以后阅读程序，增强程序的可读性。并且对定义的名称，进行注释。
;/////////开始自定义及初始化////////////////
shuchu equ p2 ;定义P2口为输出口
pianxuan equ p1 ;P1为片选口
cishu equ 10 ;循环次数
shuzhi equ 100 ;显示的数值
|
楼主
标题置顶
标题高亮
