USB HOST DRIVER V03 Freescale Semiconductor / Motorola, USB HOST DRIVER V03 Datasheet - Page 71

• Manufacturer Part Number: USB HOST DRIVER V03
• Description: USB Host Driver v03
• Manufacturer: Freescale Semiconductor / Motorola

4. MOTUSB Library.
4.1. Library Overview.
The MOTUSB library is based on the functionality of the MOTUSB Device Driver. The
purpose of this library is to simplify USB development processes for user mode Client
applications, that use the MOTUSB Device Driver. The library maps all functionality
provided by the MOTUSB Device Driver. Developers should find it preferable to use the
library programming interface than to communicate directly with the Device Driver
through Win32 API.
4.2. Compiling And Linking.
Required headers:
\inc
Required libraries:
\lib
4.3. Handles.
The Library uses other handles than OS ( HANDLE ). The major problems with OS
handles is that in some cases they can become invalid. A MOTUSB Client should track
these cases and reopen the handles where possible. The MOTUSB library automatically
supports such tracking and, moreover, MOTUSB handles never become invalid. When
the Client application wants to perform an operation on a handle that turns out to be in an
invalid state, the library returns a corresponding error code. The Client application does
not track such cases as Device disconnection from the bus. The library closes all handles
upon disconnection and reopens them if a Device with the same VendorID / ProductID
connects to the bus.
The type of handle
library differs between them, and requests which apply to a Device handle, should not be
used for pipe objects, and similarly pipe object handles should not be used for Device
requests.
The Library does not provide a way to open a pipe object without the assistance of the
Device. The Library maintains an open pipe list for each Device object. The Client
application first needs to open a Device object handle using the
M
motusb.h
motstatus.h
motusb.lib
PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE
usb_t
- MOTUSB library programming interface
- MOTUSB errors codes
- MOTUSB library
is common for both Device and pipe objects. However the
MOTUSB Library.
USBOpenDevice
routine,
4-1