Chapter 4 Software Development

4-2-3. Sample USB Host Software

The CD-ROM directory \package\host contains the following USB host software for testing such things as bulk data flow. A brief overview of operation appears in Section 2.

Readme.txt

Software description, usage notes, etc.

Rwbulk.exe

Test application

Bulkusb.sys

WDM-USB driver

Bulkusb.inf

WDM-USB driver installer information file

This USB host software adopts the following layered approach. For a detailed description, refer to the accompanying text file Readme.txt.

 

RWbulk.exe

 

 

Windows user mode console application

 

 

 

 

 

 

 

Win32API

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

BulkUsb.sys

 

 

Windows kernel mode driver

 

 

 

 

 

 

 

USB Driver Interface(USBDI)

 

USB Host Stack

 

Windows WDM USB Host Protocol Stack (Microsoft)

 

 

 

 

 

 

 

 

HostController

 

 

 

 

 

 

USB

 

 

 

 

 

 

 

n Note n

This sample host software runs only under Windows 98. It is only for provisional use by firmware developers pending the completion of proper host drivers and applications. It is not robust enough for heavy use. In fact, continued use risks operating system instability and even hang-ups. Note that we are unable to respond personally to technical queries with regard to this software.

4-2-4. Compiling and Executing Sample USB Firmware

Compiling the sample USB firmware requires the cc665s compiler installed in Section 2.1.2. Double-check the environment variables from that Section.

The work directory containing the sample USB firmware--c:\work in our example--contains make files for two popular make utilities (not included in the JOB60851 Starter Kit): Makefile.nmk for use with nmake from Microsoft and Makefile.bor for use with maker from Inprise (formerly Borland). Rename or copy the appropriate one to makefile. Also available is the batch file cl665s.bat for users without either of these make implementations. Successful compilation produces the file USB.HEX in the work directory. Check the link map file USB.M66 in the same directory for error messages from the linker.

To test USB.HEX, download it to the JOB60851 board and execute it there with the procedure in Section 2-3. "Running User Programs." Use Rwbulk.exe and the procedure in Section 2-2-2. "Running Flash Memory Program" to test bulk data flow.

4-2-5. Confirming USB Compliance with Usbcheck.exe

The USB Implementers Forum web site provides Usbcomp.exe, a self-extracting archive containing Usbcheck.exe, host software for checking support for USB standard device requests.

page 4-11

Page 46
Image 46
Oki JOB60851 user manual Sample USB Host Software, Compiling and Executing Sample USB Firmware