home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / g / gtak212.zip / OS2-DD / readme < prev    next >
Text File  |  1993-01-16  |  3KB  |  94 lines
  1. OS2-DD    C Character Device Driver Support Package
  2.     for OS/2 1.3 and 2.0.
  3.  
  4.     Andreas Kaiser,
  5.     Danziger Str. 4
  6.     D-7000 Stuttgart 70
  7.     Germany
  8.  
  9.     Fido:    2:241/7220.9
  10.     Subnet:    ak@ananke.stgt.sub.org
  11.  
  12. Legal Notice (I don't write legal stuff in a foreign language, sorry):
  13. ----------------------------------------------------------------------
  14.  
  15. Ich uebernehme keinerlei Gewaehrleistung für korrekte Funktion oder
  16. irgendwelche daraus resultierenden Schaeden oder Folgeschaeden. Es
  17. liegt in der Natur von Geraetettreibern, dass dadurch die Integritaet
  18. des Systems verletzt werden kann.
  19.  
  20. Licence:
  21. --------
  22.  
  23. You are free to use and modify this source, as long as you make your
  24. source and your device driver available for public according to the
  25. usualy GNU Copyleft license and send me a note for what device your
  26. driver was written.
  27.  
  28. Files:
  29. ------
  30.  
  31. This driver was developed for Zortech C, but should be usable with
  32. other compilers too.
  33.  
  34. dd-head.inc    Device driver header.
  35.         Requires some symbol definitions
  36.             DD_ATTRIB    Driver attributes.
  37.             DD_NAME        Device name, 8 characters
  38.                     padded with spaces.
  39.         The driver source must provide an ASM file, which
  40.         defines both symbols and includes this file. No more
  41.         contents are required. The generated object file must
  42.         be the object first file in the linker command line,
  43.         since the header must be the first data in the EXE/SYS
  44.         file.
  45.  
  46. dd-segs.inc    Device driver segment definitions.
  47. macros.inc    Utility macros.
  48.  
  49. lowlevel.asm    Bottom layer. Contains entry point, C wrappers.
  50.         for most DD helper functions, ...
  51.  
  52. dd.h        Device driver definitions and declarations.
  53.  
  54. strategy.c    Strategy routine. Dispatches device driver functions.
  55.  
  56. ddebug.c    Debugging code for direct video output.
  57.  
  58.         If you use Zortech C, the function _STI_ddebug is
  59.         automatically called whenever this file is linked
  60.         with the driver (= when debugging code is compiled).
  61.  
  62.         If you do not use Zortech C, you have to call
  63.         _STI_ddebug as the first statement of DrvInit();
  64.  
  65.         Set the variable video_address to 0xB8000 to get
  66.         debug output on VGA, the default is 0xB0000 for a
  67.         monochrome chard. Use monochrome whenever possible,
  68.         you might not get init time output for BASEDEVs when
  69.         the output is on VGA.
  70.  
  71. d2debug.c    Same as ddebug.c but for BASEDEV drivers.
  72.  
  73.         If you do not use Zortech C, you have to call
  74.         _STI_d2debug as the first statement of DrvInitBase();
  75.  
  76. def_*.c        Default driver functions, called by strategy()
  77.         unless defined in the device driver source
  78.         (requires linking with /NOE).
  79.  
  80. demo.def    Sample definition file.
  81.  
  82. Usage:
  83. ------
  84.  
  85. You should already know about OS/2 device driver programming. The
  86. strategy dispatcher calls functions named DrvInit, DrvRead, ... (see
  87. dd.h) whenever the corresponding function code is received. The default
  88. versions in this library return an "Invalid Function" error indicator.
  89. These functions should return the status word (e.h. "return DONE").
  90.  
  91. Debugging support required a monochrome card. Debugging is enabled when
  92. compiling with DEBUG=1. For non-ZTC users: Don't output debugging info
  93. before DrvInit or DrvInitBase calls the appropriate _STI_ function.
  94.