blob: a16b1f9c1aca50ec2e48d917369e23f19921cf6a [file] [log] [blame]
Samuel Ortize5354102013-03-27 17:29:53 +02001#ifndef _LINUX_MEI_CL_BUS_H
2#define _LINUX_MEI_CL_BUS_H
3
4#include <linux/device.h>
5#include <linux/uuid.h>
Tomas Winkler1f180352014-09-29 16:31:46 +03006#include <linux/mod_devicetable.h>
Samuel Ortize5354102013-03-27 17:29:53 +02007
8struct mei_cl_device;
9
Tomas Winklerdbac9932015-05-07 15:54:07 +030010typedef void (*mei_cl_event_cb_t)(struct mei_cl_device *device,
11 u32 events, void *context);
12
13/**
14 * struct mei_cl_device - MEI device handle
15 * An mei_cl_device pointer is returned from mei_add_device()
16 * and links MEI bus clients to their actual ME host client pointer.
17 * Drivers for MEI devices will get an mei_cl_device pointer
18 * when being probed and shall use it for doing ME bus I/O.
19 *
20 * @dev: linux driver model device pointer
21 * @me_cl: me client
22 * @cl: mei client
23 * @name: device name
24 * @event_work: async work to execute event callback
25 * @event_cb: Drivers register this callback to get asynchronous ME
26 * events (e.g. Rx buffer pending) notifications.
27 * @event_context: event callback run context
28 * @events: Events bitmask sent to the driver.
29 * @priv_data: client private data
30 */
31struct mei_cl_device {
32 struct device dev;
33
34 struct mei_me_client *me_cl;
35 struct mei_cl *cl;
36 char name[MEI_CL_NAME_SIZE];
37
38 struct work_struct event_work;
39 mei_cl_event_cb_t event_cb;
40 void *event_context;
41 unsigned long events;
42
43 void *priv_data;
44};
45
Samuel Ortize5354102013-03-27 17:29:53 +020046struct mei_cl_driver {
47 struct device_driver driver;
48 const char *name;
49
50 const struct mei_cl_device_id *id_table;
51
52 int (*probe)(struct mei_cl_device *dev,
53 const struct mei_cl_device_id *id);
54 int (*remove)(struct mei_cl_device *dev);
55};
56
Samuel Ortiz333e4ee2013-03-27 17:29:54 +020057int __mei_cl_driver_register(struct mei_cl_driver *driver,
58 struct module *owner);
59#define mei_cl_driver_register(driver) \
60 __mei_cl_driver_register(driver, THIS_MODULE)
61
62void mei_cl_driver_unregister(struct mei_cl_driver *driver);
63
Tomas Winkler39db74c2014-11-27 14:07:28 +020064ssize_t mei_cl_send(struct mei_cl_device *device, u8 *buf, size_t length);
65ssize_t mei_cl_recv(struct mei_cl_device *device, u8 *buf, size_t length);
Samuel Ortiz3e833292013-03-27 17:29:55 +020066
Samuel Ortiz3e833292013-03-27 17:29:55 +020067int mei_cl_register_event_cb(struct mei_cl_device *device,
68 mei_cl_event_cb_t read_cb, void *context);
69
70#define MEI_CL_EVENT_RX 0
71#define MEI_CL_EVENT_TX 1
72
Samuel Ortizaa6aef22013-03-27 17:29:59 +020073void *mei_cl_get_drvdata(const struct mei_cl_device *device);
74void mei_cl_set_drvdata(struct mei_cl_device *device, void *data);
75
Samuel Ortize46980a2013-04-09 01:51:38 +030076int mei_cl_enable_device(struct mei_cl_device *device);
77int mei_cl_disable_device(struct mei_cl_device *device);
78
Samuel Ortize5354102013-03-27 17:29:53 +020079#endif /* _LINUX_MEI_CL_BUS_H */