11-I2C

声明：

本文是本人在韦东山笔记的基础上加了一些注释，方便理解。原文地址：

第001节_I2C协议与EEPROM

1.1 I2C协议原理

I2C在硬件上的接法如下图所示，主控芯片（ARM）引出SCL、SDA线两条线，在一条I2C总线上可以接很多I2C设备（各设备如下图所示进行连接），我们还会放一个上拉电阻（放一个上拉电阻的原因以后我们再说）。

我们怎么传输数据，我们需要发数据从主设备发送到从设备上去，也需要把数据从从设备传送到主设备上去，数据涉及到双向传输。

1.1.1 IIC传输数据的格式

1.写操作的格式（或者说是步骤）：
刚开始主芯片要发出一个start信号，然后发出一个设备地址(用来确定是往哪一个芯片写数据)，方向(即表达你读或写，0表示写，1表示读)。

回应(用来确定这个设备是否存在)，然后就可以传输数据，传输数据之后，要有一个回应信号（确定数据是否接受完成)，然后再传输下一个数据。

每传输一个数据，接受方都会有一个回应信号，数据发送完之后，主芯片就会发送一个停止信号。

2.读操作的格式（或者说是步骤）：
刚开始主芯片要发出一个start信号，然后发出一个设备地址(用来确定是从哪一个芯片读取数据)，方向(读/写，0表示写，1表示读)。

回应(用来确定这个设备是否存在)，然后就可以传输数据，传输数据之后，要有一个回应信号（确定数据是否接受完成)，然后在传输下一个数据。

每传输一个数据，接受方都会有一个回应信号，数据发送完之后，主芯片就会发送一个停止信号。

注：不管是写还是读操作，设备地址加方向的位数是8位，而数据也是8位的。也就是说传输是以8位进行传输的。设备地址加方向其实也是数据。

传输是以8位为单元数据传输的，先传输最高位(MSB)，主芯片发出start信号之后，然后发出9个时钟去传输数据（前8个时钟的每个时钟传输一位数据，第9个时钟用于等待（发出）回应位。即9个时钟用于发送8位数据）。

下面看一下IIC总线的传输过程图：
（1）开始信号（S）：SCL为高电平时，SDA由高电平向低电平跳变，开始传送数据。
（2）结束信号（P）：SCL为高电平时，SDA由低电平向高电平跳变，结束传送数据。
（3）响应信号(ACK)：接收器在接收到8位数据后，在第9个时钟周期，拉低SDA
另外需要知道的是：SDA上传输的数据必须在SCL为高电平期间保持稳定，SDA上的数据只能在SCL为低电平期间变化。

好了，看了前面的知识，我们有几个问题：
1.问题：如何在SDA上实现双向传输（IIC为半双工，即要么主到从，要么从到主）？
答：主芯片通过一根SDA线既可以把数据发给从设备，也可以从SDA上读取数据，连接SDA线的引脚里面必然有两个引脚（发送引脚/接受引脚）。

2.问题：主设备(从设备)发送数据时，从设备(主设备)不应该发送（半双工嘛），怎么做到的？
答：通过SCL进行控制的。比如前8个时钟的每个时钟传输一位数据，第9个时钟用于等待（发出）回应位。

3.问题：主设备(从设备)发送数据时，从设备(主设备)的发送引脚的存在 不影响 主设备(从设备)数据的发送，怎么做到呢？
答：里面放一个三极管，使用开极(极电集开发出去作为输出)电路，如下图：
答：如果A要发送数据，则只需要让B输出低电平（B是三极管，则不导通）就失效了。

好，让接收端的三极管失效解决了。那么A呢，怎么输出高低电平的？
答：首先你看，我们的数据在SDA线上无非就是0或1吧。
在看下面这个图：
并且你要知道的是，在上面这个图的SDA线上有一个上拉电阻，使得AB都为1时SDA为1。而这就是上拉电阻的作用。
也就是说让A输出0，则SDA输出1；
让A输出1，则SDA输出0。
好，这个问题解决了。同样B传输数据A接收数据的时候反过来。

好，举个例子吧，从下面的例子可以看看数据是怎么传的（实现双向传输），比如：
主设备发送（8bit）给从设备 ：

1.前8个clk
	从设备不要影响，从设备不驱动三极管；
	主设备决定数据；
2.第9个clk，由从设备决定数据
	主设备不驱动三极管；
	从设备决定数据；

从上面的例子，就可以知道，怎样在一条线上实现，双向传输的办法。这就是为什么在SDA,SCL上放上拉电阻的原因。

补充一点：看从这往上数第三幅图的数据传输图，在第9个时钟之后，如果有某一方处于繁忙状态，它可以一直把SCL拉低，当SCL为低电平时候，大家都不应该使用IIC总线，只有当SCL从低电平变为高电平的时候，IIC总线才能被使用。

说明一点：从这往上数第三幅图我们也可以知道ACK信号应该是低电平。主设备不驱动三极管，如果从设备不驱动三极端的化SDA应该是高电平，当从设备接收数据之后，发出回应信号的时候，就会驱动三极管，让SDA变为低电平。所以说：ACK信号是低电平。

再说明一点：对于IIC协议它只能规定怎么传输数据，数据什么含义它完全不能够控制，数据的含义由从设备决定。

第002节_S3C2440的I2C控制器

在嵌入式系统里面的主控芯片一般都会有I2C控制器，要是没有可以根据I2C协议用GPIO管脚模拟，但是非常麻烦，先不用管这个。我们来看有I2C控制器的情况：
我们要发送数据时，可以把数据放到I2C控制器的某个寄存器，它就会自动的发出时钟，并且把数据发送给从设备，同时会等待从设备会返回回应信号。
当我们想接收一个数据的时候，要设置某个寄存器启动传输，它也一样会产生时钟，然后从设备就会把数据通过SDA传到I2C控制器里面，组装进某个寄存器里面，最终寄存器会把接收到的8位数据返回给我们的程序。
从这里可以看到I2C控制器简化了I2C的操作。
简短电路连接图，如图:

好，来看下面这个图，其是I2C控制器的内部结构原理图
根据下图，我们首先设置IICCON(来设置时钟)，时钟源是PCLK(是50MHZ)，但其太快了，我们需要设置这个分频系数，把时钟降低，降低到我们想要的SCL。
然后我们要发出start信号，我们需要设置寄存器IICSTAT发出start信号。
之后我们需要发出数据啊，我们的程序可以把数据写入到IICDS寄存器，一写入就会自动的发出时钟，并且把这8位数据从SDA发送给从设备。
数据发送之后，在第九个时钟会收到回应信号，可以查询IICSTAT是否有ACK，有ACK表示数据发送成功了，可以继续发送数据。
等发完数据之后，再来设置IICSTAT让它发出P信号。

好，再往下看。
我们知道，在第九个CLK，就会产生一个中断，在中断处理过程中SCL被拉为低电平，谁都不能再使用IIC总线，等待中断处理完成。那么怎样处理中断，或者说这个ACK中断是干嘛的？

写操作：
	若无ACK,则说明出错，然后发出P信号结束。
	若有ACK信号，则表示上一个字节成功发送出去。
		若仍有数据你想要去发送，则写入IICDS寄存器，然后清中断，一清中断就会释放SCL信号，继续发出时钟，把数
		据再次发送出去。
		若没有数据想发送了，你就发出P信号结束。
读操作：
	读到8位数时，应该回应给设备一个ACK信号。
	如果还想读数据，就先清中断，从而启动了传输。等它再次发生ACK中断时，再来读取IICDS寄存器,得到数据。
	不想读取数据的话，就发出P信号结束。

重点： 发生中断时，我们的IIC控制器会把SCL拉低，阻止任何设备再使用IIC总线，清中断之后才能继续使用，这种机制
就给我们中断服务程序的执行提供了时间。

那么，我们想要发送或接收，我们具体怎么操作，如下：

在发送模式：
	1.往寄存器IICDS寄存器放入一个val值。
	2.发完，产生中断，并且会把 SCL拉低。
	3.在中断程序里，你去编程判断是否要继续发送数据，，如果想继续发送则往IICDS里面写入下一个数据，一旦写入
	下一个数据，则IIC继续操作，若再次发完，就会再次产生中断。

在接受模式：
	1.你写的程序发起传输，去接受数据。
	2.接收到数据之后，产生中断，SCL被拉低。
	3.中断程序里，判断数据是否要继续接受等，如果还想继续接受的话，再次设置，设置好之后去读IICDS寄存器，一但读出来IIC则继续接受下一个数据，收到新数据之后，又会产生一个中断（就是这样循环操作）。

下面是IIC的几个重要寄存器：

ICCON寄存器（Multi-masterIIC-buscontrol)

IICCON寄存器用于控制是否发出ACK信号、设置发送器的时钟、开启，i2c中断，并标识中断是否发生。它的各位含义如表:
使用IICCON寄存器时，有如下注意事项。
1.发送模式的时钟频率由位[6]、位[3:0]联合决定,另外，llCCON[6]=0,IICCON[3:0] 不能取0或10
2.12c中断在以下3种情况下发生：当发出地址信息或接收到一个从机（从机及所说的外部设备）地址并且吻合时、当总线仲裁失败时、当发送/接收完一个字节的数据（包括响应位）时。
3.基于SDA、SCL线上时间特性的考虑，要发送数据时，先将数据写入IICDS寄存器，然后再清除中断。
4.如果IICCON[5]=0，IICCON[4]将不能正常工作。所以，即使不使用12c中断，也要将IICCON[5]设为1。

IICSTAT寄存器(Multi-masterIIC-buscontrol/status)

IICSTAT寄存器用于选择12c接口的工作模式，发出S信号、P信号，使能接收／发送功能，并标识各种状态，比如总线仲裁是否成功、作为从机时是否被寻址、是否接收到0地址、是否接收到ACK信号等。IICSTAT寄存器的各位如表:

IICADD寄存器(Multi-masterIlC-busaddress)

用到IICADD寄存器的位[7:11]，表示从机地址。IICADD寄存器在串行输出使能位 IICSTAT[4]为0时，才可以写入：在任何时间都可以读出。IICADD寄存器的各位如表:

IICDS寄存器(Multi-masterIIC-busTx/Rxdatashift)

用到IICDS寄存器的位[7：0]，其中保存的是要发送或己经接收的数据。
IICDS寄存器在 串行输出使能位IICSTAT[1]（？？？？？）为1时，才可以写入；
在任何时间都可以读出。
IICDS寄存器的各位如表:

再往下看芯片手册，是读写操作流程图，我们编程按照这个来就行：
读写操作流程图

主机发送器模式操作:

主机接收器模式操作:

第003节_程序框架

写程序之前 考虑好程序的框架，我们想写出一个结构比较好，比较容易扩展的程序。因此我们先要考虑清楚框架的设计。

3.1 IIC控制器的功能

IIC会做什么事情呢？
答：对于IIC控制器，它负责传输数据，不知道数据的含义，但是它要实现写 / 读操作，如下。
读操作 ：

写操作 ：

很显然，IIC控制器提供了传输数据的能力，至于数据有什么含义，IIC控制器并不知道，数据的含义由外接的IIC芯片决定。
我们需要阅读AT24cxx芯片手册，才知道IIC控制器应该发出怎样的数据，
AT24cxx的操作方法：

3.1 程序框架

现在来写框架

我们提供一个统一的接口i2c_transfer，不关使用哪个芯片，他最终都会调用i2c_transfer，来选择某一款I2C控制器，把数据发送出去，或者从I2c设备读到数据。
对于每一次i2c_transfer()传输的数据都可以用一个i2c_msg结构体来表示。但是值得注意的是，读某个地址的数据时要用两个i2c_msg结构体来描述它，这是因为一个i2c_msg结构体只能描述一个传输方向(读/写)，我们读取ac24ccxx某个地址上的数据时，要先写出要读取的地址，然后来读取设备地址上的数据。

我们想设计出以一个结构体比较容易扩展的框架。对于具体型号的I2C控制器（如2440的）我们要抽象出一个结构体i2c_controller，我们构造这个结构体之后，把这个这个结构体，告诉上层(I2C控制器那一层)，上层有个管理者i2c_contreller.c文件。

我们在s3c2440_i2c_controller.c这个文件中我们构造出一个i2c_controller结构体，把它放入上层文件中的数组里，以后就根据结构体的名字，把这个结构体取出来使用。（这样做的好处是，如果你有多种型号（如2440）的板子，以后每种型号直接存入数组就行）。
假设我们有一个TI的开发板，在ti_i2c_controller.c文件中，也要构造出一个i2c_controller结构体，同样们也会把这个结构体放入上层的结构体数组(i2c_contreller.c文件中)中，以后根据名字先出来使用。

对于设备层中的at24cxx芯片我们写出at24cxx.c文件在这个文件实现读写函数：
1.at24cxx_write函数
2.at24cxx_read。
读写函数都会调用i2c_transfer发起IIC传输，所以我们写程序的时候主要的暂时会涉及到三个文件：
at24cxx.c， s3c2440_i2c_controller.c，i2c_contreller.c。
在最上层会写出一个i2c_test.c文件，它会提供菜单供我们选择来测试。

下面我们自顶而下地写一个程序框架，涉及到的文件有：i2c_test.c、at24cxx.c、i2c_controller.c、s3c2440_i2c_controller.c

i2c_test.c文件

该文件的内容如下：

void i2c_test(void)
{
   
	/* 初始化: 选择I2C控制器 */

	/* 提供菜单供测试 */
}

这个菜单最终会调用到at24cxx.c里面的函数。

at24cxx.c文件

读写函数会使用标准的接口i2c_transfer来启动I2C传输。该文件的内容如下：

int at24cxx_write(unsigned int addr, unsigned char *data, int len)
{
   
	/* 构造i2c_msg */

	/* 调用i2c_transfer */
}

int at24cxx_read(unsigned int addr, unsigned char *data, int len)
{
   
	/* 构造i2c_msg */

	/* 调用i2c_transfer */
}

i2c_controller.c文件

该文件的内容如下：

/* 注册---有一个i2c_controller数组用来存放各种不同芯片的操作结构体 */
void register_i2c_controller()
{
   
}

/* 根据名字来选择某款I2C控制器 */
void select_i2c_controller(char *name)
{
   
}

/* 实现 i2c_transfer 接口函数 */
int i2c_transfer(i2c_msg msgs, int num)
{
   
}

select_i2c_controller函数根据名字来选择某款I2C控制器后，以后就会使用被选择的I2C控制器来启动传输。

有数组一定有注册函数register_i2c_controller会把下面实现的I2C控制器结构体i2c_controller放到i2c_controller数组里面。

s3c2440_i2c_controller.c文件

对于具体的芯片，要实现自己的i2c_controller。该文件的内容如下：

/* 实现i2c_controller结构体
          .init
          .master_xfer
          .name
 */

第004节_I2C控制器编程_框架

我们现在来讲I2C控制器怎么写，它是I2C程序中最核心的地方，我们要先构造几个结构体，这几个结构体放在i2c_controller.h里面。

2c_controller.h文件

我们要发出I2c传输时，要构造出i2c_msg，把构造出的i2c_msg扔给下面的i2c_controller.c，i2c_controller.c会选择某一个i2c控制器，使用里面的master_xfer来传输数据， 所以我们需要构造出一个i2c_controller结构体。
2c_controller.h文件如下：

#ifndef _I2C_CONTROLLER_H
#define _I2C_CONTROLLER_H

typedef struct i2c_msg {
   
	unsigned int addr;  /* 7bits */
	int flags;  /* 0 - write, 1 - read */
	int len;
	int cnt_transferred;
	unsigned char *buf;
}i2c_msg, *p_i2c_msg;

typedef struct i2c_controller {
   
	int (*int)(void);
	int (*master_xfer)(i2c_msg msgs, int num);
	char *name;
}i2c_controller, *p_i2c_controller;


#endif /* _I2C_CONTROLLER_H */
解析：我们构造这两个结构体，我们要把它放在i2c_controller.c把它用起来，

i2c_controller.c文件

include "i2c_controller.h"

#define I2C_CONTROLLER_NUM 10 //10种芯片

/* 有一个i2c_controller数组用来存放各种不同芯片的操作结构体 */
static p_i2c_controller p_i2c_controllers[I2C_CONTROLLER_NUM];
static p_i2c_controller p_i2c_con_selected;


void register_i2c_controller(p_i2c_controller *p) 
{
   
	int i;
	for (i = 0; i < I2C_CONTROLLER_NUM; i++)
	{
   
		if (!p_i2c_controllers[i])
		{
   
			p_i2c_controllers[i] = p;
			return;
		}
	}
}
解析：register_i2c_controller函数用于把参数中的结构体指针，注册到p_i2c_controllers指针数组中。

/* 根据名字来选择某款I2C控制器 */
int select_i2c_controller(char *name)
{
   
	int i;
	for (i = 0; i < I2C_CONTROLLER_NUM; i++)
	{