IBM Device Driver Source Kit for OS/2

From OS2World.Com Wiki
Revision as of 18:27, 2 March 2025 by Martini (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Article Info
Author IBM
Date 1993-05-25
OS Version
Companion File N/A
Source [1]
NUMBER 293-253

ABSTRACT

The IBM Device Driver Source Kit for OS/2® (DDK) on CD-ROM media contains:

  • IBM's latest release of OS/2 device driver source code
  • Build and test tools for several device drivers
  • Online documentation.

Customers licensing the product will receive future, generally available releases to the product, if any, for one year from the ordering date.

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.

® 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

OVERVIEW

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.

Some source code says:

You may use this code in accordance with the IBM License Agreement provided in the IBM Device Driver Source Kit for OS/2. This Copyright statement may not be removed.

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:

  • 32-bit PostScript (1), (a)
  • 16-bit Plotter (b)
  • 32-bit PMPrint Queue (a)
  • 32-bit Serial Port (a)
  • 32-bit Parallel Port (a).

DISPLAY DEVICE DRIVERS:

  • 16-bit VGA (b)
  • 16-bit 8514 (b)
  • VGA Base Video Handler
  • SVGA Base Video Handler (b)
  • SVGA Utility
  • Virtual Video
  • XGA® Virtual Video
  • 32-bit VGA
  • SVGA-256
  • 32-bit XGA (b) (beta)
  • 32-bit XGA Presentation Manager®
  • 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. ® 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):

  • 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).

SCSI DEVICE DRIVERS (16-BIT):

  • OS/2 SCSI.SYS Emulation (b)
  • Adapter for ABIOS SCB (b).

DISKETTE DEVICE DRIVERS (16-BIT):

  • Adapter for ABIOS Diskette (b) (Floppy)
  • OS/2 ISA/EISA Floppy (b)
  • Virtual Floppy
  • Protected Mode VDisk (RAM) for CP/DOS 2.0.

MOUSE DEVICE DRIVERS (16-BIT):

  • Mouse Subsystem
  • Mouse Family G
  • Virtual Mouse.

KEYBOARD DEVICE DRIVERS (16-BIT):

  • Keyboard Family 1
  • Keyboard Family 2
  • Virtual Keyboard.

MMPM/2 DEVICE DRIVERS:

  • Audio Template (b), (c)
  • Audio Virtual (c).

PEN DEVICE DRIVERS:

  • Pen Base
  • Pen Serial Digitizer
  • Pen for OS/2 Calibration Tool (a)
  • Pen Tool for PenPM (a).

8516 TOUCH DEVICE DRIVERS (16-BIT):

  • Touch Device Independent (b)
  • Touch Device Dependent (b)
  • Virtual Touch Device Independent.

SERIAL (COMMUNICATION) DEVICE DRIVERS (16-BIT)

  • Serial (b)
  • Virtual Serial
  • AT® Synchronous (b).

PARALLEL (COMMUNICATION) DEVICE DRIVERS (16-BIT)

  • 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:

  • 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.

Additional books and enhancements to these books may be included in subsequent releases.

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.

CUSTINFO

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

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