3 * Intel Management Engine Interface (Intel MEI) Linux driver
4 * Copyright (c) 2003-2011, Intel Corporation.
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms and conditions of the GNU General Public License,
8 * version 2, as published by the Free Software Foundation.
10 * This program is distributed in the hope it will be useful, but WITHOUT
11 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
18 #include <linux/kernel.h>
20 #include <linux/errno.h>
21 #include <linux/types.h>
22 #include <linux/fcntl.h>
23 #include <linux/aio.h>
24 #include <linux/pci.h>
25 #include <linux/init.h>
26 #include <linux/ioctl.h>
27 #include <linux/cdev.h>
28 #include <linux/list.h>
29 #include <linux/delay.h>
30 #include <linux/sched.h>
31 #include <linux/uuid.h>
32 #include <linux/jiffies.h>
33 #include <linux/uaccess.h>
39 #include "interface.h"
40 #include "mei_version.h"
45 * mei_ioctl_connect_client - the connect to fw client IOCTL function
47 * @dev: the device structure
48 * @data: IOCTL connect data, input and output parameters
49 * @file: private data of the file object
51 * Locking: called under "dev->device_lock" lock
53 * returns 0 on success, <0 on failure.
55 int mei_ioctl_connect_client(struct file
*file
,
56 struct mei_connect_client_data
*data
)
58 struct mei_device
*dev
;
60 struct mei_client
*client
;
62 struct mei_cl
*cl_pos
= NULL
;
63 struct mei_cl
*cl_next
= NULL
;
64 long timeout
= CONNECT_TIMEOUT
;
69 cl
= file
->private_data
;
70 if (WARN_ON(!cl
|| !cl
->dev
))
75 dev_dbg(&dev
->pdev
->dev
, "mei_ioctl_connect_client() Entry\n");
78 /* buffered ioctl cb */
79 cb
= kzalloc(sizeof(struct mei_cl_cb
), GFP_KERNEL
);
84 INIT_LIST_HEAD(&cb
->cb_list
);
86 cb
->major_file_operations
= MEI_IOCTL
;
88 if (dev
->mei_state
!= MEI_ENABLED
) {
92 if (cl
->state
!= MEI_FILE_INITIALIZING
&&
93 cl
->state
!= MEI_FILE_DISCONNECTED
) {
98 /* find ME client we're trying to connect to */
99 i
= mei_find_me_client_index(dev
, data
->in_client_uuid
);
100 if (i
>= 0 && !dev
->me_clients
[i
].props
.fixed_address
) {
101 cl
->me_client_id
= dev
->me_clients
[i
].client_id
;
102 cl
->state
= MEI_FILE_CONNECTING
;
105 dev_dbg(&dev
->pdev
->dev
, "Connect to FW Client ID = %d\n",
107 dev_dbg(&dev
->pdev
->dev
, "FW Client - Protocol Version = %d\n",
108 dev
->me_clients
[i
].props
.protocol_version
);
109 dev_dbg(&dev
->pdev
->dev
, "FW Client - Max Msg Len = %d\n",
110 dev
->me_clients
[i
].props
.max_msg_length
);
112 /* if we're connecting to amthi client so we will use the exist
115 if (uuid_le_cmp(data
->in_client_uuid
, mei_amthi_guid
) == 0) {
116 dev_dbg(&dev
->pdev
->dev
, "FW Client is amthi\n");
117 if (dev
->iamthif_cl
.state
!= MEI_FILE_CONNECTED
) {
121 clear_bit(cl
->host_client_id
, dev
->host_clients_map
);
122 list_for_each_entry_safe(cl_pos
, cl_next
,
123 &dev
->file_list
, link
) {
124 if (mei_cl_cmp_id(cl
, cl_pos
)) {
125 dev_dbg(&dev
->pdev
->dev
,
126 "remove file private data node host"
127 " client = %d, ME client = %d.\n",
128 cl_pos
->host_client_id
,
129 cl_pos
->me_client_id
);
130 list_del(&cl_pos
->link
);
134 dev_dbg(&dev
->pdev
->dev
, "free file private data memory.\n");
138 file
->private_data
= &dev
->iamthif_cl
;
140 client
= &data
->out_client_properties
;
141 client
->max_msg_length
=
142 dev
->me_clients
[i
].props
.max_msg_length
;
143 client
->protocol_version
=
144 dev
->me_clients
[i
].props
.protocol_version
;
145 rets
= dev
->iamthif_cl
.status
;
150 if (cl
->state
!= MEI_FILE_CONNECTING
) {
156 /* prepare the output buffer */
157 client
= &data
->out_client_properties
;
158 client
->max_msg_length
= dev
->me_clients
[i
].props
.max_msg_length
;
159 client
->protocol_version
= dev
->me_clients
[i
].props
.protocol_version
;
160 dev_dbg(&dev
->pdev
->dev
, "Can connect?\n");
161 if (dev
->mei_host_buffer_is_empty
162 && !mei_other_client_is_connecting(dev
, cl
)) {
163 dev_dbg(&dev
->pdev
->dev
, "Sending Connect Message\n");
164 dev
->mei_host_buffer_is_empty
= false;
165 if (!mei_connect(dev
, cl
)) {
166 dev_dbg(&dev
->pdev
->dev
, "Sending connect message - failed\n");
170 dev_dbg(&dev
->pdev
->dev
, "Sending connect message - succeeded\n");
171 cl
->timer_count
= MEI_CONNECT_TIMEOUT
;
172 cb
->file_private
= cl
;
173 list_add_tail(&cb
->cb_list
,
174 &dev
->ctrl_rd_list
.mei_cb
.
180 dev_dbg(&dev
->pdev
->dev
, "Queuing the connect request due to device busy\n");
181 cb
->file_private
= cl
;
182 dev_dbg(&dev
->pdev
->dev
, "add connect cb to control write list.\n");
183 list_add_tail(&cb
->cb_list
,
184 &dev
->ctrl_wr_list
.mei_cb
.cb_list
);
186 mutex_unlock(&dev
->device_lock
);
187 err
= wait_event_timeout(dev
->wait_recvd_msg
,
188 (MEI_FILE_CONNECTED
== cl
->state
||
189 MEI_FILE_DISCONNECTED
== cl
->state
),
192 mutex_lock(&dev
->device_lock
);
193 if (MEI_FILE_CONNECTED
== cl
->state
) {
194 dev_dbg(&dev
->pdev
->dev
, "successfully connected to FW client.\n");
198 dev_dbg(&dev
->pdev
->dev
, "failed to connect to FW client.cl->state = %d.\n",
201 dev_dbg(&dev
->pdev
->dev
,
202 "wait_event_interruptible_timeout failed on client"
203 " connect message fw response message.\n");
207 mei_io_list_flush(&dev
->ctrl_rd_list
, cl
);
208 mei_io_list_flush(&dev
->ctrl_wr_list
, cl
);
213 dev_dbg(&dev
->pdev
->dev
, "free connect cb memory.");
219 * find_amthi_read_list_entry - finds a amthilist entry for current file
221 * @dev: the device structure
222 * @file: pointer to file object
224 * returns returned a list entry on success, NULL on failure.
226 struct mei_cl_cb
*find_amthi_read_list_entry(
227 struct mei_device
*dev
,
230 struct mei_cl
*cl_temp
;
231 struct mei_cl_cb
*pos
= NULL
;
232 struct mei_cl_cb
*next
= NULL
;
234 list_for_each_entry_safe(pos
, next
,
235 &dev
->amthi_read_complete_list
.mei_cb
.cb_list
, cb_list
) {
236 cl_temp
= (struct mei_cl
*)pos
->file_private
;
237 if (cl_temp
&& cl_temp
== &dev
->iamthif_cl
&&
238 pos
->file_object
== file
)
245 * amthi_read - read data from AMTHI client
247 * @dev: the device structure
248 * @if_num: minor number
249 * @file: pointer to file object
250 * @*ubuf: pointer to user data in user space
251 * @length: data length to read
252 * @offset: data read offset
254 * Locking: called under "dev->device_lock" lock
257 * returned data length on success,
258 * zero if no data to read,
259 * negative on failure.
261 int amthi_read(struct mei_device
*dev
, struct file
*file
,
262 char __user
*ubuf
, size_t length
, loff_t
*offset
)
266 struct mei_cl_cb
*cb
= NULL
;
267 struct mei_cl
*cl
= file
->private_data
;
268 unsigned long timeout
;
271 /* Only Posible if we are in timeout */
272 if (!cl
|| cl
!= &dev
->iamthif_cl
) {
273 dev_dbg(&dev
->pdev
->dev
, "bad file ext.\n");
277 for (i
= 0; i
< dev
->me_clients_num
; i
++) {
278 if (dev
->me_clients
[i
].client_id
==
279 dev
->iamthif_cl
.me_client_id
)
283 if (i
== dev
->me_clients_num
) {
284 dev_dbg(&dev
->pdev
->dev
, "amthi client not found.\n");
287 if (WARN_ON(dev
->me_clients
[i
].client_id
!= cl
->me_client_id
))
290 dev_dbg(&dev
->pdev
->dev
, "checking amthi data\n");
291 cb
= find_amthi_read_list_entry(dev
, file
);
293 /* Check for if we can block or not*/
294 if (cb
== NULL
&& file
->f_flags
& O_NONBLOCK
)
298 dev_dbg(&dev
->pdev
->dev
, "waiting for amthi data\n");
300 /* unlock the Mutex */
301 mutex_unlock(&dev
->device_lock
);
303 wait_ret
= wait_event_interruptible(dev
->iamthif_cl
.wait
,
304 (cb
= find_amthi_read_list_entry(dev
, file
)));
309 dev_dbg(&dev
->pdev
->dev
, "woke up from sleep\n");
311 /* Locking again the Mutex */
312 mutex_lock(&dev
->device_lock
);
316 dev_dbg(&dev
->pdev
->dev
, "Got amthi data\n");
317 dev
->iamthif_timer
= 0;
320 timeout
= cb
->read_time
+
321 msecs_to_jiffies(IAMTHIF_READ_TIMER
);
322 dev_dbg(&dev
->pdev
->dev
, "amthi timeout = %lud\n",
325 if (time_after(jiffies
, timeout
)) {
326 dev_dbg(&dev
->pdev
->dev
, "amthi Time out\n");
327 /* 15 sec for the message has expired */
328 list_del(&cb
->cb_list
);
333 /* if the whole message will fit remove it from the list */
334 if (cb
->information
>= *offset
&& length
>= (cb
->information
- *offset
))
335 list_del(&cb
->cb_list
);
336 else if (cb
->information
> 0 && cb
->information
<= *offset
) {
337 /* end of the message has been reached */
338 list_del(&cb
->cb_list
);
342 /* else means that not full buffer will be read and do not
343 * remove message from deletion list
346 dev_dbg(&dev
->pdev
->dev
, "amthi cb->response_buffer size - %d\n",
347 cb
->response_buffer
.size
);
348 dev_dbg(&dev
->pdev
->dev
, "amthi cb->information - %lu\n",
351 /* length is being turncated to PAGE_SIZE, however,
352 * the information may be longer */
353 length
= min_t(size_t, length
, (cb
->information
- *offset
));
355 if (copy_to_user(ubuf
, cb
->response_buffer
.data
+ *offset
, length
))
359 if ((*offset
+ length
) < cb
->information
) {
365 dev_dbg(&dev
->pdev
->dev
, "free amthi cb memory.\n");
367 mei_free_cb_private(cb
);
373 * mei_start_read - the start read client message function.
375 * @dev: the device structure
376 * @if_num: minor number
377 * @cl: private data of the file object
379 * returns 0 on success, <0 on failure.
381 int mei_start_read(struct mei_device
*dev
, struct mei_cl
*cl
)
383 struct mei_cl_cb
*cb
;
387 if (cl
->state
!= MEI_FILE_CONNECTED
)
390 if (dev
->mei_state
!= MEI_ENABLED
)
393 dev_dbg(&dev
->pdev
->dev
, "check if read is pending.\n");
394 if (cl
->read_pending
|| cl
->read_cb
) {
395 dev_dbg(&dev
->pdev
->dev
, "read is pending.\n");
399 cb
= kzalloc(sizeof(struct mei_cl_cb
), GFP_KERNEL
);
403 dev_dbg(&dev
->pdev
->dev
, "allocation call back successful. host client = %d, ME client = %d\n",
404 cl
->host_client_id
, cl
->me_client_id
);
406 for (i
= 0; i
< dev
->me_clients_num
; i
++) {
407 if (dev
->me_clients
[i
].client_id
== cl
->me_client_id
)
412 if (WARN_ON(dev
->me_clients
[i
].client_id
!= cl
->me_client_id
)) {
417 if (i
== dev
->me_clients_num
) {
422 cb
->response_buffer
.size
= dev
->me_clients
[i
].props
.max_msg_length
;
423 cb
->response_buffer
.data
=
424 kmalloc(cb
->response_buffer
.size
, GFP_KERNEL
);
425 if (!cb
->response_buffer
.data
) {
429 dev_dbg(&dev
->pdev
->dev
, "allocation call back data success.\n");
430 cb
->major_file_operations
= MEI_READ
;
431 /* make sure information is zero before we start */
433 cb
->file_private
= (void *) cl
;
435 if (dev
->mei_host_buffer_is_empty
) {
436 dev
->mei_host_buffer_is_empty
= false;
437 if (!mei_send_flow_control(dev
, cl
)) {
441 list_add_tail(&cb
->cb_list
,
442 &dev
->read_list
.mei_cb
.cb_list
);
445 list_add_tail(&cb
->cb_list
, &dev
->ctrl_wr_list
.mei_cb
.cb_list
);
449 mei_free_cb_private(cb
);
454 * amthi_write - write iamthif data to amthi client
456 * @dev: the device structure
457 * @cb: mei call back struct
459 * returns 0 on success, <0 on failure.
461 int amthi_write(struct mei_device
*dev
, struct mei_cl_cb
*cb
)
463 struct mei_msg_hdr mei_hdr
;
469 dev_dbg(&dev
->pdev
->dev
, "write data to amthi client.\n");
471 dev
->iamthif_state
= MEI_IAMTHIF_WRITING
;
472 dev
->iamthif_current_cb
= cb
;
473 dev
->iamthif_file_object
= cb
->file_object
;
474 dev
->iamthif_canceled
= false;
475 dev
->iamthif_ioctl
= true;
476 dev
->iamthif_msg_buf_size
= cb
->request_buffer
.size
;
477 memcpy(dev
->iamthif_msg_buf
, cb
->request_buffer
.data
,
478 cb
->request_buffer
.size
);
480 ret
= mei_flow_ctrl_creds(dev
, &dev
->iamthif_cl
);
484 if (ret
&& dev
->mei_host_buffer_is_empty
) {
486 dev
->mei_host_buffer_is_empty
= false;
487 if (cb
->request_buffer
.size
>
488 (((dev
->host_hw_state
& H_CBD
) >> 24) * sizeof(u32
))
489 -sizeof(struct mei_msg_hdr
)) {
491 (((dev
->host_hw_state
& H_CBD
) >> 24) *
492 sizeof(u32
)) - sizeof(struct mei_msg_hdr
);
493 mei_hdr
.msg_complete
= 0;
495 mei_hdr
.length
= cb
->request_buffer
.size
;
496 mei_hdr
.msg_complete
= 1;
499 mei_hdr
.host_addr
= dev
->iamthif_cl
.host_client_id
;
500 mei_hdr
.me_addr
= dev
->iamthif_cl
.me_client_id
;
501 mei_hdr
.reserved
= 0;
502 dev
->iamthif_msg_buf_index
+= mei_hdr
.length
;
503 if (!mei_write_message(dev
, &mei_hdr
,
504 (unsigned char *)(dev
->iamthif_msg_buf
),
508 if (mei_hdr
.msg_complete
) {
509 if (mei_flow_ctrl_reduce(dev
, &dev
->iamthif_cl
))
511 dev
->iamthif_flow_control_pending
= true;
512 dev
->iamthif_state
= MEI_IAMTHIF_FLOW_CONTROL
;
513 dev_dbg(&dev
->pdev
->dev
, "add amthi cb to write waiting list\n");
514 dev
->iamthif_current_cb
= cb
;
515 dev
->iamthif_file_object
= cb
->file_object
;
516 list_add_tail(&cb
->cb_list
,
517 &dev
->write_waiting_list
.mei_cb
.cb_list
);
519 dev_dbg(&dev
->pdev
->dev
, "message does not complete, "
520 "so add amthi cb to write list.\n");
521 list_add_tail(&cb
->cb_list
,
522 &dev
->write_list
.mei_cb
.cb_list
);
525 if (!(dev
->mei_host_buffer_is_empty
))
526 dev_dbg(&dev
->pdev
->dev
, "host buffer is not empty");
528 dev_dbg(&dev
->pdev
->dev
, "No flow control credentials, "
529 "so add iamthif cb to write list.\n");
530 list_add_tail(&cb
->cb_list
, &dev
->write_list
.mei_cb
.cb_list
);
536 * iamthif_ioctl_send_msg - send cmd data to amthi client
538 * @dev: the device structure
540 * returns 0 on success, <0 on failure.
542 void mei_run_next_iamthif_cmd(struct mei_device
*dev
)
544 struct mei_cl
*cl_tmp
;
545 struct mei_cl_cb
*pos
= NULL
;
546 struct mei_cl_cb
*next
= NULL
;
552 dev
->iamthif_msg_buf_size
= 0;
553 dev
->iamthif_msg_buf_index
= 0;
554 dev
->iamthif_canceled
= false;
555 dev
->iamthif_ioctl
= true;
556 dev
->iamthif_state
= MEI_IAMTHIF_IDLE
;
557 dev
->iamthif_timer
= 0;
558 dev
->iamthif_file_object
= NULL
;
560 dev_dbg(&dev
->pdev
->dev
, "complete amthi cmd_list cb.\n");
562 list_for_each_entry_safe(pos
, next
,
563 &dev
->amthi_cmd_list
.mei_cb
.cb_list
, cb_list
) {
564 list_del(&pos
->cb_list
);
565 cl_tmp
= (struct mei_cl
*)pos
->file_private
;
567 if (cl_tmp
&& cl_tmp
== &dev
->iamthif_cl
) {
568 status
= amthi_write(dev
, pos
);
570 dev_dbg(&dev
->pdev
->dev
,
571 "amthi write failed status = %d\n",
581 * mei_free_cb_private - free mei_cb_private related memory
583 * @cb: mei callback struct
585 void mei_free_cb_private(struct mei_cl_cb
*cb
)
590 kfree(cb
->request_buffer
.data
);
591 kfree(cb
->response_buffer
.data
);