linux/i3c/master.h

42  * @master: I3C master that instantiated this device. Will be used to do
44  * @master_priv: master private data assigned to the device. Can be used to
45  *		 add master specific information
51 	struct i3c_master_controller *master;  member
110  * Every time an IBI comes in, the I3C master driver should find a free IBI
114  * How IBI slots are allocated is left to the I3C master driver, though, for
135  *		     rejected by the master
151  * infrastructure. I3C master drivers may have their own internal
174  *		 assigned a dynamic address by the master. Will be used during
204  *	 should never be accessed from I3C master controller drivers. Only core
210  * core and passed to I3C master controller drivers when they're requested to
247  * I3C master can also have limitations, so this number is just here as a
318  * @cur_master: I3C master currently driving the bus. Since I3C is multi-master
319  *		this can change over the time. Will be used to let a master
333  *	      I3C master
336  *	      I3C master
345  *	  the same master in parallel. This is the responsibility of the
346  *	  master to guarantee that frames are actually sent sequentially and
350  * by the I3C master to cope with the multi-master functionality, where one bus
371  * struct i3c_master_controller_ops - I3C master methods
385  *		    This is a good place to attach master controller specific
395  *		    happens when the master device is unregistered.
412  *		    This is a good place to attach master controller specific
416  *		    happens when the master device is unregistered.
456 	int (*bus_init)(struct i3c_master_controller *master);
457 	void (*bus_cleanup)(struct i3c_master_controller *master);
461 	int (*do_daa)(struct i3c_master_controller *master);
462 	bool (*supports_ccc_cmd)(struct i3c_master_controller *master,
464 	int (*send_ccc_cmd)(struct i3c_master_controller *master,
480 	int (*enable_hotjoin)(struct i3c_master_controller *master);
481 	int (*disable_hotjoin)(struct i3c_master_controller *master);
482 	int (*set_speed)(struct i3c_master_controller *master, enum i3c_open_drain_speed speed);
486  * struct i3c_master_controller - I3C master controller object
488  * @this: an I3C device object representing this master. This device will be
493  * @ops: master operations. See &struct i3c_master_controller_ops
494  * @secondary: true if the master is a secondary master
496  * @hotjoin: true if the master support hotjoin
500  * @bus: I3C bus exposed by this master
501  * @wq: workqueue which can be used by master
550 int i3c_master_do_i2c_xfers(struct i3c_master_controller *master,
554 int i3c_master_disec_locked(struct i3c_master_controller *master, u8 addr,
556 int i3c_master_enec_locked(struct i3c_master_controller *master, u8 addr,
558 int i3c_master_entdaa_locked(struct i3c_master_controller *master);
559 int i3c_master_defslvs_locked(struct i3c_master_controller *master);
561 int i3c_master_get_free_addr(struct i3c_master_controller *master,
564 int i3c_master_add_i3c_dev_locked(struct i3c_master_controller *master,
566 int i3c_master_do_daa(struct i3c_master_controller *master);
568 int i3c_master_set_info(struct i3c_master_controller *master,
571 int i3c_master_register(struct i3c_master_controller *master,
575 void i3c_master_unregister(struct i3c_master_controller *master);
576 int i3c_master_enable_hotjoin(struct i3c_master_controller *master);
577 int i3c_master_disable_hotjoin(struct i3c_master_controller *master);
580  * i3c_dev_get_master_data() - get master private data attached to an I3C
593  * i3c_dev_set_master_data() - attach master private data to an I3C device
598  * This functions allows a master controller to attach per-device private data
608  * i2c_dev_get_master_data() - get master private data attached to an I2C
621  * i2c_dev_set_master_data() - attach master private data to an I2C device
626  * This functions allows a master controller to attach per-device private data
636  * i3c_dev_get_master() - get master used to communicate with a device
639  * Return: the master controller driving @dev
644 	return dev->common.master;  in i3c_dev_get_master()
648  * i2c_dev_get_master() - get master used to communicate with a device
651  * Return: the master controller driving @dev
656 	return dev->common.master;  in i2c_dev_get_master()
660  * i3c_master_get_bus() - get the bus attached to a master
661  * @master: master object
663  * Return: the I3C bus @master is connected to
666 i3c_master_get_bus(struct i3c_master_controller *master)  in i3c_master_get_bus()  argument
668 	return &master->bus;  in i3c_master_get_bus()