1 // SPDX-License-Identifier: GPL-2.0+
3 * ufs.c - Universal Flash Subsystem (UFS) driver
5 * Taken from Linux Kernel v5.2 (drivers/scsi/ufs/ufshcd.c) and ported
8 * Copyright (C) 2019 Texas Instruments Incorporated - http://www.ti.com
15 #include <dm/device_compat.h>
16 #include <dm/devres.h>
18 #include <dm/device-internal.h>
23 #include <linux/dma-mapping.h>
27 #define UFSHCD_ENABLE_INTRS (UTP_TRANSFER_REQ_COMPL |\
30 /* maximum number of link-startup retries */
31 #define DME_LINKSTARTUP_RETRIES 3
33 /* maximum number of retries for a general UIC command */
34 #define UFS_UIC_COMMAND_RETRIES 3
36 /* Query request retries */
37 #define QUERY_REQ_RETRIES 3
38 /* Query request timeout */
39 #define QUERY_REQ_TIMEOUT 1500 /* 1.5 seconds */
41 /* maximum timeout in ms for a general UIC command */
42 #define UFS_UIC_CMD_TIMEOUT 1000
43 /* NOP OUT retries waiting for NOP IN response */
44 #define NOP_OUT_RETRIES 10
45 /* Timeout after 30 msecs if NOP OUT hangs without response */
46 #define NOP_OUT_TIMEOUT 30 /* msecs */
48 /* Only use one Task Tag for all requests */
51 /* Expose the flag value from utp_upiu_query.value */
52 #define MASK_QUERY_UPIU_FLAG_LOC 0xFF
54 #define MAX_PRDT_ENTRY 262144
56 /* maximum bytes per request */
57 #define UFS_MAX_BYTES (128 * 256 * 1024)
59 static inline bool ufshcd_is_hba_active(struct ufs_hba *hba);
60 static inline void ufshcd_hba_stop(struct ufs_hba *hba);
61 static int ufshcd_hba_enable(struct ufs_hba *hba);
64 * ufshcd_wait_for_register - wait for register value to change
66 static int ufshcd_wait_for_register(struct ufs_hba *hba, u32 reg, u32 mask,
67 u32 val, unsigned long timeout_ms)
70 unsigned long start = get_timer(0);
72 /* ignore bits that we don't intend to wait on */
75 while ((ufshcd_readl(hba, reg) & mask) != val) {
76 if (get_timer(start) > timeout_ms) {
77 if ((ufshcd_readl(hba, reg) & mask) != val)
87 * ufshcd_init_pwr_info - setting the POR (power on reset)
88 * values in hba power info
90 static void ufshcd_init_pwr_info(struct ufs_hba *hba)
92 hba->pwr_info.gear_rx = UFS_PWM_G1;
93 hba->pwr_info.gear_tx = UFS_PWM_G1;
94 hba->pwr_info.lane_rx = 1;
95 hba->pwr_info.lane_tx = 1;
96 hba->pwr_info.pwr_rx = SLOWAUTO_MODE;
97 hba->pwr_info.pwr_tx = SLOWAUTO_MODE;
98 hba->pwr_info.hs_rate = 0;
102 * ufshcd_print_pwr_info - print power params as saved in hba
105 static void ufshcd_print_pwr_info(struct ufs_hba *hba)
107 static const char * const names[] = {
117 dev_err(hba->dev, "[RX, TX]: gear=[%d, %d], lane[%d, %d], pwr[%s, %s], rate = %d\n",
118 hba->pwr_info.gear_rx, hba->pwr_info.gear_tx,
119 hba->pwr_info.lane_rx, hba->pwr_info.lane_tx,
120 names[hba->pwr_info.pwr_rx],
121 names[hba->pwr_info.pwr_tx],
122 hba->pwr_info.hs_rate);
126 * ufshcd_ready_for_uic_cmd - Check if controller is ready
127 * to accept UIC commands
129 static inline bool ufshcd_ready_for_uic_cmd(struct ufs_hba *hba)
131 if (ufshcd_readl(hba, REG_CONTROLLER_STATUS) & UIC_COMMAND_READY)
138 * ufshcd_get_uic_cmd_result - Get the UIC command result
140 static inline int ufshcd_get_uic_cmd_result(struct ufs_hba *hba)
142 return ufshcd_readl(hba, REG_UIC_COMMAND_ARG_2) &
143 MASK_UIC_COMMAND_RESULT;
147 * ufshcd_get_dme_attr_val - Get the value of attribute returned by UIC command
149 static inline u32 ufshcd_get_dme_attr_val(struct ufs_hba *hba)
151 return ufshcd_readl(hba, REG_UIC_COMMAND_ARG_3);
155 * ufshcd_is_device_present - Check if any device connected to
156 * the host controller
158 static inline bool ufshcd_is_device_present(struct ufs_hba *hba)
160 return (ufshcd_readl(hba, REG_CONTROLLER_STATUS) &
161 DEVICE_PRESENT) ? true : false;
165 * ufshcd_send_uic_cmd - UFS Interconnect layer command API
168 static int ufshcd_send_uic_cmd(struct ufs_hba *hba, struct uic_command *uic_cmd)
170 unsigned long start = 0;
172 u32 enabled_intr_status;
174 if (!ufshcd_ready_for_uic_cmd(hba)) {
176 "Controller not ready to accept UIC commands\n");
180 debug("sending uic command:%d\n", uic_cmd->command);
183 ufshcd_writel(hba, uic_cmd->argument1, REG_UIC_COMMAND_ARG_1);
184 ufshcd_writel(hba, uic_cmd->argument2, REG_UIC_COMMAND_ARG_2);
185 ufshcd_writel(hba, uic_cmd->argument3, REG_UIC_COMMAND_ARG_3);
188 ufshcd_writel(hba, uic_cmd->command & COMMAND_OPCODE_MASK,
191 start = get_timer(0);
193 intr_status = ufshcd_readl(hba, REG_INTERRUPT_STATUS);
194 enabled_intr_status = intr_status & hba->intr_mask;
195 ufshcd_writel(hba, intr_status, REG_INTERRUPT_STATUS);
197 if (get_timer(start) > UFS_UIC_CMD_TIMEOUT) {
199 "Timedout waiting for UIC response\n");
204 if (enabled_intr_status & UFSHCD_ERROR_MASK) {
205 dev_err(hba->dev, "Error in status:%08x\n",
206 enabled_intr_status);
210 } while (!(enabled_intr_status & UFSHCD_UIC_MASK));
212 uic_cmd->argument2 = ufshcd_get_uic_cmd_result(hba);
213 uic_cmd->argument3 = ufshcd_get_dme_attr_val(hba);
215 debug("Sent successfully\n");
221 * ufshcd_dme_set_attr - UIC command for DME_SET, DME_PEER_SET
224 int ufshcd_dme_set_attr(struct ufs_hba *hba, u32 attr_sel, u8 attr_set,
225 u32 mib_val, u8 peer)
227 struct uic_command uic_cmd = {0};
228 static const char *const action[] = {
232 const char *set = action[!!peer];
234 int retries = UFS_UIC_COMMAND_RETRIES;
236 uic_cmd.command = peer ?
237 UIC_CMD_DME_PEER_SET : UIC_CMD_DME_SET;
238 uic_cmd.argument1 = attr_sel;
239 uic_cmd.argument2 = UIC_ARG_ATTR_TYPE(attr_set);
240 uic_cmd.argument3 = mib_val;
243 /* for peer attributes we retry upon failure */
244 ret = ufshcd_send_uic_cmd(hba, &uic_cmd);
246 dev_dbg(hba->dev, "%s: attr-id 0x%x val 0x%x error code %d\n",
247 set, UIC_GET_ATTR_ID(attr_sel), mib_val, ret);
248 } while (ret && peer && --retries);
251 dev_err(hba->dev, "%s: attr-id 0x%x val 0x%x failed %d retries\n",
252 set, UIC_GET_ATTR_ID(attr_sel), mib_val,
253 UFS_UIC_COMMAND_RETRIES - retries);
259 * ufshcd_dme_get_attr - UIC command for DME_GET, DME_PEER_GET
262 int ufshcd_dme_get_attr(struct ufs_hba *hba, u32 attr_sel,
263 u32 *mib_val, u8 peer)
265 struct uic_command uic_cmd = {0};
266 static const char *const action[] = {
270 const char *get = action[!!peer];
272 int retries = UFS_UIC_COMMAND_RETRIES;
274 uic_cmd.command = peer ?
275 UIC_CMD_DME_PEER_GET : UIC_CMD_DME_GET;
276 uic_cmd.argument1 = attr_sel;
279 /* for peer attributes we retry upon failure */
280 ret = ufshcd_send_uic_cmd(hba, &uic_cmd);
282 dev_dbg(hba->dev, "%s: attr-id 0x%x error code %d\n",
283 get, UIC_GET_ATTR_ID(attr_sel), ret);
284 } while (ret && peer && --retries);
287 dev_err(hba->dev, "%s: attr-id 0x%x failed %d retries\n",
288 get, UIC_GET_ATTR_ID(attr_sel),
289 UFS_UIC_COMMAND_RETRIES - retries);
292 *mib_val = uic_cmd.argument3;
297 static int ufshcd_disable_tx_lcc(struct ufs_hba *hba, bool peer)
299 u32 tx_lanes, i, err = 0;
302 ufshcd_dme_get(hba, UIC_ARG_MIB(PA_CONNECTEDTXDATALANES),
305 ufshcd_dme_peer_get(hba, UIC_ARG_MIB(PA_CONNECTEDTXDATALANES),
307 for (i = 0; i < tx_lanes; i++) {
309 err = ufshcd_dme_set(hba,
310 UIC_ARG_MIB_SEL(TX_LCC_ENABLE,
311 UIC_ARG_MPHY_TX_GEN_SEL_INDEX(i)),
314 err = ufshcd_dme_peer_set(hba,
315 UIC_ARG_MIB_SEL(TX_LCC_ENABLE,
316 UIC_ARG_MPHY_TX_GEN_SEL_INDEX(i)),
319 dev_err(hba->dev, "%s: TX LCC Disable failed, peer = %d, lane = %d, err = %d",
320 __func__, peer, i, err);
328 static inline int ufshcd_disable_device_tx_lcc(struct ufs_hba *hba)
330 return ufshcd_disable_tx_lcc(hba, true);
334 * ufshcd_dme_link_startup - Notify Unipro to perform link startup
337 static int ufshcd_dme_link_startup(struct ufs_hba *hba)
339 struct uic_command uic_cmd = {0};
342 uic_cmd.command = UIC_CMD_DME_LINK_STARTUP;
344 ret = ufshcd_send_uic_cmd(hba, &uic_cmd);
347 "dme-link-startup: error code %d\n", ret);
352 * ufshcd_disable_intr_aggr - Disables interrupt aggregation.
355 static inline void ufshcd_disable_intr_aggr(struct ufs_hba *hba)
357 ufshcd_writel(hba, 0, REG_UTP_TRANSFER_REQ_INT_AGG_CONTROL);
361 * ufshcd_get_lists_status - Check UCRDY, UTRLRDY and UTMRLRDY
363 static inline int ufshcd_get_lists_status(u32 reg)
365 return !((reg & UFSHCD_STATUS_READY) == UFSHCD_STATUS_READY);
369 * ufshcd_enable_run_stop_reg - Enable run-stop registers,
370 * When run-stop registers are set to 1, it indicates the
371 * host controller that it can process the requests
373 static void ufshcd_enable_run_stop_reg(struct ufs_hba *hba)
375 ufshcd_writel(hba, UTP_TASK_REQ_LIST_RUN_STOP_BIT,
376 REG_UTP_TASK_REQ_LIST_RUN_STOP);
377 ufshcd_writel(hba, UTP_TRANSFER_REQ_LIST_RUN_STOP_BIT,
378 REG_UTP_TRANSFER_REQ_LIST_RUN_STOP);
382 * ufshcd_enable_intr - enable interrupts
384 static void ufshcd_enable_intr(struct ufs_hba *hba, u32 intrs)
386 u32 set = ufshcd_readl(hba, REG_INTERRUPT_ENABLE);
389 if (hba->version == UFSHCI_VERSION_10) {
390 rw = set & INTERRUPT_MASK_RW_VER_10;
391 set = rw | ((set ^ intrs) & intrs);
396 ufshcd_writel(hba, set, REG_INTERRUPT_ENABLE);
398 hba->intr_mask = set;
402 * ufshcd_make_hba_operational - Make UFS controller operational
404 * To bring UFS host controller to operational state,
405 * 1. Enable required interrupts
406 * 2. Configure interrupt aggregation
407 * 3. Program UTRL and UTMRL base address
408 * 4. Configure run-stop-registers
411 static int ufshcd_make_hba_operational(struct ufs_hba *hba)
416 /* Enable required interrupts */
417 ufshcd_enable_intr(hba, UFSHCD_ENABLE_INTRS);
419 /* Disable interrupt aggregation */
420 ufshcd_disable_intr_aggr(hba);
422 /* Configure UTRL and UTMRL base address registers */
423 ufshcd_writel(hba, lower_32_bits((dma_addr_t)hba->utrdl),
424 REG_UTP_TRANSFER_REQ_LIST_BASE_L);
425 ufshcd_writel(hba, upper_32_bits((dma_addr_t)hba->utrdl),
426 REG_UTP_TRANSFER_REQ_LIST_BASE_H);
427 ufshcd_writel(hba, lower_32_bits((dma_addr_t)hba->utmrdl),
428 REG_UTP_TASK_REQ_LIST_BASE_L);
429 ufshcd_writel(hba, upper_32_bits((dma_addr_t)hba->utmrdl),
430 REG_UTP_TASK_REQ_LIST_BASE_H);
433 * UCRDY, UTMRLDY and UTRLRDY bits must be 1
435 reg = ufshcd_readl(hba, REG_CONTROLLER_STATUS);
436 if (!(ufshcd_get_lists_status(reg))) {
437 ufshcd_enable_run_stop_reg(hba);
440 "Host controller not ready to process requests");
450 * ufshcd_link_startup - Initialize unipro link startup
452 static int ufshcd_link_startup(struct ufs_hba *hba)
455 int retries = DME_LINKSTARTUP_RETRIES;
456 bool link_startup_again = true;
460 ufshcd_ops_link_startup_notify(hba, PRE_CHANGE);
462 ret = ufshcd_dme_link_startup(hba);
464 /* check if device is detected by inter-connect layer */
465 if (!ret && !ufshcd_is_device_present(hba)) {
466 dev_err(hba->dev, "%s: Device not present\n", __func__);
472 * DME link lost indication is only received when link is up,
473 * but we can't be sure if the link is up until link startup
474 * succeeds. So reset the local Uni-Pro and try again.
476 if (ret && ufshcd_hba_enable(hba))
478 } while (ret && retries--);
481 /* failed to get the link up... retire */
484 if (link_startup_again) {
485 link_startup_again = false;
486 retries = DME_LINKSTARTUP_RETRIES;
490 /* Mark that link is up in PWM-G1, 1-lane, SLOW-AUTO mode */
491 ufshcd_init_pwr_info(hba);
493 if (hba->quirks & UFSHCD_QUIRK_BROKEN_LCC) {
494 ret = ufshcd_disable_device_tx_lcc(hba);
499 /* Include any host controller configuration via UIC commands */
500 ret = ufshcd_ops_link_startup_notify(hba, POST_CHANGE);
504 ret = ufshcd_make_hba_operational(hba);
507 dev_err(hba->dev, "link startup failed %d\n", ret);
513 * ufshcd_hba_stop - Send controller to reset state
515 static inline void ufshcd_hba_stop(struct ufs_hba *hba)
519 ufshcd_writel(hba, CONTROLLER_DISABLE, REG_CONTROLLER_ENABLE);
520 err = ufshcd_wait_for_register(hba, REG_CONTROLLER_ENABLE,
521 CONTROLLER_ENABLE, CONTROLLER_DISABLE,
524 dev_err(hba->dev, "%s: Controller disable failed\n", __func__);
528 * ufshcd_is_hba_active - Get controller state
530 static inline bool ufshcd_is_hba_active(struct ufs_hba *hba)
532 return (ufshcd_readl(hba, REG_CONTROLLER_ENABLE) & CONTROLLER_ENABLE)
537 * ufshcd_hba_start - Start controller initialization sequence
539 static inline void ufshcd_hba_start(struct ufs_hba *hba)
541 ufshcd_writel(hba, CONTROLLER_ENABLE, REG_CONTROLLER_ENABLE);
545 * ufshcd_hba_enable - initialize the controller
547 static int ufshcd_hba_enable(struct ufs_hba *hba)
551 if (!ufshcd_is_hba_active(hba))
552 /* change controller state to "reset state" */
553 ufshcd_hba_stop(hba);
555 ufshcd_ops_hce_enable_notify(hba, PRE_CHANGE);
557 /* start controller initialization sequence */
558 ufshcd_hba_start(hba);
561 * To initialize a UFS host controller HCE bit must be set to 1.
562 * During initialization the HCE bit value changes from 1->0->1.
563 * When the host controller completes initialization sequence
564 * it sets the value of HCE bit to 1. The same HCE bit is read back
565 * to check if the controller has completed initialization sequence.
566 * So without this delay the value HCE = 1, set in the previous
567 * instruction might be read back.
568 * This delay can be changed based on the controller.
572 /* wait for the host controller to complete initialization */
574 while (ufshcd_is_hba_active(hba)) {
578 dev_err(hba->dev, "Controller enable failed\n");
584 /* enable UIC related interrupts */
585 ufshcd_enable_intr(hba, UFSHCD_UIC_MASK);
587 ufshcd_ops_hce_enable_notify(hba, POST_CHANGE);
593 * ufshcd_host_memory_configure - configure local reference block with
596 static void ufshcd_host_memory_configure(struct ufs_hba *hba)
598 struct utp_transfer_req_desc *utrdlp;
599 dma_addr_t cmd_desc_dma_addr;
604 cmd_desc_dma_addr = (dma_addr_t)hba->ucdl;
606 utrdlp->command_desc_base_addr_lo =
607 cpu_to_le32(lower_32_bits(cmd_desc_dma_addr));
608 utrdlp->command_desc_base_addr_hi =
609 cpu_to_le32(upper_32_bits(cmd_desc_dma_addr));
611 response_offset = offsetof(struct utp_transfer_cmd_desc, response_upiu);
612 prdt_offset = offsetof(struct utp_transfer_cmd_desc, prd_table);
614 utrdlp->response_upiu_offset = cpu_to_le16(response_offset >> 2);
615 utrdlp->prd_table_offset = cpu_to_le16(prdt_offset >> 2);
616 utrdlp->response_upiu_length = cpu_to_le16(ALIGNED_UPIU_SIZE >> 2);
618 hba->ucd_req_ptr = (struct utp_upiu_req *)hba->ucdl;
620 (struct utp_upiu_rsp *)&hba->ucdl->response_upiu;
622 (struct ufshcd_sg_entry *)&hba->ucdl->prd_table;
626 * ufshcd_memory_alloc - allocate memory for host memory space data structures
628 static int ufshcd_memory_alloc(struct ufs_hba *hba)
630 /* Allocate one Transfer Request Descriptor
631 * Should be aligned to 1k boundary.
633 hba->utrdl = memalign(1024, sizeof(struct utp_transfer_req_desc));
635 dev_err(hba->dev, "Transfer Descriptor memory allocation failed\n");
639 /* Allocate one Command Descriptor
640 * Should be aligned to 1k boundary.
642 hba->ucdl = memalign(1024, sizeof(struct utp_transfer_cmd_desc));
644 dev_err(hba->dev, "Command descriptor memory allocation failed\n");
652 * ufshcd_get_intr_mask - Get the interrupt bit mask
654 static inline u32 ufshcd_get_intr_mask(struct ufs_hba *hba)
658 switch (hba->version) {
659 case UFSHCI_VERSION_10:
660 intr_mask = INTERRUPT_MASK_ALL_VER_10;
662 case UFSHCI_VERSION_11:
663 case UFSHCI_VERSION_20:
664 intr_mask = INTERRUPT_MASK_ALL_VER_11;
666 case UFSHCI_VERSION_21:
668 intr_mask = INTERRUPT_MASK_ALL_VER_21;
676 * ufshcd_get_ufs_version - Get the UFS version supported by the HBA
678 static inline u32 ufshcd_get_ufs_version(struct ufs_hba *hba)
680 return ufshcd_readl(hba, REG_UFS_VERSION);
684 * ufshcd_get_upmcrs - Get the power mode change request status
686 static inline u8 ufshcd_get_upmcrs(struct ufs_hba *hba)
688 return (ufshcd_readl(hba, REG_CONTROLLER_STATUS) >> 8) & 0x7;
692 * ufshcd_prepare_req_desc_hdr() - Fills the requests header
693 * descriptor according to request
695 static void ufshcd_prepare_req_desc_hdr(struct utp_transfer_req_desc *req_desc,
697 enum dma_data_direction cmd_dir)
702 if (cmd_dir == DMA_FROM_DEVICE) {
703 data_direction = UTP_DEVICE_TO_HOST;
704 *upiu_flags = UPIU_CMD_FLAGS_READ;
705 } else if (cmd_dir == DMA_TO_DEVICE) {
706 data_direction = UTP_HOST_TO_DEVICE;
707 *upiu_flags = UPIU_CMD_FLAGS_WRITE;
709 data_direction = UTP_NO_DATA_TRANSFER;
710 *upiu_flags = UPIU_CMD_FLAGS_NONE;
713 dword_0 = data_direction | (0x1 << UPIU_COMMAND_TYPE_OFFSET);
715 /* Enable Interrupt for command */
716 dword_0 |= UTP_REQ_DESC_INT_CMD;
718 /* Transfer request descriptor header fields */
719 req_desc->header.dword_0 = cpu_to_le32(dword_0);
720 /* dword_1 is reserved, hence it is set to 0 */
721 req_desc->header.dword_1 = 0;
723 * assigning invalid value for command status. Controller
724 * updates OCS on command completion, with the command
727 req_desc->header.dword_2 =
728 cpu_to_le32(OCS_INVALID_COMMAND_STATUS);
729 /* dword_3 is reserved, hence it is set to 0 */
730 req_desc->header.dword_3 = 0;
732 req_desc->prd_table_length = 0;
735 static void ufshcd_prepare_utp_query_req_upiu(struct ufs_hba *hba,
738 struct utp_upiu_req *ucd_req_ptr = hba->ucd_req_ptr;
739 struct ufs_query *query = &hba->dev_cmd.query;
740 u16 len = be16_to_cpu(query->request.upiu_req.length);
742 /* Query request header */
743 ucd_req_ptr->header.dword_0 =
744 UPIU_HEADER_DWORD(UPIU_TRANSACTION_QUERY_REQ,
745 upiu_flags, 0, TASK_TAG);
746 ucd_req_ptr->header.dword_1 =
747 UPIU_HEADER_DWORD(0, query->request.query_func,
750 /* Data segment length only need for WRITE_DESC */
751 if (query->request.upiu_req.opcode == UPIU_QUERY_OPCODE_WRITE_DESC)
752 ucd_req_ptr->header.dword_2 =
753 UPIU_HEADER_DWORD(0, 0, (len >> 8), (u8)len);
755 ucd_req_ptr->header.dword_2 = 0;
757 /* Copy the Query Request buffer as is */
758 memcpy(&ucd_req_ptr->qr, &query->request.upiu_req, QUERY_OSF_SIZE);
760 /* Copy the Descriptor */
761 if (query->request.upiu_req.opcode == UPIU_QUERY_OPCODE_WRITE_DESC)
762 memcpy(ucd_req_ptr + 1, query->descriptor, len);
764 memset(hba->ucd_rsp_ptr, 0, sizeof(struct utp_upiu_rsp));
767 static inline void ufshcd_prepare_utp_nop_upiu(struct ufs_hba *hba)
769 struct utp_upiu_req *ucd_req_ptr = hba->ucd_req_ptr;
771 memset(ucd_req_ptr, 0, sizeof(struct utp_upiu_req));
773 /* command descriptor fields */
774 ucd_req_ptr->header.dword_0 =
775 UPIU_HEADER_DWORD(UPIU_TRANSACTION_NOP_OUT, 0, 0, 0x1f);
776 /* clear rest of the fields of basic header */
777 ucd_req_ptr->header.dword_1 = 0;
778 ucd_req_ptr->header.dword_2 = 0;
780 memset(hba->ucd_rsp_ptr, 0, sizeof(struct utp_upiu_rsp));
784 * ufshcd_comp_devman_upiu - UFS Protocol Information Unit(UPIU)
785 * for Device Management Purposes
787 static int ufshcd_comp_devman_upiu(struct ufs_hba *hba,
788 enum dev_cmd_type cmd_type)
792 struct utp_transfer_req_desc *req_desc = hba->utrdl;
794 hba->dev_cmd.type = cmd_type;
796 ufshcd_prepare_req_desc_hdr(req_desc, &upiu_flags, DMA_NONE);
798 case DEV_CMD_TYPE_QUERY:
799 ufshcd_prepare_utp_query_req_upiu(hba, upiu_flags);
801 case DEV_CMD_TYPE_NOP:
802 ufshcd_prepare_utp_nop_upiu(hba);
811 static int ufshcd_send_command(struct ufs_hba *hba, unsigned int task_tag)
815 u32 enabled_intr_status;
817 ufshcd_writel(hba, 1 << task_tag, REG_UTP_TRANSFER_REQ_DOOR_BELL);
819 start = get_timer(0);
821 intr_status = ufshcd_readl(hba, REG_INTERRUPT_STATUS);
822 enabled_intr_status = intr_status & hba->intr_mask;
823 ufshcd_writel(hba, intr_status, REG_INTERRUPT_STATUS);
825 if (get_timer(start) > QUERY_REQ_TIMEOUT) {
827 "Timedout waiting for UTP response\n");
832 if (enabled_intr_status & UFSHCD_ERROR_MASK) {
833 dev_err(hba->dev, "Error in status:%08x\n",
834 enabled_intr_status);
838 } while (!(enabled_intr_status & UTP_TRANSFER_REQ_COMPL));
844 * ufshcd_get_req_rsp - returns the TR response transaction type
846 static inline int ufshcd_get_req_rsp(struct utp_upiu_rsp *ucd_rsp_ptr)
848 return be32_to_cpu(ucd_rsp_ptr->header.dword_0) >> 24;
852 * ufshcd_get_tr_ocs - Get the UTRD Overall Command Status
855 static inline int ufshcd_get_tr_ocs(struct ufs_hba *hba)
857 return le32_to_cpu(hba->utrdl->header.dword_2) & MASK_OCS;
860 static inline int ufshcd_get_rsp_upiu_result(struct utp_upiu_rsp *ucd_rsp_ptr)
862 return be32_to_cpu(ucd_rsp_ptr->header.dword_1) & MASK_RSP_UPIU_RESULT;
865 static int ufshcd_check_query_response(struct ufs_hba *hba)
867 struct ufs_query_res *query_res = &hba->dev_cmd.query.response;
869 /* Get the UPIU response */
870 query_res->response = ufshcd_get_rsp_upiu_result(hba->ucd_rsp_ptr) >>
871 UPIU_RSP_CODE_OFFSET;
872 return query_res->response;
876 * ufshcd_copy_query_response() - Copy the Query Response and the data
879 static int ufshcd_copy_query_response(struct ufs_hba *hba)
881 struct ufs_query_res *query_res = &hba->dev_cmd.query.response;
883 memcpy(&query_res->upiu_res, &hba->ucd_rsp_ptr->qr, QUERY_OSF_SIZE);
885 /* Get the descriptor */
886 if (hba->dev_cmd.query.descriptor &&
887 hba->ucd_rsp_ptr->qr.opcode == UPIU_QUERY_OPCODE_READ_DESC) {
888 u8 *descp = (u8 *)hba->ucd_rsp_ptr +
889 GENERAL_UPIU_REQUEST_SIZE;
893 /* data segment length */
894 resp_len = be32_to_cpu(hba->ucd_rsp_ptr->header.dword_2) &
895 MASK_QUERY_DATA_SEG_LEN;
897 be16_to_cpu(hba->dev_cmd.query.request.upiu_req.length);
898 if (likely(buf_len >= resp_len)) {
899 memcpy(hba->dev_cmd.query.descriptor, descp, resp_len);
902 "%s: Response size is bigger than buffer",
912 * ufshcd_exec_dev_cmd - API for sending device management requests
914 static int ufshcd_exec_dev_cmd(struct ufs_hba *hba, enum dev_cmd_type cmd_type,
920 err = ufshcd_comp_devman_upiu(hba, cmd_type);
924 err = ufshcd_send_command(hba, TASK_TAG);
928 err = ufshcd_get_tr_ocs(hba);
930 dev_err(hba->dev, "Error in OCS:%d\n", err);
934 resp = ufshcd_get_req_rsp(hba->ucd_rsp_ptr);
936 case UPIU_TRANSACTION_NOP_IN:
938 case UPIU_TRANSACTION_QUERY_RSP:
939 err = ufshcd_check_query_response(hba);
941 err = ufshcd_copy_query_response(hba);
943 case UPIU_TRANSACTION_REJECT_UPIU:
944 /* TODO: handle Reject UPIU Response */
946 dev_err(hba->dev, "%s: Reject UPIU not fully implemented\n",
951 dev_err(hba->dev, "%s: Invalid device management cmd response: %x\n",
959 * ufshcd_init_query() - init the query response and request parameters
961 static inline void ufshcd_init_query(struct ufs_hba *hba,
962 struct ufs_query_req **request,
963 struct ufs_query_res **response,
964 enum query_opcode opcode,
965 u8 idn, u8 index, u8 selector)
967 *request = &hba->dev_cmd.query.request;
968 *response = &hba->dev_cmd.query.response;
969 memset(*request, 0, sizeof(struct ufs_query_req));
970 memset(*response, 0, sizeof(struct ufs_query_res));
971 (*request)->upiu_req.opcode = opcode;
972 (*request)->upiu_req.idn = idn;
973 (*request)->upiu_req.index = index;
974 (*request)->upiu_req.selector = selector;
978 * ufshcd_query_flag() - API function for sending flag query requests
980 int ufshcd_query_flag(struct ufs_hba *hba, enum query_opcode opcode,
981 enum flag_idn idn, bool *flag_res)
983 struct ufs_query_req *request = NULL;
984 struct ufs_query_res *response = NULL;
985 int err, index = 0, selector = 0;
986 int timeout = QUERY_REQ_TIMEOUT;
988 ufshcd_init_query(hba, &request, &response, opcode, idn, index,
992 case UPIU_QUERY_OPCODE_SET_FLAG:
993 case UPIU_QUERY_OPCODE_CLEAR_FLAG:
994 case UPIU_QUERY_OPCODE_TOGGLE_FLAG:
995 request->query_func = UPIU_QUERY_FUNC_STANDARD_WRITE_REQUEST;
997 case UPIU_QUERY_OPCODE_READ_FLAG:
998 request->query_func = UPIU_QUERY_FUNC_STANDARD_READ_REQUEST;
1000 /* No dummy reads */
1001 dev_err(hba->dev, "%s: Invalid argument for read request\n",
1009 "%s: Expected query flag opcode but got = %d\n",
1015 err = ufshcd_exec_dev_cmd(hba, DEV_CMD_TYPE_QUERY, timeout);
1019 "%s: Sending flag query for idn %d failed, err = %d\n",
1020 __func__, idn, err);
1025 *flag_res = (be32_to_cpu(response->upiu_res.value) &
1026 MASK_QUERY_UPIU_FLAG_LOC) & 0x1;
1032 static int ufshcd_query_flag_retry(struct ufs_hba *hba,
1033 enum query_opcode opcode,
1034 enum flag_idn idn, bool *flag_res)
1039 for (retries = 0; retries < QUERY_REQ_RETRIES; retries++) {
1040 ret = ufshcd_query_flag(hba, opcode, idn, flag_res);
1043 "%s: failed with error %d, retries %d\n",
1044 __func__, ret, retries);
1051 "%s: query attribute, opcode %d, idn %d, failed with error %d after %d retires\n",
1052 __func__, opcode, idn, ret, retries);
1056 static int __ufshcd_query_descriptor(struct ufs_hba *hba,
1057 enum query_opcode opcode,
1058 enum desc_idn idn, u8 index, u8 selector,
1059 u8 *desc_buf, int *buf_len)
1061 struct ufs_query_req *request = NULL;
1062 struct ufs_query_res *response = NULL;
1066 dev_err(hba->dev, "%s: descriptor buffer required for opcode 0x%x\n",
1072 if (*buf_len < QUERY_DESC_MIN_SIZE || *buf_len > QUERY_DESC_MAX_SIZE) {
1073 dev_err(hba->dev, "%s: descriptor buffer size (%d) is out of range\n",
1074 __func__, *buf_len);
1079 ufshcd_init_query(hba, &request, &response, opcode, idn, index,
1081 hba->dev_cmd.query.descriptor = desc_buf;
1082 request->upiu_req.length = cpu_to_be16(*buf_len);
1085 case UPIU_QUERY_OPCODE_WRITE_DESC:
1086 request->query_func = UPIU_QUERY_FUNC_STANDARD_WRITE_REQUEST;
1088 case UPIU_QUERY_OPCODE_READ_DESC:
1089 request->query_func = UPIU_QUERY_FUNC_STANDARD_READ_REQUEST;
1092 dev_err(hba->dev, "%s: Expected query descriptor opcode but got = 0x%.2x\n",
1098 err = ufshcd_exec_dev_cmd(hba, DEV_CMD_TYPE_QUERY, QUERY_REQ_TIMEOUT);
1101 dev_err(hba->dev, "%s: opcode 0x%.2x for idn %d failed, index %d, err = %d\n",
1102 __func__, opcode, idn, index, err);
1106 hba->dev_cmd.query.descriptor = NULL;
1107 *buf_len = be16_to_cpu(response->upiu_res.length);
1114 * ufshcd_query_descriptor_retry - API function for sending descriptor requests
1116 int ufshcd_query_descriptor_retry(struct ufs_hba *hba, enum query_opcode opcode,
1117 enum desc_idn idn, u8 index, u8 selector,
1118 u8 *desc_buf, int *buf_len)
1123 for (retries = QUERY_REQ_RETRIES; retries > 0; retries--) {
1124 err = __ufshcd_query_descriptor(hba, opcode, idn, index,
1125 selector, desc_buf, buf_len);
1126 if (!err || err == -EINVAL)
1134 * ufshcd_read_desc_length - read the specified descriptor length from header
1136 static int ufshcd_read_desc_length(struct ufs_hba *hba, enum desc_idn desc_id,
1137 int desc_index, int *desc_length)
1140 u8 header[QUERY_DESC_HDR_SIZE];
1141 int header_len = QUERY_DESC_HDR_SIZE;
1143 if (desc_id >= QUERY_DESC_IDN_MAX)
1146 ret = ufshcd_query_descriptor_retry(hba, UPIU_QUERY_OPCODE_READ_DESC,
1147 desc_id, desc_index, 0, header,
1151 dev_err(hba->dev, "%s: Failed to get descriptor header id %d",
1154 } else if (desc_id != header[QUERY_DESC_DESC_TYPE_OFFSET]) {
1155 dev_warn(hba->dev, "%s: descriptor header id %d and desc_id %d mismatch",
1156 __func__, header[QUERY_DESC_DESC_TYPE_OFFSET],
1161 *desc_length = header[QUERY_DESC_LENGTH_OFFSET];
1166 static void ufshcd_init_desc_sizes(struct ufs_hba *hba)
1170 err = ufshcd_read_desc_length(hba, QUERY_DESC_IDN_DEVICE, 0,
1171 &hba->desc_size.dev_desc);
1173 hba->desc_size.dev_desc = QUERY_DESC_DEVICE_DEF_SIZE;
1175 err = ufshcd_read_desc_length(hba, QUERY_DESC_IDN_POWER, 0,
1176 &hba->desc_size.pwr_desc);
1178 hba->desc_size.pwr_desc = QUERY_DESC_POWER_DEF_SIZE;
1180 err = ufshcd_read_desc_length(hba, QUERY_DESC_IDN_INTERCONNECT, 0,
1181 &hba->desc_size.interc_desc);
1183 hba->desc_size.interc_desc = QUERY_DESC_INTERCONNECT_DEF_SIZE;
1185 err = ufshcd_read_desc_length(hba, QUERY_DESC_IDN_CONFIGURATION, 0,
1186 &hba->desc_size.conf_desc);
1188 hba->desc_size.conf_desc = QUERY_DESC_CONFIGURATION_DEF_SIZE;
1190 err = ufshcd_read_desc_length(hba, QUERY_DESC_IDN_UNIT, 0,
1191 &hba->desc_size.unit_desc);
1193 hba->desc_size.unit_desc = QUERY_DESC_UNIT_DEF_SIZE;
1195 err = ufshcd_read_desc_length(hba, QUERY_DESC_IDN_GEOMETRY, 0,
1196 &hba->desc_size.geom_desc);
1198 hba->desc_size.geom_desc = QUERY_DESC_GEOMETRY_DEF_SIZE;
1200 err = ufshcd_read_desc_length(hba, QUERY_DESC_IDN_HEALTH, 0,
1201 &hba->desc_size.hlth_desc);
1203 hba->desc_size.hlth_desc = QUERY_DESC_HEALTH_DEF_SIZE;
1207 * ufshcd_map_desc_id_to_length - map descriptor IDN to its length
1210 int ufshcd_map_desc_id_to_length(struct ufs_hba *hba, enum desc_idn desc_id,
1214 case QUERY_DESC_IDN_DEVICE:
1215 *desc_len = hba->desc_size.dev_desc;
1217 case QUERY_DESC_IDN_POWER:
1218 *desc_len = hba->desc_size.pwr_desc;
1220 case QUERY_DESC_IDN_GEOMETRY:
1221 *desc_len = hba->desc_size.geom_desc;
1223 case QUERY_DESC_IDN_CONFIGURATION:
1224 *desc_len = hba->desc_size.conf_desc;
1226 case QUERY_DESC_IDN_UNIT:
1227 *desc_len = hba->desc_size.unit_desc;
1229 case QUERY_DESC_IDN_INTERCONNECT:
1230 *desc_len = hba->desc_size.interc_desc;
1232 case QUERY_DESC_IDN_STRING:
1233 *desc_len = QUERY_DESC_MAX_SIZE;
1235 case QUERY_DESC_IDN_HEALTH:
1236 *desc_len = hba->desc_size.hlth_desc;
1238 case QUERY_DESC_IDN_RFU_0:
1239 case QUERY_DESC_IDN_RFU_1:
1248 EXPORT_SYMBOL(ufshcd_map_desc_id_to_length);
1251 * ufshcd_read_desc_param - read the specified descriptor parameter
1254 int ufshcd_read_desc_param(struct ufs_hba *hba, enum desc_idn desc_id,
1255 int desc_index, u8 param_offset, u8 *param_read_buf,
1261 bool is_kmalloc = true;
1264 if (desc_id >= QUERY_DESC_IDN_MAX || !param_size)
1267 /* Get the max length of descriptor from structure filled up at probe
1270 ret = ufshcd_map_desc_id_to_length(hba, desc_id, &buff_len);
1273 if (ret || !buff_len) {
1274 dev_err(hba->dev, "%s: Failed to get full descriptor length",
1279 /* Check whether we need temp memory */
1280 if (param_offset != 0 || param_size < buff_len) {
1281 desc_buf = kmalloc(buff_len, GFP_KERNEL);
1285 desc_buf = param_read_buf;
1289 /* Request for full descriptor */
1290 ret = ufshcd_query_descriptor_retry(hba, UPIU_QUERY_OPCODE_READ_DESC,
1291 desc_id, desc_index, 0, desc_buf,
1295 dev_err(hba->dev, "%s: Failed reading descriptor. desc_id %d, desc_index %d, param_offset %d, ret %d",
1296 __func__, desc_id, desc_index, param_offset, ret);
1301 if (desc_buf[QUERY_DESC_DESC_TYPE_OFFSET] != desc_id) {
1302 dev_err(hba->dev, "%s: invalid desc_id %d in descriptor header",
1303 __func__, desc_buf[QUERY_DESC_DESC_TYPE_OFFSET]);
1308 /* Check wherher we will not copy more data, than available */
1309 if (is_kmalloc && param_size > buff_len)
1310 param_size = buff_len;
1313 memcpy(param_read_buf, &desc_buf[param_offset], param_size);
1320 /* replace non-printable or non-ASCII characters with spaces */
1321 static inline void ufshcd_remove_non_printable(uint8_t *val)
1326 if (*val < 0x20 || *val > 0x7e)
1331 * ufshcd_uic_pwr_ctrl - executes UIC commands (which affects the link power
1332 * state) and waits for it to take effect.
1335 static int ufshcd_uic_pwr_ctrl(struct ufs_hba *hba, struct uic_command *cmd)
1337 unsigned long start = 0;
1341 ret = ufshcd_send_uic_cmd(hba, cmd);
1344 "pwr ctrl cmd 0x%x with mode 0x%x uic error %d\n",
1345 cmd->command, cmd->argument3, ret);
1350 start = get_timer(0);
1352 status = ufshcd_get_upmcrs(hba);
1353 if (get_timer(start) > UFS_UIC_CMD_TIMEOUT) {
1355 "pwr ctrl cmd 0x%x failed, host upmcrs:0x%x\n",
1356 cmd->command, status);
1357 ret = (status != PWR_OK) ? status : -1;
1360 } while (status != PWR_LOCAL);
1366 * ufshcd_uic_change_pwr_mode - Perform the UIC power mode change
1367 * using DME_SET primitives.
1369 static int ufshcd_uic_change_pwr_mode(struct ufs_hba *hba, u8 mode)
1371 struct uic_command uic_cmd = {0};
1374 uic_cmd.command = UIC_CMD_DME_SET;
1375 uic_cmd.argument1 = UIC_ARG_MIB(PA_PWRMODE);
1376 uic_cmd.argument3 = mode;
1377 ret = ufshcd_uic_pwr_ctrl(hba, &uic_cmd);
1383 void ufshcd_prepare_utp_scsi_cmd_upiu(struct ufs_hba *hba,
1384 struct scsi_cmd *pccb, u32 upiu_flags)
1386 struct utp_upiu_req *ucd_req_ptr = hba->ucd_req_ptr;
1387 unsigned int cdb_len;
1389 /* command descriptor fields */
1390 ucd_req_ptr->header.dword_0 =
1391 UPIU_HEADER_DWORD(UPIU_TRANSACTION_COMMAND, upiu_flags,
1392 pccb->lun, TASK_TAG);
1393 ucd_req_ptr->header.dword_1 =
1394 UPIU_HEADER_DWORD(UPIU_COMMAND_SET_TYPE_SCSI, 0, 0, 0);
1396 /* Total EHS length and Data segment length will be zero */
1397 ucd_req_ptr->header.dword_2 = 0;
1399 ucd_req_ptr->sc.exp_data_transfer_len = cpu_to_be32(pccb->datalen);
1401 cdb_len = min_t(unsigned short, pccb->cmdlen, UFS_CDB_SIZE);
1402 memset(ucd_req_ptr->sc.cdb, 0, UFS_CDB_SIZE);
1403 memcpy(ucd_req_ptr->sc.cdb, pccb->cmd, cdb_len);
1405 memset(hba->ucd_rsp_ptr, 0, sizeof(struct utp_upiu_rsp));
1408 static inline void prepare_prdt_desc(struct ufshcd_sg_entry *entry,
1409 unsigned char *buf, ulong len)
1411 entry->size = cpu_to_le32(len) | GENMASK(1, 0);
1412 entry->base_addr = cpu_to_le32(lower_32_bits((unsigned long)buf));
1413 entry->upper_addr = cpu_to_le32(upper_32_bits((unsigned long)buf));
1416 static void prepare_prdt_table(struct ufs_hba *hba, struct scsi_cmd *pccb)
1418 struct utp_transfer_req_desc *req_desc = hba->utrdl;
1419 struct ufshcd_sg_entry *prd_table = hba->ucd_prdt_ptr;
1420 ulong datalen = pccb->datalen;
1426 req_desc->prd_table_length = 0;
1430 table_length = DIV_ROUND_UP(pccb->datalen, MAX_PRDT_ENTRY);
1434 prepare_prdt_desc(&prd_table[table_length - i - 1], buf,
1435 MAX_PRDT_ENTRY - 1);
1436 buf += MAX_PRDT_ENTRY;
1437 datalen -= MAX_PRDT_ENTRY;
1440 prepare_prdt_desc(&prd_table[table_length - i - 1], buf, datalen - 1);
1442 req_desc->prd_table_length = table_length;
1445 static int ufs_scsi_exec(struct udevice *scsi_dev, struct scsi_cmd *pccb)
1447 struct ufs_hba *hba = dev_get_uclass_priv(scsi_dev->parent);
1448 struct utp_transfer_req_desc *req_desc = hba->utrdl;
1450 int ocs, result = 0;
1453 ufshcd_prepare_req_desc_hdr(req_desc, &upiu_flags, pccb->dma_dir);
1454 ufshcd_prepare_utp_scsi_cmd_upiu(hba, pccb, upiu_flags);
1455 prepare_prdt_table(hba, pccb);
1457 ufshcd_send_command(hba, TASK_TAG);
1459 ocs = ufshcd_get_tr_ocs(hba);
1462 result = ufshcd_get_req_rsp(hba->ucd_rsp_ptr);
1464 case UPIU_TRANSACTION_RESPONSE:
1465 result = ufshcd_get_rsp_upiu_result(hba->ucd_rsp_ptr);
1467 scsi_status = result & MASK_SCSI_STATUS;
1472 case UPIU_TRANSACTION_REJECT_UPIU:
1473 /* TODO: handle Reject UPIU Response */
1475 "Reject UPIU not fully implemented\n");
1479 "Unexpected request response code = %x\n",
1485 dev_err(hba->dev, "OCS error from controller = %x\n", ocs);
1492 static inline int ufshcd_read_desc(struct ufs_hba *hba, enum desc_idn desc_id,
1493 int desc_index, u8 *buf, u32 size)
1495 return ufshcd_read_desc_param(hba, desc_id, desc_index, 0, buf, size);
1498 static int ufshcd_read_device_desc(struct ufs_hba *hba, u8 *buf, u32 size)
1500 return ufshcd_read_desc(hba, QUERY_DESC_IDN_DEVICE, 0, buf, size);
1504 * ufshcd_read_string_desc - read string descriptor
1507 int ufshcd_read_string_desc(struct ufs_hba *hba, int desc_index,
1508 u8 *buf, u32 size, bool ascii)
1512 err = ufshcd_read_desc(hba, QUERY_DESC_IDN_STRING, desc_index, buf,
1516 dev_err(hba->dev, "%s: reading String Desc failed after %d retries. err = %d\n",
1517 __func__, QUERY_REQ_RETRIES, err);
1528 /* remove header and divide by 2 to move from UTF16 to UTF8 */
1529 ascii_len = (desc_len - QUERY_DESC_HDR_SIZE) / 2 + 1;
1530 if (size < ascii_len + QUERY_DESC_HDR_SIZE) {
1531 dev_err(hba->dev, "%s: buffer allocated size is too small\n",
1537 buff_ascii = kmalloc(ascii_len, GFP_KERNEL);
1544 * the descriptor contains string in UTF16 format
1545 * we need to convert to utf-8 so it can be displayed
1547 utf16_to_utf8(buff_ascii,
1548 (uint16_t *)&buf[QUERY_DESC_HDR_SIZE], ascii_len);
1550 /* replace non-printable or non-ASCII characters with spaces */
1551 for (i = 0; i < ascii_len; i++)
1552 ufshcd_remove_non_printable(&buff_ascii[i]);
1554 memset(buf + QUERY_DESC_HDR_SIZE, 0,
1555 size - QUERY_DESC_HDR_SIZE);
1556 memcpy(buf + QUERY_DESC_HDR_SIZE, buff_ascii, ascii_len);
1557 buf[QUERY_DESC_LENGTH_OFFSET] = ascii_len + QUERY_DESC_HDR_SIZE;
1564 static int ufs_get_device_desc(struct ufs_hba *hba,
1565 struct ufs_dev_desc *dev_desc)
1572 buff_len = max_t(size_t, hba->desc_size.dev_desc,
1573 QUERY_DESC_MAX_SIZE + 1);
1574 desc_buf = kmalloc(buff_len, GFP_KERNEL);
1580 err = ufshcd_read_device_desc(hba, desc_buf, hba->desc_size.dev_desc);
1582 dev_err(hba->dev, "%s: Failed reading Device Desc. err = %d\n",
1588 * getting vendor (manufacturerID) and Bank Index in big endian
1591 dev_desc->wmanufacturerid = desc_buf[DEVICE_DESC_PARAM_MANF_ID] << 8 |
1592 desc_buf[DEVICE_DESC_PARAM_MANF_ID + 1];
1594 model_index = desc_buf[DEVICE_DESC_PARAM_PRDCT_NAME];
1596 /* Zero-pad entire buffer for string termination. */
1597 memset(desc_buf, 0, buff_len);
1599 err = ufshcd_read_string_desc(hba, model_index, desc_buf,
1600 QUERY_DESC_MAX_SIZE, true/*ASCII*/);
1602 dev_err(hba->dev, "%s: Failed reading Product Name. err = %d\n",
1607 desc_buf[QUERY_DESC_MAX_SIZE] = '\0';
1608 strlcpy(dev_desc->model, (char *)(desc_buf + QUERY_DESC_HDR_SIZE),
1609 min_t(u8, desc_buf[QUERY_DESC_LENGTH_OFFSET],
1612 /* Null terminate the model string */
1613 dev_desc->model[MAX_MODEL_LEN] = '\0';
1621 * ufshcd_get_max_pwr_mode - reads the max power mode negotiated with device
1623 static int ufshcd_get_max_pwr_mode(struct ufs_hba *hba)
1625 struct ufs_pa_layer_attr *pwr_info = &hba->max_pwr_info.info;
1627 if (hba->max_pwr_info.is_valid)
1630 pwr_info->pwr_tx = FAST_MODE;
1631 pwr_info->pwr_rx = FAST_MODE;
1632 pwr_info->hs_rate = PA_HS_MODE_B;
1634 /* Get the connected lane count */
1635 ufshcd_dme_get(hba, UIC_ARG_MIB(PA_CONNECTEDRXDATALANES),
1636 &pwr_info->lane_rx);
1637 ufshcd_dme_get(hba, UIC_ARG_MIB(PA_CONNECTEDTXDATALANES),
1638 &pwr_info->lane_tx);
1640 if (!pwr_info->lane_rx || !pwr_info->lane_tx) {
1641 dev_err(hba->dev, "%s: invalid connected lanes value. rx=%d, tx=%d\n",
1642 __func__, pwr_info->lane_rx, pwr_info->lane_tx);
1647 * First, get the maximum gears of HS speed.
1648 * If a zero value, it means there is no HSGEAR capability.
1649 * Then, get the maximum gears of PWM speed.
1651 ufshcd_dme_get(hba, UIC_ARG_MIB(PA_MAXRXHSGEAR), &pwr_info->gear_rx);
1652 if (!pwr_info->gear_rx) {
1653 ufshcd_dme_get(hba, UIC_ARG_MIB(PA_MAXRXPWMGEAR),
1654 &pwr_info->gear_rx);
1655 if (!pwr_info->gear_rx) {
1656 dev_err(hba->dev, "%s: invalid max pwm rx gear read = %d\n",
1657 __func__, pwr_info->gear_rx);
1660 pwr_info->pwr_rx = SLOW_MODE;
1663 ufshcd_dme_peer_get(hba, UIC_ARG_MIB(PA_MAXRXHSGEAR),
1664 &pwr_info->gear_tx);
1665 if (!pwr_info->gear_tx) {
1666 ufshcd_dme_peer_get(hba, UIC_ARG_MIB(PA_MAXRXPWMGEAR),
1667 &pwr_info->gear_tx);
1668 if (!pwr_info->gear_tx) {
1669 dev_err(hba->dev, "%s: invalid max pwm tx gear read = %d\n",
1670 __func__, pwr_info->gear_tx);
1673 pwr_info->pwr_tx = SLOW_MODE;
1676 hba->max_pwr_info.is_valid = true;
1680 static int ufshcd_change_power_mode(struct ufs_hba *hba,
1681 struct ufs_pa_layer_attr *pwr_mode)
1685 /* if already configured to the requested pwr_mode */
1686 if (pwr_mode->gear_rx == hba->pwr_info.gear_rx &&
1687 pwr_mode->gear_tx == hba->pwr_info.gear_tx &&
1688 pwr_mode->lane_rx == hba->pwr_info.lane_rx &&
1689 pwr_mode->lane_tx == hba->pwr_info.lane_tx &&
1690 pwr_mode->pwr_rx == hba->pwr_info.pwr_rx &&
1691 pwr_mode->pwr_tx == hba->pwr_info.pwr_tx &&
1692 pwr_mode->hs_rate == hba->pwr_info.hs_rate) {
1693 dev_dbg(hba->dev, "%s: power already configured\n", __func__);
1698 * Configure attributes for power mode change with below.
1699 * - PA_RXGEAR, PA_ACTIVERXDATALANES, PA_RXTERMINATION,
1700 * - PA_TXGEAR, PA_ACTIVETXDATALANES, PA_TXTERMINATION,
1703 ufshcd_dme_set(hba, UIC_ARG_MIB(PA_RXGEAR), pwr_mode->gear_rx);
1704 ufshcd_dme_set(hba, UIC_ARG_MIB(PA_ACTIVERXDATALANES),
1706 if (pwr_mode->pwr_rx == FASTAUTO_MODE || pwr_mode->pwr_rx == FAST_MODE)
1707 ufshcd_dme_set(hba, UIC_ARG_MIB(PA_RXTERMINATION), TRUE);
1709 ufshcd_dme_set(hba, UIC_ARG_MIB(PA_RXTERMINATION), FALSE);
1711 ufshcd_dme_set(hba, UIC_ARG_MIB(PA_TXGEAR), pwr_mode->gear_tx);
1712 ufshcd_dme_set(hba, UIC_ARG_MIB(PA_ACTIVETXDATALANES),
1714 if (pwr_mode->pwr_tx == FASTAUTO_MODE || pwr_mode->pwr_tx == FAST_MODE)
1715 ufshcd_dme_set(hba, UIC_ARG_MIB(PA_TXTERMINATION), TRUE);
1717 ufshcd_dme_set(hba, UIC_ARG_MIB(PA_TXTERMINATION), FALSE);
1719 if (pwr_mode->pwr_rx == FASTAUTO_MODE ||
1720 pwr_mode->pwr_tx == FASTAUTO_MODE ||
1721 pwr_mode->pwr_rx == FAST_MODE ||
1722 pwr_mode->pwr_tx == FAST_MODE)
1723 ufshcd_dme_set(hba, UIC_ARG_MIB(PA_HSSERIES),
1726 ret = ufshcd_uic_change_pwr_mode(hba, pwr_mode->pwr_rx << 4 |
1731 "%s: power mode change failed %d\n", __func__, ret);
1736 /* Copy new Power Mode to power info */
1737 memcpy(&hba->pwr_info, pwr_mode, sizeof(struct ufs_pa_layer_attr));
1743 * ufshcd_verify_dev_init() - Verify device initialization
1746 static int ufshcd_verify_dev_init(struct ufs_hba *hba)
1751 for (retries = NOP_OUT_RETRIES; retries > 0; retries--) {
1752 err = ufshcd_exec_dev_cmd(hba, DEV_CMD_TYPE_NOP,
1754 if (!err || err == -ETIMEDOUT)
1757 dev_dbg(hba->dev, "%s: error %d retrying\n", __func__, err);
1761 dev_err(hba->dev, "%s: NOP OUT failed %d\n", __func__, err);
1767 * ufshcd_complete_dev_init() - checks device readiness
1769 static int ufshcd_complete_dev_init(struct ufs_hba *hba)
1775 err = ufshcd_query_flag_retry(hba, UPIU_QUERY_OPCODE_SET_FLAG,
1776 QUERY_FLAG_IDN_FDEVICEINIT, NULL);
1779 "%s setting fDeviceInit flag failed with error %d\n",
1784 /* poll for max. 1000 iterations for fDeviceInit flag to clear */
1785 for (i = 0; i < 1000 && !err && flag_res; i++)
1786 err = ufshcd_query_flag_retry(hba, UPIU_QUERY_OPCODE_READ_FLAG,
1787 QUERY_FLAG_IDN_FDEVICEINIT,
1792 "%s reading fDeviceInit flag failed with error %d\n",
1796 "%s fDeviceInit was not cleared by the device\n",
1803 static void ufshcd_def_desc_sizes(struct ufs_hba *hba)
1805 hba->desc_size.dev_desc = QUERY_DESC_DEVICE_DEF_SIZE;
1806 hba->desc_size.pwr_desc = QUERY_DESC_POWER_DEF_SIZE;
1807 hba->desc_size.interc_desc = QUERY_DESC_INTERCONNECT_DEF_SIZE;
1808 hba->desc_size.conf_desc = QUERY_DESC_CONFIGURATION_DEF_SIZE;
1809 hba->desc_size.unit_desc = QUERY_DESC_UNIT_DEF_SIZE;
1810 hba->desc_size.geom_desc = QUERY_DESC_GEOMETRY_DEF_SIZE;
1811 hba->desc_size.hlth_desc = QUERY_DESC_HEALTH_DEF_SIZE;
1814 int ufs_start(struct ufs_hba *hba)
1816 struct ufs_dev_desc card = {0};
1819 ret = ufshcd_link_startup(hba);
1823 ret = ufshcd_verify_dev_init(hba);
1827 ret = ufshcd_complete_dev_init(hba);
1831 /* Init check for device descriptor sizes */
1832 ufshcd_init_desc_sizes(hba);
1834 ret = ufs_get_device_desc(hba, &card);
1836 dev_err(hba->dev, "%s: Failed getting device info. err = %d\n",
1842 if (ufshcd_get_max_pwr_mode(hba)) {
1844 "%s: Failed getting max supported power mode\n",
1847 ret = ufshcd_change_power_mode(hba, &hba->max_pwr_info.info);
1849 dev_err(hba->dev, "%s: Failed setting power mode, err = %d\n",
1855 printf("Device at %s up at:", hba->dev->name);
1856 ufshcd_print_pwr_info(hba);
1862 int ufshcd_probe(struct udevice *ufs_dev, struct ufs_hba_ops *hba_ops)
1864 struct ufs_hba *hba = dev_get_uclass_priv(ufs_dev);
1865 struct scsi_platdata *scsi_plat;
1866 struct udevice *scsi_dev;
1869 device_find_first_child(ufs_dev, &scsi_dev);
1873 scsi_plat = dev_get_uclass_platdata(scsi_dev);
1874 scsi_plat->max_id = UFSHCD_MAX_ID;
1875 scsi_plat->max_lun = UFS_MAX_LUNS;
1876 scsi_plat->max_bytes_per_req = UFS_MAX_BYTES;
1880 hba->mmio_base = (void *)dev_read_addr(ufs_dev);
1882 /* Set descriptor lengths to specification defaults */
1883 ufshcd_def_desc_sizes(hba);
1885 ufshcd_ops_init(hba);
1887 /* Read capabilties registers */
1888 hba->capabilities = ufshcd_readl(hba, REG_CONTROLLER_CAPABILITIES);
1890 /* Get UFS version supported by the controller */
1891 hba->version = ufshcd_get_ufs_version(hba);
1892 if (hba->version != UFSHCI_VERSION_10 &&
1893 hba->version != UFSHCI_VERSION_11 &&
1894 hba->version != UFSHCI_VERSION_20 &&
1895 hba->version != UFSHCI_VERSION_21)
1896 dev_err(hba->dev, "invalid UFS version 0x%x\n",
1899 /* Get Interrupt bit mask per version */
1900 hba->intr_mask = ufshcd_get_intr_mask(hba);
1902 /* Allocate memory for host memory space */
1903 err = ufshcd_memory_alloc(hba);
1905 dev_err(hba->dev, "Memory allocation failed\n");
1909 /* Configure Local data structures */
1910 ufshcd_host_memory_configure(hba);
1913 * In order to avoid any spurious interrupt immediately after
1914 * registering UFS controller interrupt handler, clear any pending UFS
1915 * interrupt status and disable all the UFS interrupts.
1917 ufshcd_writel(hba, ufshcd_readl(hba, REG_INTERRUPT_STATUS),
1918 REG_INTERRUPT_STATUS);
1919 ufshcd_writel(hba, 0, REG_INTERRUPT_ENABLE);
1921 err = ufshcd_hba_enable(hba);
1923 dev_err(hba->dev, "Host controller enable failed\n");
1927 err = ufs_start(hba);
1934 int ufs_scsi_bind(struct udevice *ufs_dev, struct udevice **scsi_devp)
1936 int ret = device_bind_driver(ufs_dev, "ufs_scsi", "ufs_scsi",
1942 static struct scsi_ops ufs_ops = {
1943 .exec = ufs_scsi_exec,
1946 int ufs_probe_dev(int index)
1948 struct udevice *dev;
1950 return uclass_get_device(UCLASS_UFS, index, &dev);
1955 struct udevice *dev;
1959 ret = uclass_get_device(UCLASS_UFS, i, &dev);
1967 U_BOOT_DRIVER(ufs_scsi) = {