可直接用于項(xiàng)目開(kāi)發(fā)的TWI/IIC頭文件(GCC)

ID:80436 · 發(fā)表于 2015-5-21 23:48

/*--------------------------文件說(shuō)明----------------------------------
文件用途：TWI/I2C驅(qū)動(dòng),查詢(xún)方式，主機(jī)模式
原創(chuàng)者：SEE
修改者：linxiyiran
最后修改時(shí)間：2009.07.08
使用說(shuō)明：調(diào)用最后6個(gè)API應(yīng)用程序接口函數(shù)進(jìn)行I2C讀寫(xiě)
調(diào)試說(shuō)明：ATmega16L+WinAVR-20090313+AVR studio 4 環(huán)境下調(diào)試通過(guò)。
注意事項(xiàng) ：根據(jù)原創(chuàng)者意愿，如用于商業(yè)用途請(qǐng)注明文件來(lái)源。
--------------------------------------------------------------------*/
#ifndef I2C_H
#define I2C_H
//主機(jī)模式啟動(dòng)狀態(tài)碼
#define I2C_START 0x08 //啟動(dòng)總線(xiàn)
#define I2C_RESTART 0x10 //重新啟動(dòng)總線(xiàn)
//主機(jī)發(fā)送模式狀態(tài)碼
#define I2C_MT_SLA_ACK 0x18 //SLA+W寫(xiě)地址已發(fā)送，收到應(yīng)答位
#define I2C_MT_SLA_NACK 0x20 //SLA+W寫(xiě)地址已發(fā)送，收到非應(yīng)答位
#define I2C_MT_DATA_ACK 0x28 //寫(xiě)入數(shù)據(jù)已發(fā)送，收到應(yīng)答位
#define I2C_MT_DATA_NACK 0x30 //寫(xiě)入數(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 //沒(méi)有相關(guān)的狀態(tài)信息，TWINT='0'
#define I2C_BUS_ERROR 0x00 //由于非法的START或STOP引起的總線(xiàn)錯(cuò)誤
//定義SLA中讀寫(xiě)控制位極性
#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 //錯(cuò)誤
#define I2C_CRR 1 //正確
//定義TWINT位置位查詢(xún)等待時(shí)間
#define WAITCOUNT 60 //3.6864M時(shí)，此處必須大于60，驗(yàn)證得知小于60，程序均不能正常工作
/*--------------------------------------------------------------------
函數(shù)名稱(chēng)：I2C_Init
函數(shù)功能：TWI初始化
注意事項(xiàng)：（須根據(jù)具體情況設(shè)置）
提示說(shuō)明：
輸入：
返回：
--------------------------------------------------------------------*/
void I2C_Init(void)
{
TWBR=0x0f; //波特率設(shè)置，必須大于 10
TWSR=0; //狀態(tài)寄存器初始化
//TWAR= //從機(jī)地址和通用呼叫設(shè)置,多CPU時(shí)使用
}
/*--------------------------------------------------------------------
函數(shù)名稱(chēng)：I2C_WaitINT
函數(shù)功能：等待TWINT位置位
注意事項(xiàng)：需定義 WAITCOUNT
提示說(shuō)明：
輸入：
返回：運(yùn)行狀況 I2C_ERR ：錯(cuò)誤 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ù)名稱(chēng)：I2C_SendByte
函數(shù)功能：發(fā)送一字節(jié)數(shù)據(jù)
注意事項(xiàng)：
提示說(shuō)明：
輸入：待發(fā)送數(shù)據(jù)
返回：運(yùn)行狀況 I2C_ERR ：錯(cuò)誤 I2C_CRR :正確
--------------------------------------------------------------------*/
void I2C_SendByte(unsigned char x)
{
TWDR=(x);
TWCR=(1<<TWINT)|(1<<TWEN);
}
/*--------------------------------------------------------------------
函數(shù)名稱(chēng)：I2C Start
函數(shù)功能：發(fā)出起始信號(hào)
注意事項(xiàng)：
提示說(shuō)明：
輸入：
返回：運(yùn)行狀況 I2C_ERR ：錯(cuò)誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_Start(void)
{
I2CStart(); //發(fā)出起始信號(hào)
if(!I2C_WaitINT()) return I2C_ERR; //等待啟動(dòng)完成
if( I2C_STATUS!=I2C_START ) //檢查是否啟動(dòng)成功
return I2C_ERR; //啟動(dòng)失敗，返回0
return I2C_CRR; //啟動(dòng)成功，返回1
}
/*--------------------------------------------------------------------
函數(shù)名稱(chēng)：I2C ReStart
函數(shù)功能：發(fā)出重復(fù)起始信號(hào)
注意事項(xiàng)：
提示說(shuō)明：
輸入：
返回：運(yùn)行狀況 I2C_ERR ：錯(cuò)誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_Restart(void)
{
I2CStart();
if(!I2C_WaitINT()) return I2C_ERR;
if( I2C_STATUS!=I2C_RESTART ) //檢查是否重復(fù)啟動(dòng)成功
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數(shù)名稱(chēng)：I2C_SendWrDAdr
函數(shù)功能：發(fā)送 7位器件寫(xiě)地址: XXXX XXX0
注意事項(xiàng)：
提示說(shuō)明：
輸入：寫(xiě)地址
返回：運(yùn)行狀況 I2C_ERR ：錯(cuò)誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_SendWrDAdr(unsigned char wrDAdr)
{
I2C_SendByte(wrDAdr); //設(shè)置器件寫(xiě)地址
if(!I2C_WaitINT()) return I2C_ERR;
if( I2C_STATUS!=I2C_MT_SLA_ACK )
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數(shù)名稱(chēng)：I2C_SendWrDAdr_
函數(shù)功能：發(fā)送 10位器件寫(xiě)地址: 1111 0XX0, XXXX XXXX
注意事項(xiàng)：
提示說(shuō)明：兼容發(fā)送 7位器件寫(xiě)地址: XXXX XXX0
輸入：
返回：運(yùn)行狀況 I2C_ERR ：錯(cuò)誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_SendWrDAdr_(unsigned int wrDAdr)
{
if( (wrDAdr0xF000) == 0xF000 ) //判斷是否為 10位器件地址
if( I2C_SendWrDAdr((unsigned char )wrDAdr>>8)==I2C_ERR ) //設(shè)置（高位）器件寫(xiě)地址
return I2C_ERR;
if( I2C_SendWrDAdr( (unsigned char)wrDAdr )==I2C_ERR ) //設(shè)置（低位）器件寫(xiě)地址
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數(shù)名稱(chēng)：I2C_SendRdDAdr
函數(shù)功能：發(fā)送7位器件讀地址: XXXX XXX1
注意事項(xiàng)：
提示說(shuō)明：
輸入：讀地址
返回：運(yùn)行狀況 I2C_ERR ：錯(cuò)誤 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ù)名稱(chēng)：I2C_SendRdDAdr_
函數(shù)功能：發(fā)送 10位器件讀地址: 1111 0XX0, XXXX XXXX
注意事項(xiàng)：
提示說(shuō)明：兼容發(fā)送 7位器件讀地址: XXXX XXX1
輸入：
返回：運(yùn)行狀況 I2C_ERR ：錯(cuò)誤 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ù)名稱(chēng)：I2C_SendDat
函數(shù)功能：I2C發(fā)送數(shù)據(jù)
注意事項(xiàng)：
提示說(shuō)明：
輸入：待發(fā)送的字節(jié)數(shù)據(jù)
返回：運(yùn)行狀況 I2C_ERR ：錯(cuò)誤 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ù)名稱(chēng)：I2C_RcvNAckDat
函數(shù)功能：I2C接收數(shù)據(jù)且不產(chǎn)生應(yīng)答
注意事項(xiàng)：
提示說(shuō)明：
輸入：接收數(shù)據(jù)存儲(chǔ)空間指針
返回：運(yùn)行狀況 I2C_ERR ：錯(cuò)誤 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ù)名稱(chēng)：I2C_RcvAckDat
函數(shù)功能：I2C接收數(shù)據(jù)且產(chǎn)生應(yīng)答
注意事項(xiàng)：
提示說(shuō)明：
輸入：接收數(shù)據(jù)存儲(chǔ)空間指針
返回：運(yùn)行狀況 I2C_ERR ：錯(cuò)誤 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ù)名稱(chēng)：I2C_Write(unsigned int wrDAdr,unsigned char wordAdr,unsigned char dat)
函數(shù)功能：I2C寫(xiě)器件，寫(xiě)一個(gè)字節(jié)
注意事項(xiàng)：
提示說(shuō)明：
輸入：wrDAdr : write device-address 寫(xiě)器件地址
wordAdr: word address 從地址
dat: data 數(shù)據(jù)
返回：運(yùn)行狀況 I2C_ERR ：錯(cuò)誤 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 )//保證寫(xiě)控制位正確
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ù)名稱(chēng)：I2C_Write_
函數(shù)功能：I2C寫(xiě)器件，寫(xiě)N個(gè)數(shù)據(jù)
注意事項(xiàng)：
提示說(shuō)明：
輸入：wrDAdr : write device-address 寫(xiě)器件地址
wordAdr: word address 從地址
*pWrDat: p->write data 寫(xiě)入數(shù)據(jù)的指針
num : number 寫(xiě)入數(shù)據(jù)個(gè)數(shù)
返回：運(yùn)行狀況 I2C_ERR ：錯(cuò)誤 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 )//保證寫(xiě)控制位正確
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ù)名稱(chēng)：I2C_Read
函數(shù)功能：I2C讀器件，讀一個(gè)數(shù)據(jù)
注意事項(xiàng)：
提示說(shuō)明：
輸入：rdDAdr : read device-address 讀器件地址
wordAdr: word address 從地址
*pRdDat: p->read data 讀取數(shù)據(jù)指針
返回：運(yùn)行狀況 I2C_ERR ：錯(cuò)誤 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 )//保證寫(xiě)控制位正確
return I2C_ERR;
if( I2C_SendDat(wordAdr)==I2C_ERR )//從地址當(dāng)作一般數(shù)據(jù)發(fā)送。
return I2C_ERR;
if( I2C_Restart()==I2C_ERR )//重啟動(dòng)
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ù)名稱(chēng)：I2C_Read_
函數(shù)功能：I2C讀器件，讀N個(gè)數(shù)據(jù)
注意事項(xiàng)：
提示說(shuō)明：
輸入：rdDAdr : read device-address 讀器件地址
wordAdr: word address 字地址
*pRdDat: p->read data 讀取數(shù)據(jù)指針
num : number 讀取數(shù)據(jù)個(gè)數(shù)
返回：運(yùn)行狀況 I2C_ERR ：錯(cuò)誤 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 )//保證寫(xiě)控制位正確
return I2C_ERR;
if( I2C_SendDat(wordAdr)==I2C_ERR )//從地址當(dāng)作一般數(shù)據(jù)發(fā)送。
return I2C_ERR;
if( I2C_Restart()==I2C_ERR )//重啟動(dòng)
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ù)名稱(chēng)：I2C_Write_direct
函數(shù)功能：I2C寫(xiě)無(wú)從地址器件，寫(xiě)一個(gè)字節(jié)
注意事項(xiàng)：
提示說(shuō)明：
輸入：wrDAdr : write device-address 寫(xiě)器件地址
dat: data 數(shù)據(jù)
返回：運(yùn)行狀況 I2C_ERR ：錯(cuò)誤 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 )//保證寫(xiě)控制位正確
return I2C_ERR;
if( I2C_SendDat(dat)==I2C_ERR )//直接寫(xiě)數(shù)據(jù)
return I2C_ERR;
I2CStop();
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數(shù)名稱(chēng)：I2C_Read_direct
函數(shù)功能：I2C讀無(wú)從地址器件，讀一個(gè)數(shù)據(jù)
注意事項(xiàng)：
提示說(shuō)明：
輸入：rdDAdr : read device-address 讀器件地址
*pRdDat: p->read data 讀取數(shù)據(jù)指針
返回：運(yùn)行狀況 I2C_ERR ：錯(cuò)誤 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ù)制代碼

帳號(hào)		自動(dòng)登錄	找回密碼
密碼			立即注冊(cè)