1 /*        $NetBSD: ehcireg.h,v 1.41 2024/09/23 10:07:26 skrll Exp $   */
2 
3 /*
4  * Copyright (c) 2001, 2004 The NetBSD Foundation, Inc.
5  * All rights reserved.
6  *
7  * This code is derived from software contributed to The NetBSD Foundation
8  * by Lennart Augustsson (lennart@augustsson.net).
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29  * POSSIBILITY OF SUCH DAMAGE.
30  */
31 
32 /*
33  * The EHCI 0.96 spec can be found at
34  * http://developer.intel.com/technology/usb/download/ehci-r096.pdf
35  * and the USB 2.0 spec at
36  * http://www.usb.org/developers/data/usb_20.zip
37  */
38 
39 #ifndef _DEV_USB_EHCIREG_H_
40 #define _DEV_USB_EHCIREG_H_
41 
42 /*** PCI config registers ***/
43 
44 #define PCI_CBMEM             0x10      /* configuration base MEM */
45 
46 #define PCI_INTERFACE_EHCI    0x20
47 
48 #define PCI_USBREV            0x60      /* RO USB protocol revision */
49 #define  PCI_USBREV_MASK      0xff
50 #define  PCI_USBREV_PRE_1_0   0x00
51 #define  PCI_USBREV_1_0                 0x10
52 #define  PCI_USBREV_1_1                 0x11
53 #define  PCI_USBREV_2_0                 0x20
54 
55 #define PCI_EHCI_FLADJ                  0x61      /*RW Frame len adj, SOF=59488+6*fladj */
56 
57 #define PCI_EHCI_PORTWAKECAP  0x62      /* RW Port wake caps (opt)  */
58 
59 /* Regs at EECP + offset */
60 #define PCI_EHCI_USBLEGSUP    0x00
61 #define  EHCI_LEG_HC_OS_OWNED           0x01000000
62 #define  EHCI_LEG_HC_BIOS_OWNED                   0x00010000
63 #define PCI_EHCI_USBLEGCTLSTS 0x04
64 #define  EHCI_LEG_EXT_SMI_BAR           0x80000000
65 #define  EHCI_LEG_EXT_SMI_PCICMD        0x40000000
66 #define  EHCI_LEG_EXT_SMI_OS_CHANGE     0x20000000
67 
68 #define EHCI_CAP_GET_ID(cap) ((cap) & 0xff)
69 #define EHCI_CAP_GET_NEXT(cap) (((cap) >> 8) & 0xff)
70 #define EHCI_CAP_ID_LEGACY 1
71 
72 /*** EHCI capability registers ***/
73 
74 #define EHCI_CAPLENGTH                  0x00      /*RO Capability register length field */
75 /* reserved                             0x01 */
76 #define EHCI_HCIVERSION                 0x02      /* RO Interface version number */
77 
78 #define EHCI_HCSPARAMS                  0x04      /* RO Structural parameters */
79 #define  EHCI_HCS_N_TT(x)     (((x) >> 20) & 0xf) /* # of xacts xlater ETTF */
80 #define  EHCI_HCS_N_PTT(x)    (((x) >> 20) & 0xf) /* ports per xlater ETTF */
81 #define  EHCI_HCS_DEBUGPORT(x)          (((x) >> 20) & 0xf)
82 #define  EHCI_HCS_P_INDICATOR(x) ((x) & 0x10000)
83 #define  EHCI_HCS_N_CC(x)     (((x) >> 12) & 0xf) /* # of companion ctlrs */
84 #define  EHCI_HCS_N_PCC(x)    (((x) >> 8) & 0xf) /* # of ports per comp. */
85 #define  EHCI_HCS_PPC(x)      ((x) & 0x10) /* port power control */
86 #define  EHCI_HCS_N_PORTS(x)  ((x) & 0xf) /* # of ports */
87 
88 #define EHCI_HCCPARAMS                  0x08      /* RO Capability parameters */
89 #define  EHCI_HCC_EECP(x)               (((x) >> 8) & 0xff) /* extended ports caps */
90 #define  EHCI_HCC_IST_FULLFRAME                   __BIT(7)
91 #define  EHCI_HCC_IST_THRESHOLD_MASK    __BITS(6,4)         /* isoc sched threshold */
92 #define  EHCI_HCC_GET_IST_THRESHOLD(x)  __SHIFTOUT((x), EHCI_HCC_IST_THRESHOLD_MASK)
93 #define  EHCI_HCC_ASPC(x)     ((x) & 0x4) /* async sched park cap */
94 #define  EHCI_HCC_PFLF(x)     ((x) & 0x2) /* prog frame list flag */
95 #define  EHCI_HCC_64BIT(x)    ((x) & 0x1) /* 64 bit address cap */
96 
97 #define EHCI_HCSP_PORTROUTE   0x0c      /*RO Companion port route description */
98 
99 /* EHCI operational registers.  Offset given by EHCI_CAPLENGTH register */
100 #define EHCI_USBCMD           0x00      /* RO, RW, WO Command register */
101 #define  EHCI_CMD_ITC_M                 0x00ff0000 /* RW interrupt threshold ctrl */
102 #define   EHCI_CMD_ITC_1      0x00010000
103 #define   EHCI_CMD_ITC_2      0x00020000
104 #define   EHCI_CMD_ITC_4      0x00040000
105 #define   EHCI_CMD_ITC_8      0x00080000
106 #define   EHCI_CMD_ITC_16     0x00100000
107 #define   EHCI_CMD_ITC_32     0x00200000
108 #define   EHCI_CMD_ITC_64     0x00400000
109 #define  EHCI_CMD_ASPME                 0x00000800 /* RW/RO async park enable */
110 #define  EHCI_CMD_ASPMC                 0x00000300 /* RW/RO async park count */
111 #define  EHCI_CMD_LHCR                  0x00000080 /* RW light host ctrl reset */
112 #define  EHCI_CMD_IAAD                  0x00000040 /* RW intr on async adv door bell */
113 #define  EHCI_CMD_ASE                   0x00000020 /* RW async sched enable */
114 #define  EHCI_CMD_PSE                   0x00000010 /* RW periodic sched enable */
115 #define  EHCI_CMD_FLS_M                 0x0000000c /* RW/RO frame list size */
116 #define  EHCI_CMD_FLS(x)      (((x) >> 2) & 3) /* RW/RO frame list size */
117 #define  EHCI_CMD_HCRESET     0x00000002 /* RW reset */
118 #define  EHCI_CMD_RS                    0x00000001 /* RW run/stop */
119 
120 #define EHCI_USBSTS           0x04      /* RO, RW, RWC Status register */
121 #define  EHCI_STS_ASS                   0x00008000 /* RO async sched status */
122 #define  EHCI_STS_PSS                   0x00004000 /* RO periodic sched status */
123 #define  EHCI_STS_REC                   0x00002000 /* RO reclamation */
124 #define  EHCI_STS_HCH                   0x00001000 /* RO host controller halted */
125 #define  EHCI_STS_IAA                   0x00000020 /* RWC interrupt on async adv */
126 #define  EHCI_STS_HSE                   0x00000010 /* RWC host system error */
127 #define  EHCI_STS_FLR                   0x00000008 /* RWC frame list rollover */
128 #define  EHCI_STS_PCD                   0x00000004 /* RWC port change detect */
129 #define  EHCI_STS_ERRINT      0x00000002 /* RWC error interrupt */
130 #define  EHCI_STS_INT                   0x00000001 /* RWC interrupt */
131 #define  EHCI_STS_INTRS(x)    ((x) & 0x3f)
132 
133 #define EHCI_NORMAL_INTRS (EHCI_STS_IAA | EHCI_STS_HSE | EHCI_STS_PCD | EHCI_STS_ERRINT | EHCI_STS_INT)
134 
135 #define EHCI_USBINTR                    0x08      /* RW Interrupt register */
136 #define EHCI_INTR_IAAE                  0x00000020 /* interrupt on async advance ena */
137 #define EHCI_INTR_HSEE                  0x00000010 /* host system error ena */
138 #define EHCI_INTR_FLRE                  0x00000008 /* frame list rollover ena */
139 #define EHCI_INTR_PCIE                  0x00000004 /* port change ena */
140 #define EHCI_INTR_UEIE                  0x00000002 /* USB error intr ena */
141 #define EHCI_INTR_UIE                   0x00000001 /* USB intr ena */
142 
143 #define EHCI_FRINDEX                    0x0c      /* RW Frame Index register */
144 
145 #define EHCI_CTRLDSSEGMENT    0x10      /* RW Control Data Structure Segment */
146 
147 #define EHCI_PERIODICLISTBASE 0x14      /* RW Periodic List Base */
148 #define EHCI_ASYNCLISTADDR    0x18      /* RW Async List Base */
149 
150 #define EHCI_CONFIGFLAG                 0x40      /* RW Configure Flag register */
151 #define  EHCI_CONF_CF                   0x00000001 /* RW configure flag */
152 
153 #define EHCI_PORTSC(n)                  (0x40+4*(n)) /* RO, RW, RWC Port Status reg */
154 #define  EHCI_PS_PSPD                   0x0C000000 /* RO port speed (ETTF) */
155 #define  EHCI_PS_PSPD_FS      0x00000000 /* Full speed (ETTF) */
156 #define  EHCI_PS_PSPD_LS      0x04000000 /* Low speed (ETTF) */
157 #define  EHCI_PS_PSPD_HS      0x08000000 /* High speed (ETTF) */
158 #define  EHCI_PS_WKOC_E                 0x00400000 /* RW wake on over current ena */
159 #define  EHCI_PS_WKDSCNNT_E   0x00200000 /* RW wake on disconnect ena */
160 #define  EHCI_PS_WKCNNT_E     0x00100000 /* RW wake on connect ena */
161 #define  EHCI_PS_PTC                    0x000f0000 /* RW port test control */
162 #define  EHCI_PS_PIC                    0x0000c000 /* RW port indicator control */
163 #define  EHCI_PS_PO           0x00002000 /* RW port owner */
164 #define  EHCI_PS_PP           0x00001000 /* RW,RO port power */
165 #define  EHCI_PS_LS           0x00000c00 /* RO line status */
166 #define  EHCI_PS_IS_LOWSPEED(x)         (((x) & EHCI_PS_LS) == 0x00000400)
167 #define  EHCI_PS_PR           0x00000100 /* RW port reset */
168 #define  EHCI_PS_SUSP                   0x00000080 /* RW suspend */
169 #define  EHCI_PS_FPR                    0x00000040 /* RW force port resume */
170 #define  EHCI_PS_OCC                    0x00000020 /* RWC over current change */
171 #define  EHCI_PS_OCA                    0x00000010 /* RO over current active */
172 #define  EHCI_PS_PEC                    0x00000008 /* RWC port enable change */
173 #define  EHCI_PS_PE           0x00000004 /* RW port enable */
174 #define  EHCI_PS_CSC                    0x00000002 /* RWC connect status change */
175 #define  EHCI_PS_CS           0x00000001 /* RO connect status */
176 #define  EHCI_PS_CLEAR                  (EHCI_PS_OCC|EHCI_PS_PEC|EHCI_PS_CSC)
177 
178 #define EHCI_PORT_RESET_COMPLETE 2 /* ms */
179 
180 #define EHCI_FLALIGN_ALIGN    0x1000
181 #define EHCI_MAX_PORTS                  16 /* only 4 bits available in EHCI_HCS_N_PORTS */
182 
183 /* No data structure may cross a page boundary. */
184 #define EHCI_PAGE_SHIFT                 12
185 #define EHCI_PAGE_SIZE                  (1 << EHCI_PAGE_SHIFT)
186 #define EHCI_PAGE_MASK                  (EHCI_PAGE_SIZE - 1)
187 #define EHCI_PAGE(x)                    ((x) & ~EHCI_PAGE_MASK)
188 #define EHCI_PAGE_OFFSET(x)   ((x) & EHCI_PAGE_MASK)
189 #define EHCI_NPAGES(x)                  (((x) + EHCI_PAGE_MASK) >> EHCI_PAGE_SHIFT)
190 
191 typedef uint32_t ehci_link_t;
192 #define EHCI_LINK_TERMINATE   __BIT(0)
193 #define EHCI_LINK_TYPE(x)     ((x) & 0x00000006)
194 #define  EHCI_LINK_ITD                  0x0
195 #define  EHCI_LINK_QH                   0x2
196 #define  EHCI_LINK_SITD                 0x4
197 #define  EHCI_LINK_FSTN                 0x6
198 #define EHCI_LINK_ADDR(x)     ((x) &~ 0x1f)
199 
200 typedef uint32_t ehci_physaddr_t;
201 
202 typedef uint32_t ehci_isoc_trans_t;
203 typedef uint32_t ehci_isoc_bufr_ptr_t;
204 
205 /* Isochronous Transfer Descriptor */
206 #define EHCI_ITD_ALIGN 32
207 #define EHCI_ITD_NUFRAMES USB_UFRAMES_PER_FRAME
208 #define EHCI_ITD_NBUFFERS 7
209 typedef struct ehci_itd_t {
210           volatile ehci_link_t                    itd_next;
211           volatile ehci_isoc_trans_t    itd_ctl[EHCI_ITD_NUFRAMES];
212 #define EHCI_ITD_STATUS_MASK  __BITS(31,28)
213 #define EHCI_ITD_GET_STATUS(x)          __SHIFTOUT((x), EHCI_ITD_STATUS_MASK)
214 #define EHCI_ITD_SET_STATUS(x)          __SHIFTIN((x), EHCI_ITD_STATUS_MASK)
215 #define EHCI_ITD_ACTIVE                 __BIT(31)
216 #define EHCI_ITD_BUF_ERR      __BIT(30)
217 #define EHCI_ITD_BABBLE                 __BIT(29)
218 #define EHCI_ITD_ERROR                  __BIT(28)
219 #define EHCI_ITD_LEN_MASK     __BITS(27,16)
220 #define EHCI_ITD_GET_LEN(x)   __SHIFTOUT((x), EHCI_ITD_LEN_MASK)
221 #define EHCI_ITD_SET_LEN(x)   __SHIFTIN((x), EHCI_ITD_LEN_MASK)
222 #define EHCI_ITD_IOC                    __BIT(15)
223 #define EHCI_ITD_GET_IOC(x)   __SHIFTOUT((x), EHCI_ITD_IOC)
224 #define EHCI_ITD_SET_IOC(x)   __SHIFTIN((x), EHCI_ITD_IOC)
225 #define EHCI_ITD_PG_MASK      __BITS(14,12)
226 #define EHCI_ITD_GET_PG(x)    __SHIFTOUT((x), EHCI_ITD_PG_MASK)
227 #define EHCI_ITD_SET_PG(x)    __SHIFTIN((x), EHCI_ITD_PG_MASK)
228 #define EHCI_ITD_OFFSET_MASK  __BITS(11,0)
229 #define EHCI_ITD_GET_OFFS(x)  __SHIFTOUT((x), EHCI_ITD_OFFSET_MASK)
230 #define EHCI_ITD_SET_OFFS(x)  __SHIFTIN((x), EHCI_ITD_OFFSET_MASK)
231           volatile ehci_isoc_bufr_ptr_t itd_bufr[EHCI_ITD_NBUFFERS];
232 #define EHCI_ITD_BPTR_MASK    __BITS(31,12)
233 #define EHCI_ITD_GET_BPTR(x)  ((x) & EHCI_ITD_BPTR_MASK)
234 #define EHCI_ITD_SET_BPTR(x)  ((x) & EHCI_ITD_BPTR_MASK)
235 #define EHCI_ITD_EP_MASK      __BITS(11,8)
236 #define EHCI_ITD_GET_EP(x)    __SHIFTOUT((x), EHCI_ITD_EP_MASK)
237 #define EHCI_ITD_SET_EP(x)    __SHIFTIN((x), EHCI_ITD_EP_MASK)
238 #define EHCI_ITD_DADDR_MASK   __BITS(6,0)
239 #define EHCI_ITD_GET_DADDR(x) __SHIFTOUT((x), EHCI_ITD_DADDR_MASK)
240 #define EHCI_ITD_SET_DADDR(x) __SHIFTIN((x), EHCI_ITD_DADDR_MASK)
241 #define EHCI_ITD_DIR_MASK     __BIT(11)
242 #define EHCI_ITD_GET_DIR(x)   __SHIFTOUT((x), EHCI_ITD_DIR_MASK)
243 #define EHCI_ITD_SET_DIR(x)   __SHIFTIN((x), EHCI_ITD_DIR_MASK)
244 #define EHCI_ITD_MAXPKT_MASK  __BITS(10,0)
245 #define EHCI_ITD_GET_MAXPKT(x)          __SHIFTOUT((x), EHCI_ITD_MAXPKT_MASK)
246 #define EHCI_ITD_SET_MAXPKT(x)          __SHIFTIN((x), EHCI_ITD_MAXPKT_MASK)
247 #define EHCI_ITD_MULTI_MASK   __BITS(1,0)
248 #define EHCI_ITD_GET_MULTI(x) __SHIFTOUT((x), EHCI_ITD_MULTI_MASK)
249 #define EHCI_ITD_SET_MULTI(x) __SHIFTIN((x), EHCI_ITD_MULTI_MASK)
250           volatile ehci_isoc_bufr_ptr_t itd_bufr_hi[EHCI_ITD_NBUFFERS];
251 } ehci_itd_t;
252 #define EHCI_ITD_ALLOC_ALIGN  MAX(EHCI_ITD_ALIGN, CACHE_LINE_SIZE)
253 #define EHCI_ITD_SIZE                   (roundup(sizeof(ehci_itd_t), EHCI_ITD_ALLOC_ALIGN))
254 #define EHCI_ITD_CHUNK                  (EHCI_PAGE_SIZE / EHCI_ITD_SIZE)
255 
256 /* Split Transaction Isochronous Transfer Descriptor */
257 #define EHCI_SITD_ALIGN 32
258 typedef struct ehci_sitd_t {
259           volatile ehci_link_t          sitd_next;
260           volatile uint32_t   sitd_endp;
261 #define EHCI_SITD_DIR_MASK    __BIT(31)
262 #define EHCI_SITD_PORT_MASK   __BITS(30,24)
263 #define EHCI_SITD_HUBA_MASK   __BITS(22,16)
264 #define EHCI_SITD_ENDPT_MASK  __BITS(11,8)
265 #define EHCI_SITD_DADDR_MASK  __BITS(6,0)
266 #define EHCI_SITD_SET_DIR(x)  __SHIFTIN((x), EHCI_SITD_DIR_MASK)
267 #define EHCI_SITD_SET_PORT(x) __SHIFTIN((x), EHCI_SITD_PORT_MASK)
268 #define EHCI_SITD_SET_HUBA(x) __SHIFTIN((x), EHCI_SITD_HUBA_MASK)
269 #define EHCI_SITD_SET_ENDPT(x)          __SHIFTIN((x), EHCI_SITD_ENDPT_MASK)
270 #define EHCI_SITD_SET_DADDR(x)          __SHIFTIN((x), EHCI_SITD_DADDR_MASK)
271           volatile uint32_t   sitd_sched;
272 #define EHCI_SITD_SMASK_MASK  __BITS(7,0)
273 #define EHCI_SITD_CMASK_MASK  __BITS(15,8)
274 #define EHCI_SITD_SET_SMASK(x)          __SHIFTIN((x), EHCI_SITD_SMASK_MASK)
275 #define EHCI_SITD_SET_CMASK(x)          __SHIFTIN((x), EHCI_SITD_CMASK_MASK)
276           volatile uint32_t   sitd_trans;
277 #define EHCI_SITD_IOC                   __BIT(31)
278 #define EHCI_SITD_P           __BIT(30)
279 #define EHCI_SITD_LENGTH_MASK __BITS(25,16)
280 #define EHCI_SITD_GET_LEN(x)  __SHIFTOUT((x), EHCI_SITD_LENGTH_MASK)
281 #define EHCI_SITD_SET_LEN(x)  __SHIFTIN((x), EHCI_SITD_LENGTH_MASK)
282 #define EHCI_SITD_STATUS_MASK __BITS(7,0)
283 #define EHCI_SITD_ACTIVE      0x00000080
284 #define EHCI_SITD_ERR                   0x00000040
285 #define EHCI_SITD_BUFERR      0x00000020
286 #define EHCI_SITD_BABBLE      0x00000010
287 #define EHCI_SITD_XACTERR     0x00000008
288 #define EHCI_SITD_MISS                  0x00000004
289 #define EHCI_SITD_SPLITXSTATE 0x00000002
290 
291 #define EHCI_SITD_BUFFERS     2
292 
293           volatile uint32_t   sitd_buffer[EHCI_SITD_BUFFERS];
294 #define EHCI_SITD_SET_BPTR(x) ((x) & 0xfffff000)
295 #define EHCI_SITD_SET_OFFS(x) ((x) & 0xfff)
296 #define EHCI_SITD_TP_MASK     __BITS(4,3)
297 #define EHCI_SITD_TCOUNT_MASK __BITS(2,0)
298 
299           volatile ehci_link_t          sitd_back;
300           volatile uint32_t   sitd_buffer_hi[EHCI_SITD_BUFFERS];
301 } ehci_sitd_t;
302 
303 /* Queue Element Transfer Descriptor */
304 #define EHCI_QTD_NBUFFERS     5
305 #define EHCI_QTD_MAXTRANSFER  (EHCI_QTD_NBUFFERS * EHCI_PAGE_SIZE)
306 #define EHCI_QTD_ALIGN 32
307 typedef struct ehci_qtd_t {
308           volatile ehci_link_t          qtd_next;
309           volatile ehci_link_t          qtd_altnext;
310           volatile uint32_t   qtd_status;
311 #define EHCI_QTD_STATUS_MASK  __BITS(7,0)
312 #define EHCI_QTD_GET_STATUS(x)          __SHIFTOUT((x), EHCI_QTD_STATUS_MASK)
313 #define EHCI_QTD_SET_STATUS(x)          __SHIFTIN((x), EHCI_QTD_STATUS_MASK)
314 #define  EHCI_QTD_ACTIVE      0x80
315 #define  EHCI_QTD_HALTED      0x40
316 #define  EHCI_QTD_BUFERR      0x20
317 #define  EHCI_QTD_BABBLE      0x10
318 #define  EHCI_QTD_XACTERR     0x08
319 #define  EHCI_QTD_MISSEDMICRO 0x04
320 #define  EHCI_QTD_SPLITXSTATE 0x02
321 #define  EHCI_QTD_PINGSTATE   0x01
322 #define  EHCI_QTD_STATERRS    0x3c
323 #define EHCI_QTD_PID_MASK     __BITS(9,8)
324 #define EHCI_QTD_GET_PID(x)   __SHIFTOUT((x), EHCI_QTD_PID_MASK)
325 #define EHCI_QTD_SET_PID(x)   __SHIFTIN((x), EHCI_QTD_PID_MASK)
326 #define  EHCI_QTD_PID_OUT     0x0
327 #define  EHCI_QTD_PID_IN      0x1
328 #define  EHCI_QTD_PID_SETUP   0x2
329 #define EHCI_QTD_CERR_MASK    __BITS(11,10)
330 #define EHCI_QTD_GET_CERR(x)  __SHIFTOUT((x), EHCI_QTD_CERR_MASK)
331 #define EHCI_QTD_SET_CERR(x)  __SHIFTIN((x), EHCI_QTD_CERR_MASK)
332 #define EHCI_QTD_C_PAGE_MASK  __BITS(14,12)
333 #define EHCI_QTD_GET_C_PAGE(x)          __SHIFTOUT((x), EHCI_QTD_C_PAGE_MASK)
334 #define EHCI_QTD_SET_C_PAGE(x)          __SHIFTIN((x), EHCI_QTD_C_PAGE_MASK)
335 #define EHCI_QTD_IOC                    __BIT(15)
336 #define EHCI_QTD_GET_IOC(x)   __SHIFTOUT((x), EHCI_QTD_IOC)
337 #define EHCI_QTD_BYTES_MASK   __BITS(30,16)
338 #define EHCI_QTD_GET_BYTES(x) __SHIFTOUT((x), EHCI_QTD_BYTES_MASK)
339 #define EHCI_QTD_SET_BYTES(x) __SHIFTIN((x), EHCI_QTD_BYTES_MASK)
340 #define EHCI_QTD_TOGGLE_MASK  __BIT(31)
341 #define EHCI_QTD_GET_TOGGLE(x)          __SHIFTOUT((x), EHCI_QTD_TOGGLE_MASK)
342 #define   EHCI_QTD_SET_TOGGLE(x)        __SHIFTIN((x), EHCI_QTD_TOGGLE_MASK)
343           volatile ehci_physaddr_t qtd_buffer[EHCI_QTD_NBUFFERS];
344           volatile ehci_physaddr_t qtd_buffer_hi[EHCI_QTD_NBUFFERS];
345 } ehci_qtd_t;
346 #define EHCI_QTD_ALLOC_ALIGN  MAX(EHCI_QTD_ALIGN, CACHE_LINE_SIZE)
347 #define EHCI_QTD_SIZE                   (roundup(sizeof(ehci_qtd_t), EHCI_QTD_ALLOC_ALIGN))
348 #define EHCI_QTD_CHUNK                  (EHCI_PAGE_SIZE / EHCI_QTD_SIZE)
349 
350 /* Queue Head */
351 #define EHCI_QH_ALIGN 32
352 typedef struct ehci_qh_t {
353           volatile ehci_link_t          qh_link;
354           volatile uint32_t   qh_endp;
355 #define EHCI_QH_ADDR_MASK     __BITS(6,0)         /* endpoint addr */
356 #define EHCI_QH_GET_ADDR(x)   __SHIFTOUT((x), EHCI_QH_ADDR_MASK)
357 #define EHCI_QH_SET_ADDR(x)   __SHIFTIN((x), EHCI_QH_ADDR_MASK)
358 #define EHCI_QH_INACT                   __BIT(7)  /* inactivate on next */
359 #define EHCI_QH_GET_INACT(x)  __SHIFTOUT((x), EHCI_QH_INACT)
360 #define EHCI_QH_ENDPT_MASK    __BITS(11,8)         /* endpoint no */
361 #define EHCI_QH_GET_ENDPT(x)  __SHIFTOUT((x), EHCI_QH_ENDPT_MASK)
362 #define EHCI_QH_SET_ENDPT(x)  __SHIFTIN((x), EHCI_QH_ENDPT_MASK)
363 #define EHCI_QH_EPS_MASK      __BITS(13,12)       /* endpoint speed */
364 #define EHCI_QH_GET_EPS(x)    __SHIFTOUT((x), EHCI_QH_EPS_MASK)
365 #define EHCI_QH_SET_EPS(x)    __SHIFTIN((x), EHCI_QH_EPS_MASK)
366 #define  EHCI_QH_SPEED_FULL   0x0
367 #define  EHCI_QH_SPEED_LOW    0x1
368 #define  EHCI_QH_SPEED_HIGH   0x2
369 #define EHCI_QH_DTC           __BIT(14)  /* data toggle control */
370 #define EHCI_QH_GET_DTC(x)    __SHIFTOUT((x), EHCI_QH_DTC)
371 #define EHCI_QH_HRECL                   __BIT(15) /* head of reclamation */
372 #define EHCI_QH_GET_HRECL(x)  __SHIFTOUT((x), EHCI_QH_HRECL)
373 #define EHCI_QH_MPL_MASK      __BITS(26,16)       /* max packet len */
374 #define EHCI_QH_GET_MPL(x)    __SHIFTOUT((x), EHCI_QH_MPL_MASK)
375 #define EHCI_QH_SET_MPL(x)    __SHIFTIN((x), EHCI_QH_MPL_MASK)
376 #define EHCI_QH_CTL           __BIT(27) /* control endpoint */
377 #define EHCI_QH_GET_CTL(x)    __SHIFTOUT((x), EHCI_QH_CTL)
378 #define EHCI_QH_NRL_MASK      __BITS(31,28)       /* NAK reload */
379 #define EHCI_QH_GET_NRL(x)    __SHIFTOUT((x), EHCI_QH_NRL_MASK)
380 #define EHCI_QH_SET_NRL(x)    __SHIFTIN((x), EHCI_QH_NRL_MASK)
381           volatile uint32_t   qh_endphub;
382 #define EHCI_QH_SMASK_MASK    __BITS(7,0)          /* intr sched mask */
383 #define EHCI_QH_GET_SMASK(x)  __SHIFTOUT((x), EHCI_QH_SMASK_MASK)
384 #define EHCI_QH_SET_SMASK(x)  __SHIFTIN((x), EHCI_QH_SMASK_MASK)
385 #define EHCI_QH_CMASK_MASK    __BITS(15,8)         /* split completion mask */
386 #define EHCI_QH_GET_CMASK(x)  __SHIFTOUT((x), EHCI_QH_CMASK_MASK)
387 #define EHCI_QH_SET_CMASK(x)  __SHIFTIN((x), EHCI_QH_CMASK_MASK)
388 #define EHCI_QH_HUBA_MASK     __BITS(22,16)       /* hub address */
389 #define EHCI_QH_GET_HUBA(x)   __SHIFTOUT((x), EHCI_QH_HUBA_MASK)
390 #define EHCI_QH_SET_HUBA(x)   __SHIFTIN((x), EHCI_QH_HUBA_MASK)
391 #define EHCI_QH_PORT_MASK     __BITS(29,23)        /* hub port */
392 #define EHCI_QH_GET_PORT(x)   __SHIFTOUT((x), EHCI_QH_PORT_MASK)
393 #define EHCI_QH_SET_PORT(x)   __SHIFTIN((x), EHCI_QH_PORT_MASK)
394 #define EHCI_QH_MULTI_MASK    __BITS(31,30)       /* pipe multiplier */
395 #define EHCI_QH_GET_MULT(x)   __SHIFTOUT((x), EHCI_QH_MULTI_MASK)
396 #define EHCI_QH_SET_MULT(x)   __SHIFTIN((x), EHCI_QH_MULTI_MASK)
397           volatile ehci_link_t          qh_curqtd;
398           ehci_qtd_t                    qh_qtd;
399 } ehci_qh_t;
400 #define EHCI_QH_ALLOC_ALIGN   MAX(EHCI_QH_ALIGN, CACHE_LINE_SIZE)
401 #define EHCI_QH_SIZE                    (roundup(sizeof(ehci_qh_t), EHCI_QH_ALLOC_ALIGN))
402 #define EHCI_QH_CHUNK                   (EHCI_PAGE_SIZE / EHCI_QH_SIZE)
403 
404 /* Periodic Frame Span Traversal Node */
405 #define EHCI_FSTN_ALIGN 32
406 typedef struct ehci_fstn_t {
407           volatile ehci_link_t          fstn_link;
408           volatile ehci_link_t          fstn_back;
409 } ehci_fstn_t;
410 
411 /* Debug Port */
412 #define PCI_CAP_DEBUGPORT_OFFSET __BITS(28,16)
413 #define PCI_CAP_DEBUGPORT_BAR __BITS(31,29)
414 /* Debug Port Registers, offset into DEBUGPORT_BAR at DEBUGPORT_OFFSET */
415 #define EHCI_DEBUG_SC                   0x00
416 /* Status/Control Register */
417 #define  EHCI_DSC_DATA_LENGTH __BITS(3,0)
418 #define  EHCI_DSC_WRITE                 __BIT(4)
419 #define  EHCI_DSC_GO                    __BIT(5)
420 #define  EHCI_DSC_ERROR                 __BIT(6)
421 #define  EHCI_DSC_EXCEPTION   __BITS(9,7)
422 #define   EHCI_DSC_EXCEPTION_NONE       0
423 #define   EHCI_DSC_EXCEPTION_XACT       1
424 #define   EHCI_DSC_EXCEPTION_HW                   2
425 #define  EHCI_DSC_IN_USE      __BIT(10)
426 #define  EHCI_DSC_DONE                  __BIT(16)
427 #define  EHCI_DSC_ENABLED     __BIT(28)
428 #define  EHCI_DSC_OWNER                 __BIT(30)
429 #define EHCI_DEBUG_UPR                  0x04
430 /* USB PIDs Register */
431 #define  EHCI_DPR_TOKEN                 __BITS(7,0)
432 #define  EHCI_DPR_SEND                  __BITS(15,8)
433 #define  EHCI_DPR_RECEIVED    __BITS(23,16)
434 /* Data Registers */
435 #define EHCI_DEBUG_DATA0123   0x08
436 #define EHCI_DEBUG_DATA4567   0x0c
437 #define EHCI_DEBUG_DAR                  0x10
438 /* Device Address Register */
439 #define  EHCI_DAR_ENDPOINT    __BITS(3,0)
440 #define  EHCI_DAR_ADDRESS     __BITS(14,8)
441 
442 #endif /* _DEV_USB_EHCIREG_H_ */
443