1 // SPDX-License-Identifier: GPL-2.0
3 * Copyright (c) 2003-2020, Intel Corporation. All rights reserved.
4 * Intel Management Engine Interface (Intel MEI) Linux driver
6 #include <linux/export.h>
7 #include <linux/sched.h>
8 #include <linux/wait.h>
9 #include <linux/pm_runtime.h>
10 #include <linux/slab.h>
12 #include <linux/mei.h>
18 static const char *mei_hbm_status_str(enum mei_hbm_status status)
20 #define MEI_HBM_STATUS(status) case MEI_HBMS_##status: return #status
22 MEI_HBM_STATUS(SUCCESS);
23 MEI_HBM_STATUS(CLIENT_NOT_FOUND);
24 MEI_HBM_STATUS(ALREADY_EXISTS);
25 MEI_HBM_STATUS(REJECTED);
26 MEI_HBM_STATUS(INVALID_PARAMETER);
27 MEI_HBM_STATUS(NOT_ALLOWED);
28 MEI_HBM_STATUS(ALREADY_STARTED);
29 MEI_HBM_STATUS(NOT_STARTED);
30 default: return "unknown";
35 static const char *mei_cl_conn_status_str(enum mei_cl_connect_status status)
37 #define MEI_CL_CS(status) case MEI_CL_CONN_##status: return #status
41 MEI_CL_CS(ALREADY_STARTED);
42 MEI_CL_CS(OUT_OF_RESOURCES);
43 MEI_CL_CS(MESSAGE_SMALL);
44 MEI_CL_CS(NOT_ALLOWED);
45 default: return "unknown";
50 const char *mei_hbm_state_str(enum mei_hbm_state state)
52 #define MEI_HBM_STATE(state) case MEI_HBM_##state: return #state
55 MEI_HBM_STATE(STARTING);
56 MEI_HBM_STATE(STARTED);
57 MEI_HBM_STATE(DR_SETUP);
58 MEI_HBM_STATE(ENUM_CLIENTS);
59 MEI_HBM_STATE(CLIENT_PROPERTIES);
60 MEI_HBM_STATE(STOPPED);
68 * mei_cl_conn_status_to_errno - convert client connect response
69 * status to error code
71 * @status: client connect response status
73 * Return: corresponding error code
75 static int mei_cl_conn_status_to_errno(enum mei_cl_connect_status status)
78 case MEI_CL_CONN_SUCCESS: return 0;
79 case MEI_CL_CONN_NOT_FOUND: return -ENOTTY;
80 case MEI_CL_CONN_ALREADY_STARTED: return -EBUSY;
81 case MEI_CL_CONN_OUT_OF_RESOURCES: return -EBUSY;
82 case MEI_CL_CONN_MESSAGE_SMALL: return -EINVAL;
83 case MEI_CL_CONN_NOT_ALLOWED: return -EBUSY;
84 default: return -EINVAL;
89 * mei_hbm_write_message - wrapper for sending hbm messages.
95 static inline int mei_hbm_write_message(struct mei_device *dev,
96 struct mei_msg_hdr *hdr,
99 return mei_write_message(dev, hdr, sizeof(*hdr), data, hdr->length);
103 * mei_hbm_idle - set hbm to idle state
105 * @dev: the device structure
107 void mei_hbm_idle(struct mei_device *dev)
109 dev->init_clients_timer = 0;
110 dev->hbm_state = MEI_HBM_IDLE;
114 * mei_hbm_reset - reset hbm counters and book keeping data structurs
116 * @dev: the device structure
118 void mei_hbm_reset(struct mei_device *dev)
120 mei_me_cl_rm_all(dev);
126 * mei_hbm_hdr - construct hbm header
128 * @mei_hdr: hbm header
129 * @length: payload length
132 static inline void mei_hbm_hdr(struct mei_msg_hdr *mei_hdr, size_t length)
134 memset(mei_hdr, 0, sizeof(*mei_hdr));
135 mei_hdr->length = length;
136 mei_hdr->msg_complete = 1;
140 * mei_hbm_cl_hdr - construct client hbm header
143 * @hbm_cmd: host bus message command
144 * @buf: buffer for cl header
145 * @len: buffer length
148 void mei_hbm_cl_hdr(struct mei_cl *cl, u8 hbm_cmd, void *buf, size_t len)
150 struct mei_hbm_cl_cmd *cmd = buf;
154 cmd->hbm_cmd = hbm_cmd;
155 cmd->host_addr = mei_cl_host_addr(cl);
156 cmd->me_addr = mei_cl_me_id(cl);
160 * mei_hbm_cl_write - write simple hbm client message
162 * @dev: the device structure
164 * @hbm_cmd: host bus message command
165 * @buf: message buffer
166 * @len: buffer length
168 * Return: 0 on success, <0 on failure.
170 static inline int mei_hbm_cl_write(struct mei_device *dev, struct mei_cl *cl,
171 u8 hbm_cmd, void *buf, size_t len)
173 struct mei_msg_hdr mei_hdr;
175 mei_hbm_hdr(&mei_hdr, len);
176 mei_hbm_cl_hdr(cl, hbm_cmd, buf, len);
178 return mei_hbm_write_message(dev, &mei_hdr, buf);
182 * mei_hbm_cl_addr_equal - check if the client's and
183 * the message address match
186 * @cmd: hbm client message
188 * Return: true if addresses are the same
191 bool mei_hbm_cl_addr_equal(struct mei_cl *cl, struct mei_hbm_cl_cmd *cmd)
193 return mei_cl_host_addr(cl) == cmd->host_addr &&
194 mei_cl_me_id(cl) == cmd->me_addr;
198 * mei_hbm_cl_find_by_cmd - find recipient client
200 * @dev: the device structure
201 * @buf: a buffer with hbm cl command
203 * Return: the recipient client or NULL if not found
206 struct mei_cl *mei_hbm_cl_find_by_cmd(struct mei_device *dev, void *buf)
208 struct mei_hbm_cl_cmd *cmd = (struct mei_hbm_cl_cmd *)buf;
211 list_for_each_entry(cl, &dev->file_list, link)
212 if (mei_hbm_cl_addr_equal(cl, cmd))
219 * mei_hbm_start_wait - wait for start response message.
221 * @dev: the device structure
223 * Return: 0 on success and < 0 on failure
225 int mei_hbm_start_wait(struct mei_device *dev)
229 if (dev->hbm_state > MEI_HBM_STARTING)
232 mutex_unlock(&dev->device_lock);
233 ret = wait_event_timeout(dev->wait_hbm_start,
234 dev->hbm_state != MEI_HBM_STARTING,
235 mei_secs_to_jiffies(MEI_HBM_TIMEOUT));
236 mutex_lock(&dev->device_lock);
238 if (ret == 0 && (dev->hbm_state <= MEI_HBM_STARTING)) {
239 dev->hbm_state = MEI_HBM_IDLE;
240 dev_err(dev->dev, "waiting for mei start failed\n");
247 * mei_hbm_start_req - sends start request message.
249 * @dev: the device structure
251 * Return: 0 on success and < 0 on failure
253 int mei_hbm_start_req(struct mei_device *dev)
255 struct mei_msg_hdr mei_hdr;
256 struct hbm_host_version_request req;
261 mei_hbm_hdr(&mei_hdr, sizeof(req));
263 /* host start message */
264 memset(&req, 0, sizeof(req));
265 req.hbm_cmd = HOST_START_REQ_CMD;
266 req.host_version.major_version = HBM_MAJOR_VERSION;
267 req.host_version.minor_version = HBM_MINOR_VERSION;
269 dev->hbm_state = MEI_HBM_IDLE;
270 ret = mei_hbm_write_message(dev, &mei_hdr, &req);
272 dev_err(dev->dev, "version message write failed: ret = %d\n",
277 dev->hbm_state = MEI_HBM_STARTING;
278 dev->init_clients_timer = MEI_CLIENTS_INIT_TIMEOUT;
279 mei_schedule_stall_timer(dev);
284 * mei_hbm_dma_setup_req() - setup DMA request
285 * @dev: the device structure
287 * Return: 0 on success and < 0 on failure
289 static int mei_hbm_dma_setup_req(struct mei_device *dev)
291 struct mei_msg_hdr mei_hdr;
292 struct hbm_dma_setup_request req;
296 mei_hbm_hdr(&mei_hdr, sizeof(req));
298 memset(&req, 0, sizeof(req));
299 req.hbm_cmd = MEI_HBM_DMA_SETUP_REQ_CMD;
300 for (i = 0; i < DMA_DSCR_NUM; i++) {
303 paddr = dev->dr_dscr[i].daddr;
304 req.dma_dscr[i].addr_hi = upper_32_bits(paddr);
305 req.dma_dscr[i].addr_lo = lower_32_bits(paddr);
306 req.dma_dscr[i].size = dev->dr_dscr[i].size;
309 mei_dma_ring_reset(dev);
311 ret = mei_hbm_write_message(dev, &mei_hdr, &req);
313 dev_err(dev->dev, "dma setup request write failed: ret = %d.\n",
318 dev->hbm_state = MEI_HBM_DR_SETUP;
319 dev->init_clients_timer = MEI_CLIENTS_INIT_TIMEOUT;
320 mei_schedule_stall_timer(dev);
325 * mei_hbm_capabilities_req - request capabilities
327 * @dev: the device structure
329 * Return: 0 on success and < 0 on failure
331 static int mei_hbm_capabilities_req(struct mei_device *dev)
333 struct mei_msg_hdr mei_hdr;
334 struct hbm_capability_request req;
337 mei_hbm_hdr(&mei_hdr, sizeof(req));
339 memset(&req, 0, sizeof(req));
340 req.hbm_cmd = MEI_HBM_CAPABILITIES_REQ_CMD;
341 if (dev->hbm_f_vt_supported)
342 req.capability_requested[0] |= HBM_CAP_VT;
343 if (dev->hbm_f_cd_supported)
344 req.capability_requested[0] |= HBM_CAP_CD;
346 ret = mei_hbm_write_message(dev, &mei_hdr, &req);
349 "capabilities request write failed: ret = %d.\n", ret);
353 dev->hbm_state = MEI_HBM_CAP_SETUP;
354 dev->init_clients_timer = MEI_CLIENTS_INIT_TIMEOUT;
355 mei_schedule_stall_timer(dev);
360 * mei_hbm_enum_clients_req - sends enumeration client request message.
362 * @dev: the device structure
364 * Return: 0 on success and < 0 on failure
366 static int mei_hbm_enum_clients_req(struct mei_device *dev)
368 struct mei_msg_hdr mei_hdr;
369 struct hbm_host_enum_request req;
372 /* enumerate clients */
373 mei_hbm_hdr(&mei_hdr, sizeof(req));
375 memset(&req, 0, sizeof(req));
376 req.hbm_cmd = HOST_ENUM_REQ_CMD;
377 req.flags |= dev->hbm_f_dc_supported ? MEI_HBM_ENUM_F_ALLOW_ADD : 0;
378 req.flags |= dev->hbm_f_ie_supported ?
379 MEI_HBM_ENUM_F_IMMEDIATE_ENUM : 0;
381 ret = mei_hbm_write_message(dev, &mei_hdr, &req);
383 dev_err(dev->dev, "enumeration request write failed: ret = %d.\n",
387 dev->hbm_state = MEI_HBM_ENUM_CLIENTS;
388 dev->init_clients_timer = MEI_CLIENTS_INIT_TIMEOUT;
389 mei_schedule_stall_timer(dev);
394 * mei_hbm_me_cl_add - add new me client to the list
396 * @dev: the device structure
397 * @res: hbm property response
399 * Return: 0 on success and -ENOMEM on allocation failure
402 static int mei_hbm_me_cl_add(struct mei_device *dev,
403 struct hbm_props_response *res)
405 struct mei_me_client *me_cl;
406 const uuid_le *uuid = &res->client_properties.protocol_name;
408 mei_me_cl_rm_by_uuid(dev, uuid);
410 me_cl = kzalloc(sizeof(*me_cl), GFP_KERNEL);
414 mei_me_cl_init(me_cl);
416 me_cl->props = res->client_properties;
417 me_cl->client_id = res->me_addr;
418 me_cl->tx_flow_ctrl_creds = 0;
420 mei_me_cl_add(dev, me_cl);
426 * mei_hbm_add_cl_resp - send response to fw on client add request
428 * @dev: the device structure
430 * @status: response status
432 * Return: 0 on success and < 0 on failure
434 static int mei_hbm_add_cl_resp(struct mei_device *dev, u8 addr, u8 status)
436 struct mei_msg_hdr mei_hdr;
437 struct hbm_add_client_response resp;
440 dev_dbg(dev->dev, "adding client response\n");
442 mei_hbm_hdr(&mei_hdr, sizeof(resp));
444 memset(&resp, 0, sizeof(resp));
445 resp.hbm_cmd = MEI_HBM_ADD_CLIENT_RES_CMD;
447 resp.status = status;
449 ret = mei_hbm_write_message(dev, &mei_hdr, &resp);
451 dev_err(dev->dev, "add client response write failed: ret = %d\n",
457 * mei_hbm_fw_add_cl_req - request from the fw to add a client
459 * @dev: the device structure
460 * @req: add client request
462 * Return: 0 on success and < 0 on failure
464 static int mei_hbm_fw_add_cl_req(struct mei_device *dev,
465 struct hbm_add_client_request *req)
468 u8 status = MEI_HBMS_SUCCESS;
470 BUILD_BUG_ON(sizeof(struct hbm_add_client_request) !=
471 sizeof(struct hbm_props_response));
473 ret = mei_hbm_me_cl_add(dev, (struct hbm_props_response *)req);
475 status = !MEI_HBMS_SUCCESS;
477 if (dev->dev_state == MEI_DEV_ENABLED)
478 schedule_work(&dev->bus_rescan_work);
480 return mei_hbm_add_cl_resp(dev, req->me_addr, status);
484 * mei_hbm_cl_notify_req - send notification request
486 * @dev: the device structure
487 * @cl: a client to disconnect from
488 * @start: true for start false for stop
490 * Return: 0 on success and -EIO on write failure
492 int mei_hbm_cl_notify_req(struct mei_device *dev,
493 struct mei_cl *cl, u8 start)
496 struct mei_msg_hdr mei_hdr;
497 struct hbm_notification_request req;
500 mei_hbm_hdr(&mei_hdr, sizeof(req));
501 mei_hbm_cl_hdr(cl, MEI_HBM_NOTIFY_REQ_CMD, &req, sizeof(req));
505 ret = mei_hbm_write_message(dev, &mei_hdr, &req);
507 dev_err(dev->dev, "notify request failed: ret = %d\n", ret);
513 * notify_res_to_fop - convert notification response to the proper
516 * @cmd: client notification start response command
518 * Return: MEI_FOP_NOTIFY_START or MEI_FOP_NOTIFY_STOP;
520 static inline enum mei_cb_file_ops notify_res_to_fop(struct mei_hbm_cl_cmd *cmd)
522 struct hbm_notification_response *rs =
523 (struct hbm_notification_response *)cmd;
525 return mei_cl_notify_req2fop(rs->start);
529 * mei_hbm_cl_notify_start_res - update the client state according
530 * notify start response
532 * @dev: the device structure
533 * @cl: mei host client
534 * @cmd: client notification start response command
536 static void mei_hbm_cl_notify_start_res(struct mei_device *dev,
538 struct mei_hbm_cl_cmd *cmd)
540 struct hbm_notification_response *rs =
541 (struct hbm_notification_response *)cmd;
543 cl_dbg(dev, cl, "hbm: notify start response status=%d\n", rs->status);
545 if (rs->status == MEI_HBMS_SUCCESS ||
546 rs->status == MEI_HBMS_ALREADY_STARTED) {
547 cl->notify_en = true;
550 cl->status = -EINVAL;
555 * mei_hbm_cl_notify_stop_res - update the client state according
556 * notify stop response
558 * @dev: the device structure
559 * @cl: mei host client
560 * @cmd: client notification stop response command
562 static void mei_hbm_cl_notify_stop_res(struct mei_device *dev,
564 struct mei_hbm_cl_cmd *cmd)
566 struct hbm_notification_response *rs =
567 (struct hbm_notification_response *)cmd;
569 cl_dbg(dev, cl, "hbm: notify stop response status=%d\n", rs->status);
571 if (rs->status == MEI_HBMS_SUCCESS ||
572 rs->status == MEI_HBMS_NOT_STARTED) {
573 cl->notify_en = false;
576 /* TODO: spec is not clear yet about other possible issues */
577 cl->status = -EINVAL;
582 * mei_hbm_cl_notify - signal notification event
584 * @dev: the device structure
585 * @cmd: notification client message
587 static void mei_hbm_cl_notify(struct mei_device *dev,
588 struct mei_hbm_cl_cmd *cmd)
592 cl = mei_hbm_cl_find_by_cmd(dev, cmd);
598 * mei_hbm_cl_dma_map_req - send client dma map request
600 * @dev: the device structure
601 * @cl: mei host client
603 * Return: 0 on success and -EIO on write failure
605 int mei_hbm_cl_dma_map_req(struct mei_device *dev, struct mei_cl *cl)
607 struct mei_msg_hdr mei_hdr;
608 struct hbm_client_dma_map_request req;
611 mei_hbm_hdr(&mei_hdr, sizeof(req));
613 memset(&req, 0, sizeof(req));
615 req.hbm_cmd = MEI_HBM_CLIENT_DMA_MAP_REQ_CMD;
616 req.client_buffer_id = cl->dma.buffer_id;
617 req.address_lsb = lower_32_bits(cl->dma.daddr);
618 req.address_msb = upper_32_bits(cl->dma.daddr);
619 req.size = cl->dma.size;
621 ret = mei_hbm_write_message(dev, &mei_hdr, &req);
623 dev_err(dev->dev, "dma map request failed: ret = %d\n", ret);
629 * mei_hbm_cl_dma_unmap_req - send client dma unmap request
631 * @dev: the device structure
632 * @cl: mei host client
634 * Return: 0 on success and -EIO on write failure
636 int mei_hbm_cl_dma_unmap_req(struct mei_device *dev, struct mei_cl *cl)
638 struct mei_msg_hdr mei_hdr;
639 struct hbm_client_dma_unmap_request req;
642 mei_hbm_hdr(&mei_hdr, sizeof(req));
644 memset(&req, 0, sizeof(req));
646 req.hbm_cmd = MEI_HBM_CLIENT_DMA_UNMAP_REQ_CMD;
647 req.client_buffer_id = cl->dma.buffer_id;
649 ret = mei_hbm_write_message(dev, &mei_hdr, &req);
651 dev_err(dev->dev, "dma unmap request failed: ret = %d\n", ret);
656 static void mei_hbm_cl_dma_map_res(struct mei_device *dev,
657 struct hbm_client_dma_response *res)
660 struct mei_cl_cb *cb, *next;
663 list_for_each_entry_safe(cb, next, &dev->ctrl_rd_list, list) {
664 if (cb->fop_type != MEI_FOP_DMA_MAP)
666 if (!cb->cl->dma.buffer_id || cb->cl->dma_mapped)
676 dev_err(dev->dev, "cl dma map failed %d\n", res->status);
677 cl->status = -EFAULT;
679 dev_dbg(dev->dev, "cl dma map succeeded\n");
686 static void mei_hbm_cl_dma_unmap_res(struct mei_device *dev,
687 struct hbm_client_dma_response *res)
690 struct mei_cl_cb *cb, *next;
693 list_for_each_entry_safe(cb, next, &dev->ctrl_rd_list, list) {
694 if (cb->fop_type != MEI_FOP_DMA_UNMAP)
696 if (!cb->cl->dma.buffer_id || !cb->cl->dma_mapped)
706 dev_err(dev->dev, "cl dma unmap failed %d\n", res->status);
707 cl->status = -EFAULT;
709 dev_dbg(dev->dev, "cl dma unmap succeeded\n");
717 * mei_hbm_prop_req - request property for a single client
719 * @dev: the device structure
720 * @start_idx: client index to start search
722 * Return: 0 on success and < 0 on failure
724 static int mei_hbm_prop_req(struct mei_device *dev, unsigned long start_idx)
726 struct mei_msg_hdr mei_hdr;
727 struct hbm_props_request req;
731 addr = find_next_bit(dev->me_clients_map, MEI_CLIENTS_MAX, start_idx);
733 /* We got all client properties */
734 if (addr == MEI_CLIENTS_MAX) {
735 dev->hbm_state = MEI_HBM_STARTED;
736 mei_host_client_init(dev);
740 mei_hbm_hdr(&mei_hdr, sizeof(req));
742 memset(&req, 0, sizeof(req));
744 req.hbm_cmd = HOST_CLIENT_PROPERTIES_REQ_CMD;
747 ret = mei_hbm_write_message(dev, &mei_hdr, &req);
749 dev_err(dev->dev, "properties request write failed: ret = %d\n",
754 dev->init_clients_timer = MEI_CLIENTS_INIT_TIMEOUT;
755 mei_schedule_stall_timer(dev);
761 * mei_hbm_pg - sends pg command
763 * @dev: the device structure
764 * @pg_cmd: the pg command code
766 * Return: -EIO on write failure
767 * -EOPNOTSUPP if the operation is not supported by the protocol
769 int mei_hbm_pg(struct mei_device *dev, u8 pg_cmd)
771 struct mei_msg_hdr mei_hdr;
772 struct hbm_power_gate req;
775 if (!dev->hbm_f_pg_supported)
778 mei_hbm_hdr(&mei_hdr, sizeof(req));
780 memset(&req, 0, sizeof(req));
781 req.hbm_cmd = pg_cmd;
783 ret = mei_hbm_write_message(dev, &mei_hdr, &req);
785 dev_err(dev->dev, "power gate command write failed.\n");
788 EXPORT_SYMBOL_GPL(mei_hbm_pg);
791 * mei_hbm_stop_req - send stop request message
795 * Return: -EIO on write failure
797 static int mei_hbm_stop_req(struct mei_device *dev)
799 struct mei_msg_hdr mei_hdr;
800 struct hbm_host_stop_request req;
802 mei_hbm_hdr(&mei_hdr, sizeof(req));
804 memset(&req, 0, sizeof(req));
805 req.hbm_cmd = HOST_STOP_REQ_CMD;
806 req.reason = DRIVER_STOP_REQUEST;
808 return mei_hbm_write_message(dev, &mei_hdr, &req);
812 * mei_hbm_cl_flow_control_req - sends flow control request.
814 * @dev: the device structure
817 * Return: -EIO on write failure
819 int mei_hbm_cl_flow_control_req(struct mei_device *dev, struct mei_cl *cl)
821 struct hbm_flow_control req;
823 cl_dbg(dev, cl, "sending flow control\n");
824 return mei_hbm_cl_write(dev, cl, MEI_FLOW_CONTROL_CMD,
829 * mei_hbm_add_single_tx_flow_ctrl_creds - adds single buffer credentials.
831 * @dev: the device structure
832 * @fctrl: flow control response bus message
834 * Return: 0 on success, < 0 otherwise
836 static int mei_hbm_add_single_tx_flow_ctrl_creds(struct mei_device *dev,
837 struct hbm_flow_control *fctrl)
839 struct mei_me_client *me_cl;
842 me_cl = mei_me_cl_by_id(dev, fctrl->me_addr);
844 dev_err(dev->dev, "no such me client %d\n", fctrl->me_addr);
848 if (WARN_ON(me_cl->props.single_recv_buf == 0)) {
853 me_cl->tx_flow_ctrl_creds++;
854 dev_dbg(dev->dev, "recv flow ctrl msg ME %d (single) creds = %d.\n",
855 fctrl->me_addr, me_cl->tx_flow_ctrl_creds);
859 mei_me_cl_put(me_cl);
864 * mei_hbm_cl_tx_flow_ctrl_creds_res - flow control response from me
866 * @dev: the device structure
867 * @fctrl: flow control response bus message
869 static void mei_hbm_cl_tx_flow_ctrl_creds_res(struct mei_device *dev,
870 struct hbm_flow_control *fctrl)
874 if (!fctrl->host_addr) {
875 /* single receive buffer */
876 mei_hbm_add_single_tx_flow_ctrl_creds(dev, fctrl);
880 cl = mei_hbm_cl_find_by_cmd(dev, fctrl);
882 cl->tx_flow_ctrl_creds++;
883 cl_dbg(dev, cl, "flow control creds = %d.\n",
884 cl->tx_flow_ctrl_creds);
890 * mei_hbm_cl_disconnect_req - sends disconnect message to fw.
892 * @dev: the device structure
893 * @cl: a client to disconnect from
895 * Return: -EIO on write failure
897 int mei_hbm_cl_disconnect_req(struct mei_device *dev, struct mei_cl *cl)
899 struct hbm_client_connect_request req;
901 return mei_hbm_cl_write(dev, cl, CLIENT_DISCONNECT_REQ_CMD,
906 * mei_hbm_cl_disconnect_rsp - sends disconnect respose to the FW
908 * @dev: the device structure
909 * @cl: a client to disconnect from
911 * Return: -EIO on write failure
913 int mei_hbm_cl_disconnect_rsp(struct mei_device *dev, struct mei_cl *cl)
915 struct hbm_client_connect_response resp;
917 return mei_hbm_cl_write(dev, cl, CLIENT_DISCONNECT_RES_CMD,
918 &resp, sizeof(resp));
922 * mei_hbm_cl_disconnect_res - update the client state according
923 * disconnect response
925 * @dev: the device structure
926 * @cl: mei host client
927 * @cmd: disconnect client response host bus message
929 static void mei_hbm_cl_disconnect_res(struct mei_device *dev, struct mei_cl *cl,
930 struct mei_hbm_cl_cmd *cmd)
932 struct hbm_client_connect_response *rs =
933 (struct hbm_client_connect_response *)cmd;
935 cl_dbg(dev, cl, "hbm: disconnect response status=%d\n", rs->status);
937 if (rs->status == MEI_CL_DISCONN_SUCCESS)
938 cl->state = MEI_FILE_DISCONNECT_REPLY;
943 * mei_hbm_cl_connect_req - send connection request to specific me client
945 * @dev: the device structure
946 * @cl: a client to connect to
948 * Return: -EIO on write failure
950 int mei_hbm_cl_connect_req(struct mei_device *dev, struct mei_cl *cl)
952 struct hbm_client_connect_request req;
954 return mei_hbm_cl_write(dev, cl, CLIENT_CONNECT_REQ_CMD,
959 * mei_hbm_cl_connect_res - update the client state according
960 * connection response
962 * @dev: the device structure
963 * @cl: mei host client
964 * @cmd: connect client response host bus message
966 static void mei_hbm_cl_connect_res(struct mei_device *dev, struct mei_cl *cl,
967 struct mei_hbm_cl_cmd *cmd)
969 struct hbm_client_connect_response *rs =
970 (struct hbm_client_connect_response *)cmd;
972 cl_dbg(dev, cl, "hbm: connect response status=%s\n",
973 mei_cl_conn_status_str(rs->status));
975 if (rs->status == MEI_CL_CONN_SUCCESS)
976 cl->state = MEI_FILE_CONNECTED;
978 cl->state = MEI_FILE_DISCONNECT_REPLY;
979 if (rs->status == MEI_CL_CONN_NOT_FOUND) {
980 mei_me_cl_del(dev, cl->me_cl);
981 if (dev->dev_state == MEI_DEV_ENABLED)
982 schedule_work(&dev->bus_rescan_work);
985 cl->status = mei_cl_conn_status_to_errno(rs->status);
989 * mei_hbm_cl_res - process hbm response received on behalf
992 * @dev: the device structure
993 * @rs: hbm client message
994 * @fop_type: file operation type
996 static void mei_hbm_cl_res(struct mei_device *dev,
997 struct mei_hbm_cl_cmd *rs,
998 enum mei_cb_file_ops fop_type)
1001 struct mei_cl_cb *cb, *next;
1004 list_for_each_entry_safe(cb, next, &dev->ctrl_rd_list, list) {
1008 if (cb->fop_type != fop_type)
1011 if (mei_hbm_cl_addr_equal(cl, rs)) {
1012 list_del_init(&cb->list);
1021 case MEI_FOP_CONNECT:
1022 mei_hbm_cl_connect_res(dev, cl, rs);
1024 case MEI_FOP_DISCONNECT:
1025 mei_hbm_cl_disconnect_res(dev, cl, rs);
1027 case MEI_FOP_NOTIFY_START:
1028 mei_hbm_cl_notify_start_res(dev, cl, rs);
1030 case MEI_FOP_NOTIFY_STOP:
1031 mei_hbm_cl_notify_stop_res(dev, cl, rs);
1037 cl->timer_count = 0;
1043 * mei_hbm_fw_disconnect_req - disconnect request initiated by ME firmware
1044 * host sends disconnect response
1046 * @dev: the device structure.
1047 * @disconnect_req: disconnect request bus message from the me
1049 * Return: -ENOMEM on allocation failure
1051 static int mei_hbm_fw_disconnect_req(struct mei_device *dev,
1052 struct hbm_client_connect_request *disconnect_req)
1055 struct mei_cl_cb *cb;
1057 cl = mei_hbm_cl_find_by_cmd(dev, disconnect_req);
1059 cl_warn(dev, cl, "fw disconnect request received\n");
1060 cl->state = MEI_FILE_DISCONNECTING;
1061 cl->timer_count = 0;
1063 cb = mei_cl_enqueue_ctrl_wr_cb(cl, 0, MEI_FOP_DISCONNECT_RSP,
1072 * mei_hbm_pg_enter_res - PG enter response received
1074 * @dev: the device structure.
1076 * Return: 0 on success, -EPROTO on state mismatch
1078 static int mei_hbm_pg_enter_res(struct mei_device *dev)
1080 if (mei_pg_state(dev) != MEI_PG_OFF ||
1081 dev->pg_event != MEI_PG_EVENT_WAIT) {
1082 dev_err(dev->dev, "hbm: pg entry response: state mismatch [%s, %d]\n",
1083 mei_pg_state_str(mei_pg_state(dev)), dev->pg_event);
1087 dev->pg_event = MEI_PG_EVENT_RECEIVED;
1088 wake_up(&dev->wait_pg);
1094 * mei_hbm_pg_resume - process with PG resume
1096 * @dev: the device structure.
1098 void mei_hbm_pg_resume(struct mei_device *dev)
1100 pm_request_resume(dev->dev);
1102 EXPORT_SYMBOL_GPL(mei_hbm_pg_resume);
1105 * mei_hbm_pg_exit_res - PG exit response received
1107 * @dev: the device structure.
1109 * Return: 0 on success, -EPROTO on state mismatch
1111 static int mei_hbm_pg_exit_res(struct mei_device *dev)
1113 if (mei_pg_state(dev) != MEI_PG_ON ||
1114 (dev->pg_event != MEI_PG_EVENT_WAIT &&
1115 dev->pg_event != MEI_PG_EVENT_IDLE)) {
1116 dev_err(dev->dev, "hbm: pg exit response: state mismatch [%s, %d]\n",
1117 mei_pg_state_str(mei_pg_state(dev)), dev->pg_event);
1121 switch (dev->pg_event) {
1122 case MEI_PG_EVENT_WAIT:
1123 dev->pg_event = MEI_PG_EVENT_RECEIVED;
1124 wake_up(&dev->wait_pg);
1126 case MEI_PG_EVENT_IDLE:
1128 * If the driver is not waiting on this then
1129 * this is HW initiated exit from PG.
1130 * Start runtime pm resume sequence to exit from PG.
1132 dev->pg_event = MEI_PG_EVENT_RECEIVED;
1133 mei_hbm_pg_resume(dev);
1136 WARN(1, "hbm: pg exit response: unexpected pg event = %d\n",
1145 * mei_hbm_config_features - check what hbm features and commands
1146 * are supported by the fw
1148 * @dev: the device structure
1150 static void mei_hbm_config_features(struct mei_device *dev)
1152 /* Power Gating Isolation Support */
1153 dev->hbm_f_pg_supported = 0;
1154 if (dev->version.major_version > HBM_MAJOR_VERSION_PGI)
1155 dev->hbm_f_pg_supported = 1;
1157 if (dev->version.major_version == HBM_MAJOR_VERSION_PGI &&
1158 dev->version.minor_version >= HBM_MINOR_VERSION_PGI)
1159 dev->hbm_f_pg_supported = 1;
1161 dev->hbm_f_dc_supported = 0;
1162 if (dev->version.major_version >= HBM_MAJOR_VERSION_DC)
1163 dev->hbm_f_dc_supported = 1;
1165 dev->hbm_f_ie_supported = 0;
1166 if (dev->version.major_version >= HBM_MAJOR_VERSION_IE)
1167 dev->hbm_f_ie_supported = 1;
1169 /* disconnect on connect timeout instead of link reset */
1170 dev->hbm_f_dot_supported = 0;
1171 if (dev->version.major_version >= HBM_MAJOR_VERSION_DOT)
1172 dev->hbm_f_dot_supported = 1;
1174 /* Notification Event Support */
1175 dev->hbm_f_ev_supported = 0;
1176 if (dev->version.major_version >= HBM_MAJOR_VERSION_EV)
1177 dev->hbm_f_ev_supported = 1;
1179 /* Fixed Address Client Support */
1180 dev->hbm_f_fa_supported = 0;
1181 if (dev->version.major_version >= HBM_MAJOR_VERSION_FA)
1182 dev->hbm_f_fa_supported = 1;
1184 /* OS ver message Support */
1185 dev->hbm_f_os_supported = 0;
1186 if (dev->version.major_version >= HBM_MAJOR_VERSION_OS)
1187 dev->hbm_f_os_supported = 1;
1189 /* DMA Ring Support */
1190 dev->hbm_f_dr_supported = 0;
1191 if (dev->version.major_version > HBM_MAJOR_VERSION_DR ||
1192 (dev->version.major_version == HBM_MAJOR_VERSION_DR &&
1193 dev->version.minor_version >= HBM_MINOR_VERSION_DR))
1194 dev->hbm_f_dr_supported = 1;
1197 dev->hbm_f_vt_supported = 0;
1198 if (dev->version.major_version > HBM_MAJOR_VERSION_VT ||
1199 (dev->version.major_version == HBM_MAJOR_VERSION_VT &&
1200 dev->version.minor_version >= HBM_MINOR_VERSION_VT))
1201 dev->hbm_f_vt_supported = 1;
1203 /* Capability message Support */
1204 dev->hbm_f_cap_supported = 0;
1205 if (dev->version.major_version > HBM_MAJOR_VERSION_CAP ||
1206 (dev->version.major_version == HBM_MAJOR_VERSION_CAP &&
1207 dev->version.minor_version >= HBM_MINOR_VERSION_CAP))
1208 dev->hbm_f_cap_supported = 1;
1210 /* Client DMA Support */
1211 dev->hbm_f_cd_supported = 0;
1212 if (dev->version.major_version > HBM_MAJOR_VERSION_CD ||
1213 (dev->version.major_version == HBM_MAJOR_VERSION_CD &&
1214 dev->version.minor_version >= HBM_MINOR_VERSION_CD))
1215 dev->hbm_f_cd_supported = 1;
1219 * mei_hbm_version_is_supported - checks whether the driver can
1220 * support the hbm version of the device
1222 * @dev: the device structure
1223 * Return: true if driver can support hbm version of the device
1225 bool mei_hbm_version_is_supported(struct mei_device *dev)
1227 return (dev->version.major_version < HBM_MAJOR_VERSION) ||
1228 (dev->version.major_version == HBM_MAJOR_VERSION &&
1229 dev->version.minor_version <= HBM_MINOR_VERSION);
1233 * mei_hbm_dispatch - bottom half read routine after ISR to
1234 * handle the read bus message cmd processing.
1236 * @dev: the device structure
1237 * @hdr: header of bus message
1239 * Return: 0 on success and < 0 on failure
1241 int mei_hbm_dispatch(struct mei_device *dev, struct mei_msg_hdr *hdr)
1243 struct mei_bus_message *mei_msg;
1244 struct hbm_host_version_response *version_res;
1245 struct hbm_props_response *props_res;
1246 struct hbm_host_enum_response *enum_res;
1247 struct hbm_dma_setup_response *dma_setup_res;
1248 struct hbm_add_client_request *add_cl_req;
1249 struct hbm_capability_response *capability_res;
1252 struct mei_hbm_cl_cmd *cl_cmd;
1253 struct hbm_client_connect_request *disconnect_req;
1254 struct hbm_flow_control *fctrl;
1255 struct hbm_client_dma_response *client_dma_res;
1257 /* read the message to our buffer */
1258 BUG_ON(hdr->length >= sizeof(dev->rd_msg_buf));
1259 mei_read_slots(dev, dev->rd_msg_buf, hdr->length);
1260 mei_msg = (struct mei_bus_message *)dev->rd_msg_buf;
1261 cl_cmd = (struct mei_hbm_cl_cmd *)mei_msg;
1263 /* ignore spurious message and prevent reset nesting
1264 * hbm is put to idle during system reset
1266 if (dev->hbm_state == MEI_HBM_IDLE) {
1267 dev_dbg(dev->dev, "hbm: state is idle ignore spurious messages\n");
1271 switch (mei_msg->hbm_cmd) {
1272 case HOST_START_RES_CMD:
1273 dev_dbg(dev->dev, "hbm: start: response message received.\n");
1275 dev->init_clients_timer = 0;
1277 version_res = (struct hbm_host_version_response *)mei_msg;
1279 dev_dbg(dev->dev, "HBM VERSION: DRIVER=%02d:%02d DEVICE=%02d:%02d\n",
1280 HBM_MAJOR_VERSION, HBM_MINOR_VERSION,
1281 version_res->me_max_version.major_version,
1282 version_res->me_max_version.minor_version);
1284 if (version_res->host_version_supported) {
1285 dev->version.major_version = HBM_MAJOR_VERSION;
1286 dev->version.minor_version = HBM_MINOR_VERSION;
1288 dev->version.major_version =
1289 version_res->me_max_version.major_version;
1290 dev->version.minor_version =
1291 version_res->me_max_version.minor_version;
1294 if (!mei_hbm_version_is_supported(dev)) {
1295 dev_warn(dev->dev, "hbm: start: version mismatch - stopping the driver.\n");
1297 dev->hbm_state = MEI_HBM_STOPPED;
1298 if (mei_hbm_stop_req(dev)) {
1299 dev_err(dev->dev, "hbm: start: failed to send stop request\n");
1305 mei_hbm_config_features(dev);
1307 if (dev->dev_state != MEI_DEV_INIT_CLIENTS ||
1308 dev->hbm_state != MEI_HBM_STARTING) {
1309 if (dev->dev_state == MEI_DEV_POWER_DOWN ||
1310 dev->dev_state == MEI_DEV_POWERING_DOWN) {
1311 dev_dbg(dev->dev, "hbm: start: on shutdown, ignoring\n");
1314 dev_err(dev->dev, "hbm: start: state mismatch, [%d, %d]\n",
1315 dev->dev_state, dev->hbm_state);
1319 if (dev->hbm_f_cap_supported) {
1320 if (mei_hbm_capabilities_req(dev))
1322 wake_up(&dev->wait_hbm_start);
1326 if (dev->hbm_f_dr_supported) {
1327 if (mei_dmam_ring_alloc(dev))
1328 dev_info(dev->dev, "running w/o dma ring\n");
1329 if (mei_dma_ring_is_allocated(dev)) {
1330 if (mei_hbm_dma_setup_req(dev))
1333 wake_up(&dev->wait_hbm_start);
1338 dev->hbm_f_dr_supported = 0;
1339 mei_dmam_ring_free(dev);
1341 if (mei_hbm_enum_clients_req(dev))
1344 wake_up(&dev->wait_hbm_start);
1347 case MEI_HBM_CAPABILITIES_RES_CMD:
1348 dev_dbg(dev->dev, "hbm: capabilities response: message received.\n");
1350 dev->init_clients_timer = 0;
1352 if (dev->dev_state != MEI_DEV_INIT_CLIENTS ||
1353 dev->hbm_state != MEI_HBM_CAP_SETUP) {
1354 if (dev->dev_state == MEI_DEV_POWER_DOWN ||
1355 dev->dev_state == MEI_DEV_POWERING_DOWN) {
1356 dev_dbg(dev->dev, "hbm: capabilities response: on shutdown, ignoring\n");
1359 dev_err(dev->dev, "hbm: capabilities response: state mismatch, [%d, %d]\n",
1360 dev->dev_state, dev->hbm_state);
1364 capability_res = (struct hbm_capability_response *)mei_msg;
1365 if (!(capability_res->capability_granted[0] & HBM_CAP_VT))
1366 dev->hbm_f_vt_supported = 0;
1367 if (!(capability_res->capability_granted[0] & HBM_CAP_CD))
1368 dev->hbm_f_cd_supported = 0;
1370 if (dev->hbm_f_dr_supported) {
1371 if (mei_dmam_ring_alloc(dev))
1372 dev_info(dev->dev, "running w/o dma ring\n");
1373 if (mei_dma_ring_is_allocated(dev)) {
1374 if (mei_hbm_dma_setup_req(dev))
1380 dev->hbm_f_dr_supported = 0;
1381 mei_dmam_ring_free(dev);
1383 if (mei_hbm_enum_clients_req(dev))
1387 case MEI_HBM_DMA_SETUP_RES_CMD:
1388 dev_dbg(dev->dev, "hbm: dma setup response: message received.\n");
1390 dev->init_clients_timer = 0;
1392 if (dev->dev_state != MEI_DEV_INIT_CLIENTS ||
1393 dev->hbm_state != MEI_HBM_DR_SETUP) {
1394 if (dev->dev_state == MEI_DEV_POWER_DOWN ||
1395 dev->dev_state == MEI_DEV_POWERING_DOWN) {
1396 dev_dbg(dev->dev, "hbm: dma setup response: on shutdown, ignoring\n");
1399 dev_err(dev->dev, "hbm: dma setup response: state mismatch, [%d, %d]\n",
1400 dev->dev_state, dev->hbm_state);
1404 dma_setup_res = (struct hbm_dma_setup_response *)mei_msg;
1406 if (dma_setup_res->status) {
1407 u8 status = dma_setup_res->status;
1409 if (status == MEI_HBMS_NOT_ALLOWED) {
1410 dev_dbg(dev->dev, "hbm: dma setup not allowed\n");
1412 dev_info(dev->dev, "hbm: dma setup response: failure = %d %s\n",
1414 mei_hbm_status_str(status));
1416 dev->hbm_f_dr_supported = 0;
1417 mei_dmam_ring_free(dev);
1420 if (mei_hbm_enum_clients_req(dev))
1424 case CLIENT_CONNECT_RES_CMD:
1425 dev_dbg(dev->dev, "hbm: client connect response: message received.\n");
1426 mei_hbm_cl_res(dev, cl_cmd, MEI_FOP_CONNECT);
1429 case CLIENT_DISCONNECT_RES_CMD:
1430 dev_dbg(dev->dev, "hbm: client disconnect response: message received.\n");
1431 mei_hbm_cl_res(dev, cl_cmd, MEI_FOP_DISCONNECT);
1434 case MEI_FLOW_CONTROL_CMD:
1435 dev_dbg(dev->dev, "hbm: client flow control response: message received.\n");
1437 fctrl = (struct hbm_flow_control *)mei_msg;
1438 mei_hbm_cl_tx_flow_ctrl_creds_res(dev, fctrl);
1441 case MEI_PG_ISOLATION_ENTRY_RES_CMD:
1442 dev_dbg(dev->dev, "hbm: power gate isolation entry response received\n");
1443 ret = mei_hbm_pg_enter_res(dev);
1448 case MEI_PG_ISOLATION_EXIT_REQ_CMD:
1449 dev_dbg(dev->dev, "hbm: power gate isolation exit request received\n");
1450 ret = mei_hbm_pg_exit_res(dev);
1455 case HOST_CLIENT_PROPERTIES_RES_CMD:
1456 dev_dbg(dev->dev, "hbm: properties response: message received.\n");
1458 dev->init_clients_timer = 0;
1460 if (dev->dev_state != MEI_DEV_INIT_CLIENTS ||
1461 dev->hbm_state != MEI_HBM_CLIENT_PROPERTIES) {
1462 if (dev->dev_state == MEI_DEV_POWER_DOWN ||
1463 dev->dev_state == MEI_DEV_POWERING_DOWN) {
1464 dev_dbg(dev->dev, "hbm: properties response: on shutdown, ignoring\n");
1467 dev_err(dev->dev, "hbm: properties response: state mismatch, [%d, %d]\n",
1468 dev->dev_state, dev->hbm_state);
1472 props_res = (struct hbm_props_response *)mei_msg;
1474 if (props_res->status == MEI_HBMS_CLIENT_NOT_FOUND) {
1475 dev_dbg(dev->dev, "hbm: properties response: %d CLIENT_NOT_FOUND\n",
1476 props_res->me_addr);
1477 } else if (props_res->status) {
1478 dev_err(dev->dev, "hbm: properties response: wrong status = %d %s\n",
1480 mei_hbm_status_str(props_res->status));
1483 mei_hbm_me_cl_add(dev, props_res);
1486 /* request property for the next client */
1487 if (mei_hbm_prop_req(dev, props_res->me_addr + 1))
1492 case HOST_ENUM_RES_CMD:
1493 dev_dbg(dev->dev, "hbm: enumeration response: message received\n");
1495 dev->init_clients_timer = 0;
1497 enum_res = (struct hbm_host_enum_response *) mei_msg;
1498 BUILD_BUG_ON(sizeof(dev->me_clients_map)
1499 < sizeof(enum_res->valid_addresses));
1500 memcpy(dev->me_clients_map, enum_res->valid_addresses,
1501 sizeof(enum_res->valid_addresses));
1503 if (dev->dev_state != MEI_DEV_INIT_CLIENTS ||
1504 dev->hbm_state != MEI_HBM_ENUM_CLIENTS) {
1505 if (dev->dev_state == MEI_DEV_POWER_DOWN ||
1506 dev->dev_state == MEI_DEV_POWERING_DOWN) {
1507 dev_dbg(dev->dev, "hbm: enumeration response: on shutdown, ignoring\n");
1510 dev_err(dev->dev, "hbm: enumeration response: state mismatch, [%d, %d]\n",
1511 dev->dev_state, dev->hbm_state);
1515 dev->hbm_state = MEI_HBM_CLIENT_PROPERTIES;
1517 /* first property request */
1518 if (mei_hbm_prop_req(dev, 0))
1523 case HOST_STOP_RES_CMD:
1524 dev_dbg(dev->dev, "hbm: stop response: message received\n");
1526 dev->init_clients_timer = 0;
1528 if (dev->hbm_state != MEI_HBM_STOPPED) {
1529 dev_err(dev->dev, "hbm: stop response: state mismatch, [%d, %d]\n",
1530 dev->dev_state, dev->hbm_state);
1534 mei_set_devstate(dev, MEI_DEV_POWER_DOWN);
1535 dev_info(dev->dev, "hbm: stop response: resetting.\n");
1536 /* force the reset */
1539 case CLIENT_DISCONNECT_REQ_CMD:
1540 dev_dbg(dev->dev, "hbm: disconnect request: message received\n");
1542 disconnect_req = (struct hbm_client_connect_request *)mei_msg;
1543 mei_hbm_fw_disconnect_req(dev, disconnect_req);
1546 case ME_STOP_REQ_CMD:
1547 dev_dbg(dev->dev, "hbm: stop request: message received\n");
1548 dev->hbm_state = MEI_HBM_STOPPED;
1549 if (mei_hbm_stop_req(dev)) {
1550 dev_err(dev->dev, "hbm: stop request: failed to send stop request\n");
1555 case MEI_HBM_ADD_CLIENT_REQ_CMD:
1556 dev_dbg(dev->dev, "hbm: add client request received\n");
1558 * after the host receives the enum_resp
1559 * message clients may be added or removed
1561 if (dev->hbm_state <= MEI_HBM_ENUM_CLIENTS ||
1562 dev->hbm_state >= MEI_HBM_STOPPED) {
1563 dev_err(dev->dev, "hbm: add client: state mismatch, [%d, %d]\n",
1564 dev->dev_state, dev->hbm_state);
1567 add_cl_req = (struct hbm_add_client_request *)mei_msg;
1568 ret = mei_hbm_fw_add_cl_req(dev, add_cl_req);
1570 dev_err(dev->dev, "hbm: add client: failed to send response %d\n",
1574 dev_dbg(dev->dev, "hbm: add client request processed\n");
1577 case MEI_HBM_NOTIFY_RES_CMD:
1578 dev_dbg(dev->dev, "hbm: notify response received\n");
1579 mei_hbm_cl_res(dev, cl_cmd, notify_res_to_fop(cl_cmd));
1582 case MEI_HBM_NOTIFICATION_CMD:
1583 dev_dbg(dev->dev, "hbm: notification\n");
1584 mei_hbm_cl_notify(dev, cl_cmd);
1587 case MEI_HBM_CLIENT_DMA_MAP_RES_CMD:
1588 dev_dbg(dev->dev, "hbm: client dma map response: message received.\n");
1589 client_dma_res = (struct hbm_client_dma_response *)mei_msg;
1590 mei_hbm_cl_dma_map_res(dev, client_dma_res);
1593 case MEI_HBM_CLIENT_DMA_UNMAP_RES_CMD:
1594 dev_dbg(dev->dev, "hbm: client dma unmap response: message received.\n");
1595 client_dma_res = (struct hbm_client_dma_response *)mei_msg;
1596 mei_hbm_cl_dma_unmap_res(dev, client_dma_res);
1600 WARN(1, "hbm: wrong command %d\n", mei_msg->hbm_cmd);