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

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