ASM编程规范1.0.doc

汇编语言编程规范 Version 1.0 汇编语言编程规范 软件设计一种工程。如果不统一编程规范，最终写出的程序，其可读性将较差，这不仅给代码的理解带来障碍，增加维护阶段的工作量，同时不规范的代码隐含错误的可能性也比较大。分析表明，编码阶段产生的错误当中，语法错误大概占20%左右，而由于未严格检查软件逻辑导致的错误、函数（模块）之间接口错误及由于代码可理解度低导致优化维护阶段对代码的错误修改引起的错误则占了一半以上。可见，提高软件质量必须降低编码阶段的错误率。如何有效降低编码阶段的错误呢？这需要制定详细的软件编程规范，并培训每一位程序员，最终的结果可以把编码阶段的错误降至10%左右，同时也降低了程序的测试费用，效果相当显著。?????本从代码的可维护性（可读性、可理解性、可修改性）、代码逻辑与效率、函数（模块）接口、可测试性四个阐述，规范分成规则和建议两种，其中规则部分为强制执行项目，而建议部分则不作强制，可根据习惯取舍。 1．排版?? 1.1程序块使用缩进方式，函数和标号使用空格缩进，程序段混合使用.以兼容各种程序编辑器 ?? 1.2在指令的操作数之间的，使用空格进行间隔，采用这种松散方式编写代码的目的是使代码更加清晰。?? 1.3一行最多写一条语句。 ?? 1.4 变量定义时，保持对齐。便于阅读和检查内存的使用情况。2．注释???????注释的原则是有助于对程序的阅读理解，注释不宜太多也不能太少，太少不利于代码理解，太多则会对阅读产生干扰，因此只在必要的地方才加注释，而且注释要准确、易懂、尽可能简洁,。注释量一般控制在30%到50%之间。 2.1程序在必要的地方必须有注释，注释要准确、易懂、简洁。 ? 例如如下注释()意义不大：?????????? MOV DXCE1COUNTER,#00H??? ; 将DXCE1COUNTER赋值为0????????而如下的注释则给出了额外有用的信息：?????????? JNZ??? PcComm_Err??????????????? ; 假如校验出错 ????2.2注释应与其描述的代码相近，对代码的注释应放在其上方或右方（对单条语句的注释）相邻位置，不可放在下面，如放于上方则需与其上面的代码用空行隔开。 ????2.3头文件、源文件的头部，应进行注释。注释必须列出：文件名、作者、目的、功能、修改日志等。 ????2.4 函数头部应进行注释，列出：函数的目的、功能、输入参数、输出参数、涉及到的通用变量和寄存器、调用的其他函数和模块、修改日志等。对一些复杂的函数，在注释中最好提供典型用法。 ????2.5 对重要代码段的功能、意图进行注释，提供有用的、额外的信息。并在该代码段的结束处加一行注释表示该段代码结束。 ????2.6 对于所有的常量，变量，数据结构声明(包括数组、结构、类、枚举等)，如果其命名不是充分自注释的，在声明时都必须加以注释，说明其含义。 2.7 维护代码时，要更新相应的注释，删除不再有用的注释。保持代码、注释的一致性，避免产生误解。 3．命名?? 3.1 标识符缩写???? 形成缩写的几种技术： 去掉所有的不在词头的元音字母。如screen写成scrn, primtive写成prmv。 使用每个单词的头一个或几个字母。如Channel Activation写成ChanActiv，Release ,Indication写成RelInd。使用变量名中每个有典型意义的单词。如Count of Failure写成FailCnt。 去掉无用的单词后缀 ing, ed等。如Paging Request写成PagReq。 使用标准的或惯用的缩写形式（包括协议文件中出现的缩写形式）。如BSIC(Base Station Identification Code)、MAP(Mobile Application Part)。对于在全局范国内使用的变量和函数，如果希望它们在c语言和汇编编写的程序都可以被访问的话，应遵从如下的规则：在C语言和汇编语言中均需要声明它是全局的，对函数而言还必须在C语言中给出准确的函数原型说明；在c语言中保持“自然”的命名，而在汇编语言中该名字需加一个下划线作为前缀。. 关于缩写的准则：?????? 1 缩写应该保持一致性。如Channel不要有时缩写成Chan，有时缩写成Ch。Length有时缩写成Len，有时缩写成len。???????2 在源代码头部加入注解来说明协议相关的、非通用缩写。???????3 标识符的长度不超过12个字符。3.2 变量命名约定：前缀 + 主体??????? ; 注释????变量命名要考虑简单、直观、不易混淆。前缀是可选项，表示变量类型，由于汇编中变量多是单字节变量，所以单字节变量可以不加前缀，对于