- 🍇 博主主页： 【Systemcall小酒屋】
- 🍇 博主追寻：热衷于用简单的案例讲述复杂的技术，“假传万卷书，真传一案例”，这是林群院士说过的一句话，另外“成就是最好的老师”，技术既要沉淀，也得分享，成就感的正反馈是支持我持续耕耘的动力！
- 🍇 专栏目录： 【Firefly-RK356x板卡】
- 🍇 专栏说明：基于Firefly旗下的RK356x板卡进行入门篇讲述，欢迎订阅，博主会持续更新！
文章目录
- 一、I2C 使用情况
- 二、定义和注册 I2C 设备
- 三、定义和注册 I2C 驱动
- 3.1 I2C 驱动定义
- 3.2 I2C 驱动注册
- 3.3 通过 I2C 收发数据
配置 I2C 可分为两大步骤：
- 定义和注册 I2C 设备
- 定义和注册 I2C 驱动
下面以配置 GSL3680 为例。GSL3680是一款电容屏多点触摸控制单芯片。
一、I2C 使用情况
ROC-RK3568-PC开发板上有 6 个片上 I2C 控制器，各个 I2C 的使用情况如下表：
| Port | Pin name | Device |
|---|---|---|
| I2C0 | GPIO0_B1/I2C0_SCL GPIO0_B2/I2C0_SDA | RK809 |
| I2C1 | GPIO0_B3/I2C1_SCL GPIO0_B4/I2C1_SDA | TP |
| I2C2_M0 | GPIO0_B5/I2C2_SCL_M0 GPIO0_B6/I2C2_SDA_M0 | 复用为其他功能 |
| I2C2_M1 | GPIO4_B5/I2C2_SCL_M1 GPIO4_B4/I2C2_SDA_M1 | 复用为其他功能 |
| I2C3_M0 | GPIO1_A1/I2C3_SCL_M0 GPIO1_A0/I2C3_SDA_M0 | BAT |
| I2C3_M1 | GPIO3_B5/I2C3_SCL_M1 GPIO3_B6/I2C3_SDA_M1 | 复用为其他功能 |
| I2C4_M0 | GPIO4_B3/I2C4_SCL_M0 GPIO4_B2/I2C4_SDA_M0 | TP |
| I2C4_M1 | GPIO2_B2/I2C4_SCL_M1 GPIO2_B1/I2C4_SDA_M1 | 复用为其他功能 |
| I2C5_M0 | GPIO3_B3/I2C5_SCL_M0 GPIO3_B4/I2C5_SDA_M0 | MC3230/HYM8563 |
| I2C5_M1 | GPIO4_C7/I2C5_SCL_M1 GPIO4_D0/I2C5_SDA_M1 | 复用为其他功能 |
二、定义和注册 I2C 设备
在注册 I2C 设备时，需要结构体 i2c_client 来描述 I2C 设备。在标准 Linux 中，用户只需要提供相应的 I2C 设备信息，Linux 就会根据所提供的信息构造 i2c_client 结构体。
I2C 设备信息以节点的形式写到 DTS 文件中，例如 I2C2 总线：
// kernel/arch/arm64/boot/dts/rockchip/rk3566-firefly-aioj-lvds-HSX101H40C.dts
&i2c2 {status = "okay";clock-frequency = <100000>; // i2c频率：10kHz//i2c-scl-rising-time-ns = <800>; // 上降沿800ns//i2c-scl-falling-time-ns = <100>; // 下降沿100nsgslx680: gslx680@41 {compatible = "gslX680";reg = <0x41>; // i2c地址screen_max_x = <800>;screen_max_y = <1280>;touch-gpio = <&gpio0 RK_PC5 IRQ_TYPE_LEVEL_LOW>;reset-gpio = <&gpio0 RK_PC1 GPIO_ACTIVE_HIGH>;flip-x = <1>;flip-y = <0>;swap-xy = <0>;gsl,fw = <1>;};
};
三、定义和注册 I2C 驱动
3.1 I2C 驱动定义
在定义 I2C 驱动之前，用户首先要定义变量 of_device_id 和 i2c_device_id。
of_device_id 用于在驱动中调用 DTS 文件中定义的设备信息，其定义如下所示：
static struct of_device_id gsl_ts_ids[] = {{.compatible = "gslX680"},{}};
定义变量 i2c_device_id：
static const struct i2c_device_id gsl_ts_id[] = {{GSLX680_I2C_NAME, 0},{}};MODULE_DEVICE_TABLE(i2c, gsl_ts_id);
I2C 驱动定义 i2c_driver 如下所示：
static struct i2c_driver gsl_ts_driver = {.driver = { .name = GSLX680_I2C_NAME,.owner = THIS_MODULE,.of_match_table = of_match_ptr(gsl_ts_ids),},#ifndef CONFIG_HAS_EARLYSUSPEND//.suspend = gsl_ts_suspend,//.resume = gsl_ts_resume,#endif.probe = gsl_ts_probe,.remove = gsl_ts_remove,.id_table = gsl_ts_id,};
变量 id_table 指示该驱动所支持的设备。
3.2 I2C 驱动注册
使用 i2c_add_driver 函数注册 I2C 驱动。
i2c_add_driver(&gsl_ts_driver);
在调用 i2c_add_driver 注册 I2C 驱动时，会遍历 I2C 设备，如果该驱动支持所遍历到的设备，则会调用该驱动的 probe 函数。
3.3 通过 I2C 收发数据
- 向从机发送信息：
int i2c_master_send(const 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);/** If everything went ok (i.e. 1 msg transmitted), return #bytes* transmitted, else error code.*/return (ret == 1) ? count : ret;}
- 向从机读取信息：
int i2c_master_recv(const struct i2c_client *client, 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.flags |= I2C_M_RD;msg.len = count;msg.buf = buf;ret = i2c_transfer(adap, &msg, 1);/** If everything went ok (i.e. 1 msg received), return #bytes received,* else error code.*/return (ret == 1) ? count : ret;}EXPORT_SYMBOL(i2c_master_recv);
