3 * Intel Management Engine Interface (Intel MEI) Linux driver
4 * Copyright (c) 2003-2012, 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
17 #include <linux/sched/signal.h>
18 #include <linux/wait.h>
19 #include <linux/delay.h>
20 #include <linux/slab.h>
21 #include <linux/pm_runtime.h>
23 #include <linux/mei.h>
30 * mei_me_cl_init - initialize me client
34 void mei_me_cl_init(struct mei_me_client
*me_cl
)
36 INIT_LIST_HEAD(&me_cl
->list
);
37 kref_init(&me_cl
->refcnt
);
41 * mei_me_cl_get - increases me client refcount
45 * Locking: called under "dev->device_lock" lock
47 * Return: me client or NULL
49 struct mei_me_client
*mei_me_cl_get(struct mei_me_client
*me_cl
)
51 if (me_cl
&& kref_get_unless_zero(&me_cl
->refcnt
))
58 * mei_me_cl_release - free me client
60 * Locking: called under "dev->device_lock" lock
62 * @ref: me_client refcount
64 static void mei_me_cl_release(struct kref
*ref
)
66 struct mei_me_client
*me_cl
=
67 container_of(ref
, struct mei_me_client
, refcnt
);
73 * mei_me_cl_put - decrease me client refcount and free client if necessary
75 * Locking: called under "dev->device_lock" lock
79 void mei_me_cl_put(struct mei_me_client
*me_cl
)
82 kref_put(&me_cl
->refcnt
, mei_me_cl_release
);
86 * __mei_me_cl_del - delete me client from the list and decrease
92 * Locking: dev->me_clients_rwsem
94 static void __mei_me_cl_del(struct mei_device
*dev
, struct mei_me_client
*me_cl
)
99 list_del_init(&me_cl
->list
);
100 mei_me_cl_put(me_cl
);
104 * mei_me_cl_del - delete me client from the list and decrease
110 void mei_me_cl_del(struct mei_device
*dev
, struct mei_me_client
*me_cl
)
112 down_write(&dev
->me_clients_rwsem
);
113 __mei_me_cl_del(dev
, me_cl
);
114 up_write(&dev
->me_clients_rwsem
);
118 * mei_me_cl_add - add me client to the list
123 void mei_me_cl_add(struct mei_device
*dev
, struct mei_me_client
*me_cl
)
125 down_write(&dev
->me_clients_rwsem
);
126 list_add(&me_cl
->list
, &dev
->me_clients
);
127 up_write(&dev
->me_clients_rwsem
);
131 * __mei_me_cl_by_uuid - locate me client by uuid
132 * increases ref count
135 * @uuid: me client uuid
137 * Return: me client or NULL if not found
139 * Locking: dev->me_clients_rwsem
141 static struct mei_me_client
*__mei_me_cl_by_uuid(struct mei_device
*dev
,
144 struct mei_me_client
*me_cl
;
147 WARN_ON(!rwsem_is_locked(&dev
->me_clients_rwsem
));
149 list_for_each_entry(me_cl
, &dev
->me_clients
, list
) {
150 pn
= &me_cl
->props
.protocol_name
;
151 if (uuid_le_cmp(*uuid
, *pn
) == 0)
152 return mei_me_cl_get(me_cl
);
159 * mei_me_cl_by_uuid - locate me client by uuid
160 * increases ref count
163 * @uuid: me client uuid
165 * Return: me client or NULL if not found
167 * Locking: dev->me_clients_rwsem
169 struct mei_me_client
*mei_me_cl_by_uuid(struct mei_device
*dev
,
172 struct mei_me_client
*me_cl
;
174 down_read(&dev
->me_clients_rwsem
);
175 me_cl
= __mei_me_cl_by_uuid(dev
, uuid
);
176 up_read(&dev
->me_clients_rwsem
);
182 * mei_me_cl_by_id - locate me client by client id
183 * increases ref count
185 * @dev: the device structure
186 * @client_id: me client id
188 * Return: me client or NULL if not found
190 * Locking: dev->me_clients_rwsem
192 struct mei_me_client
*mei_me_cl_by_id(struct mei_device
*dev
, u8 client_id
)
195 struct mei_me_client
*__me_cl
, *me_cl
= NULL
;
197 down_read(&dev
->me_clients_rwsem
);
198 list_for_each_entry(__me_cl
, &dev
->me_clients
, list
) {
199 if (__me_cl
->client_id
== client_id
) {
200 me_cl
= mei_me_cl_get(__me_cl
);
204 up_read(&dev
->me_clients_rwsem
);
210 * __mei_me_cl_by_uuid_id - locate me client by client id and uuid
211 * increases ref count
213 * @dev: the device structure
214 * @uuid: me client uuid
215 * @client_id: me client id
217 * Return: me client or null if not found
219 * Locking: dev->me_clients_rwsem
221 static struct mei_me_client
*__mei_me_cl_by_uuid_id(struct mei_device
*dev
,
222 const uuid_le
*uuid
, u8 client_id
)
224 struct mei_me_client
*me_cl
;
227 WARN_ON(!rwsem_is_locked(&dev
->me_clients_rwsem
));
229 list_for_each_entry(me_cl
, &dev
->me_clients
, list
) {
230 pn
= &me_cl
->props
.protocol_name
;
231 if (uuid_le_cmp(*uuid
, *pn
) == 0 &&
232 me_cl
->client_id
== client_id
)
233 return mei_me_cl_get(me_cl
);
241 * mei_me_cl_by_uuid_id - locate me client by client id and uuid
242 * increases ref count
244 * @dev: the device structure
245 * @uuid: me client uuid
246 * @client_id: me client id
248 * Return: me client or null if not found
250 struct mei_me_client
*mei_me_cl_by_uuid_id(struct mei_device
*dev
,
251 const uuid_le
*uuid
, u8 client_id
)
253 struct mei_me_client
*me_cl
;
255 down_read(&dev
->me_clients_rwsem
);
256 me_cl
= __mei_me_cl_by_uuid_id(dev
, uuid
, client_id
);
257 up_read(&dev
->me_clients_rwsem
);
263 * mei_me_cl_rm_by_uuid - remove all me clients matching uuid
265 * @dev: the device structure
266 * @uuid: me client uuid
268 * Locking: called under "dev->device_lock" lock
270 void mei_me_cl_rm_by_uuid(struct mei_device
*dev
, const uuid_le
*uuid
)
272 struct mei_me_client
*me_cl
;
274 dev_dbg(dev
->dev
, "remove %pUl\n", uuid
);
276 down_write(&dev
->me_clients_rwsem
);
277 me_cl
= __mei_me_cl_by_uuid(dev
, uuid
);
278 __mei_me_cl_del(dev
, me_cl
);
279 mei_me_cl_put(me_cl
);
280 up_write(&dev
->me_clients_rwsem
);
284 * mei_me_cl_rm_by_uuid_id - remove all me clients matching client id
286 * @dev: the device structure
287 * @uuid: me client uuid
290 * Locking: called under "dev->device_lock" lock
292 void mei_me_cl_rm_by_uuid_id(struct mei_device
*dev
, const uuid_le
*uuid
, u8 id
)
294 struct mei_me_client
*me_cl
;
296 dev_dbg(dev
->dev
, "remove %pUl %d\n", uuid
, id
);
298 down_write(&dev
->me_clients_rwsem
);
299 me_cl
= __mei_me_cl_by_uuid_id(dev
, uuid
, id
);
300 __mei_me_cl_del(dev
, me_cl
);
301 mei_me_cl_put(me_cl
);
302 up_write(&dev
->me_clients_rwsem
);
306 * mei_me_cl_rm_all - remove all me clients
308 * @dev: the device structure
310 * Locking: called under "dev->device_lock" lock
312 void mei_me_cl_rm_all(struct mei_device
*dev
)
314 struct mei_me_client
*me_cl
, *next
;
316 down_write(&dev
->me_clients_rwsem
);
317 list_for_each_entry_safe(me_cl
, next
, &dev
->me_clients
, list
)
318 __mei_me_cl_del(dev
, me_cl
);
319 up_write(&dev
->me_clients_rwsem
);
323 * mei_cl_cmp_id - tells if the clients are the same
325 * @cl1: host client 1
326 * @cl2: host client 2
328 * Return: true - if the clients has same host and me ids
331 static inline bool mei_cl_cmp_id(const struct mei_cl
*cl1
,
332 const struct mei_cl
*cl2
)
335 (cl1
->host_client_id
== cl2
->host_client_id
) &&
336 (mei_cl_me_id(cl1
) == mei_cl_me_id(cl2
));
340 * mei_io_cb_free - free mei_cb_private related memory
342 * @cb: mei callback struct
344 void mei_io_cb_free(struct mei_cl_cb
*cb
)
355 * mei_tx_cb_queue - queue tx callback
357 * Locking: called under "dev->device_lock" lock
359 * @cb: mei callback struct
360 * @head: an instance of list to queue on
362 static inline void mei_tx_cb_enqueue(struct mei_cl_cb
*cb
,
363 struct list_head
*head
)
365 list_add_tail(&cb
->list
, head
);
366 cb
->cl
->tx_cb_queued
++;
370 * mei_tx_cb_dequeue - dequeue tx callback
372 * Locking: called under "dev->device_lock" lock
374 * @cb: mei callback struct to dequeue and free
376 static inline void mei_tx_cb_dequeue(struct mei_cl_cb
*cb
)
378 if (!WARN_ON(cb
->cl
->tx_cb_queued
== 0))
379 cb
->cl
->tx_cb_queued
--;
385 * mei_io_cb_init - allocate and initialize io callback
388 * @type: operation type
389 * @fp: pointer to file structure
391 * Return: mei_cl_cb pointer or NULL;
393 static struct mei_cl_cb
*mei_io_cb_init(struct mei_cl
*cl
,
394 enum mei_cb_file_ops type
,
395 const struct file
*fp
)
397 struct mei_cl_cb
*cb
;
399 cb
= kzalloc(sizeof(struct mei_cl_cb
), GFP_KERNEL
);
403 INIT_LIST_HEAD(&cb
->list
);
412 * mei_io_list_flush_cl - removes cbs belonging to the cl.
414 * @head: an instance of our list structure
417 static void mei_io_list_flush_cl(struct list_head
*head
,
418 const struct mei_cl
*cl
)
420 struct mei_cl_cb
*cb
, *next
;
422 list_for_each_entry_safe(cb
, next
, head
, list
) {
423 if (mei_cl_cmp_id(cl
, cb
->cl
))
424 list_del_init(&cb
->list
);
429 * mei_io_tx_list_free_cl - removes cb belonging to the cl and free them
431 * @head: An instance of our list structure
434 static void mei_io_tx_list_free_cl(struct list_head
*head
,
435 const struct mei_cl
*cl
)
437 struct mei_cl_cb
*cb
, *next
;
439 list_for_each_entry_safe(cb
, next
, head
, list
) {
440 if (mei_cl_cmp_id(cl
, cb
->cl
))
441 mei_tx_cb_dequeue(cb
);
446 * mei_io_list_free_fp - free cb from a list that matches file pointer
449 * @fp: file pointer (matching cb file object), may be NULL
451 static void mei_io_list_free_fp(struct list_head
*head
, const struct file
*fp
)
453 struct mei_cl_cb
*cb
, *next
;
455 list_for_each_entry_safe(cb
, next
, head
, list
)
456 if (!fp
|| fp
== cb
->fp
)
461 * mei_cl_alloc_cb - a convenient wrapper for allocating read cb
464 * @length: size of the buffer
465 * @fop_type: operation type
466 * @fp: associated file pointer (might be NULL)
468 * Return: cb on success and NULL on failure
470 struct mei_cl_cb
*mei_cl_alloc_cb(struct mei_cl
*cl
, size_t length
,
471 enum mei_cb_file_ops fop_type
,
472 const struct file
*fp
)
474 struct mei_cl_cb
*cb
;
476 cb
= mei_io_cb_init(cl
, fop_type
, fp
);
483 cb
->buf
.data
= kmalloc(length
, GFP_KERNEL
);
488 cb
->buf
.size
= length
;
494 * mei_cl_enqueue_ctrl_wr_cb - a convenient wrapper for allocating
495 * and enqueuing of the control commands cb
498 * @length: size of the buffer
499 * @fop_type: operation type
500 * @fp: associated file pointer (might be NULL)
502 * Return: cb on success and NULL on failure
503 * Locking: called under "dev->device_lock" lock
505 struct mei_cl_cb
*mei_cl_enqueue_ctrl_wr_cb(struct mei_cl
*cl
, size_t length
,
506 enum mei_cb_file_ops fop_type
,
507 const struct file
*fp
)
509 struct mei_cl_cb
*cb
;
511 /* for RX always allocate at least client's mtu */
513 length
= max_t(size_t, length
, mei_cl_mtu(cl
));
515 cb
= mei_cl_alloc_cb(cl
, length
, fop_type
, fp
);
519 list_add_tail(&cb
->list
, &cl
->dev
->ctrl_wr_list
);
524 * mei_cl_read_cb - find this cl's callback in the read list
525 * for a specific file
528 * @fp: file pointer (matching cb file object), may be NULL
530 * Return: cb on success, NULL if cb is not found
532 struct mei_cl_cb
*mei_cl_read_cb(const struct mei_cl
*cl
, const struct file
*fp
)
534 struct mei_cl_cb
*cb
;
536 list_for_each_entry(cb
, &cl
->rd_completed
, list
)
537 if (!fp
|| fp
== cb
->fp
)
544 * mei_cl_flush_queues - flushes queue lists belonging to cl.
547 * @fp: file pointer (matching cb file object), may be NULL
549 * Return: 0 on success, -EINVAL if cl or cl->dev is NULL.
551 int mei_cl_flush_queues(struct mei_cl
*cl
, const struct file
*fp
)
553 struct mei_device
*dev
;
555 if (WARN_ON(!cl
|| !cl
->dev
))
560 cl_dbg(dev
, cl
, "remove list entry belonging to cl\n");
561 mei_io_tx_list_free_cl(&cl
->dev
->write_list
, cl
);
562 mei_io_tx_list_free_cl(&cl
->dev
->write_waiting_list
, cl
);
563 mei_io_list_flush_cl(&cl
->dev
->ctrl_wr_list
, cl
);
564 mei_io_list_flush_cl(&cl
->dev
->ctrl_rd_list
, cl
);
565 mei_io_list_free_fp(&cl
->rd_pending
, fp
);
566 mei_io_list_free_fp(&cl
->rd_completed
, fp
);
572 * mei_cl_init - initializes cl.
574 * @cl: host client to be initialized
577 static void mei_cl_init(struct mei_cl
*cl
, struct mei_device
*dev
)
579 memset(cl
, 0, sizeof(struct mei_cl
));
580 init_waitqueue_head(&cl
->wait
);
581 init_waitqueue_head(&cl
->rx_wait
);
582 init_waitqueue_head(&cl
->tx_wait
);
583 init_waitqueue_head(&cl
->ev_wait
);
584 INIT_LIST_HEAD(&cl
->rd_completed
);
585 INIT_LIST_HEAD(&cl
->rd_pending
);
586 INIT_LIST_HEAD(&cl
->link
);
587 cl
->writing_state
= MEI_IDLE
;
588 cl
->state
= MEI_FILE_UNINITIALIZED
;
593 * mei_cl_allocate - allocates cl structure and sets it up.
596 * Return: The allocated file or NULL on failure
598 struct mei_cl
*mei_cl_allocate(struct mei_device
*dev
)
602 cl
= kmalloc(sizeof(struct mei_cl
), GFP_KERNEL
);
606 mei_cl_init(cl
, dev
);
612 * mei_cl_link - allocate host id in the host map
616 * Return: 0 on success
617 * -EINVAL on incorrect values
618 * -EMFILE if open count exceeded.
620 int mei_cl_link(struct mei_cl
*cl
)
622 struct mei_device
*dev
;
625 if (WARN_ON(!cl
|| !cl
->dev
))
630 id
= find_first_zero_bit(dev
->host_clients_map
, MEI_CLIENTS_MAX
);
631 if (id
>= MEI_CLIENTS_MAX
) {
632 dev_err(dev
->dev
, "id exceeded %d", MEI_CLIENTS_MAX
);
636 if (dev
->open_handle_count
>= MEI_MAX_OPEN_HANDLE_COUNT
) {
637 dev_err(dev
->dev
, "open_handle_count exceeded %d",
638 MEI_MAX_OPEN_HANDLE_COUNT
);
642 dev
->open_handle_count
++;
644 cl
->host_client_id
= id
;
645 list_add_tail(&cl
->link
, &dev
->file_list
);
647 set_bit(id
, dev
->host_clients_map
);
649 cl
->state
= MEI_FILE_INITIALIZING
;
651 cl_dbg(dev
, cl
, "link cl\n");
656 * mei_cl_unlink - remove host client from the list
662 int mei_cl_unlink(struct mei_cl
*cl
)
664 struct mei_device
*dev
;
666 /* don't shout on error exit path */
670 if (WARN_ON(!cl
->dev
))
675 cl_dbg(dev
, cl
, "unlink client");
677 if (dev
->open_handle_count
> 0)
678 dev
->open_handle_count
--;
680 /* never clear the 0 bit */
681 if (cl
->host_client_id
)
682 clear_bit(cl
->host_client_id
, dev
->host_clients_map
);
684 list_del_init(&cl
->link
);
686 cl
->state
= MEI_FILE_UNINITIALIZED
;
687 cl
->writing_state
= MEI_IDLE
;
689 WARN_ON(!list_empty(&cl
->rd_completed
) ||
690 !list_empty(&cl
->rd_pending
) ||
691 !list_empty(&cl
->link
));
696 void mei_host_client_init(struct mei_device
*dev
)
698 dev
->dev_state
= MEI_DEV_ENABLED
;
699 dev
->reset_count
= 0;
701 schedule_work(&dev
->bus_rescan_work
);
703 pm_runtime_mark_last_busy(dev
->dev
);
704 dev_dbg(dev
->dev
, "rpm: autosuspend\n");
705 pm_request_autosuspend(dev
->dev
);
709 * mei_hbuf_acquire - try to acquire host buffer
711 * @dev: the device structure
712 * Return: true if host buffer was acquired
714 bool mei_hbuf_acquire(struct mei_device
*dev
)
716 if (mei_pg_state(dev
) == MEI_PG_ON
||
717 mei_pg_in_transition(dev
)) {
718 dev_dbg(dev
->dev
, "device is in pg\n");
722 if (!dev
->hbuf_is_ready
) {
723 dev_dbg(dev
->dev
, "hbuf is not ready\n");
727 dev
->hbuf_is_ready
= false;
733 * mei_cl_wake_all - wake up readers, writers and event waiters so
734 * they can be interrupted
738 static void mei_cl_wake_all(struct mei_cl
*cl
)
740 struct mei_device
*dev
= cl
->dev
;
742 /* synchronized under device mutex */
743 if (waitqueue_active(&cl
->rx_wait
)) {
744 cl_dbg(dev
, cl
, "Waking up reading client!\n");
745 wake_up_interruptible(&cl
->rx_wait
);
747 /* synchronized under device mutex */
748 if (waitqueue_active(&cl
->tx_wait
)) {
749 cl_dbg(dev
, cl
, "Waking up writing client!\n");
750 wake_up_interruptible(&cl
->tx_wait
);
752 /* synchronized under device mutex */
753 if (waitqueue_active(&cl
->ev_wait
)) {
754 cl_dbg(dev
, cl
, "Waking up waiting for event clients!\n");
755 wake_up_interruptible(&cl
->ev_wait
);
757 /* synchronized under device mutex */
758 if (waitqueue_active(&cl
->wait
)) {
759 cl_dbg(dev
, cl
, "Waking up ctrl write clients!\n");
765 * mei_cl_set_disconnected - set disconnected state and clear
766 * associated states and resources
770 static void mei_cl_set_disconnected(struct mei_cl
*cl
)
772 struct mei_device
*dev
= cl
->dev
;
774 if (cl
->state
== MEI_FILE_DISCONNECTED
||
775 cl
->state
<= MEI_FILE_INITIALIZING
)
778 cl
->state
= MEI_FILE_DISCONNECTED
;
779 mei_io_tx_list_free_cl(&dev
->write_list
, cl
);
780 mei_io_tx_list_free_cl(&dev
->write_waiting_list
, cl
);
781 mei_io_list_flush_cl(&dev
->ctrl_rd_list
, cl
);
782 mei_io_list_flush_cl(&dev
->ctrl_wr_list
, cl
);
784 cl
->rx_flow_ctrl_creds
= 0;
785 cl
->tx_flow_ctrl_creds
= 0;
791 if (!WARN_ON(cl
->me_cl
->connect_count
== 0))
792 cl
->me_cl
->connect_count
--;
794 if (cl
->me_cl
->connect_count
== 0)
795 cl
->me_cl
->tx_flow_ctrl_creds
= 0;
797 mei_me_cl_put(cl
->me_cl
);
801 static int mei_cl_set_connecting(struct mei_cl
*cl
, struct mei_me_client
*me_cl
)
803 if (!mei_me_cl_get(me_cl
))
806 /* only one connection is allowed for fixed address clients */
807 if (me_cl
->props
.fixed_address
) {
808 if (me_cl
->connect_count
) {
809 mei_me_cl_put(me_cl
);
815 cl
->state
= MEI_FILE_CONNECTING
;
816 cl
->me_cl
->connect_count
++;
822 * mei_cl_send_disconnect - send disconnect request
825 * @cb: callback block
827 * Return: 0, OK; otherwise, error.
829 static int mei_cl_send_disconnect(struct mei_cl
*cl
, struct mei_cl_cb
*cb
)
831 struct mei_device
*dev
;
836 ret
= mei_hbm_cl_disconnect_req(dev
, cl
);
839 cl
->state
= MEI_FILE_DISCONNECT_REPLY
;
843 list_move_tail(&cb
->list
, &dev
->ctrl_rd_list
);
844 cl
->timer_count
= MEI_CONNECT_TIMEOUT
;
845 mei_schedule_stall_timer(dev
);
851 * mei_cl_irq_disconnect - processes close related operation from
852 * interrupt thread context - send disconnect request
855 * @cb: callback block.
856 * @cmpl_list: complete list.
858 * Return: 0, OK; otherwise, error.
860 int mei_cl_irq_disconnect(struct mei_cl
*cl
, struct mei_cl_cb
*cb
,
861 struct list_head
*cmpl_list
)
863 struct mei_device
*dev
= cl
->dev
;
868 msg_slots
= mei_hbm2slots(sizeof(struct hbm_client_connect_request
));
869 slots
= mei_hbuf_empty_slots(dev
);
873 if ((u32
)slots
< msg_slots
)
876 ret
= mei_cl_send_disconnect(cl
, cb
);
878 list_move_tail(&cb
->list
, cmpl_list
);
884 * __mei_cl_disconnect - disconnect host client from the me one
885 * internal function runtime pm has to be already acquired
889 * Return: 0 on success, <0 on failure.
891 static int __mei_cl_disconnect(struct mei_cl
*cl
)
893 struct mei_device
*dev
;
894 struct mei_cl_cb
*cb
;
899 cl
->state
= MEI_FILE_DISCONNECTING
;
901 cb
= mei_cl_enqueue_ctrl_wr_cb(cl
, 0, MEI_FOP_DISCONNECT
, NULL
);
907 if (mei_hbuf_acquire(dev
)) {
908 rets
= mei_cl_send_disconnect(cl
, cb
);
910 cl_err(dev
, cl
, "failed to disconnect.\n");
915 mutex_unlock(&dev
->device_lock
);
916 wait_event_timeout(cl
->wait
,
917 cl
->state
== MEI_FILE_DISCONNECT_REPLY
||
918 cl
->state
== MEI_FILE_DISCONNECTED
,
919 mei_secs_to_jiffies(MEI_CL_CONNECT_TIMEOUT
));
920 mutex_lock(&dev
->device_lock
);
923 if (cl
->state
!= MEI_FILE_DISCONNECT_REPLY
&&
924 cl
->state
!= MEI_FILE_DISCONNECTED
) {
925 cl_dbg(dev
, cl
, "timeout on disconnect from FW client.\n");
930 /* we disconnect also on error */
931 mei_cl_set_disconnected(cl
);
933 cl_dbg(dev
, cl
, "successfully disconnected from FW client.\n");
940 * mei_cl_disconnect - disconnect host client from the me one
944 * Locking: called under "dev->device_lock" lock
946 * Return: 0 on success, <0 on failure.
948 int mei_cl_disconnect(struct mei_cl
*cl
)
950 struct mei_device
*dev
;
953 if (WARN_ON(!cl
|| !cl
->dev
))
958 cl_dbg(dev
, cl
, "disconnecting");
960 if (!mei_cl_is_connected(cl
))
963 if (mei_cl_is_fixed_address(cl
)) {
964 mei_cl_set_disconnected(cl
);
968 if (dev
->dev_state
== MEI_DEV_POWER_DOWN
) {
969 cl_dbg(dev
, cl
, "Device is powering down, don't bother with disconnection\n");
970 mei_cl_set_disconnected(cl
);
974 rets
= pm_runtime_get(dev
->dev
);
975 if (rets
< 0 && rets
!= -EINPROGRESS
) {
976 pm_runtime_put_noidle(dev
->dev
);
977 cl_err(dev
, cl
, "rpm: get failed %d\n", rets
);
981 rets
= __mei_cl_disconnect(cl
);
983 cl_dbg(dev
, cl
, "rpm: autosuspend\n");
984 pm_runtime_mark_last_busy(dev
->dev
);
985 pm_runtime_put_autosuspend(dev
->dev
);
992 * mei_cl_is_other_connecting - checks if other
993 * client with the same me client id is connecting
995 * @cl: private data of the file object
997 * Return: true if other client is connected, false - otherwise.
999 static bool mei_cl_is_other_connecting(struct mei_cl
*cl
)
1001 struct mei_device
*dev
;
1002 struct mei_cl_cb
*cb
;
1006 list_for_each_entry(cb
, &dev
->ctrl_rd_list
, list
) {
1007 if (cb
->fop_type
== MEI_FOP_CONNECT
&&
1008 mei_cl_me_id(cl
) == mei_cl_me_id(cb
->cl
))
1016 * mei_cl_send_connect - send connect request
1019 * @cb: callback block
1021 * Return: 0, OK; otherwise, error.
1023 static int mei_cl_send_connect(struct mei_cl
*cl
, struct mei_cl_cb
*cb
)
1025 struct mei_device
*dev
;
1030 ret
= mei_hbm_cl_connect_req(dev
, cl
);
1033 cl
->state
= MEI_FILE_DISCONNECT_REPLY
;
1037 list_move_tail(&cb
->list
, &dev
->ctrl_rd_list
);
1038 cl
->timer_count
= MEI_CONNECT_TIMEOUT
;
1039 mei_schedule_stall_timer(dev
);
1044 * mei_cl_irq_connect - send connect request in irq_thread context
1047 * @cb: callback block
1048 * @cmpl_list: complete list
1050 * Return: 0, OK; otherwise, error.
1052 int mei_cl_irq_connect(struct mei_cl
*cl
, struct mei_cl_cb
*cb
,
1053 struct list_head
*cmpl_list
)
1055 struct mei_device
*dev
= cl
->dev
;
1060 if (mei_cl_is_other_connecting(cl
))
1063 msg_slots
= mei_hbm2slots(sizeof(struct hbm_client_connect_request
));
1064 slots
= mei_hbuf_empty_slots(dev
);
1068 if ((u32
)slots
< msg_slots
)
1071 rets
= mei_cl_send_connect(cl
, cb
);
1073 list_move_tail(&cb
->list
, cmpl_list
);
1079 * mei_cl_connect - connect host client to the me one
1083 * @fp: pointer to file structure
1085 * Locking: called under "dev->device_lock" lock
1087 * Return: 0 on success, <0 on failure.
1089 int mei_cl_connect(struct mei_cl
*cl
, struct mei_me_client
*me_cl
,
1090 const struct file
*fp
)
1092 struct mei_device
*dev
;
1093 struct mei_cl_cb
*cb
;
1096 if (WARN_ON(!cl
|| !cl
->dev
|| !me_cl
))
1101 rets
= mei_cl_set_connecting(cl
, me_cl
);
1105 if (mei_cl_is_fixed_address(cl
)) {
1106 cl
->state
= MEI_FILE_CONNECTED
;
1111 rets
= pm_runtime_get(dev
->dev
);
1112 if (rets
< 0 && rets
!= -EINPROGRESS
) {
1113 pm_runtime_put_noidle(dev
->dev
);
1114 cl_err(dev
, cl
, "rpm: get failed %d\n", rets
);
1118 cb
= mei_cl_enqueue_ctrl_wr_cb(cl
, 0, MEI_FOP_CONNECT
, fp
);
1124 /* run hbuf acquire last so we don't have to undo */
1125 if (!mei_cl_is_other_connecting(cl
) && mei_hbuf_acquire(dev
)) {
1126 rets
= mei_cl_send_connect(cl
, cb
);
1131 mutex_unlock(&dev
->device_lock
);
1132 wait_event_timeout(cl
->wait
,
1133 (cl
->state
== MEI_FILE_CONNECTED
||
1134 cl
->state
== MEI_FILE_DISCONNECTED
||
1135 cl
->state
== MEI_FILE_DISCONNECT_REQUIRED
||
1136 cl
->state
== MEI_FILE_DISCONNECT_REPLY
),
1137 mei_secs_to_jiffies(MEI_CL_CONNECT_TIMEOUT
));
1138 mutex_lock(&dev
->device_lock
);
1140 if (!mei_cl_is_connected(cl
)) {
1141 if (cl
->state
== MEI_FILE_DISCONNECT_REQUIRED
) {
1142 mei_io_list_flush_cl(&dev
->ctrl_rd_list
, cl
);
1143 mei_io_list_flush_cl(&dev
->ctrl_wr_list
, cl
);
1144 /* ignore disconnect return valuue;
1145 * in case of failure reset will be invoked
1147 __mei_cl_disconnect(cl
);
1152 /* timeout or something went really wrong */
1154 cl
->status
= -EFAULT
;
1159 cl_dbg(dev
, cl
, "rpm: autosuspend\n");
1160 pm_runtime_mark_last_busy(dev
->dev
);
1161 pm_runtime_put_autosuspend(dev
->dev
);
1166 if (!mei_cl_is_connected(cl
))
1167 mei_cl_set_disconnected(cl
);
1173 * mei_cl_alloc_linked - allocate and link host client
1175 * @dev: the device structure
1177 * Return: cl on success ERR_PTR on failure
1179 struct mei_cl
*mei_cl_alloc_linked(struct mei_device
*dev
)
1184 cl
= mei_cl_allocate(dev
);
1190 ret
= mei_cl_link(cl
);
1197 return ERR_PTR(ret
);
1201 * mei_cl_tx_flow_ctrl_creds - checks flow_control credits for cl.
1205 * Return: 1 if tx_flow_ctrl_creds >0, 0 - otherwise.
1207 static int mei_cl_tx_flow_ctrl_creds(struct mei_cl
*cl
)
1209 if (WARN_ON(!cl
|| !cl
->me_cl
))
1212 if (cl
->tx_flow_ctrl_creds
> 0)
1215 if (mei_cl_is_fixed_address(cl
))
1218 if (mei_cl_is_single_recv_buf(cl
)) {
1219 if (cl
->me_cl
->tx_flow_ctrl_creds
> 0)
1226 * mei_cl_tx_flow_ctrl_creds_reduce - reduces transmit flow control credits
1233 * -EINVAL when ctrl credits are <= 0
1235 static int mei_cl_tx_flow_ctrl_creds_reduce(struct mei_cl
*cl
)
1237 if (WARN_ON(!cl
|| !cl
->me_cl
))
1240 if (mei_cl_is_fixed_address(cl
))
1243 if (mei_cl_is_single_recv_buf(cl
)) {
1244 if (WARN_ON(cl
->me_cl
->tx_flow_ctrl_creds
<= 0))
1246 cl
->me_cl
->tx_flow_ctrl_creds
--;
1248 if (WARN_ON(cl
->tx_flow_ctrl_creds
<= 0))
1250 cl
->tx_flow_ctrl_creds
--;
1256 * mei_cl_notify_fop2req - convert fop to proper request
1258 * @fop: client notification start response command
1260 * Return: MEI_HBM_NOTIFICATION_START/STOP
1262 u8
mei_cl_notify_fop2req(enum mei_cb_file_ops fop
)
1264 if (fop
== MEI_FOP_NOTIFY_START
)
1265 return MEI_HBM_NOTIFICATION_START
;
1267 return MEI_HBM_NOTIFICATION_STOP
;
1271 * mei_cl_notify_req2fop - convert notification request top file operation type
1273 * @req: hbm notification request type
1275 * Return: MEI_FOP_NOTIFY_START/STOP
1277 enum mei_cb_file_ops
mei_cl_notify_req2fop(u8 req
)
1279 if (req
== MEI_HBM_NOTIFICATION_START
)
1280 return MEI_FOP_NOTIFY_START
;
1282 return MEI_FOP_NOTIFY_STOP
;
1286 * mei_cl_irq_notify - send notification request in irq_thread context
1289 * @cb: callback block.
1290 * @cmpl_list: complete list.
1292 * Return: 0 on such and error otherwise.
1294 int mei_cl_irq_notify(struct mei_cl
*cl
, struct mei_cl_cb
*cb
,
1295 struct list_head
*cmpl_list
)
1297 struct mei_device
*dev
= cl
->dev
;
1303 msg_slots
= mei_hbm2slots(sizeof(struct hbm_client_connect_request
));
1304 slots
= mei_hbuf_empty_slots(dev
);
1308 if ((u32
)slots
< msg_slots
)
1311 request
= mei_cl_notify_fop2req(cb
->fop_type
);
1312 ret
= mei_hbm_cl_notify_req(dev
, cl
, request
);
1315 list_move_tail(&cb
->list
, cmpl_list
);
1319 list_move_tail(&cb
->list
, &dev
->ctrl_rd_list
);
1324 * mei_cl_notify_request - send notification stop/start request
1327 * @fp: associate request with file
1328 * @request: 1 for start or 0 for stop
1330 * Locking: called under "dev->device_lock" lock
1332 * Return: 0 on such and error otherwise.
1334 int mei_cl_notify_request(struct mei_cl
*cl
,
1335 const struct file
*fp
, u8 request
)
1337 struct mei_device
*dev
;
1338 struct mei_cl_cb
*cb
;
1339 enum mei_cb_file_ops fop_type
;
1342 if (WARN_ON(!cl
|| !cl
->dev
))
1347 if (!dev
->hbm_f_ev_supported
) {
1348 cl_dbg(dev
, cl
, "notifications not supported\n");
1352 if (!mei_cl_is_connected(cl
))
1355 rets
= pm_runtime_get(dev
->dev
);
1356 if (rets
< 0 && rets
!= -EINPROGRESS
) {
1357 pm_runtime_put_noidle(dev
->dev
);
1358 cl_err(dev
, cl
, "rpm: get failed %d\n", rets
);
1362 fop_type
= mei_cl_notify_req2fop(request
);
1363 cb
= mei_cl_enqueue_ctrl_wr_cb(cl
, 0, fop_type
, fp
);
1369 if (mei_hbuf_acquire(dev
)) {
1370 if (mei_hbm_cl_notify_req(dev
, cl
, request
)) {
1374 list_move_tail(&cb
->list
, &dev
->ctrl_rd_list
);
1377 mutex_unlock(&dev
->device_lock
);
1378 wait_event_timeout(cl
->wait
,
1379 cl
->notify_en
== request
|| !mei_cl_is_connected(cl
),
1380 mei_secs_to_jiffies(MEI_CL_CONNECT_TIMEOUT
));
1381 mutex_lock(&dev
->device_lock
);
1383 if (cl
->notify_en
!= request
&& !cl
->status
)
1384 cl
->status
= -EFAULT
;
1389 cl_dbg(dev
, cl
, "rpm: autosuspend\n");
1390 pm_runtime_mark_last_busy(dev
->dev
);
1391 pm_runtime_put_autosuspend(dev
->dev
);
1398 * mei_cl_notify - raise notification
1402 * Locking: called under "dev->device_lock" lock
1404 void mei_cl_notify(struct mei_cl
*cl
)
1406 struct mei_device
*dev
;
1408 if (!cl
|| !cl
->dev
)
1416 cl_dbg(dev
, cl
, "notify event");
1417 cl
->notify_ev
= true;
1418 if (!mei_cl_bus_notify_event(cl
))
1419 wake_up_interruptible(&cl
->ev_wait
);
1422 kill_fasync(&cl
->ev_async
, SIGIO
, POLL_PRI
);
1427 * mei_cl_notify_get - get or wait for notification event
1430 * @block: this request is blocking
1431 * @notify_ev: true if notification event was received
1433 * Locking: called under "dev->device_lock" lock
1435 * Return: 0 on such and error otherwise.
1437 int mei_cl_notify_get(struct mei_cl
*cl
, bool block
, bool *notify_ev
)
1439 struct mei_device
*dev
;
1444 if (WARN_ON(!cl
|| !cl
->dev
))
1449 if (!dev
->hbm_f_ev_supported
) {
1450 cl_dbg(dev
, cl
, "notifications not supported\n");
1454 if (!mei_cl_is_connected(cl
))
1463 mutex_unlock(&dev
->device_lock
);
1464 rets
= wait_event_interruptible(cl
->ev_wait
, cl
->notify_ev
);
1465 mutex_lock(&dev
->device_lock
);
1471 *notify_ev
= cl
->notify_ev
;
1472 cl
->notify_ev
= false;
1477 * mei_cl_read_start - the start read client message function.
1480 * @length: number of bytes to read
1481 * @fp: pointer to file structure
1483 * Return: 0 on success, <0 on failure.
1485 int mei_cl_read_start(struct mei_cl
*cl
, size_t length
, const struct file
*fp
)
1487 struct mei_device
*dev
;
1488 struct mei_cl_cb
*cb
;
1491 if (WARN_ON(!cl
|| !cl
->dev
))
1496 if (!mei_cl_is_connected(cl
))
1499 if (!mei_me_cl_is_active(cl
->me_cl
)) {
1500 cl_err(dev
, cl
, "no such me client\n");
1504 if (mei_cl_is_fixed_address(cl
))
1507 /* HW currently supports only one pending read */
1508 if (cl
->rx_flow_ctrl_creds
)
1511 cb
= mei_cl_enqueue_ctrl_wr_cb(cl
, length
, MEI_FOP_READ
, fp
);
1515 rets
= pm_runtime_get(dev
->dev
);
1516 if (rets
< 0 && rets
!= -EINPROGRESS
) {
1517 pm_runtime_put_noidle(dev
->dev
);
1518 cl_err(dev
, cl
, "rpm: get failed %d\n", rets
);
1523 if (mei_hbuf_acquire(dev
)) {
1524 rets
= mei_hbm_cl_flow_control_req(dev
, cl
);
1528 list_move_tail(&cb
->list
, &cl
->rd_pending
);
1530 cl
->rx_flow_ctrl_creds
++;
1533 cl_dbg(dev
, cl
, "rpm: autosuspend\n");
1534 pm_runtime_mark_last_busy(dev
->dev
);
1535 pm_runtime_put_autosuspend(dev
->dev
);
1544 * mei_msg_hdr_init - initialize mei message header
1546 * @mei_hdr: mei message header
1547 * @cb: message callback structure
1549 static void mei_msg_hdr_init(struct mei_msg_hdr
*mei_hdr
, struct mei_cl_cb
*cb
)
1551 mei_hdr
->host_addr
= mei_cl_host_addr(cb
->cl
);
1552 mei_hdr
->me_addr
= mei_cl_me_id(cb
->cl
);
1553 mei_hdr
->length
= 0;
1554 mei_hdr
->reserved
= 0;
1555 mei_hdr
->msg_complete
= 0;
1556 mei_hdr
->dma_ring
= 0;
1557 mei_hdr
->internal
= cb
->internal
;
1561 * mei_cl_irq_write - write a message to device
1562 * from the interrupt thread context
1565 * @cb: callback block.
1566 * @cmpl_list: complete list.
1568 * Return: 0, OK; otherwise error.
1570 int mei_cl_irq_write(struct mei_cl
*cl
, struct mei_cl_cb
*cb
,
1571 struct list_head
*cmpl_list
)
1573 struct mei_device
*dev
;
1574 struct mei_msg_data
*buf
;
1575 struct mei_msg_hdr mei_hdr
;
1576 size_t hdr_len
= sizeof(mei_hdr
);
1583 if (WARN_ON(!cl
|| !cl
->dev
))
1590 first_chunk
= cb
->buf_idx
== 0;
1592 rets
= first_chunk
? mei_cl_tx_flow_ctrl_creds(cl
) : 1;
1597 cl_dbg(dev
, cl
, "No flow control credentials: not sending.\n");
1601 len
= buf
->size
- cb
->buf_idx
;
1602 hbuf_slots
= mei_hbuf_empty_slots(dev
);
1603 if (hbuf_slots
< 0) {
1608 hbuf_len
= mei_slots2data(hbuf_slots
);
1610 mei_msg_hdr_init(&mei_hdr
, cb
);
1613 * Split the message only if we can write the whole host buffer
1614 * otherwise wait for next time the host buffer is empty.
1616 if (len
+ hdr_len
<= hbuf_len
) {
1617 mei_hdr
.length
= len
;
1618 mei_hdr
.msg_complete
= 1;
1619 } else if ((u32
)hbuf_slots
== mei_hbuf_depth(dev
)) {
1620 mei_hdr
.length
= hbuf_len
- hdr_len
;
1625 cl_dbg(dev
, cl
, "buf: size = %zu idx = %zu\n",
1626 cb
->buf
.size
, cb
->buf_idx
);
1628 rets
= mei_write_message(dev
, &mei_hdr
, hdr_len
,
1629 buf
->data
+ cb
->buf_idx
, mei_hdr
.length
);
1634 cl
->writing_state
= MEI_WRITING
;
1635 cb
->buf_idx
+= mei_hdr
.length
;
1638 if (mei_cl_tx_flow_ctrl_creds_reduce(cl
)) {
1644 if (mei_hdr
.msg_complete
)
1645 list_move_tail(&cb
->list
, &dev
->write_waiting_list
);
1651 list_move_tail(&cb
->list
, cmpl_list
);
1656 * mei_cl_write - submit a write cb to mei device
1657 * assumes device_lock is locked
1660 * @cb: write callback with filled data
1662 * Return: number of bytes sent on success, <0 on failure.
1664 ssize_t
mei_cl_write(struct mei_cl
*cl
, struct mei_cl_cb
*cb
)
1666 struct mei_device
*dev
;
1667 struct mei_msg_data
*buf
;
1668 struct mei_msg_hdr mei_hdr
;
1669 size_t hdr_len
= sizeof(mei_hdr
);
1676 if (WARN_ON(!cl
|| !cl
->dev
))
1686 blocking
= cb
->blocking
;
1688 cl_dbg(dev
, cl
, "len=%zd\n", len
);
1690 rets
= pm_runtime_get(dev
->dev
);
1691 if (rets
< 0 && rets
!= -EINPROGRESS
) {
1692 pm_runtime_put_noidle(dev
->dev
);
1693 cl_err(dev
, cl
, "rpm: get failed %zd\n", rets
);
1698 cl
->writing_state
= MEI_IDLE
;
1701 rets
= mei_cl_tx_flow_ctrl_creds(cl
);
1705 mei_msg_hdr_init(&mei_hdr
, cb
);
1708 cl_dbg(dev
, cl
, "No flow control credentials: not sending.\n");
1713 if (!mei_hbuf_acquire(dev
)) {
1714 cl_dbg(dev
, cl
, "Cannot acquire the host buffer: not sending.\n");
1719 hbuf_slots
= mei_hbuf_empty_slots(dev
);
1720 if (hbuf_slots
< 0) {
1725 hbuf_len
= mei_slots2data(hbuf_slots
);
1727 if (len
+ hdr_len
<= hbuf_len
) {
1728 mei_hdr
.length
= len
;
1729 mei_hdr
.msg_complete
= 1;
1731 mei_hdr
.length
= hbuf_len
- hdr_len
;
1734 rets
= mei_write_message(dev
, &mei_hdr
, hdr_len
,
1735 buf
->data
, mei_hdr
.length
);
1739 rets
= mei_cl_tx_flow_ctrl_creds_reduce(cl
);
1743 cl
->writing_state
= MEI_WRITING
;
1744 cb
->buf_idx
= mei_hdr
.length
;
1747 if (mei_hdr
.msg_complete
)
1748 mei_tx_cb_enqueue(cb
, &dev
->write_waiting_list
);
1750 mei_tx_cb_enqueue(cb
, &dev
->write_list
);
1753 if (blocking
&& cl
->writing_state
!= MEI_WRITE_COMPLETE
) {
1755 mutex_unlock(&dev
->device_lock
);
1756 rets
= wait_event_interruptible(cl
->tx_wait
,
1757 cl
->writing_state
== MEI_WRITE_COMPLETE
||
1758 (!mei_cl_is_connected(cl
)));
1759 mutex_lock(&dev
->device_lock
);
1760 /* wait_event_interruptible returns -ERESTARTSYS */
1762 if (signal_pending(current
))
1766 if (cl
->writing_state
!= MEI_WRITE_COMPLETE
) {
1774 cl_dbg(dev
, cl
, "rpm: autosuspend\n");
1775 pm_runtime_mark_last_busy(dev
->dev
);
1776 pm_runtime_put_autosuspend(dev
->dev
);
1785 * mei_cl_complete - processes completed operation for a client
1787 * @cl: private data of the file object.
1788 * @cb: callback block.
1790 void mei_cl_complete(struct mei_cl
*cl
, struct mei_cl_cb
*cb
)
1792 struct mei_device
*dev
= cl
->dev
;
1794 switch (cb
->fop_type
) {
1796 mei_tx_cb_dequeue(cb
);
1797 cl
->writing_state
= MEI_WRITE_COMPLETE
;
1798 if (waitqueue_active(&cl
->tx_wait
)) {
1799 wake_up_interruptible(&cl
->tx_wait
);
1801 pm_runtime_mark_last_busy(dev
->dev
);
1802 pm_request_autosuspend(dev
->dev
);
1807 list_add_tail(&cb
->list
, &cl
->rd_completed
);
1808 if (!mei_cl_is_fixed_address(cl
) &&
1809 !WARN_ON(!cl
->rx_flow_ctrl_creds
))
1810 cl
->rx_flow_ctrl_creds
--;
1811 if (!mei_cl_bus_rx_event(cl
))
1812 wake_up_interruptible(&cl
->rx_wait
);
1815 case MEI_FOP_CONNECT
:
1816 case MEI_FOP_DISCONNECT
:
1817 case MEI_FOP_NOTIFY_STOP
:
1818 case MEI_FOP_NOTIFY_START
:
1819 if (waitqueue_active(&cl
->wait
))
1823 case MEI_FOP_DISCONNECT_RSP
:
1825 mei_cl_set_disconnected(cl
);
1834 * mei_cl_all_disconnect - disconnect forcefully all connected clients
1838 void mei_cl_all_disconnect(struct mei_device
*dev
)
1842 list_for_each_entry(cl
, &dev
->file_list
, link
)
1843 mei_cl_set_disconnected(cl
);