Command: usbuhcil
USBDOS is a collection of different USB drivers and tools:
USBUHCIL is a DOS Driver for a Universal HCI compatible USB Host
Controller.
LITE version (maximum 16 Devices, no Isochronous Transactions).
Syntax:
USBUHCIL [Options]
Options:
/? Show this HELP screen
/A Show all ALIASES for these command line Options
/ErrLvl Show all ErrorLevels (DOS Return Codes)
/U UNINSTALL from memory
/L:Y|N Force installation into LOW memory (default = No)
/Index # Use UHCI Host with PCI INDEX # (default = 0)
/IOAddr # Use I/O base ADDR # (100h-FFE0h, divisible by 32)
/IRQ # Use IRQ # (3-15, default = 9)
/DisableLegacy Disable Legacy Keyboard/Mouse support
/DisableOther Disable Other Control program
/P:# Pause # deciSeconds before finding Root Devices (0-255)
/Beep:Y|N BEEP Speaker when bad Device is found (default = Yes)
/PD[:#] Display Program Debug messages during install and
uninstall
# = Milliseconds to delay each step (0-2000, default=0)
/Run # Run (Resume/Enable) Device Address # |
/Stop # Stop (Disable) Device Address # |0-1 =Host/Root Hub
/Reset # Reset Device Address # |2-17=Attached Dvc
/Suspend # Suspend Device Address # |18-255=All Hosts
/Resume # Resume (not Enable) Device Address # |
/PowerOn # Power On Device Address # |
/PowerOff # Power Off Device Address # | 2-17
/PowerReset # Power Reset Device Address # |
/SC D# C# Set Configuration of Device D# (2-17) to value C#
(0-255)
/RW:# Y|N Enable/disable Remote Wakeup on Device # (2-17)
/TM:# Y|N Enable/disable Test Mode on Device # (2-17)
/Timing # Set Timing to # Bits/Frame (11936-12063, default = 12000)
/Debug, /SST Debug/SingleStep the Host
/Host Show Status of Host (PCI/USB/Root Hub)
/FL Show Status of Frame List
/QH Show Status of Queue Heads
/TD [#] Show Status of Transfer Descriptor(s), optional
Idx # (0-79)
/AD Show Status of Addressed Devices
/ND Show Status of New Device Notification Entries
/Descr [:#] Show Descriptors for Device Address # (2-17)
If no Address is provided, shows Last Enumerated Device
/R A# I# Show HID Report Descr for Dvc Addr A# (2-17),
Intf I# (0-255)
Comments:
USBUHCIL is too complex and too long to describe it completely in
htmlhelp. Please have a look into pages 53 till 175 of USBINTRO.DOC,
see links below).
USBUHCI is the full USB Host Controller Driver program. USBUHCIL is the
"Lite" or "Limited" version. The difference between the two is that
USBUHCI can handle a full 126 Logical Devices (Addresses), and allows
Isochronous Transactions to be scheduled. USBUHCIL can only handle 16
Logical Devices, and does not allow the scheduling of Isochronous
Transactions. Both programs implement the full Application Programming
Interface (API) as described in USBAPI.DOC, and are equivalent in every
other way.
From now on, when we are referring to one or the other of the programs
(USBUHCI or USBUHCIL), we will use the name of the individual program.
When we are referring to a Host Controller Driver in general (and can
be actually referring to either program), we will use USBUHCI{L}.
USBUHCIL uses substantially less memory than USBUHCI, and should be
sufficient for most applications. Most computers only have a few
Physical Devices plugged into any particular USB bus, and there are no
Drivers available yet for any type of Isochronous Device/Interface (such
as a Video Camera). Note, however, that because there has not yet been
a Device/Interface Driver developed for a "real" Isochronous Device, the
Isochronous capabilities of USBUHCI have not been tested with an actual
Physical Device and may not work correctly.
Both USBUHCI & USBUHCIL require an overlay file to operate properly.
The overlay file for USBUHCI is called USBUHCI.OVL, and the overlay file
for USBUHCIL is called USBUHCIL.OVL. The overlay file must be in the
same directory as the main executable file (USBUHCI.COM or
USBUHCIL.COM). If USBUHCI{L} cannot find the overlay file (or it is the
wrong version of overlay file), the program will not work.
For more information see:
https://gitlab.com/FreeDOS/drivers/usbdos/-/tree/master/DOC/DOSUSB
OR:
C:\FREEDOS\DOC\usbintro.doc (too big for edit, please use
another editor, e.g. Blocek!)
OR:
https://bretjohnson.us/
Examples:
usbuhcil (only UHCI is supported at the moment!)
See also:
boundtst
drives
errorlevel/exitcodes
hidsupt1
inklevel
irq
ps2mtest
scantest
thrust
uni2asci
usbdevic
usbdos
usbdrive
usbhosts
usbhub
usbjstik
usbkeyb
usbmouse
usbprint
usbsupt1
usbuhci
vendorid
Copyright © 2007-2009 Bret E. Johnson, help version 2023 W. Spiegl.
This file is derived from the FreeDOS Spec Command HOWTO.
See the file H2Cpying for copying conditions.