標(biāo)題:
可直接用于項(xiàng)目開發(fā)的TWI/IIC頭文件(GCC)
[打印本頁]
作者:
liuqq
時(shí)間:
2015-5-21 23:48
標(biāo)題:
可直接用于項(xiàng)目開發(fā)的TWI/IIC頭文件(GCC)
/*--------------------------文件說明----------------------------------
文件用途 :TWI/I2C驅(qū)動,查詢方式,主機(jī)模式
原創(chuàng)者 :SEE
修改者 :linxiyiran
最后修改時(shí)間 :2009.07.08
使用說明 :調(diào)用最后6個API應(yīng)用程序接口函數(shù)進(jìn)行I2C讀寫
調(diào)試說明 :ATmega16L+WinAVR-20090313+AVR studio 4 環(huán)境下調(diào)試通過。
注意事項(xiàng) :根據(jù)原創(chuàng)者意愿,如用于商業(yè)用途請注明文件來源。
--------------------------------------------------------------------*/
#ifndef I2C_H
#define I2C_H
//主機(jī)模式啟動狀態(tài)碼
#define I2C_START 0x08 //啟動總線
#define I2C_RESTART 0x10 //重新啟動總線
//主機(jī)發(fā)送模式狀態(tài)碼
#define I2C_MT_SLA_ACK 0x18 //SLA+W寫地址已發(fā)送,收到應(yīng)答位
#define I2C_MT_SLA_NACK 0x20 //SLA+W寫地址已發(fā)送,收到非應(yīng)答位
#define I2C_MT_DATA_ACK 0x28 //寫入數(shù)據(jù)已發(fā)送,收到應(yīng)答位
#define I2C_MT_DATA_NACK 0x30 //寫入數(shù)據(jù)已發(fā)送,收到應(yīng)答位
#define I2C_MT_ARB_LOST 0x38 //SLA+W或數(shù)據(jù)仲裁失敗
//主機(jī)接收模式狀態(tài)碼
#define I2C_MR_ARB_LOST 0x38 //SLA+R或NOT ACK的仲裁失敗
#define I2C_MR_SLA_ACK 0x40 //SLA+R已發(fā)送,收到應(yīng)答位
#define I2C_MR_SLA_NACK 0x48 //SLA+R已發(fā)送,收到非應(yīng)答位
#define I2C_MR_DATA_ACK 0x50 //接收到數(shù)據(jù),應(yīng)答位已返回
#define I2C_MR_DATA_NACK 0x58 //接收到數(shù)據(jù),非應(yīng)答位已返回
//從機(jī)接收模式狀態(tài)碼
#define I2C_SR_SLA_ACK 0x60 //自己的SLA+W已經(jīng)被接收ACK已返回
#define I2C_SR_ARB_LOST_SLA_ACK 0x68 //SLA+R/W作為主機(jī)的仲裁失敗,自己的SLA+W已經(jīng)被接收ACK已返回
#define I2C_SR_GCALL_ACK 0x70 //接收到廣播地址ACK已返回
#define I2C_SR_ARB_LOST_GCALL_ACK 0x78 //SLA+R/W作為主機(jī)的仲裁失敗,接收到廣播地址ACK已返回
#define I2C_SR_DATA_ACK 0x80 //以前以自己的SLA+W被尋址,數(shù)據(jù)已經(jīng)被接收ACK已返回
#define I2C_SR_DATA_NACK 0x88 //以前以自己的SLA+W被尋址,數(shù)據(jù)已經(jīng)被接收NOT ACK已返回
#define I2C_SR_GCALL_DATA_ACK 0x90 //以前以廣播方式被尋址,數(shù)據(jù)已經(jīng)被接收ACK已返回
#define I2C_SR_GCALL_DATA_NACK 0x98 //以前以廣播方式被尋址,數(shù)據(jù)已經(jīng)被接收NOT ACK已返回
#define I2C_SR_STOP 0xA0 //在以從機(jī)工作時(shí)接收到STOP或重復(fù)START
//從機(jī)發(fā)送模式狀態(tài)碼
#define I2C_ST_SLA_ACK 0xA8 //自己的SLA+R已經(jīng)被接收ACK已返回
#define I2C_ST_ARB_LOST_SLA_ACK 0xB0 //SLA+R/W作為主機(jī)的仲裁失敗,自己的SLA+R已經(jīng)被接收ACK已返回
#define I2C_ST_DATA_ACK 0xB8 //TWDR里數(shù)據(jù)已經(jīng)被發(fā)送接收到ACK
#define I2C_ST_DATA_NACK 0xC0 //TWDR里數(shù)據(jù)已經(jīng)被發(fā)送接收到NOT ACK
#define I2C_ST_LAST_DATA 0xC8 //TWDR的一字節(jié)數(shù)據(jù)已經(jīng)發(fā)送(TWAE='0'),接收到ACK
//其他狀態(tài)碼
#define I2C_NO_INFO 0xF8 //沒有相關(guān)的狀態(tài)信息,TWINT='0'
#define I2C_BUS_ERROR 0x00 //由于非法的START或STOP引起的總線錯誤
//定義SLA中讀寫控制位極性
#define I2C_READ 1
#define I2C_WRITE 0
#define I2CStart() (TWCR=(1<<TWINT)|(1<<TWSTA)|(1<<TWEN))
#define I2CStop() (TWCR=(1<<TWINT)|(1<<TWSTO)|(1<<TWEN))
#define I2C_STATUS (TWSR 0xf8)
#define I2CSendAck() (TWCR|=(1<<TWEA))
#define I2CSendNoAck() (TWCR=~(1<<TWEA))
#define I2CRcvNckByte() (TWCR=(1<<TWINT)|(1<<TWEN))
#define I2CRcvAckByte() (TWCR=(1<<TWINT)|(1<<TWEN)|(1<<TWEA))
//定義運(yùn)行狀態(tài)返回值極性
#define I2C_ERR 0 //錯誤
#define I2C_CRR 1 //正確
//定義TWINT位置位查詢等待時(shí)間
#define WAITCOUNT 60 //3.6864M時(shí),此處必須大于60,驗(yàn)證得知小于60,程序均不能正常工作
/*--------------------------------------------------------------------
函數(shù)名稱:I2C_Init
函數(shù)功能:TWI初始化
注意事項(xiàng):(須根據(jù)具體情況設(shè)置)
提示說明:
輸 入:
返 回:
--------------------------------------------------------------------*/
void I2C_Init(void)
{
TWBR=0x0f; //波特率設(shè)置,必須大于 10
TWSR=0; //狀態(tài)寄存器初始化
//TWAR= //從機(jī)地址和通用呼叫設(shè)置,多CPU時(shí)使用
}
/*--------------------------------------------------------------------
函數(shù)名稱:I2C_WaitINT
函數(shù)功能:等待TWINT位置位
注意事項(xiàng):需定義 WAITCOUNT
提示說明:
輸 入:
返 回:運(yùn)行狀況 I2C_ERR :錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_WaitINT(void)
{
unsigned int i=WAITCOUNT;
while(!(TWCR(1<<TWINT))) //等待TWINT置1
{if((--i)==0) return I2C_ERR;}
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數(shù)名稱:I2C_SendByte
函數(shù)功能:發(fā)送一字節(jié)數(shù)據(jù)
注意事項(xiàng):
提示說明:
輸 入:待發(fā)送數(shù)據(jù)
返 回:運(yùn)行狀況 I2C_ERR :錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
void I2C_SendByte(unsigned char x)
{
TWDR=(x);
TWCR=(1<<TWINT)|(1<<TWEN);
}
/*--------------------------------------------------------------------
函數(shù)名稱:I2C Start
函數(shù)功能:發(fā)出起始信號
注意事項(xiàng):
提示說明:
輸 入:
返 回:運(yùn)行狀況 I2C_ERR :錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_Start(void)
{
I2CStart(); //發(fā)出起始信號
if(!I2C_WaitINT()) return I2C_ERR; //等待啟動完成
if( I2C_STATUS!=I2C_START ) //檢查是否啟動成功
return I2C_ERR; //啟動失敗,返回0
return I2C_CRR; //啟動成功,返回1
}
/*--------------------------------------------------------------------
函數(shù)名稱:I2C ReStart
函數(shù)功能:發(fā)出重復(fù)起始信號
注意事項(xiàng):
提示說明:
輸 入:
返 回:運(yùn)行狀況 I2C_ERR :錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_Restart(void)
{
I2CStart();
if(!I2C_WaitINT()) return I2C_ERR;
if( I2C_STATUS!=I2C_RESTART ) //檢查是否重復(fù)啟動成功
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數(shù)名稱:I2C_SendWrDAdr
函數(shù)功能:發(fā)送 7位 器件寫地址: XXXX XXX0
注意事項(xiàng):
提示說明:
輸 入:寫地址
返 回:運(yùn)行狀況 I2C_ERR :錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_SendWrDAdr(unsigned char wrDAdr)
{
I2C_SendByte(wrDAdr); //設(shè)置器件寫地址
if(!I2C_WaitINT()) return I2C_ERR;
if( I2C_STATUS!=I2C_MT_SLA_ACK )
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數(shù)名稱:I2C_SendWrDAdr_
函數(shù)功能:發(fā)送 10位 器件寫地址: 1111 0XX0, XXXX XXXX
注意事項(xiàng):
提示說明:兼容 發(fā)送 7位 器件寫地址: XXXX XXX0
輸 入:
返 回:運(yùn)行狀況 I2C_ERR :錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_SendWrDAdr_(unsigned int wrDAdr)
{
if( (wrDAdr0xF000) == 0xF000 ) //判斷是否為 10位 器件地址
if( I2C_SendWrDAdr((unsigned char )wrDAdr>>8)==I2C_ERR ) //設(shè)置(高位)器件寫地址
return I2C_ERR;
if( I2C_SendWrDAdr( (unsigned char)wrDAdr )==I2C_ERR ) //設(shè)置 (低位)器件寫地址
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數(shù)名稱:I2C_SendRdDAdr
函數(shù)功能:發(fā)送7位器件讀地址: XXXX XXX1
注意事項(xiàng):
提示說明:
輸 入:讀地址
返 回:運(yùn)行狀況 I2C_ERR :錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_SendRdDAdr(unsigned char rdDAdr)
{
I2C_SendByte(rdDAdr); //設(shè)置器件讀地址
if(!I2C_WaitINT()) return I2C_ERR;
if( I2C_STATUS!=I2C_MR_SLA_ACK )
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數(shù)名稱:I2C_SendRdDAdr_
函數(shù)功能:發(fā)送 10位 器件讀地址: 1111 0XX0, XXXX XXXX
注意事項(xiàng):
提示說明:兼容 發(fā)送 7位 器件讀地址: XXXX XXX1
輸 入:
返 回:運(yùn)行狀況 I2C_ERR :錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_SendRdDAdr_(unsigned char rdDAdr)
{
if( (rdDAdr0xF000) == 0xF000 ) //判斷是否為 10位 器件地址
if( I2C_SendWrDAdr( (unsigned char)rdDAdr>>8 )==I2C_ERR ) //設(shè)置 (高位)器件讀地址
return I2C_ERR;
if( I2C_SendWrDAdr( (unsigned char)rdDAdr )==I2C_ERR ) //設(shè)置 (低位)器件讀地址
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數(shù)名稱:I2C_SendDat
函數(shù)功能:I2C發(fā)送數(shù)據(jù)
注意事項(xiàng):
提示說明:
輸 入:待發(fā)送的字節(jié)數(shù)據(jù)
返 回:運(yùn)行狀況 I2C_ERR :錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_SendDat(unsigned char data)
{
I2C_SendByte(data);
if(!I2C_WaitINT()) return I2C_ERR;
if( I2C_STATUS!=I2C_MT_DATA_ACK )
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數(shù)名稱:I2C_RcvNAckDat
函數(shù)功能:I2C接收數(shù)據(jù)且不產(chǎn)生應(yīng)答
注意事項(xiàng):
提示說明:
輸 入:接收數(shù)據(jù)存儲空間指針
返 回:運(yùn)行狀況 I2C_ERR :錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_RcvNAckDat(unsigned char *pRdDat)
{
I2CRcvNckByte();
if(!I2C_WaitINT()) return I2C_ERR;
if( I2C_STATUS!=I2C_MR_DATA_NACK )
return I2C_ERR;
*pRdDat=TWDR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數(shù)名稱:I2C_RcvAckDat
函數(shù)功能:I2C接收數(shù)據(jù)且產(chǎn)生應(yīng)答
注意事項(xiàng):
提示說明:
輸 入:接收數(shù)據(jù)存儲空間指針
返 回:運(yùn)行狀況 I2C_ERR :錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_RcvAckDat(unsigned char *pRdDat)
{
I2CRcvAckByte();
if(!I2C_WaitINT()) return I2C_ERR;
if( I2C_STATUS!=I2C_MR_DATA_ACK )
return I2C_ERR;
*pRdDat=TWDR;
return I2C_CRR;
}
/*以下是API函數(shù)*/
//(Application Program Interface 應(yīng)用程序接口)
/*--------------------------------------------------------------------
函數(shù)名稱:I2C_Write(unsigned int wrDAdr,unsigned char wordAdr,unsigned char dat)
函數(shù)功能:I2C寫器件,寫一個字節(jié)
注意事項(xiàng):
提示說明:
輸 入:wrDAdr : write device-address 寫器件地址
wordAdr: word address 從地址
dat: data 數(shù)據(jù)
返 回:運(yùn)行狀況 I2C_ERR :錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_Write(unsigned int wrDAdr,unsigned char wordAdr,unsigned char dat)
{
if( I2C_Start()==I2C_ERR )
return I2C_ERR;
//wrDAdr =0xfffe;
if( I2C_SendWrDAdr_((wrDAdr0xfffe)|I2C_WRITE)==I2C_ERR )//保證寫控制位正確
return I2C_ERR;
if( I2C_SendDat(wordAdr)==I2C_ERR )//從地址當(dāng)作一般數(shù)據(jù)發(fā)送
return I2C_ERR;
if( I2C_SendDat(dat)==I2C_ERR )
return I2C_ERR;
I2CStop();
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數(shù)名稱:I2C_Write_
函數(shù)功能:I2C寫器件,寫N個數(shù)據(jù)
注意事項(xiàng):
提示說明:
輸 入:wrDAdr : write device-address 寫器件地址
wordAdr: word address 從地址
*pWrDat: p->write data 寫入數(shù)據(jù)的指針
num : number 寫入數(shù)據(jù)個數(shù)
返 回:運(yùn)行狀況 I2C_ERR :錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_Write_(unsigned int wrDAdr,unsigned char wordAdr,
unsigned char *pWrDat,unsigned char num)
{
unsigned char i;
if( I2C_Start()==I2C_ERR )
return I2C_ERR;
//wrDAdr =0xfffe;
if( I2C_SendWrDAdr_((wrDAdr0xfffe)|I2C_WRITE)==I2C_ERR )//保證寫控制位正確
return I2C_ERR;
if( I2C_SendDat(wordAdr)==I2C_ERR )//從地址當(dāng)作一般數(shù)據(jù)發(fā)送
return I2C_ERR;
for(i=0;i<num;i++)
if( I2C_SendDat(*(pWrDat++))==I2C_ERR )
return I2C_ERR;
I2CStop();
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數(shù)名稱:I2C_Read
函數(shù)功能:I2C讀器件,讀一個數(shù)據(jù)
注意事項(xiàng):
提示說明:
輸 入:rdDAdr : read device-address 讀器件地址
wordAdr: word address 從地址
*pRdDat: p->read data 讀取數(shù)據(jù)指針
返 回:運(yùn)行狀況 I2C_ERR :錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_Read(unsigned int rdDAdr,unsigned char wordAdr,unsigned char *pRdDat)
{
if( I2C_Start()==I2C_ERR )
return I2C_ERR;
//rdDAdr =0xfffe;
if( I2C_SendWrDAdr_((rdDAdr0xfffe)|I2C_WRITE)==I2C_ERR )//保證寫控制位正確
return I2C_ERR;
if( I2C_SendDat(wordAdr)==I2C_ERR )//從地址當(dāng)作一般數(shù)據(jù)發(fā)送。
return I2C_ERR;
if( I2C_Restart()==I2C_ERR )//重啟動
return I2C_ERR;
//rdDAdr =0xfffe;
if( I2C_SendRdDAdr((rdDAdr0xfffe)|I2C_READ)==I2C_ERR )//保證讀控制位正確
return I2C_ERR;
if( I2C_RcvNAckDat(pRdDat)==I2C_ERR )//接收數(shù)據(jù)
return I2C_ERR;
I2CStop();
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數(shù)名稱:I2C_Read_
函數(shù)功能:I2C讀器件,讀N個數(shù)據(jù)
注意事項(xiàng):
提示說明:
輸 入:rdDAdr : read device-address 讀器件地址
wordAdr: word address 字地址
*pRdDat: p->read data 讀取數(shù)據(jù)指針
num : number 讀取數(shù)據(jù)個數(shù)
返 回:運(yùn)行狀況 I2C_ERR :錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_Read_(unsigned int rdDAdr,unsigned char wordAdr,
unsigned char *pRdDat,unsigned char num)
{
unsigned char i;
if( I2C_Start()==I2C_ERR )
return I2C_ERR;
//rdDAdr =0xfffe;
if( I2C_SendWrDAdr_((rdDAdr0xfffe)|I2C_WRITE)==I2C_ERR )//保證寫控制位正確
return I2C_ERR;
if( I2C_SendDat(wordAdr)==I2C_ERR )//從地址當(dāng)作一般數(shù)據(jù)發(fā)送。
return I2C_ERR;
if( I2C_Restart()==I2C_ERR )//重啟動
return I2C_ERR;
//rdDAdr =0xfffe;
if( I2C_SendRdDAdr((rdDAdr0xfffe)|I2C_READ)==I2C_ERR )//保證讀控制位正確
return I2C_ERR;
for(i=0;i<num-1;i++) //接收數(shù)據(jù)
if( I2C_RcvAckDat(pRdDat+i)==I2C_ERR )
return I2C_ERR;
if( I2C_RcvNAckDat(pRdDat+i)==I2C_ERR )
return I2C_ERR;
I2CStop();
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數(shù)名稱:I2C_Write_direct
函數(shù)功能:I2C寫無從地址器件,寫一個字節(jié)
注意事項(xiàng):
提示說明:
輸 入:wrDAdr : write device-address 寫器件地址
dat: data 數(shù)據(jù)
返 回:運(yùn)行狀況 I2C_ERR :錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_Write_direct(unsigned int wrDAdr,unsigned char dat)
{
if( I2C_Start()==I2C_ERR )
return I2C_ERR;
//wrDAdr =0xfffe;
if( I2C_SendWrDAdr_((wrDAdr0xfffe)|I2C_WRITE)==I2C_ERR )//保證寫控制位正確
return I2C_ERR;
if( I2C_SendDat(dat)==I2C_ERR )//直接寫數(shù)據(jù)
return I2C_ERR;
I2CStop();
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數(shù)名稱:I2C_Read_direct
函數(shù)功能:I2C讀無從地址器件,讀一個數(shù)據(jù)
注意事項(xiàng):
提示說明:
輸 入:rdDAdr : read device-address 讀器件地址
*pRdDat: p->read data 讀取數(shù)據(jù)指針
返 回:運(yùn)行狀況 I2C_ERR :錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_Read_direct(unsigned int rdDAdr,unsigned char wordAdr,unsigned char *pRdDat)
{
if( I2C_Start()==I2C_ERR )
return I2C_ERR;
//rdDAdr =0xfffe;
if( I2C_SendWrDAdr_((rdDAdr0xfffe)|I2C_WRITE)==I2C_ERR )
return I2C_ERR;
if( I2C_RcvNAckDat(pRdDat)==I2C_ERR )//直接讀數(shù)據(jù)
return I2C_ERR;
I2CStop();
return I2C_CRR;
}
#endif
復(fù)制代碼
歡迎光臨 (http://www.torrancerestoration.com/bbs/)
Powered by Discuz! X3.1