想测Arduino的I2C性能,又不知道如何使用库函数,又不想自己写函数。。顺手把Arduino官网的Wire.h库函数借鉴下。
首先,arduino中的Wire库主要包含以下函数:
Wire.begin()
Wire.requestFrom()
Wire.beginTransmission()
Wire.endTransmission()
Wire.write()
Wire.available()
Wire.read()
Wire.onReceive()
Wire.onRequest()
1、Wire.begin() 和 Wire.begin(address)
描述
初始化wire库 ,并且加入到I2C网络,前者作为Master 或 Slaver,并且只能调用一次。
参数
address :7位的器件地址(可选),如果没有输入,则以Master的形式加入到I2C网络。
2、Wire.requestFrom()
描述
主设备请求从设备一个字节,这个字节可以被主设备用 read()或available()接受。
Wire.requrstFrom(addtess,quantity)
Wire.requrstFrom(addtess,quantity,stop)
参数
addtess : 7位的器件地址
quantity : 请求得到的数量
stop :布尔形,‘1’ 则在请求结束后发送一个停止命令,并释放总线。‘0’则继续发送请求保持连接。
返回
字节形 ,从从机接受到的字节数目。
3 Wire.beginTransmission(address)
描述
开始一次传输数据,发送一个I2C开始字符
参数
address : 器件的7位地址
返回值 无
4、 Wire.endTransmission()和Wire.endTransmission(stop)
描述
结束一个由beginTransmission()开始的并且由write()排列的从机的传输。在Arduino中 endTransmission()接受到
一个布尔形变量,如果为1 则endTransmission()发送一个停止信息;如果为0 则发送开始信息
返回值
0 成功 1 数据溢出 2 发送addtess时从机接受到NACK 3 发送数据时接受到 NACK 4 其他错误
5、 Wire.write()
描述
向从机发送数据
形式
Wire.write(value)
Wire.write(string)
Wire.write(data, length)
参数
value :要发送的数值
string :字符组的指针
data :一个字节数组
length :传输的数量
例子:
#include <Wire.h>
byte val = 0;
void setup()
{
Wire.begin(); // join i2c bus
}
void loop()
{
Wire.beginTransmission(44); // transmit to device #44 (0x2c)
// device address is specified in datasheet
Wire.write(val); // sends value byte
Wire.endTransmission(); // stop transmitting
val++; // increment value
if(val == 64) // if reached 64th position (max)
{
val = 0; // start over from lowest value
}
delay(500);
}
6、 Wire.available()
描述
7、 Wire.read()
8、 Wire.onReceive()
9、 Wire.onRequest()