1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17#ifndef _MEI_CLIENT_H_
18#define _MEI_CLIENT_H_
19
20#include <linux/types.h>
21#include <linux/poll.h>
22#include <linux/mei.h>
23
24#include "mei_dev.h"
25
26
27
28
29void mei_me_cl_init(struct mei_me_client *me_cl);
30void mei_me_cl_put(struct mei_me_client *me_cl);
31struct mei_me_client *mei_me_cl_get(struct mei_me_client *me_cl);
32
33void mei_me_cl_add(struct mei_device *dev, struct mei_me_client *me_cl);
34void mei_me_cl_del(struct mei_device *dev, struct mei_me_client *me_cl);
35
36struct mei_me_client *mei_me_cl_by_uuid(struct mei_device *dev,
37 const uuid_le *uuid);
38struct mei_me_client *mei_me_cl_by_id(struct mei_device *dev, u8 client_id);
39struct mei_me_client *mei_me_cl_by_uuid_id(struct mei_device *dev,
40 const uuid_le *uuid, u8 client_id);
41void mei_me_cl_rm_by_uuid(struct mei_device *dev, const uuid_le *uuid);
42void mei_me_cl_rm_by_uuid_id(struct mei_device *dev,
43 const uuid_le *uuid, u8 id);
44void mei_me_cl_rm_all(struct mei_device *dev);
45
46
47
48
49
50
51
52
53static inline bool mei_me_cl_is_active(const struct mei_me_client *me_cl)
54{
55 return !list_empty_careful(&me_cl->list);
56}
57
58
59
60
61
62
63
64
65static inline const uuid_le *mei_me_cl_uuid(const struct mei_me_client *me_cl)
66{
67 return &me_cl->props.protocol_name;
68}
69
70
71
72
73
74
75
76
77static inline u8 mei_me_cl_ver(const struct mei_me_client *me_cl)
78{
79 return me_cl->props.protocol_version;
80}
81
82
83
84
85void mei_io_cb_free(struct mei_cl_cb *priv_cb);
86
87
88
89
90
91struct mei_cl *mei_cl_allocate(struct mei_device *dev);
92
93int mei_cl_link(struct mei_cl *cl);
94int mei_cl_unlink(struct mei_cl *cl);
95
96struct mei_cl *mei_cl_alloc_linked(struct mei_device *dev);
97
98struct mei_cl_cb *mei_cl_read_cb(const struct mei_cl *cl,
99 const struct file *fp);
100struct mei_cl_cb *mei_cl_alloc_cb(struct mei_cl *cl, size_t length,
101 enum mei_cb_file_ops type,
102 const struct file *fp);
103struct mei_cl_cb *mei_cl_enqueue_ctrl_wr_cb(struct mei_cl *cl, size_t length,
104 enum mei_cb_file_ops type,
105 const struct file *fp);
106int mei_cl_flush_queues(struct mei_cl *cl, const struct file *fp);
107
108
109
110
111
112
113
114
115
116
117
118
119static inline bool mei_cl_is_connected(struct mei_cl *cl)
120{
121 return cl->state == MEI_FILE_CONNECTED;
122}
123
124
125
126
127
128
129
130
131static inline u8 mei_cl_me_id(const struct mei_cl *cl)
132{
133 return cl->me_cl ? cl->me_cl->client_id : 0;
134}
135
136
137
138
139
140
141
142
143static inline size_t mei_cl_mtu(const struct mei_cl *cl)
144{
145 return cl->me_cl->props.max_msg_length;
146}
147
148
149
150
151
152
153
154
155static inline bool mei_cl_is_fixed_address(const struct mei_cl *cl)
156{
157 return cl->me_cl && cl->me_cl->props.fixed_address;
158}
159
160
161
162
163
164
165
166
167
168static inline bool mei_cl_is_single_recv_buf(const struct mei_cl *cl)
169{
170 return cl->me_cl->props.single_recv_buf;
171}
172
173
174
175
176
177
178
179
180static inline const uuid_le *mei_cl_uuid(const struct mei_cl *cl)
181{
182 return mei_me_cl_uuid(cl->me_cl);
183}
184
185
186
187
188
189
190
191
192static inline u8 mei_cl_host_addr(const struct mei_cl *cl)
193{
194 return mei_cl_is_fixed_address(cl) ? 0 : cl->host_client_id;
195}
196
197int mei_cl_disconnect(struct mei_cl *cl);
198int mei_cl_irq_disconnect(struct mei_cl *cl, struct mei_cl_cb *cb,
199 struct list_head *cmpl_list);
200int mei_cl_connect(struct mei_cl *cl, struct mei_me_client *me_cl,
201 const struct file *file);
202int mei_cl_irq_connect(struct mei_cl *cl, struct mei_cl_cb *cb,
203 struct list_head *cmpl_list);
204int mei_cl_read_start(struct mei_cl *cl, size_t length, const struct file *fp);
205ssize_t mei_cl_write(struct mei_cl *cl, struct mei_cl_cb *cb);
206int mei_cl_irq_write(struct mei_cl *cl, struct mei_cl_cb *cb,
207 struct list_head *cmpl_list);
208
209void mei_cl_complete(struct mei_cl *cl, struct mei_cl_cb *cb);
210
211void mei_host_client_init(struct mei_device *dev);
212
213u8 mei_cl_notify_fop2req(enum mei_cb_file_ops fop);
214enum mei_cb_file_ops mei_cl_notify_req2fop(u8 request);
215int mei_cl_notify_request(struct mei_cl *cl,
216 const struct file *file, u8 request);
217int mei_cl_irq_notify(struct mei_cl *cl, struct mei_cl_cb *cb,
218 struct list_head *cmpl_list);
219int mei_cl_notify_get(struct mei_cl *cl, bool block, bool *notify_ev);
220void mei_cl_notify(struct mei_cl *cl);
221
222void mei_cl_all_disconnect(struct mei_device *dev);
223
224#define MEI_CL_FMT "cl:host=%02d me=%02d "
225#define MEI_CL_PRM(cl) (cl)->host_client_id, mei_cl_me_id(cl)
226
227#define cl_dbg(dev, cl, format, arg...) \
228 dev_dbg((dev)->dev, MEI_CL_FMT format, MEI_CL_PRM(cl), ##arg)
229
230#define cl_warn(dev, cl, format, arg...) \
231 dev_warn((dev)->dev, MEI_CL_FMT format, MEI_CL_PRM(cl), ##arg)
232
233#define cl_err(dev, cl, format, arg...) \
234 dev_err((dev)->dev, MEI_CL_FMT format, MEI_CL_PRM(cl), ##arg)
235
236#endif
237