Category : Recently Uploaded Files
Archive   : INFOPACK.ZIP
Filename : EXAMPLE.RTF

{\rtf1\ansi \deff0{\fonttbl{\f0\froman Tms Rmn;}{\f1\fdecor Symbol;}{\f2\fswiss Helv;}{\f3\fmodern Courier;}}{\colortbl;\red0\green0\blue0;\red0\green0\blue255;\red0\green255\blue255;\red0\green255\blue0;\red255\green0\blue255;
\red255\green0\blue0;\red255\green255\blue0;\red255\green255\blue255;}{\stylesheet{\s242\tqc\tx4320\tqr\tx8640 \fs20 \sbasedon0\snext242 footer;}{\s243\tqc\tx4320\tqr\tx8640 \fs20 \sbasedon0\snext243 header;}{\fs20 \snext0 Normal;}}{\info{\title Example}
{\subject Example CDROM Driver Description}{\author Michael Edwards}{\doccomm A description of the example CDROM device driver distributed with MSCDEX v2.2 release.}{\operator Batman}{\creatim\yr1990\mo7\dy16\hr11\min16}{\revtim\yr1990\mo8\dy7\hr13\min21}
{\printim\yr1990\mo8\dy23\hr12\min58}{\version37}{\edmins1750}{\nofpages2}{\nofwords724}{\nofchars4580}{\vern8310}}\margl2160\widowctrl\ftnbj\ftnrestart \sectd \linex0\endnhere\titlepg {\header \pard\plain \qr\sl240 \fs20 {\b\f2\fs16
Example Device Driver - Microsoft MS-DOS CD-ROM Extensions Version 2.20
\par }\pard\plain \s243\tqc\tx4320\tqr\tx8640 \fs20
\par }{\footer \pard\plain \qr\sl240 \fs20 {\b\f2\fs16 Example Device Driver Description - Copyright (C) Microsoft Corp. 1990. All rights reserved - page }{\field{\*\fldinst {\b\f2\fs16 page}}{\fldrslt {\b\f2\fs16 2}}}{\b\f2\fs16
\par }\pard\plain \s242\qc\tqc\tx4320\tqr\tx8640 \fs20
\par }{\headerf \pard\plain \qc\sl240 \fs20 {\b\f2\fs28 Microsoft MS-DOS CD-ROM Extensions
\par Example Device Driver
\par 15 August 1990
\par }\pard\plain \s243\tqc\tx4320\tqr\tx8640 \fs20
\par }{\footerf \pard\plain \qr\sl240 \fs20 {\b\f2\fs16 Example Device Driver Description - Copyright (C) Microsoft Corp. 1990. All rights reserved - page }{\field{\*\fldinst {\b\f2\fs16 page}}{\fldrslt {\b\f2\fs16 1}}}{\b\f2\fs16
\par }\pard\plain \s242\qc\tqc\tx4320\tqr\tx8640 \fs20
\par }\pard\plain \qj\sl240 \fs20
The purpose of the example CD-ROM device driver is to demonstrate an implementation of a MSCDEX CD-ROM device driver conforming to the specification in the document "Microsoft MS-DOS CD-ROM Extensions Hardware-Dependent Device Driver Specification". Usin
g this example as a starting point, together with an understanding of the device driver specification, greatly simplifies the task of creating a MSCDEX CD-ROM device driver.
\par
\par {\plain \b Installation
\par }\pard \sl240 {\b
\par }This example driver is for use on an AT style bus with most of H
itachi's drives and controllers except their SCSI devices (CDR-3650). The device driver is installed in the same way as any other device, with an entry in CONFIG.SYS. The syntax of this entry is:
\par \pard \fi432\sl240
\par \pard \sl240 DEVICE=<{\i filename}> /D:<{\i device_names}> /N:<{\i drives}> /P:<{\i port address}> C:<{\i minutes}>
\par
\par where the arguments are:
\par
\par <{\i filename}>\tab \tab the MS-DOS path to, and name of, the device driver file.
\par \pard \fi-2160\li2160\sl240
\par /D:<{\i device_names}>\tab the character device names that will be used by MSCDEX.EXE to find and communicate with the device driver. Alth
ough more than one device name on the command line provides names for multiple device headers to control more than one physical device, this example supports multiple devices as sub-units of a single device header (the recommended approach). Choose uniqu
e device names that you do not expect to use as file names. DOS's file open code looks at the device list before opening files, so a device named 'CDROM' would prevent opening a file or directory named 'CDROM'.
\par
\par \pard \fi-2160\li2160 /N:\tab
the number of sub-units (physical drives) attached to the interface card (defaults to one sub-unit). This example supports a maximum of 8 drives, however when more than 4 drives are controlled by one device driver, you need to use an interface card and d
rives that support 8-drive-daisy-chaining (for example, CDR-IFI8-A, CDR-3600, etc.)
\par
\par \pard \fi-2160\li2160\sl240 /P:\tab the port address to be used to communicate with the card (defaults to 300H).
\par
\par /C:\tab the number of minutes of driver inactivity before the power save feature (which will increase the life span of the drive unit) should turn off the drive motor. This is a value from 0 to 14H, where 0 disables the spin down feature.
\par \pard \qj\sl240
\par {\plain \b \page Building the Driver
\par }\pard \sl240 {\b
\par }\pard The source files and the makefile you need to build the driver are in the HITACHIA directory on the SUP: disk. The tools (MASM 5.1, etc.) are in BIN directory of the TOOLS: disk. The files needed to build the driver include:
\par \pard \fi-2160\li2160
\par MAKEFILE\tab The makefile to build the driver.
\par
\par MSCDEX.ASM\tab This file is device indepe
ndent and can be used by a device driver with no changes. It contains all the entry points for the commands that a MSCDEX CD-ROM device driver is expected to handle. Some commands, and certain device independent data, are handled without actually callin
g the device dependent code in CD.ASM.
\par
\par CD.ASM\tab This file contains device dependent code for all the entry points defined in MSCDEX.ASM. These routines start with the letters "cdrom_", and have explicitly defined entry and exit conditions. A device drive
r should use this file as a starting point by replacing the Hitachi implementation with the necessary device dependent code to perform the equivalent functions, and carefully adhering to the indicated entry and exit conditions.
\par
\par MSCDEX.INC\tab This is an include file for MSCDEX.ASM and CD.ASM with useful definitions for command structures, error codes, and the status word.
\par
\par MACROS.MAC\tab This is an include file for MSCDEX.ASM and CD.ASM with useful macro definitions to make the code easier to read.
\par
\par CD.INC\tab This is an include file for CD.ASM defining names for the low-level driver commands provided in CDREAD.ASM.
\par
\par CDREAD.ASM\tab This file contains the function CDREAD() which has about 26 sub-functions to perform various low level driver commands.
\par
\par CDREAD.AT\tab This is an include file for CDREAD.ASM defining various port addresses, control codes, and other defines.
\par
\par CDREAD.DOC\tab This file documents the entry and exit conditions for the sub-functions provided by CDREAD().
\par
\par ECC.ASM\tab This file contains the routine to
do the last level of error correction in the event the Cross Interleave Reed-Solomon Code implemented in the drive is not able to correct a read error. For performance considerations it is recommended that this level of error correction also be done on
the drive.
\par
\par TRACER.ASM\tab This file is linked if the DEBUG label is defined in the MAKEFILE. It defines WriteAux which directs messages to the serial port.
\par
\par \pard \fi-2160\li2160\tx1080 CMACROS.INC\tab This is an include file used by TRACER.ASM, and defines various constructs to improve readability and ease writing of assembly code.
\par \pard \fi-2160\li2160
\par }