IBM Device Driver Source Kit for OS/2: Difference between revisions

From OS2World.Com Wiki
Jump to navigation Jump to search
No edit summary
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
NUMBER     293-253
{{Article
DATE      930525
|Author=IBM
|Date=1993-05-25
|OS=
|File=N/A
|Source=[https://www.ibm.com/docs/en/announcements/archive/ENUS293-253]
}}
:NUMBER 293-253


ABSTRACT
==ABSTRACT==
 
The IBM Device Driver Source Kit for OS/(DDK) on CD-ROM media contains:
The IBM Device Driver Source Kit for OS/2 (R) (DDK) on CD-ROM media contains:
* IBM's latest release of OS/2 device driver source code
* IBM's latest release of OS/2 device driver source code
* Build and test tools for several device drivers
* Build and test tools for several device drivers
Line 16: Line 21:
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.
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.
One-Time Charge: $499.
 
Availability Date:  May 25, 1993.


(R) Registered trademark of International Business Machines Corporation.
Availability Date: May 25, 1993.


IN BRIEF...
® Registered trademark of International Business Machines Corporation.


==IN BRIEF...==
The IBM Device Driver Source Kit for OS/2 (71G3703) features:
The IBM Device Driver Source Kit for OS/2 (71G3703) features:
* Full source code enabling rapid development of new device drivers
* Full source code enabling rapid development of new device drivers
Line 46: Line 50:
* Generally available updates, if any, for one year from the ordering date at no additional charge
* Generally available updates, if any, for one year from the ordering date at no additional charge


PRODNO
==PRODNO==


  71G3703
  71G3703
Line 56: Line 60:
  71G3678
  71G3678


OVERVIEW
==OVERVIEW==
 
===DESCRIPTION===
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.
 
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
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.


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


PRINTER DEVICE DRIVERS:
PRINTER DEVICE DRIVERS:
Line 79: Line 77:
* 32-bit Serial Port (a)
* 32-bit Serial Port (a)
* 32-bit Parallel Port (a).
* 32-bit Parallel Port (a).
DISPLAY DEVICE DRIVERS:
DISPLAY DEVICE DRIVERS:
* 16-bit VGA (b)
* 16-bit VGA (b)
Line 87: Line 84:
* SVGA Utility
* SVGA Utility
* Virtual Video
* Virtual Video
* XGA (R) Virtual Video
* XGA® Virtual Video
* 32-bit VGA
* 32-bit VGA
* SVGA-256
* SVGA-256
* 32-bit XGA (b) (beta)
* 32-bit XGA (b) (beta)
* 32-bit XGA Presentation Manager (R)
* 32-bit XGA Presentation Manager®
* 32-bit XGA Base Video Handler
* 32-bit XGA Base Video Handler
* 32-bit 8514 (b) (beta)
* 32-bit 8514 (b) (beta)
Line 100: Line 97:


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


(1) Trademark of Adobe Systems, Incorporated.
(1) Trademark of Adobe Systems, Incorporated.
(R) Registered trademark of International Business Machines Corporation.
® Registered trademark of International Business Machines Corporation.
(2) Trademark of Microsoft Corporation.
(2) Trademark of Microsoft Corporation.
(3) Trademark of Microsoft Corporation.
(3) Trademark of Microsoft Corporation.
Line 117: Line 114:


DASD DEVICE DRIVERS (16-BIT):
DASD DEVICE DRIVERS (16-BIT):
          o  OS/2 DASD Device Manager (b)
* OS/2 DASD Device Manager (b)
          o  OS/2 ASPI Device Manager (b)
* OS/2 ASPI Device Manager (b)
          o  Removable DASD to Fixed Drive Conversion (b)
* Removable DASD to Fixed Drive Conversion (b)
          o  Adapter Presence Detection Sample (b)
* Adapter Presence Detection Sample (b)
          o  Adapter for ST506/IDE DASD (b)
* Adapter for ST506/IDE DASD (b)
          o  Adapter for ABIOS DASD (b)
* Adapter for ABIOS DASD (b)
          o  Virtual Machine Disk Generator (b).
* Virtual Machine Disk Generator (b).
          SCSI DEVICE DRIVERS (16-BIT):
SCSI DEVICE DRIVERS (16-BIT):
          o  OS/2 SCSI.SYS Emulation (b)
* OS/2 SCSI.SYS Emulation (b)
          o  Adapter for ABIOS SCB (b).
* Adapter for ABIOS SCB (b).
          DISKETTE DEVICE DRIVERS (16-BIT):
DISKETTE DEVICE DRIVERS (16-BIT):
          o  Adapter for ABIOS Diskette (b) (Floppy)
* Adapter for ABIOS Diskette (b) (Floppy)
          o  OS/2 ISA/EISA Floppy (b)
* OS/2 ISA/EISA Floppy (b)
          o  Virtual Floppy
* Virtual Floppy
          o  Protected Mode VDisk (RAM) for CP/DOS 2.0.
* Protected Mode VDisk (RAM) for CP/DOS 2.0.
          MOUSE DEVICE DRIVERS (16-BIT):
MOUSE DEVICE DRIVERS (16-BIT):
          o  Mouse Subsystem
* Mouse Subsystem
          o  Mouse Family G
* Mouse Family G
          o  Virtual Mouse.
* Virtual Mouse.
          KEYBOARD DEVICE DRIVERS (16-BIT):
KEYBOARD DEVICE DRIVERS (16-BIT):
          o  Keyboard Family 1
* Keyboard Family 1
          o  Keyboard Family 2
* Keyboard Family 2
          o  Virtual Keyboard.
* Virtual Keyboard.
          MMPM/2 DEVICE DRIVERS:
MMPM/2 DEVICE DRIVERS:
          o  Audio Template (b), (c)
* Audio Template (b), (c)
          o  Audio Virtual (c).
* Audio Virtual (c).
          PEN DEVICE DRIVERS:
PEN DEVICE DRIVERS:
          o  Pen Base
* Pen Base
          o  Pen Serial Digitizer
* Pen Serial Digitizer
          o  Pen for OS/2 Calibration Tool (a)
* Pen for OS/2 Calibration Tool (a)
          o  Pen Tool for PenPM (a).
* Pen Tool for PenPM (a).
          8516 TOUCH DEVICE DRIVERS (16-BIT):
8516 TOUCH DEVICE DRIVERS (16-BIT):
          o  Touch Device Independent (b)
* Touch Device Independent (b)
          o  Touch Device Dependent (b)
* Touch Device Dependent (b)
          o  Virtual Touch Device Independent.
* Virtual Touch Device Independent.
          SERIAL (COMMUNICATION) DEVICE DRIVERS (16-BIT)
SERIAL (COMMUNICATION) DEVICE DRIVERS (16-BIT)
          o  Serial (b)
* Serial (b)
          o  Virtual Serial
* Virtual Serial
          o  AT (R) Synchronous (b).
* AT® Synchronous (b).
          PARALLEL (COMMUNICATION) DEVICE DRIVERS (16-BIT)
PARALLEL (COMMUNICATION) DEVICE DRIVERS (16-BIT)
          o  Parallel Port (b)
* Parallel Port (b)
          o  Virtual Parallel.
* Virtual Parallel.
            (a) IBM C Set/2 (ICC) Compiler required.
:(a) IBM C Set/2 (ICC) Compiler required.
            (b) Microsoft C Optimizing Compiler (CL) Version 6.00A required.
:(b) Microsoft C Optimizing Compiler (CL) Version 6.00A required.
            (c) MMPM/2 Toolkit required.
:(c) MMPM/2 Toolkit required.
          BUILD AND TEST TOOLS
 
          The build tools facilitate the development of the device drivers and
BUILD AND TEST TOOLS
          the test tools verify the quality of the developed drivers. Many
 
          drivers include test cases that will facilitate construction of test
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.
          cases for new drivers.
          TEST TOOLS:
          o  Display (b) -- tests all mandatory graphics engine (GRE)
              functions for display drivers.
          o  Paltest (b) -- tests general palette manager for Presentation
              Manager display drivers.
          o  Paldisp (b) -- displays the hardware palette in a Presentation
              Manager window; use for debugging palette manager enabled
              Presentation Manager display.
          o  Printer -- performs tests for all mandatory graphics engine (GRE)
              functions for printer drivers.
          o  Pen
          o  Pen Calibration
          o  Multimedia Audio Exerciser (c)
          o  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:
          o  General Information
          o  Printer Device Driver Reference
          o  Display Device Driver Reference
          o  Storage Device Driver Reference
          o  Input/Output Device Driver Reference
          o  PenPM Device Driver Reference
          o  MMPM/2 Device Driver Reference
          o  Presentation Device Driver Reference
          o  Virtual Device Driver Reference
          o  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
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.


The following publications may be ordered separately.  To
ONLINE DOCUMENTATION
order, contact Direct Response Marketing at 800-633-8266; specify the
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.
title, order number and quantity.
                                                              ORDER
          TITLE                                              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


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


TECHNICAL INFORMATION
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
SPECIFIED OPERATING ENVIRONMENT
          MACHINE REQUIREMENTS:
          o  System supported by OS/2 2.0
          o  Recommended 8MB (or greater) system memory
          o  20MB up to 83MB (HPFS) or 120MB (FAT) hard disk memory, depending
              on user preferences
          o  One OS/2 supported CD-ROM drive
          o  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:
          o  Microsoft Macro Assembler (MASM) Version 5.10A.15
          o  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.
          o  Microsoft C Optimizing Compiler (CL) Version 6.00A
          o  IBM C Set/2 (ICC) Compiler
          o  MMPM/2 Toolkit
          PLANNING INFORMATION
          PACKAGING:  The Device Driver Source Kit for OS/2 contains the
          following:
          o  One CD-ROM containing the machine readable information
          o  IBM License Agreement for the IBM Device Driver Source Kit
              Version 1.0 for OS/2
          o  WIN-OS/2 (TM) 3.1 Seamless Device Driver Supplement Registration.
            (TM) 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
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.


ORDERING INFORMATION
SECURITY, AUDITABILITY AND CONTROL


To order, contact Direct Response Marketing at 800-633-8266;
User management is responsible for evaluation, selection and implementation of security features, administrative procedures and appropriate controls in application systems and communication facilities.
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                CD-ROM
                            for OS/2
o  Program Package -- program CD-ROM
o  Documentation -- separate documentation without program CD-ROM.


TERMS AND CONDITIONS
==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.


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


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


PROGRAM SERVICES: Developer support is available to all licensee's
PROGRAM SERVICES: Developer support is available to all licensee's of the IBM Device Driver Source Kit for OS/2.
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
Developer support (technical assistance) encompasses DDK usage
are expected to have device driver development experience or be willing to invest the time necessary to work through most of their
and many aspects of device driver development in general. Developers
own questions and problems. Developer support is not intended to provide an education service. It is intended, however, to answer
are expected to have device driver development experience or be
specific questions after the device driver developer has made a reasonable effort to obtain an answer using available information.
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
Central Service is not available for this product, but developers are encouraged to use the IBM Driver Development Support
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
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.
easily downloaded for review offline.


Developers interested in using the DDSC System should dial
Developers interested in using the DDSC System should dial (via modem) 407-982-3217 to register and to access the support
(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.
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
Support for a specific release of the DDK will be available until 30 days after the release of the subsequent DDK. General
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.
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
Additional support is available depending on the licensee's geography and participation in certain IBM programs (for example, the
geography and participation in certain IBM programs (for example, the
OS/2 Developer Assistance Program (DAP)).
OS/2 Developer Assistance Program (DAP)).


TESTING PERIOD: None; 30-day money-back guarantee applies.
TESTING PERIOD: None; 30-day money-back guarantee applies.
          CHARGES
{|class="wikitable"
          PROGRAM                                               ONE-TIME
|+CHARGES
          NUMBER        DESCRIPTION                            CHARGE
!PROGRAM NUMBER||DESCRIPTION||ONE-TIME CHARGE<br/>$
          71G3703       Device Driver Source Kit
|-
                            for OS/2                               $499
|71G3703||Device Driver Source Kit for OS/2||499
          71G1895       Printer Device Driver
|-
                            Reference                               29
|71G1895||Printer Device Driver Reference||29
          71G1896       Display Device Driver
|-
                            Reference                               29
|71G1896||Display Device Driver Reference||29
          71G1897       Storage Device Driver
|-
                            Reference                               29
|71G1897||Storage Device Driver Reference||29
          71G1898       Input/Output Device Driver
|-
                            Reference                               29
|71G1898||Input/Output Device Driver Reference||29
          71G1899       PenPM Device Driver
|-
                            Reference                               29
|71G1899||PenPM Device Driver Reference||29
          71G3678       MMPM/2 Device Driver
|-
                            Reference                               29
|71G3678||MMPM/2 Device Driver Reference||29
|}
[[Category:IBM US Announcement Letter]]

Latest revision as of 16:27, 2 March 2025

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