xref: /freebsd/sys/dev/usb/controller/ehcireg.h (revision 71625ec9ad2a9bc8c09784fbd23b759830e0ee5f)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause
3  *
4  * Copyright (c) 2001 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 #ifndef _EHCIREG_H_
33 #define	_EHCIREG_H_
34 
35 /* PCI config registers  */
36 #define	PCI_CBMEM		0x10	/* configuration base MEM */
37 #define	PCI_INTERFACE_EHCI	0x20
38 #define	PCI_USBREV		0x60	/* RO USB protocol revision */
39 #define	PCI_USB_REV_MASK	0xff
40 #define	PCI_USB_REV_PRE_1_0	0x00
41 #define	PCI_USB_REV_1_0		0x10
42 #define	PCI_USB_REV_1_1		0x11
43 #define	PCI_USB_REV_2_0		0x20
44 #define	PCI_EHCI_FLADJ		0x61	/* RW Frame len adj, SOF=59488+6*fladj */
45 #define	PCI_EHCI_PORTWAKECAP	0x62	/* RW Port wake caps (opt)  */
46 
47 /* EHCI Extended Capabilities */
48 #define	EHCI_EC_LEGSUP		0x01
49 #define	EHCI_EECP_NEXT(x)	(((x) >> 8) & 0xff)
50 #define	EHCI_EECP_ID(x)		((x) & 0xff)
51 
52 /* Legacy support extended capability */
53 #define	EHCI_LEGSUP_BIOS_SEM		0x02
54 #define	EHCI_LEGSUP_OS_SEM		0x03
55 #define	EHCI_LEGSUP_USBLEGCTLSTS	0x04
56 
57 /* EHCI capability registers */
58 #define	EHCI_CAPLEN_HCIVERSION	0x00	/* RO Capability register length
59 					 * (least-significant byte) and
60 					 * interface version number (two
61 					 * most significant)
62 					 */
63 #define EHCI_CAPLENGTH(x)	((x) & 0xff)
64 #define EHCI_HCIVERSION(x)	(((x) >> 16) & 0xffff)
65 #define	EHCI_HCSPARAMS		0x04	/* RO Structural parameters */
66 #define	EHCI_HCS_DEBUGPORT(x)	(((x) >> 20) & 0xf)
67 #define	EHCI_HCS_P_INDICATOR(x) ((x) & 0x10000)
68 #define	EHCI_HCS_N_CC(x)	(((x) >> 12) & 0xf)	/* # of companion ctlrs */
69 #define	EHCI_HCS_N_PCC(x)	(((x) >> 8) & 0xf)	/* # of ports per comp. */
70 #define	EHCI_HCS_PPC(x)		((x) & 0x10)	/* port power control */
71 #define	EHCI_HCS_N_PORTS(x)	((x) & 0xf)	/* # of ports */
72 #define	EHCI_HCCPARAMS		0x08	/* RO Capability parameters */
73 #define	EHCI_HCC_EECP(x)	(((x) >> 8) & 0xff)	/* extended ports caps */
74 #define	EHCI_HCC_IST(x)		(((x) >> 4) & 0xf)	/* isoc sched threshold */
75 #define	EHCI_HCC_ASPC(x)	((x) & 0x4)	/* async sched park cap */
76 #define	EHCI_HCC_PFLF(x)	((x) & 0x2)	/* prog frame list flag */
77 #define	EHCI_HCC_64BIT(x)	((x) & 0x1)	/* 64 bit address cap */
78 #define	EHCI_HCSP_PORTROUTE	0x0c	/* RO Companion port route description */
79 
80 /* EHCI operational registers.  Offset given by EHCI_CAPLENGTH register */
81 #define	EHCI_USBCMD		0x00	/* RO, RW, WO Command register */
82 #define	EHCI_CMD_ITC_M		0x00ff0000	/* RW interrupt threshold ctrl */
83 #define	EHCI_CMD_ITC_1		0x00010000
84 #define	EHCI_CMD_ITC_2		0x00020000
85 #define	EHCI_CMD_ITC_4		0x00040000
86 #define	EHCI_CMD_ITC_8		0x00080000
87 #define	EHCI_CMD_ITC_16		0x00100000
88 #define	EHCI_CMD_ITC_32		0x00200000
89 #define	EHCI_CMD_ITC_64		0x00400000
90 #define	EHCI_CMD_ASPME		0x00000800	/* RW/RO async park enable */
91 #define	EHCI_CMD_ASPMC		0x00000300	/* RW/RO async park count */
92 #define	EHCI_CMD_LHCR		0x00000080	/* RW light host ctrl reset */
93 #define	EHCI_CMD_IAAD		0x00000040	/* RW intr on async adv door
94 						 * bell */
95 #define	EHCI_CMD_ASE		0x00000020	/* RW async sched enable */
96 #define	EHCI_CMD_PSE		0x00000010	/* RW periodic sched enable */
97 #define	EHCI_CMD_FLS_M		0x0000000c	/* RW/RO frame list size */
98 #define	EHCI_CMD_FLS(x)		(((x) >> 2) & 3)	/* RW/RO frame list size */
99 #define	EHCI_CMD_HCRESET	0x00000002	/* RW reset */
100 #define	EHCI_CMD_RS		0x00000001	/* RW run/stop */
101 #define	EHCI_USBSTS		0x04	/* RO, RW, RWC Status register */
102 #define	EHCI_STS_ASS		0x00008000	/* RO async sched status */
103 #define	EHCI_STS_PSS		0x00004000	/* RO periodic sched status */
104 #define	EHCI_STS_REC		0x00002000	/* RO reclamation */
105 #define	EHCI_STS_HCH		0x00001000	/* RO host controller halted */
106 #define	EHCI_STS_IAA		0x00000020	/* RWC interrupt on async adv */
107 #define	EHCI_STS_HSE		0x00000010	/* RWC host system error */
108 #define	EHCI_STS_FLR		0x00000008	/* RWC frame list rollover */
109 #define	EHCI_STS_PCD		0x00000004	/* RWC port change detect */
110 #define	EHCI_STS_ERRINT		0x00000002	/* RWC error interrupt */
111 #define	EHCI_STS_INT		0x00000001	/* RWC interrupt */
112 #define	EHCI_STS_INTRS(x)	((x) & 0x3f)
113 
114 /*
115  * NOTE: the doorbell interrupt is enabled, but the doorbell is never
116  * used! SiS chipsets require this.
117  */
118 #define	EHCI_NORMAL_INTRS	(EHCI_STS_IAA | EHCI_STS_HSE |	\
119 				EHCI_STS_PCD | EHCI_STS_ERRINT | EHCI_STS_INT)
120 
121 #define	EHCI_USBINTR		0x08	/* RW Interrupt register */
122 #define	EHCI_INTR_IAAE		0x00000020	/* interrupt on async advance
123 						 * ena */
124 #define	EHCI_INTR_HSEE		0x00000010	/* host system error ena */
125 #define	EHCI_INTR_FLRE		0x00000008	/* frame list rollover ena */
126 #define	EHCI_INTR_PCIE		0x00000004	/* port change ena */
127 #define	EHCI_INTR_UEIE		0x00000002	/* USB error intr ena */
128 #define	EHCI_INTR_UIE		0x00000001	/* USB intr ena */
129 
130 #define	EHCI_FRINDEX		0x0c	/* RW Frame Index register */
131 
132 #define	EHCI_CTRLDSSEGMENT	0x10	/* RW Control Data Structure Segment */
133 
134 #define	EHCI_PERIODICLISTBASE	0x14	/* RW Periodic List Base */
135 #define	EHCI_ASYNCLISTADDR	0x18	/* RW Async List Base */
136 
137 #define	EHCI_CONFIGFLAG		0x40	/* RW Configure Flag register */
138 #define	EHCI_CONF_CF		0x00000001	/* RW configure flag */
139 
140 #define	EHCI_PORTSC(n)		(0x40+(4*(n)))	/* RO, RW, RWC Port Status reg */
141 #define	EHCI_PS_WKOC_E		0x00400000	/* RW wake on over current ena */
142 #define	EHCI_PS_WKDSCNNT_E	0x00200000	/* RW wake on disconnect ena */
143 #define	EHCI_PS_WKCNNT_E	0x00100000	/* RW wake on connect ena */
144 #define	EHCI_PS_PTC		0x000f0000	/* RW port test control */
145 #define	EHCI_PS_PIC		0x0000c000	/* RW port indicator control */
146 #define	EHCI_PS_PO		0x00002000	/* RW port owner */
147 #define	EHCI_PS_PP		0x00001000	/* RW,RO port power */
148 #define	EHCI_PS_LS		0x00000c00	/* RO line status */
149 #define	EHCI_PS_IS_LOWSPEED(x)	(((x) & EHCI_PS_LS) == 0x00000400)
150 #define	EHCI_PS_PR		0x00000100	/* RW port reset */
151 #define	EHCI_PS_SUSP		0x00000080	/* RW suspend */
152 #define	EHCI_PS_FPR		0x00000040	/* RW force port resume */
153 #define	EHCI_PS_OCC		0x00000020	/* RWC over current change */
154 #define	EHCI_PS_OCA		0x00000010	/* RO over current active */
155 #define	EHCI_PS_PEC		0x00000008	/* RWC port enable change */
156 #define	EHCI_PS_PE		0x00000004	/* RW port enable */
157 #define	EHCI_PS_CSC		0x00000002	/* RWC connect status change */
158 #define	EHCI_PS_CS		0x00000001	/* RO connect status */
159 #define	EHCI_PS_CLEAR		(EHCI_PS_OCC | EHCI_PS_PEC | EHCI_PS_CSC)
160 
161 #define	EHCI_PORT_RESET_COMPLETE	2	/* ms */
162 
163 /*
164  * Registers not covered by EHCI specification
165  *
166  *
167  * EHCI_USBMODE register offset is different for cores with LPM support,
168  * bits are equal
169  */
170 #define	EHCI_USBMODE_NOLPM	0x68	/* RW USB Device mode reg (no LPM) */
171 #define	EHCI_USBMODE_LPM	0xC8	/* RW USB Device mode reg (LPM) */
172 #define	EHCI_UM_CM		0x00000003	/* R/WO Controller Mode */
173 #define	EHCI_UM_CM_IDLE		0x0	/* Idle */
174 #define	EHCI_UM_CM_HOST		0x3	/* Host Controller */
175 #define	EHCI_UM_ES		0x00000004	/* R/WO Endian Select */
176 #define	EHCI_UM_ES_LE		0x0	/* Little-endian byte alignment */
177 #define	EHCI_UM_ES_BE		0x4	/* Big-endian byte alignment */
178 #define	EHCI_UM_SDIS		0x00000010	/* R/WO Stream Disable Mode */
179 
180 /*
181  * Actual port speed bits depends on EHCI_HOSTC(n) registers presence,
182  * speed encoding is equal
183  */
184 #define	EHCI_HOSTC(n)		(0x80+(4*(n)))	/* RO, RW Host mode control reg */
185 #define	EHCI_HOSTC_PSPD_SHIFT	25
186 #define	EHCI_HOSTC_PSPD_MASK	0x3
187 
188 #define	EHCI_PORTSC_PSPD_SHIFT	26
189 #define	EHCI_PORTSC_PSPD_MASK	0x3
190 
191 #define	EHCI_PORT_SPEED_FULL	0
192 #define	EHCI_PORT_SPEED_LOW	1
193 #define	EHCI_PORT_SPEED_HIGH	2
194 #endif	/* _EHCIREG_H_ */
195