xref: /openbsd/sys/dev/usb/ohcireg.h (revision ab0b1be7)
1 /*	$OpenBSD: ohcireg.h,v 1.14 2013/04/15 09:23:01 mglocker Exp $ */
2 /*	$NetBSD: ohcireg.h,v 1.19 2002/07/11 21:14:27 augustss Exp $	*/
3 /*	$FreeBSD: src/sys/dev/usb/ohcireg.h,v 1.8 1999/11/17 22:33:40 n_hibma Exp $	*/
4 
5 
6 /*
7  * Copyright (c) 1998 The NetBSD Foundation, Inc.
8  * All rights reserved.
9  *
10  * This code is derived from software contributed to The NetBSD Foundation
11  * by Lennart Augustsson (lennart@augustsson.net) at
12  * Carlstedt Research & Technology.
13  *
14  * Redistribution and use in source and binary forms, with or without
15  * modification, are permitted provided that the following conditions
16  * are met:
17  * 1. Redistributions of source code must retain the above copyright
18  *    notice, this list of conditions and the following disclaimer.
19  * 2. Redistributions in binary form must reproduce the above copyright
20  *    notice, this list of conditions and the following disclaimer in the
21  *    documentation and/or other materials provided with the distribution.
22  *
23  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
24  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
25  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
26  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
27  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
28  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
29  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
30  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
31  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
32  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
33  * POSSIBILITY OF SUCH DAMAGE.
34  */
35 
36 #ifndef _DEV_PCI_OHCIREG_H_
37 #define _DEV_PCI_OHCIREG_H_
38 
39 /*** PCI config registers ***/
40 
41 #define PCI_CBMEM		0x10	/* configuration base memory */
42 
43 #define PCI_INTERFACE_OHCI	0x10
44 
45 /*** OHCI registers */
46 
47 #define OHCI_REVISION		0x00	/* OHCI revision # */
48 #define  OHCI_REV_LO(rev)	((rev)&0xf)
49 #define  OHCI_REV_HI(rev)	(((rev)>>4)&0xf)
50 #define  OHCI_REV_LEGACY(rev)	((rev) & 0x100)
51 
52 #define OHCI_CONTROL		0x04
53 #define  OHCI_CBSR_MASK		0x00000003 /* Control/Bulk Service Ratio */
54 #define  OHCI_RATIO_1_1		0x00000000
55 #define  OHCI_RATIO_1_2		0x00000001
56 #define  OHCI_RATIO_1_3		0x00000002
57 #define  OHCI_RATIO_1_4		0x00000003
58 #define  OHCI_PLE		0x00000004 /* Periodic List Enable */
59 #define  OHCI_IE		0x00000008 /* Isochronous Enable */
60 #define  OHCI_CLE		0x00000010 /* Control List Enable */
61 #define  OHCI_BLE		0x00000020 /* Bulk List Enable */
62 #define  OHCI_HCFS_MASK		0x000000c0 /* HostControllerFunctionalState */
63 #define  OHCI_HCFS_RESET	0x00000000
64 #define  OHCI_HCFS_RESUME	0x00000040
65 #define  OHCI_HCFS_OPERATIONAL	0x00000080
66 #define  OHCI_HCFS_SUSPEND	0x000000c0
67 #define  OHCI_IR		0x00000100 /* Interrupt Routing */
68 #define  OHCI_RWC		0x00000200 /* Remote Wakeup Connected */
69 #define  OHCI_RWE		0x00000400 /* Remote Wakeup Enabled */
70 #define OHCI_COMMAND_STATUS	0x08
71 #define  OHCI_HCR		0x00000001 /* Host Controller Reset */
72 #define  OHCI_CLF		0x00000002 /* Control List Filled */
73 #define  OHCI_BLF		0x00000004 /* Bulk List Filled */
74 #define  OHCI_OCR		0x00000008 /* Ownership Change Request */
75 #define  OHCI_SOC_MASK		0x00030000 /* Scheduling Overrun Count */
76 #define OHCI_INTERRUPT_STATUS	0x0c
77 #define  OHCI_SO		0x00000001 /* Scheduling Overrun */
78 #define  OHCI_WDH		0x00000002 /* Writeback Done Head */
79 #define  OHCI_SF		0x00000004 /* Start of Frame */
80 #define  OHCI_RD		0x00000008 /* Resume Detected */
81 #define  OHCI_UE		0x00000010 /* Unrecoverable Error */
82 #define  OHCI_FNO		0x00000020 /* Frame Number Overflow */
83 #define  OHCI_RHSC		0x00000040 /* Root Hub Status Change */
84 #define  OHCI_OC		0x40000000 /* Ownership Change */
85 #define  OHCI_MIE		0x80000000 /* Master Interrupt Enable */
86 #define OHCI_INTERRUPT_ENABLE	0x10
87 #define OHCI_INTERRUPT_DISABLE	0x14
88 #define OHCI_HCCA		0x18
89 #define OHCI_PERIOD_CURRENT_ED	0x1c
90 #define OHCI_CONTROL_HEAD_ED	0x20
91 #define OHCI_CONTROL_CURRENT_ED	0x24
92 #define OHCI_BULK_HEAD_ED	0x28
93 #define OHCI_BULK_CURRENT_ED	0x2c
94 #define OHCI_DONE_HEAD		0x30
95 #define OHCI_FM_INTERVAL	0x34
96 #define  OHCI_GET_IVAL(s)	((s) & 0x3fff)
97 #define  OHCI_GET_FSMPS(s)	(((s) >> 16) & 0x7fff)
98 #define  OHCI_FIT		0x80000000
99 #define OHCI_FM_REMAINING	0x38
100 #define OHCI_FM_NUMBER		0x3c
101 #define OHCI_PERIODIC_START	0x40
102 #define OHCI_LS_THRESHOLD	0x44
103 #define OHCI_RH_DESCRIPTOR_A	0x48
104 #define  OHCI_GET_NDP(s)	((s) & 0xff)
105 #define  OHCI_PSM		0x0100     /* Power Switching Mode */
106 #define  OHCI_NPS		0x0200	   /* No Power Switching */
107 #define  OHCI_DT		0x0400     /* Device Type */
108 #define  OHCI_OCPM		0x0800     /* Overcurrent Protection Mode */
109 #define  OHCI_NOCP		0x1000     /* No Overcurrent Protection */
110 #define  OHCI_GET_POTPGT(s)	((s) >> 24)
111 #define OHCI_RH_DESCRIPTOR_B	0x4c
112 #define OHCI_RH_STATUS		0x50
113 #define  OHCI_LPS		0x00000001 /* Local Power Status */
114 #define  OHCI_OCI		0x00000002 /* OverCurrent Indicator */
115 #define  OHCI_DRWE		0x00008000 /* Device Remote Wakeup Enable */
116 #define  OHCI_LPSC		0x00010000 /* Local Power Status Change */
117 #define  OHCI_CCIC		0x00020000 /* OverCurrent Indicator Change */
118 #define  OHCI_CRWE		0x80000000 /* Clear Remote Wakeup Enable */
119 #define OHCI_RH_PORT_STATUS(n)	(0x50 + (n)*4) /* 1 based indexing */
120 
121 #define OHCI_LES (OHCI_PLE | OHCI_IE | OHCI_CLE | OHCI_BLE)
122 #define OHCI_ALL_INTRS (OHCI_SO | OHCI_WDH | OHCI_SF | OHCI_RD | OHCI_UE | \
123                         OHCI_FNO | OHCI_RHSC | OHCI_OC)
124 #define OHCI_NORMAL_INTRS (OHCI_SO | OHCI_WDH | OHCI_RD | OHCI_UE | OHCI_RHSC)
125 
126 #define OHCI_FSMPS(i) (((i-210)*6/7) << 16)
127 #define OHCI_PERIODIC(i) ((i)*9/10)
128 
129 typedef u_int32_t ohci_physaddr_t;
130 
131 #define OHCI_NO_INTRS 32
132 struct ohci_hcca {
133 	ohci_physaddr_t	hcca_interrupt_table[OHCI_NO_INTRS];
134 	u_int32_t	hcca_frame_number;
135 	ohci_physaddr_t	hcca_done_head;
136 #define OHCI_DONE_INTRS 1
137 };
138 #define OHCI_HCCA_SIZE 256
139 #define OHCI_HCCA_ALIGN 256
140 
141 #define OHCI_PAGE_SIZE 0x1000
142 #define OHCI_PAGE(x) ((x) &~ 0xfff)
143 #define OHCI_PAGE_OFFSET(x) ((x) & 0xfff)
144 
145 struct ohci_ed {
146 	u_int32_t	ed_flags;
147 #define OHCI_ED_GET_FA(s)	((s) & 0x7f)
148 #define OHCI_ED_ADDRMASK	0x0000007f
149 #define OHCI_ED_SET_FA(s)	(s)
150 #define OHCI_ED_GET_EN(s)	(((s) >> 7) & 0xf)
151 #define OHCI_ED_SET_EN(s)	((s) << 7)
152 #define OHCI_ED_DIR_MASK	0x00001800
153 #define  OHCI_ED_DIR_TD		0x00000000
154 #define  OHCI_ED_DIR_OUT	0x00000800
155 #define  OHCI_ED_DIR_IN		0x00001000
156 #define OHCI_ED_SPEED		0x00002000
157 #define OHCI_ED_SKIP		0x00004000
158 #define OHCI_ED_FORMAT_GEN	0x00000000
159 #define OHCI_ED_FORMAT_ISO	0x00008000
160 #define OHCI_ED_GET_MAXP(s)	(((s) >> 16) & 0x07ff)
161 #define OHCI_ED_SET_MAXP(s)	((s) << 16)
162 #define OHCI_ED_MAXPMASK	(0x7ff << 16)
163 	ohci_physaddr_t	ed_tailp;
164 	ohci_physaddr_t	ed_headp;
165 #define OHCI_HALTED		0x00000001
166 #define OHCI_TOGGLECARRY	0x00000002
167 #define OHCI_HEADMASK		0xfffffffc
168 	ohci_physaddr_t	ed_nexted;
169 };
170 /* #define OHCI_ED_SIZE 16 */
171 #define OHCI_ED_ALIGN 16
172 
173 struct ohci_td {
174 	u_int32_t	td_flags;
175 #define OHCI_TD_R		0x00040000		/* Buffer Rounding  */
176 #define OHCI_TD_DP_MASK		0x00180000		/* Direction / PID */
177 #define  OHCI_TD_SETUP		0x00000000
178 #define  OHCI_TD_OUT		0x00080000
179 #define  OHCI_TD_IN		0x00100000
180 #define OHCI_TD_GET_DI(x)	(((x) >> 21) & 7)	/* Delay Interrupt */
181 #define OHCI_TD_SET_DI(x)	((x) << 21)
182 #define  OHCI_TD_NOINTR		0x00e00000
183 #define  OHCI_TD_INTR_MASK	0x00e00000
184 #define OHCI_TD_TOGGLE_CARRY	0x00000000
185 #define OHCI_TD_TOGGLE_0	0x02000000
186 #define OHCI_TD_TOGGLE_1	0x03000000
187 #define OHCI_TD_TOGGLE_MASK	0x03000000
188 #define OHCI_TD_GET_EC(x)	(((x) >> 26) & 3)	/* Error Count */
189 #define OHCI_TD_GET_CC(x)	((x) >> 28)		/* Condition Code */
190 #define  OHCI_TD_NOCC		0xf0000000
191 	ohci_physaddr_t	td_cbp;		/* Current Buffer Pointer */
192 	ohci_physaddr_t td_nexttd;	/* Next TD */
193 	ohci_physaddr_t td_be;		/* Buffer End */
194 };
195 /* #define OHCI_TD_SIZE 16 */
196 #define OHCI_TD_ALIGN 16
197 
198 #define OHCI_ITD_NOFFSET 8
199 struct ohci_itd {
200 	u_int32_t	itd_flags;
201 #define OHCI_ITD_GET_SF(x)	((x) & 0x0000ffff)
202 #define OHCI_ITD_SET_SF(x)	((x) & 0xffff)
203 #define OHCI_ITD_GET_DI(x)	(((x) >> 21) & 7)	/* Delay Interrupt */
204 #define OHCI_ITD_SET_DI(x)	((x) << 21)
205 #define  OHCI_ITD_NOINTR	0x00e00000
206 #define OHCI_ITD_GET_FC(x)	((((x) >> 24) & 7)+1)	/* Frame Count */
207 #define OHCI_ITD_SET_FC(x)	(((x)-1) << 24)
208 #define OHCI_ITD_GET_CC(x)	((x) >> 28)		/* Condition Code */
209 #define  OHCI_ITD_NOCC		0xf0000000
210 	ohci_physaddr_t	itd_bp0;			/* Buffer Page 0 */
211 	ohci_physaddr_t	itd_nextitd;			/* Next ITD */
212 	ohci_physaddr_t	itd_be;				/* Buffer End */
213 	u_int16_t	itd_offset[OHCI_ITD_NOFFSET];	/* Buffer offsets */
214 #define itd_pswn itd_offset				/* Packet Status Word*/
215 #define OHCI_ITD_PAGE_SELECT	0x00001000
216 #define OHCI_ITD_MK_OFFS(len)	(0xe000 | ((len) & 0x1fff))
217 #define OHCI_ITD_PSW_LENGTH(x)	((x) & 0xfff)		/* Transfer length */
218 #define OHCI_ITD_PSW_GET_CC(x)	((x) >> 12)		/* Condition Code */
219 };
220 /* #define OHCI_ITD_SIZE 32 */
221 #define OHCI_ITD_ALIGN 32
222 
223 
224 #define OHCI_CC_NO_ERROR		0
225 #define OHCI_CC_CRC			1
226 #define OHCI_CC_BIT_STUFFING		2
227 #define OHCI_CC_DATA_TOGGLE_MISMATCH	3
228 #define OHCI_CC_STALL			4
229 #define OHCI_CC_DEVICE_NOT_RESPONDING	5
230 #define OHCI_CC_PID_CHECK_FAILURE	6
231 #define OHCI_CC_UNEXPECTED_PID		7
232 #define OHCI_CC_DATA_OVERRUN		8
233 #define OHCI_CC_DATA_UNDERRUN		9
234 #define OHCI_CC_BUFFER_OVERRUN		12
235 #define OHCI_CC_BUFFER_UNDERRUN		13
236 #define OHCI_CC_NOT_ACCESSED		14
237 #define OHCI_CC_NOT_ACCESSED_MASK	14
238 
239 /* Some delay needed when changing certain registers. */
240 #define OHCI_ENABLE_POWER_DELAY	5
241 #define OHCI_READ_DESC_DELAY	5
242 
243 #endif /* _DEV_PCI_OHCIREG_H_ */
244