30  * @bus: I3C bus to take the lock on
41  * logic to rely on I3C device information that could be changed behind their
52  * @bus: I3C bus to release the lock on
65  * @bus: I3C bus to take the lock on
69  * maintenance operations). Basically all communications with I3C devices are
71  * state or I3C dynamic address).
74  * In other words, transfer requests passed to the I3C master can be submitted
75  * in parallel and I3C master drivers have to use their own locking to make
86  * @bus: I3C bus to release the lock on
250 	struct i3c_device *i3c = dev_to_i3cdev(dev);  in modalias_show()  local
254 	i3c_device_get_info(i3c, &devinfo);  in modalias_show()
260 		return sprintf(buf, "i3c:dcr%02Xmanuf%04X", devinfo.dcr,  in modalias_show()
263 	return sprintf(buf, "i3c:dcr%02Xmanuf%04Xpart%04Xext%04X",  in modalias_show()
292 		return add_uevent_var(env, "MODALIAS=i3c:dcr%02Xmanuf%04X",  in i3c_device_uevent()
296 			      "MODALIAS=i3c:dcr%02Xmanuf%04Xpart%04Xext%04X",  in i3c_device_uevent()
341 	.name = "i3c",
407  * sending it out to the I3C bus. This means that a 7-bit dynamic address needs to be allocated
410  * However, some I3C targets may request specific addresses (called as "init_dyn_addr"), which is
414  * the "init_dyn_addr" to switch to its "init_dyn_addr" when it hot-joins the I3C bus. Otherwise,
415  * if the "init_dyn_addr" is already in use by another I3C device, the target device will not be
475 	INIT_LIST_HEAD(&i3cbus->devs.i3c);  in i3c_bus_init()
480 		id = of_alias_get_id(np, "i3c");  in i3c_bus_init()
583 	ret = sprintf(buf, "%ld\n", i3cbus->scl_rate.i3c);  in i3c_scl_frequency_show()
651  * @master: I3C master object
663  * @master: I3C master object
710 	WARN_ON(!list_empty(&bus->devs.i2c) || !list_empty(&bus->devs.i3c));  in i3c_masterdev_release()
729 		if (!i3cbus->scl_rate.i3c)  in i3c_bus_set_mode()
730 			i3cbus->scl_rate.i3c = I3C_BUS_TYP_I3C_SCL_RATE;  in i3c_bus_set_mode()
734 		if (!i3cbus->scl_rate.i3c)  in i3c_bus_set_mode()
735 			i3cbus->scl_rate.i3c = I3C_BUS_TYP_I3C_SCL_RATE;  in i3c_bus_set_mode()
742 		if (!i3cbus->scl_rate.i3c ||  in i3c_bus_set_mode()
743 		    i3cbus->scl_rate.i3c > i3cbus->scl_rate.i2c)  in i3c_bus_set_mode()
744 			i3cbus->scl_rate.i3c = i3cbus->scl_rate.i2c;  in i3c_bus_set_mode()
750 	dev_dbg(&master->dev, "i2c-scl = %ld Hz i3c-scl = %ld Hz\n",  in i3c_bus_set_mode()
751 		i3cbus->scl_rate.i2c, i3cbus->scl_rate.i3c);  in i3c_bus_set_mode()
754 	 * I3C/I2C frequency may have been overridden, check that user-provided  in i3c_bus_set_mode()
757 	if (i3cbus->scl_rate.i3c > I3C_BUS_MAX_I3C_SCL_RATE ||  in i3c_bus_set_mode()
876  * @master: I3C master object
956  * behind dynamic address assignment has to be handled in the I3C master
961  * Return: 0 in case of success, a positive I3C error code if the error is
1006  * @addr: a valid I3C slave address or %I3C_BROADCAST_ADDR
1014  * Return: 0 in case of success, a positive I3C error code if the error is
1027  * @addr: a valid I3C slave address or %I3C_BROADCAST_ADDR
1035  * Return: 0 in case of success, a positive I3C error code if the error is
1053  * This should be called after all I3C devices have been discovered (in other
1061  * Return: 0 in case of success, a positive I3C error code if the error is
1118 		/* Skip the I3C dev representing this master. */  in i3c_master_defslvs_locked()
1543 	list_add_tail(&dev->common.node, &master->bus.devs.i3c);  in i3c_master_attach_i3c_dev()
1690 				"Failed to add I3C device (err = %d)\n", ret);  in i3c_master_register_new_i3c_devs()
1700  * This function is instantiating an I3C device object and adding it to the
1701  * I3C device list. All device information are automatically retrieved using
1704  * The I3C device object is returned in case the master wants to attach
1733  * @info: I3C device information
1795 	list_for_each_entry_safe(i3cdev, i3ctmp, &master->bus.devs.i3c,  in i3c_master_detach_free_devs()
1818  * i3c_master_bus_init() - initialize an I3C bus
1821  * This function is following all initialisation steps described in the I3C
1837  * 5. Reserve address slots for I3C devices with init_dyn_addr. And if devices
1839  *    the FW with SETDASA and attach corresponding statically defined I3C
1843  *    remaining I3C devices
1845  * Once this is done, all I3C and I2C devices should be usable.
1941 	list_for_each_entry(i3cboardinfo, &master->boardinfo.i3c, node) {  in i3c_master_bus_init()
2007 	list_for_each_entry(i3cboardinfo, &master->boardinfo.i3c, node) {  in i3c_master_attach_boardinfo()
2032  * i3c_master_add_i3c_dev_locked() - add an I3C slave to the bus
2034  * @addr: I3C slave dynamic address assigned to the device
2036  * This function is instantiating an I3C device object and adding it to the
2037  * I3C device list. All device information are automatically retrieved using
2040  * The I3C device object is returned in case the master wants to attach
2096 			 * i3c bus as it does not exist and has been assigned  in i3c_master_add_i3c_dev_locked()
2207 	 * The I3C Specification does not clearly say I2C devices with 10-bit  in of_i3c_master_add_i2c_boardinfo()
2268 	list_add_tail(&boardinfo->node, &master->boardinfo.i3c);  in of_i3c_master_add_i3c_boardinfo()
2318 	 * The user might want to limit I2C and I3C speed in case some devices  in of_populate_i3c_bus()
2325 	if (!of_property_read_u32(i3cbus_np, "i3c-scl-hz", &val))  in of_populate_i3c_bus()
2326 		master->bus.scl_rate.i3c = val;  in of_populate_i3c_bus()
2496 	/* FIXME: Should we allow i3c masters to override these values? */  in i3c_master_i2c_adapter_init()
2769  * i3c_master_register() - register an I3C master
2771  * @parent: the parent device (the one that provides this I3C master
2780  * - creates and initializes the I3C bus
2783  * - registers all I3C devices added by the controller during bus
2816 	INIT_LIST_HEAD(&master->boardinfo.i3c);  in i3c_master_register()
2823 	dev_set_name(&master->dev, "i3c-%d", i3cbus->id);  in i3c_master_register()
2875 	 * Expose our I3C bus as an I2C adapter so that I2C devices are exposed  in i3c_master_register()
2890 	 * register I3C devices discovered during the initial DAA.  in i3c_master_register()
2913  * i3c_master_unregister() - unregister an I3C master
3069 	res = of_alias_get_highest_id("i3c");  in i3c_init()
3102 MODULE_DESCRIPTION("I3C core");