2019-05-26 23:55:06 -07:00
|
|
|
/* SPDX-License-Identifier: GPL-2.0-or-later */
|
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-01 14:26:31 -07:00
|
|
|
/*
|
|
|
|
* i2c-core.h - interfaces internal to the I2C framework
|
|
|
|
*/
|
|
|
|
|
2024-01-04 01:17:08 -07:00
|
|
|
#include <linux/kconfig.h>
|
2009-06-19 07:58:20 -07: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-01 14:26:31 -07: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 07:58:20 -07: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-01 14:26:31 -07:00
|
|
|
extern struct list_head __i2c_board_list;
|
|
|
|
extern int __i2c_first_dynamic_bus_num;
|
|
|
|
|
2017-05-23 02:14:17 -07:00
|
|
|
int i2c_check_7bit_addr_validity_strict(unsigned short addr);
|
2019-06-27 02:24:06 -07:00
|
|
|
int i2c_dev_irq_from_resources(const struct resource *resources,
|
|
|
|
unsigned int num_resources);
|
2017-05-23 02:50:58 -07:00
|
|
|
|
2019-04-03 05:40:08 -07:00
|
|
|
/*
|
2020-05-05 09:01:01 -07:00
|
|
|
* We only allow atomic transfers for very late communication, e.g. to access a
|
|
|
|
* PMIC when powering down. Atomic transfers are a corner case and not for
|
|
|
|
* generic use!
|
2019-04-03 05:40:08 -07:00
|
|
|
*/
|
|
|
|
static inline bool i2c_in_atomic_xfer_mode(void)
|
|
|
|
{
|
2024-01-04 01:17:08 -07:00
|
|
|
return system_state > SYSTEM_RUNNING &&
|
|
|
|
(IS_ENABLED(CONFIG_PREEMPT_COUNT) ? !preemptible() : irqs_disabled());
|
2019-04-03 05:40:08 -07:00
|
|
|
}
|
|
|
|
|
2019-04-03 05:40:09 -07:00
|
|
|
static inline int __i2c_lock_bus_helper(struct i2c_adapter *adap)
|
|
|
|
{
|
|
|
|
int ret = 0;
|
|
|
|
|
2019-04-03 05:40:10 -07:00
|
|
|
if (i2c_in_atomic_xfer_mode()) {
|
|
|
|
WARN(!adap->algo->master_xfer_atomic && !adap->algo->smbus_xfer_atomic,
|
|
|
|
"No atomic I2C transfer handler for '%s'\n", dev_name(&adap->dev));
|
2019-04-03 05:40:09 -07:00
|
|
|
ret = i2c_trylock_bus(adap, I2C_LOCK_SEGMENT) ? 0 : -EAGAIN;
|
2019-04-03 05:40:10 -07:00
|
|
|
} else {
|
2019-04-03 05:40:09 -07:00
|
|
|
i2c_lock_bus(adap, I2C_LOCK_SEGMENT);
|
2019-04-03 05:40:10 -07:00
|
|
|
}
|
2019-04-03 05:40:09 -07:00
|
|
|
|
|
|
|
return ret;
|
|
|
|
}
|
|
|
|
|
2019-04-25 07:19:48 -07:00
|
|
|
static inline int __i2c_check_suspended(struct i2c_adapter *adap)
|
|
|
|
{
|
|
|
|
if (test_bit(I2C_ALF_IS_SUSPENDED, &adap->locked_flags)) {
|
|
|
|
if (!test_and_set_bit(I2C_ALF_SUSPEND_REPORTED, &adap->locked_flags))
|
|
|
|
dev_WARN(&adap->dev, "Transfer while suspended\n");
|
|
|
|
return -ESHUTDOWN;
|
|
|
|
}
|
|
|
|
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2017-05-23 07:22:23 -07:00
|
|
|
#ifdef CONFIG_ACPI
|
|
|
|
void i2c_acpi_register_devices(struct i2c_adapter *adap);
|
2019-06-27 02:24:09 -07:00
|
|
|
|
2022-09-29 09:19:11 -07:00
|
|
|
int i2c_acpi_get_irq(struct i2c_client *client, bool *wake_capable);
|
2017-05-23 07:22:23 -07:00
|
|
|
#else /* CONFIG_ACPI */
|
|
|
|
static inline void i2c_acpi_register_devices(struct i2c_adapter *adap) { }
|
2019-06-27 02:24:09 -07:00
|
|
|
|
2022-09-29 09:19:11 -07:00
|
|
|
static inline int i2c_acpi_get_irq(struct i2c_client *client, bool *wake_capable)
|
2019-06-27 02:24:09 -07:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
2017-05-23 07:22:23 -07: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 02:50:58 -07: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;
|
2022-02-10 14:33:41 -07:00
|
|
|
|
|
|
|
#if IS_ENABLED(CONFIG_I2C_SMBUS)
|
|
|
|
int i2c_setup_smbus_alert(struct i2c_adapter *adap);
|
|
|
|
#else
|
|
|
|
static inline int i2c_setup_smbus_alert(struct i2c_adapter *adap)
|
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
#endif
|