Using Your DDK: Difference between revisions
No edit summary |
|||
Line 4: | Line 4: | ||
==Joystick Virtual Device Driver and Applications== | ==Joystick Virtual Device Driver and Applications== | ||
===Driver Description:=== | ===Driver Description:=== | ||
The IBM PC game port adapter provides a simple interface to joysticks and other similar analog devices. This component includes the OS/2 device driver source code for the PDD/VDD pair and OS/2 source code for the JOYTUNE and JOYTEST applications. | The IBM PC game port adapter provides a simple interface to joysticks and other similar analog devices. This component includes the OS/2 device driver source code for the PDD/VDD pair and OS/2 source code for the JOYTUNE and JOYTEST applications. | ||
===Compilers/assemblers Required:=== | ===Compilers/assemblers Required:=== | ||
* Microsoft Assembler 5.0 | * Microsoft Assembler 5.0 | ||
* IBM C Set ++ V2.01 | * IBM C Set ++ V2.01 | ||
===Build Instructions:=== | ===Build Instructions:=== | ||
1. Set the environment variables so the correct tools are picked up during the build. | |||
1.Set the environment variables so the correct tools are picked up during the build. | |||
e.g., SET PATH=<drive>:\DDK\TOOLS;%PATH% | e.g., SET PATH=<drive>:\DDK\TOOLS;%PATH% | ||
Where <drive> represents your DDK installed drive and DDK represents the DDK installed directory. On the CD-ROM, the TOOLS directory path is DDK\ TOOLS. | Where <drive> represents your DDK installed drive and DDK represents the DDK installed directory. On the CD-ROM, the TOOLS directory path is DDK\ TOOLS. | ||
2.Before the FIRST build is attempted, run (only once) the COPYCSET.CMD REXX command file in the DDK\TOOLS directory. This command copies the set of needed files from your copy of the IBM C Set ++ V2.01 compiler to the proper directories under the DDK base directory. | 2. Before the FIRST build is attempted, run (only once) the COPYCSET.CMD REXX command file in the DDK\TOOLS directory. This command copies the set of needed files from your copy of the IBM C Set ++ V2.01 compiler to the proper directories under the DDK base directory. | ||
e.g., COPYCSET <IBMCdrive>:\'IBMC' <drive>:\DDK | e.g., COPYCSET <IBMCdrive>:\'IBMC' <drive>:\DDK | ||
Where <IBMCdrive> represents the IBM C Set ++ V2.01 installed drive and ' IBMC' represents the IBM C Set ++ V2.01 installed directory, <drive> represents your DDK installed drive and DDK represents the DDK installed directory. | Where <IBMCdrive> represents the IBM C Set ++ V2.01 installed drive and 'IBMC' represents the IBM C Set ++ V2.01 installed directory, <drive> represents your DDK installed drive and DDK represents the DDK installed directory. | ||
3.Change the directory to \DDK\BASE\SRC\VDEV\MME\VJOY. | 3. Change the directory to \DDK\BASE\SRC\VDEV\MME\VJOY. | ||
4.Invoke NMAKE on the resident makefile. | 4.Invoke NMAKE on the resident makefile. | ||
Line 35: | Line 29: | ||
===Files Created By Successful Build:=== | ===Files Created By Successful Build:=== | ||
Directory: \DDK\BASE\SRC\VDEV\MME\VJOY | Directory: \DDK\BASE\SRC\VDEV\MME\VJOY | ||
Line 45: | Line 38: | ||
Debug Version: | Debug Version: | ||
* DGAMEVDD.SYS | * DGAMEVDD.SYS | ||
==Joystick Physical Device Driver== | ==Joystick Physical Device Driver== | ||
===Driver Description:=== | ===Driver Description:=== | ||
The IBM PC game port adapter provides a simple interface to joysticks and other similar analog devices. This component includes the OS/2 device driver source code for the PDD/VDD pair and OS/2 source code for the JOYTUNE and JOYTEST applications. | The IBM PC game port adapter provides a simple interface to joysticks and other similar analog devices. This component includes the OS/2 device driver source code for the PDD/VDD pair and OS/2 source code for the JOYTUNE and JOYTEST applications. | ||
===Compilers/assemblers Required:=== | ===Compilers/assemblers Required:=== | ||
* Microsoft Assembler 5.0 | |||
* Microsoft C 6.0 | |||
===Build Instructions:=== | ===Build Instructions:=== | ||
1. Set the environment variables so the correct tools are picked up during the build. | |||
1.Set the environment variables so the correct tools are picked up during the build. | |||
e.g., SET PATH=<drive>:\DDK\TOOLS;%PATH% | e.g., SET PATH=<drive>:\DDK\TOOLS;%PATH% | ||
Where <drive> represents your DDK installed drive and DDK represents the DDK installed directory. On the CD-ROM, the TOOLS directory path is DDK\ TOOLS. | Where <drive> represents your DDK installed drive and DDK represents the DDK installed directory. On the CD-ROM, the TOOLS directory path is DDK\ TOOLS. | ||
2.Before the FIRST build is attempted, run (only once) the COPYC60.CMD REXX command file in the DDK\TOOLS directory. This command copies the set of needed files from your copy of the Microsoft C 6.0 compiler to the proper directories under the DDK base directory. | 2. Before the FIRST build is attempted, run (only once) the COPYC60.CMD REXX command file in the DDK\TOOLS directory. This command copies the set of needed files from your copy of the Microsoft C 6.0 compiler to the proper directories under the DDK base directory. | ||
e.g., COPYC60 <MSCdrive>:\'C600' <drive>:\DDK | e.g., COPYC60 <MSCdrive>:\'C600' <drive>:\DDK | ||
Where <MSCdrive> represents the Microsoft C installed drive and 'C600' represents the Microsoft C installed directory, <drive> represents your DDK installed drive and DDK represents the DDK installed directory. | Where <MSCdrive> represents the Microsoft C installed drive and 'C600' represents the Microsoft C installed directory, <drive> represents your DDK installed drive and DDK represents the DDK installed directory. | ||
3.Change the directory to DDK\BASE\SRC\DEV\MME\JOY. | 3. Change the directory to DDK\BASE\SRC\DEV\MME\JOY. | ||
4.Invoke NMAKE on the resident makefile. | 4.Invoke NMAKE on the resident makefile. | ||
Line 81: | Line 65: | ||
===Files Created By Successful Build:=== | ===Files Created By Successful Build:=== | ||
Directory: \DDK\BASE\SRC\DEV\MME\JOY | Directory: \DDK\BASE\SRC\DEV\MME\JOY | ||
Line 89: | Line 72: | ||
Debug Version: | Debug Version: | ||
* DGAMEDD.SYS | * DGAMEDD.SYS | ||
==USB Device Driver Sample== | ==USB Device Driver Sample== | ||
===Driver Description:=== | ===Driver Description:=== | ||
The Universal Serial Bus (USB) device driver sample contains source code for USB device drivers and installation protocols. The code includes the base USB device driver stack and the following drivers: | The Universal Serial Bus (USB) device driver sample contains source code for USB device drivers and installation protocols. The code includes the base USB device driver stack and the following drivers: | ||
* Keyboard | * Keyboard | ||
* Mouse | * Mouse | ||
Line 104: | Line 82: | ||
===Compilers/Assemblers Required:=== | ===Compilers/Assemblers Required:=== | ||
* Microsoft MASM 5.1 (supplied with the DDK) | * Microsoft MASM 5.1 (supplied with the DDK) | ||
* Microsoft C 6.0 | * Microsoft C 6.0 | ||
===Build Instructions:=== | ===Build Instructions:=== | ||
1. Set the environment variables so the correct tools are picked up during the build. | |||
1.Set the environment variables so the correct tools are picked up during the build. | |||
e.g., SET PATH=<drive>:\DDK\TOOLS;%PATH% | e.g., SET PATH=<drive>:\DDK\TOOLS;%PATH% | ||
Where <drive> represents your DDK installed drive and DDK represents the DDK installed directory. On the CD-ROM, the TOOLS directory path is \DDK\ TOOLS | Where <drive> represents your DDK installed drive and DDK represents the DDK installed directory. On the CD-ROM, the TOOLS directory path is \DDK\TOOLS. | ||
2. Before the FIRST build is attempted, run (only once) the COPYC60.CMD REXX command file in the \DDK\TOOLS directory. This command copies the set of needed files from your copy of the Microsoft C 6.0 compiler to the proper directories under the DDK base directory. | |||
e.g., COPYC60 <MSCdrive>:\'MSC60' <drive>:\DDK | e.g., COPYC60 <MSCdrive>:\'MSC60' <drive>:\DDK | ||
Where <MSCdrive> represents the Microsoft C installed drive and "MSC60" represents the Microsoft C installed directory, <drive> represents your DDK installed drive and DDK represents the DDK installed directory. | Where <MSCdrive> represents the Microsoft C installed drive and "MSC60" represents the Microsoft C installed directory, <drive> represents your DDK installed drive and DDK represents the DDK installed directory. | ||
3.To ensure the device driver gets created properly on a FAT file system, type SET LANG=US at an OS/2 command prompt before invoking NMAKE. | 3. To ensure the device driver gets created properly on a FAT file system, type SET LANG=US at an OS/2 command prompt before invoking NMAKE. | ||
'''To build all the USB device drivers:''' | '''To build all the USB device drivers:''' | ||
#Change the directory to \DDK\BASE\SRC\DEV\USB. | |||
#Invoke NMAKE on the resident makefile. | |||
'''To build an individual USB device driver:''' | '''To build an individual USB device driver:''' | ||
#Change the directory to \DDK\BASE\SRC\DEV\MOUSE\USB. | |||
#Change to the directory of the desired USB device driver. | |||
#Invoke NMAKE on the resident makefile. | |||
===Files Created by Successful Build:=== | ===Files Created by Successful Build:=== | ||
Directory: \DDK\BASE\SRC\DEV\USB\USBD | Directory: \DDK\BASE\SRC\DEV\USB\USBD | ||
* USBD.SYS | * USBD.SYS |
Revision as of 15:18, 21 May 2016
By IBM
Reprint Courtesy of International Business Machines Corporation, © International Business Machines Corporation
Joystick Virtual Device Driver and Applications
Driver Description:
The IBM PC game port adapter provides a simple interface to joysticks and other similar analog devices. This component includes the OS/2 device driver source code for the PDD/VDD pair and OS/2 source code for the JOYTUNE and JOYTEST applications.
Compilers/assemblers Required:
- Microsoft Assembler 5.0
- IBM C Set ++ V2.01
Build Instructions:
1. Set the environment variables so the correct tools are picked up during the build.
e.g., SET PATH=<drive>:\DDK\TOOLS;%PATH%
Where <drive> represents your DDK installed drive and DDK represents the DDK installed directory. On the CD-ROM, the TOOLS directory path is DDK\ TOOLS.
2. Before the FIRST build is attempted, run (only once) the COPYCSET.CMD REXX command file in the DDK\TOOLS directory. This command copies the set of needed files from your copy of the IBM C Set ++ V2.01 compiler to the proper directories under the DDK base directory.
e.g., COPYCSET <IBMCdrive>:\'IBMC' <drive>:\DDK
Where <IBMCdrive> represents the IBM C Set ++ V2.01 installed drive and 'IBMC' represents the IBM C Set ++ V2.01 installed directory, <drive> represents your DDK installed drive and DDK represents the DDK installed directory.
3. Change the directory to \DDK\BASE\SRC\VDEV\MME\VJOY.
4.Invoke NMAKE on the resident makefile.
5.Invoke NMAKE DEBUG to build the debug version.
Files Created By Successful Build:
Directory: \DDK\BASE\SRC\VDEV\MME\VJOY
Retail Version:
- GAMEVDD.SYS
- JOYTEST.EXE
- JOYTUNE.EXE
Debug Version:
- DGAMEVDD.SYS
Joystick Physical Device Driver
Driver Description:
The IBM PC game port adapter provides a simple interface to joysticks and other similar analog devices. This component includes the OS/2 device driver source code for the PDD/VDD pair and OS/2 source code for the JOYTUNE and JOYTEST applications.
Compilers/assemblers Required:
- Microsoft Assembler 5.0
- Microsoft C 6.0
Build Instructions:
1. Set the environment variables so the correct tools are picked up during the build.
e.g., SET PATH=<drive>:\DDK\TOOLS;%PATH%
Where <drive> represents your DDK installed drive and DDK represents the DDK installed directory. On the CD-ROM, the TOOLS directory path is DDK\ TOOLS.
2. Before the FIRST build is attempted, run (only once) the COPYC60.CMD REXX command file in the DDK\TOOLS directory. This command copies the set of needed files from your copy of the Microsoft C 6.0 compiler to the proper directories under the DDK base directory.
e.g., COPYC60 <MSCdrive>:\'C600' <drive>:\DDK
Where <MSCdrive> represents the Microsoft C installed drive and 'C600' represents the Microsoft C installed directory, <drive> represents your DDK installed drive and DDK represents the DDK installed directory.
3. Change the directory to DDK\BASE\SRC\DEV\MME\JOY.
4.Invoke NMAKE on the resident makefile.
5.Invoke NMAKE DEBUG to build the debug version.
Files Created By Successful Build:
Directory: \DDK\BASE\SRC\DEV\MME\JOY
Retail Version:
- GAMEDD.SYS
Debug Version:
- DGAMEDD.SYS
USB Device Driver Sample
Driver Description:
The Universal Serial Bus (USB) device driver sample contains source code for USB device drivers and installation protocols. The code includes the base USB device driver stack and the following drivers:
- Keyboard
- Mouse
- Modem
- Digital audio
Compilers/Assemblers Required:
- Microsoft MASM 5.1 (supplied with the DDK)
- Microsoft C 6.0
Build Instructions:
1. Set the environment variables so the correct tools are picked up during the build.
e.g., SET PATH=<drive>:\DDK\TOOLS;%PATH%
Where <drive> represents your DDK installed drive and DDK represents the DDK installed directory. On the CD-ROM, the TOOLS directory path is \DDK\TOOLS.
2. Before the FIRST build is attempted, run (only once) the COPYC60.CMD REXX command file in the \DDK\TOOLS directory. This command copies the set of needed files from your copy of the Microsoft C 6.0 compiler to the proper directories under the DDK base directory.
e.g., COPYC60 <MSCdrive>:\'MSC60' <drive>:\DDK
Where <MSCdrive> represents the Microsoft C installed drive and "MSC60" represents the Microsoft C installed directory, <drive> represents your DDK installed drive and DDK represents the DDK installed directory.
3. To ensure the device driver gets created properly on a FAT file system, type SET LANG=US at an OS/2 command prompt before invoking NMAKE.
To build all the USB device drivers:
- Change the directory to \DDK\BASE\SRC\DEV\USB.
- Invoke NMAKE on the resident makefile.
To build an individual USB device driver:
- Change the directory to \DDK\BASE\SRC\DEV\MOUSE\USB.
- Change to the directory of the desired USB device driver.
- Invoke NMAKE on the resident makefile.
Files Created by Successful Build:
Directory: \DDK\BASE\SRC\DEV\USB\USBD
- USBD.SYS
Directory: \DDK\BASE\SRC\DEV\USB\UHCI
- USBUHCD.SYS
- USBUHCD2.SYS
Directory: \DDK\BASE\SRC\DEV\USB\HID
- USBHID.SYS
Directory: \DDK\BASE\SRC\DEV\USB\USBMOUSE
- USBMOUSE.SYS
Directory: \DDK\BASE\SRC\DEV\USB\USBKBD
- USBKBD.SYS
Directory: \DDK\BASE\SRC\DEV\USB\USBAUDIO
- USBAUDIO.SYS
Directory: \DDK\BASE\SRC\DEV\USB\USBCOM
- USBCOM.SYS