摘要:作為一個初學者如何具有良好的程序設計風格呢?下面小編將以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.注釋的書寫
這里注釋分為函數頭注釋,程序中代碼注釋,
函數頭注釋使用如下形式
/*
*Name:
*Description:
*Created:
*Author:
*/
這四項必選,其他的如函數的傳入傳出參數,視函數的需要適當增加。
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();這樣函數的使用,因為你以后不知道你到底什么地方調用了函數,導致程序調試難度增加。可以在定義函數的過程中調用其他函數作為函數體。
/**************************采用timer2 產生波形***********************/
// 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; /* 定義可移植的無符號8位整數關鍵字 */
typedef signed char int8; /* 定義可移植的有符號8位整數關鍵字 */
typedef unsigned int uint16; /* 定義可移植的無符號16位整數關鍵字 */
typedef signed int int16; /* 定義可移植的有符號16位整數關鍵字 */
typedef unsigned long uint32; /* 定義可移植的無符號32位整數關鍵字 */
typedef signed long int32; /* 定義可移植的有符號32位整數關鍵字 */
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.
在模塊化的函數中使用詳細段落注釋:
/***********************
** 函數名稱: Com_putchar
** 功能描述: 從串行口輸出一個字符c
** 輸 入: c:輸出字符
** 輸出 : 0:失敗 1:成功
** 全局變量: 無
** 調用模塊:
** 說明:
** 注意:
********************/
在文件頭上加文件名,文件用途,作者,日期等信息。
/*********************************************************************************************************
** serial driver
** (c) Copyright 2005-2006, limaokui
** All Rights Reserved
**
** V1.1.0
**
**
**--------------文件信息--------------------------------------------------------------------------------
**文 件 名:sio.c
**創 建 人: 李茂奎
**最后修改日期: 2005年7月13日
**描 述: serial driver
**
**--------------歷史版本信息----------------------------------------------------------------------------
** 創建人: 李茂奎
** 版 本: V1.00
** 日 期: 2005年7月13日
** 描 述: 原始版本
**
*********************************************************************************************************/
要清楚,注釋是為了方便閱讀,增強程序的可度性,不要本末倒置,不要給很簡單大家都能看明白的程序加注釋,不要讓注釋淹沒了你的程序結構。對于函數,變量等盡量使用文件名自注釋的方法,及通過文件名就可以知道意思。
評論
查看更多