内核驱动 i2c-mux-gpio

作者:Peter Korsgaard <peter.korsgaard@barco.com>

描述

i2c-mux-gpio 是一个 i2c 多路复用器驱动程序,提供从主 I2C 总线和通过 GPIO 引脚控制的硬件 MUX 访问 I2C 总线段的能力。

例如。

 ----------              ----------  Bus segment 1   - - - - -
|          | SCL/SDA    |          |-------------- |           |
|          |------------|          |
|          |            |          | Bus segment 2 |           |
|  Linux   | GPIO 1..N  |   MUX    |---------------   Devices
|          |------------|          |               |           |
|          |            |          | Bus segment M
|          |            |          |---------------|           |
 ----------              ----------                  - - - - -

主 I2C 总线的 SCL/SDA 根据 GPIO 引脚 1..N 的设置复用到总线段 1..M。

用法

i2c-mux-gpio 使用平台总线,因此您需要提供一个 struct platform_device,其中 platform_data 指向一个 struct i2c_mux_gpio_platform_data,其中包含主总线的 I2C 适配器号、要创建的总线段数以及用于控制它的 GPIO 引脚。 有关详细信息,请参见 include/linux/platform_data/i2c-mux-gpio.h。

例如,像这样提供 4 个总线段,通过 3 个 GPIO 引脚控制的 MUX

#include <linux/platform_data/i2c-mux-gpio.h>
#include <linux/platform_device.h>

static const unsigned myboard_gpiomux_gpios[] = {
      AT91_PIN_PC26, AT91_PIN_PC25, AT91_PIN_PC24
};

static const unsigned myboard_gpiomux_values[] = {
      0, 1, 2, 3
};

static struct i2c_mux_gpio_platform_data myboard_i2cmux_data = {
      .parent         = 1,
      .base_nr        = 2, /* optional */
      .values         = myboard_gpiomux_values,
      .n_values       = ARRAY_SIZE(myboard_gpiomux_values),
      .gpios          = myboard_gpiomux_gpios,
      .n_gpios        = ARRAY_SIZE(myboard_gpiomux_gpios),
      .idle           = 4, /* optional */
};

static struct platform_device myboard_i2cmux = {
      .name           = "i2c-mux-gpio",
      .id             = 0,
      .dev            = {
              .platform_data  = &myboard_i2cmux_data,
      },
};

如果在注册时您不知道绝对 GPIO 引脚编号,则可以提供芯片名称 (.chip_name) 和相对 GPIO 引脚编号,i2c-mux-gpio 驱动程序将为您完成这项工作,包括在 GPIO 芯片未立即可用时进行延迟探测。

设备注册

注册 i2c-mux-gpio 设备时,应将它使用的任何 GPIO 引脚的数量作为设备 ID 传递。 这保证了每个实例都有一个不同的 ID。

或者,如果您不需要稳定的设备名称,您可以简单地将 PLATFORM_DEVID_AUTO 作为设备 ID 传递,平台核心会将动态 ID 分配给您的设备。 如果您在注册时不知道绝对 GPIO 引脚编号,这甚至是唯一的选择。