?? i2c.h
字號:
/*--------------------------文件說明----------------------------------
文件用途 ：TWI/I2C驅動,查詢方式，主機模式
原創者 ：SEE
修改者 ：programshao
最后修改時間 ：2007-05-03
使用說明 ：調用最后6個API函數進行I2C讀寫
調試說明 ：ATmega16L+ICC+AVR studio 4 環境下調試通過。
注意事項 ：根據原創者意愿，如用于商業用途請注明文件來源。
--------------------------------------------------------------------*/
#ifndef I2C_H
#define I2C_H
/* define TWSR values (not bits) */
/* Master */
#define I2C_START 0x08
#define I2C_RESTART 0x10
/* Master Transmitter */
#define I2C_MT_SLA_ACK 0x18
#define I2C_MT_SLA_NACK 0x20
#define I2C_MT_DATA_ACK 0x28
#define I2C_MT_DATA_NACK 0x30
#define I2C_MT_ARB_LOST 0x38
/* Master Receiver */
#define I2C_MR_ARB_LOST 0x38
#define I2C_MR_SLA_ACK 0x40
#define I2C_MR_SLA_NACK 0x48
#define I2C_MR_DATA_ACK 0x50
#define I2C_MR_DATA_NACK 0x58
/* Slave Receiver */
#define I2C_SR_SLA_ACK 0x60
#define I2C_SR_ARB_LOST_SLA_ACK 0x68
#define I2C_SR_GCALL_ACK 0x70
#define I2C_SR_ARB_LOST_GCALL_ACK 0x78
#define I2C_SR_DATA_ACK 0x80
#define I2C_SR_DATA_NACK 0x88
#define I2C_SR_GCALL_DATA_ACK 0x90
#define I2C_SR_GCALL_DATA_NACK 0x98
#define I2C_SR_STOP 0xA0
/* Slave Transmitter */
#define I2C_ST_SLA_ACK 0xA8
#define I2C_ST_ARB_LOST_SLA_ACK 0xB0
#define I2C_ST_DATA_ACK 0xB8
#define I2C_ST_DATA_NACK 0xC0
#define I2C_ST_LAST_DATA 0xC8
/* Misc */
#define I2C_NO_INFO 0xF8
#define I2C_BUS_ERROR 0x00
/*定義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))
/*定義運行狀態返回值極性*/
#define I2C_ERR 0 //錯誤
#define I2C_CRR 1 //正確
/*定義TWINT位置位查詢等待時間*/
#define WAITCOUNT 50
/*--------------------------------------------------------------------
函數名稱：I2C_Init
函數功能：TWI初始化
注意事項：（須根據具體情況設置）
提示說明：
輸 入：
--------------------------------------------------------------------*/
void I2C_Init(void)
{
TWBR=0x0f;//波特率設置，必須大于 10
//TWAR= //從機地址和通用呼叫設置
}
/*--------------------------------------------------------------------
函數名稱：I2C_WaitINT
函數功能：等待TWINT位置位
注意事項：需定義 WAITCOUNT
提示說明：
輸 入：
返 回：運行狀況 I2C_ERR ：錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_WaitINT(void)
{
unsigned int i=WAITCOUNT;
while(!(TWCR&(1<<TWINT)))
{if((--i)==0) return I2C_ERR;}
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：I2C_SendByte
函數功能：發送一字節數據
注意事項：
提示說明：
輸 入：待發送數據
返 回：運行狀況 I2C_ERR ：錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
void I2C_SendByte(unsigned char x)
{
TWDR=(x);
TWCR=(1<<TWINT)|(1<<TWEN);
}
/*--------------------------------------------------------------------
函數名稱：I2C Start
函數功能：發出起始信號
注意事項：
提示說明：
輸 入：
返 回：運行狀況 I2C_ERR ：錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_Start()
{
I2CStart();
if(!I2C_WaitINT()) return I2C_ERR;
if( I2C_STATUS!=I2C_START )
return I2C_ERR;
}
/*--------------------------------------------------------------------
函數名稱：I2C ReStart
函數功能：發出重復起始信號
注意事項：
提示說明：
輸 入：
返 回：運行狀況 I2C_ERR ：錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_Restart()
{
I2CStart();
if(!I2C_WaitINT()) return I2C_ERR;
if( I2C_STATUS!=I2C_RESTART )
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：I2C_SendWrDAdr
函數功能：發送 7位 器件寫地址: XXXX XXX0
注意事項：
提示說明：
輸 入：寫地址
返 回：運行狀況 I2C_ERR ：錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_SendWrDAdr(unsigned char wrDAdr)
{
I2C_SendByte(wrDAdr); //設置器件寫地址
if(!I2C_WaitINT()) return I2C_ERR;
if( I2C_STATUS!=I2C_MT_SLA_ACK )
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：I2C_SendWrDAdr_
函數功能：發送 10位 器件寫地址: 1111 0XX0, XXXX XXXX
注意事項：
提示說明：兼容 發送 7位 器件寫地址: XXXX XXX0
輸 入：
返 回：運行狀況 I2C_ERR ：錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_SendWrDAdr_(unsigned int wrDAdr)
{
if( wrDAdr&0xF000 == 0xF000 ) //判斷是否為 10位 器件地址
if( I2C_SendWrDAdr((unsigned char )wrDAdr>>8)==I2C_ERR ) //設置（高位）器件寫地址
return I2C_ERR;
if( I2C_SendWrDAdr( (unsigned char)wrDAdr )==I2C_ERR ) //設置 （低位）器件寫地址
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：I2C_SendRdDAdr
函數功能：發送 7位 器件讀地址: XXXX XXX1
注意事項：
提示說明：
輸 入：讀地址
返 回：運行狀況 I2C_ERR ：錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_SendRdDAdr(unsigned char rdDAdr)
{
I2C_SendByte(rdDAdr); //設置 器件讀地址
if(!I2C_WaitINT()) return I2C_ERR;
if( I2C_STATUS!=I2C_MR_SLA_ACK )
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：I2C_SendRdDAdr_
函數功能：發送 10位 器件讀地址: 1111 0XX0, XXXX XXXX
注意事項：
提示說明：兼容 發送 7位 器件讀地址: XXXX XXX1
輸 入：
返 回：運行狀況 I2C_ERR ：錯誤 I2C_CRR :正確
--------------------------------------------------------------------*/
unsigned char I2C_SendRdDAdr_(unsigned char rdDAdr)
{
if( rdDAdr&0xF000 == 0xF000 ) //判斷是否為 10位 器件地址
if( I2C_SendWrDAdr( (unsigned char)rdDAdr>>8 )==I2C_ERR ) //設置 （高位）器件讀地址
return I2C_ERR;
if( I2C_SendWrDAdr( (unsigned char)rdDAdr )==I2C_ERR ) //設置 （低位）器件讀地址
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：I2C_SendDat
函數功能：I2C發送數據
注意事項：
提示說明：
輸 入：待發送的字節數據
返 回：運行狀況 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;
}
/*--------------------------------------------------------------------
函數名稱：I2C_RcvNAckDat
函數功能：I2C接收數據且不產生應答
注意事項：
提示說明：
輸 入：接收數據存儲空間指針
返 回：運行狀況 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;
}
/*--------------------------------------------------------------------
函數名稱：I2C_RcvAckDat
函數功能：I2C接收數據且產生應答
注意事項：
提示說明：
輸 入：接收數據存儲空間指針
返 回：運行狀況 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函數*/
/*--------------------------------------------------------------------
函數名稱：I2C_Write
函數功能：I2C寫器件，寫一個字節
注意事項：
提示說明：
輸 入：wrDAdr : write device-address 寫器件地址
wordAdr: word address 從地址
dat: data 數據
返 回：運行狀況 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_((wrDAdr&0xfffe)|I2C_WRITE)==I2C_ERR )//保證寫控制位正確
return I2C_ERR;
if( I2C_SendDat(wordAdr)==I2C_ERR )//從地址當作一般數據發送
return I2C_ERR;
if( I2C_SendDat(dat)==I2C_ERR )
return I2C_ERR;
I2CStop();
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：I2C_Write_
函數功能：I2C寫器件，寫N個數據
注意事項：
提示說明：
輸 入：wrDAdr : write device-address 寫器件地址
wordAdr: word address 從地址
*pWrDat: p->write data 寫入數據的指針
num : number 寫入數據個數
返 回：運行狀況 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_((wrDAdr&0xfffe)|I2C_WRITE)==I2C_ERR )//保證寫控制位正確
return I2C_ERR;
if( I2C_SendDat(wordAdr)==I2C_ERR )//從地址當作一般數據發送
return I2C_ERR;
for(i=0;i<num;i++)
if( I2C_SendDat(*(pWrDat++))==I2C_ERR )
return I2C_ERR;
I2CStop();
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：I2C_Read
函數功能：I2C讀器件，讀一個數據
注意事項：
提示說明：
輸 入：rdDAdr : read device-address 讀器件地址
wordAdr: word address 從地址
*pRdDat: p->read data 讀取數據指針
返 回：運行狀況 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_((rdDAdr&0xfffe)|I2C_WRITE)==I2C_ERR )//保證寫控制位正確
return I2C_ERR;
if( I2C_SendDat(wordAdr)==I2C_ERR )//從地址當作一般數據發送。
return I2C_ERR;
if( I2C_Restart()==I2C_ERR )//重啟動
return I2C_ERR;
//rdDAdr &=0xfffe;
if( I2C_SendRdDAdr((rdDAdr&0xfffe)|I2C_READ)==I2C_ERR )//保證讀控制位正確
return I2C_ERR;
if( I2C_RcvNAckDat(pRdDat)==I2C_ERR )//接收數據
return I2C_ERR;
I2CStop();
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：I2C_Read_
函數功能：I2C讀器件，讀N個數據
注意事項：
提示說明：
輸 入：rdDAdr : read device-address 讀器件地址
wordAdr: word address 字地址
*pRdDat: p->read data 讀取數據指針
num : number 讀取數據個數
返 回：運行狀況 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_((rdDAdr&0xfffe)|I2C_WRITE)==I2C_ERR )//保證寫控制位正確
return I2C_ERR;
if( I2C_SendDat(wordAdr)==I2C_ERR )//從地址當作一般數據發送。
return I2C_ERR;
if( I2C_Restart()==I2C_ERR )//重啟動
return I2C_ERR;
//rdDAdr &=0xfffe;
if( I2C_SendRdDAdr((rdDAdr&0xfffe)|I2C_READ)==I2C_ERR )//保證讀控制位正確
return I2C_ERR;
for(i=0;i<num-1;i++) //接收數據
if( I2C_RcvAckDat(pRdDat+i)==I2C_ERR )
return I2C_ERR;
if( I2C_RcvNAckDat(pRdDat+i)==I2C_ERR )
return I2C_ERR;
I2CStop();
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：I2C_Write_direct
函數功能：I2C寫無從地址器件，寫一個字節
注意事項：
提示說明：
輸 入：wrDAdr : write device-address 寫器件地址
dat: data 數據
返 回：運行狀況 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_((wrDAdr&0xfffe)|I2C_WRITE)==I2C_ERR )//保證寫控制位正確
return I2C_ERR;
if( I2C_SendDat(dat)==I2C_ERR )//直接寫數據
return I2C_ERR;
I2CStop();
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：I2C_Read_direct
函數功能：I2C讀無從地址器件，讀一個數據
注意事項：
提示說明：
輸 入：rdDAdr : read device-address 讀器件地址
*pRdDat: p->read data 讀取數據指針
返 回：運行狀況 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_((rdDAdr&0xfffe)|I2C_WRITE)==I2C_ERR )
return I2C_ERR;
if( I2C_RcvNAckDat(pRdDat)==I2C_ERR )//直接讀數據
return I2C_ERR;
I2CStop();
return I2C_CRR;
}
#endif
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -