xref: /linux/drivers/thunderbolt/tb_regs.h (revision 0e9b70c1e3623fa110fb6be553e644524228ef60)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * Thunderbolt driver - Port/Switch config area registers
4  *
5  * Every thunderbolt device consists (logically) of a switch with multiple
6  * ports. Every port contains up to four config regions (HOPS, PORT, SWITCH,
7  * COUNTERS) which are used to configure the device.
8  *
9  * Copyright (c) 2014 Andreas Noever <andreas.noever@gmail.com>
10  * Copyright (C) 2018, Intel Corporation
11  */
12 
13 #ifndef _TB_REGS
14 #define _TB_REGS
15 
16 #include <linux/types.h>
17 
18 
19 #define TB_ROUTE_SHIFT 8  /* number of bits in a port entry of a route */
20 
21 
22 /*
23  * TODO: should be 63? But we do not know how to receive frames larger than 256
24  * bytes at the frame level. (header + checksum = 16, 60*4 = 240)
25  */
26 #define TB_MAX_CONFIG_RW_LENGTH 60
27 
28 enum tb_switch_cap {
29 	TB_SWITCH_CAP_TMU		= 0x03,
30 	TB_SWITCH_CAP_VSE		= 0x05,
31 };
32 
33 enum tb_switch_vse_cap {
34 	TB_VSE_CAP_PLUG_EVENTS		= 0x01, /* also EEPROM */
35 	TB_VSE_CAP_TIME2		= 0x03,
36 	TB_VSE_CAP_CP_LP		= 0x04,
37 	TB_VSE_CAP_LINK_CONTROLLER	= 0x06, /* also IECS */
38 };
39 
40 enum tb_port_cap {
41 	TB_PORT_CAP_PHY			= 0x01,
42 	TB_PORT_CAP_POWER		= 0x02,
43 	TB_PORT_CAP_TIME1		= 0x03,
44 	TB_PORT_CAP_ADAP		= 0x04,
45 	TB_PORT_CAP_VSE			= 0x05,
46 	TB_PORT_CAP_USB4		= 0x06,
47 };
48 
49 enum tb_port_state {
50 	TB_PORT_DISABLED	= 0, /* tb_cap_phy.disable == 1 */
51 	TB_PORT_CONNECTING	= 1, /* retry */
52 	TB_PORT_UP		= 2,
53 	TB_PORT_TX_CL0S		= 3,
54 	TB_PORT_RX_CL0S		= 4,
55 	TB_PORT_CL1		= 5,
56 	TB_PORT_CL2		= 6,
57 	TB_PORT_UNPLUGGED	= 7,
58 };
59 
60 /* capability headers */
61 
62 struct tb_cap_basic {
63 	u8 next;
64 	/* enum tb_cap cap:8; prevent "narrower than values of its type" */
65 	u8 cap; /* if cap == 0x05 then we have a extended capability */
66 } __packed;
67 
68 /**
69  * struct tb_cap_extended_short - Switch extended short capability
70  * @next: Pointer to the next capability. If @next and @length are zero
71  *	  then we have a long cap.
72  * @cap: Base capability ID (see &enum tb_switch_cap)
73  * @vsec_id: Vendor specific capability ID (see &enum switch_vse_cap)
74  * @length: Length of this capability
75  */
76 struct tb_cap_extended_short {
77 	u8 next;
78 	u8 cap;
79 	u8 vsec_id;
80 	u8 length;
81 } __packed;
82 
83 /**
84  * struct tb_cap_extended_long - Switch extended long capability
85  * @zero1: This field should be zero
86  * @cap: Base capability ID (see &enum tb_switch_cap)
87  * @vsec_id: Vendor specific capability ID (see &enum switch_vse_cap)
88  * @zero2: This field should be zero
89  * @next: Pointer to the next capability
90  * @length: Length of this capability
91  */
92 struct tb_cap_extended_long {
93 	u8 zero1;
94 	u8 cap;
95 	u8 vsec_id;
96 	u8 zero2;
97 	u16 next;
98 	u16 length;
99 } __packed;
100 
101 /**
102  * struct tb_cap_any - Structure capable of hold every capability
103  * @basic: Basic capability
104  * @extended_short: Vendor specific capability
105  * @extended_long: Vendor specific extended capability
106  */
107 struct tb_cap_any {
108 	union {
109 		struct tb_cap_basic basic;
110 		struct tb_cap_extended_short extended_short;
111 		struct tb_cap_extended_long extended_long;
112 	};
113 } __packed;
114 
115 /* capabilities */
116 
117 struct tb_cap_link_controller {
118 	struct tb_cap_extended_long cap_header;
119 	u32 count:4; /* number of link controllers */
120 	u32 unknown1:4;
121 	u32 base_offset:8; /*
122 			    * offset (into this capability) of the configuration
123 			    * area of the first link controller
124 			    */
125 	u32 length:12; /* link controller configuration area length */
126 	u32 unknown2:4; /* TODO check that length is correct */
127 } __packed;
128 
129 struct tb_cap_phy {
130 	struct tb_cap_basic cap_header;
131 	u32 unknown1:16;
132 	u32 unknown2:14;
133 	bool disable:1;
134 	u32 unknown3:11;
135 	enum tb_port_state state:4;
136 	u32 unknown4:2;
137 } __packed;
138 
139 struct tb_eeprom_ctl {
140 	bool fl_sk:1; /* send pulse to transfer one bit */
141 	bool fl_cs:1; /* set to 0 before access */
142 	bool fl_di:1; /* to eeprom */
143 	bool fl_do:1; /* from eeprom */
144 	bool bit_banging_enable:1; /* set to 1 before access */
145 	bool not_present:1; /* should be 0 */
146 	bool unknown1:1;
147 	bool present:1; /* should be 1 */
148 	u32 unknown2:24;
149 } __packed;
150 
151 struct tb_cap_plug_events {
152 	struct tb_cap_extended_short cap_header;
153 	u32 __unknown1:2; /* VSC_CS_1 */
154 	u32 plug_events:5; /* VSC_CS_1 */
155 	u32 __unknown2:25; /* VSC_CS_1 */
156 	u32 vsc_cs_2;
157 	u32 vsc_cs_3;
158 	struct tb_eeprom_ctl eeprom_ctl;
159 	u32 __unknown5[7]; /* VSC_CS_5 -> VSC_CS_11 */
160 	u32 drom_offset; /* VSC_CS_12: 32 bit register, but eeprom addresses are 16 bit */
161 } __packed;
162 
163 /* device headers */
164 
165 /* Present on port 0 in TB_CFG_SWITCH at address zero. */
166 struct tb_regs_switch_header {
167 	/* DWORD 0 */
168 	u16 vendor_id;
169 	u16 device_id;
170 	/* DWORD 1 */
171 	u32 first_cap_offset:8;
172 	u32 upstream_port_number:6;
173 	u32 max_port_number:6;
174 	u32 depth:3;
175 	u32 __unknown1:1;
176 	u32 revision:8;
177 	/* DWORD 2 */
178 	u32 route_lo;
179 	/* DWORD 3 */
180 	u32 route_hi:31;
181 	bool enabled:1;
182 	/* DWORD 4 */
183 	u32 plug_events_delay:8; /*
184 				  * RW, pause between plug events in
185 				  * milliseconds. Writing 0x00 is interpreted
186 				  * as 255ms.
187 				  */
188 	u32 cmuv:8;
189 	u32 __unknown4:8;
190 	u32 thunderbolt_version:8;
191 } __packed;
192 
193 /* USB4 version 1.0 */
194 #define USB4_VERSION_1_0			0x20
195 
196 #define ROUTER_CS_1				0x01
197 #define ROUTER_CS_4				0x04
198 #define ROUTER_CS_5				0x05
199 #define ROUTER_CS_5_SLP				BIT(0)
200 #define ROUTER_CS_5_WOP				BIT(1)
201 #define ROUTER_CS_5_WOU				BIT(2)
202 #define ROUTER_CS_5_WOD				BIT(3)
203 #define ROUTER_CS_5_C3S				BIT(23)
204 #define ROUTER_CS_5_PTO				BIT(24)
205 #define ROUTER_CS_5_UTO				BIT(25)
206 #define ROUTER_CS_5_HCO				BIT(26)
207 #define ROUTER_CS_5_CV				BIT(31)
208 #define ROUTER_CS_6				0x06
209 #define ROUTER_CS_6_SLPR			BIT(0)
210 #define ROUTER_CS_6_TNS				BIT(1)
211 #define ROUTER_CS_6_WOPS			BIT(2)
212 #define ROUTER_CS_6_WOUS			BIT(3)
213 #define ROUTER_CS_6_HCI				BIT(18)
214 #define ROUTER_CS_6_CR				BIT(25)
215 #define ROUTER_CS_7				0x07
216 #define ROUTER_CS_9				0x09
217 #define ROUTER_CS_25				0x19
218 #define ROUTER_CS_26				0x1a
219 #define ROUTER_CS_26_OPCODE_MASK		GENMASK(15, 0)
220 #define ROUTER_CS_26_STATUS_MASK		GENMASK(29, 24)
221 #define ROUTER_CS_26_STATUS_SHIFT		24
222 #define ROUTER_CS_26_ONS			BIT(30)
223 #define ROUTER_CS_26_OV				BIT(31)
224 
225 /* USB4 router operations opcodes */
226 enum usb4_switch_op {
227 	USB4_SWITCH_OP_QUERY_DP_RESOURCE = 0x10,
228 	USB4_SWITCH_OP_ALLOC_DP_RESOURCE = 0x11,
229 	USB4_SWITCH_OP_DEALLOC_DP_RESOURCE = 0x12,
230 	USB4_SWITCH_OP_NVM_WRITE = 0x20,
231 	USB4_SWITCH_OP_NVM_AUTH = 0x21,
232 	USB4_SWITCH_OP_NVM_READ = 0x22,
233 	USB4_SWITCH_OP_NVM_SET_OFFSET = 0x23,
234 	USB4_SWITCH_OP_DROM_READ = 0x24,
235 	USB4_SWITCH_OP_NVM_SECTOR_SIZE = 0x25,
236 	USB4_SWITCH_OP_BUFFER_ALLOC = 0x33,
237 };
238 
239 /* Router TMU configuration */
240 #define TMU_RTR_CS_0				0x00
241 #define TMU_RTR_CS_0_FREQ_WIND_MASK		GENMASK(26, 16)
242 #define TMU_RTR_CS_0_TD				BIT(27)
243 #define TMU_RTR_CS_0_UCAP			BIT(30)
244 #define TMU_RTR_CS_1				0x01
245 #define TMU_RTR_CS_1_LOCAL_TIME_NS_MASK		GENMASK(31, 16)
246 #define TMU_RTR_CS_1_LOCAL_TIME_NS_SHIFT	16
247 #define TMU_RTR_CS_2				0x02
248 #define TMU_RTR_CS_3				0x03
249 #define TMU_RTR_CS_3_LOCAL_TIME_NS_MASK		GENMASK(15, 0)
250 #define TMU_RTR_CS_3_TS_PACKET_INTERVAL_MASK	GENMASK(31, 16)
251 #define TMU_RTR_CS_3_TS_PACKET_INTERVAL_SHIFT	16
252 #define TMU_RTR_CS_15				0xf
253 #define TMU_RTR_CS_15_FREQ_AVG_MASK		GENMASK(5, 0)
254 #define TMU_RTR_CS_15_DELAY_AVG_MASK		GENMASK(11, 6)
255 #define TMU_RTR_CS_15_OFFSET_AVG_MASK		GENMASK(17, 12)
256 #define TMU_RTR_CS_15_ERROR_AVG_MASK		GENMASK(23, 18)
257 #define TMU_RTR_CS_22				0x16
258 #define TMU_RTR_CS_24				0x18
259 #define TMU_RTR_CS_25				0x19
260 
261 enum tb_port_type {
262 	TB_TYPE_INACTIVE	= 0x000000,
263 	TB_TYPE_PORT		= 0x000001,
264 	TB_TYPE_NHI		= 0x000002,
265 	/* TB_TYPE_ETHERNET	= 0x020000, lower order bits are not known */
266 	/* TB_TYPE_SATA		= 0x080000, lower order bits are not known */
267 	TB_TYPE_DP_HDMI_IN	= 0x0e0101,
268 	TB_TYPE_DP_HDMI_OUT	= 0x0e0102,
269 	TB_TYPE_PCIE_DOWN	= 0x100101,
270 	TB_TYPE_PCIE_UP		= 0x100102,
271 	TB_TYPE_USB3_DOWN	= 0x200101,
272 	TB_TYPE_USB3_UP		= 0x200102,
273 };
274 
275 /* Present on every port in TB_CF_PORT at address zero. */
276 struct tb_regs_port_header {
277 	/* DWORD 0 */
278 	u16 vendor_id;
279 	u16 device_id;
280 	/* DWORD 1 */
281 	u32 first_cap_offset:8;
282 	u32 max_counters:11;
283 	u32 counters_support:1;
284 	u32 __unknown1:4;
285 	u32 revision:8;
286 	/* DWORD 2 */
287 	enum tb_port_type type:24;
288 	u32 thunderbolt_version:8;
289 	/* DWORD 3 */
290 	u32 __unknown2:20;
291 	u32 port_number:6;
292 	u32 __unknown3:6;
293 	/* DWORD 4 */
294 	u32 nfc_credits;
295 	/* DWORD 5 */
296 	u32 max_in_hop_id:11;
297 	u32 max_out_hop_id:11;
298 	u32 __unknown4:10;
299 	/* DWORD 6 */
300 	u32 __unknown5;
301 	/* DWORD 7 */
302 	u32 __unknown6;
303 
304 } __packed;
305 
306 /* Basic adapter configuration registers */
307 #define ADP_CS_4				0x04
308 #define ADP_CS_4_NFC_BUFFERS_MASK		GENMASK(9, 0)
309 #define ADP_CS_4_TOTAL_BUFFERS_MASK		GENMASK(29, 20)
310 #define ADP_CS_4_TOTAL_BUFFERS_SHIFT		20
311 #define ADP_CS_4_LCK				BIT(31)
312 #define ADP_CS_5				0x05
313 #define ADP_CS_5_LCA_MASK			GENMASK(28, 22)
314 #define ADP_CS_5_LCA_SHIFT			22
315 #define ADP_CS_5_DHP				BIT(31)
316 
317 /* TMU adapter registers */
318 #define TMU_ADP_CS_3				0x03
319 #define TMU_ADP_CS_3_UDM			BIT(29)
320 #define TMU_ADP_CS_6				0x06
321 #define TMU_ADP_CS_6_DTS			BIT(1)
322 
323 /* Lane adapter registers */
324 #define LANE_ADP_CS_0				0x00
325 #define LANE_ADP_CS_0_SUPPORTED_SPEED_MASK	GENMASK(19, 16)
326 #define LANE_ADP_CS_0_SUPPORTED_SPEED_SHIFT	16
327 #define LANE_ADP_CS_0_SUPPORTED_WIDTH_MASK	GENMASK(25, 20)
328 #define LANE_ADP_CS_0_SUPPORTED_WIDTH_SHIFT	20
329 #define LANE_ADP_CS_0_SUPPORTED_WIDTH_DUAL	0x2
330 #define LANE_ADP_CS_0_CL0S_SUPPORT		BIT(26)
331 #define LANE_ADP_CS_0_CL1_SUPPORT		BIT(27)
332 #define LANE_ADP_CS_0_CL2_SUPPORT		BIT(28)
333 #define LANE_ADP_CS_1				0x01
334 #define LANE_ADP_CS_1_TARGET_SPEED_MASK		GENMASK(3, 0)
335 #define LANE_ADP_CS_1_TARGET_SPEED_GEN3		0xc
336 #define LANE_ADP_CS_1_TARGET_WIDTH_MASK		GENMASK(9, 4)
337 #define LANE_ADP_CS_1_TARGET_WIDTH_SHIFT	4
338 #define LANE_ADP_CS_1_TARGET_WIDTH_SINGLE	0x1
339 #define LANE_ADP_CS_1_TARGET_WIDTH_DUAL		0x3
340 #define LANE_ADP_CS_1_CL0S_ENABLE		BIT(10)
341 #define LANE_ADP_CS_1_CL1_ENABLE		BIT(11)
342 #define LANE_ADP_CS_1_CL2_ENABLE		BIT(12)
343 #define LANE_ADP_CS_1_LD			BIT(14)
344 #define LANE_ADP_CS_1_LB			BIT(15)
345 #define LANE_ADP_CS_1_CURRENT_SPEED_MASK	GENMASK(19, 16)
346 #define LANE_ADP_CS_1_CURRENT_SPEED_SHIFT	16
347 #define LANE_ADP_CS_1_CURRENT_SPEED_GEN2	0x8
348 #define LANE_ADP_CS_1_CURRENT_SPEED_GEN3	0x4
349 #define LANE_ADP_CS_1_CURRENT_WIDTH_MASK	GENMASK(25, 20)
350 #define LANE_ADP_CS_1_CURRENT_WIDTH_SHIFT	20
351 #define LANE_ADP_CS_1_PMS			BIT(30)
352 
353 /* USB4 port registers */
354 #define PORT_CS_1				0x01
355 #define PORT_CS_1_LENGTH_SHIFT			8
356 #define PORT_CS_1_TARGET_MASK			GENMASK(18, 16)
357 #define PORT_CS_1_TARGET_SHIFT			16
358 #define PORT_CS_1_RETIMER_INDEX_SHIFT		20
359 #define PORT_CS_1_WNR_WRITE			BIT(24)
360 #define PORT_CS_1_NR				BIT(25)
361 #define PORT_CS_1_RC				BIT(26)
362 #define PORT_CS_1_PND				BIT(31)
363 #define PORT_CS_2				0x02
364 #define PORT_CS_18				0x12
365 #define PORT_CS_18_BE				BIT(8)
366 #define PORT_CS_18_TCM				BIT(9)
367 #define PORT_CS_18_CPS				BIT(10)
368 #define PORT_CS_18_WOCS				BIT(16)
369 #define PORT_CS_18_WODS				BIT(17)
370 #define PORT_CS_18_WOU4S			BIT(18)
371 #define PORT_CS_19				0x13
372 #define PORT_CS_19_PC				BIT(3)
373 #define PORT_CS_19_PID				BIT(4)
374 #define PORT_CS_19_WOC				BIT(16)
375 #define PORT_CS_19_WOD				BIT(17)
376 #define PORT_CS_19_WOU4				BIT(18)
377 
378 /* Display Port adapter registers */
379 #define ADP_DP_CS_0				0x00
380 #define ADP_DP_CS_0_VIDEO_HOPID_MASK		GENMASK(26, 16)
381 #define ADP_DP_CS_0_VIDEO_HOPID_SHIFT		16
382 #define ADP_DP_CS_0_AE				BIT(30)
383 #define ADP_DP_CS_0_VE				BIT(31)
384 #define ADP_DP_CS_1_AUX_TX_HOPID_MASK		GENMASK(10, 0)
385 #define ADP_DP_CS_1_AUX_RX_HOPID_MASK		GENMASK(21, 11)
386 #define ADP_DP_CS_1_AUX_RX_HOPID_SHIFT		11
387 #define ADP_DP_CS_2				0x02
388 #define ADP_DP_CS_2_NRD_MLC_MASK		GENMASK(2, 0)
389 #define ADP_DP_CS_2_HDP				BIT(6)
390 #define ADP_DP_CS_2_NRD_MLR_MASK		GENMASK(9, 7)
391 #define ADP_DP_CS_2_NRD_MLR_SHIFT		7
392 #define ADP_DP_CS_2_CA				BIT(10)
393 #define ADP_DP_CS_2_GR_MASK			GENMASK(12, 11)
394 #define ADP_DP_CS_2_GR_SHIFT			11
395 #define ADP_DP_CS_2_GR_0_25G			0x0
396 #define ADP_DP_CS_2_GR_0_5G			0x1
397 #define ADP_DP_CS_2_GR_1G			0x2
398 #define ADP_DP_CS_2_GROUP_ID_MASK		GENMASK(15, 13)
399 #define ADP_DP_CS_2_GROUP_ID_SHIFT		13
400 #define ADP_DP_CS_2_CM_ID_MASK			GENMASK(19, 16)
401 #define ADP_DP_CS_2_CM_ID_SHIFT			16
402 #define ADP_DP_CS_2_CMMS			BIT(20)
403 #define ADP_DP_CS_2_ESTIMATED_BW_MASK		GENMASK(31, 24)
404 #define ADP_DP_CS_2_ESTIMATED_BW_SHIFT		24
405 #define ADP_DP_CS_3				0x03
406 #define ADP_DP_CS_3_HDPC			BIT(9)
407 #define DP_LOCAL_CAP				0x04
408 #define DP_REMOTE_CAP				0x05
409 /* For DP IN adapter */
410 #define DP_STATUS				0x06
411 #define DP_STATUS_ALLOCATED_BW_MASK		GENMASK(31, 24)
412 #define DP_STATUS_ALLOCATED_BW_SHIFT		24
413 /* For DP OUT adapter */
414 #define DP_STATUS_CTRL				0x06
415 #define DP_STATUS_CTRL_CMHS			BIT(25)
416 #define DP_STATUS_CTRL_UF			BIT(26)
417 #define DP_COMMON_CAP				0x07
418 /* Only if DP IN supports BW allocation mode */
419 #define ADP_DP_CS_8				0x08
420 #define ADP_DP_CS_8_REQUESTED_BW_MASK		GENMASK(7, 0)
421 #define ADP_DP_CS_8_DPME			BIT(30)
422 #define ADP_DP_CS_8_DR				BIT(31)
423 
424 /*
425  * DP_COMMON_CAP offsets work also for DP_LOCAL_CAP and DP_REMOTE_CAP
426  * with exception of DPRX done.
427  */
428 #define DP_COMMON_CAP_RATE_MASK			GENMASK(11, 8)
429 #define DP_COMMON_CAP_RATE_SHIFT		8
430 #define DP_COMMON_CAP_RATE_RBR			0x0
431 #define DP_COMMON_CAP_RATE_HBR			0x1
432 #define DP_COMMON_CAP_RATE_HBR2			0x2
433 #define DP_COMMON_CAP_RATE_HBR3			0x3
434 #define DP_COMMON_CAP_LANES_MASK		GENMASK(14, 12)
435 #define DP_COMMON_CAP_LANES_SHIFT		12
436 #define DP_COMMON_CAP_1_LANE			0x0
437 #define DP_COMMON_CAP_2_LANES			0x1
438 #define DP_COMMON_CAP_4_LANES			0x2
439 #define DP_COMMON_CAP_LTTPR_NS			BIT(27)
440 #define DP_COMMON_CAP_BW_MODE			BIT(28)
441 #define DP_COMMON_CAP_DPRX_DONE			BIT(31)
442 /* Only present if DP IN supports BW allocation mode */
443 #define ADP_DP_CS_8				0x08
444 #define ADP_DP_CS_8_DPME			BIT(30)
445 #define ADP_DP_CS_8_DR				BIT(31)
446 
447 /* PCIe adapter registers */
448 #define ADP_PCIE_CS_0				0x00
449 #define ADP_PCIE_CS_0_PE			BIT(31)
450 
451 /* USB adapter registers */
452 #define ADP_USB3_CS_0				0x00
453 #define ADP_USB3_CS_0_V				BIT(30)
454 #define ADP_USB3_CS_0_PE			BIT(31)
455 #define ADP_USB3_CS_1				0x01
456 #define ADP_USB3_CS_1_CUBW_MASK			GENMASK(11, 0)
457 #define ADP_USB3_CS_1_CDBW_MASK			GENMASK(23, 12)
458 #define ADP_USB3_CS_1_CDBW_SHIFT		12
459 #define ADP_USB3_CS_1_HCA			BIT(31)
460 #define ADP_USB3_CS_2				0x02
461 #define ADP_USB3_CS_2_AUBW_MASK			GENMASK(11, 0)
462 #define ADP_USB3_CS_2_ADBW_MASK			GENMASK(23, 12)
463 #define ADP_USB3_CS_2_ADBW_SHIFT		12
464 #define ADP_USB3_CS_2_CMR			BIT(31)
465 #define ADP_USB3_CS_3				0x03
466 #define ADP_USB3_CS_3_SCALE_MASK		GENMASK(5, 0)
467 #define ADP_USB3_CS_4				0x04
468 #define ADP_USB3_CS_4_ALR_MASK			GENMASK(6, 0)
469 #define ADP_USB3_CS_4_ALR_20G			0x1
470 #define ADP_USB3_CS_4_ULV			BIT(7)
471 #define ADP_USB3_CS_4_MSLR_MASK			GENMASK(18, 12)
472 #define ADP_USB3_CS_4_MSLR_SHIFT		12
473 #define ADP_USB3_CS_4_MSLR_20G			0x1
474 
475 /* Hop register from TB_CFG_HOPS. 8 byte per entry. */
476 struct tb_regs_hop {
477 	/* DWORD 0 */
478 	u32 next_hop:11; /*
479 			  * hop to take after sending the packet through
480 			  * out_port (on the incoming port of the next switch)
481 			  */
482 	u32 out_port:6; /* next port of the path (on the same switch) */
483 	u32 initial_credits:8;
484 	u32 unknown1:6; /* set to zero */
485 	bool enable:1;
486 
487 	/* DWORD 1 */
488 	u32 weight:4;
489 	u32 unknown2:4; /* set to zero */
490 	u32 priority:3;
491 	bool drop_packages:1;
492 	u32 counter:11; /* index into TB_CFG_COUNTERS on this port */
493 	bool counter_enable:1;
494 	bool ingress_fc:1;
495 	bool egress_fc:1;
496 	bool ingress_shared_buffer:1;
497 	bool egress_shared_buffer:1;
498 	bool pending:1;
499 	u32 unknown3:3; /* set to zero */
500 } __packed;
501 
502 /* TMU Thunderbolt 3 registers */
503 #define TB_TIME_VSEC_3_CS_9			0x9
504 #define TB_TIME_VSEC_3_CS_9_TMU_OBJ_MASK	GENMASK(17, 16)
505 #define TB_TIME_VSEC_3_CS_26			0x1a
506 #define TB_TIME_VSEC_3_CS_26_TD			BIT(22)
507 
508 /*
509  * Used for Titan Ridge only. Bits are part of the same register: TMU_ADP_CS_6
510  * (see above) as in USB4 spec, but these specific bits used for Titan Ridge
511  * only and reserved in USB4 spec.
512  */
513 #define TMU_ADP_CS_6_DISABLE_TMU_OBJ_MASK	GENMASK(3, 2)
514 #define TMU_ADP_CS_6_DISABLE_TMU_OBJ_CL1	BIT(2)
515 #define TMU_ADP_CS_6_DISABLE_TMU_OBJ_CL2	BIT(3)
516 
517 /* Plug Events registers */
518 #define TB_PLUG_EVENTS_USB_DISABLE		BIT(2)
519 #define TB_PLUG_EVENTS_CS_1_LANE_DISABLE	BIT(3)
520 #define TB_PLUG_EVENTS_CS_1_DPOUT_DISABLE	BIT(4)
521 #define TB_PLUG_EVENTS_CS_1_LOW_DPIN_DISABLE	BIT(5)
522 #define TB_PLUG_EVENTS_CS_1_HIGH_DPIN_DISABLE	BIT(6)
523 
524 #define TB_PLUG_EVENTS_PCIE_WR_DATA		0x1b
525 #define TB_PLUG_EVENTS_PCIE_CMD			0x1c
526 #define TB_PLUG_EVENTS_PCIE_CMD_DW_OFFSET_MASK	GENMASK(9, 0)
527 #define TB_PLUG_EVENTS_PCIE_CMD_BR_SHIFT	10
528 #define TB_PLUG_EVENTS_PCIE_CMD_BR_MASK		GENMASK(17, 10)
529 #define TB_PLUG_EVENTS_PCIE_CMD_RD_WR_MASK	BIT(21)
530 #define TB_PLUG_EVENTS_PCIE_CMD_WR		0x1
531 #define TB_PLUG_EVENTS_PCIE_CMD_COMMAND_SHIFT	22
532 #define TB_PLUG_EVENTS_PCIE_CMD_COMMAND_MASK	GENMASK(24, 22)
533 #define TB_PLUG_EVENTS_PCIE_CMD_COMMAND_VAL	0x2
534 #define TB_PLUG_EVENTS_PCIE_CMD_REQ_ACK_MASK	BIT(30)
535 #define TB_PLUG_EVENTS_PCIE_CMD_TIMEOUT_MASK	BIT(31)
536 #define TB_PLUG_EVENTS_PCIE_CMD_RD_DATA		0x1d
537 
538 /* CP Low Power registers */
539 #define TB_LOW_PWR_C1_CL1			0x1
540 #define TB_LOW_PWR_C1_CL1_OBJ_MASK		GENMASK(4, 1)
541 #define TB_LOW_PWR_C1_CL2_OBJ_MASK		GENMASK(4, 1)
542 #define TB_LOW_PWR_C1_PORT_A_MASK		GENMASK(2, 1)
543 #define TB_LOW_PWR_C0_PORT_B_MASK		GENMASK(4, 3)
544 #define TB_LOW_PWR_C3_CL1			0x3
545 
546 /* Common link controller registers */
547 #define TB_LC_DESC				0x02
548 #define TB_LC_DESC_NLC_MASK			GENMASK(3, 0)
549 #define TB_LC_DESC_SIZE_SHIFT			8
550 #define TB_LC_DESC_SIZE_MASK			GENMASK(15, 8)
551 #define TB_LC_DESC_PORT_SIZE_SHIFT		16
552 #define TB_LC_DESC_PORT_SIZE_MASK		GENMASK(27, 16)
553 #define TB_LC_FUSE				0x03
554 #define TB_LC_SNK_ALLOCATION			0x10
555 #define TB_LC_SNK_ALLOCATION_SNK0_MASK		GENMASK(3, 0)
556 #define TB_LC_SNK_ALLOCATION_SNK0_CM		0x1
557 #define TB_LC_SNK_ALLOCATION_SNK1_SHIFT		4
558 #define TB_LC_SNK_ALLOCATION_SNK1_MASK		GENMASK(7, 4)
559 #define TB_LC_SNK_ALLOCATION_SNK1_CM		0x1
560 #define TB_LC_POWER				0x740
561 
562 /* Link controller registers */
563 #define TB_LC_CS_42				0x2a
564 #define TB_LC_CS_42_USB_PLUGGED			BIT(31)
565 
566 #define TB_LC_PORT_ATTR				0x8d
567 #define TB_LC_PORT_ATTR_BE			BIT(12)
568 
569 #define TB_LC_SX_CTRL				0x96
570 #define TB_LC_SX_CTRL_WOC			BIT(1)
571 #define TB_LC_SX_CTRL_WOD			BIT(2)
572 #define TB_LC_SX_CTRL_WODPC			BIT(3)
573 #define TB_LC_SX_CTRL_WODPD			BIT(4)
574 #define TB_LC_SX_CTRL_WOU4			BIT(5)
575 #define TB_LC_SX_CTRL_WOP			BIT(6)
576 #define TB_LC_SX_CTRL_L1C			BIT(16)
577 #define TB_LC_SX_CTRL_L1D			BIT(17)
578 #define TB_LC_SX_CTRL_L2C			BIT(20)
579 #define TB_LC_SX_CTRL_L2D			BIT(21)
580 #define TB_LC_SX_CTRL_SLI			BIT(29)
581 #define TB_LC_SX_CTRL_UPSTREAM			BIT(30)
582 #define TB_LC_SX_CTRL_SLP			BIT(31)
583 #define TB_LC_LINK_ATTR				0x97
584 #define TB_LC_LINK_ATTR_CPS			BIT(18)
585 
586 #define TB_LC_LINK_REQ				0xad
587 #define TB_LC_LINK_REQ_XHCI_CONNECT		BIT(31)
588 
589 #endif
590