home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / ddkx86v1.zip / README.DDK < prev   
Text File  |  1995-04-20  |  11KB  |  254 lines
  1.  
  2.      IBM DEVELOPER CONNECTION DEVICE DRIVER KIT FOR OS/2 - Version 2
  3.      ===============================================================
  4.  
  5. This file contains information you need to install the IBM Developer Connection
  6. Device Driver Kit for OS/2, and additional information not included in the
  7. documentation.
  8.  
  9. This README file is divided into the following categories:
  10.  
  11. o  Before You Install the IBM Developer Connection Device Driver Kit for OS/2
  12.  
  13. o  Installing the IBM Developer Connection Device Driver Kit for OS/2
  14.  
  15. o  Getting Help
  16.  
  17. o  Late-Breaking News and Special Notes
  18.  
  19. o  Your Satisfaction
  20.  
  21. o  Trademarks
  22.  
  23.  
  24. Before You Install the IBM Developer Connection Device Driver Kit for OS/2
  25. ===========================================================================
  26.  
  27.    Software Requirements
  28.    ---------------------
  29.    One of the following:
  30.      OS/2 2.0 with ServicePak XR06055 (See Note)
  31.      OS/2 2.1
  32.      OS/2 Warp
  33.  
  34.    NOTE:  Without the ServicePak, your OS/2 2.0 installation will not
  35.           return the correct results from application-specific exits
  36.           even though the exit completes correctly.  Also, Workplace
  37.           Shell objects created during an installation will not use
  38.           the specified icon.
  39.  
  40.    Hardware Requirements
  41.    ---------------------
  42.    1. The SWAPPER.DAT file may grow during installation depending on the
  43.       number of components you select.  To do a full installation on an
  44.       8MB RAM system, at least 15MB of disk space should be available to
  45.       SWAPPER.DAT.  Systems with more RAM require less disk space (for
  46.       example, a system with 16MB RAM will require 10MB of disk space
  47.       for a full installation).
  48.  
  49.    2. You must have at least 2MB of disk space on your boot drive.
  50.  
  51.    NOTE:  If you are installing over a previous version of the DDK and
  52.           you don't want any of your previous DDK files, you can use a
  53.           special tool called DELDDK to delete all information related
  54.           to the installed DDK.  This file is located in the \DDKx86\SETUP
  55.           directory on the CD.  DELDDK will delete all .INI information,
  56.           the old DDK folder on the Desktop, and the specified DDK tree.
  57.  
  58.    WARNING: Make sure to BACK UP any files that you want to
  59.             save BEFORE you run DELDDK.  ALL files under the
  60.             specified directory and its subdirectories will be
  61.             DELETED by DELDDK.
  62.  
  63.  
  64. Installing the IBM Developer Connection Device Driver Kit for OS/2
  65. ==================================================================
  66. To start the installation process, execute the DDKINST command file
  67. located in the root directory of the CD.  The DDK installation program
  68. allows installation of selected (or all) components.
  69.  
  70. NOTES:  The "Delete the Installed Components and Reinstall" option
  71.         might not work in certain situations.  To circumvent this
  72.         problem, back up any files that you want to save and use the
  73.         DELDDK tool to delete the previously installed DDK.  You can
  74.         then run a fresh installation.
  75.  
  76.         When components are selected from the "Install - directories"
  77.         panel, the installation program displays the total hard disk
  78.         space (in bytes) necessary to install all the selected
  79.         components.  You can review the free space available on each
  80.         disk by selecting the "Disk space..." push button from the same
  81.         panel.
  82.  
  83.         The "bytes needed" figure displayed by the installation program
  84.         (which includes space for the installation program work files)
  85.         is an approximation of the MAXIMUM number of bytes of free space
  86.         required to perform an installation on a FAT-formatted disk.
  87.         Significantly less space is required for installation on an
  88.         HPFS-formatted disk.
  89.  
  90.  
  91. Getting Help
  92. ============
  93.  
  94.    Using Your DDK
  95.    --------------
  96.    "Using Your DDK" in the DDK for OS/2 folder is an online document that
  97.    describes in detail how to use the IBM Developer Connection Device
  98.    Driver Kit for OS/2.
  99.  
  100.    It includes the following information:
  101.  
  102.    - A list of available driver source code, tools, and documentation
  103.    - Compilers that are required to build a specific driver
  104.    - A tree structure showing where specific driver files are located
  105.    - Instructions on how to build a specific driver
  106.    - Special considerations etc.
  107.  
  108.    Device Driver Documentation
  109.    ---------------------------
  110.    The \BOOK directory, under the DDK base directory, contains the
  111.    DDK online documentation.  The files contained in this directory
  112.    are .INF files and can be viewed with the OS/2 VIEW command.  You
  113.    also can view the documentation directly from the CD (without
  114.    installing the books on your hard disk) by double-clicking on
  115.    "DDK References on DDK CD-ROM" in the DDK for OS/2 folder on the
  116.    Desktop.
  117.  
  118.    PowerPC Documentation
  119.    ---------------------
  120.    PowerPC Reference Platform Specification V1.0 is included in the
  121.    DDK online documentation.  To order a hardcopy of this reference,
  122.    call 1-800-POWERPC using MPR-PPC-RPU-02 as the order number.
  123.  
  124.    Service and Technical Support
  125.    -----------------------------
  126.    We are ready to help you with your IBM Developer Connection Device
  127.    Driver Kit for OS/2 questions.  You can contact us through the
  128.    following channels:
  129.  
  130.    1. Use a PC and modem to place a call to the DUDE BBS at (407)982-3217
  131.       (N, 8, 1  14.4 KBPS).  After completing a self-registration, you
  132.       will have limited access to the system.  Additional information on
  133.       Driver Development Support Center (DDSC) and system operations will
  134.       be presented on the system after registration.  Within one business
  135.       day, the DUDE team will verify the completion of your registration
  136.       information, upgrade your access level to NORMAL, and notify you.
  137.  
  138.    2. Developers experiencing problems connecting to the DUDE BBS can call
  139.       (407)982-4239 where they will hear a recorded message directing them to
  140.       leave a name and phone number.  The messages are retrieved throughout
  141.       the day, Monday-Friday, 8.00 a.m to 5.00 p.m. Eastern time.  A member
  142.       of the DUDE team will return the call by the end of the next business
  143.       day.
  144.  
  145.  
  146. Late-Breaking News and Special Notes
  147. ====================================
  148.  
  149.    CHANGE/SUPPORT NOTICE
  150.    ---------------------
  151.    The source code contained in this DDK, besides sample code,
  152.    includes the latest actual, buildable source code that will
  153.    produce working drivers for different types of devices.
  154.  
  155.    The goal of the DDK is to provide device driver developers with
  156.    as much of this tested code as early as possible.  However, some
  157.    of this source code might be "preliminary" or "IBM internal use
  158.    code."  This type of code is considered "unsupported" and is
  159.    subject to change without notice.  Examples of this unsupported
  160.    code are any function calls that are not documented in the
  161.    available IBM Reference Manuals included in "Using Your DDK" (in
  162.    the "Online Documentation" section under "DDK Roadmap").
  163.  
  164.    Device Drivers Referencing PMWINP.H
  165.    -----------------------------------
  166.    Any device drivers that previously referenced the files PMWINP.H
  167.    or PMWINP.INC have been changed to reference the files PMWINX.H
  168.    and PMWINX.INC.  If you are migrating to the current DDK, change
  169.    any drivers on previous DDKs that referenced the files PMWINP.*
  170.    to refer to the new PMWINX.* files.
  171.  
  172.    Microsoft MASM 6.0B
  173.    -------------------
  174.    Building drivers with Microsoft MASM 6.0B has known problems. We
  175.    suggest that you use Microsoft MASM 6.0 for a successful build.
  176.  
  177.    OS/2 DEBUG KERNELS
  178.    ------------------
  179.    The OS/2 debug kernels are now supplied with The Developer Connection
  180.    for OS/2.
  181.  
  182.    MODULE LEVEL VERSION CONTROL
  183.    ----------------------------
  184.    This DDK includes information on "Module Level Version Control,"
  185.    an important procedure for device-driver developers.  Refer to
  186.    the "Module Level Version Control" section in "Using Your DDK" for
  187.    more information.
  188.  
  189.    CONSIDERATIONS WHEN INSTALLING THE OS/2 2.1 SERVICEPAK XR06200
  190.    --------------------------------------------------------------
  191.    Delivering the OS/2 2.1 ServicePak XR06200 uncovered a problem
  192.    that IBM believes is limited to display drivers.  If you modify
  193.    the source code provided in the DDK using the same display driver
  194.    name and then install the ServicePak, your device driver will be
  195.    overwritten.
  196.  
  197.    IBM has updated its display driver utilities to recognize display
  198.    drivers not packaged in the OS/2 2.1 product. IBM also has tested
  199.    a representative set of display drivers that support a broad range
  200.    of popular display adapters and hardware systems.  This will help
  201.    users recover their previous level of high resolution and color
  202.    support.
  203.  
  204.    The updated utilities and workaround information are available
  205.    electronically on worldwide bulletin boards and will be delivered
  206.    with the ServicePak. These updates and workarounds apply only to U.S.
  207.    versions of the ServicePak.
  208.  
  209.    IBM continues to work with independent hardware vendors and other
  210.    software developers to architect and define standards.
  211.  
  212.    Developer Connection Browser
  213.    ----------------------------
  214.    The Developer Connection Browser has been removed from the DDK.
  215.  
  216.    Device Driver Conference Presentations
  217.    --------------------------------------
  218.    The Device Driver Conference Presentations has been removed from
  219.    the DDK. Please refer to a previous version of the DDK for any
  220.    information you might need.
  221.  
  222. Your Satisfaction
  223. =================
  224. Your satisfaction with IBM is important to us. If you are not totally
  225. satisfied with this product, please contact us through one of the Service
  226. and Technical support channels listed above.
  227.  
  228. Tell us what is not meeting your expectations and why you are dissatisfied.
  229. Provide your name, your organization's name, and your telephone number so
  230. we can contact you.  We will work with you to resolve your concerns.
  231.  
  232. Also, print the survey in "Using Your DDK" document, fill it out, and
  233. send it to us.  Your input will help us plan future products for you.
  234.  
  235.  
  236. Trademarks
  237. ==========
  238. The following terms are trademarks of the IBM Corporation in the United
  239. States and/or other countries:
  240.  
  241.    IBM
  242.    OS/2
  243.    OS/2 Warp
  244.  
  245.  
  246.    IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESSED OR IMPLIED,
  247.    INCLUDING WITHOUT LIMITATION, WARRANTIES OF FITNESS AND
  248.    MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT.
  249.    BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY RELATED
  250.    PATENTS OR COPYRIGHTS.
  251.  
  252.    (c) Copyright IBM Corporation, 1995, all rights reserved.
  253.  
  254.