?? avr c語言優(yōu)秀編程風(fēng)格.htm
字號:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3c.org/TR/1999/REC-html401-19991224/loose.dtd">
<!-- saved from url=(0048)http://www.avrvi.com/start/guide_avr_c_good.html -->
<HTML xmlns="http://www.w3.org/1999/xhtml"><HEAD><TITLE>AVR c語言優(yōu)秀編程風(fēng)格</TITLE>
<META http-equiv=Content-Type content="text/html; charset=gb2312">
<META content="AVR 新手入門 單片機(jī) AVR與虛擬儀器網(wǎng)站提供" name=description>
<META content="古欣 guxin[at]mail.sdu.edu.cn" name=author>
<META content="AVR 單片機(jī) 新手入門 手把手教程" name=keywords>
<STYLE title=css_design_by_guxin type=text/css media=all>@import url( ../inc/article.css );
</STYLE>
<LINK media=all href="AVR c語言優(yōu)秀編程風(fēng)格.files/article.css" type=text/css
rel=stylesheet>
<META content="MSHTML 6.00.2900.3199" name=GENERATOR></HEAD>
<BODY>
<DIV class=m>
<H1 class=c>AVR與虛擬儀器 www.avrvi.com</H1></DIV>
<DIV class=m>
<DIV id=head>
<P class=c>AVR與虛擬儀器致力于提供最優(yōu)質(zhì)的AVR和labview技術(shù)服務(wù)，最全的技術(shù)資料，最好的開發(fā)板方案。</P>
<P class=c>我們將以AVR DB-CORE Ver2.3 Atmega16開發(fā)板為平臺，一步一步，教會大家AVR單片機(jī)編程。</P>
<P class=c>本站所有范例都采用ICC編寫，ICC編譯器加AVR Studio下載調(diào)試，下載器為JTAG&ISP下載編程器。
</P></DIV></DIV>
<DIV class=m>
<DIV id=now>你現(xiàn)在的位置：<A href="http://www.avrvi.com/">AVR與虛擬儀器</A>>><A
href="http://www.avrvi.com/index_new_start.html">新手入門</A>>>AVR c語言優(yōu)秀編程風(fēng)格
<SPAN><A title=AVR與虛擬儀器論壇 href="http://bbs.avrvi.com/">論壇</A></SPAN></DIV></DIV>
<DIV class=m>
<H3>AVR c語言優(yōu)秀編程風(fēng)格 </H3>
<DIV class=pad10>
<P>作為一個(gè)初學(xué)者如何具有良好的程序設(shè)計(jì)風(fēng)格呢？我想引用一個(gè)關(guān)于初學(xué)者請教編程大師的故事讓讀者自己去領(lǐng)悟。</P>
<P>有一位編程大師，他寫非結(jié)構(gòu)化的程序，一位初學(xué)者刻意模仿他，也寫非結(jié)構(gòu)化的程序。當(dāng)他讓大師看他的進(jìn)步時(shí)，大師批評了他的非結(jié)構(gòu)化程序：“
對一位編程大師合適的東西未必對一個(gè)初學(xué)者同樣合適，在超越結(jié)構(gòu)化之前，你必須理解編程之道。”
我個(gè)人認(rèn)為作為一個(gè)初學(xué)者應(yīng)該踏踏實(shí)實(shí)的打好程序設(shè)計(jì)的基礎(chǔ)，不要急功近利，舍本逐末。我走過不少彎路，希望大家能和我一樣能牢記編程大師的忠告：“對編程大師合適的東西未必對一個(gè)初學(xué)者同樣合適”。
</P>
<P>本文所描述的優(yōu)秀編程風(fēng)格適合于大部分語言，文章中可能提到你不是很了解的概念，沒有關(guān)系，你放心的讀下去，當(dāng)你使用AVR一個(gè)月之后，你什么都明白了。</P>
<P class=title>AVR c語言優(yōu)秀編程風(fēng)格 </P>
<P><SPAN class=title>文件結(jié)構(gòu)</SPAN></P>
<P>模塊化的程序應(yīng)該是有一個(gè)很好的程序結(jié)構(gòu)的。AVR
C語言程序有兩種用戶文件，.c程序文件，.h頭文件，程序中編寫過程中需要在.c文件中包含.h頭文件。初學(xué)者往往出現(xiàn)重復(fù)包含或者頭文件包含錯(cuò)誤的問題，我當(dāng)時(shí)也時(shí)常為這種錯(cuò)誤而發(fā)愁。下面我以我寫的電機(jī)驅(qū)動例程來給大家說明一下，優(yōu)秀的編程文件結(jié)構(gòu)。</P>
<P>這個(gè)工程中有8個(gè)文件，一個(gè)說明文件，如下圖：下載程序例子 <A
href="http://www.avrvi.com/down.php?file=examples/motor_control.rar">電機(jī)控制案例</A>
。 </P>
<P><IMG height=238 alt=文件結(jié)構(gòu) src="AVR c語言優(yōu)秀編程風(fēng)格.files/file_srtuct.jpg"
width=152></P>
<P>我寫的成型的程序的文件個(gè)數(shù)基本上都是偶數(shù)，因?yàn)槊恳粋€(gè)結(jié)構(gòu)化的函數(shù)定義.c文件都會對應(yīng)一個(gè).h文件。main.c對應(yīng)config.h。我們來看看各文件的包含關(guān)系。下面我們看看這些文件的包含關(guān)系與內(nèi)容：[推薦的文件包含順序與關(guān)系]</P>
<UL>
<LI>所有.c文件都包含了config.h文件。如： #include "config.h"
<LI>在config.h 中有如下代碼：<BR><PRE>#include "delay.h"
#include "device_init.h"
#include "motor.h"</PRE>
<LI>這樣做就不容易出現(xiàn)錯(cuò)誤的包含關(guān)系，為了預(yù)防萬一，我們還引入了宏定義與預(yù)編譯。如下：<BR><PRE>#ifndef _UNIT_H__
#define _UNIT_H__ 1
//100us
extern void Delay100us(uint8 n);
//1s
extern void Delay1s(uint16 n); // n <= 6 ,when n==7, it is 1.
//1ms
extern void Delay1ms(uint16 n);
#endif
第一次包含本文件的時(shí)候正確編譯，并且#define _UNIT_H__ 1，第二次包含本文件#ifndef _UNIT_H__就不再成立，跳過文件。
預(yù)編譯還有更多的用途，比如可以根據(jù)不同的值編譯不同的語句，如下：
//#pragma REGPARMS
#if CPU_TYPE == M128
#include <iom128v.h>
#endif
#if CPU_TYPE == M64
#include <iom64v.h>
#endif
#if CPU_TYPE == M32
#include <iom32v.h>
#endif
#if CPU_TYPE == M16
#include <iom16v.h>
#endif
#if CPU_TYPE == M8
#include <iom8v.h>
#endif
</PRE>
<LI>#include<filename> 與 #include "filename" 的區(qū)別 ：前者是包含系統(tǒng)目錄include下
的文件，后者是包含程序目錄下的文件。 </LI></UL>
<P><SPAN class=title>變量名與函數(shù)名</SPAN></P>
<P>變量以及函數(shù)命名應(yīng)該按照<SPAN class=red>盡量短</SPAN>，<SPAN class=red>按需長</SPAN>，<SPAN
class=red>具有實(shí)際意義</SPAN>。可以通過下劃線或者大小寫結(jié)合的方法組合動詞和名詞組成變量函數(shù)名。下面對比好的命名方法與不好的命名方法：</P>
<OL>
<LI><STRONG>好的</STRONG>： Delay100us();<BR><STRONG>不好的</STRONG>： Yanshi();
<LI><STRONG>好的</STRONG>： init_devices();<BR><STRONG>不好的</STRONG>： Chengxuchushihua();
<LI><STRONG>好的</STRONG>： int
temp;<BR><STRONG>不好的</STRONG>： int dd; </LI></OL>
<P><SPAN class=title>外部調(diào)用</SPAN></P>
<OL>
<LI>首先在模塊化程序的.h文件中定義<SPAN class=red>extern</SPAN><BR><PRE>//端口初始化
extern void port_init(void);
//T2初始化
void timer2_init(void);
//各種參數(shù)初始化
extern void init_devices(void);</PRE>
<LI>模塊化程序的.c文件中定義函數(shù)，<SPAN
class=red>不要在模塊化的程序中調(diào)用程序</SPAN>，及不要出現(xiàn)向timer2_init();這樣函數(shù)的使用，因?yàn)槟阋院蟛恢滥愕降资裁吹胤秸{(diào)用了函數(shù)，導(dǎo)致程序調(diào)試難度增加。可以在定義函數(shù)的過程中調(diào)用其他函數(shù)作為函數(shù)體。<BR><PRE>/**************************采用timer2 產(chǎn)生波形***********************/
// PWM頻率 = 系統(tǒng)時(shí)鐘頻率/（分頻系數(shù)*2*計(jì)數(shù)器上限值））
void timer2_init(void)
{
TCCR2 = 0x00; //stop
TCNT2= 0x01; //set count
OCR2 = 0x66; //set compare
TCCR2 = (1<<WGM20)|(1<<WGM21)|(1<<COM21)|0x06; // start timer 快速pwm模式，匹配清零，溢出置位 256分頻
//占空比＝高比低為：(OCR2-0X01)/(0XFF-OCR2) OX01++++++(OCR2)__________OXFF (+表示輸出高，_表示輸出低)
//即OCR2越大，輸出越大
}</PRE>
<LI>在少數(shù)幾個(gè)文件中調(diào)用函數(shù)，在main.c中調(diào)用大部分函數(shù)，在interupts.c中根據(jù)不同的中斷調(diào)用服務(wù)函數(shù)。<BR><PRE>void main(void)
{
/******************************************************************************/
//初始工作
/******************************************************************************/
init_devices();
while(1)
{
for_ward(0); //默認(rèn)速度運(yùn)轉(zhuǎn) 正
Delay1s(5); //延時(shí)5s
motor_stop(); //停止
Delay1s(5); //延時(shí)5s
back_ward(0); //默認(rèn)速度運(yùn)轉(zhuǎn) 反
Delay1s(5); //延時(shí)5s
speed_add(20); //加速
Delay1s(5); //延時(shí)5s
speed_subtract(20); //減速
Delay1s(5); //延時(shí)5s
}
}</PRE></LI></OL>
<P><SPAN class=title>宏定義</SPAN></P>
<P>宏定義主要用于兩個(gè)地方：</P>
<OL>
<LI>一是用得非常多的命令或語句，利用宏將其簡化。<BR><PRE>#ifndef TRUE
#define TRUE 1
#endif
#ifndef FALSE
#define FALSE 0
#endif
#ifndef NULL
#define NULL 0
#endif
#define MIN(a,b) ((a<b)?(a):(b))
#define MAX(a,b) ((a>b)?(a):(b))
#define ABS(x) ((x>)?(x):(-x))
typedef unsigned char uint8; /* 定義可移植的無符號8位整數(shù)關(guān)鍵字 */
typedef signed char int8; /* 定義可移植的有符號8位整數(shù)關(guān)鍵字 */
typedef unsigned int uint16; /* 定義可移植的無符號16位整數(shù)關(guān)鍵字 */
typedef signed int int16; /* 定義可移植的有符號16位整數(shù)關(guān)鍵字 */
typedef unsigned long uint32; /* 定義可移植的無符號32位整數(shù)關(guān)鍵字 */
typedef signed long int32; /* 定義可移植的有符號32位整數(shù)關(guān)鍵字 */
</PRE>
<LI>二是利用宏定義方便的進(jìn)行硬件接口操作，再程序需要修改時(shí)，只需要修改宏定義即可，而不需要滿篇去找命令行，進(jìn)行修改。<BR><PRE>//PD4,PD5 電機(jī)方向控制 <SPAN class=red>如果更改管腳控制電機(jī)方向，更改PORTD |= 0x10即可。</SPAN>
#define moto_en1 PORTD |= 0x10
#define moto_en2 PORTD |= 0x20
#define moto_uen1 PORTD &=~ 0x10
#define moto_uen2 PORTD &=~ 0x20
//啟動TC2定時(shí)比較和溢出
#define TC2_EN TIMSK |= (<<1OCIE2)|(1<<TOIE2)
//禁止TC2再定時(shí)比較和溢出
#define TC2_DIS TIMSK &=~ (1<<OCIE2)|(1<<TOIE2)</PRE></LI></OL>
<P><SPAN class=title>關(guān)于注釋</SPAN></P>
<P>為了增加程序的可讀性，方便合作者讀動程序，或者程序作者在一段時(shí)間之后還能看懂程序，我們需要在程序中寫 注釋。</P>
<OL>
<LI>在比較特殊的函數(shù)使用或者命令調(diào)用的地方加單行注釋。使用方法為：<BR><PRE>Tbuf_putchar(c,RTbuf); // 將數(shù)據(jù)加入到發(fā)送緩沖區(qū)并開中斷
extern void Delay1s(uint16 n); // n <= 6 ,when n==7, it is 1. </PRE>
<LI>在模塊化的函數(shù)中使用詳細(xì)段落注釋：<BR><PRE>/***********************
** 函數(shù)名稱: Com_putchar
** 功能描述: 從串行口輸出一個(gè)字符c
** 輸 入: c:輸出字符
** 輸出 : 0:失敗 1:成功
** 全局變量: 無
** 調(diào)用模塊:
** 說明：
** 注意：
********************/</PRE>
<LI>在文件頭上加文件名，文件用途，作者，日期等信息。<BR><PRE>/*********************************************************************************************************
** serial driver
** (c) Copyright 2005-2006, limaokui
** All Rights Reserved
**
** V1.1.0
**
**
**--------------文件信息--------------------------------------------------------------------------------
**文 件 名:sio.c
**創(chuàng) 建 人: 李茂奎
**最后修改日期: 2005年7月13日
**描 述: serial driver
**
**--------------歷史版本信息----------------------------------------------------------------------------
** 創(chuàng)建人: 李茂奎
** 版 本: V1.00
** 日 期: 2005年7月13日
** 描 述: 原始版本
**
*********************************************************************************************************/</PRE></LI></OL>
<P>要清楚，注釋是為了方便閱讀，增強(qiáng)程序的可度性，不要本末倒置，不要給很簡單大家都能看明白的程序加注釋，不要讓注釋淹沒了你的程序結(jié)構(gòu)。對于函數(shù)，變量等盡量使用文件名自注釋的方法，及通過文件名就可以知道意思。</P>
<P>本文結(jié)束了，新手教程也結(jié)束了，希望我們教程能讓你輕松進(jìn)入AVR的世界。</P>
<P><A
href="http://www.avrvi.com/">AVR與虛擬儀器網(wǎng)站</A>全體工作人員謝謝你對本站的支持，謝謝你光臨本站。</P></DIV></DIV>
<DIV class=m>
<H4 id=link><A href="http://www.avrvi.com/">AVR 與虛擬儀器</A>歡迎交換鏈接，請與小古聯(lián)系
avrvi【at】163.com </H4>
<SCRIPT src="AVR c語言優(yōu)秀編程風(fēng)格.files/links.js" type=text/javascript></SCRIPT>
<SCRIPT src="AVR c語言優(yōu)秀編程風(fēng)格.files/footer.js" type=text/javascript></SCRIPT>
</DIV></BODY></HTML>
?? 快捷鍵說明
復(fù)制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -