- Update to 2.6.25-rc3.
[linux-flexiantxendom0-3.2.10.git] / include / linux / i2c.h
index a100c9f..365e0df 100644 (file)
@@ -140,7 +140,6 @@ struct i2c_driver {
        int (*command)(struct i2c_client *client,unsigned int cmd, void *arg);
 
        struct device_driver driver;
-       struct list_head list;
 };
 #define to_i2c_driver(d) container_of(d, struct i2c_driver, driver)
 
@@ -155,12 +154,11 @@ struct i2c_driver {
  *     generic enough to hide second-sourcing and compatible revisions.
  * @adapter: manages the bus segment hosting this I2C device
  * @driver: device's driver, hence pointer to access routines
- * @usage_count: counts current number of users of this client
  * @dev: Driver model device node for the slave.
  * @irq: indicates the IRQ generated by this device (if any)
  * @driver_name: Identifies new-style driver used with this device; also
  *     used as the module name for hotplug/coldplug modprobe support.
- * @list: list of active/busy clients
+ * @list: list of active/busy clients (DEPRECATED)
  * @released: used to synchronize client releases & detaches and references
  *
  * An i2c_client identifies a single device (i.e. chip) connected to an
@@ -175,16 +173,16 @@ struct i2c_client {
        char name[I2C_NAME_SIZE];
        struct i2c_adapter *adapter;    /* the adapter we sit on        */
        struct i2c_driver *driver;      /* and our access routines      */
-       int usage_count;                /* How many accesses currently  */
-                                       /* to the client                */
        struct device dev;              /* the device structure         */
        int irq;                        /* irq issued by device (or -1) */
        char driver_name[KOBJ_NAME_LEN];
-       struct list_head list;
+       struct list_head list;          /* DEPRECATED */
        struct completion released;
 };
 #define to_i2c_client(d) container_of(d, struct i2c_client, dev)
 
+extern struct i2c_client *i2c_verify_client(struct device *dev);
+
 static inline struct i2c_client *kobj_to_i2c_client(struct kobject *kobj)
 {
        struct device * const dev = container_of(kobj, struct device, kobj);
@@ -261,15 +259,28 @@ i2c_new_probed_device(struct i2c_adapter *adap,
                      struct i2c_board_info *info,
                      unsigned short const *addr_list);
 
+/* For devices that use several addresses, use i2c_new_dummy() to make
+ * client handles for the extra addresses.
+ */
+extern struct i2c_client *
+i2c_new_dummy(struct i2c_adapter *adap, u16 address, const char *type);
+
 extern void i2c_unregister_device(struct i2c_client *);
 
 /* Mainboard arch_initcall() code should register all its I2C devices.
  * This is done at arch_initcall time, before declaring any i2c adapters.
  * Modules for add-on boards must use other calls.
  */
+#ifdef CONFIG_I2C_BOARDINFO
 extern int
 i2c_register_board_info(int busnum, struct i2c_board_info const *info, unsigned n);
-
+#else
+static inline int
+i2c_register_board_info(int busnum, struct i2c_board_info const *info, unsigned n)
+{
+       return 0;
+}
+#endif
 
 /*
  * The following structs are for those who like to implement new bus drivers:
@@ -319,8 +330,7 @@ struct i2c_adapter {
        struct device dev;              /* the adapter device */
 
        int nr;
-       struct list_head clients;
-       struct list_head list;
+       struct list_head clients;       /* DEPRECATED */
        char name[48];
        struct completion dev_released;
 };
@@ -357,10 +367,10 @@ static inline void i2c_set_adapdata (struct i2c_adapter *dev, void *data)
  * command line
  */
 struct i2c_client_address_data {
-       unsigned short *normal_i2c;
-       unsigned short *probe;
-       unsigned short *ignore;
-       unsigned short **forces;
+       const unsigned short *normal_i2c;
+       const unsigned short *probe;
+       const unsigned short *ignore;
+       const unsigned short * const *forces;
 };
 
 /* Internal numbers to terminate lists */
@@ -389,11 +399,8 @@ static inline int i2c_add_driver(struct i2c_driver *driver)
 extern int i2c_attach_client(struct i2c_client *);
 extern int i2c_detach_client(struct i2c_client *);
 
-/* Should be used to make sure that client-struct is valid and that it
-   is okay to access the i2c-client.
-   returns -ENODEV if client has gone in the meantime */
-extern int i2c_use_client(struct i2c_client *);
-extern int i2c_release_client(struct i2c_client *);
+extern struct i2c_client *i2c_use_client(struct i2c_client *client);
+extern void i2c_release_client(struct i2c_client *client);
 
 /* call the i2c_client->command() of all attached clients with
  * the given arguments */
@@ -405,7 +412,7 @@ extern void i2c_clients_command(struct i2c_adapter *adap,
  * specific address (unless a 'force' matched);
  */
 extern int i2c_probe(struct i2c_adapter *adapter,
-               struct i2c_client_address_data *address_data,
+               const struct i2c_client_address_data *address_data,
                int (*found_proc) (struct i2c_adapter *, int, int));
 
 extern struct i2c_adapter* i2c_get_adapter(int id);
@@ -598,104 +605,93 @@ I2C_CLIENT_MODULE_PARM(probe, "List of adapter,address pairs to scan "   \
                       "additionally");                                 \
 I2C_CLIENT_MODULE_PARM(ignore, "List of adapter,address pairs not to " \
                       "scan");                                         \
-static struct i2c_client_address_data addr_data = {                    \
+static const struct i2c_client_address_data addr_data = {              \
        .normal_i2c     = normal_i2c,                                   \
        .probe          = probe,                                        \
        .ignore         = ignore,                                       \
        .forces         = forces,                                       \
 }
 
+#define I2C_CLIENT_FORCE_TEXT \
+       "List of adapter,address pairs to boldly assume to be present"
+
 /* These are the ones you want to use in your own drivers. Pick the one
    which matches the number of devices the driver differenciates between. */
-#define I2C_CLIENT_INSMOD \
-  I2C_CLIENT_MODULE_PARM(force, \
-                      "List of adapter,address pairs to boldly assume " \
-                      "to be present"); \
-       static unsigned short *forces[] = {                             \
-                       force,                                          \
-                       NULL                                            \
-               };                                                      \
+#define I2C_CLIENT_INSMOD                                              \
+I2C_CLIENT_MODULE_PARM(force, I2C_CLIENT_FORCE_TEXT);                  \
+static const unsigned short * const forces[] = { force, NULL };                \
 I2C_CLIENT_INSMOD_COMMON
 
 #define I2C_CLIENT_INSMOD_1(chip1)                                     \
 enum chips { any_chip, chip1 };                                                \
-I2C_CLIENT_MODULE_PARM(force, "List of adapter,address pairs to "      \
-                      "boldly assume to be present");                  \
+I2C_CLIENT_MODULE_PARM(force, I2C_CLIENT_FORCE_TEXT);                  \
 I2C_CLIENT_MODULE_PARM_FORCE(chip1);                                   \
-static unsigned short *forces[] = { force, force_##chip1, NULL };      \
+static const unsigned short * const forces[] = { force,                \
+       force_##chip1, NULL };                                          \
 I2C_CLIENT_INSMOD_COMMON
 
 #define I2C_CLIENT_INSMOD_2(chip1, chip2)                              \
 enum chips { any_chip, chip1, chip2 };                                 \
-I2C_CLIENT_MODULE_PARM(force, "List of adapter,address pairs to "      \
-                      "boldly assume to be present");                  \
+I2C_CLIENT_MODULE_PARM(force, I2C_CLIENT_FORCE_TEXT);                  \
 I2C_CLIENT_MODULE_PARM_FORCE(chip1);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip2);                                   \
-static unsigned short *forces[] = { force, force_##chip1,              \
-                                   force_##chip2, NULL };              \
+static const unsigned short * const forces[] = { force,                \
+       force_##chip1, force_##chip2, NULL };                           \
 I2C_CLIENT_INSMOD_COMMON
 
 #define I2C_CLIENT_INSMOD_3(chip1, chip2, chip3)                       \
 enum chips { any_chip, chip1, chip2, chip3 };                          \
-I2C_CLIENT_MODULE_PARM(force, "List of adapter,address pairs to "      \
-                      "boldly assume to be present");                  \
+I2C_CLIENT_MODULE_PARM(force, I2C_CLIENT_FORCE_TEXT);                  \
 I2C_CLIENT_MODULE_PARM_FORCE(chip1);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip2);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip3);                                   \
-static unsigned short *forces[] = { force, force_##chip1,              \
-                                   force_##chip2, force_##chip3,       \
-                                   NULL };                             \
+static const unsigned short * const forces[] = { force,                \
+       force_##chip1, force_##chip2, force_##chip3, NULL };            \
 I2C_CLIENT_INSMOD_COMMON
 
 #define I2C_CLIENT_INSMOD_4(chip1, chip2, chip3, chip4)                        \
 enum chips { any_chip, chip1, chip2, chip3, chip4 };                   \
-I2C_CLIENT_MODULE_PARM(force, "List of adapter,address pairs to "      \
-                      "boldly assume to be present");                  \
+I2C_CLIENT_MODULE_PARM(force, I2C_CLIENT_FORCE_TEXT);                  \
 I2C_CLIENT_MODULE_PARM_FORCE(chip1);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip2);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip3);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip4);                                   \
-static unsigned short *forces[] = { force, force_##chip1,              \
-                                   force_##chip2, force_##chip3,       \
-                                   force_##chip4, NULL};               \
+static const unsigned short * const forces[] = { force,                \
+       force_##chip1, force_##chip2, force_##chip3,                    \
+       force_##chip4, NULL};                                           \
 I2C_CLIENT_INSMOD_COMMON
 
 #define I2C_CLIENT_INSMOD_5(chip1, chip2, chip3, chip4, chip5)         \
 enum chips { any_chip, chip1, chip2, chip3, chip4, chip5 };            \
-I2C_CLIENT_MODULE_PARM(force, "List of adapter,address pairs to "      \
-                      "boldly assume to be present");                  \
+I2C_CLIENT_MODULE_PARM(force, I2C_CLIENT_FORCE_TEXT);                  \
 I2C_CLIENT_MODULE_PARM_FORCE(chip1);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip2);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip3);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip4);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip5);                                   \
-static unsigned short *forces[] = { force, force_##chip1,              \
-                                   force_##chip2, force_##chip3,       \
-                                   force_##chip4, force_##chip5,       \
-                                   NULL };                             \
+static const unsigned short * const forces[] = { force,                        \
+       force_##chip1, force_##chip2, force_##chip3,                    \
+       force_##chip4, force_##chip5, NULL };                           \
 I2C_CLIENT_INSMOD_COMMON
 
 #define I2C_CLIENT_INSMOD_6(chip1, chip2, chip3, chip4, chip5, chip6)  \
 enum chips { any_chip, chip1, chip2, chip3, chip4, chip5, chip6 };     \
-I2C_CLIENT_MODULE_PARM(force, "List of adapter,address pairs to "      \
-                      "boldly assume to be present");                  \
+I2C_CLIENT_MODULE_PARM(force, I2C_CLIENT_FORCE_TEXT);                  \
 I2C_CLIENT_MODULE_PARM_FORCE(chip1);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip2);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip3);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip4);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip5);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip6);                                   \
-static unsigned short *forces[] = { force, force_##chip1,              \
-                                   force_##chip2, force_##chip3,       \
-                                   force_##chip4, force_##chip5,       \
-                                   force_##chip6, NULL };              \
+static const unsigned short * const forces[] = { force,                        \
+       force_##chip1, force_##chip2, force_##chip3,                    \
+       force_##chip4, force_##chip5, force_##chip6, NULL };            \
 I2C_CLIENT_INSMOD_COMMON
 
 #define I2C_CLIENT_INSMOD_7(chip1, chip2, chip3, chip4, chip5, chip6, chip7) \
 enum chips { any_chip, chip1, chip2, chip3, chip4, chip5, chip6,       \
             chip7 };                                                   \
-I2C_CLIENT_MODULE_PARM(force, "List of adapter,address pairs to "      \
-                      "boldly assume to be present");                  \
+I2C_CLIENT_MODULE_PARM(force, I2C_CLIENT_FORCE_TEXT);                  \
 I2C_CLIENT_MODULE_PARM_FORCE(chip1);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip2);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip3);                                   \
@@ -703,18 +699,16 @@ I2C_CLIENT_MODULE_PARM_FORCE(chip4);                                      \
 I2C_CLIENT_MODULE_PARM_FORCE(chip5);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip6);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip7);                                   \
-static unsigned short *forces[] = { force, force_##chip1,              \
-                                   force_##chip2, force_##chip3,       \
-                                   force_##chip4, force_##chip5,       \
-                                   force_##chip6, force_##chip7,       \
-                                   NULL };                             \
+static const unsigned short * const forces[] = { force,                        \
+       force_##chip1, force_##chip2, force_##chip3,                    \
+       force_##chip4, force_##chip5, force_##chip6,                    \
+       force_##chip7, NULL };                                          \
 I2C_CLIENT_INSMOD_COMMON
 
 #define I2C_CLIENT_INSMOD_8(chip1, chip2, chip3, chip4, chip5, chip6, chip7, chip8) \
 enum chips { any_chip, chip1, chip2, chip3, chip4, chip5, chip6,       \
             chip7, chip8 };                                            \
-I2C_CLIENT_MODULE_PARM(force, "List of adapter,address pairs to "      \
-                      "boldly assume to be present");                  \
+I2C_CLIENT_MODULE_PARM(force, I2C_CLIENT_FORCE_TEXT);                  \
 I2C_CLIENT_MODULE_PARM_FORCE(chip1);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip2);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip3);                                   \
@@ -723,11 +717,10 @@ I2C_CLIENT_MODULE_PARM_FORCE(chip5);                                      \
 I2C_CLIENT_MODULE_PARM_FORCE(chip6);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip7);                                   \
 I2C_CLIENT_MODULE_PARM_FORCE(chip8);                                   \
-static unsigned short *forces[] = { force, force_##chip1,              \
-                                   force_##chip2, force_##chip3,       \
-                                   force_##chip4, force_##chip5,       \
-                                   force_##chip6, force_##chip7,       \
-                                   force_##chip8, NULL };              \
+static const unsigned short * const forces[] = { force,                        \
+       force_##chip1, force_##chip2, force_##chip3,                    \
+       force_##chip4, force_##chip5, force_##chip6,                    \
+       force_##chip7, force_##chip8, NULL };                           \
 I2C_CLIENT_INSMOD_COMMON
 #endif /* __KERNEL__ */
 #endif /* _LINUX_I2C_H */