1 // SPDX-License-Identifier: GPL-2.0-only
3 * Copyright (c) 2013-2016, Linux Foundation. All rights reserved.
6 #include <linux/acpi.h>
7 #include <linux/time.h>
9 #include <linux/platform_device.h>
10 #include <linux/phy/phy.h>
11 #include <linux/gpio/consumer.h>
12 #include <linux/reset-controller.h>
13 #include <linux/devfreq.h>
16 #include "ufshcd-pltfrm.h"
20 #include "ufs_quirks.h"
21 #define UFS_QCOM_DEFAULT_DBG_PRINT_EN \
22 (UFS_QCOM_DBG_PRINT_REGS_EN | UFS_QCOM_DBG_PRINT_TEST_BUS_EN)
40 static struct ufs_qcom_host *ufs_qcom_hosts[MAX_UFS_QCOM_HOSTS];
42 static void ufs_qcom_get_default_testbus_cfg(struct ufs_qcom_host *host);
43 static int ufs_qcom_set_dme_vs_core_clk_ctrl_clear_div(struct ufs_hba *hba,
46 static struct ufs_qcom_host *rcdev_to_ufs_host(struct reset_controller_dev *rcd)
48 return container_of(rcd, struct ufs_qcom_host, rcdev);
51 static void ufs_qcom_dump_regs_wrapper(struct ufs_hba *hba, int offset, int len,
52 const char *prefix, void *priv)
54 ufshcd_dump_regs(hba, offset, len * 4, prefix);
57 static int ufs_qcom_get_connected_tx_lanes(struct ufs_hba *hba, u32 *tx_lanes)
61 err = ufshcd_dme_get(hba,
62 UIC_ARG_MIB(PA_CONNECTEDTXDATALANES), tx_lanes);
64 dev_err(hba->dev, "%s: couldn't read PA_CONNECTEDTXDATALANES %d\n",
70 static int ufs_qcom_host_clk_get(struct device *dev,
71 const char *name, struct clk **clk_out, bool optional)
76 clk = devm_clk_get(dev, name);
84 if (optional && err == -ENOENT) {
89 if (err != -EPROBE_DEFER)
90 dev_err(dev, "failed to get %s err %d\n", name, err);
95 static int ufs_qcom_host_clk_enable(struct device *dev,
96 const char *name, struct clk *clk)
100 err = clk_prepare_enable(clk);
102 dev_err(dev, "%s: %s enable failed %d\n", __func__, name, err);
107 static void ufs_qcom_disable_lane_clks(struct ufs_qcom_host *host)
109 if (!host->is_lane_clks_enabled)
112 clk_disable_unprepare(host->tx_l1_sync_clk);
113 clk_disable_unprepare(host->tx_l0_sync_clk);
114 clk_disable_unprepare(host->rx_l1_sync_clk);
115 clk_disable_unprepare(host->rx_l0_sync_clk);
117 host->is_lane_clks_enabled = false;
120 static int ufs_qcom_enable_lane_clks(struct ufs_qcom_host *host)
123 struct device *dev = host->hba->dev;
125 if (host->is_lane_clks_enabled)
128 err = ufs_qcom_host_clk_enable(dev, "rx_lane0_sync_clk",
129 host->rx_l0_sync_clk);
133 err = ufs_qcom_host_clk_enable(dev, "tx_lane0_sync_clk",
134 host->tx_l0_sync_clk);
138 err = ufs_qcom_host_clk_enable(dev, "rx_lane1_sync_clk",
139 host->rx_l1_sync_clk);
143 err = ufs_qcom_host_clk_enable(dev, "tx_lane1_sync_clk",
144 host->tx_l1_sync_clk);
148 host->is_lane_clks_enabled = true;
152 clk_disable_unprepare(host->rx_l1_sync_clk);
154 clk_disable_unprepare(host->tx_l0_sync_clk);
156 clk_disable_unprepare(host->rx_l0_sync_clk);
161 static int ufs_qcom_init_lane_clks(struct ufs_qcom_host *host)
164 struct device *dev = host->hba->dev;
166 if (has_acpi_companion(dev))
169 err = ufs_qcom_host_clk_get(dev, "rx_lane0_sync_clk",
170 &host->rx_l0_sync_clk, false);
174 err = ufs_qcom_host_clk_get(dev, "tx_lane0_sync_clk",
175 &host->tx_l0_sync_clk, false);
179 /* In case of single lane per direction, don't read lane1 clocks */
180 if (host->hba->lanes_per_direction > 1) {
181 err = ufs_qcom_host_clk_get(dev, "rx_lane1_sync_clk",
182 &host->rx_l1_sync_clk, false);
186 err = ufs_qcom_host_clk_get(dev, "tx_lane1_sync_clk",
187 &host->tx_l1_sync_clk, true);
193 static int ufs_qcom_link_startup_post_change(struct ufs_hba *hba)
197 return ufs_qcom_get_connected_tx_lanes(hba, &tx_lanes);
200 static int ufs_qcom_check_hibern8(struct ufs_hba *hba)
204 unsigned long timeout = jiffies + msecs_to_jiffies(HBRN8_POLL_TOUT_MS);
207 err = ufshcd_dme_get(hba,
208 UIC_ARG_MIB_SEL(MPHY_TX_FSM_STATE,
209 UIC_ARG_MPHY_TX_GEN_SEL_INDEX(0)),
211 if (err || tx_fsm_val == TX_FSM_HIBERN8)
214 /* sleep for max. 200us */
215 usleep_range(100, 200);
216 } while (time_before(jiffies, timeout));
219 * we might have scheduled out for long during polling so
220 * check the state again.
222 if (time_after(jiffies, timeout))
223 err = ufshcd_dme_get(hba,
224 UIC_ARG_MIB_SEL(MPHY_TX_FSM_STATE,
225 UIC_ARG_MPHY_TX_GEN_SEL_INDEX(0)),
229 dev_err(hba->dev, "%s: unable to get TX_FSM_STATE, err %d\n",
231 } else if (tx_fsm_val != TX_FSM_HIBERN8) {
233 dev_err(hba->dev, "%s: invalid TX_FSM_STATE = %d\n",
240 static void ufs_qcom_select_unipro_mode(struct ufs_qcom_host *host)
242 ufshcd_rmwl(host->hba, QUNIPRO_SEL,
243 ufs_qcom_cap_qunipro(host) ? QUNIPRO_SEL : 0,
245 /* make sure above configuration is applied before we return */
250 * ufs_qcom_host_reset - reset host controller and PHY
252 static int ufs_qcom_host_reset(struct ufs_hba *hba)
255 struct ufs_qcom_host *host = ufshcd_get_variant(hba);
257 if (!host->core_reset) {
258 dev_warn(hba->dev, "%s: reset control not set\n", __func__);
262 ret = reset_control_assert(host->core_reset);
264 dev_err(hba->dev, "%s: core_reset assert failed, err = %d\n",
270 * The hardware requirement for delay between assert/deassert
271 * is at least 3-4 sleep clock (32.7KHz) cycles, which comes to
272 * ~125us (4/32768). To be on the safe side add 200us delay.
274 usleep_range(200, 210);
276 ret = reset_control_deassert(host->core_reset);
278 dev_err(hba->dev, "%s: core_reset deassert failed, err = %d\n",
281 usleep_range(1000, 1100);
287 static int ufs_qcom_power_up_sequence(struct ufs_hba *hba)
289 struct ufs_qcom_host *host = ufshcd_get_variant(hba);
290 struct phy *phy = host->generic_phy;
292 bool is_rate_B = (UFS_QCOM_LIMIT_HS_RATE == PA_HS_MODE_B)
295 /* Reset UFS Host Controller and PHY */
296 ret = ufs_qcom_host_reset(hba);
298 dev_warn(hba->dev, "%s: host reset returned %d\n",
302 phy_set_mode(phy, PHY_MODE_UFS_HS_B);
304 /* phy initialization - calibrate the phy */
307 dev_err(hba->dev, "%s: phy init failed, ret = %d\n",
312 /* power on phy - start serdes and phy's power and clocks */
313 ret = phy_power_on(phy);
315 dev_err(hba->dev, "%s: phy power on failed, ret = %d\n",
317 goto out_disable_phy;
320 ufs_qcom_select_unipro_mode(host);
331 * The UTP controller has a number of internal clock gating cells (CGCs).
332 * Internal hardware sub-modules within the UTP controller control the CGCs.
333 * Hardware CGCs disable the clock to inactivate UTP sub-modules not involved
334 * in a specific operation, UTP controller CGCs are by default disabled and
335 * this function enables them (after every UFS link startup) to save some power
338 static void ufs_qcom_enable_hw_clk_gating(struct ufs_hba *hba)
341 ufshcd_readl(hba, REG_UFS_CFG2) | REG_UFS_CFG2_CGC_EN_ALL,
344 /* Ensure that HW clock gating is enabled before next operations */
348 static int ufs_qcom_hce_enable_notify(struct ufs_hba *hba,
349 enum ufs_notify_change_status status)
351 struct ufs_qcom_host *host = ufshcd_get_variant(hba);
356 ufs_qcom_power_up_sequence(hba);
358 * The PHY PLL output is the source of tx/rx lane symbol
359 * clocks, hence, enable the lane clocks only after PHY
362 err = ufs_qcom_enable_lane_clks(host);
365 /* check if UFS PHY moved from DISABLED to HIBERN8 */
366 err = ufs_qcom_check_hibern8(hba);
367 ufs_qcom_enable_hw_clk_gating(hba);
368 ufs_qcom_ice_enable(host);
371 dev_err(hba->dev, "%s: invalid status %d\n", __func__, status);
379 * Returns zero for success and non-zero in case of a failure
381 static int ufs_qcom_cfg_timers(struct ufs_hba *hba, u32 gear,
382 u32 hs, u32 rate, bool update_link_startup_timer)
385 struct ufs_qcom_host *host = ufshcd_get_variant(hba);
386 struct ufs_clk_info *clki;
387 u32 core_clk_period_in_ns;
388 u32 tx_clk_cycles_per_us = 0;
389 unsigned long core_clk_rate = 0;
390 u32 core_clk_cycles_per_us = 0;
392 static u32 pwm_fr_table[][2] = {
399 static u32 hs_fr_table_rA[][2] = {
405 static u32 hs_fr_table_rB[][2] = {
412 * The Qunipro controller does not use following registers:
413 * SYS1CLK_1US_REG, TX_SYMBOL_CLK_1US_REG, CLK_NS_REG &
414 * UFS_REG_PA_LINK_STARTUP_TIMER
415 * But UTP controller uses SYS1CLK_1US_REG register for Interrupt
418 if (ufs_qcom_cap_qunipro(host) && !ufshcd_is_intr_aggr_allowed(hba))
422 dev_err(hba->dev, "%s: invalid gear = %d\n", __func__, gear);
426 list_for_each_entry(clki, &hba->clk_list_head, list) {
427 if (!strcmp(clki->name, "core_clk"))
428 core_clk_rate = clk_get_rate(clki->clk);
431 /* If frequency is smaller than 1MHz, set to 1MHz */
432 if (core_clk_rate < DEFAULT_CLK_RATE_HZ)
433 core_clk_rate = DEFAULT_CLK_RATE_HZ;
435 core_clk_cycles_per_us = core_clk_rate / USEC_PER_SEC;
436 if (ufshcd_readl(hba, REG_UFS_SYS1CLK_1US) != core_clk_cycles_per_us) {
437 ufshcd_writel(hba, core_clk_cycles_per_us, REG_UFS_SYS1CLK_1US);
439 * make sure above write gets applied before we return from
445 if (ufs_qcom_cap_qunipro(host))
448 core_clk_period_in_ns = NSEC_PER_SEC / core_clk_rate;
449 core_clk_period_in_ns <<= OFFSET_CLK_NS_REG;
450 core_clk_period_in_ns &= MASK_CLK_NS_REG;
455 if (rate == PA_HS_MODE_A) {
456 if (gear > ARRAY_SIZE(hs_fr_table_rA)) {
458 "%s: index %d exceeds table size %zu\n",
460 ARRAY_SIZE(hs_fr_table_rA));
463 tx_clk_cycles_per_us = hs_fr_table_rA[gear-1][1];
464 } else if (rate == PA_HS_MODE_B) {
465 if (gear > ARRAY_SIZE(hs_fr_table_rB)) {
467 "%s: index %d exceeds table size %zu\n",
469 ARRAY_SIZE(hs_fr_table_rB));
472 tx_clk_cycles_per_us = hs_fr_table_rB[gear-1][1];
474 dev_err(hba->dev, "%s: invalid rate = %d\n",
481 if (gear > ARRAY_SIZE(pwm_fr_table)) {
483 "%s: index %d exceeds table size %zu\n",
485 ARRAY_SIZE(pwm_fr_table));
488 tx_clk_cycles_per_us = pwm_fr_table[gear-1][1];
492 dev_err(hba->dev, "%s: invalid mode = %d\n", __func__, hs);
496 if (ufshcd_readl(hba, REG_UFS_TX_SYMBOL_CLK_NS_US) !=
497 (core_clk_period_in_ns | tx_clk_cycles_per_us)) {
498 /* this register 2 fields shall be written at once */
499 ufshcd_writel(hba, core_clk_period_in_ns | tx_clk_cycles_per_us,
500 REG_UFS_TX_SYMBOL_CLK_NS_US);
502 * make sure above write gets applied before we return from
508 if (update_link_startup_timer) {
509 ufshcd_writel(hba, ((core_clk_rate / MSEC_PER_SEC) * 100),
510 REG_UFS_PA_LINK_STARTUP_TIMER);
512 * make sure that this configuration is applied before
525 static int ufs_qcom_link_startup_notify(struct ufs_hba *hba,
526 enum ufs_notify_change_status status)
529 struct ufs_qcom_host *host = ufshcd_get_variant(hba);
533 if (ufs_qcom_cfg_timers(hba, UFS_PWM_G1, SLOWAUTO_MODE,
535 dev_err(hba->dev, "%s: ufs_qcom_cfg_timers() failed\n",
541 if (ufs_qcom_cap_qunipro(host))
543 * set unipro core clock cycles to 150 & clear clock
546 err = ufs_qcom_set_dme_vs_core_clk_ctrl_clear_div(hba,
550 * Some UFS devices (and may be host) have issues if LCC is
551 * enabled. So we are setting PA_Local_TX_LCC_Enable to 0
552 * before link startup which will make sure that both host
553 * and device TX LCC are disabled once link startup is
556 if (ufshcd_get_local_unipro_ver(hba) != UFS_UNIPRO_VER_1_41)
557 err = ufshcd_disable_host_tx_lcc(hba);
561 ufs_qcom_link_startup_post_change(hba);
571 static int ufs_qcom_suspend(struct ufs_hba *hba, enum ufs_pm_op pm_op)
573 struct ufs_qcom_host *host = ufshcd_get_variant(hba);
574 struct phy *phy = host->generic_phy;
576 if (ufs_qcom_is_link_off(hba)) {
578 * Disable the tx/rx lane symbol clocks before PHY is
579 * powered down as the PLL source should be disabled
580 * after downstream clocks are disabled.
582 ufs_qcom_disable_lane_clks(host);
585 } else if (!ufs_qcom_is_link_active(hba)) {
586 ufs_qcom_disable_lane_clks(host);
592 static int ufs_qcom_resume(struct ufs_hba *hba, enum ufs_pm_op pm_op)
594 struct ufs_qcom_host *host = ufshcd_get_variant(hba);
595 struct phy *phy = host->generic_phy;
598 if (ufs_qcom_is_link_off(hba)) {
599 err = phy_power_on(phy);
601 dev_err(hba->dev, "%s: failed PHY power on: %d\n",
606 err = ufs_qcom_enable_lane_clks(host);
610 } else if (!ufs_qcom_is_link_active(hba)) {
611 err = ufs_qcom_enable_lane_clks(host);
616 err = ufs_qcom_ice_resume(host);
620 hba->is_sys_suspended = false;
624 static void ufs_qcom_dev_ref_clk_ctrl(struct ufs_qcom_host *host, bool enable)
626 if (host->dev_ref_clk_ctrl_mmio &&
627 (enable ^ host->is_dev_ref_clk_enabled)) {
628 u32 temp = readl_relaxed(host->dev_ref_clk_ctrl_mmio);
631 temp |= host->dev_ref_clk_en_mask;
633 temp &= ~host->dev_ref_clk_en_mask;
636 * If we are here to disable this clock it might be immediately
637 * after entering into hibern8 in which case we need to make
638 * sure that device ref_clk is active for specific time after
642 unsigned long gating_wait;
644 gating_wait = host->hba->dev_info.clk_gating_wait_us;
649 * bRefClkGatingWaitTime defines the minimum
650 * time for which the reference clock is
651 * required by device during transition from
652 * HS-MODE to LS-MODE or HIBERN8 state. Give it
653 * more delay to be on the safe side.
656 usleep_range(gating_wait, gating_wait + 10);
660 writel_relaxed(temp, host->dev_ref_clk_ctrl_mmio);
662 /* ensure that ref_clk is enabled/disabled before we return */
666 * If we call hibern8 exit after this, we need to make sure that
667 * device ref_clk is stable for at least 1us before the hibern8
673 host->is_dev_ref_clk_enabled = enable;
677 static int ufs_qcom_pwr_change_notify(struct ufs_hba *hba,
678 enum ufs_notify_change_status status,
679 struct ufs_pa_layer_attr *dev_max_params,
680 struct ufs_pa_layer_attr *dev_req_params)
682 struct ufs_qcom_host *host = ufshcd_get_variant(hba);
683 struct ufs_dev_params ufs_qcom_cap;
686 if (!dev_req_params) {
687 pr_err("%s: incoming dev_req_params is NULL\n", __func__);
694 ufs_qcom_cap.tx_lanes = UFS_QCOM_LIMIT_NUM_LANES_TX;
695 ufs_qcom_cap.rx_lanes = UFS_QCOM_LIMIT_NUM_LANES_RX;
696 ufs_qcom_cap.hs_rx_gear = UFS_QCOM_LIMIT_HSGEAR_RX;
697 ufs_qcom_cap.hs_tx_gear = UFS_QCOM_LIMIT_HSGEAR_TX;
698 ufs_qcom_cap.pwm_rx_gear = UFS_QCOM_LIMIT_PWMGEAR_RX;
699 ufs_qcom_cap.pwm_tx_gear = UFS_QCOM_LIMIT_PWMGEAR_TX;
700 ufs_qcom_cap.rx_pwr_pwm = UFS_QCOM_LIMIT_RX_PWR_PWM;
701 ufs_qcom_cap.tx_pwr_pwm = UFS_QCOM_LIMIT_TX_PWR_PWM;
702 ufs_qcom_cap.rx_pwr_hs = UFS_QCOM_LIMIT_RX_PWR_HS;
703 ufs_qcom_cap.tx_pwr_hs = UFS_QCOM_LIMIT_TX_PWR_HS;
704 ufs_qcom_cap.hs_rate = UFS_QCOM_LIMIT_HS_RATE;
705 ufs_qcom_cap.desired_working_mode =
706 UFS_QCOM_LIMIT_DESIRED_MODE;
708 if (host->hw_ver.major == 0x1) {
710 * HS-G3 operations may not reliably work on legacy QCOM
711 * UFS host controller hardware even though capability
712 * exchange during link startup phase may end up
713 * negotiating maximum supported gear as G3.
714 * Hence downgrade the maximum supported gear to HS-G2.
716 if (ufs_qcom_cap.hs_tx_gear > UFS_HS_G2)
717 ufs_qcom_cap.hs_tx_gear = UFS_HS_G2;
718 if (ufs_qcom_cap.hs_rx_gear > UFS_HS_G2)
719 ufs_qcom_cap.hs_rx_gear = UFS_HS_G2;
722 ret = ufshcd_get_pwr_dev_param(&ufs_qcom_cap,
726 pr_err("%s: failed to determine capabilities\n",
731 /* enable the device ref clock before changing to HS mode */
732 if (!ufshcd_is_hs_mode(&hba->pwr_info) &&
733 ufshcd_is_hs_mode(dev_req_params))
734 ufs_qcom_dev_ref_clk_ctrl(host, true);
736 if (host->hw_ver.major >= 0x4) {
737 if (dev_req_params->gear_tx == UFS_HS_G4) {
740 UIC_ARG_MIB(PA_TXHSADAPTTYPE),
745 UIC_ARG_MIB(PA_TXHSADAPTTYPE),
751 if (ufs_qcom_cfg_timers(hba, dev_req_params->gear_rx,
752 dev_req_params->pwr_rx,
753 dev_req_params->hs_rate, false)) {
754 dev_err(hba->dev, "%s: ufs_qcom_cfg_timers() failed\n",
757 * we return error code at the end of the routine,
758 * but continue to configure UFS_PHY_TX_LANE_ENABLE
759 * and bus voting as usual
764 /* cache the power mode parameters to use internally */
765 memcpy(&host->dev_req_params,
766 dev_req_params, sizeof(*dev_req_params));
768 /* disable the device ref clock if entered PWM mode */
769 if (ufshcd_is_hs_mode(&hba->pwr_info) &&
770 !ufshcd_is_hs_mode(dev_req_params))
771 ufs_qcom_dev_ref_clk_ctrl(host, false);
781 static int ufs_qcom_quirk_host_pa_saveconfigtime(struct ufs_hba *hba)
784 u32 pa_vs_config_reg1;
786 err = ufshcd_dme_get(hba, UIC_ARG_MIB(PA_VS_CONFIG_REG1),
791 /* Allow extension of MSB bits of PA_SaveConfigTime attribute */
792 err = ufshcd_dme_set(hba, UIC_ARG_MIB(PA_VS_CONFIG_REG1),
793 (pa_vs_config_reg1 | (1 << 12)));
799 static int ufs_qcom_apply_dev_quirks(struct ufs_hba *hba)
803 if (hba->dev_quirks & UFS_DEVICE_QUIRK_HOST_PA_SAVECONFIGTIME)
804 err = ufs_qcom_quirk_host_pa_saveconfigtime(hba);
806 if (hba->dev_info.wmanufacturerid == UFS_VENDOR_WDC)
807 hba->dev_quirks |= UFS_DEVICE_QUIRK_HOST_PA_TACTIVATE;
812 static u32 ufs_qcom_get_ufs_hci_version(struct ufs_hba *hba)
814 struct ufs_qcom_host *host = ufshcd_get_variant(hba);
816 if (host->hw_ver.major == 0x1)
817 return UFSHCI_VERSION_11;
819 return UFSHCI_VERSION_20;
823 * ufs_qcom_advertise_quirks - advertise the known QCOM UFS controller quirks
824 * @hba: host controller instance
826 * QCOM UFS host controller might have some non standard behaviours (quirks)
827 * than what is specified by UFSHCI specification. Advertise all such
828 * quirks to standard UFS host controller driver so standard takes them into
831 static void ufs_qcom_advertise_quirks(struct ufs_hba *hba)
833 struct ufs_qcom_host *host = ufshcd_get_variant(hba);
835 if (host->hw_ver.major == 0x01) {
836 hba->quirks |= UFSHCD_QUIRK_DELAY_BEFORE_DME_CMDS
837 | UFSHCD_QUIRK_BROKEN_PA_RXHSUNTERMCAP
838 | UFSHCD_QUIRK_DME_PEER_ACCESS_AUTO_MODE;
840 if (host->hw_ver.minor == 0x0001 && host->hw_ver.step == 0x0001)
841 hba->quirks |= UFSHCD_QUIRK_BROKEN_INTR_AGGR;
843 hba->quirks |= UFSHCD_QUIRK_BROKEN_LCC;
846 if (host->hw_ver.major == 0x2) {
847 hba->quirks |= UFSHCD_QUIRK_BROKEN_UFS_HCI_VERSION;
849 if (!ufs_qcom_cap_qunipro(host))
850 /* Legacy UniPro mode still need following quirks */
851 hba->quirks |= (UFSHCD_QUIRK_DELAY_BEFORE_DME_CMDS
852 | UFSHCD_QUIRK_DME_PEER_ACCESS_AUTO_MODE
853 | UFSHCD_QUIRK_BROKEN_PA_RXHSUNTERMCAP);
857 static void ufs_qcom_set_caps(struct ufs_hba *hba)
859 struct ufs_qcom_host *host = ufshcd_get_variant(hba);
861 hba->caps |= UFSHCD_CAP_CLK_GATING | UFSHCD_CAP_HIBERN8_WITH_CLK_GATING;
862 hba->caps |= UFSHCD_CAP_CLK_SCALING;
863 hba->caps |= UFSHCD_CAP_AUTO_BKOPS_SUSPEND;
864 hba->caps |= UFSHCD_CAP_WB_EN;
865 hba->caps |= UFSHCD_CAP_CRYPTO;
867 if (host->hw_ver.major >= 0x2) {
868 host->caps = UFS_QCOM_CAP_QUNIPRO |
869 UFS_QCOM_CAP_RETAIN_SEC_CFG_AFTER_PWR_COLLAPSE;
874 * ufs_qcom_setup_clocks - enables/disable clocks
875 * @hba: host controller instance
876 * @on: If true, enable clocks else disable them.
877 * @status: PRE_CHANGE or POST_CHANGE notify
879 * Returns 0 on success, non-zero on failure.
881 static int ufs_qcom_setup_clocks(struct ufs_hba *hba, bool on,
882 enum ufs_notify_change_status status)
884 struct ufs_qcom_host *host = ufshcd_get_variant(hba);
888 * In case ufs_qcom_init() is not yet done, simply ignore.
889 * This ufs_qcom_setup_clocks() shall be called from
890 * ufs_qcom_init() after init is done.
898 if (!ufs_qcom_is_link_active(hba)) {
899 /* disable device ref_clk */
900 ufs_qcom_dev_ref_clk_ctrl(host, false);
906 /* enable the device ref clock for HS mode*/
907 if (ufshcd_is_hs_mode(&hba->pwr_info))
908 ufs_qcom_dev_ref_clk_ctrl(host, true);
917 ufs_qcom_reset_assert(struct reset_controller_dev *rcdev, unsigned long id)
919 struct ufs_qcom_host *host = rcdev_to_ufs_host(rcdev);
921 /* Currently this code only knows about a single reset. */
923 ufs_qcom_assert_reset(host->hba);
924 /* provide 1ms delay to let the reset pulse propagate. */
925 usleep_range(1000, 1100);
930 ufs_qcom_reset_deassert(struct reset_controller_dev *rcdev, unsigned long id)
932 struct ufs_qcom_host *host = rcdev_to_ufs_host(rcdev);
934 /* Currently this code only knows about a single reset. */
936 ufs_qcom_deassert_reset(host->hba);
939 * after reset deassertion, phy will need all ref clocks,
940 * voltage, current to settle down before starting serdes.
942 usleep_range(1000, 1100);
946 static const struct reset_control_ops ufs_qcom_reset_ops = {
947 .assert = ufs_qcom_reset_assert,
948 .deassert = ufs_qcom_reset_deassert,
951 #define ANDROID_BOOT_DEV_MAX 30
952 static char android_boot_dev[ANDROID_BOOT_DEV_MAX];
955 static int __init get_android_boot_dev(char *str)
957 strlcpy(android_boot_dev, str, ANDROID_BOOT_DEV_MAX);
960 __setup("androidboot.bootdevice=", get_android_boot_dev);
964 * ufs_qcom_init - bind phy with controller
965 * @hba: host controller instance
967 * Binds PHY with controller and powers up PHY enabling clocks
970 * Returns -EPROBE_DEFER if binding fails, returns negative error
971 * on phy power up failure and returns zero on success.
973 static int ufs_qcom_init(struct ufs_hba *hba)
976 struct device *dev = hba->dev;
977 struct platform_device *pdev = to_platform_device(dev);
978 struct ufs_qcom_host *host;
979 struct resource *res;
981 if (strlen(android_boot_dev) && strcmp(android_boot_dev, dev_name(dev)))
984 host = devm_kzalloc(dev, sizeof(*host), GFP_KERNEL);
987 dev_err(dev, "%s: no memory for qcom ufs host\n", __func__);
991 /* Make a two way bind between the qcom host and the hba */
993 ufshcd_set_variant(hba, host);
995 /* Setup the reset control of HCI */
996 host->core_reset = devm_reset_control_get(hba->dev, "rst");
997 if (IS_ERR(host->core_reset)) {
998 err = PTR_ERR(host->core_reset);
999 dev_warn(dev, "Failed to get reset control %d\n", err);
1000 host->core_reset = NULL;
1004 /* Fire up the reset controller. Failure here is non-fatal. */
1005 host->rcdev.of_node = dev->of_node;
1006 host->rcdev.ops = &ufs_qcom_reset_ops;
1007 host->rcdev.owner = dev->driver->owner;
1008 host->rcdev.nr_resets = 1;
1009 err = devm_reset_controller_register(dev, &host->rcdev);
1011 dev_warn(dev, "Failed to register reset controller\n");
1016 * voting/devoting device ref_clk source is time consuming hence
1017 * skip devoting it during aggressive clock gating. This clock
1018 * will still be gated off during runtime suspend.
1020 host->generic_phy = devm_phy_get(dev, "ufsphy");
1022 if (host->generic_phy == ERR_PTR(-EPROBE_DEFER)) {
1024 * UFS driver might be probed before the phy driver does.
1025 * In that case we would like to return EPROBE_DEFER code.
1027 err = -EPROBE_DEFER;
1028 dev_warn(dev, "%s: required phy device. hasn't probed yet. err = %d\n",
1030 goto out_variant_clear;
1031 } else if (IS_ERR(host->generic_phy)) {
1032 if (has_acpi_companion(dev)) {
1033 host->generic_phy = NULL;
1035 err = PTR_ERR(host->generic_phy);
1036 dev_err(dev, "%s: PHY get failed %d\n", __func__, err);
1037 goto out_variant_clear;
1041 host->device_reset = devm_gpiod_get_optional(dev, "reset",
1043 if (IS_ERR(host->device_reset)) {
1044 err = PTR_ERR(host->device_reset);
1045 if (err != -EPROBE_DEFER)
1046 dev_err(dev, "failed to acquire reset gpio: %d\n", err);
1047 goto out_variant_clear;
1050 ufs_qcom_get_controller_revision(hba, &host->hw_ver.major,
1051 &host->hw_ver.minor, &host->hw_ver.step);
1054 * for newer controllers, device reference clock control bit has
1055 * moved inside UFS controller register address space itself.
1057 if (host->hw_ver.major >= 0x02) {
1058 host->dev_ref_clk_ctrl_mmio = hba->mmio_base + REG_UFS_CFG1;
1059 host->dev_ref_clk_en_mask = BIT(26);
1061 /* "dev_ref_clk_ctrl_mem" is optional resource */
1062 res = platform_get_resource_byname(pdev, IORESOURCE_MEM,
1063 "dev_ref_clk_ctrl_mem");
1065 host->dev_ref_clk_ctrl_mmio =
1066 devm_ioremap_resource(dev, res);
1067 if (IS_ERR(host->dev_ref_clk_ctrl_mmio)) {
1069 "%s: could not map dev_ref_clk_ctrl_mmio, err %ld\n",
1071 PTR_ERR(host->dev_ref_clk_ctrl_mmio));
1072 host->dev_ref_clk_ctrl_mmio = NULL;
1074 host->dev_ref_clk_en_mask = BIT(5);
1078 err = ufs_qcom_init_lane_clks(host);
1080 goto out_variant_clear;
1082 ufs_qcom_set_caps(hba);
1083 ufs_qcom_advertise_quirks(hba);
1085 err = ufs_qcom_ice_init(host);
1087 goto out_variant_clear;
1089 ufs_qcom_setup_clocks(hba, true, POST_CHANGE);
1091 if (hba->dev->id < MAX_UFS_QCOM_HOSTS)
1092 ufs_qcom_hosts[hba->dev->id] = host;
1094 host->dbg_print_en |= UFS_QCOM_DEFAULT_DBG_PRINT_EN;
1095 ufs_qcom_get_default_testbus_cfg(host);
1096 err = ufs_qcom_testbus_config(host);
1098 dev_warn(dev, "%s: failed to configure the testbus %d\n",
1106 ufshcd_set_variant(hba, NULL);
1111 static void ufs_qcom_exit(struct ufs_hba *hba)
1113 struct ufs_qcom_host *host = ufshcd_get_variant(hba);
1115 ufs_qcom_disable_lane_clks(host);
1116 phy_power_off(host->generic_phy);
1117 phy_exit(host->generic_phy);
1120 static int ufs_qcom_set_dme_vs_core_clk_ctrl_clear_div(struct ufs_hba *hba,
1124 u32 core_clk_ctrl_reg;
1126 if (clk_cycles > DME_VS_CORE_CLK_CTRL_MAX_CORE_CLK_1US_CYCLES_MASK)
1129 err = ufshcd_dme_get(hba,
1130 UIC_ARG_MIB(DME_VS_CORE_CLK_CTRL),
1131 &core_clk_ctrl_reg);
1135 core_clk_ctrl_reg &= ~DME_VS_CORE_CLK_CTRL_MAX_CORE_CLK_1US_CYCLES_MASK;
1136 core_clk_ctrl_reg |= clk_cycles;
1138 /* Clear CORE_CLK_DIV_EN */
1139 core_clk_ctrl_reg &= ~DME_VS_CORE_CLK_CTRL_CORE_CLK_DIV_EN_BIT;
1141 err = ufshcd_dme_set(hba,
1142 UIC_ARG_MIB(DME_VS_CORE_CLK_CTRL),
1148 static int ufs_qcom_clk_scale_up_pre_change(struct ufs_hba *hba)
1150 /* nothing to do as of now */
1154 static int ufs_qcom_clk_scale_up_post_change(struct ufs_hba *hba)
1156 struct ufs_qcom_host *host = ufshcd_get_variant(hba);
1158 if (!ufs_qcom_cap_qunipro(host))
1161 /* set unipro core clock cycles to 150 and clear clock divider */
1162 return ufs_qcom_set_dme_vs_core_clk_ctrl_clear_div(hba, 150);
1165 static int ufs_qcom_clk_scale_down_pre_change(struct ufs_hba *hba)
1167 struct ufs_qcom_host *host = ufshcd_get_variant(hba);
1169 u32 core_clk_ctrl_reg;
1171 if (!ufs_qcom_cap_qunipro(host))
1174 err = ufshcd_dme_get(hba,
1175 UIC_ARG_MIB(DME_VS_CORE_CLK_CTRL),
1176 &core_clk_ctrl_reg);
1178 /* make sure CORE_CLK_DIV_EN is cleared */
1180 (core_clk_ctrl_reg & DME_VS_CORE_CLK_CTRL_CORE_CLK_DIV_EN_BIT)) {
1181 core_clk_ctrl_reg &= ~DME_VS_CORE_CLK_CTRL_CORE_CLK_DIV_EN_BIT;
1182 err = ufshcd_dme_set(hba,
1183 UIC_ARG_MIB(DME_VS_CORE_CLK_CTRL),
1190 static int ufs_qcom_clk_scale_down_post_change(struct ufs_hba *hba)
1192 struct ufs_qcom_host *host = ufshcd_get_variant(hba);
1194 if (!ufs_qcom_cap_qunipro(host))
1197 /* set unipro core clock cycles to 75 and clear clock divider */
1198 return ufs_qcom_set_dme_vs_core_clk_ctrl_clear_div(hba, 75);
1201 static int ufs_qcom_clk_scale_notify(struct ufs_hba *hba,
1202 bool scale_up, enum ufs_notify_change_status status)
1204 struct ufs_qcom_host *host = ufshcd_get_variant(hba);
1205 struct ufs_pa_layer_attr *dev_req_params = &host->dev_req_params;
1208 if (status == PRE_CHANGE) {
1210 err = ufs_qcom_clk_scale_up_pre_change(hba);
1212 err = ufs_qcom_clk_scale_down_pre_change(hba);
1215 err = ufs_qcom_clk_scale_up_post_change(hba);
1217 err = ufs_qcom_clk_scale_down_post_change(hba);
1219 if (err || !dev_req_params)
1222 ufs_qcom_cfg_timers(hba,
1223 dev_req_params->gear_rx,
1224 dev_req_params->pwr_rx,
1225 dev_req_params->hs_rate,
1233 static void ufs_qcom_print_hw_debug_reg_all(struct ufs_hba *hba,
1234 void *priv, void (*print_fn)(struct ufs_hba *hba,
1235 int offset, int num_regs, const char *str, void *priv))
1238 struct ufs_qcom_host *host;
1240 if (unlikely(!hba)) {
1241 pr_err("%s: hba is NULL\n", __func__);
1244 if (unlikely(!print_fn)) {
1245 dev_err(hba->dev, "%s: print_fn is NULL\n", __func__);
1249 host = ufshcd_get_variant(hba);
1250 if (!(host->dbg_print_en & UFS_QCOM_DBG_PRINT_REGS_EN))
1253 reg = ufs_qcom_get_debug_reg_offset(host, UFS_UFS_DBG_RD_REG_OCSC);
1254 print_fn(hba, reg, 44, "UFS_UFS_DBG_RD_REG_OCSC ", priv);
1256 reg = ufshcd_readl(hba, REG_UFS_CFG1);
1257 reg |= UTP_DBG_RAMS_EN;
1258 ufshcd_writel(hba, reg, REG_UFS_CFG1);
1260 reg = ufs_qcom_get_debug_reg_offset(host, UFS_UFS_DBG_RD_EDTL_RAM);
1261 print_fn(hba, reg, 32, "UFS_UFS_DBG_RD_EDTL_RAM ", priv);
1263 reg = ufs_qcom_get_debug_reg_offset(host, UFS_UFS_DBG_RD_DESC_RAM);
1264 print_fn(hba, reg, 128, "UFS_UFS_DBG_RD_DESC_RAM ", priv);
1266 reg = ufs_qcom_get_debug_reg_offset(host, UFS_UFS_DBG_RD_PRDT_RAM);
1267 print_fn(hba, reg, 64, "UFS_UFS_DBG_RD_PRDT_RAM ", priv);
1269 /* clear bit 17 - UTP_DBG_RAMS_EN */
1270 ufshcd_rmwl(hba, UTP_DBG_RAMS_EN, 0, REG_UFS_CFG1);
1272 reg = ufs_qcom_get_debug_reg_offset(host, UFS_DBG_RD_REG_UAWM);
1273 print_fn(hba, reg, 4, "UFS_DBG_RD_REG_UAWM ", priv);
1275 reg = ufs_qcom_get_debug_reg_offset(host, UFS_DBG_RD_REG_UARM);
1276 print_fn(hba, reg, 4, "UFS_DBG_RD_REG_UARM ", priv);
1278 reg = ufs_qcom_get_debug_reg_offset(host, UFS_DBG_RD_REG_TXUC);
1279 print_fn(hba, reg, 48, "UFS_DBG_RD_REG_TXUC ", priv);
1281 reg = ufs_qcom_get_debug_reg_offset(host, UFS_DBG_RD_REG_RXUC);
1282 print_fn(hba, reg, 27, "UFS_DBG_RD_REG_RXUC ", priv);
1284 reg = ufs_qcom_get_debug_reg_offset(host, UFS_DBG_RD_REG_DFC);
1285 print_fn(hba, reg, 19, "UFS_DBG_RD_REG_DFC ", priv);
1287 reg = ufs_qcom_get_debug_reg_offset(host, UFS_DBG_RD_REG_TRLUT);
1288 print_fn(hba, reg, 34, "UFS_DBG_RD_REG_TRLUT ", priv);
1290 reg = ufs_qcom_get_debug_reg_offset(host, UFS_DBG_RD_REG_TMRLUT);
1291 print_fn(hba, reg, 9, "UFS_DBG_RD_REG_TMRLUT ", priv);
1294 static void ufs_qcom_enable_test_bus(struct ufs_qcom_host *host)
1296 if (host->dbg_print_en & UFS_QCOM_DBG_PRINT_TEST_BUS_EN) {
1297 ufshcd_rmwl(host->hba, UFS_REG_TEST_BUS_EN,
1298 UFS_REG_TEST_BUS_EN, REG_UFS_CFG1);
1299 ufshcd_rmwl(host->hba, TEST_BUS_EN, TEST_BUS_EN, REG_UFS_CFG1);
1301 ufshcd_rmwl(host->hba, UFS_REG_TEST_BUS_EN, 0, REG_UFS_CFG1);
1302 ufshcd_rmwl(host->hba, TEST_BUS_EN, 0, REG_UFS_CFG1);
1306 static void ufs_qcom_get_default_testbus_cfg(struct ufs_qcom_host *host)
1308 /* provide a legal default configuration */
1309 host->testbus.select_major = TSTBUS_UNIPRO;
1310 host->testbus.select_minor = 37;
1313 static bool ufs_qcom_testbus_cfg_is_ok(struct ufs_qcom_host *host)
1315 if (host->testbus.select_major >= TSTBUS_MAX) {
1316 dev_err(host->hba->dev,
1317 "%s: UFS_CFG1[TEST_BUS_SEL} may not equal 0x%05X\n",
1318 __func__, host->testbus.select_major);
1325 int ufs_qcom_testbus_config(struct ufs_qcom_host *host)
1329 u32 mask = TEST_BUS_SUB_SEL_MASK;
1334 if (!ufs_qcom_testbus_cfg_is_ok(host))
1337 switch (host->testbus.select_major) {
1339 reg = UFS_TEST_BUS_CTRL_0;
1343 reg = UFS_TEST_BUS_CTRL_0;
1347 reg = UFS_TEST_BUS_CTRL_0;
1351 reg = UFS_TEST_BUS_CTRL_0;
1355 reg = UFS_TEST_BUS_CTRL_1;
1359 reg = UFS_TEST_BUS_CTRL_1;
1363 reg = UFS_TEST_BUS_CTRL_1;
1367 reg = UFS_TEST_BUS_CTRL_1;
1370 case TSTBUS_WRAPPER:
1371 reg = UFS_TEST_BUS_CTRL_2;
1374 case TSTBUS_COMBINED:
1375 reg = UFS_TEST_BUS_CTRL_2;
1378 case TSTBUS_UTP_HCI:
1379 reg = UFS_TEST_BUS_CTRL_2;
1383 reg = UFS_UNIPRO_CFG;
1388 * No need for a default case, since
1389 * ufs_qcom_testbus_cfg_is_ok() checks that the configuration
1394 ufshcd_rmwl(host->hba, TEST_BUS_SEL,
1395 (u32)host->testbus.select_major << 19,
1397 ufshcd_rmwl(host->hba, mask,
1398 (u32)host->testbus.select_minor << offset,
1400 ufs_qcom_enable_test_bus(host);
1402 * Make sure the test bus configuration is
1403 * committed before returning.
1410 static void ufs_qcom_dump_dbg_regs(struct ufs_hba *hba)
1412 ufshcd_dump_regs(hba, REG_UFS_SYS1CLK_1US, 16 * 4,
1413 "HCI Vendor Specific Registers ");
1415 ufs_qcom_print_hw_debug_reg_all(hba, NULL, ufs_qcom_dump_regs_wrapper);
1419 * ufs_qcom_device_reset() - toggle the (optional) device reset line
1420 * @hba: per-adapter instance
1422 * Toggles the (optional) reset line to reset the attached device.
1424 static void ufs_qcom_device_reset(struct ufs_hba *hba)
1426 struct ufs_qcom_host *host = ufshcd_get_variant(hba);
1428 /* reset gpio is optional */
1429 if (!host->device_reset)
1433 * The UFS device shall detect reset pulses of 1us, sleep for 10us to
1434 * be on the safe side.
1436 gpiod_set_value_cansleep(host->device_reset, 1);
1437 usleep_range(10, 15);
1439 gpiod_set_value_cansleep(host->device_reset, 0);
1440 usleep_range(10, 15);
1443 #if IS_ENABLED(CONFIG_DEVFREQ_GOV_SIMPLE_ONDEMAND)
1444 static void ufs_qcom_config_scaling_param(struct ufs_hba *hba,
1445 struct devfreq_dev_profile *p,
1448 static struct devfreq_simple_ondemand_data *d;
1453 d = (struct devfreq_simple_ondemand_data *)data;
1455 d->upthreshold = 70;
1456 d->downdifferential = 5;
1459 static void ufs_qcom_config_scaling_param(struct ufs_hba *hba,
1460 struct devfreq_dev_profile *p,
1467 * struct ufs_hba_qcom_vops - UFS QCOM specific variant operations
1469 * The variant operations configure the necessary controller and PHY
1470 * handshake during initialization.
1472 static const struct ufs_hba_variant_ops ufs_hba_qcom_vops = {
1474 .init = ufs_qcom_init,
1475 .exit = ufs_qcom_exit,
1476 .get_ufs_hci_version = ufs_qcom_get_ufs_hci_version,
1477 .clk_scale_notify = ufs_qcom_clk_scale_notify,
1478 .setup_clocks = ufs_qcom_setup_clocks,
1479 .hce_enable_notify = ufs_qcom_hce_enable_notify,
1480 .link_startup_notify = ufs_qcom_link_startup_notify,
1481 .pwr_change_notify = ufs_qcom_pwr_change_notify,
1482 .apply_dev_quirks = ufs_qcom_apply_dev_quirks,
1483 .suspend = ufs_qcom_suspend,
1484 .resume = ufs_qcom_resume,
1485 .dbg_register_dump = ufs_qcom_dump_dbg_regs,
1486 .device_reset = ufs_qcom_device_reset,
1487 .config_scaling_param = ufs_qcom_config_scaling_param,
1488 .program_key = ufs_qcom_ice_program_key,
1492 * ufs_qcom_probe - probe routine of the driver
1493 * @pdev: pointer to Platform device handle
1495 * Return zero for success and non-zero for failure
1497 static int ufs_qcom_probe(struct platform_device *pdev)
1500 struct device *dev = &pdev->dev;
1502 /* Perform generic probe */
1503 err = ufshcd_pltfrm_init(pdev, &ufs_hba_qcom_vops);
1505 dev_err(dev, "ufshcd_pltfrm_init() failed %d\n", err);
1511 * ufs_qcom_remove - set driver_data of the device to NULL
1512 * @pdev: pointer to platform device handle
1516 static int ufs_qcom_remove(struct platform_device *pdev)
1518 struct ufs_hba *hba = platform_get_drvdata(pdev);
1520 pm_runtime_get_sync(&(pdev)->dev);
1525 static const struct of_device_id ufs_qcom_of_match[] = {
1526 { .compatible = "qcom,ufshc"},
1529 MODULE_DEVICE_TABLE(of, ufs_qcom_of_match);
1532 static const struct acpi_device_id ufs_qcom_acpi_match[] = {
1536 MODULE_DEVICE_TABLE(acpi, ufs_qcom_acpi_match);
1539 static const struct dev_pm_ops ufs_qcom_pm_ops = {
1540 .suspend = ufshcd_pltfrm_suspend,
1541 .resume = ufshcd_pltfrm_resume,
1542 .runtime_suspend = ufshcd_pltfrm_runtime_suspend,
1543 .runtime_resume = ufshcd_pltfrm_runtime_resume,
1544 .runtime_idle = ufshcd_pltfrm_runtime_idle,
1547 static struct platform_driver ufs_qcom_pltform = {
1548 .probe = ufs_qcom_probe,
1549 .remove = ufs_qcom_remove,
1550 .shutdown = ufshcd_pltfrm_shutdown,
1552 .name = "ufshcd-qcom",
1553 .pm = &ufs_qcom_pm_ops,
1554 .of_match_table = of_match_ptr(ufs_qcom_of_match),
1555 .acpi_match_table = ACPI_PTR(ufs_qcom_acpi_match),
1558 module_platform_driver(ufs_qcom_pltform);
1560 MODULE_LICENSE("GPL v2");