blob: deea47c576e50c7ca6107f632bd215d564d376b2 [file] [log] [blame]
David Brownell9c1600e2007-05-01 23:26:31 +02001/*
2 * i2c-core.h - interfaces internal to the I2C framework
3 *
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation; either version 2 of the License, or
7 * (at your option) any later version.
8 *
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
David Brownell9c1600e2007-05-01 23:26:31 +020013 */
14
Rodolfo Giomettif18c41d2009-06-19 16:58:20 +020015#include <linux/rwsem.h>
16
David Brownell9c1600e2007-05-01 23:26:31 +020017struct i2c_devinfo {
18 struct list_head list;
19 int busnum;
20 struct i2c_board_info board_info;
21};
22
23/* board_lock protects board_list and first_dynamic_bus_num.
24 * only i2c core components are allowed to use these symbols.
25 */
Rodolfo Giomettif18c41d2009-06-19 16:58:20 +020026extern struct rw_semaphore __i2c_board_lock;
David Brownell9c1600e2007-05-01 23:26:31 +020027extern struct list_head __i2c_board_list;
28extern int __i2c_first_dynamic_bus_num;
29
Wolfram Sange4991ec2017-05-23 11:14:17 +020030int i2c_check_7bit_addr_validity_strict(unsigned short addr);
Wolfram Sang5bf4fa72017-05-23 11:50:58 +020031
Wolfram Sangbae1d3a2019-04-03 14:40:08 +020032/*
33 * We only allow atomic transfers for very late communication, e.g. to send
34 * the powerdown command to a PMIC. Atomic transfers are a corner case and not
35 * for generic use!
36 */
37static inline bool i2c_in_atomic_xfer_mode(void)
38{
39 return system_state > SYSTEM_RUNNING && irqs_disabled();
40}
41
Wolfram Sang83c42212019-04-03 14:40:09 +020042static inline int __i2c_lock_bus_helper(struct i2c_adapter *adap)
43{
44 int ret = 0;
45
46 if (i2c_in_atomic_xfer_mode())
47 ret = i2c_trylock_bus(adap, I2C_LOCK_SEGMENT) ? 0 : -EAGAIN;
48 else
49 i2c_lock_bus(adap, I2C_LOCK_SEGMENT);
50
51 return ret;
52}
53
Wolfram Sang53f8f7c2017-05-23 16:22:23 +020054#ifdef CONFIG_ACPI
Andy Shevchenkoc64ffff2017-07-17 17:13:28 +030055const struct acpi_device_id *
56i2c_acpi_match_device(const struct acpi_device_id *matches,
57 struct i2c_client *client);
Wolfram Sang53f8f7c2017-05-23 16:22:23 +020058void i2c_acpi_register_devices(struct i2c_adapter *adap);
59#else /* CONFIG_ACPI */
60static inline void i2c_acpi_register_devices(struct i2c_adapter *adap) { }
Andy Shevchenkoc64ffff2017-07-17 17:13:28 +030061static inline const struct acpi_device_id *
62i2c_acpi_match_device(const struct acpi_device_id *matches,
63 struct i2c_client *client)
64{
65 return NULL;
66}
Wolfram Sang53f8f7c2017-05-23 16:22:23 +020067#endif /* CONFIG_ACPI */
68extern struct notifier_block i2c_acpi_notifier;
69
70#ifdef CONFIG_ACPI_I2C_OPREGION
71int i2c_acpi_install_space_handler(struct i2c_adapter *adapter);
72void i2c_acpi_remove_space_handler(struct i2c_adapter *adapter);
73#else /* CONFIG_ACPI_I2C_OPREGION */
74static inline int i2c_acpi_install_space_handler(struct i2c_adapter *adapter) { return 0; }
75static inline void i2c_acpi_remove_space_handler(struct i2c_adapter *adapter) { }
76#endif /* CONFIG_ACPI_I2C_OPREGION */
77
Wolfram Sang5bf4fa72017-05-23 11:50:58 +020078#ifdef CONFIG_OF
79void of_i2c_register_devices(struct i2c_adapter *adap);
80#else
81static inline void of_i2c_register_devices(struct i2c_adapter *adap) { }
82#endif
83extern struct notifier_block i2c_of_notifier;