Board	I2C / TWI pins
Uno, Ethernet	A4 (SDA), A5 (SCL)
Mega2560	20 (SDA), 21 (SCL)
Leonardo	2 (SDA), 3 (SCL)
Due	20 (SDA), 21 (SCL), SDA1, SCL1

I2C库文件wire

背景
使用 Arduino 例程的时候发现，官方的描述不太详细，走了些弯路。特此，写篇文章记录下。

Arduino 的 I2C 相关函数
Arduino 的封装库真的是非_非非常的棒，I2C 就只有 10 个 API 函数。I2C 所用的库，称为：Wire Library。详细的描述可以看这个官方地址：

https://www.arduino.cc/en/Reference/Wire

下面我会介绍部分的 API 函数。

begin

begin 函数用于初始化 Wrie Library 并以 Master 或 Slave 的身份加入 I2C 总线上。begin 函数没有返回值。调用 begin 函数有两种形式：

begin()：无输入参数，表示以 Master 形式加入总线。
begin( address )：有输入参数，表示以从机形式加入总线，设备地址为address（7-bit）

beginTransmission

beginTransmission 函数用于启动一次 Master write to Slave 操作。值得注意的是这个函数的调用并不会产生 Start 信号和发送 Slave Address，仅是实现通知 Arduino后面要启动 Master write to Slave 操作。

beginTransmission 函数调用后，（再调用 write 函数进行数据写入），最后再调用 endTransmission 函数方能产生 Start 信号和发送 Slave Address 及通讯时序。
beginTransmission 函数调用形式：

beginTransmission(address)
1

write

write 函数用于向 Slave 写入数据。共有 3 种调用形式：

write(value) ：写入单字节
write(string) ：写入字符串
write(data, length) ：写入 length 个字节

endTransmission

endTransmission 函数用于结束一次 Master write to Slave 操作。前面在介绍 beginTransmission 的时候也介绍过了，如果不在后面使用 endTransmission 函数，总线上不会产生 Master write to Slave 的时序。

endTransmission 函数的调用十分有意思。endTransmission 函数可输入参数。

endTransmission(0)：当输入参数为 0 时，将在通讯结束后，不产生 STOP 信号。
endTransmission(!0)：当输入参数为 !0 时，在通讯结束后，生成 STOP 信号。（释放总线）
endTransmission()：当无输入参数时，在通讯结束后，产生 STOP 信号。（释放总线）
因为我设计的产品程序是使用 DUMMY WRITE 时序，就是这个不产生 STOP 信号卡了我半天的时间（这是我要写本文的原因……）。而官方中，并没有详细介绍这个输入参数…

同时，endTransmission 函数时具有返回值的：

0：success
1：data too long to fit in transmit buffer
2：received NACK on transmit of address
3：received NACK on transmit of data
4：other error
有个地方需要注意的：当通讯过程中，出现异常后，异常后的 write 操作将被终止，直接结束通讯，具体的是否出现异常，只需要看 endTransmission 的返回值即可。

requestFrom

requestFrom 函数用于实现 Master Read From Slave 操作。调用形式有 2 种：

requestFrom(address, quantity)：从 address 设备读取 quantity 个字节，结束后，产生 STOP 信号
requestFrom(address, quantity, stop) ：从 address 设备读取 quantity 个字节，结束后，依据 stop 的值确定是否产生 STOP 信号。
stop = 0：不产生 STOP 信号
stop != 0：产生 STOP 信号
requestFrom 函数具有返回值（表示从 address 设备读取到的字节数）。

available
available 函数用于统计 Master Read From Slave 操作后， read 缓存区剩余的字节数。每当缓存区的数据被读走 1 个字节，available 函数的返回值减一。通常 available 函数会搭配着 read 函数使用。

read
read 函数用于在 Master Read From Slave 操作后，读取缓存区的数据。

例程
下面的例程，是我提供给客户的案例程序。程序上传至了 GitHub：
https://github.com/TFmini/TFmini-I2C-MasterExample_Arduino

通讯时序如下图所示：

节选代码段：

#include <Wire.h> // I2C head filevoid setup() {// put your setup code here, to run once:Serial.begin(115200);// Initiate the Wire library and join the I2C bus as a master or Slave.Wire.begin(); Serial.print("Ready to Read TFmini\r\n");delay(10);
}void loop() {// put your main code here, to run repeatedly:byte i = 0;byte rx_Num = 0;  // the bytes of received by I2Cbyte rx_buf[7] = {0}; // received buffer by I2CWire.beginTransmission(7); // Begin a transmission to the I2C Slave device with the given address.Wire.write(1); // Reg's Address_HWire.write(2); // Reg's Address_LWire.write(7); // Data LengthWire.endTransmission(0);  // Send a START Sign// Wire.requestFrom（AA,BB）;receive the data form slave.// AA: Slave Address ; BB: Data Bytes rx_Num = Wire.requestFrom(0x07, 7); // Wire.available: Retuens the number of bytes available for retrieval with read().while( Wire.available()){rx_buf[i] = Wire.read(); // received one bytei++;}}

总结

作者：Cherry0_0Wu
来源：CSDN
原文：https://blog.csdn.net/XiuHua_Wu/article/details/82691173
版权声明：本文为博主原创文章，转载请附上博文链接！

【arduino库文件】-wire.h相关推荐

Arduino 库文件解读
当打开:项目------>加载库------>库管理,所下载的库文件在哪里存方的呢? 如下图,在我的文档里------>Arduino------> libraries里面的 ...
Arduino库文件导入卸载常见问题及解决
本文针对以下问题: 需要导入自建库,不知道入口: 需要修改或者删除自建库,发现怎么操作都没用的: 想要修改官方库,或者将修改后的官方库覆盖无效的: 目录导入库相关卸载库相关由于Arduino的版 ...
深入了解arduino舵机控制库文件Servo.h
舵机是我们在控制领域高频率使用的器件,尤其对于arduino玩家不可或缺.简单的使用方法我们在前面的博文中都已经做过介绍. 常规使用一般控制一般步骤为包涵一个servo.h的头文件,然后绑定端口, ...
C语言库文件ctype.h中重要的库函数
C Primer Plus第七章分支跳转章节中,提到了ctype.h头文件中的一些用于判断字符类型的库函数接口. isalnum() 字母数字 isalpha() 字母 isblank() 标准的空白 ...
C/C++ 数学库文件 (math.h)
目录 1.三角函数 Trigonometric functions 1.1. cos() 函数 1.2 sin() 正弦函数 1.3. tan() 正切函数 1.4. acos() 反余弦函数 1.5 ...
mind+自定义arduino库，实现简易RFID智能家居系统
文章目录前言(完整用户库下载链接在文章末尾) 一.用户库文件结构二.配置config.json文件三.编写main.ts文件四.编辑资源文件夹 _images _locales _menus ...
制作Arduino库——摩斯码
制作Arduino库--摩斯码前沿 1.文件结构 2.主文件代码 3.自定义Arduino库 3.1.编写.h头文件 3.2.编写.cpp源文件 3.3.编写keywords.txt文件 4.使自定 ...
arduino的servo函数_如何使用Arduino舵机库servo.h – 八色木
文章目录 [隐藏] 我们都知道Arduino控制板支持PWM的引脚有限,但如果在Arduino上需要控制超出PWM引脚数量的舵机怎么办呢?答案是使用servo.h库文件,它是Arduino控制舵机的标 ...
STM32F103构建固件库模板(PS固件库文件树介绍)
参考:STM32F103ZE新建固件库模板作者:追兮兮发布时间:2020-10-14 10:31:45 网址:https://blog.csdn.net/weixin_44234294/artic ...

【arduino库文件】-wire.h

目录