摘要：作為一個(gè)初學(xué)者如何具有良好的程序設(shè)計(jì)風(fēng)格呢？下面小編將以avr單片機(jī)介紹它的c語(yǔ)言編程風(fēng)格。

　　C語(yǔ)言編程風(fēng)格介紹

　　1.變量定義

　　在定義變量時(shí)，前綴使用變量的類型，之后使用表現(xiàn)變量用途的英文單詞或單詞縮寫(xiě)，且每個(gè)單詞或縮寫(xiě)的首字母大寫(xiě)，各種前綴縮寫(xiě)如下：

　　無(wú)符號(hào)變量使用 u8，u16，u32；例：unsigned char u8Temp；

　　有符號(hào)變量使用 s8，s16，s32；例：char s8Temp；

　　浮點(diǎn)數(shù)變量使用 f32，d64；例：float f32Temp；

　　結(jié)構(gòu)體變量使用 st；例：struct Temp stTemp；

　　字符串變量使用 s；例：char sTemp；

　　數(shù)組變量使用 a；例：unsigned char aTemp［10］；

　　指針變量使用 p；例：unsigned char *pTemp；

　　枚舉變量使用 e；例：enum Temp eTemp；

　　2.宏定義

　　對(duì)于宏定義使用大寫(xiě)+下劃線的方式。

　　3.程序排版

　　一行程序的開(kāi)始使用tab鍵進(jìn)行對(duì)齊，一行的中間使用空格鍵進(jìn)行對(duì)齊。

　　這樣防止不同的編輯工具打開(kāi)時(shí)，造成代碼混亂。

　　4.注釋的書(shū)寫(xiě)

　　這里注釋分為函數(shù)頭注釋，程序中代碼注釋，

　　函數(shù)頭注釋使用如下形式

　　/*

　　*Name：

　　*Description：

　　*Created：

　　*Author：

　　*/

　　這四項(xiàng)必選，其他的如函數(shù)的傳入傳出參數(shù)，視函數(shù)的需要適當(dāng)增加。

　　5.測(cè)試代碼

　　在編程的同時(shí)，需要注意添加適當(dāng)?shù)臏y(cè)試代碼，這樣可以減輕以后測(cè)試代碼時(shí)的工作量。

　　AVR c語(yǔ)言優(yōu)秀編程風(fēng)格

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

　　模塊化的程序應(yīng)該是有一個(gè)很好的程序結(jié)構(gòu)的。AVR C語(yǔ)言程序有兩種用戶文件，.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

　　//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__就不再成立，跳過(guò)文件。

　　預(yù)編譯還有更多的用途，比如可以根據(jù)不同的值編譯不同的語(yǔ)句，如下：

　　//#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

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

　　變量名與函數(shù)名

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

　　1.好的： Delay100us（）;

　　不好的： Yanshi（）;

　　2.好的： init_devices（）;

　　不好的： Chengxuchushihua（）;

　　3.好的： int temp;

　　不好的： int dd;

　　外部調(diào)用

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

　　//端口初始化

　　extern void port_init（void）;

　　//T2初始化

　　void timer2_init（void）;

　　//各種參數(shù)初始化

　　extern void init_devices（void）;

　　2.模塊化程序的.c文件中定義函數(shù)，不要在模塊化的程序中調(diào)用程序，及不要出現(xiàn)向timer2_init（）;這樣函數(shù)的使用，因?yàn)槟阋院蟛恢滥愕降资裁吹胤秸{(diào)用了函數(shù)，導(dǎo)致程序調(diào)試難度增加?？梢栽诙x函數(shù)的過(guò)程中調(diào)用其他函數(shù)作為函數(shù)體。

　　/**************************采用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越大，輸出越大

　　}

　　3.在少數(shù)幾個(gè)文件中調(diào)用函數(shù)，在main.c中調(diào)用大部分函數(shù)，在interupts.c中根據(jù)不同的中斷調(diào)用服務(wù)函數(shù)。

　　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

　　}

　　}

　　宏定義

　　宏定義主要用于兩個(gè)地方：

　　1.一是用得非常多的命令或語(yǔ)句，利用宏將其簡(jiǎn)化。

　　#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; /* 定義可移植的無(wú)符號(hào)8位整數(shù)關(guān)鍵字 */

　　typedef signed char int8; /* 定義可移植的有符號(hào)8位整數(shù)關(guān)鍵字 */

　　typedef unsigned int uint16; /* 定義可移植的無(wú)符號(hào)16位整數(shù)關(guān)鍵字 */

　　typedef signed int int16; /* 定義可移植的有符號(hào)16位整數(shù)關(guān)鍵字 */

　　typedef unsigned long uint32; /* 定義可移植的無(wú)符號(hào)32位整數(shù)關(guān)鍵字 */

　　typedef signed long int32; /* 定義可移植的有符號(hào)32位整數(shù)關(guān)鍵字 */

　　2.二是利用宏定義方便的進(jìn)行硬件接口操作，再程序需要修改時(shí)，只需要修改宏定義即可，而不需要滿篇去找命令行，進(jìn)行修改。

　　//PD4，PD5 電機(jī)方向控制 如果更改管腳控制電機(jī)方向，更改PORTD |= 0x10即可。

　　#define moto_en1 PORTD |= 0x10

　　#define moto_en2 PORTD |= 0x20

　　#define moto_uen1 PORTD &=~ 0x10

　　#define moto_uen2 PORTD &=~ 0x20

　　//啟動(dòng)TC2定時(shí)比較和溢出

　　#define TC2_EN TIMSK |= （《《1OCIE2）|（1《《TOIE2）

　　//禁止TC2再定時(shí)比較和溢出

　　#define TC2_DIS TIMSK &=~ （1《《OCIE2）|（1《《TOIE2）

　　關(guān)于注釋

　　為了增加程序的可讀性，方便合作者讀動(dòng)程序，或者程序作者在一段時(shí)間之后還能看懂程序，我們需要在程序中寫(xiě) 注釋。

　　在比較特殊的函數(shù)使用或者命令調(diào)用的地方加單行注釋。使用方法為：

　　Tbuf_putchar（c，RTbuf）; // 將數(shù)據(jù)加入到發(fā)送緩沖區(qū)并開(kāi)中斷

　　extern void Delay1s（uint16 n）; // n 《= 6 ，when n==7， it is 1.

　　在模塊化的函數(shù)中使用詳細(xì)段落注釋：

　　/***********************

　　** 函數(shù)名稱： Com_putchar

　　** 功能描述： 從串行口輸出一個(gè)字符c

　　** 輸　入： c：輸出字符

　　** 輸出 ： 0：失敗 1：成功

　　** 全局變量： 無(wú)

　　** 調(diào)用模塊：

　　** 說(shuō)明：

　　** 注意：

　　********************/

　　在文件頭上加文件名，文件用途，作者，日期等信息。

　　/*********************************************************************************************************

　　** 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日

　　** 描　述： 原始版本

　　**

　　*********************************************************************************************************/

　　要清楚，注釋是為了方便閱讀，增強(qiáng)程序的可度性，不要本末倒置，不要給很簡(jiǎn)單大家都能看明白的程序加注釋，不要讓注釋淹沒(méi)了你的程序結(jié)構(gòu)。對(duì)于函數(shù)，變量等盡量使用文件名自注釋的方法，及通過(guò)文件名就可以知道意思。