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 default: return "unknown";
60 const char *mei_hbm_state_str(enum mei_hbm_state state)
62 #define MEI_HBM_STATE(state) case MEI_HBM_##state: return #state
65 MEI_HBM_STATE(STARTING);
66 MEI_HBM_STATE(STARTED);
67 MEI_HBM_STATE(ENUM_CLIENTS);
68 MEI_HBM_STATE(CLIENT_PROPERTIES);
69 MEI_HBM_STATE(STOPPED);
77 * mei_cl_conn_status_to_errno - convert client connect response
78 * status to error code
80 * @status: client connect response status
82 * Return: corresponding error code
84 static int mei_cl_conn_status_to_errno(enum mei_cl_connect_status status)
87 case MEI_CL_CONN_SUCCESS: return 0;
88 case MEI_CL_CONN_NOT_FOUND: return -ENOTTY;
89 case MEI_CL_CONN_ALREADY_STARTED: return -EBUSY;
90 case MEI_CL_CONN_OUT_OF_RESOURCES: return -EBUSY;
91 case MEI_CL_CONN_MESSAGE_SMALL: return -EINVAL;
92 default: return -EINVAL;
97 * mei_hbm_idle - set hbm to idle state
99 * @dev: the device structure
101 void mei_hbm_idle(struct mei_device *dev)
103 dev->init_clients_timer = 0;
104 dev->hbm_state = MEI_HBM_IDLE;
108 * mei_hbm_reset - reset hbm counters and book keeping data structurs
110 * @dev: the device structure
112 void mei_hbm_reset(struct mei_device *dev)
114 dev->me_client_index = 0;
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;
138 * mei_hbm_cl_hdr - construct client hbm header
141 * @hbm_cmd: host bus message command
142 * @buf: buffer for cl header
143 * @len: buffer length
146 void mei_hbm_cl_hdr(struct mei_cl *cl, u8 hbm_cmd, void *buf, size_t len)
148 struct mei_hbm_cl_cmd *cmd = buf;
152 cmd->hbm_cmd = hbm_cmd;
153 cmd->host_addr = mei_cl_host_addr(cl);
154 cmd->me_addr = mei_cl_me_id(cl);
158 * mei_hbm_cl_write - write simple hbm client message
160 * @dev: the device structure
162 * @hbm_cmd: host bus message command
163 * @len: buffer length
165 * Return: 0 on success, <0 on failure.
168 int mei_hbm_cl_write(struct mei_device *dev,
169 struct mei_cl *cl, u8 hbm_cmd, size_t len)
171 struct mei_msg_hdr *mei_hdr = &dev->wr_msg.hdr;
173 mei_hbm_hdr(mei_hdr, len);
174 mei_hbm_cl_hdr(cl, hbm_cmd, dev->wr_msg.data, len);
176 return mei_write_message(dev, mei_hdr, dev->wr_msg.data);
180 * mei_hbm_cl_addr_equal - check if the client's and
181 * the message address match
184 * @cmd: hbm client message
186 * Return: true if addresses are the same
189 bool mei_hbm_cl_addr_equal(struct mei_cl *cl, struct mei_hbm_cl_cmd *cmd)
191 return mei_cl_host_addr(cl) == cmd->host_addr &&
192 mei_cl_me_id(cl) == cmd->me_addr;
196 * mei_hbm_cl_find_by_cmd - find recipient client
198 * @dev: the device structure
199 * @buf: a buffer with hbm cl command
201 * Return: the recipient client or NULL if not found
204 struct mei_cl *mei_hbm_cl_find_by_cmd(struct mei_device *dev, void *buf)
206 struct mei_hbm_cl_cmd *cmd = (struct mei_hbm_cl_cmd *)buf;
209 list_for_each_entry(cl, &dev->file_list, link)
210 if (mei_hbm_cl_addr_equal(cl, cmd))
217 * mei_hbm_start_wait - wait for start response message.
219 * @dev: the device structure
221 * Return: 0 on success and < 0 on failure
223 int mei_hbm_start_wait(struct mei_device *dev)
227 if (dev->hbm_state > MEI_HBM_STARTING)
230 mutex_unlock(&dev->device_lock);
231 ret = wait_event_timeout(dev->wait_hbm_start,
232 dev->hbm_state != MEI_HBM_STARTING,
233 mei_secs_to_jiffies(MEI_HBM_TIMEOUT));
234 mutex_lock(&dev->device_lock);
236 if (ret == 0 && (dev->hbm_state <= MEI_HBM_STARTING)) {
237 dev->hbm_state = MEI_HBM_IDLE;
238 dev_err(dev->dev, "waiting for mei start failed\n");
245 * mei_hbm_start_req - sends start request message.
247 * @dev: the device structure
249 * Return: 0 on success and < 0 on failure
251 int mei_hbm_start_req(struct mei_device *dev)
253 struct mei_msg_hdr *mei_hdr = &dev->wr_msg.hdr;
254 struct hbm_host_version_request *start_req;
255 const size_t len = sizeof(struct hbm_host_version_request);
260 mei_hbm_hdr(mei_hdr, len);
262 /* host start message */
263 start_req = (struct hbm_host_version_request *)dev->wr_msg.data;
264 memset(start_req, 0, len);
265 start_req->hbm_cmd = HOST_START_REQ_CMD;
266 start_req->host_version.major_version = HBM_MAJOR_VERSION;
267 start_req->host_version.minor_version = HBM_MINOR_VERSION;
269 dev->hbm_state = MEI_HBM_IDLE;
270 ret = mei_write_message(dev, mei_hdr, dev->wr_msg.data);
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;
283 * mei_hbm_enum_clients_req - sends enumeration client request message.
285 * @dev: the device structure
287 * Return: 0 on success and < 0 on failure
289 static int mei_hbm_enum_clients_req(struct mei_device *dev)
291 struct mei_msg_hdr *mei_hdr = &dev->wr_msg.hdr;
292 struct hbm_host_enum_request *enum_req;
293 const size_t len = sizeof(struct hbm_host_enum_request);
296 /* enumerate clients */
297 mei_hbm_hdr(mei_hdr, len);
299 enum_req = (struct hbm_host_enum_request *)dev->wr_msg.data;
300 memset(enum_req, 0, len);
301 enum_req->hbm_cmd = HOST_ENUM_REQ_CMD;
302 enum_req->allow_add = dev->hbm_f_dc_supported;
304 ret = mei_write_message(dev, mei_hdr, dev->wr_msg.data);
306 dev_err(dev->dev, "enumeration request write failed: ret = %d.\n",
310 dev->hbm_state = MEI_HBM_ENUM_CLIENTS;
311 dev->init_clients_timer = MEI_CLIENTS_INIT_TIMEOUT;
316 * mei_hbm_me_cl_add - add new me client to the list
318 * @dev: the device structure
319 * @res: hbm property response
321 * Return: 0 on success and -ENOMEM on allocation failure
324 static int mei_hbm_me_cl_add(struct mei_device *dev,
325 struct hbm_props_response *res)
327 struct mei_me_client *me_cl;
328 const uuid_le *uuid = &res->client_properties.protocol_name;
330 mei_me_cl_rm_by_uuid(dev, uuid);
332 me_cl = kzalloc(sizeof(struct mei_me_client), GFP_KERNEL);
336 mei_me_cl_init(me_cl);
338 me_cl->props = res->client_properties;
339 me_cl->client_id = res->me_addr;
340 me_cl->mei_flow_ctrl_creds = 0;
342 mei_me_cl_add(dev, me_cl);
348 * mei_hbm_add_cl_resp - send response to fw on client add request
350 * @dev: the device structure
352 * @status: response status
354 * Return: 0 on success and < 0 on failure
356 static int mei_hbm_add_cl_resp(struct mei_device *dev, u8 addr, u8 status)
358 struct mei_msg_hdr *mei_hdr = &dev->wr_msg.hdr;
359 struct hbm_add_client_response *resp;
360 const size_t len = sizeof(struct hbm_add_client_response);
363 dev_dbg(dev->dev, "adding client response\n");
365 resp = (struct hbm_add_client_response *)dev->wr_msg.data;
367 mei_hbm_hdr(mei_hdr, len);
368 memset(resp, 0, sizeof(struct hbm_add_client_response));
370 resp->hbm_cmd = MEI_HBM_ADD_CLIENT_RES_CMD;
371 resp->me_addr = addr;
372 resp->status = status;
374 ret = mei_write_message(dev, mei_hdr, dev->wr_msg.data);
376 dev_err(dev->dev, "add client response write failed: ret = %d\n",
382 * mei_hbm_fw_add_cl_req - request from the fw to add a client
384 * @dev: the device structure
385 * @req: add client request
387 * Return: 0 on success and < 0 on failure
389 static int mei_hbm_fw_add_cl_req(struct mei_device *dev,
390 struct hbm_add_client_request *req)
393 u8 status = MEI_HBMS_SUCCESS;
395 BUILD_BUG_ON(sizeof(struct hbm_add_client_request) !=
396 sizeof(struct hbm_props_response));
398 ret = mei_hbm_me_cl_add(dev, (struct hbm_props_response *)req);
400 status = !MEI_HBMS_SUCCESS;
402 return mei_hbm_add_cl_resp(dev, req->me_addr, status);
406 * mei_hbm_cl_notify_req - send notification request
408 * @dev: the device structure
409 * @cl: a client to disconnect from
410 * @start: true for start false for stop
412 * Return: 0 on success and -EIO on write failure
414 int mei_hbm_cl_notify_req(struct mei_device *dev,
415 struct mei_cl *cl, u8 start)
418 struct mei_msg_hdr *mei_hdr = &dev->wr_msg.hdr;
419 struct hbm_notification_request *req;
420 const size_t len = sizeof(struct hbm_notification_request);
423 mei_hbm_hdr(mei_hdr, len);
424 mei_hbm_cl_hdr(cl, MEI_HBM_NOTIFY_REQ_CMD, dev->wr_msg.data, len);
426 req = (struct hbm_notification_request *)dev->wr_msg.data;
429 ret = mei_write_message(dev, mei_hdr, dev->wr_msg.data);
431 dev_err(dev->dev, "notify request failed: ret = %d\n", ret);
437 * notify_res_to_fop - convert notification response to the proper
440 * @cmd: client notification start response command
442 * Return: MEI_FOP_NOTIFY_START or MEI_FOP_NOTIFY_STOP;
444 static inline enum mei_cb_file_ops notify_res_to_fop(struct mei_hbm_cl_cmd *cmd)
446 struct hbm_notification_response *rs =
447 (struct hbm_notification_response *)cmd;
449 return mei_cl_notify_req2fop(rs->start);
453 * mei_hbm_cl_notify_start_res - update the client state according
454 * notify start response
456 * @dev: the device structure
457 * @cl: mei host client
458 * @cmd: client notification start response command
460 static void mei_hbm_cl_notify_start_res(struct mei_device *dev,
462 struct mei_hbm_cl_cmd *cmd)
464 struct hbm_notification_response *rs =
465 (struct hbm_notification_response *)cmd;
467 cl_dbg(dev, cl, "hbm: notify start response status=%d\n", rs->status);
469 if (rs->status == MEI_HBMS_SUCCESS ||
470 rs->status == MEI_HBMS_ALREADY_STARTED) {
471 cl->notify_en = true;
474 cl->status = -EINVAL;
479 * mei_hbm_cl_notify_stop_res - update the client state according
480 * notify stop response
482 * @dev: the device structure
483 * @cl: mei host client
484 * @cmd: client notification stop response command
486 static void mei_hbm_cl_notify_stop_res(struct mei_device *dev,
488 struct mei_hbm_cl_cmd *cmd)
490 struct hbm_notification_response *rs =
491 (struct hbm_notification_response *)cmd;
493 cl_dbg(dev, cl, "hbm: notify stop response status=%d\n", rs->status);
495 if (rs->status == MEI_HBMS_SUCCESS ||
496 rs->status == MEI_HBMS_NOT_STARTED) {
497 cl->notify_en = false;
500 /* TODO: spec is not clear yet about other possible issues */
501 cl->status = -EINVAL;
506 * mei_hbm_cl_notify - signal notification event
508 * @dev: the device structure
509 * @cmd: notification client message
511 static void mei_hbm_cl_notify(struct mei_device *dev,
512 struct mei_hbm_cl_cmd *cmd)
516 cl = mei_hbm_cl_find_by_cmd(dev, cmd);
517 if (cl && cl->notify_en) {
518 cl->notify_ev = true;
519 wake_up_interruptible(&cl->ev_wait);
524 * mei_hbm_prop_req - request property for a single client
526 * @dev: the device structure
528 * Return: 0 on success and < 0 on failure
531 static int mei_hbm_prop_req(struct mei_device *dev)
534 struct mei_msg_hdr *mei_hdr = &dev->wr_msg.hdr;
535 struct hbm_props_request *prop_req;
536 const size_t len = sizeof(struct hbm_props_request);
537 unsigned long next_client_index;
540 next_client_index = find_next_bit(dev->me_clients_map, MEI_CLIENTS_MAX,
541 dev->me_client_index);
543 /* We got all client properties */
544 if (next_client_index == MEI_CLIENTS_MAX) {
545 dev->hbm_state = MEI_HBM_STARTED;
546 schedule_work(&dev->init_work);
551 mei_hbm_hdr(mei_hdr, len);
552 prop_req = (struct hbm_props_request *)dev->wr_msg.data;
554 memset(prop_req, 0, sizeof(struct hbm_props_request));
556 prop_req->hbm_cmd = HOST_CLIENT_PROPERTIES_REQ_CMD;
557 prop_req->me_addr = next_client_index;
559 ret = mei_write_message(dev, mei_hdr, dev->wr_msg.data);
561 dev_err(dev->dev, "properties request write failed: ret = %d\n",
566 dev->init_clients_timer = MEI_CLIENTS_INIT_TIMEOUT;
567 dev->me_client_index = next_client_index;
573 * mei_hbm_pg - sends pg command
575 * @dev: the device structure
576 * @pg_cmd: the pg command code
578 * Return: -EIO on write failure
579 * -EOPNOTSUPP if the operation is not supported by the protocol
581 int mei_hbm_pg(struct mei_device *dev, u8 pg_cmd)
583 struct mei_msg_hdr *mei_hdr = &dev->wr_msg.hdr;
584 struct hbm_power_gate *req;
585 const size_t len = sizeof(struct hbm_power_gate);
588 if (!dev->hbm_f_pg_supported)
591 mei_hbm_hdr(mei_hdr, len);
593 req = (struct hbm_power_gate *)dev->wr_msg.data;
595 req->hbm_cmd = pg_cmd;
597 ret = mei_write_message(dev, mei_hdr, dev->wr_msg.data);
599 dev_err(dev->dev, "power gate command write failed.\n");
602 EXPORT_SYMBOL_GPL(mei_hbm_pg);
605 * mei_hbm_stop_req - send stop request message
609 * Return: -EIO on write failure
611 static int mei_hbm_stop_req(struct mei_device *dev)
613 struct mei_msg_hdr *mei_hdr = &dev->wr_msg.hdr;
614 struct hbm_host_stop_request *req =
615 (struct hbm_host_stop_request *)dev->wr_msg.data;
616 const size_t len = sizeof(struct hbm_host_stop_request);
618 mei_hbm_hdr(mei_hdr, len);
621 req->hbm_cmd = HOST_STOP_REQ_CMD;
622 req->reason = DRIVER_STOP_REQUEST;
624 return mei_write_message(dev, mei_hdr, dev->wr_msg.data);
628 * mei_hbm_cl_flow_control_req - sends flow control request.
630 * @dev: the device structure
633 * Return: -EIO on write failure
635 int mei_hbm_cl_flow_control_req(struct mei_device *dev, struct mei_cl *cl)
637 const size_t len = sizeof(struct hbm_flow_control);
639 cl_dbg(dev, cl, "sending flow control\n");
640 return mei_hbm_cl_write(dev, cl, MEI_FLOW_CONTROL_CMD, len);
644 * mei_hbm_add_single_flow_creds - adds single buffer credentials.
646 * @dev: the device structure
647 * @flow: flow control.
649 * Return: 0 on success, < 0 otherwise
651 static int mei_hbm_add_single_flow_creds(struct mei_device *dev,
652 struct hbm_flow_control *flow)
654 struct mei_me_client *me_cl;
657 me_cl = mei_me_cl_by_id(dev, flow->me_addr);
659 dev_err(dev->dev, "no such me client %d\n",
664 if (WARN_ON(me_cl->props.single_recv_buf == 0)) {
669 me_cl->mei_flow_ctrl_creds++;
670 dev_dbg(dev->dev, "recv flow ctrl msg ME %d (single) creds = %d.\n",
671 flow->me_addr, me_cl->mei_flow_ctrl_creds);
675 mei_me_cl_put(me_cl);
680 * mei_hbm_cl_flow_control_res - flow control response from me
682 * @dev: the device structure
683 * @flow_control: flow control response bus message
685 static void mei_hbm_cl_flow_control_res(struct mei_device *dev,
686 struct hbm_flow_control *flow_control)
690 if (!flow_control->host_addr) {
691 /* single receive buffer */
692 mei_hbm_add_single_flow_creds(dev, flow_control);
696 cl = mei_hbm_cl_find_by_cmd(dev, flow_control);
698 cl->mei_flow_ctrl_creds++;
699 cl_dbg(dev, cl, "flow control creds = %d.\n",
700 cl->mei_flow_ctrl_creds);
706 * mei_hbm_cl_disconnect_req - sends disconnect message to fw.
708 * @dev: the device structure
709 * @cl: a client to disconnect from
711 * Return: -EIO on write failure
713 int mei_hbm_cl_disconnect_req(struct mei_device *dev, struct mei_cl *cl)
715 const size_t len = sizeof(struct hbm_client_connect_request);
717 return mei_hbm_cl_write(dev, cl, CLIENT_DISCONNECT_REQ_CMD, len);
721 * mei_hbm_cl_disconnect_rsp - sends disconnect respose to the FW
723 * @dev: the device structure
724 * @cl: a client to disconnect from
726 * Return: -EIO on write failure
728 int mei_hbm_cl_disconnect_rsp(struct mei_device *dev, struct mei_cl *cl)
730 const size_t len = sizeof(struct hbm_client_connect_response);
732 return mei_hbm_cl_write(dev, cl, CLIENT_DISCONNECT_RES_CMD, len);
736 * mei_hbm_cl_disconnect_res - update the client state according
737 * disconnect response
739 * @dev: the device structure
740 * @cl: mei host client
741 * @cmd: disconnect client response host bus message
743 static void mei_hbm_cl_disconnect_res(struct mei_device *dev, struct mei_cl *cl,
744 struct mei_hbm_cl_cmd *cmd)
746 struct hbm_client_connect_response *rs =
747 (struct hbm_client_connect_response *)cmd;
749 cl_dbg(dev, cl, "hbm: disconnect response status=%d\n", rs->status);
751 if (rs->status == MEI_CL_DISCONN_SUCCESS)
752 cl->state = MEI_FILE_DISCONNECT_REPLY;
757 * mei_hbm_cl_connect_req - send connection request to specific me client
759 * @dev: the device structure
760 * @cl: a client to connect to
762 * Return: -EIO on write failure
764 int mei_hbm_cl_connect_req(struct mei_device *dev, struct mei_cl *cl)
766 const size_t len = sizeof(struct hbm_client_connect_request);
768 return mei_hbm_cl_write(dev, cl, CLIENT_CONNECT_REQ_CMD, len);
772 * mei_hbm_cl_connect_res - update the client state according
773 * connection response
775 * @dev: the device structure
776 * @cl: mei host client
777 * @cmd: connect client response host bus message
779 static void mei_hbm_cl_connect_res(struct mei_device *dev, struct mei_cl *cl,
780 struct mei_hbm_cl_cmd *cmd)
782 struct hbm_client_connect_response *rs =
783 (struct hbm_client_connect_response *)cmd;
785 cl_dbg(dev, cl, "hbm: connect response status=%s\n",
786 mei_cl_conn_status_str(rs->status));
788 if (rs->status == MEI_CL_CONN_SUCCESS)
789 cl->state = MEI_FILE_CONNECTED;
791 cl->state = MEI_FILE_DISCONNECT_REPLY;
792 if (rs->status == MEI_CL_CONN_NOT_FOUND)
793 mei_me_cl_del(dev, cl->me_cl);
795 cl->status = mei_cl_conn_status_to_errno(rs->status);
799 * mei_hbm_cl_res - process hbm response received on behalf
802 * @dev: the device structure
803 * @rs: hbm client message
804 * @fop_type: file operation type
806 static void mei_hbm_cl_res(struct mei_device *dev,
807 struct mei_hbm_cl_cmd *rs,
808 enum mei_cb_file_ops fop_type)
811 struct mei_cl_cb *cb, *next;
814 list_for_each_entry_safe(cb, next, &dev->ctrl_rd_list.list, list) {
818 if (cb->fop_type != fop_type)
821 if (mei_hbm_cl_addr_equal(cl, rs)) {
822 list_del_init(&cb->list);
831 case MEI_FOP_CONNECT:
832 mei_hbm_cl_connect_res(dev, cl, rs);
834 case MEI_FOP_DISCONNECT:
835 mei_hbm_cl_disconnect_res(dev, cl, rs);
837 case MEI_FOP_NOTIFY_START:
838 mei_hbm_cl_notify_start_res(dev, cl, rs);
840 case MEI_FOP_NOTIFY_STOP:
841 mei_hbm_cl_notify_stop_res(dev, cl, rs);
853 * mei_hbm_fw_disconnect_req - disconnect request initiated by ME firmware
854 * host sends disconnect response
856 * @dev: the device structure.
857 * @disconnect_req: disconnect request bus message from the me
859 * Return: -ENOMEM on allocation failure
861 static int mei_hbm_fw_disconnect_req(struct mei_device *dev,
862 struct hbm_client_connect_request *disconnect_req)
865 struct mei_cl_cb *cb;
867 cl = mei_hbm_cl_find_by_cmd(dev, disconnect_req);
869 cl_dbg(dev, cl, "fw disconnect request received\n");
870 cl->state = MEI_FILE_DISCONNECTING;
873 cb = mei_io_cb_init(cl, MEI_FOP_DISCONNECT_RSP, NULL);
876 cl_dbg(dev, cl, "add disconnect response as first\n");
877 list_add(&cb->list, &dev->ctrl_wr_list.list);
883 * mei_hbm_config_features - check what hbm features and commands
884 * are supported by the fw
886 * @dev: the device structure
888 static void mei_hbm_config_features(struct mei_device *dev)
890 /* Power Gating Isolation Support */
891 dev->hbm_f_pg_supported = 0;
892 if (dev->version.major_version > HBM_MAJOR_VERSION_PGI)
893 dev->hbm_f_pg_supported = 1;
895 if (dev->version.major_version == HBM_MAJOR_VERSION_PGI &&
896 dev->version.minor_version >= HBM_MINOR_VERSION_PGI)
897 dev->hbm_f_pg_supported = 1;
899 if (dev->version.major_version >= HBM_MAJOR_VERSION_DC)
900 dev->hbm_f_dc_supported = 1;
902 /* disconnect on connect timeout instead of link reset */
903 if (dev->version.major_version >= HBM_MAJOR_VERSION_DOT)
904 dev->hbm_f_dot_supported = 1;
906 /* Notification Event Support */
907 if (dev->version.major_version >= HBM_MAJOR_VERSION_EV)
908 dev->hbm_f_ev_supported = 1;
912 * mei_hbm_version_is_supported - checks whether the driver can
913 * support the hbm version of the device
915 * @dev: the device structure
916 * Return: true if driver can support hbm version of the device
918 bool mei_hbm_version_is_supported(struct mei_device *dev)
920 return (dev->version.major_version < HBM_MAJOR_VERSION) ||
921 (dev->version.major_version == HBM_MAJOR_VERSION &&
922 dev->version.minor_version <= HBM_MINOR_VERSION);
926 * mei_hbm_dispatch - bottom half read routine after ISR to
927 * handle the read bus message cmd processing.
929 * @dev: the device structure
930 * @hdr: header of bus message
932 * Return: 0 on success and < 0 on failure
934 int mei_hbm_dispatch(struct mei_device *dev, struct mei_msg_hdr *hdr)
936 struct mei_bus_message *mei_msg;
937 struct hbm_host_version_response *version_res;
938 struct hbm_props_response *props_res;
939 struct hbm_host_enum_response *enum_res;
940 struct hbm_add_client_request *add_cl_req;
943 struct mei_hbm_cl_cmd *cl_cmd;
944 struct hbm_client_connect_request *disconnect_req;
945 struct hbm_flow_control *flow_control;
947 /* read the message to our buffer */
948 BUG_ON(hdr->length >= sizeof(dev->rd_msg_buf));
949 mei_read_slots(dev, dev->rd_msg_buf, hdr->length);
950 mei_msg = (struct mei_bus_message *)dev->rd_msg_buf;
951 cl_cmd = (struct mei_hbm_cl_cmd *)mei_msg;
953 /* ignore spurious message and prevent reset nesting
954 * hbm is put to idle during system reset
956 if (dev->hbm_state == MEI_HBM_IDLE) {
957 dev_dbg(dev->dev, "hbm: state is idle ignore spurious messages\n");
961 switch (mei_msg->hbm_cmd) {
962 case HOST_START_RES_CMD:
963 dev_dbg(dev->dev, "hbm: start: response message received.\n");
965 dev->init_clients_timer = 0;
967 version_res = (struct hbm_host_version_response *)mei_msg;
969 dev_dbg(dev->dev, "HBM VERSION: DRIVER=%02d:%02d DEVICE=%02d:%02d\n",
970 HBM_MAJOR_VERSION, HBM_MINOR_VERSION,
971 version_res->me_max_version.major_version,
972 version_res->me_max_version.minor_version);
974 if (version_res->host_version_supported) {
975 dev->version.major_version = HBM_MAJOR_VERSION;
976 dev->version.minor_version = HBM_MINOR_VERSION;
978 dev->version.major_version =
979 version_res->me_max_version.major_version;
980 dev->version.minor_version =
981 version_res->me_max_version.minor_version;
984 if (!mei_hbm_version_is_supported(dev)) {
985 dev_warn(dev->dev, "hbm: start: version mismatch - stopping the driver.\n");
987 dev->hbm_state = MEI_HBM_STOPPED;
988 if (mei_hbm_stop_req(dev)) {
989 dev_err(dev->dev, "hbm: start: failed to send stop request\n");
995 mei_hbm_config_features(dev);
997 if (dev->dev_state != MEI_DEV_INIT_CLIENTS ||
998 dev->hbm_state != MEI_HBM_STARTING) {
999 dev_err(dev->dev, "hbm: start: state mismatch, [%d, %d]\n",
1000 dev->dev_state, dev->hbm_state);
1004 if (mei_hbm_enum_clients_req(dev)) {
1005 dev_err(dev->dev, "hbm: start: failed to send enumeration request\n");
1009 wake_up(&dev->wait_hbm_start);
1012 case CLIENT_CONNECT_RES_CMD:
1013 dev_dbg(dev->dev, "hbm: client connect response: message received.\n");
1014 mei_hbm_cl_res(dev, cl_cmd, MEI_FOP_CONNECT);
1017 case CLIENT_DISCONNECT_RES_CMD:
1018 dev_dbg(dev->dev, "hbm: client disconnect response: message received.\n");
1019 mei_hbm_cl_res(dev, cl_cmd, MEI_FOP_DISCONNECT);
1022 case MEI_FLOW_CONTROL_CMD:
1023 dev_dbg(dev->dev, "hbm: client flow control response: message received.\n");
1025 flow_control = (struct hbm_flow_control *) mei_msg;
1026 mei_hbm_cl_flow_control_res(dev, flow_control);
1029 case MEI_PG_ISOLATION_ENTRY_RES_CMD:
1030 dev_dbg(dev->dev, "power gate isolation entry response received\n");
1031 dev->pg_event = MEI_PG_EVENT_RECEIVED;
1032 if (waitqueue_active(&dev->wait_pg))
1033 wake_up(&dev->wait_pg);
1036 case MEI_PG_ISOLATION_EXIT_REQ_CMD:
1037 dev_dbg(dev->dev, "power gate isolation exit request received\n");
1038 dev->pg_event = MEI_PG_EVENT_RECEIVED;
1039 if (waitqueue_active(&dev->wait_pg))
1040 wake_up(&dev->wait_pg);
1043 * If the driver is not waiting on this then
1044 * this is HW initiated exit from PG.
1045 * Start runtime pm resume sequence to exit from PG.
1047 pm_request_resume(dev->dev);
1050 case HOST_CLIENT_PROPERTIES_RES_CMD:
1051 dev_dbg(dev->dev, "hbm: properties response: message received.\n");
1053 dev->init_clients_timer = 0;
1055 if (dev->dev_state != MEI_DEV_INIT_CLIENTS ||
1056 dev->hbm_state != MEI_HBM_CLIENT_PROPERTIES) {
1057 dev_err(dev->dev, "hbm: properties response: state mismatch, [%d, %d]\n",
1058 dev->dev_state, dev->hbm_state);
1062 props_res = (struct hbm_props_response *)mei_msg;
1064 if (props_res->status) {
1065 dev_err(dev->dev, "hbm: properties response: wrong status = %d %s\n",
1067 mei_hbm_status_str(props_res->status));
1071 mei_hbm_me_cl_add(dev, props_res);
1073 dev->me_client_index++;
1075 /* request property for the next client */
1076 if (mei_hbm_prop_req(dev))
1081 case HOST_ENUM_RES_CMD:
1082 dev_dbg(dev->dev, "hbm: enumeration response: message received\n");
1084 dev->init_clients_timer = 0;
1086 enum_res = (struct hbm_host_enum_response *) mei_msg;
1087 BUILD_BUG_ON(sizeof(dev->me_clients_map)
1088 < sizeof(enum_res->valid_addresses));
1089 memcpy(dev->me_clients_map, enum_res->valid_addresses,
1090 sizeof(enum_res->valid_addresses));
1092 if (dev->dev_state != MEI_DEV_INIT_CLIENTS ||
1093 dev->hbm_state != MEI_HBM_ENUM_CLIENTS) {
1094 dev_err(dev->dev, "hbm: enumeration response: state mismatch, [%d, %d]\n",
1095 dev->dev_state, dev->hbm_state);
1099 dev->hbm_state = MEI_HBM_CLIENT_PROPERTIES;
1101 /* first property request */
1102 if (mei_hbm_prop_req(dev))
1107 case HOST_STOP_RES_CMD:
1108 dev_dbg(dev->dev, "hbm: stop response: message received\n");
1110 dev->init_clients_timer = 0;
1112 if (dev->hbm_state != MEI_HBM_STOPPED) {
1113 dev_err(dev->dev, "hbm: stop response: state mismatch, [%d, %d]\n",
1114 dev->dev_state, dev->hbm_state);
1118 dev->dev_state = MEI_DEV_POWER_DOWN;
1119 dev_info(dev->dev, "hbm: stop response: resetting.\n");
1120 /* force the reset */
1124 case CLIENT_DISCONNECT_REQ_CMD:
1125 dev_dbg(dev->dev, "hbm: disconnect request: message received\n");
1127 disconnect_req = (struct hbm_client_connect_request *)mei_msg;
1128 mei_hbm_fw_disconnect_req(dev, disconnect_req);
1131 case ME_STOP_REQ_CMD:
1132 dev_dbg(dev->dev, "hbm: stop request: message received\n");
1133 dev->hbm_state = MEI_HBM_STOPPED;
1134 if (mei_hbm_stop_req(dev)) {
1135 dev_err(dev->dev, "hbm: stop request: failed to send stop request\n");
1140 case MEI_HBM_ADD_CLIENT_REQ_CMD:
1141 dev_dbg(dev->dev, "hbm: add client request received\n");
1143 * after the host receives the enum_resp
1144 * message clients may be added or removed
1146 if (dev->hbm_state <= MEI_HBM_ENUM_CLIENTS &&
1147 dev->hbm_state >= MEI_HBM_STOPPED) {
1148 dev_err(dev->dev, "hbm: add client: state mismatch, [%d, %d]\n",
1149 dev->dev_state, dev->hbm_state);
1152 add_cl_req = (struct hbm_add_client_request *)mei_msg;
1153 ret = mei_hbm_fw_add_cl_req(dev, add_cl_req);
1155 dev_err(dev->dev, "hbm: add client: failed to send response %d\n",
1159 dev_dbg(dev->dev, "hbm: add client request processed\n");
1162 case MEI_HBM_NOTIFY_RES_CMD:
1163 dev_dbg(dev->dev, "hbm: notify response received\n");
1164 mei_hbm_cl_res(dev, cl_cmd, notify_res_to_fop(cl_cmd));
1167 case MEI_HBM_NOTIFICATION_CMD:
1168 dev_dbg(dev->dev, "hbm: notification\n");
1169 mei_hbm_cl_notify(dev, cl_cmd);