i2c: Add i2c_board_info and i2c_new_device()
This provides partial support for new-style I2C driver binding. It builds
on "struct i2c_board_info" declarations that identify I2C devices on a given
board. This is needed on systems with I2C devices that can't be fully probed
and/or autoconfigured, such as many embedded Linux configurations where the
way a given I2C device is wired may affect how it must be used.
There are two models for declaring such devices:
* LATE -- using a public function i2c_new_device(). This lets modules
declare I2C devices found *AFTER* a given I2C adapter becomes available.
For example, a PCI card could create adapters giving access to utility
chips on that card, and this would be used to associate those chips with
those adapters.
* EARLY -- from arch_initcall() level code, using a non-exported function
i2c_register_board_info(). This copies the declarations *BEFORE* such
an i2c_adapter becomes available, arranging that i2c_new_device() will
be called later when i2c-core registers the relevant i2c_adapter.
For example, arch/.../.../board-*.c files would declare the I2C devices
along with their platform data, and I2C devices would behave much like
PNPACPI devices. (That is, both enumerate from board-specific tables.)
To match the exported i2c_new_device(), the previously-private function
i2c_unregister_device() is now exported.
Pending later patches using these new APIs, this is effectively a NOP.
Signed-off-by: David Brownell <dbrownell@users.sourceforge.net>
Signed-off-by: Jean Delvare <khali@linux-fr.org>
2007-05-02 05:26:31 +08:00
|
|
|
/*
|
|
|
|
|
* i2c-core.h - interfaces internal to the I2C framework
|
|
|
|
|
*
|
|
|
|
|
* This program is free software; you can redistribute it and/or modify
|
|
|
|
|
* it under the terms of the GNU General Public License as published by
|
|
|
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
|
|
|
* (at your option) any later version.
|
|
|
|
|
*
|
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
|
* GNU General Public License for more details.
|
|
|
|
|
*/
|
|
|
|
|
|
2009-06-19 22:58:20 +08:00
|
|
|
#include <linux/rwsem.h>
|
|
|
|
|
|
i2c: Add i2c_board_info and i2c_new_device()
This provides partial support for new-style I2C driver binding. It builds
on "struct i2c_board_info" declarations that identify I2C devices on a given
board. This is needed on systems with I2C devices that can't be fully probed
and/or autoconfigured, such as many embedded Linux configurations where the
way a given I2C device is wired may affect how it must be used.
There are two models for declaring such devices:
* LATE -- using a public function i2c_new_device(). This lets modules
declare I2C devices found *AFTER* a given I2C adapter becomes available.
For example, a PCI card could create adapters giving access to utility
chips on that card, and this would be used to associate those chips with
those adapters.
* EARLY -- from arch_initcall() level code, using a non-exported function
i2c_register_board_info(). This copies the declarations *BEFORE* such
an i2c_adapter becomes available, arranging that i2c_new_device() will
be called later when i2c-core registers the relevant i2c_adapter.
For example, arch/.../.../board-*.c files would declare the I2C devices
along with their platform data, and I2C devices would behave much like
PNPACPI devices. (That is, both enumerate from board-specific tables.)
To match the exported i2c_new_device(), the previously-private function
i2c_unregister_device() is now exported.
Pending later patches using these new APIs, this is effectively a NOP.
Signed-off-by: David Brownell <dbrownell@users.sourceforge.net>
Signed-off-by: Jean Delvare <khali@linux-fr.org>
2007-05-02 05:26:31 +08:00
|
|
|
struct i2c_devinfo {
|
|
|
|
|
struct list_head list;
|
|
|
|
|
int busnum;
|
|
|
|
|
struct i2c_board_info board_info;
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
/* board_lock protects board_list and first_dynamic_bus_num.
|
|
|
|
|
* only i2c core components are allowed to use these symbols.
|
|
|
|
|
*/
|
2009-06-19 22:58:20 +08:00
|
|
|
extern struct rw_semaphore __i2c_board_lock;
|
i2c: Add i2c_board_info and i2c_new_device()
This provides partial support for new-style I2C driver binding. It builds
on "struct i2c_board_info" declarations that identify I2C devices on a given
board. This is needed on systems with I2C devices that can't be fully probed
and/or autoconfigured, such as many embedded Linux configurations where the
way a given I2C device is wired may affect how it must be used.
There are two models for declaring such devices:
* LATE -- using a public function i2c_new_device(). This lets modules
declare I2C devices found *AFTER* a given I2C adapter becomes available.
For example, a PCI card could create adapters giving access to utility
chips on that card, and this would be used to associate those chips with
those adapters.
* EARLY -- from arch_initcall() level code, using a non-exported function
i2c_register_board_info(). This copies the declarations *BEFORE* such
an i2c_adapter becomes available, arranging that i2c_new_device() will
be called later when i2c-core registers the relevant i2c_adapter.
For example, arch/.../.../board-*.c files would declare the I2C devices
along with their platform data, and I2C devices would behave much like
PNPACPI devices. (That is, both enumerate from board-specific tables.)
To match the exported i2c_new_device(), the previously-private function
i2c_unregister_device() is now exported.
Pending later patches using these new APIs, this is effectively a NOP.
Signed-off-by: David Brownell <dbrownell@users.sourceforge.net>
Signed-off-by: Jean Delvare <khali@linux-fr.org>
2007-05-02 05:26:31 +08:00
|
|
|
extern struct list_head __i2c_board_list;
|
|
|
|
|
extern int __i2c_first_dynamic_bus_num;
|
|
|
|
|
|
2017-05-23 17:50:58 +08:00
|
|
|
int i2c_check_addr_validity(unsigned addr, unsigned short flags);
|
2017-05-23 17:14:17 +08:00
|
|
|
int i2c_check_7bit_addr_validity_strict(unsigned short addr);
|
2017-05-23 17:50:58 +08:00
|
|
|
|
2017-05-23 22:22:23 +08:00
|
|
|
#ifdef CONFIG_ACPI
|
2017-07-17 22:13:28 +08:00
|
|
|
const struct acpi_device_id *
|
|
|
|
|
i2c_acpi_match_device(const struct acpi_device_id *matches,
|
|
|
|
|
struct i2c_client *client);
|
2017-05-23 22:22:23 +08:00
|
|
|
void i2c_acpi_register_devices(struct i2c_adapter *adap);
|
|
|
|
|
#else /* CONFIG_ACPI */
|
|
|
|
|
static inline void i2c_acpi_register_devices(struct i2c_adapter *adap) { }
|
2017-07-17 22:13:28 +08:00
|
|
|
static inline const struct acpi_device_id *
|
|
|
|
|
i2c_acpi_match_device(const struct acpi_device_id *matches,
|
|
|
|
|
struct i2c_client *client)
|
|
|
|
|
{
|
|
|
|
|
return NULL;
|
|
|
|
|
}
|
2017-05-23 22:22:23 +08:00
|
|
|
#endif /* CONFIG_ACPI */
|
|
|
|
|
extern struct notifier_block i2c_acpi_notifier;
|
|
|
|
|
|
|
|
|
|
#ifdef CONFIG_ACPI_I2C_OPREGION
|
|
|
|
|
int i2c_acpi_install_space_handler(struct i2c_adapter *adapter);
|
|
|
|
|
void i2c_acpi_remove_space_handler(struct i2c_adapter *adapter);
|
|
|
|
|
#else /* CONFIG_ACPI_I2C_OPREGION */
|
|
|
|
|
static inline int i2c_acpi_install_space_handler(struct i2c_adapter *adapter) { return 0; }
|
|
|
|
|
static inline void i2c_acpi_remove_space_handler(struct i2c_adapter *adapter) { }
|
|
|
|
|
#endif /* CONFIG_ACPI_I2C_OPREGION */
|
|
|
|
|
|
2017-05-23 17:50:58 +08:00
|
|
|
#ifdef CONFIG_OF
|
|
|
|
|
void of_i2c_register_devices(struct i2c_adapter *adap);
|
|
|
|
|
#else
|
|
|
|
|
static inline void of_i2c_register_devices(struct i2c_adapter *adap) { }
|
|
|
|
|
#endif
|
|
|
|
|
extern struct notifier_block i2c_of_notifier;
|