Linux驱动之IIC子系统

1. IIC协议

1.1 写操作

流程如下：

• 主芯片要发出一个start信号

• 然后发出一个设备地址(用来确定是往哪一个芯片写数据)，方向(读/写，0表示写，1表示读)

• 从设备回应(用来确定这个设备是否存在)，然后就可以传输数据

• 主设备发送一个字节数据给从设备，并等待回应

• 每传输一字节数据，接收方要有一个回应信号（确定数据是否接受完成)，然后再传输下一个数据

• 数据发送完之后，主芯片就会发送一个停止信号

下图：白色背景表示"主→从"，灰色背景表示"从→主"

1.2 读操作

流程如下：

• 主芯片要发出一个start信号

• 然后发出一个设备地址(用来确定是往哪一个芯片写数据)，方向(读/写，0表示写，1表示读)

• 从设备回应(用来确定这个设备是否存在)，然后就可以传输数据

• 从设备发送一个字节数据给主设备，并等待回应

• 每传输一字节数据，接收方要有一个回应信号（确定数据是否接受完成)，然后再传输下一个数据

• 数据发送完之后，主芯片就会发送一个停止信号

下图：白色背景表示"主→从"，灰色背景表示"从→主"

1.3 I2C信号

I2C协议中数据传输的单位是字节，也就是8位。但是要用到9个时钟：前面8个时钟用来传输8数据，第9个时钟用来传输回应信号。传输时，先传输最高位(MSB)。

• 开始信号（S）：SCL为高电平时，SDA从高电平向低电平跳变，开始传送数据

• 结束信号（P）：SCL为高电平时，SDA由低电平向高电平跳变，结束传送数据

• 响应信号(ACK)：接收器在接收到8位数据后，在第9个时钟周期，拉低SDA

• SDA上传输的数据必须在SCL为高电平期间保持稳定，SDA上的数据只能在SCL为低电平期间变化

I2C协议信号如下：

1.4 硬件实现

scl和sda管脚都采用开漏输出的驱动方式，需要外接上拉电阻来输出高电平。

真值表如下：

从真值表和电路图我们可以知道：

• 当某一个芯片不想影响SDA线时，那就不驱动这个三极管

• 想让SDA输出高电平，双方都不驱动三极管(SDA通过上拉电阻变为高电平)

• 想让SDA输出低电平，就驱动三极管

2. SMBus协议

2.1 概述

SMBus是基于I2C协议的，SMBus要求更严格，SMBus是I2C协议的子集，如下图：

SMBus与I2C的区别如下：

• VDD的极限值不一样

• I2C协议：范围很广，甚至讨论了高达12V的情况

• SMBus：1.8V~5V

• 最小时钟频率、最大的Clock Stretching

• Clock Stretching含义：某个设备需要更多时间进行内部的处理时，它可以把SCL拉低占住I2C总线

• I2C协议：时钟频率最小值无限制，Clock Stretching时长也没有限制

• SMBus：时钟频率最小值是10KHz，Clock Stretching的最大时间值也有限制

• 地址回应(Address Acknowledge) 一个I2C设备接收到它的设备地址后，是否必须发出回应信号？

• I2C协议：没有强制要求必须发出回应信号

• SMBus：强制要求必须发出回应信号，这样对方才知道该设备的状态：busy，failed，或是被移除了

• SMBus协议明确了数据的传输格式

• I2C协议：它只定义了怎么传输数据，但是并没有定义数据的格式，这完全由设备来定义

• SMBus：定义了几种数据格式(后面分析)

• REPEATED START Condition(重复发出S信号)

• 比如读EEPROM时，涉及2个操作：

• 把存储地址发给设备

• 读数据

• 在写、读之间，可以不发出P信号，而是直接发出S信号：这个S信号就是REPEATED START

• 如下图所示

• SMBus Low Power Version

• SMBus也有低功耗的版本

2.2 SMBus协议分析

symbols(符号)

S     (1 bit) : Start bit(开始位)
Sr    (1 bit) : 重复的开始位
P     (1 bit) : Stop bit(停止位)
R/W#  (1 bit) : Read/Write bit. Rd equals 1, Wr equals 0.(读写位)
A, N  (1 bit) : Accept and reverse accept bit.(回应位)
Address(7 bits): I2C 7 bit address. Note that this can be expanded as usual to
                get a 10 bit I2C address.
                (地址位，7位地址)
Command Code  (8 bits): Command byte, a data byte which often selects a register on
                the device.
                (命令字节，一般用来选择芯片内部的寄存器)
Data Byte (8 bits): A plain data byte. Sometimes, I write DataLow, DataHigh
                for 16 bit data.
                (数据字节，8位；如果是16位数据的话，用2个字节来表示：DataLow、DataHigh)
Count (8 bits): A data byte containing the length of a block operation.
        (在block操作总，表示数据长度)
[..]:           Data sent by I2C device, as opposed to data sent by the host
                adapter.
                (中括号表示I2C设备发送的数据，没有中括号表示host adapter发送的数据)

SMBus Quick Command

只是用来发送一位数据：R/W#本意是用来表示读或写，但是在SMBus里可以用来表示其他含义。比如某些开关设备，可以根据这一位来决定是打开还是关闭。

Functionality flag: I2C_FUNC_SMBUS_QUICK

SMBus Receive Byte

I2C-tools中的函数：i2c_smbus_read_byte()。

读取一个字节，Host adapter接收到一个字节后不需要发出回应信号(上图中N表示不回应)。

Functionality flag: I2C_FUNC_SMBUS_READ_BYTE

SMBus Send Byte

I2C-tools中的函数：i2c_smbus_write_byte()。 发送一个字节。

1	Functionality flag: I2C_FUNC_SMBUS_WRITE_BYTE

SMBus Read Byte

I2C-tools中的函数：i2c_smbus_read_byte_data()。

先发出Command Code(它一般表示芯片内部的寄存器地址)，再读取一个字节的数据。 上面介绍的SMBus Receive Byte是不发送Comand，直接读取数据。

Functionality flag: I2C_FUNC_SMBUS_READ_BYTE_DATA

SMBus Read Word

I2C-tools中的函数：i2c_smbus_read_word_data()。

先发出Command Code(它一般表示芯片内部的寄存器地址)，再读取2个字节的数据。

Functionality flag: I2C_FUNC_SMBUS_READ_WORD_DATA

SMBus Write Byte

I2C-tools中的函数：i2c_smbus_write_byte_data()。

先发出Command Code(它一般表示芯片内部的寄存器地址)，再发出1个字节的数据。

Functionality flag: I2C_FUNC_SMBUS_WRITE_BYTE_DATA

SMBus Write Word

I2C-tools中的函数：i2c_smbus_write_word_data()。

先发出Command Code(它一般表示芯片内部的寄存器地址)，再发出1个字节的数据。

Functionality flag: I2C_FUNC_SMBUS_WRITE_WORD_DATA

SMBus Block Read

I2C-tools中的函数：i2c_smbus_read_block_data()。

先发出Command Code(它一般表示芯片内部的寄存器地址)，再发起度操作：

• 先读到一个字节(Block Count)，表示后续要读的字节数

• 然后读取全部数据

Functionality flag: I2C_FUNC_SMBUS_READ_BLOCK_DATA

SMBus Block Write

I2C-tools中的函数：i2c_smbus_write_block_data()。

先发出Command Code(它一般表示芯片内部的寄存器地址)，再发出1个字节的Byte Conut(表示后续要发出的数据字节数)，最后发出全部数据。

Functionality flag: I2C_FUNC_SMBUS_WRITE_BLOCK_DATA

I2C Block Read

在一般的I2C协议中，也可以连续读出多个字节。 它跟SMBus Block Read的差别在于设备发出的第1个数据不是长度N，如下图所示：

I2C-tools中的函数：i2c_smbus_read_i2c_block_data()。

先发出Command Code(它一般表示芯片内部的寄存器地址)，再发出1个字节的Byte Conut(表示后续要发出的数据字节数)，最后发出全部数据。

Functionality flag: I2C_FUNC_SMBUS_READ_I2C_BLOCK

I2C Block Write

在一般的I2C协议中，也可以连续发出多个字节。 它跟SMBus Block Write的差别在于发出的第1个数据不是长度N，如下图所示：

I2C-tools中的函数：i2c_smbus_write_i2c_block_data()。

先发出Command Code(它一般表示芯片内部的寄存器地址)，再发出1个字节的Byte Conut(表示后续要发出的数据字节数)，最后发出全部数据。

Functionality flag: I2C_FUNC_SMBUS_WRITE_I2C_BLOCK

SMBus Block Write - Block Read Process Call

先写一块数据，再读一块数据。

Functionality flag: I2C_FUNC_SMBUS_BLOCK_PROC_CALL

Packet Error Checking (PEC)

PEC是一种错误校验码，如果使用PEC，那么在P信号之前，数据发送方要发送一个字节的PEC码(它是CRC-8码)。

以SMBus Send Byte为例，下图中，一个未使用PEC，另一个使用PEC：

3. 数据结构

soc中的iic控制器与挂载在iic总线上的设备的拓扑图如下：

3.1 bus_type

iic也是一个总线设备，linux启动阶段会创建一个iic总线i2c_bus_type，该总线用于管理i2c_client设备和i2c_driver驱动。这里不必多说，该结构跟linux驱动之设备模型里的总线相同，这里实现了它自己的match和probe函数，这些后面再说。

3.2 i2c_adapter

每个soc内部都有自己的iic控制器，一般会有多个iic控制器，i2c_adapter结构体就是用于描述iic控制器的结构体（就是iic controler），结构体里的nr用于表述该控制器是第几个控制器例如iic-0，iic-1等这里面有一个最重要的结构就是i2c_algorithm，该结构是具体controler的实际iic传输实现，对于不同的平台iic的内部设计一般是不同的，那么通过该结构来提供统一的接口给其他模块调用，而具体的差异由具体的平台实现自己的i2c_algorithm。该部分驱动一般由soc厂商编写。

3.4 i2c_client

iic下会挂载一个或多个设备，每个设备的信息由i2c_client结构体描述，例如设备地址等信息。该结构体还有一个指针指向i2c_adapter，表示该设备挂载在哪个iic controler下以便在iic通信的时候通过i2c_adapter提供的i2c_algorithm提供的接口完成实际的数据传输。

3.5 i2c_driver

iic下挂载的设备例如tp、温湿度传感器等设备的驱动由该数据结构来描述，这个是我们实际编写驱动中最常用的，通过iic驱动具体的挂载在iic总线上的设备。i2c_driver跟i2c_client匹配成功后，就调用i2c_driver.probe函数。

3.6 i2c_msg

有了iic设备和iic驱动了，iic是通信总线，那就是要用来传输消息的，还有一个描述具体消息的结构体就是i2c_msg，该结构体描述了消息方向，传输地址，消息长度以及消息本身内容。

下面将这些数据结构之间的关系通过一张图来展示，如下图：

可以看到我们的iic驱动也是使用之前描述的设备驱动模型，bus下挂载链条结构一个挂载设备一个挂载驱动通过总线提供的match函数进行匹配实现device找到device_driver或则device_driver找到要驱动的device然后，在match成功后通过总线的probe函数调用到驱动的probe函数，实际驱动开发人员只需要填充i2c_driver结构体并将其注册到总线就可以了。区别在于iic总线是一个具体实实在在的总线，soc内部有iic控制器，通过i2c_adapter描述提供统一的接口，i2c_driver通过i2c_adapter提供的iic传输函数来操作i2c_client设备，这就是iic总线驱动的整体框架了。

4. 流程分析

i2c_register_adapter函数流程如下：

这里面有一个函数i2c_detect需要注意，该函数会遍历总线下的每一个i2c_driver并调用i2c_driver的detect函数，具体的i2c_driver的detect函数由具体的驱动实现。

i2c_register_driver函数流程如下：

i2c_driver同adapt的注册有一些相同的流程，其中detect函数就是其中之一，注册i2c_driver的时候也会遍历bus下的i2c_driver并调用相应的detect函数。