Lines Matching +full:i2c +full:- +full:sda +full:- +full:hold +full:- +full:time +full:- +full:ns
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
3 * i2c.h - definitions for the Linux i2c bus interface
4 * Copyright (C) 1995-2000 Simon G. Vogl
5 * Copyright (C) 2013-2019 Wolfram Sang <wsa@kernel.org>
22 #include <uapi/linux/i2c.h>
28 /* --- General options ------------------------------------------------ */
42 /* I2C Frequency Modes */
57 * transmit one message at a time, a more complex version can be used to
65 * i2c_master_recv - issue a single I2C message in master receive mode
79 * i2c_master_recv_dmasafe - issue a single I2C message in master receive mode
95 * i2c_master_send - issue a single I2C message in master transmit mode
109 * i2c_master_send_dmasafe - issue a single I2C message in master transmit mode
186 #endif /* I2C */
189 * struct i2c_device_identity - i2c client device identification
190 * @manufacturer_id: 0 - 4095, database maintained by NXP
191 * @part_id: 0 - 511, according to manufacturer
192 * @die_revision: 0 - 7, according to manufacturer
221 * struct i2c_driver - represent an I2C device driver
222 * @class: What kind of i2c device we instantiate (for detect)
223 * @probe: Callback for device binding - soon to be deprecated
228 * @command: Callback for bus-wide signaling (optional)
230 * @id_table: List of I2C devices supported by this driver
232 * @address_list: The I2C addresses to probe (for detect)
233 * @clients: List of detected clients we created (for i2c-core use only)
246 * for the many I2C/SMBus devices which can't be detected reliably, and
275 * 16-bit payload data reported by the slave device acting as master.
296 * struct i2c_client - represent an I2C slave device
298 * @addr: Address used on the I2C bus connected to the parent adapter.
300 * generic enough to hide second-sourcing and compatible revisions.
301 * @adapter: manages the bus segment hosting this I2C device
305 * @detected: member of an i2c_driver.clients list or i2c-core's
307 * @slave_cb: Callback when I2C slave mode of an adapter is used. The adapter
311 * i2c bus. The behaviour exposed to Linux is defined by the driver
320 #define I2C_CLIENT_HOST_NOTIFY 0x40 /* We want to use I2C host notify */
325 unsigned short addr; /* chip address - NOTE: 7bit */
353 return dev_get_drvdata(&client->dev); in i2c_get_clientdata()
358 dev_set_drvdata(&client->dev, data); in i2c_set_clientdata()
361 /* I2C slave support */
379 return client->slave_cb(client, event, val); in i2c_slave_event()
386 * struct i2c_board_info - template for device creation
390 * @dev_name: Overrides the default <busnr>-<addr> dev_name if set
399 * I2C doesn't actually support hardware probing, although controllers and
404 * i2c_board_info is used to build tables of information listing I2C devices
407 * bus numbers identify adapters that aren't yet available. For add-on boards,
425 * I2C_BOARD_INFO - macro used to list an i2c device and its address
431 * fields (such as associated irq, or device-specific platform_data)
440 * Add-on boards should register/unregister their devices; e.g. a board
441 * with integrated I2C, a config eeprom, sensors, and a codec that's
447 /* If you don't know the exact address of an I2C device, use this variant
474 #endif /* I2C */
476 /* Mainboard arch_initcall() code should register all its I2C devices.
477 * This is done at arch_initcall time, before declaring any i2c adapters.
478 * Modules for add-on boards must use other calls.
494 * struct i2c_algorithm - represent I2C transfer method
495 * @master_xfer: Issue a set of i2c transactions to the given I2C adapter
500 * @smbus_xfer: Issue smbus transactions to the given I2C adapter. If this
502 * into I2C transfers instead.
507 * @reg_slave: Register given client to I2C slave mode of this adapter
508 * @unreg_slave: Unregister given client from I2C slave mode of this adapter
512 * be addressed using the same bus algorithms - i.e. bit-banging or the PCF8584
517 * Kernel Documentation file Documentation/i2c/fault-codes.rst.
521 * If an adapter algorithm can't do I2C-level access, set master_xfer
524 * using common I2C messages.
550 * struct i2c_lock_operations - represent I2C locking operations
551 * @lock_bus: Get exclusive access to an I2C bus segment
552 * @trylock_bus: Try to get exclusive access to an I2C bus segment
553 * @unlock_bus: Release exclusive access to an I2C bus segment
564 * struct i2c_timings - I2C timing information
566 * @scl_rise_ns: time SCL signal takes to rise in ns; t(r) in the I2C specification
567 * @scl_fall_ns: time SCL signal takes to fall in ns; t(f) in the I2C specification
568 * @scl_int_delay_ns: time IP core additionally needs to setup SCL in ns
569 * @sda_fall_ns: time SDA signal takes to fall in ns; t(f) in the I2C specification
570 * @sda_hold_ns: time IP core additionally needs to hold SDA in ns
571 * @digital_filter_width_ns: width in ns of spikes on i2c lines that the IP core
588 * struct i2c_bus_recovery_info - I2C bus recovery information
595 * @get_sda: This gets current value of SDA line. This or set_sda() is mandatory
598 * @set_sda: This sets/clears the SDA line. This or get_sda() is mandatory for
602 * has a more complex internal logic than just reading SDA. Optional.
604 * configure padmux here for SDA/SCL line or something else they want.
606 * may configure padmux here for SDA/SCL line or something else they want.
608 * @sda_gpiod: gpiod of the SDA line. Only required for GPIO recovery.
609 * @pinctrl: pinctrl used by GPIO recovery to change the state of the I2C pins.
611 * @pins_default: default pinctrl state of SCL/SDA lines, when they are assigned
612 * to the I2C bus. Optional. Populated internally for GPIO recovery, if
614 * @pins_gpio: recovery pinctrl state of SCL/SDA lines, when they are used as
644 * struct i2c_adapter_quirks - describe flaws of an i2c adapter
652 * Note about combined messages: Some I2C controllers can only send one message
653 * per transfer, plus something called combined message or write-then-read.
659 * write-then-anything or other variants. To support that, write-then-read has
660 * been broken out into smaller bits like write-first and read-second which can
681 /* convenience macro for typical write-then read case */
692 * i2c_adapter is the structure used to identify a physical i2c bus along
709 unsigned long locked_flags; /* owned by the I2C core */
729 return dev_get_drvdata(&adap->dev); in i2c_get_adapdata()
734 dev_set_drvdata(&adap->dev, data); in i2c_set_adapdata()
741 struct device *parent = adapter->dev.parent; in i2c_parent_is_i2c_adapter()
743 if (parent != NULL && parent->type == &i2c_adapter_type) in i2c_parent_is_i2c_adapter()
757 * i2c_lock_bus - Get exclusive access to an I2C bus segment
758 * @adapter: Target I2C bus segment
759 * @flags: I2C_LOCK_ROOT_ADAPTER locks the root i2c adapter, I2C_LOCK_SEGMENT
765 adapter->lock_ops->lock_bus(adapter, flags); in i2c_lock_bus()
769 * i2c_trylock_bus - Try to get exclusive access to an I2C bus segment
770 * @adapter: Target I2C bus segment
771 * @flags: I2C_LOCK_ROOT_ADAPTER tries to locks the root i2c adapter,
774 * Return: true if the I2C bus segment is locked, false otherwise
779 return adapter->lock_ops->trylock_bus(adapter, flags); in i2c_trylock_bus()
783 * i2c_unlock_bus - Release exclusive access to an I2C bus segment
784 * @adapter: Target I2C bus segment
785 * @flags: I2C_LOCK_ROOT_ADAPTER unlocks the root i2c adapter, I2C_LOCK_SEGMENT
791 adapter->lock_ops->unlock_bus(adapter, flags); in i2c_unlock_bus()
795 * i2c_mark_adapter_suspended - Report suspended state of the adapter to the core
807 set_bit(I2C_ALF_IS_SUSPENDED, &adap->locked_flags); in i2c_mark_adapter_suspended()
812 * i2c_mark_adapter_resumed - Report resumed state of the adapter to the core
822 clear_bit(I2C_ALF_IS_SUSPENDED, &adap->locked_flags); in i2c_mark_adapter_resumed()
826 /* i2c adapter classes (bitmask) */
836 /* Construct an I2C_CLIENT_END-terminated array of i2c addresses */
841 /* ----- functions exported by i2c.o */
859 return !IS_ERR_OR_NULL(client) && client->dev.driver; in i2c_client_has_driver()
862 /* call the i2c_client->command() of all attached clients with
876 return adap->algo->functionality(adap); in i2c_get_functionality()
886 * i2c_check_quirks() - Function for checking the quirk flags in an i2c adapter
887 * @adap: i2c adapter
894 if (!adap->quirks) in i2c_check_quirks()
896 return (adap->quirks->flags & quirks) == quirks; in i2c_check_quirks()
902 return adap->nr; in i2c_adapter_id()
907 return (msg->addr << 1) | (msg->flags & I2C_M_RD ? 1 : 0); in i2c_8bit_addr_from_msg()
915 * module_i2c_driver() - Helper macro for registering a modular I2C driver
918 * Helper macro for I2C drivers which do not do anything special in module
927 * builtin_i2c_driver() - Helper macro for registering a builtin I2C driver
930 * Helper macro for I2C drivers which do not do anything special in their
937 #endif /* I2C */
984 return -ENOTSUPP; in of_i2c_get_board_info()
994 struct acpi_resource_i2c_serialbus **i2c);
1001 struct acpi_resource_i2c_serialbus **i2c) in i2c_acpi_get_i2c_resource() argument
1012 return ERR_PTR(-ENODEV); in i2c_acpi_new_device()