|
This document assumes that you are familiar with the Realmode Drivers
white paper and the External BEF Interface Specification for x86
Realmode DDI. Both documents are available on the Solaris Developer
Connection at http://soldc.sun.com/developer/support/driver.
The file BASIC.ZIP contains the files necessary for building realmode
drivers. It includes object files for the driver frameworks, subroutine
libraries, header files, and sample driver source code and makefiles.
Download this file (README.BAS) and BASIC.ZIP, and
copy them into the root of your realmode development tree. The root can
be any place that is convenient for you, but full path names in this
file are based on the assumption that you are using a directory called
C:\BOOT. If you use a different location, substitute your root
directory wherever you see C:\BOOT.
Extract the files from BASIC.ZIP such that the directory
hierarchy is preserved. Some extraction tools require an argument to
prevent all the files from being placed in the local directory. You
should have the following directory hierarchy after extraction:
C:\BOOT
+-- INC
|
+-- DRIVERS
+----- HALFBEFS
|
+----- INCLUDE
|
+----- LIB
|
+----- NETWORK
| +----- PCN
|
+----- PROTO
|
+----- SCSI
+----- AHA1540
Once you have installed the files in this manner, consult the Realmode
Drivers white paper for details on how to write new realmode drivers.
If you need more detailed information about the realmode driver
framework than is available in the white paper and BASIC.ZIP,
read README.SRC and then download and extract
SOURCE.ZIP. This archive contains the full source of the
driver framework.
If you are having difficulty getting your driver to work, read
README.DBG and then download and extract DEBUG.ZIP.
This archive contains debug versions of framework object files and a
debug utility to assist with debugging realmode drivers using MS-DOS
debuggers.
Following is the list of files included in BASIC.ZIP file and
the rights associated with these files. Please refer to the use placed
upon each file.
The following files are Modifiable and Redistributable according to
terms of the Binary Code License Agreement and Supplemental License Terms
listed in the download agreement:
drivers/makefile.inc
drivers/makefile.sub
drivers/halfbefs/joyst.c
drivers/halfbefs/makefile
drivers/network/pcn/makefile
drivers/network/pcn/pcn.c
drivers/network/pcn/pcn.h
drivers/proto/makefile
drivers/proto/proto.c
drivers/proto/proto.h
drivers/scsi/aha1540/makefile
drivers/scsi/aha1540/aha1540.c
drivers/scsi/aha1540/aha1540.h
Following files are Not Modifiable but Redistributable in a binary form
according to terms of the Binary Code License Agreement and
Supplemental License Terms listed in the download agreement:
drivers/include/rmsc.h
drivers/include/rmscnet.h
drivers/include/rmscscsi.h
drivers/include/stdarg.h
drivers/include/stdio.h
drivers/include/stdlib.h
drivers/include/string.h
drivers/include/types.h
drivers/lib/oldnames.lib
drivers/lib/slibce.lib
drivers/lib/common.lib
drivers/lib/helpers.lib
drivers/lib/crt0.obj
drivers/main.obj
drivers/network/network.obj
drivers/scsi/scsi.obj
drivers/include/bef.h
inc/befext.h
inc/dostypes.h
inc/dev_info.h
| 
Print-friendly Version
