xref: /illumos-gate/usr/src/uts/common/sys/usb/hcd/ehci/ehci.h (revision 9a48f6c4)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 /*
22  * Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
23  * Use is subject to license terms.
24  */
25 
26 #ifndef _SYS_USB_EHCI_H
27 #define	_SYS_USB_EHCI_H
28 
29 
30 #ifdef __cplusplus
31 extern "C" {
32 #endif
33 
34 /*
35  * Enhanced Host Controller Driver (EHCI)
36  *
37  * The EHCI driver is a software driver which interfaces to the Universal
38  * Serial Bus layer (USBA) and the Host Controller (HC). The interface to
39  * the Host Controller is defined by the EHCI Host Controller Interface.
40  *
41  * This header file describes the registers and data structures shared by
42  * the EHCI USB controller (HC) and the EHCI Driver.
43  */
44 
45 #include <sys/types.h>
46 #include <sys/pci.h>
47 #include <sys/sunddi.h>
48 #include <sys/sunndi.h>
49 #include <sys/ndi_impldefs.h>
50 #include <sys/disp.h>
51 
52 #include <sys/usb/usba.h>
53 
54 #include <sys/usb/usba/hcdi.h>
55 
56 #include <sys/usb/hubd/hub.h>
57 #include <sys/usb/usba/hubdi.h>
58 #include <sys/usb/hubd/hubdvar.h>
59 
60 #include <sys/id32.h>
61 
62 #define	EHCI_MAX_RH_PORTS	31	/* Maximum root hub ports */
63 
64 
65 /*
66  * Each EHCI buffer can hold upto 4k bytes of data. Hence there is a
67  * restriction of 4k alignment while allocating a dma buffer.
68  */
69 #define	EHCI_4K_ALIGN			0x1000
70 
71 /*
72  * USB Host controller DMA scatter gather list defines for
73  * Sparc and non-sparc architectures.
74  */
75 #if defined(__sparc)
76 #define	EHCI_DMA_ATTR_MAX_XFER		0xffffffffull
77 #define	EHCI_DMA_ATTR_COUNT_MAX		0xffffffffull
78 #define	EHCI_DMA_ATTR_GRANULAR		512
79 #define	EHCI_DMA_ATTR_ALIGNMENT		EHCI_4K_ALIGN
80 #else
81 #define	EHCI_DMA_ATTR_MAX_XFER		0x00ffffffull
82 #define	EHCI_DMA_ATTR_COUNT_MAX		0x00ffffffull
83 #define	EHCI_DMA_ATTR_GRANULAR		1
84 #define	EHCI_DMA_ATTR_ALIGNMENT		EHCI_4K_ALIGN
85 #endif
86 
87 /* Set the default data structure (QTD,QH,SITD,ITD) to a 32 byte alignment */
88 #define	EHCI_DMA_ATTR_TD_QH_ALIGNMENT	0x0020
89 #define	EHCI_DMA_ATTR_PFL_ALIGNMENT	EHCI_4K_ALIGN
90 
91 /* TW scatter/gatter list defines */
92 #define	EHCI_DMA_ATTR_TW_SGLLEN		0x7fffffff
93 
94 /*
95  * EHCI Capability Registers
96  *
97  * The registers specify the limits, restrictions and capabilities of the
98  * specific EHCI Host Controller implementation.
99  */
100 typedef	volatile struct	ehci_caps {
101 	uint8_t		ehci_caps_length;	/* Capability register length */
102 	uint8_t		ehci_pad;		/* Reserved */
103 	uint16_t	ehci_version;		/* Interface version number */
104 	uint32_t	ehci_hcs_params;	/* Structural paramters */
105 	uint32_t	ehci_hcc_params;	/* Capability paramters */
106 	uint8_t		ehci_port_route[8];	/* Companion port route */
107 } ehci_caps_t;
108 
109 /*
110  * EHCI revision
111  *
112  * EHCI driver supports EHCI host controllers compliant to 0.95 and higher
113  * revisions of EHCI specifications.
114  */
115 #define	EHCI_REVISION_0_95		0x95	   /* Revision 0.95 */
116 
117 /* EHCI HCS Params Register Bits */
118 #define	EHCI_HCS_PORT_INDICATOR		0x00010000 /* Port indicator control */
119 #define	EHCI_HCS_NUM_COMP_CTRLS		0x0000F000 /* No of companion ctrls */
120 #define	EHCI_HCS_NUM_COMP_CTRL_SHIFT	12
121 #define	EHCI_HCS_NUM_PORTS_CC		0x00000F00 /* Ports per classic ctrls */
122 #define	EHCI_HCS_NUM_PORTS_CC_SHIFT	8
123 #define	EHCI_HCS_PORT_ROUTING_RULES	0x00000080 /* Port routing rules */
124 #define	EHCI_HCS_PORT_POWER_CONTROL	0x00000010 /* Port power control */
125 #define	EHCI_HCS_NUM_PORTS		0x0000000F /* No of root hub ports */
126 
127 /* EHCI HCC Params Register Bits */
128 #define	EHCI_HCC_EECP			0x0000FF00 /* Extended capbilities */
129 #define	EHCI_HCC_EECP_SHIFT		8
130 #define	EHCI_HCC_EECP_MIN_OFFSET	0x00000040 /* Minimum valid offset */
131 #define	EHCI_HCC_ISOCH_SCHED_THRESHOLD	0x000000F0 /* Isoch sched threshold */
132 #define	EHCI_HCC_ASYNC_SCHED_PARK_CAP	0x00000004 /* Async schedule park cap */
133 #define	EHCI_HCC_PROG_FRAME_LIST_FLAG	0x00000002 /* Prog frame list flag */
134 #define	EHCI_HCC_64BIT_ADDR_CAP		0x00000001 /* 64bit addr capability */
135 
136 /* EHCI Port Route Register Bits */
137 #define	EHCI_PORT_ROUTE_EVEN		0x0F	   /* Classic even port route */
138 #define	EHCI_PORT_ROUTE_ODD		0xF0	   /* Classic odd port route */
139 #define	EHCI_PORT_ROUTE_ODD_SHIFT	4
140 
141 
142 /*
143  * EHCI Operational Registers
144  *
145  * The EHCI Host Controller contains a set of on-chip operational registers
146  * which are mapped into a non-cacheable portion  of the system addressable
147  * space. These registers are also used by the EHCI Host Controller Driver.
148  * This structure must be aligned to 32 byte boundary.
149  */
150 typedef volatile struct ehci_regs {
151 	/* Control and status registers */
152 	uint32_t	ehci_command;		 /* USB commands */
153 	uint32_t	ehci_status;		 /* USB status */
154 	uint32_t	ehci_interrupt;		 /* Interrupt enable */
155 	uint32_t	ehci_frame_index;	 /* Frame index */
156 
157 	/* Memory pointer registers */
158 	uint32_t	ehci_ctrl_segment;	 /* Control data segment */
159 	uint32_t	ehci_periodic_list_base; /* Period frm list base addr */
160 	uint32_t	ehci_async_list_addr;	 /* Async list base address */
161 	uint32_t	ehci_pad[9];		 /* Head of the bulk list */
162 
163 	/* Root hub registers */
164 	uint32_t	ehci_config_flag;	 /* Config Flag */
165 	uint32_t	ehci_rh_port_status[EHCI_MAX_RH_PORTS];
166 			/* Root hub port status and control information */
167 } ehci_regs_t;
168 
169 /* EHCI Command Register Bits */
170 #define	EHCI_CMD_INTR_THRESHOLD		0x00FF0000 /* Intr threshold control */
171 #define	EHCI_CMD_INTR_SHIFT		16
172 #define	EHCI_CMD_01_INTR		0x00010000 /* 01 micro-frame */
173 #define	EHCI_CMD_02_INTR		0x00020000 /* 02 micro-frames */
174 #define	EHCI_CMD_04_INTR		0x00040000 /* 04 micro-frames */
175 #define	EHCI_CMD_08_INTR		0x00080000 /* 08 micro-frames */
176 #define	EHCI_CMD_16_INTR		0x00100000 /* 16 micro-frames */
177 #define	EHCI_CMD_32_INTR		0x00200000 /* 32 micro-frames */
178 #define	EHCI_CMD_64_INTR		0x00400000 /* 64 micro-frames */
179 
180 #define	EHCI_CMD_ASYNC_PARK_ENABLE	0x00000800 /* Async sched park enable */
181 #define	EHCI_CMD_ASYNC_PARK_COUNT	0x00000300 /* Async sched park count */
182 #define	EHCI_CMD_ASYNC_PARK_COUNT_1	0x00000100 /* Async sched park cnt 1 */
183 #define	EHCI_CMD_ASYNC_PARK_COUNT_2	0x00000200 /* Async sched park cnt 2 */
184 #define	EHCI_CMD_ASYNC_PARK_COUNT_3	0x00000300 /* Async sched park cnt 3 */
185 #define	EHCI_CMD_ASYNC_PARK_SHIFT	8
186 #define	EHCI_CMD_LIGHT_HC_RESET		0x00000080 /* Light host ctrl reset */
187 #define	EHCI_CMD_INTR_ON_ASYNC_ADVANCE	0x00000040 /* Async advance doorbell */
188 #define	EHCI_CMD_ASYNC_SCHED_ENABLE	0x00000020 /* Async schedule enable */
189 #define	EHCI_CMD_PERIODIC_SCHED_ENABLE	0x00000010 /* Periodic sched enable */
190 #define	EHCI_CMD_FRAME_LIST_SIZE	0x0000000C /* Frame list size */
191 #define	EHCI_CMD_FRAME_LIST_SIZE_SHIFT	2
192 #define	EHCI_CMD_FRAME_1024_SIZE	0x00000000 /* 1024 frame list size */
193 #define	EHCI_CMD_FRAME_512_SIZE		0x00000004 /* 512 frame list size */
194 #define	EHCI_CMD_FRAME_256_SIZE		0X00000008 /* 256 frame list size */
195 #define	EHCI_CMD_HOST_CTRL_RESET	0x00000002 /* Host controller reset */
196 #define	EHCI_CMD_HOST_CTRL_RS		0x00000001 /* Host ctrl run or stop */
197 #define	EHCI_CMD_HOST_CTRL_RUN		0x00000001 /* Host controller run */
198 #define	EHCI_CMD_HOST_CTRL_STOP		0x00000000 /* Host controller stop */
199 
200 /* EHCI Status Register Bits */
201 #define	EHCI_STS_ASYNC_SCHED_STATUS	0x00008000 /* Async schedule status */
202 #define	EHCI_STS_PERIODIC_SCHED_STATUS	0x00004000 /* Periodic sched status */
203 #define	EHCI_STS_EMPTY_ASYNC_SCHEDULE	0x00002000 /* Empty async schedule */
204 #define	EHCI_STS_HOST_CTRL_HALTED	0x00001000 /* Host controller Halted */
205 #define	EHCI_STS_ASYNC_ADVANCE_INTR	0x00000020 /* Intr on async advance */
206 #define	EHCI_STS_HOST_SYSTEM_ERROR_INTR	0x00000010 /* Host system error */
207 #define	EHCI_STS_FRM_LIST_ROLLOVER_INTR	0x00000008 /* Frame list rollover */
208 #define	EHCI_STS_RH_PORT_CHANGE_INTR	0x00000004 /* Port change detect */
209 #define	EHCI_STS_USB_ERROR_INTR		0x00000002 /* USB error interrupt */
210 #define	EHCI_STS_USB_INTR		0x00000001 /* USB interrupt */
211 
212 /* EHCI Interrupt Register Bits */
213 #define	EHCI_INTR_ASYNC_ADVANCE		0x00000020 /* Async advance interrupt */
214 #define	EHCI_INTR_HOST_SYSTEM_ERROR	0x00000010 /* Host system error intr */
215 #define	EHCI_INTR_FRAME_LIST_ROLLOVER	0x00000008 /* Framelist rollover intr */
216 #define	EHCI_INTR_RH_PORT_CHANGE	0x00000004 /* Port change interrupt */
217 #define	EHCI_INTR_USB_ERROR		0x00000002 /* USB error interrupt */
218 #define	EHCI_INTR_USB			0x00000001 /* USB interrupt */
219 
220 /* EHCI Frame Index Register Bits */
221 #define	EHCI_FRAME_INDEX		0x00003FFF /* Frame index */
222 #define	EHCI_FRAME_1024			0x00003FFF /* 1024 elements */
223 #define	EHCI_FRAME_0512			0x00001FFF /* 512 elements */
224 #define	EHCI_FRAME_0256			0x00000FFF /* 256 elements */
225 
226 /* EHCI Control Data Structure Segment Register Bits */
227 /* Most significant 32 bits for all EHCI data structures in 64bit addressing */
228 #define	EHCI_CTRLD_SEGMENT		0xFFFFFFFF /* Control data segment */
229 
230 /* EHCI Periodic Frame List Base Address Register Bits */
231 #define	EHCI_PERIODIC_LIST_BASE		0xFFFFF000 /* Periodic framelist addr */
232 #define	EHCI_PERIODIC_LIST_BASE_SHIFT	12
233 
234 /* EHCI Asynchronous List Address Register Bits */
235 #define	EHCI_ASYNC_LIST_ADDR		0xFFFFFFE0 /* Async list address */
236 #define	EHCI_ASYNC_LIST_ADDR_SHIFT	5
237 
238 /* EHCI Config Flag Register Bits */
239 #define	EHCI_CONFIG_FLAG		0x00000001 /* Route host controllers */
240 #define	EHCI_CONFIG_FLAG_CLASSIC	0x00000000 /* Route to Classic ctrl */
241 #define	EHCI_CONFIG_FLAG_EHCI		0x00000001 /* Route to EHCI ctrl */
242 
243 /* EHCI Root Hub Port Status and Control Register Bits */
244 #define	EHCI_RH_PORT_OVER_CURENT_ENABLE	0x00400000 /* Over current enable */
245 #define	EHCI_RH_PORT_DISCONNECT_ENABLE	0x00200000 /* Disconnect enable */
246 #define	EHCI_RH_PORT_CONNECT_ENABLE	0x00100000 /* Connect enable */
247 #define	EHCI_RH_PORT_INDICATOR		0x0000C000 /* Port indicator control */
248 #define	EHCI_RH_PORT_IND_SHIFT		14
249 #define	EHCI_RH_PORT_IND_OFF		0x00000000 /* Port indicators off */
250 #define	EHCI_RH_PORT_IND_AMBER		0x00004000 /* Amber port indicator */
251 #define	EHCI_RH_PORT_IND_GREEN		0x00008000 /* Green port indicator */
252 #define	EHCI_RH_PORT_OWNER		0x00002000 /* Port ownership */
253 #define	EHCI_RH_PORT_OWNER_CLASSIC	0x00002000 /* Classic port ownership */
254 #define	EHCI_RH_PORT_OWNER_EHCI		0x00000000 /* EHCI port ownership */
255 #define	EHCI_RH_PORT_POWER		0x00001000 /* Port power */
256 #define	EHCI_RH_PORT_LINE_STATUS	0x00000C00 /* USB speed line status */
257 #define	EHCI_RH_PORT_LOW_SPEED		0x00000400 /* Low speed */
258 #define	EHCI_RH_PORT_RESET		0x00000100 /* Port reset */
259 #define	EHCI_RH_PORT_SUSPEND		0x00000080 /* Port suspend */
260 #define	EHCI_RH_PORT_RESUME		0x00000040 /* Port resume */
261 #define	EHCI_RH_PORT_OVER_CURR_CHANGE	0x00000020 /* Over current change */
262 #define	EHCI_RH_PORT_OVER_CURR_ACTIVE	0x00000010 /* Over current active */
263 #define	EHCI_RH_PORT_ENABLE_CHANGE	0x00000008 /* Port enable change */
264 #define	EHCI_RH_PORT_ENABLE		0x00000004 /* Port enable */
265 #define	EHCI_RH_PORT_CONNECT_STS_CHANGE	0x00000002 /* Connect status change */
266 #define	EHCI_RH_PORT_CONNECT_STATUS	0x00000001 /* Connect status */
267 
268 /* Root hub port change bits mask */
269 #define	EHCI_RH_PORT_CLEAR_MASK		0x0000002A /* Clear bits mask */
270 
271 
272 /*
273  * EHCI Extended Capability Registers
274  *
275  * Currently this register only specifies BIOS handoff information.
276  */
277 #define	EHCI_EX_CAP_SPECIFICS		0xFFFF0000
278 #define	EHCI_EX_CAP_SPECIFICS_SHIFT	16
279 #define	EHCI_EX_CAP_NEXT_PTR		0x0000FF00
280 #define	EHCI_EX_CAP_NEXT_PTR_SHIFT	8
281 #define	EHCI_EX_CAP_ID			0x000000FF
282 #define	EHCI_EX_CAP_ID_SHIFT		0
283 #define	EHCI_EX_CAP_ID_RESERVED		0
284 #define	EHCI_EX_CAP_ID_BIOS_HANDOFF	1
285 
286 #define	EHCI_LEGSUP_OS_OWNED_SEM	0x01000000
287 #define	EHCI_LEGSUP_BIOS_OWNED_SEM	0x00010000
288 
289 
290 /*
291  * Host Controller Periodic Frame List Area
292  *
293  * The Host Controller Periodic Frame List Area is a 4K structre of system
294  * memory that is established by the Host Controller Driver (HCD) and this
295  * structre is used for communication between HCD and HC. The HCD maintains
296  * a pointer to this structure in the Host Controller (HC). This structure
297  * must be aligned to a 4K boundary. There are 1024 periodic frame list
298  * entries.
299  */
300 
301 #define	EHCI_NUM_INTR_QH_LISTS		32	/* No of intr lists */
302 #define	EHCI_NUM_STATIC_NODES		63	/* No of static QHs */
303 #define	EHCI_NUM_PERIODIC_FRAME_LISTS	1024	/* No of entries */
304 
305 typedef volatile struct ehci_periodic_frame_list {
306 	uint32_t	ehci_periodic_frame_list_table[
307 			    EHCI_NUM_PERIODIC_FRAME_LISTS]; /* 1024 lists */
308 } ehci_periodic_frame_list_t;
309 
310 
311 /*
312  * Host Controller Queue Head
313  *
314  * An Queue Head (QH) is a memory structure that describes the information
315  * necessary for the Host Controller to communicate with a device endpoint
316  * except High Speed and Full Speed Isochronous's endpoints. An QH includes
317  * a Queue Element Transfer Descriptor (QTD) pointer.  This structure must
318  * be aligned to a 32 byte boundary.
319  */
320 typedef volatile struct ehci_qh {
321 	/* Endpoint capabilities or characteristics */
322 	uint32_t	qh_link_ptr;	  /* Next QH or ITD or SITD */
323 	uint32_t	qh_ctrl;	  /* Generic control information */
324 	uint32_t	qh_split_ctrl;	  /* Split transaction control info */
325 	uint32_t	qh_curr_qtd;	  /* Current QTD */
326 
327 	/* Tranfer overlay */
328 	uint32_t	qh_next_qtd;	  /* Next QTD */
329 	uint32_t	qh_alt_next_qtd;  /* Next alternate QTD */
330 	uint32_t	qh_status;	  /* Status of current QTD */
331 	uint32_t	qh_buf[5];	  /* Buffer pointers */
332 	uint32_t	qh_buf_high[5];	  /* For 64 bit addressing */
333 
334 	/* HCD private fields */
335 	uint32_t	qh_dummy_qtd;	  /* Current dummy qtd */
336 	uint32_t	qh_prev;	  /* Prevous QH */
337 	uint32_t	qh_state;	  /* QH's state */
338 	uint32_t	qh_reclaim_next;  /* Next QH on reclaim list */
339 	uint32_t	qh_reclaim_frame; /* Reclaim usb frame number */
340 	uint8_t		qh_pad[8];	  /* Required padding */
341 } ehci_qh_t;
342 
343 /*
344  * qh_link_ptr control bits.
345  */
346 #define	EHCI_QH_LINK_PTR		0xFFFFFFE0	/* QH link ptr mask */
347 #define	EHCI_QH_LINK_REF		0x00000006	/* Ref to QH/ITD/SITD */
348 #define	EHCI_QH_LINK_REF_ITD		0x00000000	/* Isoch QTD pointer */
349 #define	EHCI_QH_LINK_REF_QH		0x00000002	/* QH pointer */
350 #define	EHCI_QH_LINK_REF_SITD		0x00000004	/* SIQTD pointer */
351 #define	EHCI_QH_LINK_REF_FSTN		0x00000006	/* FSTN pointer */
352 #define	EHCI_QH_LINK_PTR_VALID		0x00000001	/* Link ptr validity */
353 
354 /*
355  * qh_ctrl control bits.
356  */
357 #define	EHCI_QH_CTRL_NC_RL		0xF0000000	/* Nak count reload */
358 #define	EHCI_QH_CTRL_NC_RL_SHIFT	28		/* NC reload shift */
359 #define	EHCI_QH_CTRL_MAX_NC		0xF0000000	/* Max Nak counts */
360 #define	EHCI_QH_CTRL_CONTROL_ED_FLAG	0x08000000	/* Ctrl endpoint flag */
361 #define	EHCI_QH_CTRL_MAXPKTSZ		0x07FF0000	/* Max packet length */
362 #define	EHCI_QH_CTRL_MAXPKTSZ_SHIFT	16		/* Max packet shift */
363 #define	EHCI_QH_CTRL_RECLAIM_HEAD	0x00008000	/* Head reclaim list */
364 #define	EHCI_QH_CTRL_DATA_TOGGLE	0x00004000	/* Data toggle */
365 #define	EHCI_QH_CTRL_ED_SPEED		0x00003000	/* Endpoint speed */
366 #define	EHCI_QH_CTRL_ED_FULL_SPEED	0x00000000	/* FullSpeed endpoint */
367 #define	EHCI_QH_CTRL_ED_LOW_SPEED	0x00001000	/* LowSpeed endpoint */
368 #define	EHCI_QH_CTRL_ED_HIGH_SPEED	0x00002000	/* HighSpeed endpoint */
369 #define	EHCI_QH_CTRL_ED_SPEED_SHIFT	12		/* ED speed shift */
370 #define	EHCI_QH_CTRL_ED_NUMBER		0x00000F00	/* Endpoint number */
371 #define	EHCI_QH_CTRL_ED_NUMBER_SHIFT	8		/* ED number shift */
372 #define	EHCI_QH_CTRL_ED_INACTIVATE	0x00000080	/* Inctivate endpoint */
373 #define	EHCI_QH_CTRL_DEVICE_ADDRESS	0x0000007F	/* Device address */
374 
375 /*
376  * q_split_ctrl control bits.
377  */
378 #define	EHCI_QH_SPLIT_CTRL_MULT		0xC0000000	/* HB multiplier */
379 #define	EHCI_QH_SPLIT_CTRL_MULT_SHIFT	30		/* HB mult Shift */
380 #define	EHCI_QH_SPLIT_CTRL_1_XACTS	0x40000000	/* 1 Xacts per uFrame */
381 #define	EHCI_QH_SPLIT_CTRL_2_XACTS	0x80000000	/* 2 Xacts per uFrame */
382 #define	EHCI_QH_SPLIT_CTRL_3_XACTS	0xC0000000	/* 3 Xacts per uFrame */
383 #define	EHCI_QH_SPLIT_CTRL_HUB_PORT	0x3F800000	/* HS hub port number */
384 #define	EHCI_QH_SPLIT_CTRL_HUB_PORT_SHIFT 23		/* HS hubport no shft */
385 #define	EHCI_QH_SPLIT_CTRL_HUB_ADDR	0x007F0000	/* HS hub address */
386 #define	EHCI_QH_SPLIT_CTRL_HUB_ADDR_SHIFT 16		/* HS hub addr mask */
387 #define	EHCI_QH_SPLIT_CTRL_COMP_MASK	0x0000FF00	/* Split comp mask */
388 #define	EHCI_QH_SPLIT_CTRL_COMP_SHIFT	8		/* Split comp shift */
389 #define	EHCI_QH_SPLIT_CTRL_INTR_MASK	0x000000FF	/* Intr schedule mask */
390 
391 /*
392  * qh_curr_qtd control bits.
393  */
394 #define	EHCI_QH_CURR_QTD_PTR		0xFFFFFFE0	/* Curr element QTD */
395 
396 /*
397  * qh_next_qtd control bits.
398  */
399 #define	EHCI_QH_NEXT_QTD_PTR		0xFFFFFFE0	/* Next QTD */
400 #define	EHCI_QH_NEXT_QTD_PTR_VALID	0x00000001	/* Next QTD validity */
401 
402 /*
403  * qh_alt_next_qtd control bits.
404  */
405 #define	EHCI_QH_ALT_NEXT_QTD_PTR	0xFFFFFFE0	/* Alternate next QTD */
406 #define	EHCI_QH_ALT_NEXT_QTD_PTR_VALID	0x00000001	/* Alt QTD validity */
407 #define	EHCI_QH_ALT_NEXT_QTD_NAKCNT	0x0000001E	/* NAK counter */
408 
409 /*
410  * qh_status control bits.
411  */
412 #define	EHCI_QH_STS_DATA_TOGGLE		0x80000000	/* Data toggle */
413 #define	EHCI_QH_STS_BYTES_TO_XFER	0x7FFF0000	/* Bytes to transfer */
414 #define	EHCI_QH_STS_BYTES_TO_XFER_SHIFT	16		/* Bytes to xfer mask */
415 #define	EHCI_QH_STS_INTR_ON_COMPLETE	0x00008000	/* Intr on complete */
416 #define	EHCI_QH_STS_C_PAGE		0x00007000	/* C page */
417 #define	EHCI_QH_STS_ERROR_COUNTER	0x00000C00	/* Error counter */
418 #define	EHCI_QH_STS_ERROR_COUNT_MASK	0x00000C00	/* Error count mask */
419 #define	EHCI_QH_STS_PID_CODE		0x00000300	/* PID code */
420 #define	EHCI_QH_STS_XACT_STATUS		0x000000FF	/* Xact Status */
421 #define	EHCI_QH_STS_HS_XACT_STATUS	0x000000F8	/* HS Xact status */
422 #define	EHCI_QH_STS_NON_HS_XACT_STATUS	0x000000FD	/* Non HS Xact status */
423 #define	EHCI_QH_STS_NO_ERROR		0x00000000	/* No error */
424 #define	EHCI_QH_STS_ACTIVE		0x00000080	/* Active */
425 #define	EHCI_QH_STS_HALTED		0x00000040	/* Halted */
426 #define	EHCI_QH_STS_DATA_BUFFER_ERR	0x00000020	/* Data buffer error */
427 #define	EHCI_QH_STS_BABBLE_DETECTED	0x00000010	/* Babble detected */
428 #define	EHCI_QH_STS_XACT_ERROR		0x00000008	/* Transaction error */
429 #define	EHCI_QH_STS_MISSED_uFRAME	0x00000004	/* Missed micro frame */
430 #define	EHCI_QH_STS_SPLIT_XSTATE	0x00000002	/* Split xact state */
431 #define	EHCI_QH_STS_DO_START_SPLIT	0x00000000	/* Do start split */
432 #define	EHCI_QH_STS_DO_COMPLETE_SPLIT	0x00000002	/* Do complete split */
433 #define	EHCI_QH_STS_PING_STATE		0x00000001	/* Ping state */
434 #define	EHCI_QH_STS_DO_OUT		0x00000000	/* Do OUT */
435 #define	EHCI_QH_STS_DO_PING		0x00000001	/* Do PING */
436 #define	EHCI_QH_STS_PRD_SPLIT_XACT_ERR	0x00000001	/* Periodic split err */
437 
438 /*
439  * qh_buf[X] control bits.
440  */
441 #define	EHCI_QH_BUF_PTR			0xFFFFF000	/* Buffer pointer */
442 #define	EHCI_QH_BUF_CURR_OFFSET		0x00000FFF	/* Current offset */
443 #define	EHCI_QH_BUF_CPROG_MASK		0x000000FF	/* Split progress */
444 #define	EHCI_QH_BUF_SBYTES		0x00000FE0	/* Software S bytes */
445 #define	EHCI_QH_BUF_FRAME_TAG		0x0000001F	/* Split xct frametag */
446 
447 /*
448  * qh_buf_high[X] control bits.
449  */
450 #define	EHCI_QH_BUF_HIGH_PTR		0xFFFFFFFF	/* For 64 addressing */
451 
452 /*
453  * qh_state
454  *
455  * QH States
456  */
457 #define	EHCI_QH_FREE			1		/* Free QH */
458 #define	EHCI_QH_STATIC			2		/* Static QH */
459 #define	EHCI_QH_ACTIVE			3		/* Active QH */
460 
461 
462 /*
463  * Host Controller Queue Element Transfer Descriptor
464  *
465  * A Queue Element Transfer Descriptor (QTD) is a memory structure that
466  * describes the information necessary for the Host Controller	(HC) to
467  * transfer a block  of data to or from a device endpoint except High
468  * Speed and Full Speed Isochronous's endpoints. These QTD's will be
469  * attached to a Queue Head (QH). This structure must be aligned to a
470  * 32 byte boundary.
471  */
472 typedef	volatile struct ehci_qtd {
473 	uint32_t	qtd_next_qtd;		/* Next QTD */
474 	uint32_t	qtd_alt_next_qtd;	/* Next alternate QTD */
475 	uint32_t	qtd_ctrl;		/* Control information */
476 	uint32_t	qtd_buf[5];		/* Buffer pointers */
477 	uint32_t	qtd_buf_high[5];	/* For 64 bit addressing */
478 
479 	/* HCD private fields */
480 	uint32_t	qtd_trans_wrapper;	/* Transfer wrapper */
481 	uint32_t	qtd_tw_next_qtd;	/* Next qtd on TW */
482 	uint32_t	qtd_active_qtd_next;	/* Next QTD on active list */
483 	uint32_t	qtd_active_qtd_prev;	/* Prev QTD on active list */
484 	uint32_t	qtd_state;		/* QTD state */
485 	uint32_t	qtd_ctrl_phase;		/* Control xfer phase info */
486 	uint32_t	qtd_xfer_offs;		/* Starting buffer offset */
487 	uint32_t	qtd_xfer_len;		/* Transfer length */
488 	uint8_t		qtd_pad[12];		/* Required padding */
489 } ehci_qtd_t;
490 
491 /*
492  * qtd_next_qtd control bits.
493  */
494 #define	EHCI_QTD_NEXT_QTD_PTR		0xFFFFFFE0	/* Next QTD pointer */
495 #define	EHCI_QTD_NEXT_QTD_PTR_VALID	0x00000001	/* Next QTD validity */
496 
497 /*
498  * qtd_alt_next_qtd control bits.
499  */
500 #define	EHCI_QTD_ALT_NEXT_QTD_PTR	0xFFFFFFE0	/* Alt QTD pointer */
501 #define	EHCI_QTD_ALT_NEXT_QTD_PTR_VALID 0x00000001	/* Alt QTD validity */
502 
503 /*
504  * qtd_ctrl control bits.
505  */
506 #define	EHCI_QTD_CTRL_DATA_TOGGLE	0x80000000	/* Data toggle */
507 #define	EHCI_QTD_CTRL_DATA_TOGGLE_0	0x00000000	/* Data toggle 0 */
508 #define	EHCI_QTD_CTRL_DATA_TOGGLE_1	0x80000000	/* Data toggle 1 */
509 #define	EHCI_QTD_CTRL_BYTES_TO_XFER	0x7FFF0000	/* Bytes to xfer */
510 #define	EHCI_QTD_CTRL_BYTES_TO_XFER_SHIFT 16		/* Bytes xfer mask */
511 #define	EHCI_QTD_CTRL_INTR_ON_COMPLETE	0x00008000	/* Intr on complete */
512 #define	EHCI_QTD_CTRL_C_PAGE		0x00007000	/* Current page */
513 #define	EHCI_QTD_CTRL_MAX_ERR_COUNTS	0x00000C00	/* Max error counts */
514 #define	EHCI_QTD_CTRL_PID_CODE		0x00000300	/* PID code */
515 #define	EHCI_QTD_CTRL_OUT_PID		0x00000000	/* OUT token */
516 #define	EHCI_QTD_CTRL_IN_PID		0x00000100	/* IN token */
517 #define	EHCI_QTD_CTRL_SETUP_PID		0x00000200	/* SETUP token */
518 #define	EHCI_QTD_CTRL_XACT_STATUS	0x000000FF	/* Xact status */
519 #define	EHCI_QTD_CTRL_HS_XACT_STATUS	0x000000F8	/* HS Xact status */
520 #define	EHCI_QTD_CTRL_NON_HS_XACT_STATUS 0x000000FD	/* Non HS Xact status */
521 #define	EHCI_QTD_CTRL_NO_ERROR		0x00000000	/* No error */
522 #define	EHCI_QTD_CTRL_ACTIVE_XACT	0x00000080	/* Active xact */
523 #define	EHCI_QTD_CTRL_HALTED_XACT	0x00000040	/* Halted due to err */
524 #define	EHCI_QTD_CTRL_DATA_BUFFER_ERROR	0x00000020	/* Data buffer error */
525 #define	EHCI_QTD_CTRL_ERR_COUNT_MASK	0x00000C00	/* Error count */
526 #define	EHCI_QTD_CTRL_BABBLE_DETECTED	0x00000010	/* Babble detected */
527 #define	EHCI_QTD_CTRL_XACT_ERROR	0x00000008	/* Transaction error */
528 #define	EHCI_QTD_CTRL_MISSED_uFRAME	0x00000004	/* Missed uFrame */
529 #define	EHCI_QTD_CTRL_SPLIT_XACT_STATE	0x00000002	/* Split xact state */
530 #define	EHCI_QTD_CTRL_DO_START_SPLIT	0x00000000	/* Do start split */
531 #define	EHCI_QTD_CTRL_DO_COMPLETE_SPLIT	0x00000002	/* Do complete split */
532 #define	EHCI_QTD_CTRL_PING_STATE	0x00000001	/* Ping state */
533 #define	EHCI_QTD_CTRL_DO_OUT		0x00000000	/* Do OUT */
534 #define	EHCI_QTD_CTRL_DO_PING		0x00000001	/* Do PING */
535 #define	EHCI_QTD_CTRL_PRD_SPLIT_XACT_ERR 0x00000001	/* Periodic split err */
536 
537 /*
538  * qtd_buf[X] control bits.
539  */
540 #define	EHCI_QTD_BUF_PTR		0xFFFFF000	/* Buffer pointer */
541 #define	EHCI_QTD_BUF_CURR_OFFSET	0x00000FFF	/* Current offset */
542 
543 /*
544  * qtd_buf_high[X] control bits.
545  */
546 #define	EHCI_QTD_BUF_HIGH_PTR		0xFFFFFFFF	/* 64 bit addressing */
547 
548 /*
549  * qtd_state
550  *
551  * QTD States
552  */
553 #define	EHCI_QTD_FREE			1		/* Free QTD */
554 #define	EHCI_QTD_DUMMY			2		/* Dummy QTD */
555 #define	EHCI_QTD_ACTIVE			3		/* Active QTD */
556 #define	EHCI_QTD_RECLAIM		4		/* Reclaim QTD */
557 
558 /*
559  * qtd_ctrl_phase
560  *
561  * Control Transfer Phase information
562  */
563 #define	EHCI_CTRL_SETUP_PHASE		1		/* Setup phase */
564 #define	EHCI_CTRL_DATA_PHASE		2		/* Data phase */
565 #define	EHCI_CTRL_STATUS_PHASE		3		/* Status phase */
566 
567 /*
568  * Host Controller Split Isochronous Transfer Descripter
569  *
570  * iTD/siTD is a memory structure that describes the information necessary for
571  * the Host Controller (HC) to transfer a block of data to or from a
572  * 1.1 isochronous device end point.  The iTD/siTD will be inserted between
573  * the periodic frame list and the interrupt tree lattice.  This structure
574  * must be aligned to a 32 byte boundary.
575  */
576 typedef	volatile struct ehci_itd {
577 	uint32_t	itd_link_ptr;		/* Next TD */
578 	uint32_t	itd_body[15];		/* iTD and siTD body */
579 	uint32_t	itd_body_high[7];	/* For 64 bit addressing */
580 
581 	/* Padding required */
582 	uint32_t	itd_pad;
583 
584 	/* HCD private fields */
585 	uint32_t	itd_trans_wrapper;	/* Transfer wrapper */
586 	uint32_t	itd_itw_next_itd;	/* Next iTD on TW */
587 	uint32_t	itd_next_active_itd;	/* Next iTD in active list */
588 	uint32_t	itd_state;		/* iTD state */
589 	uint32_t	itd_index[8];		/* iTD index */
590 	uint64_t	itd_frame_number;	/* Frame iTD exists */
591 	uint64_t	itd_reclaim_number;	/* Frame iTD is reclaimed */
592 } ehci_itd_t;
593 
594 /*
595  * Generic Link Ptr Bits
596  * EHCI_TD_LINK_PTR : Points to the next data object to be processed
597  * EHCI_TD_LINK_PTR_TYPE : Type of reference this descriptor is
598  * EHCI_TD_LINK_PTR_VALID : Is this link pointer valid
599  */
600 #define	EHCI_ITD_LINK_PTR		0xFFFFFFE0	/* TD link ptr mask */
601 #define	EHCI_ITD_LINK_REF		0x00000006	/* Ref to TD/ITD/SITD */
602 #define	EHCI_ITD_LINK_REF_ITD		0x00000000	/* ITD pointer */
603 #define	EHCI_ITD_LINK_REF_QH		0x00000002	/* QH pointer */
604 #define	EHCI_ITD_LINK_REF_SITD		0x00000004	/* SITD pointer */
605 #define	EHCI_ITD_LINK_REF_FSTN		0x00000006	/* FSTN pointer */
606 #define	EHCI_ITD_LINK_PTR_INVALID	0x00000001	/* Link ptr validity */
607 
608 #define	EHCI_ITD_CTRL_LIST_SIZE		8
609 #define	EHCI_ITD_BUFFER_LIST_SIZE	7
610 #define	EHCI_ITD_CTRL0			0	/* Status and Ctrl List */
611 #define	EHCI_ITD_CTRL1			1
612 #define	EHCI_ITD_CTRL2			2
613 #define	EHCI_ITD_CTRL3			3
614 #define	EHCI_ITD_CTRL4			4
615 #define	EHCI_ITD_CTRL5			5
616 #define	EHCI_ITD_CTRL6			6
617 #define	EHCI_ITD_CTRL7			7
618 #define	EHCI_ITD_BUFFER0		8	/* Buffer Page Ptr List */
619 #define	EHCI_ITD_BUFFER1		9
620 #define	EHCI_ITD_BUFFER2		10
621 #define	EHCI_ITD_BUFFER3		11
622 #define	EHCI_ITD_BUFFER4		12
623 #define	EHCI_ITD_BUFFER5		13
624 #define	EHCI_ITD_BUFFER6		14
625 
626 /*
627  * iTD Transaction Status and Control bits
628  */
629 #define	EHCI_ITD_XFER_STATUS_MASK	0xF0000000
630 #define	EHCI_ITD_XFER_STATUS_SHIFT	28
631 #define	EHCI_ITD_XFER_ACTIVE		0x80000000
632 #define	EHCI_ITD_XFER_DATA_BUFFER_ERR	0x40000000
633 #define	EHCI_ITD_XFER_BABBLE		0x20000000
634 #define	EHCI_ITD_XFER_ERROR		0x10000000
635 #define	EHCI_ITD_XFER_LENGTH		0x0FFF0000
636 #define	EHCI_ITD_XFER_IOC		0x00008000
637 #define	EHCI_ITD_XFER_IOC_ON		0x00008000
638 #define	EHCI_ITD_XFER_IOC_OFF		0x00000000
639 #define	EHCI_ITD_XFER_PAGE_SELECT	0x00007000
640 #define	EHCI_ITD_XFER_OFFSET		0x00000FFF
641 
642 /*
643  * iTD Buffer Page Pointer bits
644  */
645 #define	EHCI_ITD_CTRL_BUFFER_MASK	0xFFFFF000
646 #define	EHCI_ITD_CTRL_ENDPT_MASK	0x00000F00
647 #define	EHCI_ITD_CTRL_DEVICE_MASK	0x0000007F
648 #define	EHCI_ITD_CTRL_DIR		0x00000800
649 #define	EHCI_ITD_CTRL_DIR_IN		0x00000800
650 #define	EHCI_ITD_CTRL_DIR_OUT		0x00000000
651 #define	EHCI_ITD_CTRL_MAX_PACKET_MASK	0x000007FF
652 #define	EHCI_ITD_CTRL_MULTI_MASK	0x00000003
653 #define	EHCI_ITD_CTRL_ONE_XACT		0x00000001
654 #define	EHCI_ITD_CTRL_TWO_XACT		0x00000002
655 #define	EHCI_ITD_CTRL_THREE_XACT	0x00000003
656 
657 /* Unused iTD index */
658 #define	EHCI_ITD_UNUSED_INDEX		0xFFFFFFFF
659 
660 #define	EHCI_SITD_CTRL			0
661 #define	EHCI_SITD_UFRAME_SCHED		1
662 #define	EHCI_SITD_XFER_STATE		2
663 #define	EHCI_SITD_BUFFER0		3
664 #define	EHCI_SITD_BUFFER1		4
665 #define	EHCI_SITD_PREV_SITD		5
666 
667 /*
668  * sitd_ctrl bits
669  * EHCI_SITD_CTRL_DIR : Direction of transaction
670  * EHCI_SITD_CTRL_PORT_MASK : Port # of recipient transaction translator(TT)
671  * EHCI_SITD_CTRL_HUB_MASK : Device address of the TT's hub
672  * EHCI_SITD_CTRL_END_PT_MASK : Endpoint # on device serving as data source/sink
673  * EHCI_SITD_CTRL_DEVICE_MASK : Address of device serving as data source/sink
674  */
675 #define	EHCI_SITD_CTRL_DIR		0x80000000
676 #define	EHCI_SITD_CTRL_DIR_IN		0x80000000
677 #define	EHCI_SITD_CTRL_DIR_OUT		0x00000000
678 #define	EHCI_SITD_CTRL_PORT_MASK	0x7F000000
679 #define	EHCI_SITD_CTRL_PORT_SHIFT	24
680 #define	EHCI_SITD_CTRL_HUB_MASK		0x007F0000
681 #define	EHCI_SITD_CTRL_HUB_SHIFT	16
682 #define	EHCI_SITD_CTRL_END_PT_MASK	0x00000F00
683 #define	EHCI_SITD_CTRL_END_PT_SHIFT	8
684 #define	EHCI_SITD_CTRL_DEVICE_MASK	0x0000007F
685 #define	EHCI_SITD_CTRL_DEVICE_SHIFT	0
686 
687 /*
688  * sitd_uframe_sched bits
689  * EHCI_SITD_UFRAME_CMASK_MASK : Determines which uFrame the HC executes CSplit
690  * EHCI_SITD_UFRAME_SMASK_MASK : Determines which uFrame the HC executes SSplit
691  */
692 #define	EHCI_SITD_UFRAME_CMASK_MASK	0x0000FF00
693 #define	EHCI_SITD_UFRAME_CMASK_SHIFT	8
694 #define	EHCI_SITD_UFRAME_SMASK_MASK	0x000000FF
695 #define	EHCI_SITD_UFRAME_SMASK_SHIFT	0
696 
697 /*
698  * sitd_xfer_state bits
699  * EHCI_SITD_XFER_IOC_MASK : Interrupt when transaction is complete.
700  * EHCI_SITD_XFER_PAGE_MASK : Which data page pointer should be concatenated
701  *				with the CurrentOffset to construct a data
702  *				buffer pointer
703  * EHCI_SITD_XFER_TOTAL_MASK : Total number of bytes expected in xfer(1023 Max).
704  * EHCI_SITD_XFER_CPROG_MASK : HC tracks which CSplit has been executed.
705  * EHCI_SITD_XFER_STATUS_MASK : Status of xfer
706  */
707 #define	EHCI_SITD_XFER_IOC_MASK		0x80000000
708 #define	EHCI_SITD_XFER_IOC_ON		0x80000000
709 #define	EHCI_SITD_XFER_IOC_OFF		0x00000000
710 #define	EHCI_SITD_XFER_PAGE_MASK	0x40000000
711 #define	EHCI_SITD_XFER_PAGE_0		0x00000000
712 #define	EHCI_SITD_XFER_PAGE_1		0x40000000
713 #define	EHCI_SITD_XFER_TOTAL_MASK	0x03FF0000
714 #define	EHCI_SITD_XFER_TOTAL_SHIFT	16
715 #define	EHCI_SITD_XFER_CPROG_MASK	0x0000FF00
716 #define	EHCI_SITD_XFER_CPROG_SHIFT	8
717 #define	EHCI_SITD_XFER_STATUS_MASK	0x000000FF
718 #define	EHCI_SITD_XFER_STATUS_SHIFT	0
719 #define	EHCI_SITD_XFER_ACTIVE		0x80
720 #define	EHCI_SITD_XFER_ERROR		0x40
721 #define	EHCI_SITD_XFER_DATA_BUFFER_ERR	0x20
722 #define	EHCI_SITD_XFER_BABBLE		0x10
723 #define	EHCI_SITD_XFER_XACT_ERROR	0x08
724 #define	EHCI_SITD_XFER_MISSED_UFRAME	0x04
725 #define	EHCI_SITD_XFER_SPLIT_XACT_STATE	0x02
726 #define	EHCI_SITD_XFER_SSPLIT_STATE	0x00
727 #define	EHCI_SITD_XFER_CSPLIT_STATE	0x02
728 
729 /*
730  * sitd_xfer_buffer0/1
731  * EHCI_SITD_XFER_BUFFER_MASK : Buffer Pointer List
732  * EHCI_SITD_XFER_OFFSET_MASK : Current byte offset
733  * EHCI_SITD_XFER_TP_MASK : Transaction position
734  * EHCI_SITD_XFER_TCOUNT_MASK : Transaction count
735  */
736 #define	EHCI_SITD_XFER_BUFFER_MASK	0xFFFFF000
737 #define	EHCI_SITD_XFER_BUFFER_SHIFT	12
738 #define	EHCI_SITD_XFER_OFFSET_MASK	0x00000FFF
739 #define	EHCI_SITD_XFER_OFFSET_SHIFT	0
740 #define	EHCI_SITD_XFER_TP_MASK		0x00000018
741 #define	EHCI_SITD_XFER_TP_ALL		0x0
742 #define	EHCI_SITD_XFER_TP_BEGIN		0x1
743 #define	EHCI_SITD_XFER_TP_MID		0x2
744 #define	EHCI_SITD_XFER_TP_END		0x3
745 #define	EHCI_SITD_XFER_TCOUNT_MASK	0x00000007
746 #define	EHCI_SITD_XFER_TCOUNT_SHIFT	0
747 
748 /*
749  * qtd_state
750  *
751  * ITD States
752  */
753 #define	EHCI_ITD_FREE			1		/* Free ITD */
754 #define	EHCI_ITD_DUMMY			2		/* Dummy ITD */
755 #define	EHCI_ITD_ACTIVE			3		/* Active ITD */
756 #define	EHCI_ITD_RECLAIM		4		/* Reclaim ITD */
757 
758 #ifdef __cplusplus
759 }
760 #endif
761 
762 #endif	/* _SYS_USB_EHCI_H */
763