AVR c語(yǔ)言?xún)?yōu)秀編程風(fēng)格
文件結(jié)構(gòu)
模塊化的程序應(yīng)該是有一個(gè)很好的程序結(jié)構(gòu)的。AVR C語(yǔ)言程序有兩種用戶(hù)文件,.c程序文件,.h頭文件,程序中編寫(xiě)過(guò)程中需要在.c文件中包含.h頭文件。初學(xué)者往往出現(xiàn)重復(fù)包含或者頭文件包含錯(cuò)誤的問(wèn)題,我當(dāng)時(shí)也時(shí)常為這種錯(cuò)誤而發(fā)愁。下面我以我寫(xiě)的電機(jī)驅(qū)動(dòng)例程來(lái)給大家說(shuō)明一下,優(yōu)秀的編程文件結(jié)構(gòu)。
這個(gè)工程中有8個(gè)文件,一個(gè)說(shuō)明文件,如下圖:下載程序例子電機(jī)控制案例。
我寫(xiě)的成型的程序的文件個(gè)數(shù)基本上都是偶數(shù),因?yàn)槊恳粋€(gè)結(jié)構(gòu)化的函數(shù)定義.c文件都會(huì)對(duì)應(yīng)一個(gè).h文件。main.c對(duì)應(yīng)config.h。我們來(lái)看看各文件的包含關(guān)系。下面我們看看這些文件的包含關(guān)系與內(nèi)容:[推薦的文件包含順序與關(guān)系]
所有.c文件都包含了config.h文件。如: #include "config.h"
在config.h 中有如下代碼:
#include"delay.h"#include"device_init.h"#include"motor.h"
這樣做就不容易出現(xiàn)錯(cuò)誤的包含關(guān)系,為了預(yù)防萬(wàn)一,我們還引入了宏定義與預(yù)編譯。如下:
#ifndef_UNIT_H__#define_UNIT_H__1//100usexternvoidDelay100us(uint8n);//1sexternvoidDelay1s(uint16n);//n<=6,whenn==7,itis1.//1msexternvoidDelay1ms(uint16n);#endif第一次包含本文件的時(shí)候正確編譯,并且#define_UNIT_H__1,第二次包含本文件#ifndef_UNIT_H__就不再成立,跳過(guò)文件。預(yù)編譯還有更多的用途,比如可以根據(jù)不同的值編譯不同的語(yǔ)句,如下://#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ù)命名應(yīng)該按照盡量短,按需長(zhǎng),具有實(shí)際意義??梢酝ㄟ^(guò)下劃線(xiàn)或者大小寫(xiě)結(jié)合的方法組合動(dòng)詞和名詞組成變量函數(shù)名。下面對(duì)比好的命名方法與不好的命名方法:
好的: 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ù)的使用,因?yàn)槟阋院蟛恢滥愕降资裁吹胤秸{(diào)用了函數(shù),導(dǎo)致程序調(diào)試難度增加。可以在定義函數(shù)的過(guò)程中調(diào)用其他函數(shù)作為函數(shù)體。
//PWM頻率=系統(tǒng)時(shí)鐘頻率/(分頻系數(shù)*2*計(jì)數(shù)器上限值))voidtimer2_init(void){TCCR2=0x00;//stopTCNT2=0x01;//setcountOCR2=0x66;//setcompareTCCR2=(1<在少數(shù)幾個(gè)文件中調(diào)用函數(shù),在main.c中調(diào)用大部分函數(shù),在interupts.c中根據(jù)不同的中斷調(diào)用服務(wù)函數(shù)。
voidmain(void){//初始工作init_devices();while(1){for_ward(0);//默認(rèn)速度運(yùn)轉(zhuǎn)正Delay1s(5);//延時(shí)5smotor_stop();//停止Delay1s(5);//延時(shí)5sback_ward(0);//默認(rèn)速度運(yùn)轉(zhuǎn)反Delay1s(5);//延時(shí)5sspeed_add(20);//加速Delay1s(5);//延時(shí)5sspeed_subtract(20);//減速Delay1s(5);//延時(shí)5s}}宏定義
宏定義主要用于兩個(gè)地方:
一是用得非常多的命令或語(yǔ)句,利用宏將其簡(jiǎn)化。
#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;二是利用宏定義方便的進(jìn)行硬件接口操作,再程序需要修改時(shí),只需要修改宏定義即可,而不需要滿(mǎn)篇去找命令行,進(jìn)行修改。
//PD4,PD5電機(jī)方向控制如果更改管腳控制電機(jī)方向,更改PORTD|=0x10即可。#definemoto_en1PORTD|=0x10#definemoto_en2PORTD|=0x20#definemoto_uen1PORTD&=~0x10#definemoto_uen2PORTD&=~0x20//啟動(dòng)TC2定時(shí)比較和溢出#defineTC2_ENTIMSK|=(<<1OCIE2)|(1<關(guān)于注釋
為了增加程序的可讀性,方便合作者讀動(dòng)程序,或者程序作者在一段時(shí)間之后還能看懂程序,我們需要在程序中寫(xiě) 注釋。
在比較特殊的函數(shù)使用或者命令調(diào)用的地方加單行注釋。使用方法為:
Tbuf_putchar(c,RTbuf);//將數(shù)據(jù)加入到發(fā)送緩沖區(qū)并開(kāi)中斷externvoidDelay1s(uint16n);//n<=6,whenn==7,itis1.在模塊化的函數(shù)中使用詳細(xì)段落注釋?zhuān)?br/>
在文件頭上加文件名,文件用途,作者,日期等信息。
要清楚,注釋是為了方便閱讀,增強(qiáng)程序的可度性,不要本末倒置,不要給很簡(jiǎn)單大家都能看明白的程序加注釋?zhuān)灰屪⑨屟蜎](méi)了你的程序結(jié)構(gòu)。對(duì)于函數(shù),變量等盡量使用文件名自注釋的方法,及通過(guò)文件名就可以知道意思。
本文結(jié)束了,新手教程也結(jié)束了,希望我們教程能讓你輕松進(jìn)入AVR的世界。