源代码风格说明:(最核心的原则就是:便于代码的读、修改和他人的维护) 1、必须严格按照自己既有的编程风格进行代码的编写; 2、提炼出公共函数,以免重复劳动; 3、必须给源文件添加注释;我的源码固定编程风格如下:尽量采用头文件;错行按一个TAB的标准,同层次代码严格对齐;变量名首字母均大写,多单词组合的变量名中间用下划线连接;乘除尽量采用<< 和 >>,以优化代码;1.源码开始处的交代: /****************************************************************************************** ***** * 文件名:xxx.c *程序编写:xxx *联系方式:PHONE:13881831877,Fax
028)85568342,QQ:22271184,Email:aijun9801@163.com 成都上嵌科技(ChengDU Top Embedded CO..LTD) *功能描述: *晶振频率:12Mhz *版本: V1.0 *创建时间:2008年5月4日 *修改时间:2008年5月4日晚上于北京交通大学,主要修改正负温度的判断和温度的转换部分代码。 *其它说明:xxx.c源文件在移动硬盘上的开发平台中有备份 ******************************************************************************************* *****/ 2.所有子程序都采用函数声明的方式,子程序编程风格如下: /****************************************************************************************** ***** *子程序名称:DS1820_Reset() *子程序功能: * 参数传递: * 返回值: ******************************************************************************************* *****/ void DS1820_Reset() { unsigned char i; bit flag; //DS1820存在标志位 DQ = 0; //拉低总线 for (i=240;i>0;i--); //延时480微秒,产生复位脉冲 DQ = 1; //释放总线 for (i=40;i>0;i--); //延时80微秒对总线采样 flag = DQ; for (i=200;i>0;i--); //延时400微秒等待总线恢复 //return (flag); //根据flag的值可以知道DS1820是否存在或损坏 } 3.源代码结束标志编程风格如下: /****************************************************************************************** ***** ****************************************the end************************************************ ******************************************************************************************* *****/
文章评论(0条评论)
登录后参与讨论