1 /* SPDX-License-Identifier: GPL-2.0 */
2 /* Copyright (C) 2021, Intel Corporation. */
3
4 #ifndef _ICE_PTP_HW_H_
5 #define _ICE_PTP_HW_H_
6
7 enum ice_ptp_tmr_cmd {
8 INIT_TIME,
9 INIT_INCVAL,
10 ADJ_TIME,
11 ADJ_TIME_AT_TIME,
12 READ_TIME,
13 ICE_PTP_NOP,
14 };
15
16 enum ice_ptp_serdes {
17 ICE_PTP_SERDES_1G,
18 ICE_PTP_SERDES_10G,
19 ICE_PTP_SERDES_25G,
20 ICE_PTP_SERDES_40G,
21 ICE_PTP_SERDES_50G,
22 ICE_PTP_SERDES_100G
23 };
24
25 enum ice_ptp_link_spd {
26 ICE_PTP_LNK_SPD_1G,
27 ICE_PTP_LNK_SPD_10G,
28 ICE_PTP_LNK_SPD_25G,
29 ICE_PTP_LNK_SPD_25G_RS,
30 ICE_PTP_LNK_SPD_40G,
31 ICE_PTP_LNK_SPD_50G,
32 ICE_PTP_LNK_SPD_50G_RS,
33 ICE_PTP_LNK_SPD_100G_RS,
34 NUM_ICE_PTP_LNK_SPD /* Must be last */
35 };
36
37 enum ice_ptp_fec_mode {
38 ICE_PTP_FEC_MODE_NONE,
39 ICE_PTP_FEC_MODE_CLAUSE74,
40 ICE_PTP_FEC_MODE_RS_FEC
41 };
42
43 /**
44 * struct ice_time_ref_info_e822
45 * @pll_freq: Frequency of PLL that drives timer ticks in Hz
46 * @nominal_incval: increment to generate nanoseconds in GLTSYN_TIME_L
47 * @pps_delay: propagation delay of the PPS output signal
48 *
49 * Characteristic information for the various TIME_REF sources possible in the
50 * E822 devices
51 */
52 struct ice_time_ref_info_e822 {
53 u64 pll_freq;
54 u64 nominal_incval;
55 u8 pps_delay;
56 };
57
58 /**
59 * struct ice_vernier_info_e822
60 * @tx_par_clk: Frequency used to calculate P_REG_PAR_TX_TUS
61 * @rx_par_clk: Frequency used to calculate P_REG_PAR_RX_TUS
62 * @tx_pcs_clk: Frequency used to calculate P_REG_PCS_TX_TUS
63 * @rx_pcs_clk: Frequency used to calculate P_REG_PCS_RX_TUS
64 * @tx_desk_rsgb_par: Frequency used to calculate P_REG_DESK_PAR_TX_TUS
65 * @rx_desk_rsgb_par: Frequency used to calculate P_REG_DESK_PAR_RX_TUS
66 * @tx_desk_rsgb_pcs: Frequency used to calculate P_REG_DESK_PCS_TX_TUS
67 * @rx_desk_rsgb_pcs: Frequency used to calculate P_REG_DESK_PCS_RX_TUS
68 * @tx_fixed_delay: Fixed Tx latency measured in 1/100th nanoseconds
69 * @pmd_adj_divisor: Divisor used to calculate PDM alignment adjustment
70 * @rx_fixed_delay: Fixed Rx latency measured in 1/100th nanoseconds
71 *
72 * Table of constants used during as part of the Vernier calibration of the Tx
73 * and Rx timestamps. This includes frequency values used to compute TUs per
74 * PAR/PCS clock cycle, and static delay values measured during hardware
75 * design.
76 *
77 * Note that some values are not used for all link speeds, and the
78 * P_REG_DESK_PAR* registers may represent different clock markers at
79 * different link speeds, either the deskew marker for multi-lane link speeds
80 * or the Reed Solomon gearbox marker for RS-FEC.
81 */
82 struct ice_vernier_info_e822 {
83 u32 tx_par_clk;
84 u32 rx_par_clk;
85 u32 tx_pcs_clk;
86 u32 rx_pcs_clk;
87 u32 tx_desk_rsgb_par;
88 u32 rx_desk_rsgb_par;
89 u32 tx_desk_rsgb_pcs;
90 u32 rx_desk_rsgb_pcs;
91 u32 tx_fixed_delay;
92 u32 pmd_adj_divisor;
93 u32 rx_fixed_delay;
94 };
95
96 /**
97 * struct ice_cgu_pll_params_e822
98 * @refclk_pre_div: Reference clock pre-divisor
99 * @feedback_div: Feedback divisor
100 * @frac_n_div: Fractional divisor
101 * @post_pll_div: Post PLL divisor
102 *
103 * Clock Generation Unit parameters used to program the PLL based on the
104 * selected TIME_REF frequency.
105 */
106 struct ice_cgu_pll_params_e822 {
107 u32 refclk_pre_div;
108 u32 feedback_div;
109 u32 frac_n_div;
110 u32 post_pll_div;
111 };
112
113 extern const struct
114 ice_cgu_pll_params_e822 e822_cgu_params[NUM_ICE_TIME_REF_FREQ];
115
116 /* Table of constants related to possible TIME_REF sources */
117 extern const struct ice_time_ref_info_e822 e822_time_ref[NUM_ICE_TIME_REF_FREQ];
118
119 /* Table of constants for Vernier calibration on E822 */
120 extern const struct ice_vernier_info_e822 e822_vernier[NUM_ICE_PTP_LNK_SPD];
121
122 /* Increment value to generate nanoseconds in the GLTSYN_TIME_L register for
123 * the E810 devices. Based off of a PLL with an 812.5 MHz frequency.
124 */
125 #define ICE_PTP_NOMINAL_INCVAL_E810 0x13b13b13bULL
126
127 /* Device agnostic functions */
128 u8 ice_get_ptp_src_clock_index(struct ice_hw *hw);
129 bool ice_ptp_lock(struct ice_hw *hw);
130 void ice_ptp_unlock(struct ice_hw *hw);
131 int ice_ptp_init_time(struct ice_hw *hw, u64 time);
132 int ice_ptp_write_incval(struct ice_hw *hw, u64 incval);
133 int ice_ptp_write_incval_locked(struct ice_hw *hw, u64 incval);
134 int ice_ptp_adj_clock(struct ice_hw *hw, s32 adj);
135 int ice_read_phy_tstamp(struct ice_hw *hw, u8 block, u8 idx, u64 *tstamp);
136 int ice_clear_phy_tstamp(struct ice_hw *hw, u8 block, u8 idx);
137 int ice_ptp_init_phc(struct ice_hw *hw);
138
139 /* E822 family functions */
140 int ice_read_phy_reg_e822(struct ice_hw *hw, u8 port, u16 offset, u32 *val);
141 int ice_write_phy_reg_e822(struct ice_hw *hw, u8 port, u16 offset, u32 val);
142 int ice_read_quad_reg_e822(struct ice_hw *hw, u8 quad, u16 offset, u32 *val);
143 int ice_write_quad_reg_e822(struct ice_hw *hw, u8 quad, u16 offset, u32 val);
144 int ice_ptp_prep_port_adj_e822(struct ice_hw *hw, u8 port, s64 time);
145
146 /**
147 * ice_e822_time_ref - Get the current TIME_REF from capabilities
148 * @hw: pointer to the HW structure
149 *
150 * Returns the current TIME_REF from the capabilities structure.
151 */
ice_e822_time_ref(struct ice_hw * hw)152 static inline enum ice_time_ref_freq ice_e822_time_ref(struct ice_hw *hw)
153 {
154 return hw->func_caps.ts_func_info.time_ref;
155 }
156
157 /**
158 * ice_set_e822_time_ref - Set new TIME_REF
159 * @hw: pointer to the HW structure
160 * @time_ref: new TIME_REF to set
161 *
162 * Update the TIME_REF in the capabilities structure in response to some
163 * change, such as an update to the CGU registers.
164 */
165 static inline void
ice_set_e822_time_ref(struct ice_hw * hw,enum ice_time_ref_freq time_ref)166 ice_set_e822_time_ref(struct ice_hw *hw, enum ice_time_ref_freq time_ref)
167 {
168 hw->func_caps.ts_func_info.time_ref = time_ref;
169 }
170
ice_e822_pll_freq(enum ice_time_ref_freq time_ref)171 static inline u64 ice_e822_pll_freq(enum ice_time_ref_freq time_ref)
172 {
173 return e822_time_ref[time_ref].pll_freq;
174 }
175
ice_e822_nominal_incval(enum ice_time_ref_freq time_ref)176 static inline u64 ice_e822_nominal_incval(enum ice_time_ref_freq time_ref)
177 {
178 return e822_time_ref[time_ref].nominal_incval;
179 }
180
ice_e822_pps_delay(enum ice_time_ref_freq time_ref)181 static inline u64 ice_e822_pps_delay(enum ice_time_ref_freq time_ref)
182 {
183 return e822_time_ref[time_ref].pps_delay;
184 }
185
186 /* E822 Vernier calibration functions */
187 int ice_stop_phy_timer_e822(struct ice_hw *hw, u8 port, bool soft_reset);
188 int ice_start_phy_timer_e822(struct ice_hw *hw, u8 port, bool bypass);
189 int ice_phy_exit_bypass_e822(struct ice_hw *hw, u8 port);
190
191 /* E810 family functions */
192 int ice_ptp_init_phy_e810(struct ice_hw *hw);
193 int ice_read_sma_ctrl_e810t(struct ice_hw *hw, u8 *data);
194 int ice_write_sma_ctrl_e810t(struct ice_hw *hw, u8 data);
195 int ice_read_pca9575_reg_e810t(struct ice_hw *hw, u8 offset, u8 *data);
196 bool ice_is_pca9575_present(struct ice_hw *hw);
197
198 #define PFTSYN_SEM_BYTES 4
199
200 #define ICE_PTP_CLOCK_INDEX_0 0x00
201 #define ICE_PTP_CLOCK_INDEX_1 0x01
202
203 /* PHY timer commands */
204 #define SEL_CPK_SRC 8
205 #define SEL_PHY_SRC 3
206
207 /* Time Sync command Definitions */
208 #define GLTSYN_CMD_INIT_TIME BIT(0)
209 #define GLTSYN_CMD_INIT_INCVAL BIT(1)
210 #define GLTSYN_CMD_INIT_TIME_INCVAL (BIT(0) | BIT(1))
211 #define GLTSYN_CMD_ADJ_TIME BIT(2)
212 #define GLTSYN_CMD_ADJ_INIT_TIME (BIT(2) | BIT(3))
213 #define GLTSYN_CMD_READ_TIME BIT(7)
214
215 /* PHY port Time Sync command definitions */
216 #define PHY_CMD_INIT_TIME BIT(0)
217 #define PHY_CMD_INIT_INCVAL BIT(1)
218 #define PHY_CMD_ADJ_TIME (BIT(0) | BIT(1))
219 #define PHY_CMD_ADJ_TIME_AT_TIME (BIT(0) | BIT(2))
220 #define PHY_CMD_READ_TIME (BIT(0) | BIT(1) | BIT(2))
221
222 #define TS_CMD_MASK_E810 0xFF
223 #define TS_CMD_MASK 0xF
224 #define SYNC_EXEC_CMD 0x3
225
226 /* Macros to derive port low and high addresses on both quads */
227 #define P_Q0_L(a, p) ((((a) + (0x2000 * (p)))) & 0xFFFF)
228 #define P_Q0_H(a, p) ((((a) + (0x2000 * (p)))) >> 16)
229 #define P_Q1_L(a, p) ((((a) - (0x2000 * ((p) - ICE_PORTS_PER_QUAD)))) & 0xFFFF)
230 #define P_Q1_H(a, p) ((((a) - (0x2000 * ((p) - ICE_PORTS_PER_QUAD)))) >> 16)
231
232 /* PHY QUAD register base addresses */
233 #define Q_0_BASE 0x94000
234 #define Q_1_BASE 0x114000
235
236 /* Timestamp memory reset registers */
237 #define Q_REG_TS_CTRL 0x618
238 #define Q_REG_TS_CTRL_S 0
239 #define Q_REG_TS_CTRL_M BIT(0)
240
241 /* Timestamp availability status registers */
242 #define Q_REG_TX_MEMORY_STATUS_L 0xCF0
243 #define Q_REG_TX_MEMORY_STATUS_U 0xCF4
244
245 /* Tx FIFO status registers */
246 #define Q_REG_FIFO23_STATUS 0xCF8
247 #define Q_REG_FIFO01_STATUS 0xCFC
248 #define Q_REG_FIFO02_S 0
249 #define Q_REG_FIFO02_M ICE_M(0x3FF, 0)
250 #define Q_REG_FIFO13_S 10
251 #define Q_REG_FIFO13_M ICE_M(0x3FF, 10)
252
253 /* Interrupt control Config registers */
254 #define Q_REG_TX_MEM_GBL_CFG 0xC08
255 #define Q_REG_TX_MEM_GBL_CFG_LANE_TYPE_S 0
256 #define Q_REG_TX_MEM_GBL_CFG_LANE_TYPE_M BIT(0)
257 #define Q_REG_TX_MEM_GBL_CFG_TX_TYPE_S 1
258 #define Q_REG_TX_MEM_GBL_CFG_TX_TYPE_M ICE_M(0xFF, 1)
259 #define Q_REG_TX_MEM_GBL_CFG_INTR_THR_S 9
260 #define Q_REG_TX_MEM_GBL_CFG_INTR_THR_M ICE_M(0x3F, 9)
261 #define Q_REG_TX_MEM_GBL_CFG_INTR_ENA_S 15
262 #define Q_REG_TX_MEM_GBL_CFG_INTR_ENA_M BIT(15)
263
264 /* Tx Timestamp data registers */
265 #define Q_REG_TX_MEMORY_BANK_START 0xA00
266
267 /* PHY port register base addresses */
268 #define P_0_BASE 0x80000
269 #define P_4_BASE 0x106000
270
271 /* Timestamp init registers */
272 #define P_REG_RX_TIMER_INC_PRE_L 0x46C
273 #define P_REG_RX_TIMER_INC_PRE_U 0x470
274 #define P_REG_TX_TIMER_INC_PRE_L 0x44C
275 #define P_REG_TX_TIMER_INC_PRE_U 0x450
276
277 /* Timestamp match and adjust target registers */
278 #define P_REG_RX_TIMER_CNT_ADJ_L 0x474
279 #define P_REG_RX_TIMER_CNT_ADJ_U 0x478
280 #define P_REG_TX_TIMER_CNT_ADJ_L 0x454
281 #define P_REG_TX_TIMER_CNT_ADJ_U 0x458
282
283 /* Timestamp capture registers */
284 #define P_REG_RX_CAPTURE_L 0x4D8
285 #define P_REG_RX_CAPTURE_U 0x4DC
286 #define P_REG_TX_CAPTURE_L 0x4B4
287 #define P_REG_TX_CAPTURE_U 0x4B8
288
289 /* Timestamp PHY incval registers */
290 #define P_REG_TIMETUS_L 0x410
291 #define P_REG_TIMETUS_U 0x414
292
293 #define P_REG_40B_LOW_M 0xFF
294 #define P_REG_40B_HIGH_S 8
295
296 /* PHY window length registers */
297 #define P_REG_WL 0x40C
298
299 #define PTP_VERNIER_WL 0x111ed
300
301 /* PHY start registers */
302 #define P_REG_PS 0x408
303 #define P_REG_PS_START_S 0
304 #define P_REG_PS_START_M BIT(0)
305 #define P_REG_PS_BYPASS_MODE_S 1
306 #define P_REG_PS_BYPASS_MODE_M BIT(1)
307 #define P_REG_PS_ENA_CLK_S 2
308 #define P_REG_PS_ENA_CLK_M BIT(2)
309 #define P_REG_PS_LOAD_OFFSET_S 3
310 #define P_REG_PS_LOAD_OFFSET_M BIT(3)
311 #define P_REG_PS_SFT_RESET_S 11
312 #define P_REG_PS_SFT_RESET_M BIT(11)
313
314 /* PHY offset valid registers */
315 #define P_REG_TX_OV_STATUS 0x4D4
316 #define P_REG_TX_OV_STATUS_OV_S 0
317 #define P_REG_TX_OV_STATUS_OV_M BIT(0)
318 #define P_REG_RX_OV_STATUS 0x4F8
319 #define P_REG_RX_OV_STATUS_OV_S 0
320 #define P_REG_RX_OV_STATUS_OV_M BIT(0)
321
322 /* PHY offset ready registers */
323 #define P_REG_TX_OR 0x45C
324 #define P_REG_RX_OR 0x47C
325
326 /* PHY total offset registers */
327 #define P_REG_TOTAL_RX_OFFSET_L 0x460
328 #define P_REG_TOTAL_RX_OFFSET_U 0x464
329 #define P_REG_TOTAL_TX_OFFSET_L 0x440
330 #define P_REG_TOTAL_TX_OFFSET_U 0x444
331
332 /* Timestamp PAR/PCS registers */
333 #define P_REG_UIX66_10G_40G_L 0x480
334 #define P_REG_UIX66_10G_40G_U 0x484
335 #define P_REG_UIX66_25G_100G_L 0x488
336 #define P_REG_UIX66_25G_100G_U 0x48C
337 #define P_REG_DESK_PAR_RX_TUS_L 0x490
338 #define P_REG_DESK_PAR_RX_TUS_U 0x494
339 #define P_REG_DESK_PAR_TX_TUS_L 0x498
340 #define P_REG_DESK_PAR_TX_TUS_U 0x49C
341 #define P_REG_DESK_PCS_RX_TUS_L 0x4A0
342 #define P_REG_DESK_PCS_RX_TUS_U 0x4A4
343 #define P_REG_DESK_PCS_TX_TUS_L 0x4A8
344 #define P_REG_DESK_PCS_TX_TUS_U 0x4AC
345 #define P_REG_PAR_RX_TUS_L 0x420
346 #define P_REG_PAR_RX_TUS_U 0x424
347 #define P_REG_PAR_TX_TUS_L 0x428
348 #define P_REG_PAR_TX_TUS_U 0x42C
349 #define P_REG_PCS_RX_TUS_L 0x430
350 #define P_REG_PCS_RX_TUS_U 0x434
351 #define P_REG_PCS_TX_TUS_L 0x438
352 #define P_REG_PCS_TX_TUS_U 0x43C
353 #define P_REG_PAR_RX_TIME_L 0x4F0
354 #define P_REG_PAR_RX_TIME_U 0x4F4
355 #define P_REG_PAR_TX_TIME_L 0x4CC
356 #define P_REG_PAR_TX_TIME_U 0x4D0
357 #define P_REG_PAR_PCS_RX_OFFSET_L 0x4E8
358 #define P_REG_PAR_PCS_RX_OFFSET_U 0x4EC
359 #define P_REG_PAR_PCS_TX_OFFSET_L 0x4C4
360 #define P_REG_PAR_PCS_TX_OFFSET_U 0x4C8
361 #define P_REG_LINK_SPEED 0x4FC
362 #define P_REG_LINK_SPEED_SERDES_S 0
363 #define P_REG_LINK_SPEED_SERDES_M ICE_M(0x7, 0)
364 #define P_REG_LINK_SPEED_FEC_MODE_S 3
365 #define P_REG_LINK_SPEED_FEC_MODE_M ICE_M(0x3, 3)
366 #define P_REG_LINK_SPEED_FEC_MODE(reg) \
367 (((reg) & P_REG_LINK_SPEED_FEC_MODE_M) >> \
368 P_REG_LINK_SPEED_FEC_MODE_S)
369
370 /* PHY timestamp related registers */
371 #define P_REG_PMD_ALIGNMENT 0x0FC
372 #define P_REG_RX_80_TO_160_CNT 0x6FC
373 #define P_REG_RX_80_TO_160_CNT_RXCYC_S 0
374 #define P_REG_RX_80_TO_160_CNT_RXCYC_M BIT(0)
375 #define P_REG_RX_40_TO_160_CNT 0x8FC
376 #define P_REG_RX_40_TO_160_CNT_RXCYC_S 0
377 #define P_REG_RX_40_TO_160_CNT_RXCYC_M ICE_M(0x3, 0)
378
379 /* Rx FIFO status registers */
380 #define P_REG_RX_OV_FS 0x4F8
381 #define P_REG_RX_OV_FS_FIFO_STATUS_S 2
382 #define P_REG_RX_OV_FS_FIFO_STATUS_M ICE_M(0x3FF, 2)
383
384 /* Timestamp command registers */
385 #define P_REG_TX_TMR_CMD 0x448
386 #define P_REG_RX_TMR_CMD 0x468
387
388 /* E810 timesync enable register */
389 #define ETH_GLTSYN_ENA(_i) (0x03000348 + ((_i) * 4))
390
391 /* E810 shadow init time registers */
392 #define ETH_GLTSYN_SHTIME_0(i) (0x03000368 + ((i) * 32))
393 #define ETH_GLTSYN_SHTIME_L(i) (0x0300036C + ((i) * 32))
394
395 /* E810 shadow time adjust registers */
396 #define ETH_GLTSYN_SHADJ_L(_i) (0x03000378 + ((_i) * 32))
397 #define ETH_GLTSYN_SHADJ_H(_i) (0x0300037C + ((_i) * 32))
398
399 /* E810 timer command register */
400 #define ETH_GLTSYN_CMD 0x03000344
401
402 /* Source timer incval macros */
403 #define INCVAL_HIGH_M 0xFF
404
405 /* Timestamp block macros */
406 #define TS_VALID BIT(0)
407 #define TS_LOW_M 0xFFFFFFFF
408 #define TS_HIGH_M 0xFF
409 #define TS_HIGH_S 32
410
411 #define TS_PHY_LOW_M 0xFF
412 #define TS_PHY_HIGH_M 0xFFFFFFFF
413 #define TS_PHY_HIGH_S 8
414
415 #define BYTES_PER_IDX_ADDR_L_U 8
416 #define BYTES_PER_IDX_ADDR_L 4
417
418 /* Tx timestamp low latency read definitions */
419 #define TS_LL_READ_RETRIES 200
420 #define TS_LL_READ_TS_HIGH GENMASK(23, 16)
421 #define TS_LL_READ_TS_IDX GENMASK(29, 24)
422 #define TS_LL_READ_TS BIT(31)
423
424 /* Internal PHY timestamp address */
425 #define TS_L(a, idx) ((a) + ((idx) * BYTES_PER_IDX_ADDR_L_U))
426 #define TS_H(a, idx) ((a) + ((idx) * BYTES_PER_IDX_ADDR_L_U + \
427 BYTES_PER_IDX_ADDR_L))
428
429 /* External PHY timestamp address */
430 #define TS_EXT(a, port, idx) ((a) + (0x1000 * (port)) + \
431 ((idx) * BYTES_PER_IDX_ADDR_L_U))
432
433 #define LOW_TX_MEMORY_BANK_START 0x03090000
434 #define HIGH_TX_MEMORY_BANK_START 0x03090004
435
436 /* E810T SMA controller pin control */
437 #define ICE_SMA1_DIR_EN_E810T BIT(4)
438 #define ICE_SMA1_TX_EN_E810T BIT(5)
439 #define ICE_SMA2_UFL2_RX_DIS_E810T BIT(3)
440 #define ICE_SMA2_DIR_EN_E810T BIT(6)
441 #define ICE_SMA2_TX_EN_E810T BIT(7)
442
443 #define ICE_SMA1_MASK_E810T (ICE_SMA1_DIR_EN_E810T | \
444 ICE_SMA1_TX_EN_E810T)
445 #define ICE_SMA2_MASK_E810T (ICE_SMA2_UFL2_RX_DIS_E810T | \
446 ICE_SMA2_DIR_EN_E810T | \
447 ICE_SMA2_TX_EN_E810T)
448 #define ICE_ALL_SMA_MASK_E810T (ICE_SMA1_MASK_E810T | \
449 ICE_SMA2_MASK_E810T)
450
451 #define ICE_SMA_MIN_BIT_E810T 3
452 #define ICE_SMA_MAX_BIT_E810T 7
453 #define ICE_PCA9575_P1_OFFSET 8
454
455 /* E810T PCA9575 IO controller registers */
456 #define ICE_PCA9575_P0_IN 0x0
457
458 /* E810T PCA9575 IO controller pin control */
459 #define ICE_E810T_P0_GNSS_PRSNT_N BIT(4)
460
461 #endif /* _ICE_PTP_HW_H_ */
462