]>
Commit | Line | Data |
---|---|---|
e2211743 WD |
1 | /* |
2 | * (C) Copyright 2001 | |
3 | * Denis Peter, MPL AG Switzerland | |
4 | * | |
5 | * See file CREDITS for list of people who contributed to this | |
6 | * project. | |
7 | * | |
8 | * This program is free software; you can redistribute it and/or | |
9 | * modify it under the terms of the GNU General Public License as | |
10 | * published by the Free Software Foundation; either version 2 of | |
11 | * the License, or (at your option) any later version. | |
12 | * | |
13 | * This program is distributed in the hope that it will be useful, | |
14 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
15 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
16 | * GNU General Public License for more details. | |
17 | * | |
18 | * You should have received a copy of the GNU General Public License | |
19 | * along with this program; if not, write to the Free Software | |
20 | * Foundation, Inc., 59 Temple Place, Suite 330, Boston, | |
21 | * MA 02111-1307 USA | |
22 | * | |
23 | */ | |
24 | ||
25 | USB Support for PIP405 and MIP405 (UHCI) | |
26 | ======================================== | |
27 | ||
28 | The USB support is implemented on the base of the UHCI Host | |
29 | controller. | |
30 | ||
89d48367 SG |
31 | Currently supported are USB Hubs, USB Keyboards, USB Floppys, USB |
32 | flash sticks and USB network adaptors. | |
e2211743 WD |
33 | Tested with a TEAC Floppy TEAC FD-05PUB and Chicony KU-8933 Keyboard. |
34 | ||
35 | How it works: | |
36 | ------------- | |
37 | ||
38 | The USB (at least the USB UHCI) needs a frame list (4k), transfer | |
39 | descripor and queue headers which are all located in the main memory. | |
40 | The UHCI allocates every milisecond the PCI bus and reads the current | |
41 | frame pointer. This may cause to crash the OS during boot. So the USB | |
42 | _MUST_ be stopped during OS boot. This is the reason, why the USB is | |
43 | NOT automatically started during start-up. If someone needs the USB | |
44 | he has to start it and should therefore be aware that he had to stop | |
45 | it before booting the OS. | |
46 | ||
47 | For USB keyboards this can be done by a script which is automatically | |
48 | started after the U-Boot is up and running. To boot an OS with a an | |
49 | USB keyboard another script is necessary, which first disables the | |
50 | USB and then executes the boot command. If the boot command fails, | |
51 | the script can reenable the USB kbd. | |
52 | ||
53 | Common USB Commands: | |
54 | - usb start: | |
55 | - usb reset: (re)starts the USB. All USB devices will be | |
56 | initialized and a device tree is build for them. | |
57 | - usb tree: shows all USB devices in a tree like display | |
58 | - usb info [dev]: shows all USB infos of the device dev, or of all | |
59 | the devices | |
60 | - usb stop [f]: stops the USB. If f==1 the USB will also stop if | |
61 | an USB keyboard is assigned as stdin. The stdin | |
62 | is then switched to serial input. | |
63 | Storage USB Commands: | |
64 | - usb scan: scans the USB for storage devices.The USB must be | |
65 | running for this command (usb start) | |
66 | - usb device [dev]: show or set current USB staorage device | |
67 | - usb part [dev]: print partition table of one or all USB storage | |
68 | devices | |
69 | - usb read addr blk# cnt: | |
70 | read `cnt' blocks starting at block `blk#'to | |
71 | memory address `addr' | |
72 | - usbboot addr dev:part: | |
73 | boot from USB device | |
74 | ||
75 | Config Switches: | |
76 | ---------------- | |
b3aff0cb JL |
77 | CONFIG_CMD_USB enables basic USB support and the usb command |
78 | CONFIG_USB_UHCI defines the lowlevel part.A lowlevel part must be defined | |
79 | if using CONFIG_CMD_USB | |
e2211743 WD |
80 | CONFIG_USB_KEYBOARD enables the USB Keyboard |
81 | CONFIG_USB_STORAGE enables the USB storage devices | |
89d48367 | 82 | CONFIG_USB_HOST_ETHER enables USB ethernet dongle support |