[ROC-RK3568-PC] [Firefly-Android] 10min带你了解I2C的使用

时间：2022-10-21 01:00:35


  • ???? 博主主页： 【​​Systemcall小酒屋​​】
  • ???? 博主追寻：热衷于用简单的案例讲述复杂的技术，“假传万卷书，真传一案例”，这是林群院士说过的一句话，另外“成就是最好的老师”，技术既要沉淀，也得分享，成就感的正反馈是支持我持续耕耘的动力！
  • ???? 专栏目录： 【​​Firefly-RK356x板卡​​】
  • ???? 专栏说明：基于Firefly旗下的RK356x板卡进行入门篇讲述，欢迎订阅，博主会持续更新！

[ROC-RK3568-PC] [Firefly-Android] 10min带你了解I2C的使用

文章目录

  • ​​一、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>; // 下降沿100ns
    gslx680: 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);


标签：

相关文章