1 /* Copyright (c) 2013-2015, The Linux Foundation. All rights reserved.
2  *
3  * This program is free software; you can redistribute it and/or modify
4  * it under the terms of the GNU General Public License version 2 and
5  * only version 2 as published by the Free Software Foundation.
6  *
7  * This program is distributed in the hope that it will be useful,
8  * but WITHOUT ANY WARRANTY; without even the implied warranty of
9  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
10  * GNU General Public License for more details.
11  *
12  */
13 
14 #ifndef UFS_QCOM_H_
15 #define UFS_QCOM_H_
16 
17 #define MAX_UFS_QCOM_HOSTS	1
18 #define MAX_U32                 (~(u32)0)
19 #define MPHY_TX_FSM_STATE       0x41
20 #define TX_FSM_HIBERN8          0x1
21 #define HBRN8_POLL_TOUT_MS      100
22 #define DEFAULT_CLK_RATE_HZ     1000000
23 #define BUS_VECTOR_NAME_LEN     32
24 
25 #define UFS_HW_VER_MAJOR_SHFT	(28)
26 #define UFS_HW_VER_MAJOR_MASK	(0x000F << UFS_HW_VER_MAJOR_SHFT)
27 #define UFS_HW_VER_MINOR_SHFT	(16)
28 #define UFS_HW_VER_MINOR_MASK	(0x0FFF << UFS_HW_VER_MINOR_SHFT)
29 #define UFS_HW_VER_STEP_SHFT	(0)
30 #define UFS_HW_VER_STEP_MASK	(0xFFFF << UFS_HW_VER_STEP_SHFT)
31 
32 /* vendor specific pre-defined parameters */
33 #define SLOW 1
34 #define FAST 2
35 
36 #define UFS_QCOM_LIMIT_NUM_LANES_RX	2
37 #define UFS_QCOM_LIMIT_NUM_LANES_TX	2
38 #define UFS_QCOM_LIMIT_HSGEAR_RX	UFS_HS_G3
39 #define UFS_QCOM_LIMIT_HSGEAR_TX	UFS_HS_G3
40 #define UFS_QCOM_LIMIT_PWMGEAR_RX	UFS_PWM_G4
41 #define UFS_QCOM_LIMIT_PWMGEAR_TX	UFS_PWM_G4
42 #define UFS_QCOM_LIMIT_RX_PWR_PWM	SLOW_MODE
43 #define UFS_QCOM_LIMIT_TX_PWR_PWM	SLOW_MODE
44 #define UFS_QCOM_LIMIT_RX_PWR_HS	FAST_MODE
45 #define UFS_QCOM_LIMIT_TX_PWR_HS	FAST_MODE
46 #define UFS_QCOM_LIMIT_HS_RATE		PA_HS_MODE_B
47 #define UFS_QCOM_LIMIT_DESIRED_MODE	FAST
48 
49 /* QCOM UFS host controller vendor specific registers */
50 enum {
51 	REG_UFS_SYS1CLK_1US                 = 0xC0,
52 	REG_UFS_TX_SYMBOL_CLK_NS_US         = 0xC4,
53 	REG_UFS_LOCAL_PORT_ID_REG           = 0xC8,
54 	REG_UFS_PA_ERR_CODE                 = 0xCC,
55 	REG_UFS_RETRY_TIMER_REG             = 0xD0,
56 	REG_UFS_PA_LINK_STARTUP_TIMER       = 0xD8,
57 	REG_UFS_CFG1                        = 0xDC,
58 	REG_UFS_CFG2                        = 0xE0,
59 	REG_UFS_HW_VERSION                  = 0xE4,
60 
61 	UFS_TEST_BUS				= 0xE8,
62 	UFS_TEST_BUS_CTRL_0			= 0xEC,
63 	UFS_TEST_BUS_CTRL_1			= 0xF0,
64 	UFS_TEST_BUS_CTRL_2			= 0xF4,
65 	UFS_UNIPRO_CFG				= 0xF8,
66 
67 	/*
68 	 * QCOM UFS host controller vendor specific registers
69 	 * added in HW Version 3.0.0
70 	 */
71 	UFS_AH8_CFG				= 0xFC,
72 };
73 
74 /* QCOM UFS host controller vendor specific debug registers */
75 enum {
76 	UFS_DBG_RD_REG_UAWM			= 0x100,
77 	UFS_DBG_RD_REG_UARM			= 0x200,
78 	UFS_DBG_RD_REG_TXUC			= 0x300,
79 	UFS_DBG_RD_REG_RXUC			= 0x400,
80 	UFS_DBG_RD_REG_DFC			= 0x500,
81 	UFS_DBG_RD_REG_TRLUT			= 0x600,
82 	UFS_DBG_RD_REG_TMRLUT			= 0x700,
83 	UFS_UFS_DBG_RD_REG_OCSC			= 0x800,
84 
85 	UFS_UFS_DBG_RD_DESC_RAM			= 0x1500,
86 	UFS_UFS_DBG_RD_PRDT_RAM			= 0x1700,
87 	UFS_UFS_DBG_RD_RESP_RAM			= 0x1800,
88 	UFS_UFS_DBG_RD_EDTL_RAM			= 0x1900,
89 };
90 
91 #define UFS_CNTLR_2_x_x_VEN_REGS_OFFSET(x)	(0x000 + x)
92 #define UFS_CNTLR_3_x_x_VEN_REGS_OFFSET(x)	(0x400 + x)
93 
94 /* bit definitions for REG_UFS_CFG1 register */
95 #define QUNIPRO_SEL		0x1
96 #define UTP_DBG_RAMS_EN		0x20000
97 #define TEST_BUS_EN		BIT(18)
98 #define TEST_BUS_SEL		GENMASK(22, 19)
99 #define UFS_REG_TEST_BUS_EN	BIT(30)
100 
101 /* bit definitions for REG_UFS_CFG2 register */
102 #define UAWM_HW_CGC_EN		(1 << 0)
103 #define UARM_HW_CGC_EN		(1 << 1)
104 #define TXUC_HW_CGC_EN		(1 << 2)
105 #define RXUC_HW_CGC_EN		(1 << 3)
106 #define DFC_HW_CGC_EN		(1 << 4)
107 #define TRLUT_HW_CGC_EN		(1 << 5)
108 #define TMRLUT_HW_CGC_EN	(1 << 6)
109 #define OCSC_HW_CGC_EN		(1 << 7)
110 
111 /* bit definition for UFS_UFS_TEST_BUS_CTRL_n */
112 #define TEST_BUS_SUB_SEL_MASK	0x1F  /* All XXX_SEL fields are 5 bits wide */
113 
114 #define REG_UFS_CFG2_CGC_EN_ALL (UAWM_HW_CGC_EN | UARM_HW_CGC_EN |\
115 				 TXUC_HW_CGC_EN | RXUC_HW_CGC_EN |\
116 				 DFC_HW_CGC_EN | TRLUT_HW_CGC_EN |\
117 				 TMRLUT_HW_CGC_EN | OCSC_HW_CGC_EN)
118 
119 /* bit offset */
120 enum {
121 	OFFSET_UFS_PHY_SOFT_RESET           = 1,
122 	OFFSET_CLK_NS_REG                   = 10,
123 };
124 
125 /* bit masks */
126 enum {
127 	MASK_UFS_PHY_SOFT_RESET             = 0x2,
128 	MASK_TX_SYMBOL_CLK_1US_REG          = 0x3FF,
129 	MASK_CLK_NS_REG                     = 0xFFFC00,
130 };
131 
132 enum ufs_qcom_phy_init_type {
133 	UFS_PHY_INIT_FULL,
134 	UFS_PHY_INIT_CFG_RESTORE,
135 };
136 
137 /* QCOM UFS debug print bit mask */
138 #define UFS_QCOM_DBG_PRINT_REGS_EN	BIT(0)
139 #define UFS_QCOM_DBG_PRINT_ICE_REGS_EN	BIT(1)
140 #define UFS_QCOM_DBG_PRINT_TEST_BUS_EN	BIT(2)
141 
142 #define UFS_QCOM_DBG_PRINT_ALL	\
143 	(UFS_QCOM_DBG_PRINT_REGS_EN | UFS_QCOM_DBG_PRINT_ICE_REGS_EN | \
144 	 UFS_QCOM_DBG_PRINT_TEST_BUS_EN)
145 
146 /* QUniPro Vendor specific attributes */
147 #define PA_VS_CONFIG_REG1	0x9000
148 #define DME_VS_CORE_CLK_CTRL	0xD002
149 /* bit and mask definitions for DME_VS_CORE_CLK_CTRL attribute */
150 #define DME_VS_CORE_CLK_CTRL_CORE_CLK_DIV_EN_BIT		BIT(8)
151 #define DME_VS_CORE_CLK_CTRL_MAX_CORE_CLK_1US_CYCLES_MASK	0xFF
152 
153 static inline void
ufs_qcom_get_controller_revision(struct ufs_hba * hba,u8 * major,u16 * minor,u16 * step)154 ufs_qcom_get_controller_revision(struct ufs_hba *hba,
155 				 u8 *major, u16 *minor, u16 *step)
156 {
157 	u32 ver = ufshcd_readl(hba, REG_UFS_HW_VERSION);
158 
159 	*major = (ver & UFS_HW_VER_MAJOR_MASK) >> UFS_HW_VER_MAJOR_SHFT;
160 	*minor = (ver & UFS_HW_VER_MINOR_MASK) >> UFS_HW_VER_MINOR_SHFT;
161 	*step = (ver & UFS_HW_VER_STEP_MASK) >> UFS_HW_VER_STEP_SHFT;
162 };
163 
ufs_qcom_assert_reset(struct ufs_hba * hba)164 static inline void ufs_qcom_assert_reset(struct ufs_hba *hba)
165 {
166 	ufshcd_rmwl(hba, MASK_UFS_PHY_SOFT_RESET,
167 			1 << OFFSET_UFS_PHY_SOFT_RESET, REG_UFS_CFG1);
168 
169 	/*
170 	 * Make sure assertion of ufs phy reset is written to
171 	 * register before returning
172 	 */
173 	mb();
174 }
175 
ufs_qcom_deassert_reset(struct ufs_hba * hba)176 static inline void ufs_qcom_deassert_reset(struct ufs_hba *hba)
177 {
178 	ufshcd_rmwl(hba, MASK_UFS_PHY_SOFT_RESET,
179 			0 << OFFSET_UFS_PHY_SOFT_RESET, REG_UFS_CFG1);
180 
181 	/*
182 	 * Make sure de-assertion of ufs phy reset is written to
183 	 * register before returning
184 	 */
185 	mb();
186 }
187 
188 struct ufs_qcom_bus_vote {
189 	uint32_t client_handle;
190 	uint32_t curr_vote;
191 	int min_bw_vote;
192 	int max_bw_vote;
193 	int saved_vote;
194 	bool is_max_bw_needed;
195 	struct device_attribute max_bus_bw;
196 };
197 
198 /* Host controller hardware version: major.minor.step */
199 struct ufs_hw_version {
200 	u16 step;
201 	u16 minor;
202 	u8 major;
203 };
204 
205 struct ufs_qcom_testbus {
206 	u8 select_major;
207 	u8 select_minor;
208 };
209 
210 struct ufs_qcom_host {
211 	/*
212 	 * Set this capability if host controller supports the QUniPro mode
213 	 * and if driver wants the Host controller to operate in QUniPro mode.
214 	 * Note: By default this capability will be kept enabled if host
215 	 * controller supports the QUniPro mode.
216 	 */
217 	#define UFS_QCOM_CAP_QUNIPRO	0x1
218 
219 	/*
220 	 * Set this capability if host controller can retain the secure
221 	 * configuration even after UFS controller core power collapse.
222 	 */
223 	#define UFS_QCOM_CAP_RETAIN_SEC_CFG_AFTER_PWR_COLLAPSE	0x2
224 	u32 caps;
225 
226 	struct phy *generic_phy;
227 	struct ufs_hba *hba;
228 	struct ufs_qcom_bus_vote bus_vote;
229 	struct ufs_pa_layer_attr dev_req_params;
230 	struct clk *rx_l0_sync_clk;
231 	struct clk *tx_l0_sync_clk;
232 	struct clk *rx_l1_sync_clk;
233 	struct clk *tx_l1_sync_clk;
234 	bool is_lane_clks_enabled;
235 
236 	void __iomem *dev_ref_clk_ctrl_mmio;
237 	bool is_dev_ref_clk_enabled;
238 	struct ufs_hw_version hw_ver;
239 
240 	u32 dev_ref_clk_en_mask;
241 
242 	/* Bitmask for enabling debug prints */
243 	u32 dbg_print_en;
244 	struct ufs_qcom_testbus testbus;
245 };
246 
247 static inline u32
ufs_qcom_get_debug_reg_offset(struct ufs_qcom_host * host,u32 reg)248 ufs_qcom_get_debug_reg_offset(struct ufs_qcom_host *host, u32 reg)
249 {
250 	if (host->hw_ver.major <= 0x02)
251 		return UFS_CNTLR_2_x_x_VEN_REGS_OFFSET(reg);
252 
253 	return UFS_CNTLR_3_x_x_VEN_REGS_OFFSET(reg);
254 };
255 
256 #define ufs_qcom_is_link_off(hba) ufshcd_is_link_off(hba)
257 #define ufs_qcom_is_link_active(hba) ufshcd_is_link_active(hba)
258 #define ufs_qcom_is_link_hibern8(hba) ufshcd_is_link_hibern8(hba)
259 
260 int ufs_qcom_testbus_config(struct ufs_qcom_host *host);
261 
ufs_qcom_cap_qunipro(struct ufs_qcom_host * host)262 static inline bool ufs_qcom_cap_qunipro(struct ufs_qcom_host *host)
263 {
264 	if (host->caps & UFS_QCOM_CAP_QUNIPRO)
265 		return true;
266 	else
267 		return false;
268 }
269 
270 #endif /* UFS_QCOM_H_ */
271