i2c buss(i2c-core.c)

I2C Bus(i2c-core.c)

 i2c_device_probe(struct device *dev)i2c_device_remove(struct device *dev)i2c_device_shutdown(struct device *dev) static const struct dev_pm_ops i2c_device_pm_ops = {

        .suspend = i2c_device_pm_suspend,

        .resume = i2c_device_pm_resume,

        .freeze = i2c_device_pm_freeze,

        .thaw = i2c_device_pm_thaw,

        .poweroff = i2c_device_pm_poweroff,

        .restore = i2c_device_pm_restore,

        SET_RUNTIME_PM_OPS(

                pm_generic_runtime_suspend,

                pm_generic_runtime_resume,

                NULL

        )

};

 struct bus_type i2c_bus_type = {

        .name           = "i2c",

        .match          = i2c_device_match,

        .probe          = i2c_device_probe,

        .remove         = i2c_device_remove,

        .shutdown       = i2c_device_shutdown,

        .pm             = &i2c_device_pm_ops,

};

 i2c_check_addr_validity(unsigned short addr)i2c_check_addr_busy(struct i2c_adapter *adapter, int addr) i2c_lock_adapter(struct i2c_adapter *adapter)i2c_trylock_adapter(struct i2c_adapter *adapter)i2c_unlock_adapter(struct i2c_adapter *adapter) i2c_dev_set_name(struct
i2c_adapter *adap,struct i2c_client *client) i2c_new_device(struct i2c_adapter *adap, struct i2c_board_info const *info): instantiate an i2c device i2c_sysfs_delete_device and i2c_sysfs_new_device: there are "new_device" and "delete_device" node that we can
use to create one new i2c_client or delete it.for example:echo "i2c_example 34" > new_devicethere will be "0-0022/" directory be createdecho "34" > delete_devicethe "0-0022/" directory will be removed of_i2c_register_devices(struct i2c_adapter *adap) of_find_i2c_device_by_node(struct
device_node *node)of_find_i2c_adapter_by_node(struct device_node *node) i2c_register_adapter(struct i2c_adapter *adap) i2c_add_adapter(struct i2c_adapter *adapter):declare i2c adapter, use dynamic bus number i2c_add_numbered_adapter(struct i2c_adapter *adap):declare
i2c adapter, use static bus number i2c_del_adapter(struct i2c_adapter *adap): unregister I2C adapter i2c_register_driver(struct module *owner, struct i2c_driver *driver): register one i2c_driver i2c_del_driver(struct i2c_driver *driver): unregister I2C driver.

i2c_use_client(struct i2c_client *client): increments the reference count of the i2c client structure

i2c_release_client(struct i2c_client *client):release a use of the i2c client structure

struct i2c_cmd_arg {

        unsigned        cmd;

        void            *arg;

};

i2c_cmd:

i2c_clients_command: send command to adapter's every client and do the responding i2c_driver's command interface.

i2c_init: register bus: i2c_bus_type

i2c_exit: unregister bus: i2c_bus_type

the functional interface to the i2c busses.

__i2c_transfer:unlocked flavor of i2c_transfer

i2c_transfer(struct i2c_adapter *adap, struct i2c_mst *msgs, int num):execute a single or combined I2C message

i2c_master_send(const struct i2c_client *client, char *buf, int count):issue a single I2C message in master transmit mode

i2c_master_recv(const struct i2c_client *client, char *buf, int count): issue a single I2C message in master receive mode, specially there is a flag I2C_M_RD.

i2c_adapter_id: return adapter's nr.

i2c_detect(struct i2c_adapter *adapter, struct i2c_driver *driver):

i2c_check_addr_busy(struct i2c_adapter *adapter, int addr): check if the addr have already been assigned to one client of adapter's client list.

i2c_check_addr_validity: as 0x0~0x7 and 0x78~0x7f is revered, so addr must not in those range.

i2c_new_probed_device(struct i2c_adapter *adap, struct i2c_board_info *info, unsigned short const *addr_list, int (*probe)(struct i2c_adapter *, unsigned short addr)): try select a valid addr from address list to add a new i2c_client.

i2c_get_adapter: give adapter's number to get the adapter and do moudle_get to increase its reference

i2c_put_adapter: decrease its reference

For new i2c driver added:

use platform bus to register the device and match the driver's probe.

in the probe:

i2c_add_numbered_adapter(adap); // but assign new i2c_algorithm with .master_xfer and .functionality be assigned

the i2c driver mainly implement the master_xfer and supply some PM functions