xref: /linux-6.15/include/linux/mei_cl_bus.h (revision 512f64d9)
1 #ifndef _LINUX_MEI_CL_BUS_H
2 #define _LINUX_MEI_CL_BUS_H
3 
4 #include <linux/device.h>
5 #include <linux/uuid.h>
6 #include <linux/mod_devicetable.h>
7 
8 struct mei_cl_device;
9 struct mei_device;
10 
11 typedef void (*mei_cl_event_cb_t)(struct mei_cl_device *device,
12 			       u32 events, void *context);
13 
14 /**
15  * struct mei_cl_device - MEI device handle
16  * An mei_cl_device pointer is returned from mei_add_device()
17  * and links MEI bus clients to their actual ME host client pointer.
18  * Drivers for MEI devices will get an mei_cl_device pointer
19  * when being probed and shall use it for doing ME bus I/O.
20  *
21  * @bus: parent mei device
22  * @dev: linux driver model device pointer
23  * @me_cl: me client
24  * @cl: mei client
25  * @name: device name
26  * @event_work: async work to execute event callback
27  * @event_cb: Drivers register this callback to get asynchronous ME
28  *	events (e.g. Rx buffer pending) notifications.
29  * @event_context: event callback run context
30  * @events: Events bitmask sent to the driver.
31  * @priv_data: client private data
32  */
33 struct mei_cl_device {
34 	struct mei_device *bus;
35 	struct device dev;
36 
37 	struct mei_me_client *me_cl;
38 	struct mei_cl *cl;
39 	char name[MEI_CL_NAME_SIZE];
40 
41 	struct work_struct event_work;
42 	mei_cl_event_cb_t event_cb;
43 	void *event_context;
44 	unsigned long events;
45 
46 	void *priv_data;
47 };
48 
49 struct mei_cl_driver {
50 	struct device_driver driver;
51 	const char *name;
52 
53 	const struct mei_cl_device_id *id_table;
54 
55 	int (*probe)(struct mei_cl_device *dev,
56 		     const struct mei_cl_device_id *id);
57 	int (*remove)(struct mei_cl_device *dev);
58 };
59 
60 int __mei_cl_driver_register(struct mei_cl_driver *driver,
61 				struct module *owner);
62 #define mei_cl_driver_register(driver)             \
63 	__mei_cl_driver_register(driver, THIS_MODULE)
64 
65 void mei_cl_driver_unregister(struct mei_cl_driver *driver);
66 
67 ssize_t mei_cl_send(struct mei_cl_device *device, u8 *buf, size_t length);
68 ssize_t  mei_cl_recv(struct mei_cl_device *device, u8 *buf, size_t length);
69 
70 int mei_cl_register_event_cb(struct mei_cl_device *device,
71 			  mei_cl_event_cb_t read_cb, void *context);
72 
73 #define MEI_CL_EVENT_RX 0
74 #define MEI_CL_EVENT_TX 1
75 
76 void *mei_cl_get_drvdata(const struct mei_cl_device *device);
77 void mei_cl_set_drvdata(struct mei_cl_device *device, void *data);
78 
79 int mei_cl_enable_device(struct mei_cl_device *device);
80 int mei_cl_disable_device(struct mei_cl_device *device);
81 
82 #endif /* _LINUX_MEI_CL_BUS_H */
83