Commit | Line | Data |
---|---|---|
920dae64 AT |
1 | \ ========== Copyright Header Begin ========================================== |
2 | \ | |
3 | \ Hypervisor Software File: hub.tok | |
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: @(#)hub.tok 1.4 00/05/19 | |
43 | purpose: | |
44 | copyright: Copyright 1998-2000 Sun Microsystems, Inc. All Rights Reserved | |
45 | ||
46 | \ This is for chapter 11 hubs. One control endpoint 0 and one interrupt | |
47 | \ endpoint 1 for change reports. This is not for combined devices, etc. | |
48 | ||
49 | Fcode-version2 | |
50 | ||
51 | headers | |
52 | hex | |
53 | ||
54 | 1 encode-int " #address-cells" property | |
55 | 0 encode-int " #size-cells" property | |
56 | ||
57 | fload ${BP}/dev/usb-devices/hub/hub-gen.fth | |
58 | fload ${BP}/dev/usb-devices/hub/packets.fth | |
59 | fload ${BP}/dev/usb-devices/hub/hub-requests.fth | |
60 | fload ${BP}/dev/usb-devices/hub/hub-control.fth | |
61 | fload ${BP}/dev/usb-devices/hub/hub-required.fth | |
62 | fload ${BP}/dev/usb-devices/hub/bad-dev.fth | |
63 | fload ${BP}/dev/usb-devices/hub/probe.fth | |
64 | ||
65 | end0 | |
66 | ||
67 | \ "Universal Serial Bus Specification" Revision x.y is referred to | |
68 | \ as usbx.y, USBx.y, usb x.y, USB x.y in these files. | |
69 | \ When a sequence such as 1.2.3.4.5 follows such a reference in these | |
70 | \ files, it indicates a particular section of that specification. | |
71 | ||
72 | \ There can be differences between what usbx.y says and what actual | |
73 | \ USB devices do. In order to accomodate actual devices, there are | |
74 | \ fragments of code that do something differently from usbx.y. When | |
75 | \ this is known, such a fragment is marked in the code with phrases such | |
76 | \ as "balky device", "should not have to ...", "shouldn't have to ...", | |
77 | \ "may not be needed", and so on. | |
78 | ||
79 | \ "USB Hardware & Software", by John Garney, et al, is referred to in | |
80 | \ these files as "the book". When followed by a sequence of numbers | |
81 | \ such as 1.2.3.4, a particular section of this reference is indicated. | |
82 | \ When followed by a phrase such as "page 23", information on page 23 | |
83 | \ of this book is indicated. When followed by a phrase such as | |
84 | \ "figure 8.30", figure 8.30 of this book is indicated. | |
85 | ||
86 | \ For explanation of the USB technical terms used in these files, see | |
87 | \ one of the above references. |