文件結(jié)構(gòu)

模塊化的程序應該是有一個很好的程序結(jié)構(gòu)的。AVR C語言程序有兩種用戶文件，.c程序文件，.h頭文件，程序中編寫過程中需要在.c文件中包含.h頭文件。初學者往往出現(xiàn)重復包含或者頭文件包含錯誤的問題，我當時也時常為這種錯誤而發(fā)愁。下面我以我寫的電機驅(qū)動例程來給大家說明一下，優(yōu)秀的編程文件結(jié)構(gòu)。

這個工程中有8個文件，一個說明文件，如下圖：下載程序例子電機控制案例。

我寫的成型的程序的文件個數(shù)基本上都是偶數(shù)，因為每一個結(jié)構(gòu)化的函數(shù)定義.c文件都會對應一個.h文件。main.c對應config.h。我們來看看各文件的包含關系。下面我們看看這些文件的包含關系與內(nèi)容：[推薦的文件包含順序與關系]

所有.c文件都包含了config.h文件。如： #include "config.h"

在config.h 中有如下代碼：

#include"delay.h"#include"device_init.h"#include"motor.h"

這樣做就不容易出現(xiàn)錯誤的包含關系，為了預防萬一，我們還引入了宏定義與預編譯。如下：

#ifndef_UNIT_H__#define_UNIT_H__1//100usexternvoidDelay100us(uint8n);//1sexternvoidDelay1s(uint16n);//n<=6,whenn==7,itis1.//1msexternvoidDelay1ms(uint16n);#endif第一次包含本文件的時候正確編譯，并且#define_UNIT_H__1，第二次包含本文件#ifndef_UNIT_H__就不再成立，跳過文件。預編譯還有更多的用途，比如可以根據(jù)不同的值編譯不同的語句，如下：//#pragmaREGPARMS#ifCPU_TYPE==M128#include#endif#ifCPU_TYPE==M64#include#endif#ifCPU_TYPE==M32#include#endif#ifCPU_TYPE==M16#include#endif#ifCPU_TYPE==M8#include#endif

#include 與 #include "filename" 的區(qū)別 ：前者是包含系統(tǒng)目錄include下 的文件，后者是包含程序目錄下的文件。

變量名與函數(shù)名

變量以及函數(shù)命名應該按照盡量短，按需長，具有實際意義?？梢酝ㄟ^下劃線或者大小寫結(jié)合的方法組合動詞和名詞組成變量函數(shù)名。下面對比好的命名方法與不好的命名方法：

好的： Delay100us();
不好的： Yanshi();

好的： init_devices();
不好的： Chengxuchushihua();

好的： int temp;
不好的： int dd;

外部調(diào)用

首先在模塊化程序的.h文件中定義extern

//端口初始化externvoidport_init(void);//T2初始化voidtimer2_init(void);//各種參數(shù)初始化externvoidinit_devices(void);

模塊化程序的.c文件中定義函數(shù)，不要在模塊化的程序中調(diào)用程序，及不要出現(xiàn)向timer2_init();這樣函數(shù)的使用，因為你以后不知道你到底什么地方調(diào)用了函數(shù)，導致程序調(diào)試難度增加?？梢栽诙x函數(shù)的過程中調(diào)用其他函數(shù)作為函數(shù)體。

//PWM頻率=系統(tǒng)時鐘頻率/（分頻系數(shù)*2*計數(shù)器上限值））voidtimer2_init(void){TCCR2=0x00;//stopTCNT2=0x01;//setcountOCR2=0x66;//setcompareTCCR2=(1<
在少數(shù)幾個文件中調(diào)用函數(shù)，在main.c中調(diào)用大部分函數(shù)，在interupts.c中根據(jù)不同的中斷調(diào)用服務函數(shù)。
voidmain(void){//初始工作init_devices();while(1){for_ward(0);//默認速度運轉(zhuǎn)正Delay1s(5);//延時5smotor_stop();//停止Delay1s(5);//延時5sback_ward(0);//默認速度運轉(zhuǎn)反Delay1s(5);//延時5sspeed_add(20);//加速Delay1s(5);//延時5sspeed_subtract(20);//減速Delay1s(5);//延時5s}}
宏定義
宏定義主要用于兩個地方：
一是用得非常多的命令或語句，利用宏將其簡化。
#ifndefTRUE#defineTRUE1#endif#ifndefFALSE#defineFALSE0#endif#ifndefNULL#defineNULL0#endif#defineMIN(a,b)((ab)?(a):(b))#defineABS(x)((x>)?(x):(-x))typedefunsignedcharuint8;typedefsignedcharint8;typedefunsignedintuint16;typedefsignedintint16;typedefunsignedlonguint32;typedefsignedlongint32;
二是利用宏定義方便的進行硬件接口操作，再程序需要修改時，只需要修改宏定義即可，而不需要滿篇去找命令行，進行修改。
//PD4,PD5電機方向控制如果更改管腳控制電機方向，更改PORTD|=0x10即可。#definemoto_en1PORTD|=0x10#definemoto_en2PORTD|=0x20#definemoto_uen1PORTD&=~0x10#definemoto_uen2PORTD&=~0x20//啟動TC2定時比較和溢出#defineTC2_ENTIMSK|=(<<1OCIE2)|(1<
關于注釋
為了增加程序的可讀性，方便合作者讀動程序，或者程序作者在一段時間之后還能看懂程序，我們需要在程序中寫 注釋。
在比較特殊的函數(shù)使用或者命令調(diào)用的地方加單行注釋。使用方法為：
Tbuf_putchar(c,RTbuf);//將數(shù)據(jù)加入到發(fā)送緩沖區(qū)并開中斷externvoidDelay1s(uint16n);//n<=6,whenn==7,itis1.
在模塊化的函數(shù)中使用詳細段落注釋：
在文件頭上加文件名，文件用途，作者，日期等信息。
要清楚，注釋是為了方便閱讀，增強程序的可度性，不要本末倒置，不要給很簡單大家都能看明白的程序加注釋，不要讓注釋淹沒了你的程序結(jié)構(gòu)。對于函數(shù)，變量等盡量使用文件名自注釋的方法，及通過文件名就可以知道意思。
本文結(jié)束了，新手教程也結(jié)束了，希望我們教程能讓你輕松進入AVR的世界。