内核驱动 i2c-mux-gpio

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

描述

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

例如：

 ----------              ----------  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。

例如，对于一个通过 3 个 GPIO 引脚控制的提供 4 个总线段的 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 引脚号，这甚至是唯一的选择。