描述
摘要：作為一個初學者如何具有良好的程式設計風格呢？下面小編将以avr單片機介紹它的c語言程式設計風格。
C語言程式設計風格介紹
1.變量定義
在定義變量時，字首使用變量的類型，之後使用表現變量用途的英文單詞或單詞縮寫，且每個單詞或縮寫的首字母大寫，各種字首縮寫如下：
無符号變量使用 u8，u16，u32；例：unsigned char u8Temp；
有符号變量使用 s8，s16，s32；例：char s8Temp；
浮點數變量使用 f32，d64；例：float f32Temp；
結構體變量使用 st；例：struct Temp stTemp；
字元串變量使用 s；例：char sTemp；
數組變量使用 a；例：unsigned char aTemp［10］；
指針變量使用 p；例：unsigned char *pTemp；
枚舉變量使用 e；例：enum Temp eTemp；
2.宏定義
對于宏定義使用大寫+下劃線的方式。
3.程式排版
一行程式的開始使用tab鍵進行對齊，一行的中間使用空格鍵進行對齊。
這樣防止不同的編輯工具打開時，造成代碼混亂。
4.注釋的書寫
這裡注釋分為函數頭注釋，程式中代碼注釋，
函數頭注釋使用如下形式
這四項必選，其他的如函數的傳入傳出參數，視函數的需要适當增加。
5.測試代碼
在程式設計的同時，需要注意添加适當的測試代碼，這樣可以減輕以後測試代碼時的工作量。
AVR c語言優秀程式設計風格
檔案結構
子產品化的程式應該是有一個很好的程式結構的。AVR C語言程式有兩種使用者檔案，.c程式檔案，.h頭檔案，程式中編寫過程中需要在.c檔案中包含.h頭檔案。初學者往往出現重複包含或者頭檔案包含錯誤的問題，我當時也時常為這種錯誤而發愁。下面我以我寫的電機驅動例程來給大家說明一下，優秀的程式設計檔案結構。
這個工程中有8個檔案，一個說明檔案，如下圖：下載下傳程式例子 電機控制案例 。
我寫的成型的程式的檔案個數基本上都是偶數，因為每一個結構化的函數定義.c檔案都會對應一個.h檔案。main.c對應config.h。我們來看看各檔案的包含關系。下面我們看看這些檔案的包含關系與内容：［推薦的檔案包含順序與關系］
所有.c檔案都包含了config.h檔案。如： #include “config.h”
在config.h 中有如下代碼：
#include “delay.h”
#include “device_init.h”
#include “motor.h”
這樣做就不容易出現錯誤的包含關系，為了預防萬一，我們還引入了宏定義與預編譯。如下：
#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
第一次包含本檔案的時候正确編譯，并且#define _UNIT_H__ 1，第二次包含本檔案#ifndef _UNIT_H__就不再成立，跳過檔案。
預編譯還有更多的用途，比如可以根據不同的值編譯不同的語句，如下：
//#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” 的差別 ：前者是包含系統目錄include下 的檔案，後者是包含程式目錄下的檔案。
變量名與函數名
變量以及函數命名應該按照盡量短，按需長，具有實際意義。可以通過下劃線或者大小寫結合的方法組合動詞和名詞組成變量函數名。下面對比好的命名方法與不好的命名方法：
1.好的： Delay100us();
不好的： Yanshi();
2.好的： init_devices();
不好的： Chengxuchushihua();
3.好的： int temp;
不好的： int dd;
外部調用
1.首先在子產品化程式的.h檔案中定義extern
//端口初始化
extern void port_init(void);
//T2初始化
void timer2_init(void);
//各種參數初始化
extern void init_devices(void);
2.子產品化程式的.c檔案中定義函數，不要在子產品化的程式中調用程式，及不要出現向timer2_init();這樣函數的使用，因為你以後不知道你到底什麼地方調用了函數，導緻程式調試難度增加。可以在定義函數的過程中調用其他函數作為函數體。
// PWM頻率 = 系統時鐘頻率/(分頻系數*2*計數器上限值))
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.在少數幾個檔案中調用函數，在main.c中調用大部分函數，在interupts.c中根據不同的中斷調用服務函數。
void main(void)
{
//初始工作
init_devices();
while(1)
{
for_ward(0); //預設速度運轉 正
Delay1s(5); //延時5s
motor_stop(); //停止
Delay1s(5); //延時5s
back_ward(0); //預設速度運轉 反
Delay1s(5); //延時5s
speed_add(20); //加速
Delay1s(5); //延時5s
speed_subtract(20); //減速
Delay1s(5); //延時5s
}
}
宏定義
宏定義主要用于兩個地方：
1.一是用得非常多的指令或語句，利用宏将其簡化。
#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;
typedef signed char int8;
typedef unsigned int uint16;
typedef signed int int16;
typedef unsigned long uint32;
typedef signed long int32;
2.二是利用宏定義友善的進行硬體接口操作，再程式需要修改時，隻需要修改宏定義即可，而不需要滿篇去找指令行，進行修改。
//PD4，PD5 電機方向控制 如果更改管腳控制電機方向，更改PORTD |= 0x10即可。
#define moto_en1 PORTD |= 0x10
#define moto_en2 PORTD |= 0x20
#define moto_uen1 PORTD &=~ 0x10
#define moto_uen2 PORTD &=~ 0x20
//啟動TC2定時比較和溢出
#define TC2_EN TIMSK |= (《《1OCIE2)|(1《《TOIE2)
//禁止TC2再定時比較和溢出
#define TC2_DIS TIMSK &=~ (1《《OCIE2)|(1《《TOIE2)
關于注釋
為了增加程式的可讀性，友善合作者讀動程式，或者程式作者在一段時間之後還能看懂程式，我們需要在程式中寫 注釋。
在比較特殊的函數使用或者指令調用的地方加單行注釋。使用方法為：
Tbuf_putchar(c，RTbuf); // 将資料加入到發送緩沖區并開中斷
extern void Delay1s(uint16 n); // n 《= 6 ，when n==7， it is 1.
在子產品化的函數中使用詳細段落注釋：
在檔案頭上加檔案名，檔案用途，作者，日期等資訊。
要清楚，注釋是為了友善閱讀，增強程式的可度性，不要本末倒置，不要給很簡單大家都能看明白的程式加注釋，不要讓注釋淹沒了你的程式結構。對于函數，變量等盡量使用檔案名自注釋的方法，及通過檔案名就可以知道意思。
打開APP閱讀更多精彩内容
點選閱讀全文