xref: /freebsd/sys/dev/usb/controller/ehcireg.h (revision cfd6422a5217410fbd66f7a7a8a64d9d85e61229)
1 /* $FreeBSD$ */
2 /*-
3  * SPDX-License-Identifier: BSD-2-Clause-NetBSD
4  *
5  * Copyright (c) 2001 The NetBSD Foundation, Inc.
6  * All rights reserved.
7  *
8  * This code is derived from software contributed to The NetBSD Foundation
9  * by Lennart Augustsson (lennart@augustsson.net).
10  *
11  * Redistribution and use in source and binary forms, with or without
12  * modification, are permitted provided that the following conditions
13  * are met:
14  * 1. Redistributions of source code must retain the above copyright
15  *    notice, this list of conditions and the following disclaimer.
16  * 2. Redistributions in binary form must reproduce the above copyright
17  *    notice, this list of conditions and the following disclaimer in the
18  *    documentation and/or other materials provided with the distribution.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
21  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
22  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
24  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30  * POSSIBILITY OF SUCH DAMAGE.
31  */
32 
33 #ifndef _EHCIREG_H_
34 #define	_EHCIREG_H_
35 
36 /* PCI config registers  */
37 #define	PCI_CBMEM		0x10	/* configuration base MEM */
38 #define	PCI_INTERFACE_EHCI	0x20
39 #define	PCI_USBREV		0x60	/* RO USB protocol revision */
40 #define	PCI_USB_REV_MASK	0xff
41 #define	PCI_USB_REV_PRE_1_0	0x00
42 #define	PCI_USB_REV_1_0		0x10
43 #define	PCI_USB_REV_1_1		0x11
44 #define	PCI_USB_REV_2_0		0x20
45 #define	PCI_EHCI_FLADJ		0x61	/* RW Frame len adj, SOF=59488+6*fladj */
46 #define	PCI_EHCI_PORTWAKECAP	0x62	/* RW Port wake caps (opt)  */
47 
48 /* EHCI Extended Capabilities */
49 #define	EHCI_EC_LEGSUP		0x01
50 #define	EHCI_EECP_NEXT(x)	(((x) >> 8) & 0xff)
51 #define	EHCI_EECP_ID(x)		((x) & 0xff)
52 
53 /* Legacy support extended capability */
54 #define	EHCI_LEGSUP_BIOS_SEM		0x02
55 #define	EHCI_LEGSUP_OS_SEM		0x03
56 #define	EHCI_LEGSUP_USBLEGCTLSTS	0x04
57 
58 /* EHCI capability registers */
59 #define	EHCI_CAPLEN_HCIVERSION	0x00	/* RO Capability register length
60 					 * (least-significant byte) and
61 					 * interface version number (two
62 					 * most significant)
63 					 */
64 #define EHCI_CAPLENGTH(x)	((x) & 0xff)
65 #define EHCI_HCIVERSION(x)	(((x) >> 16) & 0xffff)
66 #define	EHCI_HCSPARAMS		0x04	/* RO Structural parameters */
67 #define	EHCI_HCS_DEBUGPORT(x)	(((x) >> 20) & 0xf)
68 #define	EHCI_HCS_P_INDICATOR(x) ((x) & 0x10000)
69 #define	EHCI_HCS_N_CC(x)	(((x) >> 12) & 0xf)	/* # of companion ctlrs */
70 #define	EHCI_HCS_N_PCC(x)	(((x) >> 8) & 0xf)	/* # of ports per comp. */
71 #define	EHCI_HCS_PPC(x)		((x) & 0x10)	/* port power control */
72 #define	EHCI_HCS_N_PORTS(x)	((x) & 0xf)	/* # of ports */
73 #define	EHCI_HCCPARAMS		0x08	/* RO Capability parameters */
74 #define	EHCI_HCC_EECP(x)	(((x) >> 8) & 0xff)	/* extended ports caps */
75 #define	EHCI_HCC_IST(x)		(((x) >> 4) & 0xf)	/* isoc sched threshold */
76 #define	EHCI_HCC_ASPC(x)	((x) & 0x4)	/* async sched park cap */
77 #define	EHCI_HCC_PFLF(x)	((x) & 0x2)	/* prog frame list flag */
78 #define	EHCI_HCC_64BIT(x)	((x) & 0x1)	/* 64 bit address cap */
79 #define	EHCI_HCSP_PORTROUTE	0x0c	/* RO Companion port route description */
80 
81 /* EHCI operational registers.  Offset given by EHCI_CAPLENGTH register */
82 #define	EHCI_USBCMD		0x00	/* RO, RW, WO Command register */
83 #define	EHCI_CMD_ITC_M		0x00ff0000	/* RW interrupt threshold ctrl */
84 #define	EHCI_CMD_ITC_1		0x00010000
85 #define	EHCI_CMD_ITC_2		0x00020000
86 #define	EHCI_CMD_ITC_4		0x00040000
87 #define	EHCI_CMD_ITC_8		0x00080000
88 #define	EHCI_CMD_ITC_16		0x00100000
89 #define	EHCI_CMD_ITC_32		0x00200000
90 #define	EHCI_CMD_ITC_64		0x00400000
91 #define	EHCI_CMD_ASPME		0x00000800	/* RW/RO async park enable */
92 #define	EHCI_CMD_ASPMC		0x00000300	/* RW/RO async park count */
93 #define	EHCI_CMD_LHCR		0x00000080	/* RW light host ctrl reset */
94 #define	EHCI_CMD_IAAD		0x00000040	/* RW intr on async adv door
95 						 * bell */
96 #define	EHCI_CMD_ASE		0x00000020	/* RW async sched enable */
97 #define	EHCI_CMD_PSE		0x00000010	/* RW periodic sched enable */
98 #define	EHCI_CMD_FLS_M		0x0000000c	/* RW/RO frame list size */
99 #define	EHCI_CMD_FLS(x)		(((x) >> 2) & 3)	/* RW/RO frame list size */
100 #define	EHCI_CMD_HCRESET	0x00000002	/* RW reset */
101 #define	EHCI_CMD_RS		0x00000001	/* RW run/stop */
102 #define	EHCI_USBSTS		0x04	/* RO, RW, RWC Status register */
103 #define	EHCI_STS_ASS		0x00008000	/* RO async sched status */
104 #define	EHCI_STS_PSS		0x00004000	/* RO periodic sched status */
105 #define	EHCI_STS_REC		0x00002000	/* RO reclamation */
106 #define	EHCI_STS_HCH		0x00001000	/* RO host controller halted */
107 #define	EHCI_STS_IAA		0x00000020	/* RWC interrupt on async adv */
108 #define	EHCI_STS_HSE		0x00000010	/* RWC host system error */
109 #define	EHCI_STS_FLR		0x00000008	/* RWC frame list rollover */
110 #define	EHCI_STS_PCD		0x00000004	/* RWC port change detect */
111 #define	EHCI_STS_ERRINT		0x00000002	/* RWC error interrupt */
112 #define	EHCI_STS_INT		0x00000001	/* RWC interrupt */
113 #define	EHCI_STS_INTRS(x)	((x) & 0x3f)
114 
115 /*
116  * NOTE: the doorbell interrupt is enabled, but the doorbell is never
117  * used! SiS chipsets require this.
118  */
119 #define	EHCI_NORMAL_INTRS	(EHCI_STS_IAA | EHCI_STS_HSE |	\
120 				EHCI_STS_PCD | EHCI_STS_ERRINT | EHCI_STS_INT)
121 
122 #define	EHCI_USBINTR		0x08	/* RW Interrupt register */
123 #define	EHCI_INTR_IAAE		0x00000020	/* interrupt on async advance
124 						 * ena */
125 #define	EHCI_INTR_HSEE		0x00000010	/* host system error ena */
126 #define	EHCI_INTR_FLRE		0x00000008	/* frame list rollover ena */
127 #define	EHCI_INTR_PCIE		0x00000004	/* port change ena */
128 #define	EHCI_INTR_UEIE		0x00000002	/* USB error intr ena */
129 #define	EHCI_INTR_UIE		0x00000001	/* USB intr ena */
130 
131 #define	EHCI_FRINDEX		0x0c	/* RW Frame Index register */
132 
133 #define	EHCI_CTRLDSSEGMENT	0x10	/* RW Control Data Structure Segment */
134 
135 #define	EHCI_PERIODICLISTBASE	0x14	/* RW Periodic List Base */
136 #define	EHCI_ASYNCLISTADDR	0x18	/* RW Async List Base */
137 
138 #define	EHCI_CONFIGFLAG		0x40	/* RW Configure Flag register */
139 #define	EHCI_CONF_CF		0x00000001	/* RW configure flag */
140 
141 #define	EHCI_PORTSC(n)		(0x40+(4*(n)))	/* RO, RW, RWC Port Status reg */
142 #define	EHCI_PS_WKOC_E		0x00400000	/* RW wake on over current ena */
143 #define	EHCI_PS_WKDSCNNT_E	0x00200000	/* RW wake on disconnect ena */
144 #define	EHCI_PS_WKCNNT_E	0x00100000	/* RW wake on connect ena */
145 #define	EHCI_PS_PTC		0x000f0000	/* RW port test control */
146 #define	EHCI_PS_PIC		0x0000c000	/* RW port indicator control */
147 #define	EHCI_PS_PO		0x00002000	/* RW port owner */
148 #define	EHCI_PS_PP		0x00001000	/* RW,RO port power */
149 #define	EHCI_PS_LS		0x00000c00	/* RO line status */
150 #define	EHCI_PS_IS_LOWSPEED(x)	(((x) & EHCI_PS_LS) == 0x00000400)
151 #define	EHCI_PS_PR		0x00000100	/* RW port reset */
152 #define	EHCI_PS_SUSP		0x00000080	/* RW suspend */
153 #define	EHCI_PS_FPR		0x00000040	/* RW force port resume */
154 #define	EHCI_PS_OCC		0x00000020	/* RWC over current change */
155 #define	EHCI_PS_OCA		0x00000010	/* RO over current active */
156 #define	EHCI_PS_PEC		0x00000008	/* RWC port enable change */
157 #define	EHCI_PS_PE		0x00000004	/* RW port enable */
158 #define	EHCI_PS_CSC		0x00000002	/* RWC connect status change */
159 #define	EHCI_PS_CS		0x00000001	/* RO connect status */
160 #define	EHCI_PS_CLEAR		(EHCI_PS_OCC | EHCI_PS_PEC | EHCI_PS_CSC)
161 
162 #define	EHCI_PORT_RESET_COMPLETE	2	/* ms */
163 
164 /*
165  * Registers not covered by EHCI specification
166  *
167  *
168  * EHCI_USBMODE register offset is different for cores with LPM support,
169  * bits are equal
170  */
171 #define	EHCI_USBMODE_NOLPM	0x68	/* RW USB Device mode reg (no LPM) */
172 #define	EHCI_USBMODE_LPM	0xC8	/* RW USB Device mode reg (LPM) */
173 #define	EHCI_UM_CM		0x00000003	/* R/WO Controller Mode */
174 #define	EHCI_UM_CM_IDLE		0x0	/* Idle */
175 #define	EHCI_UM_CM_HOST		0x3	/* Host Controller */
176 #define	EHCI_UM_ES		0x00000004	/* R/WO Endian Select */
177 #define	EHCI_UM_ES_LE		0x0	/* Little-endian byte alignment */
178 #define	EHCI_UM_ES_BE		0x4	/* Big-endian byte alignment */
179 #define	EHCI_UM_SDIS		0x00000010	/* R/WO Stream Disable Mode */
180 
181 /*
182  * Actual port speed bits depends on EHCI_HOSTC(n) registers presence,
183  * speed encoding is equal
184  */
185 #define	EHCI_HOSTC(n)		(0x80+(4*(n)))	/* RO, RW Host mode control reg */
186 #define	EHCI_HOSTC_PSPD_SHIFT	25
187 #define	EHCI_HOSTC_PSPD_MASK	0x3
188 
189 #define	EHCI_PORTSC_PSPD_SHIFT	26
190 #define	EHCI_PORTSC_PSPD_MASK	0x3
191 
192 #define	EHCI_PORT_SPEED_FULL	0
193 #define	EHCI_PORT_SPEED_LOW	1
194 #define	EHCI_PORT_SPEED_HIGH	2
195 #endif	/* _EHCIREG_H_ */
196