驱动篇：Linux 的 I2C设备驱动（二）（摘录）

驱动篇：Linux 的 I2C设备驱动（二）

Linux I 2 C 核心
I 2 C 核心(drivers/i2c/i2c-core.c)中提供了一组不依赖于硬件平台的接口函数,这个文件一般不需要被工程师修改,但是理解其中的主要函数非常关键,因为 I 2 C 总线驱动和设备驱动之间依赖于 I 2 C 核心作为纽带。
(1)增加/删除 i2c_adapter

int i2c_add_adapter(struct i2c_adapter *adap);
int i2c_del_adapter(struct i2c_adapter *adap);

(2)增加/删除 i2c_driver。

int i2c_register_driver(struct module *owner, struct *driver);
int i2c_del_driver(struct i2c_driver *driver);
inline int i2c_add_driver(struct i2c_driver *driver);

(3)i2c_client 依附/脱离。

int i2c_attach_client(struct i2c_client *client);
int i2c_detach_client(struct i2c_client *client);

当一个具体的 client 被侦测到并被关联的时候,设备和 sysfs 文件将被注册。相反地,在 client 被取消关联的时候,sysfs 文件和设备也被注销,如代码清单 15.6 所示。

I 2 C 核心的 client attach/detach 函数

int i2c_attach_client(struct i2c_client *client)
{
...
device_register(&client->dev);
device_create_file(&client->dev, &dev_attr_client_name);
return 0;
}
int i2c_detach_client(struct i2c_client *client)
{
...
device_remove_file(&client->dev, &dev_attr_client_name);
device_unregister(&client->dev);
...
}

(4)I 2 C 传输、发送和接收

int i2c_transfer(struct i2c_adapter * adap, struct i2c_msg *msgs, int num);
int i2c_master_send(struct i2c_client *client,const char *buf ,int count);
int i2c_master_recv(struct i2c_client *client, char *buf ,int count);

i2c_transfer() 函 数 用 于 进 行 I 2 C 适 配 器 和 I 2 C 设 备 之 间 的 一 组 消 息 交 互 ,i2c_master_send()函数和 i2c_master_recv()函数内部会调用 i2c_transfer()函数分别完成一条写消息和一条读消息
i2c_master_send 函数

int i2c_master_send(struct i2c_client *client,const char *buf ,int count)
 {
 int ret;
 struct i2c_adapter *adap=client->adapter;
 struct i2c_msg msg;
/*构造一个写消息*/
 msg.addr = client->addr;
 msg.flags = client->flags & I2C_M_TEN;
 msg.len = count;
 msg.buf = (char *)buf;
 /*传输消息*/
 ret = i2c_transfer(adap, &msg, 1);
return (ret == 1) ? count : ret;
 }

i2c_master_recv 函数

int i2c_master_recv(struct i2c_client *client, char *buf ,int count)
 {
 struct i2c_adapter *adap=client->adapter;
 struct i2c_msg msg;
 int ret;
 /*构造一个读消息*/
 msg.addr = client->addr;
 msg.flags = client->flags & I2C_M_TEN;
 msg.flags |= I2C_M_RD;
 msg.len = count;
 msg.buf = buf;
 /*传输消息*/
ret = i2c_transfer(adap, &msg, 1);
 /* 成功(1 条消息被处理), 返回读的字节数 */
 return (ret == 1) ? count : ret;
 }

i2c_transfer()函数本身不具备驱动适配器物理硬件完成消息交互的能力, 它只是寻找到 i2c_adapter 对应的 i2c_algorithm,并使用 i2c_algorithm 的 master_xfer()函数真正驱动硬件流程

int i2c_transfer(struct i2c_adapter * adap, struct i2c_msg *msgs, int num)
 {
int ret;
 if (adap->algo->master_xfer) {
 down(&adap->bus_lock);
 ret = adap->algo->master_xfer(adap,msgs,num); /* 消息传输 */
 up(&adap->bus_lock);
 return ret;

} else {
 dev_dbg(&adap->dev, "I2C level transfers not supported\n");
 return -ENOSYS;
}
}

(5)I 2 C 控制命令分配
下面函数有助于将发给 I 2 C 适配器设备文件 ioctl 的命令分配给对应适配器的algorithm 的 algo_control()函数或 i2c_driver 的 command()函数

int i2c_control(struct i2c_client *client, unsigned int cmd, unsigned
long arg);
void i2c_clients_command(struct i2c_adapter *adap, unsigned int cmd,
void *arg);