FreeBSD kernel usb device Code
xhcireg.h
Go to the documentation of this file.
1
/* $FreeBSD$ */
2
3
/*-
4
* SPDX-License-Identifier: BSD-2-Clause-FreeBSD
5
*
6
* Copyright (c) 2010 Hans Petter Selasky. All rights reserved.
7
*
8
* Redistribution and use in source and binary forms, with or without
9
* modification, are permitted provided that the following conditions
10
* are met:
11
* 1. Redistributions of source code must retain the above copyright
12
* notice, this list of conditions and the following disclaimer.
13
* 2. Redistributions in binary form must reproduce the above copyright
14
* notice, this list of conditions and the following disclaimer in the
15
* documentation and/or other materials provided with the distribution.
16
*
17
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
21
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27
* SUCH DAMAGE.
28
*/
29
30
#ifndef _XHCIREG_H_
31
#define _XHCIREG_H_
32
33
/* XHCI PCI config registers */
34
#define PCI_XHCI_CBMEM 0x10
/* configuration base MEM */
35
#define PCI_XHCI_USBREV 0x60
/* RO USB protocol revision */
36
#define PCI_USB_REV_3_0 0x30
/* USB 3.0 */
37
#define PCI_XHCI_FLADJ 0x61
/* RW frame length adjust */
38
39
#define PCI_XHCI_INTEL_XUSB2PR 0xD0
/* Intel USB2 Port Routing */
40
#define PCI_XHCI_INTEL_USB2PRM 0xD4
/* Intel USB2 Port Routing Mask */
41
#define PCI_XHCI_INTEL_USB3_PSSEN 0xD8
/* Intel USB3 Port SuperSpeed Enable */
42
#define PCI_XHCI_INTEL_USB3PRM 0xDC
/* Intel USB3 Port Routing Mask */
43
44
/* XHCI capability registers */
45
#define XHCI_CAPLENGTH 0x00
/* RO capability */
46
#define XHCI_RESERVED 0x01
/* Reserved */
47
#define XHCI_HCIVERSION 0x02
/* RO Interface version number */
48
#define XHCI_HCIVERSION_0_9 0x0090
/* xHCI version 0.9 */
49
#define XHCI_HCIVERSION_1_0 0x0100
/* xHCI version 1.0 */
50
#define XHCI_HCSPARAMS1 0x04
/* RO structural parameters 1 */
51
#define XHCI_HCS1_DEVSLOT_MAX(x)((x) & 0xFF)
52
#define XHCI_HCS1_IRQ_MAX(x) (((x) >> 8) & 0x3FF)
53
#define XHCI_HCS1_N_PORTS(x) (((x) >> 24) & 0xFF)
54
#define XHCI_HCSPARAMS2 0x08
/* RO structural parameters 2 */
55
#define XHCI_HCS2_IST(x) ((x) & 0xF)
56
#define XHCI_HCS2_ERST_MAX(x) (((x) >> 4) & 0xF)
57
#define XHCI_HCS2_SPR(x) (((x) >> 26) & 0x1)
58
#define XHCI_HCS2_SPB_MAX(x) ((((x) >> 16) & 0x3E0) | (((x) >> 27) & 0x1F))
59
#define XHCI_HCSPARAMS3 0x0C
/* RO structural parameters 3 */
60
#define XHCI_HCS3_U1_DEL(x) ((x) & 0xFF)
61
#define XHCI_HCS3_U2_DEL(x) (((x) >> 16) & 0xFFFF)
62
#define XHCI_HCSPARAMS0 0x10
/* RO capability parameters */
63
#define XHCI_HCS0_AC64(x) ((x) & 0x1)
/* 64-bit capable */
64
#define XHCI_HCS0_BNC(x) (((x) >> 1) & 0x1)
/* BW negotiation */
65
#define XHCI_HCS0_CSZ(x) (((x) >> 2) & 0x1)
/* context size */
66
#define XHCI_HCS0_PPC(x) (((x) >> 3) & 0x1)
/* port power control */
67
#define XHCI_HCS0_PIND(x) (((x) >> 4) & 0x1)
/* port indicators */
68
#define XHCI_HCS0_LHRC(x) (((x) >> 5) & 0x1)
/* light HC reset */
69
#define XHCI_HCS0_LTC(x) (((x) >> 6) & 0x1)
/* latency tolerance msg */
70
#define XHCI_HCS0_NSS(x) (((x) >> 7) & 0x1)
/* no secondary sid */
71
#define XHCI_HCS0_PSA_SZ_MAX(x) (((x) >> 12) & 0xF)
/* max pri. stream array size */
72
#define XHCI_HCS0_XECP(x) (((x) >> 16) & 0xFFFF)
/* extended capabilities pointer */
73
#define XHCI_DBOFF 0x14
/* RO doorbell offset */
74
#define XHCI_RTSOFF 0x18
/* RO runtime register space offset */
75
76
/* XHCI operational registers. Offset given by XHCI_CAPLENGTH register */
77
#define XHCI_USBCMD 0x00
/* XHCI command */
78
#define XHCI_CMD_RS 0x00000001
/* RW Run/Stop */
79
#define XHCI_CMD_HCRST 0x00000002
/* RW Host Controller Reset */
80
#define XHCI_CMD_INTE 0x00000004
/* RW Interrupter Enable */
81
#define XHCI_CMD_HSEE 0x00000008
/* RW Host System Error Enable */
82
#define XHCI_CMD_LHCRST 0x00000080
/* RO/RW Light Host Controller Reset */
83
#define XHCI_CMD_CSS 0x00000100
/* RW Controller Save State */
84
#define XHCI_CMD_CRS 0x00000200
/* RW Controller Restore State */
85
#define XHCI_CMD_EWE 0x00000400
/* RW Enable Wrap Event */
86
#define XHCI_CMD_EU3S 0x00000800
/* RW Enable U3 MFINDEX Stop */
87
#define XHCI_USBSTS 0x04
/* XHCI status */
88
#define XHCI_STS_HCH 0x00000001
/* RO - Host Controller Halted */
89
#define XHCI_STS_HSE 0x00000004
/* RW - Host System Error */
90
#define XHCI_STS_EINT 0x00000008
/* RW - Event Interrupt */
91
#define XHCI_STS_PCD 0x00000010
/* RW - Port Change Detect */
92
#define XHCI_STS_SSS 0x00000100
/* RO - Save State Status */
93
#define XHCI_STS_RSS 0x00000200
/* RO - Restore State Status */
94
#define XHCI_STS_SRE 0x00000400
/* RW - Save/Restore Error */
95
#define XHCI_STS_CNR 0x00000800
/* RO - Controller Not Ready */
96
#define XHCI_STS_HCE 0x00001000
/* RO - Host Controller Error */
97
#define XHCI_PAGESIZE 0x08
/* XHCI page size mask */
98
#define XHCI_PAGESIZE_4K 0x00000001
/* 4K Page Size */
99
#define XHCI_PAGESIZE_8K 0x00000002
/* 8K Page Size */
100
#define XHCI_PAGESIZE_16K 0x00000004
/* 16K Page Size */
101
#define XHCI_PAGESIZE_32K 0x00000008
/* 32K Page Size */
102
#define XHCI_PAGESIZE_64K 0x00000010
/* 64K Page Size */
103
#define XHCI_DNCTRL 0x14
/* XHCI device notification control */
104
#define XHCI_DNCTRL_MASK(n) (1U << (n))
105
#define XHCI_CRCR_LO 0x18
/* XHCI command ring control */
106
#define XHCI_CRCR_LO_RCS 0x00000001
/* RW - consumer cycle state */
107
#define XHCI_CRCR_LO_CS 0x00000002
/* RW - command stop */
108
#define XHCI_CRCR_LO_CA 0x00000004
/* RW - command abort */
109
#define XHCI_CRCR_LO_CRR 0x00000008
/* RW - command ring running */
110
#define XHCI_CRCR_LO_MASK 0x0000000F
111
#define XHCI_CRCR_HI 0x1C
/* XHCI command ring control */
112
#define XHCI_DCBAAP_LO 0x30
/* XHCI dev context BA pointer */
113
#define XHCI_DCBAAP_HI 0x34
/* XHCI dev context BA pointer */
114
#define XHCI_CONFIG 0x38
115
#define XHCI_CONFIG_SLOTS_MASK 0x000000FF
/* RW - number of device slots enabled */
116
117
/* XHCI port status registers */
118
#define XHCI_PORTSC(n) (0x3F0 + (0x10 * (n)))
/* XHCI port status */
119
#define XHCI_PS_CCS 0x00000001
/* RO - current connect status */
120
#define XHCI_PS_PED 0x00000002
/* RW - port enabled / disabled */
121
#define XHCI_PS_OCA 0x00000008
/* RO - over current active */
122
#define XHCI_PS_PR 0x00000010
/* RW - port reset */
123
#define XHCI_PS_PLS_GET(x) (((x) >> 5) & 0xF)
/* RW - port link state */
124
#define XHCI_PS_PLS_SET(x) (((x) & 0xF) << 5)
/* RW - port link state */
125
#define XHCI_PS_PP 0x00000200
/* RW - port power */
126
#define XHCI_PS_SPEED_GET(x) (((x) >> 10) & 0xF)
/* RO - port speed */
127
#define XHCI_PS_PIC_GET(x) (((x) >> 14) & 0x3)
/* RW - port indicator */
128
#define XHCI_PS_PIC_SET(x) (((x) & 0x3) << 14)
/* RW - port indicator */
129
#define XHCI_PS_LWS 0x00010000
/* RW - port link state write strobe */
130
#define XHCI_PS_CSC 0x00020000
/* RW - connect status change */
131
#define XHCI_PS_PEC 0x00040000
/* RW - port enable/disable change */
132
#define XHCI_PS_WRC 0x00080000
/* RW - warm port reset change */
133
#define XHCI_PS_OCC 0x00100000
/* RW - over-current change */
134
#define XHCI_PS_PRC 0x00200000
/* RW - port reset change */
135
#define XHCI_PS_PLC 0x00400000
/* RW - port link state change */
136
#define XHCI_PS_CEC 0x00800000
/* RW - config error change */
137
#define XHCI_PS_CAS 0x01000000
/* RO - cold attach status */
138
#define XHCI_PS_WCE 0x02000000
/* RW - wake on connect enable */
139
#define XHCI_PS_WDE 0x04000000
/* RW - wake on disconnect enable */
140
#define XHCI_PS_WOE 0x08000000
/* RW - wake on over-current enable */
141
#define XHCI_PS_DR 0x40000000
/* RO - device removable */
142
#define XHCI_PS_WPR 0x80000000U
/* RW - warm port reset */
143
#define XHCI_PS_CLEAR 0x80FF01FFU
/* command bits */
144
145
#define XHCI_PORTPMSC(n) (0x3F4 + (0x10 * (n)))
/* XHCI status and control */
146
#define XHCI_PM3_U1TO_GET(x) (((x) >> 0) & 0xFF)
/* RW - U1 timeout */
147
#define XHCI_PM3_U1TO_SET(x) (((x) & 0xFF) << 0)
/* RW - U1 timeout */
148
#define XHCI_PM3_U2TO_GET(x) (((x) >> 8) & 0xFF)
/* RW - U2 timeout */
149
#define XHCI_PM3_U2TO_SET(x) (((x) & 0xFF) << 8)
/* RW - U2 timeout */
150
#define XHCI_PM3_FLA 0x00010000
/* RW - Force Link PM Accept */
151
#define XHCI_PM2_L1S_GET(x) (((x) >> 0) & 0x7)
/* RO - L1 status */
152
#define XHCI_PM2_RWE 0x00000008
/* RW - remote wakup enable */
153
#define XHCI_PM2_HIRD_GET(x) (((x) >> 4) & 0xF)
/* RW - host initiated resume duration */
154
#define XHCI_PM2_HIRD_SET(x) (((x) & 0xF) << 4)
/* RW - host initiated resume duration */
155
#define XHCI_PM2_L1SLOT_GET(x) (((x) >> 8) & 0xFF)
/* RW - L1 device slot */
156
#define XHCI_PM2_L1SLOT_SET(x) (((x) & 0xFF) << 8)
/* RW - L1 device slot */
157
#define XHCI_PM2_HLE 0x00010000
/* RW - hardware LPM enable */
158
#define XHCI_PORTLI(n) (0x3F8 + (0x10 * (n)))
/* XHCI port link info */
159
#define XHCI_PLI3_ERR_GET(x) (((x) >> 0) & 0xFFFF)
/* RO - port link errors */
160
#define XHCI_PORTRSV(n) (0x3FC + (0x10 * (n)))
/* XHCI port reserved */
161
162
/* XHCI runtime registers. Offset given by XHCI_CAPLENGTH + XHCI_RTSOFF registers */
163
#define XHCI_MFINDEX 0x0000
/* RO - microframe index */
164
#define XHCI_MFINDEX_GET(x) ((x) & 0x3FFF)
165
#define XHCI_IMAN(n) (0x0020 + (0x20 * (n)))
/* XHCI interrupt management */
166
#define XHCI_IMAN_INTR_PEND 0x00000001
/* RW - interrupt pending */
167
#define XHCI_IMAN_INTR_ENA 0x00000002
/* RW - interrupt enable */
168
#define XHCI_IMOD(n) (0x0024 + (0x20 * (n)))
/* XHCI interrupt moderation */
169
#define XHCI_IMOD_IVAL_GET(x) (((x) >> 0) & 0xFFFF)
/* 250ns unit */
170
#define XHCI_IMOD_IVAL_SET(x) (((x) & 0xFFFF) << 0)
/* 250ns unit */
171
#define XHCI_IMOD_ICNT_GET(x) (((x) >> 16) & 0xFFFF)
/* 250ns unit */
172
#define XHCI_IMOD_ICNT_SET(x) (((x) & 0xFFFF) << 16)
/* 250ns unit */
173
#define XHCI_IMOD_DEFAULT 0x000001F4U
/* 8000 IRQs/second */
174
#define XHCI_IMOD_DEFAULT_LP 0x000003F8U
/* 4000 IRQs/second - LynxPoint */
175
#define XHCI_ERSTSZ(n) (0x0028 + (0x20 * (n)))
/* XHCI event ring segment table size */
176
#define XHCI_ERSTS_GET(x) ((x) & 0xFFFF)
177
#define XHCI_ERSTS_SET(x) ((x) & 0xFFFF)
178
#define XHCI_ERSTBA_LO(n) (0x0030 + (0x20 * (n)))
/* XHCI event ring segment table BA */
179
#define XHCI_ERSTBA_HI(n) (0x0034 + (0x20 * (n)))
/* XHCI event ring segment table BA */
180
#define XHCI_ERDP_LO(n) (0x0038 + (0x20 * (n)))
/* XHCI event ring dequeue pointer */
181
#define XHCI_ERDP_LO_SINDEX(x) ((x) & 0x7)
/* RO - dequeue segment index */
182
#define XHCI_ERDP_LO_BUSY 0x00000008
/* RW - event handler busy */
183
#define XHCI_ERDP_HI(n) (0x003C + (0x20 * (n)))
/* XHCI event ring dequeue pointer */
184
185
/* XHCI doorbell registers. Offset given by XHCI_CAPLENGTH + XHCI_DBOFF registers */
186
#define XHCI_DOORBELL(n) (0x0000 + (4 * (n)))
187
#define XHCI_DB_TARGET_GET(x) ((x) & 0xFF)
/* RW - doorbell target */
188
#define XHCI_DB_TARGET_SET(x) ((x) & 0xFF)
/* RW - doorbell target */
189
#define XHCI_DB_SID_GET(x) (((x) >> 16) & 0xFFFF)
/* RW - doorbell stream ID */
190
#define XHCI_DB_SID_SET(x) (((x) & 0xFFFF) << 16)
/* RW - doorbell stream ID */
191
192
/* XHCI legacy support */
193
#define XHCI_XECP_ID(x) ((x) & 0xFF)
194
#define XHCI_XECP_NEXT(x) (((x) >> 8) & 0xFF)
195
#define XHCI_XECP_BIOS_SEM 0x0002
196
#define XHCI_XECP_OS_SEM 0x0003
197
198
/* XHCI capability ID's */
199
#define XHCI_ID_USB_LEGACY 0x0001
200
#define XHCI_ID_PROTOCOLS 0x0002
201
#define XHCI_ID_POWER_MGMT 0x0003
202
#define XHCI_ID_VIRTUALIZATION 0x0004
203
#define XHCI_ID_MSG_IRQ 0x0005
204
#define XHCI_ID_USB_LOCAL_MEM 0x0006
205
206
/* XHCI register R/W wrappers */
207
#define XREAD1(sc, what, a) \
208
bus_space_read_1((sc)->sc_io_tag, (sc)->sc_io_hdl, \
209
(a) + (sc)->sc_##what##_off)
210
#define XREAD2(sc, what, a) \
211
bus_space_read_2((sc)->sc_io_tag, (sc)->sc_io_hdl, \
212
(a) + (sc)->sc_##what##_off)
213
#define XREAD4(sc, what, a) \
214
bus_space_read_4((sc)->sc_io_tag, (sc)->sc_io_hdl, \
215
(a) + (sc)->sc_##what##_off)
216
#define XWRITE1(sc, what, a, x) \
217
bus_space_write_1((sc)->sc_io_tag, (sc)->sc_io_hdl, \
218
(a) + (sc)->sc_##what##_off, (x))
219
#define XWRITE2(sc, what, a, x) \
220
bus_space_write_2((sc)->sc_io_tag, (sc)->sc_io_hdl, \
221
(a) + (sc)->sc_##what##_off, (x))
222
#define XWRITE4(sc, what, a, x) \
223
bus_space_write_4((sc)->sc_io_tag, (sc)->sc_io_hdl, \
224
(a) + (sc)->sc_##what##_off, (x))
225
226
#endif
/* _XHCIREG_H_ */
dev
usb
controller
xhcireg.h
Generated by
1.9.3