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 01:26:31 +04: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 18:58:20 +04: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 01:26:31 +04: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 18:58:20 +04: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 01:26:31 +04:00
extern struct list_head __i2c_board_list ;
extern int __i2c_first_dynamic_bus_num ;
2017-05-23 12:50:58 +03:00
int i2c_check_addr_validity ( unsigned addr , unsigned short flags ) ;
2017-05-23 12:14:17 +03:00
int i2c_check_7bit_addr_validity_strict ( unsigned short addr ) ;
2017-05-23 12:50:58 +03:00
2017-05-23 17:22:23 +03:00
# ifdef CONFIG_ACPI
2017-07-17 17:13:28 +03:00
const struct acpi_device_id *
i2c_acpi_match_device ( const struct acpi_device_id * matches ,
struct i2c_client * client ) ;
2017-05-23 17:22:23 +03: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 17:13:28 +03: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 17:22:23 +03: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 12:50:58 +03: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 ;
