?? i2c.h
字號:
/*********************************************************************
微 雪 電 子 WaveShare http://www.waveShare.net
目 的: 建立I2C操作庫
目標系統: 基于AVR單片機
應用軟件: ICCAVR
版 本: Version 1.0
圓版時間: 2005-06-25
開發人員: SEE
說 明: 若用于商業用途，請保留此段文字或注明代碼來源
深 圳 市 微 雪 電 子 有 限 公 司 保 留 所 有 的 版 權
*********************************************************************/
/*01010101010101010101010101010101010101010101010101010101010101010101
----------------------------------------------------------------------
版本更新記錄：
----------------------------------------------------------------------
入口參數說明：
----------------------------------------------------------------------
待定參數說明：
----------------------------------------------------------------------
對外變量說明：
----------------------------------------------------------------------
對外函數說明：
----------------------------------------------------------------------
10101010101010101010101010101010101010101010101010101010101010101010*/
#ifndef I2C_H
#define I2C_H
/* 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 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
/* 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
/* Misc */
#define I2C_NO_INFO 0xF8
#define I2C_BUS_ERROR 0x00
/*
* The lower 3 bits of TWSR are reserved on the ATmega163.
* The 2 LSB carry the prescaler bits on the newer ATmegas.
*/
#define I2C_STATUS_MASK (_BV(TWS7)|_BV(TWS6)|_BV(TWS5)|_BV(TWS4)|_BV(TWS3))
#define I2C_STATUS (TWSR & I2C_STATUS_MASK)
/*
* R/~W bit in SLA+R/W address field.
*/
#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 I2CWaitAck() {while(!(TWCR&(1<<TWINT)));}
#define I2CChkAck() (TWSR&0xf8) //check ack
#define I2CSendAck() (TWCR|=(1<<TWEA))
#define I2CSendNoAck() (TWCR&=~(1<<TWEA))
#define I2CSendByte(x) {TWDR=(x);TWCR=(1<<TWINT)|(1<<TWEN);}
#define I2CRcvNckByte() (TWCR=(1<<TWINT)|(1<<TWEN))
#define I2CRcvAckByte() (TWCR=(1<<TWINT)|(1<<TWEN)|(1<<TWEA))
/* For Program */
#define I2C_Stop() I2CStop()
#define I2C_SendAck() I2CSendAck()
#define I2C_SendNoAck() I2CSendNoAck()
#define I2C_WaitAck() I2CWaitAck()
/* I2C Config */
#define I2C_ERR 0
#define I2C_CRR 1
/*--------------------------------------------------------------------
函數名稱：I2C Start
函數功能：
注意事項：
提示說明：
輸 入：
返 回：
--------------------------------------------------------------------*/
bool I2C_Start()
{
I2CStart();
I2CWaitAck();
if( I2CChkAck()!=I2C_START )
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：I2C ReStart
函數功能：
注意事項：
提示說明：
輸 入：
返 回：
--------------------------------------------------------------------*/
bool I2C_Restart()
{
I2CStart();
I2CWaitAck();
if( I2CChkAck()!=I2C_RESTART )
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：發送 7位 器件寫地址: XXXX XXX0
函數功能：
注意事項：
提示說明：
輸 入：
返 回：
--------------------------------------------------------------------*/
bool I2C_SendWrDAdr(uint8 wrDAdr)
{
I2CSendByte(wrDAdr); //設置 器件寫地址
I2CWaitAck();
if( I2CChkAck()!=I2C_MT_SLA_ACK )
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：發送 10位 器件寫地址: 1111 0XX0, XXXX XXXX
函數功能：
注意事項：
提示說明：兼容 發送 7位 器件寫地址: XXXX XXX0
輸 入：
返 回：
--------------------------------------------------------------------*/
bool I2C_SendWrDAdr_(uint16 wrDAdr)
{
if( wrDAdr&0xF000 == 0xF000 ) //判斷是否為 10位 器件地址
if( I2C_SendWrDAdr( (uint8)wrDAdr>>8 )==I2C_ERR ) //設置 （高位）器件寫地址
return I2C_ERR;
if( I2C_SendWrDAdr( (uint8)wrDAdr )==I2C_ERR ) //設置 （低位）器件寫地址
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：發送 7位 器件讀地址: XXXX XXX1
函數功能：
注意事項：
提示說明：
輸 入：
返 回：
--------------------------------------------------------------------*/
bool I2C_SendRdDAdr(uint8 rdDAdr)
{
I2CSendByte(rdDAdr); //設置 器件讀地址
I2CWaitAck();
if( I2CChkAck()!=I2C_MR_SLA_ACK )
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：發送 10位 器件讀地址: 1111 0XX0, XXXX XXXX
函數功能：
注意事項：
提示說明：
輸 入：
返 回：
--------------------------------------------------------------------*/
bool I2C_SendRdDAdr_(uint8 rdDAdr)
{
if( rdDAdr&0xF000 == 0xF000 ) //判斷是否為 10位 器件地址
if( I2C_SendWrDAdr( (uint8)rdDAdr>>8 )==I2C_ERR ) //設置 （高位）器件讀地址
return I2C_ERR;
if( I2C_SendWrDAdr( (uint8)rdDAdr )==I2C_ERR ) //設置 （低位）器件讀地址
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：I2C發送數據
函數功能：
注意事項：
提示說明：
輸 入：
返 回：
--------------------------------------------------------------------*/
bool I2C_SendDat(uint8 configDat)
{
I2CSendByte(configDat);
I2CWaitAck();
if( I2CChkAck()!=I2C_MT_DATA_ACK )
return I2C_ERR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：I2C接收數據且不產生應答
函數功能：
注意事項：
提示說明：
輸 入：
返 回：
--------------------------------------------------------------------*/
bool I2C_RcvNAckDat(uint8 *pRdDat)
{
I2CRcvNckByte();
I2CWaitAck();
if( I2CChkAck()!=I2C_MR_DATA_NACK )
return I2C_ERR;
*pRdDat=TWDR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：I2C接收數據且產生應答
函數功能：
注意事項：
提示說明：
輸 入：
返 回：
--------------------------------------------------------------------*/
bool I2C_RcvAckDat(uint8 *pRdDat)
{
I2CRcvAckByte();
I2CWaitAck();
if( I2CChkAck()!=I2C_MR_DATA_ACK )
return I2C_ERR;
*pRdDat=TWDR;
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：I2C寫器件，寫一個數據
函數功能：
注意事項：
提示說明：
輸 入：wrDAdr: write device-address 寫器件地址
wordAdr: word address 字地址
dat: data 數據
返 回：
--------------------------------------------------------------------*/
bool I2C_Write(uint16 wrDAdr,uint8 wordAdr,uint8 dat)
{
if( I2C_Start()==I2C_ERR )
return I2C_ERR;
if( I2C_SendWrDAdr_(wrDAdr)==I2C_ERR )
return I2C_ERR;
if( I2C_SendDat(wordAdr)==I2C_ERR )
return I2C_ERR;
if( I2C_SendDat(dat)==I2C_ERR )
return I2C_ERR;
I2C_Stop();
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：I2C寫器件，寫N個數據
函數功能：
注意事項：
提示說明：
輸 入：wrDAdr: write device-address 寫器件地址
wordAdr: word address 字地址
*pWrDat: p->write data 寫入數據指針
num: number 寫入數據個數
返 回：
--------------------------------------------------------------------*/
//bool I2C_Write_(uint16 wrDAdr,uint8 wordAdr,
// uint8 *pWrDat,uint8 num)
//{
//
//}
/*--------------------------------------------------------------------
函數名稱：I2C讀器件，讀一個數據
函數功能：
注意事項：
提示說明：
輸 入：wrDAdr: write device-address 寫器件地址
wordAdr: word address 字地址
rdDAdr: read device-address 讀器件地址
*pRdDat: p->read data 讀取數據指針
返 回：
--------------------------------------------------------------------*/
bool I2C_Read(uint16 wrDAdr,uint8 wordAdr,
uint8 rdDAdr,uint8 *pRdDat)
{
if( I2C_Start()==I2C_ERR )
return I2C_ERR;
if( I2C_SendWrDAdr_(wrDAdr)==I2C_ERR )
return I2C_ERR;
if( I2C_SendDat(wordAdr)==I2C_ERR )
return I2C_ERR;
if( I2C_Restart()==I2C_ERR )
return I2C_ERR;
if( I2C_SendRdDAdr(rdDAdr)==I2C_ERR )
return I2C_ERR;
if( I2C_RcvNAckDat(pRdDat)==I2C_ERR )
return I2C_ERR;
I2C_Stop();
return I2C_CRR;
}
/*--------------------------------------------------------------------
函數名稱：I2C讀器件，讀N個數據
函數功能：
注意事項：
提示說明：
輸 入：wrDAdr: write device-address 寫器件地址
wordAdr: word address 字地址
rdDAdr: read device-address 讀器件地址
*pRdDat: p->read data 讀取數據指針
num: number 讀取數據個數
返 回：
--------------------------------------------------------------------*/
bool I2C_Read_(uint16 wrDAdr,uint8 wordAdr,
uint8 rdDAdr,uint8 *pRdDat,uint8 num)
{
uint8 i;
if( I2C_Start()==I2C_ERR )
return I2C_ERR;
if( I2C_SendWrDAdr_(wrDAdr)==I2C_ERR )
return I2C_ERR;
if( I2C_SendDat(wordAdr)==I2C_ERR )
return I2C_ERR;
if( I2C_Restart()==I2C_ERR )
return I2C_ERR;
if( I2C_SendRdDAdr(rdDAdr)==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;
I2C_Stop();
return I2C_CRR;
}
#endif
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -