I2C总线的Arduino库函数

I2C总线的Arduino库函数

 

I2C即Inter－Integrated Circuit串行总线的缩写，是PHILIPS公司推出的芯片间串行传输总线。它以1根串行数据线（SDA）和1根串行时钟线（SCL）实现了双工的同步数据传输。具备接口线少，控制方式简化，器件封装形式小，通讯速率较高等优势。在主从通讯中，能够有多个I2C总线器件同时接到I2C总线上，经过地址来识别通讯对象。

Arduino提供的I2C库函数为Wire.h。

I2C总线工做原理

SDA（串行数据线）和SCL（串行时钟线）都是双向I/O线，接口电路为开漏输出．需经过上拉电阻接电源VCC．当总线空闲时．两根线都是高电平，链接总线的外同器件都是CMOS器件，输出级也是开漏电路．在总线上消耗的电流很小，所以，总线上扩展的器件数量主要由电容负载来决定，由于每一个器件的总线接口都有必定的等效电容．而线路中电容会影响总线传输速度．当电容过大时，有可能形成传输错误．因此，其负载能力为400pF，所以能够估算出总线容许长度和所接器件数量。

主器件用于启动总线传送数据，并产生时钟以开放传送的器件，此时任何被寻址的器件均被认为是从器件．在总线上主和从、发和收的关系不是恒定的，而取决于此时数据传送方向。若是主机要发送数据给从器件，则主机首先寻址从器件，而后主动发送数据至从器件，最后由主机终止数据传送；若是主机要接收从器件的数据，首先由主器件寻址从器件．而后主机接收从器件发送的数据，最后由主机终止接收过程。在这种状况下．主机负责产生定时时钟和终止数据传送。 ^[2] 

I2C总线特征

I2C总线特色能够归纳以下：

(1)在硬件上，I2C总线只须要一根数据线和一根时钟线两根线，总线接口已经集成在芯片内部，不须要特殊的接口电路，并且片上接口电路的滤波器能够滤去总线数据上的毛刺．所以I2C总线简化了硬件电路PCB布线，下降了系统成本，提升了系统可靠性。由于I2C芯片除了这两根线和少许中断线，与系统再没有链接的线，用户经常使用IC能够很容易造成标准化和模块化，便于重复利用。

(2)I2C总线是一个真正的多主机总线，若是两个或多个主机同时初始化数据传输，能够经过冲突检测和仲裁防止数据破坏，每一个链接到总线上的器件都有惟一的地址，任何器件既能够做为主机也能够做为从机，但同一时刻只容许有一个主机。数据传输和地址设定由软件设定，很是灵活。总线上的器件增长和删除不影响其余器件正常工做。

(3)I2C总线能够经过外部连线进行在线检测，便于系统故障诊断和调试，故障能够当即被寻址，软件也利于标准化和模块化，缩短开发时问。

(4)链接到相同总线上的IC数量只受总线最大电容的限制，串行的8位双向数据传输速率在标准模式下可达100Kbit/s，快速模式下可达400Kbit/s，高速模式下可达3．4Mbit/s。

(5)总线具备极低的电流消耗．抗高噪声干扰，增长总线驱动器可使总线电容扩大10倍，传输距离达到15m；兼容不一样电压等级的器件，工做温度范围宽。

This library allows you to communicate with I2C / TWI devices. On the Arduino boards with the R3 layout (1.0 pinout), the SDA (data line) and SCL (clock line) are on the pin headers close to the AREF pin. The Arduino Due has two I2C / TWI interfaces SDA1 and SCL1 are near to the AREF pin and the additional one is on pins 20 and 21.

As a reference the table below shows where TWI pins are located on various Arduino boards. TWI引脚在不一样板子上的位置。

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

As of Arduino 1.0, the library inherits from the Stream functions, making it consistent with other read/write libraries. Because of this, send() and receive() have been replaced with read() and write().

Note

There are both 7- and 8-bit versions of I2C addresses. 7 bits identify the device, and the eighth bit determines if it's being written to or read from. The Wire library uses 7 bit addresses throughout. If you have a datasheet or sample code that uses 8 bit address, you'll want to drop the low bit (i.e. shift the value one bit to the right), yielding an address between 0 and 127. However the addresses from 0 to 7 are not used because are reserved so the first address that can be used is 8. Please note that a pull-up resistor is needed when connecting SDA/SCL pins. Please refer to the examples for more informations. MEGA 2560 board has pull-up resistors on pins 20 - 21 onboard.

    

I2C的Arduino库函数

begin() 初始化总线，做为主机或从机加入总线，带地址参数就是从机，不带就是主机

requestFrom() 主机向从机请求字节/数据

beginTransmission()  主机向从机传送数据开始

endTransmission()  主机向从机传送数据中止

write()  写数据，从机向主机或主机向从机

available()  返回经过read()函数获得的字节数

read()  读取一个传送的字节

SetClock()  修改I2C通讯的频率，标准值是100KHz

onReceive()  注册一个函数，当从机接收到主机的数据时此函数被调用

onRequest()  注册一个函数，当主机向从机请求数据时此函数 被调用

 

I2C的Arduino库函数详解

 

Wire.begin() 初始化总线，做为主机或从机加入总线，带地址参数就是从机，不带就是主机

Description  描述

Initiate the Wire library and join the I2C bus as a master or slave. This should normally be called only once.

Syntax  语法

Wire.begin(address) 

Parameters 参数

address: the 7-bit slave address (optional); if not specified, join the bus as a master.

Returns  返回

None

 

Wire.requestFrom()  主机向从机请求字节/数据

Description

Used by the master to request bytes from a slave device. The bytes may then be retrieved with the available() and read() functions.

As of Arduino 1.0.1, requestFrom() accepts a boolean argument changing its behavior for compatibility with certain I2C devices.

If true, requestFrom() sends a stop message after the request, releasing the I2C bus.

If false, requestFrom() sends a restart message after the request. The bus will not be released, which prevents another master device from requesting between messages. This allows one master device to send multiple requests while in control.

The default value is true.

Syntax  语法

Wire.requestFrom(address, quantity)
Wire.requestFrom(address, quantity, stop)

Parameters

address: the 7-bit address of the device to request bytes from

quantity: the number of bytes to request

stop : boolean. true will send a stop message after the request, releasing the bus. false will continually send a restart after the request, keeping the connection active.

Returns

byte : the number of bytes returned from the slave device

 

Wire.beginTransmission(address)  主机向从机传送数据开始

Description

Begin a transmission to the I2C slave device with the given address. Subsequently, queue bytes for transmission with the write() function and transmit them by calling endTransmission().

Parameters

address: the 7-bit address of the device to transmit to

Returns

None

 

Wire.endTransmission()  主机向从机传送数据中止

Description

Ends a transmission to a slave device that was begun by beginTransmission() and transmits the bytes that were queued by write().

As of Arduino 1.0.1, endTransmission() accepts a boolean argument changing its behavior for compatibility with certain I2C devices.

If true, endTransmission() sends a stop message after transmission, releasing the I2C bus.

If false, endTransmission() sends a restart message after transmission. The bus will not be released, which prevents another master device from transmitting between messages. This allows one master device to send multiple transmissions while in control.

The default value is true.

Syntax

Wire.endTransmission()
Wire.endTransmission(stop)

Parameters

stop : boolean. true will send a stop message, releasing the bus after transmission. false will send a restart, keeping the connection active.

Returns

byte, which indicates the status of the transmission:

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()  写数据，从机向主机或主机向从机

Description

Writes data from a slave device in response to a request from a master, or queues bytes for transmission from a master to slave device (in-between calls to beginTransmission() and endTransmission()).

Syntax

Wire.write(value)
Wire.write(string)
Wire.write(data, length)

Parameters

value: a value to send as a single byte

string: a string to send as a series of bytes

data: an array of data to send as bytes

length: the number of bytes to transmit

Returns

byte: write() will return the number of bytes written, though reading that number is optional

 

Example 举例

#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);
}

 

Wire.available()  返回经过read()函数获得的字节数

Description

Returns the number of bytes available for retrieval with read(). This should be called on a master device after a call to requestFrom() or on a slave inside the onReceive() handler.

available() inherits from the Stream utility class.

Parameters

None

Returns

The number of bytes available for reading.

 

 

Wire.read()   读取一个传送的字节

Description

Reads a byte that was transmitted from a slave device to a master after a call to requestFrom() or was transmitted from a master to a slave.  read() inherits from the Stream utility class.

Syntax

Wire.read()

Parameters

none

Returns

The next byte received

 

Example

#include <Wire.h>
void setup()
{
  Wire.begin();         // join i2c bus (address optional for master)
  Serial.begin(9600);   // start serial for output
}

void loop()
{
  Wire.requestFrom(2, 6);    // request 6 bytes from slave device #2
  while(Wire.available())    // slave may send less than requested
  {
    char c = Wire.read();    // receive a byte as character
    Serial.print(c);         // print the character
  }
  delay(500);
}

 

Wire.setClock()   修改I2C通讯的频率，标准值是100KHz

Description

This function modifies the clock frequency for I2C communication. I2C slave devices have no minimum working clock frequency, however 100KHz is usually the baseline.

Syntax

Wire.setClock(clockFrequency)

Parameters

clockFrequency: the value (in Hertz) of desired communication clock. Accepted values are 100000 (standard mode) and 400000 (fast mode). Some processors also support 10000 (low speed mode), 1000000 (fast mode plus) and 3400000 (high speed mode). Please refer to the specific processor documentation to make sure the desired mode is supported.

Returns

None

Wire.onReceive(handler)  注册一个函数，当从机接收到主机的数据时，此函数被调用

Description

Registers a function to be called when a slave device receives a transmission from a master.

Parameters

handler: the function to be called when the slave receives data; this should take a single int parameter (the number of bytes read from the master) and return nothing, e.g.: void myHandler(int numBytes)

Returns

None

 

Wire.onRequest(handler)  注册一个函数，当主机向从机请求数据时，此函数被调用

Description

Register a function to be called when a master requests data from this slave device.

Parameters

handler: the function to be called, takes no parameters and returns nothing, e.g.: void myHandler()

Returns

None