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/export.h>
18 #include <linux/sched.h>
19 #include <linux/wait.h>
20 #include <linux/pm_runtime.h>
21 #include <linux/slab.h>
23 #include <linux/mei.h>
29 static const char *mei_hbm_status_str(enum mei_hbm_status status)
31 #define MEI_HBM_STATUS(status) case MEI_HBMS_##status: return #status
33 MEI_HBM_STATUS(SUCCESS);
34 MEI_HBM_STATUS(CLIENT_NOT_FOUND);
35 MEI_HBM_STATUS(ALREADY_EXISTS);
36 MEI_HBM_STATUS(REJECTED);
37 MEI_HBM_STATUS(INVALID_PARAMETER);
38 MEI_HBM_STATUS(NOT_ALLOWED);
39 MEI_HBM_STATUS(ALREADY_STARTED);
40 MEI_HBM_STATUS(NOT_STARTED);
41 default: return "unknown";
46 static const char *mei_cl_conn_status_str(enum mei_cl_connect_status status)
48 #define MEI_CL_CS(status) case MEI_CL_CONN_##status: return #status
52 MEI_CL_CS(ALREADY_STARTED);
53 MEI_CL_CS(OUT_OF_RESOURCES);
54 MEI_CL_CS(MESSAGE_SMALL);
55 MEI_CL_CS(NOT_ALLOWED);
56 default: return "unknown";
61 const char *mei_hbm_state_str(enum mei_hbm_state state)
63 #define MEI_HBM_STATE(state) case MEI_HBM_##state: return #state
66 MEI_HBM_STATE(STARTING);
67 MEI_HBM_STATE(STARTED);
68 MEI_HBM_STATE(ENUM_CLIENTS);
69 MEI_HBM_STATE(CLIENT_PROPERTIES);
70 MEI_HBM_STATE(STOPPED);
78 * mei_cl_conn_status_to_errno - convert client connect response
79 * status to error code
81 * @status: client connect response status
83 * Return: corresponding error code
85 static int mei_cl_conn_status_to_errno(enum mei_cl_connect_status status)
88 case MEI_CL_CONN_SUCCESS: return 0;
89 case MEI_CL_CONN_NOT_FOUND: return -ENOTTY;
90 case MEI_CL_CONN_ALREADY_STARTED: return -EBUSY;
91 case MEI_CL_CONN_OUT_OF_RESOURCES: return -EBUSY;
92 case MEI_CL_CONN_MESSAGE_SMALL: return -EINVAL;
93 case MEI_CL_CONN_NOT_ALLOWED: return -EBUSY;
94 default: return -EINVAL;
99 * mei_hbm_idle - set hbm to idle state
101 * @dev: the device structure
103 void mei_hbm_idle(struct mei_device *dev)
105 dev->init_clients_timer = 0;
106 dev->hbm_state = MEI_HBM_IDLE;
110 * mei_hbm_reset - reset hbm counters and book keeping data structurs
112 * @dev: the device structure
114 void mei_hbm_reset(struct mei_device *dev)
116 mei_me_cl_rm_all(dev);
122 * mei_hbm_hdr - construct hbm header
125 * @length: payload length
128 static inline void mei_hbm_hdr(struct mei_msg_hdr *hdr, size_t length)
132 hdr->length = length;
133 hdr->msg_complete = 1;
139 * mei_hbm_cl_hdr - construct client hbm header
142 * @hbm_cmd: host bus message command
143 * @buf: buffer for cl header
144 * @len: buffer length
147 void mei_hbm_cl_hdr(struct mei_cl *cl, u8 hbm_cmd, void *buf, size_t len)
149 struct mei_hbm_cl_cmd *cmd = buf;
153 cmd->hbm_cmd = hbm_cmd;
154 cmd->host_addr = mei_cl_host_addr(cl);
155 cmd->me_addr = mei_cl_me_id(cl);
159 * mei_hbm_cl_write - write simple hbm client message
161 * @dev: the device structure
163 * @hbm_cmd: host bus message command
164 * @buf: message buffer
165 * @len: buffer length
167 * Return: 0 on success, <0 on failure.
170 int mei_hbm_cl_write(struct mei_device *dev, struct mei_cl *cl,
171 u8 hbm_cmd, u8 *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_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 start_req;
257 const size_t len = sizeof(struct hbm_host_version_request);
262 mei_hbm_hdr(&mei_hdr, len);
264 /* host start message */
265 memset(&start_req, 0, len);
266 start_req.hbm_cmd = HOST_START_REQ_CMD;
267 start_req.host_version.major_version = HBM_MAJOR_VERSION;
268 start_req.host_version.minor_version = HBM_MINOR_VERSION;
270 dev->hbm_state = MEI_HBM_IDLE;
271 ret = mei_write_message(dev, &mei_hdr, &start_req);
273 dev_err(dev->dev, "version message write failed: ret = %d\n",
278 dev->hbm_state = MEI_HBM_STARTING;
279 dev->init_clients_timer = MEI_CLIENTS_INIT_TIMEOUT;
284 * mei_hbm_enum_clients_req - sends enumeration client request message.
286 * @dev: the device structure
288 * Return: 0 on success and < 0 on failure
290 static int mei_hbm_enum_clients_req(struct mei_device *dev)
292 struct mei_msg_hdr mei_hdr;
293 struct hbm_host_enum_request enum_req;
294 const size_t len = sizeof(struct hbm_host_enum_request);
297 /* enumerate clients */
298 mei_hbm_hdr(&mei_hdr, len);
300 memset(&enum_req, 0, len);
301 enum_req.hbm_cmd = HOST_ENUM_REQ_CMD;
302 enum_req.flags |= dev->hbm_f_dc_supported ?
303 MEI_HBM_ENUM_F_ALLOW_ADD : 0;
304 enum_req.flags |= dev->hbm_f_ie_supported ?
305 MEI_HBM_ENUM_F_IMMEDIATE_ENUM : 0;
307 ret = mei_write_message(dev, &mei_hdr, &enum_req);
309 dev_err(dev->dev, "enumeration request write failed: ret = %d.\n",
313 dev->hbm_state = MEI_HBM_ENUM_CLIENTS;
314 dev->init_clients_timer = MEI_CLIENTS_INIT_TIMEOUT;
319 * mei_hbm_me_cl_add - add new me client to the list
321 * @dev: the device structure
322 * @res: hbm property response
324 * Return: 0 on success and -ENOMEM on allocation failure
327 static int mei_hbm_me_cl_add(struct mei_device *dev,
328 struct hbm_props_response *res)
330 struct mei_me_client *me_cl;
331 const uuid_le *uuid = &res->client_properties.protocol_name;
333 mei_me_cl_rm_by_uuid(dev, uuid);
335 me_cl = kzalloc(sizeof(struct mei_me_client), GFP_KERNEL);
339 mei_me_cl_init(me_cl);
341 me_cl->props = res->client_properties;
342 me_cl->client_id = res->me_addr;
343 me_cl->tx_flow_ctrl_creds = 0;
345 mei_me_cl_add(dev, me_cl);
351 * mei_hbm_add_cl_resp - send response to fw on client add request
353 * @dev: the device structure
355 * @status: response status
357 * Return: 0 on success and < 0 on failure
359 static int mei_hbm_add_cl_resp(struct mei_device *dev, u8 addr, u8 status)
361 struct mei_msg_hdr mei_hdr;
362 struct hbm_add_client_response resp;
363 const size_t len = sizeof(struct hbm_add_client_response);
366 dev_dbg(dev->dev, "adding client response\n");
368 mei_hbm_hdr(&mei_hdr, len);
370 memset(&resp, 0, sizeof(struct hbm_add_client_response));
371 resp.hbm_cmd = MEI_HBM_ADD_CLIENT_RES_CMD;
373 resp.status = status;
375 ret = mei_write_message(dev, &mei_hdr, &resp);
377 dev_err(dev->dev, "add client response write failed: ret = %d\n",
383 * mei_hbm_fw_add_cl_req - request from the fw to add a client
385 * @dev: the device structure
386 * @req: add client request
388 * Return: 0 on success and < 0 on failure
390 static int mei_hbm_fw_add_cl_req(struct mei_device *dev,
391 struct hbm_add_client_request *req)
394 u8 status = MEI_HBMS_SUCCESS;
396 BUILD_BUG_ON(sizeof(struct hbm_add_client_request) !=
397 sizeof(struct hbm_props_response));
399 ret = mei_hbm_me_cl_add(dev, (struct hbm_props_response *)req);
401 status = !MEI_HBMS_SUCCESS;
403 if (dev->dev_state == MEI_DEV_ENABLED)
404 schedule_work(&dev->bus_rescan_work);
406 return mei_hbm_add_cl_resp(dev, req->me_addr, status);
410 * mei_hbm_cl_notify_req - send notification request
412 * @dev: the device structure
413 * @cl: a client to disconnect from
414 * @start: true for start false for stop
416 * Return: 0 on success and -EIO on write failure
418 int mei_hbm_cl_notify_req(struct mei_device *dev,
419 struct mei_cl *cl, u8 start)
422 struct mei_msg_hdr mei_hdr;
423 struct hbm_notification_request req;
424 const size_t len = sizeof(struct hbm_notification_request);
427 mei_hbm_hdr(&mei_hdr, len);
428 mei_hbm_cl_hdr(cl, MEI_HBM_NOTIFY_REQ_CMD, &req, len);
432 ret = mei_write_message(dev, &mei_hdr, &req);
434 dev_err(dev->dev, "notify request failed: ret = %d\n", ret);
440 * notify_res_to_fop - convert notification response to the proper
443 * @cmd: client notification start response command
445 * Return: MEI_FOP_NOTIFY_START or MEI_FOP_NOTIFY_STOP;
447 static inline enum mei_cb_file_ops notify_res_to_fop(struct mei_hbm_cl_cmd *cmd)
449 struct hbm_notification_response *rs =
450 (struct hbm_notification_response *)cmd;
452 return mei_cl_notify_req2fop(rs->start);
456 * mei_hbm_cl_notify_start_res - update the client state according
457 * notify start response
459 * @dev: the device structure
460 * @cl: mei host client
461 * @cmd: client notification start response command
463 static void mei_hbm_cl_notify_start_res(struct mei_device *dev,
465 struct mei_hbm_cl_cmd *cmd)
467 struct hbm_notification_response *rs =
468 (struct hbm_notification_response *)cmd;
470 cl_dbg(dev, cl, "hbm: notify start response status=%d\n", rs->status);
472 if (rs->status == MEI_HBMS_SUCCESS ||
473 rs->status == MEI_HBMS_ALREADY_STARTED) {
474 cl->notify_en = true;
477 cl->status = -EINVAL;
482 * mei_hbm_cl_notify_stop_res - update the client state according
483 * notify stop response
485 * @dev: the device structure
486 * @cl: mei host client
487 * @cmd: client notification stop response command
489 static void mei_hbm_cl_notify_stop_res(struct mei_device *dev,
491 struct mei_hbm_cl_cmd *cmd)
493 struct hbm_notification_response *rs =
494 (struct hbm_notification_response *)cmd;
496 cl_dbg(dev, cl, "hbm: notify stop response status=%d\n", rs->status);
498 if (rs->status == MEI_HBMS_SUCCESS ||
499 rs->status == MEI_HBMS_NOT_STARTED) {
500 cl->notify_en = false;
503 /* TODO: spec is not clear yet about other possible issues */
504 cl->status = -EINVAL;
509 * mei_hbm_cl_notify - signal notification event
511 * @dev: the device structure
512 * @cmd: notification client message
514 static void mei_hbm_cl_notify(struct mei_device *dev,
515 struct mei_hbm_cl_cmd *cmd)
519 cl = mei_hbm_cl_find_by_cmd(dev, cmd);
525 * mei_hbm_prop_req - request property for a single client
527 * @dev: the device structure
528 * @start_idx: client index to start search
530 * Return: 0 on success and < 0 on failure
532 static int mei_hbm_prop_req(struct mei_device *dev, unsigned long start_idx)
534 struct mei_msg_hdr mei_hdr;
535 struct hbm_props_request prop_req;
536 const size_t len = sizeof(struct hbm_props_request);
540 addr = find_next_bit(dev->me_clients_map, MEI_CLIENTS_MAX, start_idx);
542 /* We got all client properties */
543 if (addr == MEI_CLIENTS_MAX) {
544 dev->hbm_state = MEI_HBM_STARTED;
545 mei_host_client_init(dev);
550 mei_hbm_hdr(&mei_hdr, len);
552 memset(&prop_req, 0, sizeof(struct hbm_props_request));
554 prop_req.hbm_cmd = HOST_CLIENT_PROPERTIES_REQ_CMD;
555 prop_req.me_addr = addr;
557 ret = mei_write_message(dev, &mei_hdr, &prop_req);
559 dev_err(dev->dev, "properties request write failed: ret = %d\n",
564 dev->init_clients_timer = MEI_CLIENTS_INIT_TIMEOUT;
570 * mei_hbm_pg - sends pg command
572 * @dev: the device structure
573 * @pg_cmd: the pg command code
575 * Return: -EIO on write failure
576 * -EOPNOTSUPP if the operation is not supported by the protocol
578 int mei_hbm_pg(struct mei_device *dev, u8 pg_cmd)
580 struct mei_msg_hdr mei_hdr;
581 struct hbm_power_gate req;
582 const size_t len = sizeof(struct hbm_power_gate);
585 if (!dev->hbm_f_pg_supported)
588 mei_hbm_hdr(&mei_hdr, len);
590 memset(&req, 0, len);
591 req.hbm_cmd = pg_cmd;
593 ret = mei_write_message(dev, &mei_hdr, &req);
595 dev_err(dev->dev, "power gate command write failed.\n");
598 EXPORT_SYMBOL_GPL(mei_hbm_pg);
601 * mei_hbm_stop_req - send stop request message
605 * Return: -EIO on write failure
607 static int mei_hbm_stop_req(struct mei_device *dev)
609 struct mei_msg_hdr mei_hdr;
610 struct hbm_host_stop_request req;
611 const size_t len = sizeof(struct hbm_host_stop_request);
613 mei_hbm_hdr(&mei_hdr, len);
615 memset(&req, 0, len);
616 req.hbm_cmd = HOST_STOP_REQ_CMD;
617 req.reason = DRIVER_STOP_REQUEST;
619 return mei_write_message(dev, &mei_hdr, &req);
623 * mei_hbm_cl_flow_control_req - sends flow control request.
625 * @dev: the device structure
628 * Return: -EIO on write failure
630 int mei_hbm_cl_flow_control_req(struct mei_device *dev, struct mei_cl *cl)
632 const size_t len = sizeof(struct hbm_flow_control);
635 cl_dbg(dev, cl, "sending flow control\n");
636 return mei_hbm_cl_write(dev, cl, MEI_FLOW_CONTROL_CMD, buf, len);
640 * mei_hbm_add_single_tx_flow_ctrl_creds - adds single buffer credentials.
642 * @dev: the device structure
643 * @fctrl: flow control response bus message
645 * Return: 0 on success, < 0 otherwise
647 static int mei_hbm_add_single_tx_flow_ctrl_creds(struct mei_device *dev,
648 struct hbm_flow_control *fctrl)
650 struct mei_me_client *me_cl;
653 me_cl = mei_me_cl_by_id(dev, fctrl->me_addr);
655 dev_err(dev->dev, "no such me client %d\n", fctrl->me_addr);
659 if (WARN_ON(me_cl->props.single_recv_buf == 0)) {
664 me_cl->tx_flow_ctrl_creds++;
665 dev_dbg(dev->dev, "recv flow ctrl msg ME %d (single) creds = %d.\n",
666 fctrl->me_addr, me_cl->tx_flow_ctrl_creds);
670 mei_me_cl_put(me_cl);
675 * mei_hbm_cl_flow_control_res - flow control response from me
677 * @dev: the device structure
678 * @fctrl: flow control response bus message
680 static void mei_hbm_cl_tx_flow_ctrl_creds_res(struct mei_device *dev,
681 struct hbm_flow_control *fctrl)
685 if (!fctrl->host_addr) {
686 /* single receive buffer */
687 mei_hbm_add_single_tx_flow_ctrl_creds(dev, fctrl);
691 cl = mei_hbm_cl_find_by_cmd(dev, fctrl);
693 cl->tx_flow_ctrl_creds++;
694 cl_dbg(dev, cl, "flow control creds = %d.\n",
695 cl->tx_flow_ctrl_creds);
701 * mei_hbm_cl_disconnect_req - sends disconnect message to fw.
703 * @dev: the device structure
704 * @cl: a client to disconnect from
706 * Return: -EIO on write failure
708 int mei_hbm_cl_disconnect_req(struct mei_device *dev, struct mei_cl *cl)
710 const size_t len = sizeof(struct hbm_client_connect_request);
713 return mei_hbm_cl_write(dev, cl, CLIENT_DISCONNECT_REQ_CMD, buf, len);
717 * mei_hbm_cl_disconnect_rsp - sends disconnect respose to the FW
719 * @dev: the device structure
720 * @cl: a client to disconnect from
722 * Return: -EIO on write failure
724 int mei_hbm_cl_disconnect_rsp(struct mei_device *dev, struct mei_cl *cl)
726 const size_t len = sizeof(struct hbm_client_connect_response);
729 return mei_hbm_cl_write(dev, cl, CLIENT_DISCONNECT_RES_CMD, buf, len);
733 * mei_hbm_cl_disconnect_res - update the client state according
734 * disconnect response
736 * @dev: the device structure
737 * @cl: mei host client
738 * @cmd: disconnect client response host bus message
740 static void mei_hbm_cl_disconnect_res(struct mei_device *dev, struct mei_cl *cl,
741 struct mei_hbm_cl_cmd *cmd)
743 struct hbm_client_connect_response *rs =
744 (struct hbm_client_connect_response *)cmd;
746 cl_dbg(dev, cl, "hbm: disconnect response status=%d\n", rs->status);
748 if (rs->status == MEI_CL_DISCONN_SUCCESS)
749 cl->state = MEI_FILE_DISCONNECT_REPLY;
754 * mei_hbm_cl_connect_req - send connection request to specific me client
756 * @dev: the device structure
757 * @cl: a client to connect to
759 * Return: -EIO on write failure
761 int mei_hbm_cl_connect_req(struct mei_device *dev, struct mei_cl *cl)
763 const size_t len = sizeof(struct hbm_client_connect_request);
766 return mei_hbm_cl_write(dev, cl, CLIENT_CONNECT_REQ_CMD, buf, len);
770 * mei_hbm_cl_connect_res - update the client state according
771 * connection response
773 * @dev: the device structure
774 * @cl: mei host client
775 * @cmd: connect client response host bus message
777 static void mei_hbm_cl_connect_res(struct mei_device *dev, struct mei_cl *cl,
778 struct mei_hbm_cl_cmd *cmd)
780 struct hbm_client_connect_response *rs =
781 (struct hbm_client_connect_response *)cmd;
783 cl_dbg(dev, cl, "hbm: connect response status=%s\n",
784 mei_cl_conn_status_str(rs->status));
786 if (rs->status == MEI_CL_CONN_SUCCESS)
787 cl->state = MEI_FILE_CONNECTED;
789 cl->state = MEI_FILE_DISCONNECT_REPLY;
790 if (rs->status == MEI_CL_CONN_NOT_FOUND) {
791 mei_me_cl_del(dev, cl->me_cl);
792 if (dev->dev_state == MEI_DEV_ENABLED)
793 schedule_work(&dev->bus_rescan_work);
796 cl->status = mei_cl_conn_status_to_errno(rs->status);
800 * mei_hbm_cl_res - process hbm response received on behalf
803 * @dev: the device structure
804 * @rs: hbm client message
805 * @fop_type: file operation type
807 static void mei_hbm_cl_res(struct mei_device *dev,
808 struct mei_hbm_cl_cmd *rs,
809 enum mei_cb_file_ops fop_type)
812 struct mei_cl_cb *cb, *next;
815 list_for_each_entry_safe(cb, next, &dev->ctrl_rd_list.list, list) {
819 if (cb->fop_type != fop_type)
822 if (mei_hbm_cl_addr_equal(cl, rs)) {
823 list_del_init(&cb->list);
832 case MEI_FOP_CONNECT:
833 mei_hbm_cl_connect_res(dev, cl, rs);
835 case MEI_FOP_DISCONNECT:
836 mei_hbm_cl_disconnect_res(dev, cl, rs);
838 case MEI_FOP_NOTIFY_START:
839 mei_hbm_cl_notify_start_res(dev, cl, rs);
841 case MEI_FOP_NOTIFY_STOP:
842 mei_hbm_cl_notify_stop_res(dev, cl, rs);
854 * mei_hbm_fw_disconnect_req - disconnect request initiated by ME firmware
855 * host sends disconnect response
857 * @dev: the device structure.
858 * @disconnect_req: disconnect request bus message from the me
860 * Return: -ENOMEM on allocation failure
862 static int mei_hbm_fw_disconnect_req(struct mei_device *dev,
863 struct hbm_client_connect_request *disconnect_req)
866 struct mei_cl_cb *cb;
868 cl = mei_hbm_cl_find_by_cmd(dev, disconnect_req);
870 cl_warn(dev, cl, "fw disconnect request received\n");
871 cl->state = MEI_FILE_DISCONNECTING;
874 cb = mei_cl_enqueue_ctrl_wr_cb(cl, 0, MEI_FOP_DISCONNECT_RSP,
883 * mei_hbm_pg_enter_res - PG enter response received
885 * @dev: the device structure.
887 * Return: 0 on success, -EPROTO on state mismatch
889 static int mei_hbm_pg_enter_res(struct mei_device *dev)
891 if (mei_pg_state(dev) != MEI_PG_OFF ||
892 dev->pg_event != MEI_PG_EVENT_WAIT) {
893 dev_err(dev->dev, "hbm: pg entry response: state mismatch [%s, %d]\n",
894 mei_pg_state_str(mei_pg_state(dev)), dev->pg_event);
898 dev->pg_event = MEI_PG_EVENT_RECEIVED;
899 wake_up(&dev->wait_pg);
905 * mei_hbm_pg_resume - process with PG resume
907 * @dev: the device structure.
909 void mei_hbm_pg_resume(struct mei_device *dev)
911 pm_request_resume(dev->dev);
913 EXPORT_SYMBOL_GPL(mei_hbm_pg_resume);
916 * mei_hbm_pg_exit_res - PG exit response received
918 * @dev: the device structure.
920 * Return: 0 on success, -EPROTO on state mismatch
922 static int mei_hbm_pg_exit_res(struct mei_device *dev)
924 if (mei_pg_state(dev) != MEI_PG_ON ||
925 (dev->pg_event != MEI_PG_EVENT_WAIT &&
926 dev->pg_event != MEI_PG_EVENT_IDLE)) {
927 dev_err(dev->dev, "hbm: pg exit response: state mismatch [%s, %d]\n",
928 mei_pg_state_str(mei_pg_state(dev)), dev->pg_event);
932 switch (dev->pg_event) {
933 case MEI_PG_EVENT_WAIT:
934 dev->pg_event = MEI_PG_EVENT_RECEIVED;
935 wake_up(&dev->wait_pg);
937 case MEI_PG_EVENT_IDLE:
939 * If the driver is not waiting on this then
940 * this is HW initiated exit from PG.
941 * Start runtime pm resume sequence to exit from PG.
943 dev->pg_event = MEI_PG_EVENT_RECEIVED;
944 mei_hbm_pg_resume(dev);
947 WARN(1, "hbm: pg exit response: unexpected pg event = %d\n",
956 * mei_hbm_config_features - check what hbm features and commands
957 * are supported by the fw
959 * @dev: the device structure
961 static void mei_hbm_config_features(struct mei_device *dev)
963 /* Power Gating Isolation Support */
964 dev->hbm_f_pg_supported = 0;
965 if (dev->version.major_version > HBM_MAJOR_VERSION_PGI)
966 dev->hbm_f_pg_supported = 1;
968 if (dev->version.major_version == HBM_MAJOR_VERSION_PGI &&
969 dev->version.minor_version >= HBM_MINOR_VERSION_PGI)
970 dev->hbm_f_pg_supported = 1;
972 if (dev->version.major_version >= HBM_MAJOR_VERSION_DC)
973 dev->hbm_f_dc_supported = 1;
975 if (dev->version.major_version >= HBM_MAJOR_VERSION_IE)
976 dev->hbm_f_ie_supported = 1;
978 /* disconnect on connect timeout instead of link reset */
979 if (dev->version.major_version >= HBM_MAJOR_VERSION_DOT)
980 dev->hbm_f_dot_supported = 1;
982 /* Notification Event Support */
983 if (dev->version.major_version >= HBM_MAJOR_VERSION_EV)
984 dev->hbm_f_ev_supported = 1;
986 /* Fixed Address Client Support */
987 if (dev->version.major_version >= HBM_MAJOR_VERSION_FA)
988 dev->hbm_f_fa_supported = 1;
992 * mei_hbm_version_is_supported - checks whether the driver can
993 * support the hbm version of the device
995 * @dev: the device structure
996 * Return: true if driver can support hbm version of the device
998 bool mei_hbm_version_is_supported(struct mei_device *dev)
1000 return (dev->version.major_version < HBM_MAJOR_VERSION) ||
1001 (dev->version.major_version == HBM_MAJOR_VERSION &&
1002 dev->version.minor_version <= HBM_MINOR_VERSION);
1006 * mei_hbm_dispatch - bottom half read routine after ISR to
1007 * handle the read bus message cmd processing.
1009 * @dev: the device structure
1010 * @hdr: header of bus message
1012 * Return: 0 on success and < 0 on failure
1014 int mei_hbm_dispatch(struct mei_device *dev, struct mei_msg_hdr *hdr)
1016 struct mei_bus_message *mei_msg;
1017 struct hbm_host_version_response *version_res;
1018 struct hbm_props_response *props_res;
1019 struct hbm_host_enum_response *enum_res;
1020 struct hbm_add_client_request *add_cl_req;
1023 struct mei_hbm_cl_cmd *cl_cmd;
1024 struct hbm_client_connect_request *disconnect_req;
1025 struct hbm_flow_control *fctrl;
1027 /* read the message to our buffer */
1028 BUG_ON(hdr->length >= sizeof(dev->rd_msg_buf));
1029 mei_read_slots(dev, dev->rd_msg_buf, hdr->length);
1030 mei_msg = (struct mei_bus_message *)dev->rd_msg_buf;
1031 cl_cmd = (struct mei_hbm_cl_cmd *)mei_msg;
1033 /* ignore spurious message and prevent reset nesting
1034 * hbm is put to idle during system reset
1036 if (dev->hbm_state == MEI_HBM_IDLE) {
1037 dev_dbg(dev->dev, "hbm: state is idle ignore spurious messages\n");
1041 switch (mei_msg->hbm_cmd) {
1042 case HOST_START_RES_CMD:
1043 dev_dbg(dev->dev, "hbm: start: response message received.\n");
1045 dev->init_clients_timer = 0;
1047 version_res = (struct hbm_host_version_response *)mei_msg;
1049 dev_dbg(dev->dev, "HBM VERSION: DRIVER=%02d:%02d DEVICE=%02d:%02d\n",
1050 HBM_MAJOR_VERSION, HBM_MINOR_VERSION,
1051 version_res->me_max_version.major_version,
1052 version_res->me_max_version.minor_version);
1054 if (version_res->host_version_supported) {
1055 dev->version.major_version = HBM_MAJOR_VERSION;
1056 dev->version.minor_version = HBM_MINOR_VERSION;
1058 dev->version.major_version =
1059 version_res->me_max_version.major_version;
1060 dev->version.minor_version =
1061 version_res->me_max_version.minor_version;
1064 if (!mei_hbm_version_is_supported(dev)) {
1065 dev_warn(dev->dev, "hbm: start: version mismatch - stopping the driver.\n");
1067 dev->hbm_state = MEI_HBM_STOPPED;
1068 if (mei_hbm_stop_req(dev)) {
1069 dev_err(dev->dev, "hbm: start: failed to send stop request\n");
1075 mei_hbm_config_features(dev);
1077 if (dev->dev_state != MEI_DEV_INIT_CLIENTS ||
1078 dev->hbm_state != MEI_HBM_STARTING) {
1079 dev_err(dev->dev, "hbm: start: state mismatch, [%d, %d]\n",
1080 dev->dev_state, dev->hbm_state);
1084 if (mei_hbm_enum_clients_req(dev)) {
1085 dev_err(dev->dev, "hbm: start: failed to send enumeration request\n");
1089 wake_up(&dev->wait_hbm_start);
1092 case CLIENT_CONNECT_RES_CMD:
1093 dev_dbg(dev->dev, "hbm: client connect response: message received.\n");
1094 mei_hbm_cl_res(dev, cl_cmd, MEI_FOP_CONNECT);
1097 case CLIENT_DISCONNECT_RES_CMD:
1098 dev_dbg(dev->dev, "hbm: client disconnect response: message received.\n");
1099 mei_hbm_cl_res(dev, cl_cmd, MEI_FOP_DISCONNECT);
1102 case MEI_FLOW_CONTROL_CMD:
1103 dev_dbg(dev->dev, "hbm: client flow control response: message received.\n");
1105 fctrl = (struct hbm_flow_control *)mei_msg;
1106 mei_hbm_cl_tx_flow_ctrl_creds_res(dev, fctrl);
1109 case MEI_PG_ISOLATION_ENTRY_RES_CMD:
1110 dev_dbg(dev->dev, "hbm: power gate isolation entry response received\n");
1111 ret = mei_hbm_pg_enter_res(dev);
1116 case MEI_PG_ISOLATION_EXIT_REQ_CMD:
1117 dev_dbg(dev->dev, "hbm: power gate isolation exit request received\n");
1118 ret = mei_hbm_pg_exit_res(dev);
1123 case HOST_CLIENT_PROPERTIES_RES_CMD:
1124 dev_dbg(dev->dev, "hbm: properties response: message received.\n");
1126 dev->init_clients_timer = 0;
1128 if (dev->dev_state != MEI_DEV_INIT_CLIENTS ||
1129 dev->hbm_state != MEI_HBM_CLIENT_PROPERTIES) {
1130 dev_err(dev->dev, "hbm: properties response: state mismatch, [%d, %d]\n",
1131 dev->dev_state, dev->hbm_state);
1135 props_res = (struct hbm_props_response *)mei_msg;
1137 if (props_res->status) {
1138 dev_err(dev->dev, "hbm: properties response: wrong status = %d %s\n",
1140 mei_hbm_status_str(props_res->status));
1144 mei_hbm_me_cl_add(dev, props_res);
1146 /* request property for the next client */
1147 if (mei_hbm_prop_req(dev, props_res->me_addr + 1))
1152 case HOST_ENUM_RES_CMD:
1153 dev_dbg(dev->dev, "hbm: enumeration response: message received\n");
1155 dev->init_clients_timer = 0;
1157 enum_res = (struct hbm_host_enum_response *) mei_msg;
1158 BUILD_BUG_ON(sizeof(dev->me_clients_map)
1159 < sizeof(enum_res->valid_addresses));
1160 memcpy(dev->me_clients_map, enum_res->valid_addresses,
1161 sizeof(enum_res->valid_addresses));
1163 if (dev->dev_state != MEI_DEV_INIT_CLIENTS ||
1164 dev->hbm_state != MEI_HBM_ENUM_CLIENTS) {
1165 dev_err(dev->dev, "hbm: enumeration response: state mismatch, [%d, %d]\n",
1166 dev->dev_state, dev->hbm_state);
1170 dev->hbm_state = MEI_HBM_CLIENT_PROPERTIES;
1172 /* first property request */
1173 if (mei_hbm_prop_req(dev, 0))
1178 case HOST_STOP_RES_CMD:
1179 dev_dbg(dev->dev, "hbm: stop response: message received\n");
1181 dev->init_clients_timer = 0;
1183 if (dev->hbm_state != MEI_HBM_STOPPED) {
1184 dev_err(dev->dev, "hbm: stop response: state mismatch, [%d, %d]\n",
1185 dev->dev_state, dev->hbm_state);
1189 dev->dev_state = MEI_DEV_POWER_DOWN;
1190 dev_info(dev->dev, "hbm: stop response: resetting.\n");
1191 /* force the reset */
1195 case CLIENT_DISCONNECT_REQ_CMD:
1196 dev_dbg(dev->dev, "hbm: disconnect request: message received\n");
1198 disconnect_req = (struct hbm_client_connect_request *)mei_msg;
1199 mei_hbm_fw_disconnect_req(dev, disconnect_req);
1202 case ME_STOP_REQ_CMD:
1203 dev_dbg(dev->dev, "hbm: stop request: message received\n");
1204 dev->hbm_state = MEI_HBM_STOPPED;
1205 if (mei_hbm_stop_req(dev)) {
1206 dev_err(dev->dev, "hbm: stop request: failed to send stop request\n");
1211 case MEI_HBM_ADD_CLIENT_REQ_CMD:
1212 dev_dbg(dev->dev, "hbm: add client request received\n");
1214 * after the host receives the enum_resp
1215 * message clients may be added or removed
1217 if (dev->hbm_state <= MEI_HBM_ENUM_CLIENTS ||
1218 dev->hbm_state >= MEI_HBM_STOPPED) {
1219 dev_err(dev->dev, "hbm: add client: state mismatch, [%d, %d]\n",
1220 dev->dev_state, dev->hbm_state);
1223 add_cl_req = (struct hbm_add_client_request *)mei_msg;
1224 ret = mei_hbm_fw_add_cl_req(dev, add_cl_req);
1226 dev_err(dev->dev, "hbm: add client: failed to send response %d\n",
1230 dev_dbg(dev->dev, "hbm: add client request processed\n");
1233 case MEI_HBM_NOTIFY_RES_CMD:
1234 dev_dbg(dev->dev, "hbm: notify response received\n");
1235 mei_hbm_cl_res(dev, cl_cmd, notify_res_to_fop(cl_cmd));
1238 case MEI_HBM_NOTIFICATION_CMD:
1239 dev_dbg(dev->dev, "hbm: notification\n");
1240 mei_hbm_cl_notify(dev, cl_cmd);