如何實例化i2c設備？4種方式如下：

• 方法1:靜態聲明I2C設備
  • 通過devicetree聲明I2C設備
  • 在板級文件中聲明I2C設備
• 方法2:顯式實例化設備
• 方法3:對某些設備的I2C總線進行探測
• 方法4:從用戶空間實例化

在本篇中，主要看一下方法1，3和方法4。對于方法2，在下一篇的一個I2C ADC/DAC的misc設備驅動實例中再加以詳述。

通過devicetree聲明I2C設備

/dts-v1/;
/plugin/;
/ {
       compatible = "brcm,bcm2835", "brcm,bcm2708", "brcm,bcm2709";




       fragment@0 {
          target = < &i2c1 >;
          __overlay__ {
                #address-cells = < 1 >;
                #size-cells = < 0 >;
                rtc@68 {
                        compatible = "maxim,ds3231";
                        reg = < 0x68 >;
                        #address-cells = < 2 >;
                        #size-cells = < 1 >;
                };      
          };
       };
    };

首先，寫一個dts。

編譯，并將生成的.dtbo到/boot/overlays

重啟后，查看/dev可以看到rtc

通過板級文件中聲明I2C設備

在架構板級文件中添加i2c設備信息，并注冊到特定位置?？匆粋€nxp imx開發板的電源芯片的實例，arch/arm/mach-imx/mach-mx35_3ds.c

static struct mc13xxx_platform_data mx35_3ds_mc13892_data = {
    .flags = MC13XXX_USE_RTC | MC13XXX_USE_TOUCHSCREEN,
    .regulators = {
        .num_regulators = ARRAY_SIZE(mx35_3ds_regulators),
        .regulators = mx35_3ds_regulators,
    },
};




#define GPIO_PMIC_INT IMX_GPIO_NR(2, 0)




static struct i2c_board_info mx35_3ds_i2c_mc13892 = {




    I2C_BOARD_INFO("mc13892", 0x08),
    .platform_data = &mx35_3ds_mc13892_data,
    /* irq number is run-time assigned */
};




static void __init imx35_3ds_init_mc13892(void)
{
    int ret = gpio_request_one(GPIO_PMIC_INT, GPIOF_DIR_IN, "pmic irq");




    if (ret) {
        pr_err("failed to get pmic irq: %dn", ret);
        return;
    }




    mx35_3ds_i2c_mc13892.irq = gpio_to_irq(GPIO_PMIC_INT);
    i2c_register_board_info(0, &mx35_3ds_i2c_mc13892, 1);
}

MC13892是面向i.MX51、i.MX37、i.MX3和i.MX27應用處理器的PMIC。在板級文件中定義了一個 i2c_board_info 結構體，使用i2c_register_board_info函數將i2c設備信息添加到特定鏈表。

i2c_register_board_info在/drivers/i2c/i2c-boardinfo.c中：

/**
* i2c_register_board_info - statically declare I2C devices
* @busnum: identifies the bus to which these devices belong
* @info: vector of i2c device descriptors
* @len: how many descriptors in the vector; may be zero to reserve
*    the specified bus number.
*
* Systems using the Linux I2C driver stack can declare tables of board info
* while they initialize.  This should be done in board-specific init code
* near arch_initcall() time, or equivalent, before any I2C adapter driver is
* registered.  For example, mainboard init code could define several devices,
* as could the init code for each daughtercard in a board stack.
*
* The I2C devices will be created later, after the adapter for the relevant
* bus has been registered.  After that moment, standard driver model tools
* are used to bind "new style" I2C drivers to the devices.  The bus number
* for any device declared using this routine is not available for dynamic
* allocation.
*
* The board info passed can safely be __initdata, but be careful of embedded
* pointers (for platform_data, functions, etc) since that won't be copied.
* Device properties are deep-copied though.
*/
int i2c_register_board_info(int busnum, struct i2c_board_info const *info, unsigned len)

對某些設備的I2C總線進行探測

有時沒有關于I2C設備的足夠信息，甚至無法調用i2c_new_scanned_device()。典型的例子是PC主板上的硬件監控芯片。有幾十個模型，可能被分配在25個不同的地址。考慮到主板的龐大數量，幾乎不可能建立一個正在使用的硬件監控芯片的詳盡列表。幸運的是，大多數這些芯片都有制造商和設備ID寄存器，因此可以通過探測來識別它們。

在這種情況下，I2C設備既沒有顯式聲明也沒有實例化。相反，一旦這些設備的驅動程序被加載，I2C -core就會探測它們，如果找到了，就會自動實例化一個I2C設備。為了防止此機制的任何不當行為，適用以下限制:

• I2C設備驅動程序必須實現detect()方法，該方法通過從任意寄存器讀取來識別受支持的設備。
• 只有那些可能有支持設備并同意被探測的總線才會被探測。例如，這避免了探測電視適配器上的硬件監控芯片。

detect何時調用？

i2c_driver注冊的時候，i2c_core會在所有已經注冊的i2c_adapter上探測address_list中的所有地址，硬件探測成功之后后調用i2c_driver的detect成員，然后根據detect填充的info建立一個i2c_client。

例如，MAX1668溫度傳感器的驅動實現，/drivers/hwmon/max1668.c

static struct i2c_driver max1668_driver = {
    .class = I2C_CLASS_HWMON,
    .driver = {
          .name    = "max1668",
          },
    .probe = max1668_probe,
    .id_table = max1668_id,
    .detect    = max1668_detect,
    .address_list = max1668_addr_list,
};




module_i2c_driver(max1668_driver);

其中，detect函數

/* Return 0 if detection is successful, -ENODEV otherwise */
static int max1668_detect(struct i2c_client *client,
              struct i2c_board_info *info)
{
    struct i2c_adapter *adapter = client- >adapter;
    const char *type_name;
    int man_id, dev_id;




    if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_BYTE_DATA))
        return -ENODEV;




    /* Check for unsupported part */
    man_id = i2c_smbus_read_byte_data(client, MAX1668_REG_MAN_ID);
    if (man_id != MAN_ID_MAXIM)
        return -ENODEV;




    dev_id = i2c_smbus_read_byte_data(client, MAX1668_REG_DEV_ID);
    if (dev_id < 0)
        return -ENODEV;




    type_name = NULL;
    if (dev_id == DEV_ID_MAX1668)
        type_name = "max1668";
    else if (dev_id == DEV_ID_MAX1805)
        type_name = "max1805";
    else if (dev_id == DEV_ID_MAX1989)
        type_name = "max1989";




    if (!type_name)
        return -ENODEV;




    strlcpy(info- >type, type_name, I2C_NAME_SIZE);




    return 0;
}

以樹莓派為例，i2c_add_adapter會在bcm2835_i2c_probe調用

static int bcm2835_i2c_probe(struct platform_device *pdev)

在i2c_register_adapter 中會調用，bus_for_each_drv 來來通知所有總線類型是i2c_bus_type的driver。

/* Notify drivers */
    mutex_lock(&core_lock);
    bus_for_each_drv(&i2c_bus_type, NULL, adap, __process_new_adapter);
    mutex_unlock(&core_lock);

static int __process_new_adapter(struct device_driver *d, void *data)
{
    return i2c_do_add_adapter(to_i2c_driver(d), data);
}

在i2c_do_add_adapter->i2c_detect->i2c_detect_address 中有一段關鍵code

err = driver- >detect(temp_client, &info);
    if (err) {
        /* -ENODEV is returned if the detection fails. We catch it
           here as this isn't an error. */
        return err == -ENODEV ? 0 : err;
    }

從用戶空間實例化

用戶空間通過兩個sysfs屬性文件來建立和刪除i2c_client：new_device和delete_device。

• new_device有兩個參數：i2c設備的名字（字符串）和地址（以0x開頭的16進制數）。
• delete_device只有一個參數：設備的地址。

pi@raspberrypi:/sys/class/i2c-adapter/i2c-1 $ ls
delete_device  device  i2c-dev  name  new_device  of_node  power  subsystem  uevent

添加rtc設備

pi@raspberrypi:/sys/class/i2c-adapter/i2c-1 $ echo ds3231 0x68 | sudo tee new_device 
ds3231 0x68

方法2:顯式實例化設備，在下一篇"在Linux系統里如何編寫一個PCF8591的驅動，完成ADC數據采集，DAC數據輸出"中再詳述。

PCF8591 是一個單片集成、單獨供電、低功耗、8-bit CMOS數據獲取器件。PCF8591 具有 4 個模擬輸入、1 個模擬輸出和 1個串行 I2C 總線接口。

PCF8591 的 3 個地址引腳 A0, A1 和 A2 可用于硬件地址編程，允許在同個 I2C 總線上接入 8 個 PCF8591 器件，而無需額外的硬件。在 PCF8591 器件上輸入輸出的地址、控制和數據信號都是通過雙線雙向 I2C 總線以串行的方式進行傳輸。