IBM Device Driver Source Kit for OS/2


 * NUMBER 293-253
 * DATE 1993-05-25

ABSTRACT
The IBM Device Driver Source Kit for OS/2 (R) (DDK) on CD-ROM media contains: Customers licensing the product will receive future, generally available releases to the product, if any, for one year from the ordering date.
 * IBM's latest release of OS/2 device driver source code
 * Build and test tools for several device drivers
 * Online documentation.

Several device drivers for OS/2 have been developed and are supplied in this kit. The working source code is far more than a foundation and will enable rapid development of new device drivers.

Additional sources and enhancements will be included in subsequent releases of the IBM Device Driver Source Kit for OS/2 as they become available.

Operating Environment: DDK requires OS/2 2.0 with Servicepak (XR06055) or OS/2 2.1. The device drivers contained within this product are for versions of OS/2 2.0, or later.

One-Time Charge: $499.

Availability Date: May 25, 1993.

(R) Registered trademark of International Business Machines Corporation.

IN BRIEF...
The IBM Device Driver Source Kit for OS/2 (71G3703) features:
 * Full source code enabling rapid development of new device drivers
 * Kit including 79 drivers and tools for the following device types:
 * Display
 * Printer
 * CD-ROM (compact disk - read only memory)
 * DASD (direct access storage device)
 * SCSI (small computer system interface)
 * Diskette
 * Mouse
 * Keyboard
 * Multimedia
 * Pen
 * Touch
 * Serial
 * Parallel.
 * Nine online books equivalent to over 1,500 pages of printed material with detailed information on:
 * OS/2 device drivers
 * Device driver function
 * Hints and techniques for device driver construction.
 * Generally available updates, if any, for one year from the ordering date at no additional charge

PRODNO
71G3703 71G1895 71G1896 71G1897 71G1898 71G1899 71G3678

DESCRIPTION
The IBM Device Driver Source Kit for OS/2 (DDK) is a program that includes all OS/2 generally available DDK releases, if any, for one year from the ordering date. Each release is cumulative, delivering enhancements and additions to device driver source code, tools for construction and verification and online documentation.

DEVICE DRIVER SOURCE
Actual OS/2 device driver source code* is provided to help the user rapidly develop new OS/2 device drivers. The IBM Device Driver Source Kit for OS/2 includes the following source code.
 * Sources for new drivers will be added in subsequent releases as they become available.

PRINTER DEVICE DRIVERS: DISPLAY DEVICE DRIVERS:
 * 32-bit PostScript (1), (a)
 * 16-bit Plotter (b)
 * 32-bit PMPrint Queue (a)
 * 32-bit Serial Port (a)
 * 32-bit Parallel Port (a).
 * 16-bit VGA (b)
 * 16-bit 8514 (b)
 * VGA Base Video Handler
 * SVGA Base Video Handler (b)
 * SVGA Utility
 * Virtual Video
 * XGA (R) Virtual Video
 * 32-bit VGA
 * SVGA-256
 * 32-bit XGA (b) (beta)
 * 32-bit XGA Presentation Manager (R)
 * 32-bit XGA Base Video Handler
 * 32-bit 8514 (b) (beta)
 * 32-bit 8514 Presentation Manager
 * 32-bit 8514 Base Video Handler
 * 16-bit common fonts
 * WIN-OS/2 V3.1 DDK Supplement - a license for the Microsoft (2) Windows (3) 3.1 DDK is required to request the supplement. Customers must sign and return the certification card, supplied in the CD-ROM package, to receive the supplement.

CD-ROM DEVICE DRIVERS (16-BIT):
 * CD-ROM Device Manager (b)
 * Virtual CD-ROM Device Manager
 * Hitachi (4) CD-ROM Filter (b)
 * NEC (5) CD-ROM Filter (b)
 * Sony (6) CD-ROM Filter (b)
 * Toshiba (7) CD-ROM Filter (b).

(1) Trademark of Adobe Systems, Incorporated. (R) Registered trademark of International Business Machines Corporation. (2) Trademark of Microsoft Corporation. (3) Trademark of Microsoft Corporation. (4) Registered trademark of Hitachi Corporation. (5) Registered trademark of NEC Corporation. (6) Registered trademark of Sony Corporation. (7) Registered trademark of Toshiba Corporation.

DASD DEVICE DRIVERS (16-BIT): SCSI DEVICE DRIVERS (16-BIT): DISKETTE DEVICE DRIVERS (16-BIT): MOUSE DEVICE DRIVERS (16-BIT): KEYBOARD DEVICE DRIVERS (16-BIT): MMPM/2 DEVICE DRIVERS: PEN DEVICE DRIVERS: 8516 TOUCH DEVICE DRIVERS (16-BIT): SERIAL (COMMUNICATION) DEVICE DRIVERS (16-BIT) PARALLEL (COMMUNICATION) DEVICE DRIVERS (16-BIT)
 * OS/2 DASD Device Manager (b)
 * OS/2 ASPI Device Manager (b)
 * Removable DASD to Fixed Drive Conversion (b)
 * Adapter Presence Detection Sample (b)
 * Adapter for ST506/IDE DASD (b)
 * Adapter for ABIOS DASD (b)
 * Virtual Machine Disk Generator (b).
 * OS/2 SCSI.SYS Emulation (b)
 * Adapter for ABIOS SCB (b).
 * Adapter for ABIOS Diskette (b) (Floppy)
 * OS/2 ISA/EISA Floppy (b)
 * Virtual Floppy
 * Protected Mode VDisk (RAM) for CP/DOS 2.0.
 * Mouse Subsystem
 * Mouse Family G
 * Virtual Mouse.
 * Keyboard Family 1
 * Keyboard Family 2
 * Virtual Keyboard.
 * Audio Template (b), (c)
 * Audio Virtual (c).
 * Pen Base
 * Pen Serial Digitizer
 * Pen for OS/2 Calibration Tool (a)
 * Pen Tool for PenPM (a).
 * Touch Device Independent (b)
 * Touch Device Dependent (b)
 * Virtual Touch Device Independent.
 * Serial (b)
 * Virtual Serial
 * AT (R) Synchronous (b).
 * Parallel Port (b)
 * Virtual Parallel.
 * (a) IBM C Set/2 (ICC) Compiler required.
 * (b) Microsoft C Optimizing Compiler (CL) Version 6.00A required.
 * (c) MMPM/2 Toolkit required.

BUILD AND TEST TOOLS

The build tools facilitate the development of the device drivers and the test tools verify the quality of the developed drivers. Many drivers include test cases that will facilitate construction of test cases for new drivers.

TEST TOOLS:
 * Display (b) - tests all mandatory graphics engine (GRE) functions for display drivers.
 * Paltest (b) - tests general palette manager for Presentation Manager display drivers.
 * Paldisp (b) - displays the hardware palette in a Presentation Manager window; use for debugging palette manager enabled Presentation Manager display.
 * Printer - performs tests for all mandatory graphics engine (GRE) functions for printer drivers.
 * Pen
 * Pen Calibration
 * Multimedia Audio Exerciser (c)
 * MM P2String (c) - tests the MMPM/2 system at the MCI API level.
 * (b) Microsoft C Optimizing Compiler (CL) Version 6.00A required.
 * (c) MMPM/2 Toolkit required.

ONLINE DOCUMENTATION A high-level view of the function and description of the device types and drivers are included in the online documentation. The documentation also includes hints and techniques used by developers.

The following books are included in the online documentation: Additional books and enhancements to these books may be included in subsequent releases.
 * General Information
 * Printer Device Driver Reference
 * Display Device Driver Reference
 * Storage Device Driver Reference
 * Input/Output Device Driver Reference
 * PenPM Device Driver Reference
 * MMPM/2 Device Driver Reference
 * Presentation Device Driver Reference
 * Virtual Device Driver Reference
 * Physical Device Driver Reference.

PRODUCT POSITIONING

Independent hardware vendors interested in becoming active in the OS/2 marketplace and software designers specializing in device interfacing will find the IBM Device Driver Source Kit for OS/2 attractive. Developers can modify the latest level of OS/2 device driver source code to quickly construct device drivers for new hardware. The build and test tools and online documentation effectively support the development effort. The IBM Device Driver Source Kit for OS/2 allows a short time-to-market cycle and will fortify the opportunity for a quality delivery.

PUBLICATIONS
The following publications may be ordered separately. To order, contact Direct Response Marketing at 800-633-8266; specify the title, order number and quantity. TITLE                               ORDER NUMBER Printer Device Driver Reference      S71G-1895 Display Device Driver Reference      S71G-1896 Storage Device Driver Reference      S71G-1897 Input/Output Device Driver Reference S71G-1898 PenPM Device Driver Reference        S71G-1899 MMPM/2 Device Driver Reference       S71G-3678

TECHNICAL INFORMATION
SPECIFIED OPERATING ENVIRONMENT

MACHINE REQUIREMENTS:
 * System supported by OS/2 2.0
 * Recommended 8MB (or greater) system memory
 * 20MB up to 83MB (HPFS) or 120MB (FAT) hard disk memory, depending on user preferences
 * One OS/2 supported CD-ROM drive
 * If the WIN-OS2 Version 3.1 Seamless Device Driver Supplement is subsequently requested, one 1.44MB 3.5-inch diskette drive is required.

PROGRAMMING REQUIREMENTS: Software building with the IBM Device Driver Source Kit for OS/2 requires IBM OS/2 2.0 with Servicepak (XR06055) or IBM OS/2 2.1. Compilers, assemblers and other utilities are required for creating executable drivers. The following compiler and assembler are supplied as part of the IBM Device Driver Source Kit for OS/2:
 * Microsoft Macro Assembler (MASM) Version 5.10A.15
 * Microsoft 386 C Compiler (CL386) Version 6.00.054.

NOTE: Any compiler, assembler or utility can only be used for internal use to develop OS/2 device drivers. The compilers, assemblers and utilities cannot be redistributed.

The following compilers and toolkit are not included with the IBM Device Driver Source Kit for OS/2. Refer to the DEVICE DRIVER SOURCE section for an understanding of what drivers have additional requirements.
 * Microsoft C Optimizing Compiler (CL) Version 6.00A
 * IBM C Set/2 (ICC) Compiler
 * MMPM/2 Toolkit

PLANNING INFORMATION

PACKAGING: The Device Driver Source Kit for OS/2 contains the following:
 * One CD-ROM containing the machine readable information
 * IBM License Agreement for the IBM Device Driver Source Kit Version 1.0 for OS/2
 * WIN-OS/2™ 3.1 Seamless Device Driver Supplement Registration.
 * ™ Trademark of International Business Machines Corporation.

SECURITY, AUDITABILITY AND CONTROL

User management is responsible for evaluation, selection and implementation of security features, administrative procedures and appropriate controls in application systems and communication facilities.

ORDERING INFORMATION
To order, contact Direct Response Marketing at 800-633-8266; specify the part number, program name and quantity. The shipping and handling charge will be determined by the customer preference for delivery (express mail, land mail or other). PART NUMBER PROGRAM NAME                       MEDIA 71G3703     Device Driver Source Kit for OS/2  CD-ROM
 * Program Package - program CD-ROM
 * Documentation - separate documentation without program CD-ROM.

TERMS AND CONDITIONS
LICENSING: The program in this announcement is licensed under the terms and conditions of the IBM License Agreement for the IBM Device Driver Source Kit Version 1.0 for OS/2. A copy of the agreement is included in the program package.

LIMITED WARRANTY:
 * Program: No.
 * Media: Three months.

PROGRAM SERVICES: Developer support is available to all licensee's of the IBM Device Driver Source Kit for OS/2. Developer support (technical assistance) encompasses DDK usage and many aspects of device driver development in general. Developers are expected to have device driver development experience or be willing to invest the time necessary to work through most of their own questions and problems. Developer support is not intended to provide an education service. It is intended, however, to answer specific questions after the device driver developer has made a reasonable effort to obtain an answer using available information.

Central Service is not available for this product, but developers are encouraged to use the IBM Driver Development Support Center (DDSC) System to obtain support by sending their questions and reviewing the question and answer history database, which can be easily downloaded for review offline.

Developers interested in using the DDSC System should dial (via modem) 407-982-3217 to register and to access the support system. To obtain a briefing of the services available, developers can call 407-982-4239.

Support for a specific release of the DDK will be available until 30 days after the release of the subsequent DDK. General device driver support will be available until discontinued by IBM upon three months' written notification on the DDSC System.

Additional support is available depending on the licensee's geography and participation in certain IBM programs (for example, the OS/2 Developer Assistance Program (DAP)).

TESTING PERIOD: None; 30-day money-back guarantee applies.

CHARGES PROGRAM NUMBER DESCRIPTION                           ONE-TIME CHARGE 71G3703        Device Driver Source Kit for OS/2     $499 71G1895        Printer Device Driver Reference         29 71G1896        Display Device Driver Reference         29 71G1897        Storage Device Driver Reference         29 71G1898        Input/Output Device Driver Reference    29 71G1899        PenPM Device Driver Reference           29 71G3678        MMPM/2 Device Driver Reference          29