Commit | Line | Data |
---|---|---|
920dae64 AT |
1 | \ ========== Copyright Header Begin ========================================== |
2 | \ | |
3 | \ Hypervisor Software File: transfermap.fth | |
4 | \ | |
5 | \ Copyright (c) 2006 Sun Microsystems, Inc. All Rights Reserved. | |
6 | \ | |
7 | \ - Do no alter or remove copyright notices | |
8 | \ | |
9 | \ - Redistribution and use of this software in source and binary forms, with | |
10 | \ or without modification, are permitted provided that the following | |
11 | \ conditions are met: | |
12 | \ | |
13 | \ - Redistribution of source code must retain the above copyright notice, | |
14 | \ this list of conditions and the following disclaimer. | |
15 | \ | |
16 | \ - Redistribution in binary form must reproduce the above copyright notice, | |
17 | \ this list of conditions and the following disclaimer in the | |
18 | \ documentation and/or other materials provided with the distribution. | |
19 | \ | |
20 | \ Neither the name of Sun Microsystems, Inc. or the names of contributors | |
21 | \ may be used to endorse or promote products derived from this software | |
22 | \ without specific prior written permission. | |
23 | \ | |
24 | \ This software is provided "AS IS," without a warranty of any kind. | |
25 | \ ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, | |
26 | \ INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A | |
27 | \ PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN | |
28 | \ MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL NOT BE LIABLE FOR | |
29 | \ ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR | |
30 | \ DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN | |
31 | \ OR ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR | |
32 | \ FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE | |
33 | \ DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, | |
34 | \ ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE, EVEN IF | |
35 | \ SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. | |
36 | \ | |
37 | \ You acknowledge that this software is not designed, licensed or | |
38 | \ intended for use in the design, construction, operation or maintenance of | |
39 | \ any nuclear facility. | |
40 | \ | |
41 | \ ========== Copyright Header End ============================================ | |
42 | id: @(#)transfermap.fth 1.8 04/05/25 | |
43 | purpose: | |
44 | copyright: Copyright 1997-2004 Sun Microsystems, Inc. All Rights Reserved | |
45 | copyright: Use is subject to license terms. | |
46 | ||
47 | struct | |
48 | 4 field transfer-control | |
49 | 4 field curr-buffer | |
50 | 4 field next-transfer | |
51 | h# 14 field buffer-end \ followed by pad to make general and isoc | |
52 | \ transfer sizes the same | |
53 | /n field my-endpoint \ used only by software, virt | |
54 | /n field caller-data \ ditto, for caller's buffer | |
55 | /n field caller-count | |
56 | /n field my-data | |
57 | h# 20 over h# 20 mod - \ pad to next 32 byte boundary | |
58 | field endpad2 | |
59 | ||
60 | ( general transfer descrip. size ) constant /transfer | |
61 | ||
62 | \ We can't use curr-buffer and reverse index it to get back to the virt addr | |
63 | \ of the data buffer because the controller will use that field and set it to | |
64 | \ 0 to indicate a full transfer. So we use my-data to hold the virt addr of | |
65 | \ the associated buffer. my-data can be used as a copy buffer that is | |
66 | \ dma-able from the static pool. 0 in caller-data means no associated buffer. | |
67 | \ caller-count is 0 if no data to transfer. | |
68 | ||
69 | \ XXX will waste memory up to 32 bytes per descriptor if it is evenly | |
70 | \ aligned before the calculation. can save the dict entry by pushing the | |
71 | \ calculation into the size of my-data | |
72 | ||
73 | \ isochronous transfer descriptor structure | |
74 | ||
75 | struct | |
76 | 4 field isoc-control | |
77 | h# c field buff-page \ followed by next-transfer & buffer-end, as above | |
78 | 4 field offset0 \ and offset1; reused for psw0 and psw1 | |
79 | 4 field offset2 \ and offset3; reused for psw2 and psw3 | |
80 | 4 field offset4 \ and offset5; reused for psw4 and psw5 | |
81 | 4 field offset6 \ and offset7; reused for psw6 and psw7; | |
82 | \ followed by my-endpoint, as above | |
83 | drop | |
84 | ||
85 | ||
86 | : condition-code ( transfer-d -- cc ) | |
87 | le-l@ d# 28 rshift | |
88 | ; | |
89 | ||
90 | \ For isochronous packets: | |
91 | : packet-condition-code ( n transfer-d -- cc ) | |
92 | offset0 swap 4 * + le-w@ | |
93 | h# f000 and d# 12 rshift | |
94 | ; | |
95 | ||
96 | \ completion codes for transfers ( cc field of transfer descriptor): | |
97 | ||
98 | 0 constant no-error | |
99 | 1 constant crc-error | |
100 | 2 constant bit-error | |
101 | 3 constant toggle-error | |
102 | 4 constant stall-error | |
103 | 5 constant no-response-error | |
104 | 6 constant pid-error | |
105 | 7 constant unexpected-pid-error | |
106 | 8 constant data-overrun-error | |
107 | 9 constant data-underrun-error | |
108 | \ a constant reserved1 | |
109 | \ b constant reserved2 | |
110 | c constant buf-overrun-error \ isoc only | |
111 | d constant buf-underrun-error \ isoc only | |
112 | e constant eno-access-error \ XXX isoc only? | |
113 | f constant fno-access-error \ XXX isoc only? | |
114 | ||
115 | \ These are generated by the code: | |
116 | 11 constant time-out-error | |
117 | 12 constant no-more-addresses | |
118 | ||
119 | : .error ( hw-err? -- hw-err? ) | |
120 | cmn-error[ " USB " cmn-append | |
121 | dup | |
122 | case 1 of " crc" endof | |
123 | 2 of " bit" endof | |
124 | 3 of " toggle" endof | |
125 | 4 of " stall" endof | |
126 | 5 of " no response" endof | |
127 | 6 of " pid" endof | |
128 | 7 of " unexpected pid" endof | |
129 | 8 of " data overrun" endof | |
130 | 9 of " data underrun" endof | |
131 | c of " buffer overrun" endof | |
132 | d of " buffer underrun" endof | |
133 | e of " eno" endof | |
134 | f of " fno" endof | |
135 | 11 of " time out" endof | |
136 | 12 of " no address" endof | |
137 | " unknown %x" 2 pick | |
138 | endcase | |
139 | ]cmn-end | |
140 | ; | |
141 | ||
142 | \ Maybe show hardware errors | |
143 | : ?.error ( hw-err? | stat 0 -- hw-err? | stat 0 ) | |
144 | dup if | |
145 | .error | |
146 | then | |
147 | ; | |
148 | ||
149 | \ Some next-transfer bits must be 0 | |
150 | \ XXX should be done when next transfer is allocated | |
151 | : next-transfer! ( n e-addr -- ) | |
152 | \ swap h# f invert and swap | |
153 | next-transfer le-l! | |
154 | ; | |
155 | ||
156 | \ XXX to retire the endpoint, use my-endpoint to look at transfer head and | |
157 | \ tail. if equal, the endpoint has no transfer q left, and can be retired. | |
158 | \ not quite. there could be transfer descriptors still on the done q's, or | |
159 | \ maybe in process in the chip. | |
160 | ||
161 | \ direction bits for transfer descriptors: | |
162 | ||
163 | 00 constant setup-bits | |
164 | 01 constant out-bits | |
165 | 02 constant in-bits |