home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / znode3 / uploads / tbmsbios.lbr / TBMSBIOS.HZR / TBMSBIOS.HDR
Encoding:
Text File  |  1993-06-07  |  8.5 KB  |  224 lines
  1. ; ASSEMBLY OF TBMSBIOS
  2. ; ====================
  3. ; 
  4. ; TBMSBIOS is configured to assemble with SLR's Z80ASM assembler.  It must 
  5. ; be assembled to a HEX file and overlaid onto the appropriate TurboROM SYS 
  6. ; file, as described below.  Minor changes to the code will doubtless allow 
  7. ; it be be assembled by ZASM or M80.  It may be overlaid onto a SYS file 
  8. ; using MLOAD, or by the more cumbersome method of using DDT or ZSID and 
  9. ; SAVEing the resulting image.  If you have Z80ASM (highly recommended) you 
  10. ; may use MAKEBIOS.SUB to automate assembly.  This script file should run 
  11. ; under either ZEX or SUBMIT.  The syntax for MAKEBIOS.SUB is:
  12. ;
  13. ;        MAKEBIOS insys outsys
  14. ;
  15. ; Insys is the name of the file over which to overlay TBMSBIOS and outsys is
  16. ; the name you wish to give to the resulting file.  Do not include the .SYS 
  17. ; filename extension.  The script will take care of it.
  18.  
  19.  
  20. ; USER DEFINABLE EQUATES FOR TBMSBIOS
  21. ; ==================================
  22.  
  23. ; Runtime BIOS location
  24. ; --------------------- 
  25. ; 
  26. ; You must determine the runtime location of this BIOS and the size of the 
  27. ; system with which it is to be integrated.  Run the peek program supplied 
  28. ; with TurboROM and find the first scratch address.  The assembler will use 
  29. ; that address to assist you in optimizing your system size. The correct 
  30. ; "system size" as provided to MOVTURBO will be displayed in the assembly 
  31. ; stats.  If it is different from that of the current system you will have 
  32. ; to use MOVTURBO to create a new system image over which to overlay this 
  33. ; BIOS.  
  34. ; 
  35. scratch        equ    0f7e9h    ; First Scratch address returned by peek.
  36.                 ; If you wish to reserve additional high 
  37.                 ; memory, set scratch to the lowest address 
  38.                 ; of your reserved area.
  39.  
  40.  
  41. ; The first assembly of TBMSBIOS will provide you with the runtime location 
  42. ; of the BIOS for an optimized system, along with the necessary system size 
  43. ; of the SYS file over which it will be overlaid.  If the suggested bios 
  44. ; location differs from biosloc, you may set biosloc to the suggested value 
  45. ; and reassemble TBMSBIOS go generate the highest possible system.
  46. ; 
  47. ;
  48. biosloc        equ    0f400h    ; Runtime location of BIOS
  49.  
  50.  
  51. ; Graphics Character Display
  52. ; --------------------------
  53. ;
  54. ; The grafbyte allows ZCPR to toggle Kaypro graphics on and off.  If you 
  55. ; wish to take advantage of this feature, set grafbt to the ADDRESS you wish 
  56. ; the BIOS to check to determine whether or not to output graphics char- 
  57. ; acters.  A non zero value at this address will supress graphics character 
  58. ; output.  This address may be in high memory or in the Z3 environment if 
  59. ; the address of the latter remains constant.  If you don't want this 
  60. ; feature, leave grafbt null.  '83 Kaypro 10 should have grafbt = 0.
  61. ;
  62. grafbt        equ    0    ; 0 for '83 machines
  63.  
  64.  
  65. ; Stack Location
  66. ; --------------
  67. ;
  68. ; If you wish to include the BIOS stack space in the code (recommended 
  69. ; unless you modify the code and increase it's size beyond the maximum 
  70. ; SYS file size) leave bstack null.  If you wish to set another stack
  71. ; address, set bstack to the BOTTOM address of this 64 byte stack space.
  72.  
  73. bstack        equ    0    ; bios stack, 0 if internal
  74.  
  75.  
  76. ; Initial Disk and User
  77. ; ---------------------
  78. ;
  79. ; You may specify the default disk and user following a cold boot.  If 
  80. ; a startup command is used, this should be the directory containing
  81. ; any files needed for startup, if other than a0:. 
  82. ;
  83. droot        equ    0    ; Initial default disk.  0 = A, 1 = B, etc.
  84. uroot        equ    15    
  85.  
  86.  
  87. ; Cold Boot Command Line
  88. ; ----------------------
  89. ;
  90. ; As a convenient minor bonus, you may specify an initial cold boot command 
  91. ; line for the SYS image you will be creating.  This is a ZCPR, not a BIOS 
  92. ; function, however the hex file generated by assembling this BIOS may be 
  93. ; conveniently used to overly a command line into the SYS image of the CCP 
  94. ; at the same time that the BIOS is overlaid.  Your SYS file must include 
  95. ; ZCPR1 as provided by Advent, or another configuration of ZCPR1 which 
  96. ; contains a command line buffer at ccp+7.  
  97. ;
  98. usecold        equ    true    ; True if specifing a cold boot command
  99.                 ; False to omit this feature
  100. ;
  101. coldcmd        macro
  102.         defb    cmdend - cmdstrt
  103. cmdstrt:    defb    'NZCOM TBSTART'    ; Startup command of your choice
  104. cmdend:        defb    0
  105.         endm
  106.  
  107.  
  108. ; Logical Disk Assignment for Ramdisk
  109. ; -----------------------------------
  110. ;
  111. ; TurboROM does not support the MicroSphere ramdisk.  All support routines 
  112. ; for the ramdisk are contained within this BIOS.  You cannot use TURBOMAP 
  113. ; to assign the ramdisk to a logical drive.  You must use rdnum to assign a 
  114. ; fixed logical disk drive to the ramdisk which will take precedence over 
  115. ; any assignments made with TURBOMAP or by the TurboROM to other physical 
  116. ; drives.  Be careful to avoid potential conflicts.   
  117. ; 
  118. rdnum        equ    4    ; Logical drive for MicroSphere RAM disk
  119.                 ; 0 = A, 1 = B, etc.
  120.  
  121.  
  122. ; Function Key Definition
  123. ; =======================
  124. ;
  125. ; Some computers are capable of generating characters with the high bit set 
  126. ; from special function keys or unsupported keys.  The Kaypro has several 
  127. ; key switch positions under the metal keyboard cover which may be put into 
  128. ; use for purposes such as executing a print buffer pause or halt.  These 
  129. ; keys generally return values in the range of b0h to ffh.  The BIOS constat 
  130. ; routine will return the value of such keys in the L register while 
  131. ; returining status false (zero flag, a=0).  Standard keys return status 
  132. ; true and L=0.  If you use an IOP module you may intercept the values 
  133. ; returned in L by constat and process them accordingly.  You may specify 
  134. ; the maximum value for your standard keys. Any value lower than this will 
  135. ; be treated as coming from normal character producing key while anything 
  136. ; above this value will be handled as described above.  Remember, if you 
  137. ; have a Kaypro, that the TurboROM supports the arrow and number pad keys 
  138. ; and returns values in the range of 80h to 91h for these keys.  Unless 
  139. ; you want to fundamentally redefine these keys you should select a value 
  140. ; for maxkey greater than 91h
  141. ; 
  142. maxkey        equ    92h    ; Maximum "regular" key
  143.  
  144.  
  145. ; Signon Version Number
  146. ; ---------------------
  147. ; 
  148. ; The cold boot signon message identifies the version of the BIOS currently 
  149. ; up and running.  You may select your own version number and beta release 
  150. ; letter (or other character).  
  151. ; 
  152. bvers        equ     20    ; BIOS version number
  153. beta        equ    'B'    ; beta release
  154.  
  155.  
  156.  
  157. ; Ramdisk Disk Parameter Block
  158. ; ----------------------------
  159.  
  160. ; TBMSBIOS contains the ramdisk parameter blocks from the original Micro- 
  161. ; Sphere RDISK source code.  The only change I have made is to set the 
  162. ; number of pre-directory tracks to 0 since to the best of my knowledge 
  163. ; system tracks on the MicroSphere ramdisk are like tits on a bull.  Choose 
  164. ; one of the following, depending on the size of your MicroSphere ramdisk.
  165. ; If you decline to choose one of the preset dpb's, you may configure your
  166. ; own dpb below.
  167. ;
  168. ; Select the size of ramdisk (or set all false to customize below)
  169.  
  170. Rd256        equ    false        ; 256K ramdisk
  171. Rd512        equ    false        ; 512K ramdisk
  172. Rd768         equ    false        ; 768K ramdisk
  173. Rd1024        equ    true        ; 1 meg ramdisk
  174.  
  175.  
  176. ; Select the size of your printer buffer
  177. ;
  178. pb4        equ    false        ; 4K print buffer
  179. pb32        equ    false        ; 32K print buffer
  180. pb64        equ    true        ; 64K print buffer
  181.  
  182.  
  183. ; If you did not select one of the ramdisk size options above, you may 
  184. ; configure the ramdisk parameter block as you choose.  The values shown 
  185. ; below are optimized for a disk with many small files.  No operating system 
  186. ; tracks are set aside.  Block size is 2K.  "The Programmers CP/M Handbood"  
  187. ; by Johnson/Laird has a good discussion of the elements of dpb.  Don't 
  188. ; alter the values below unless you know what you are doing.
  189. ; 
  190.      if    not (rd256 or rd512 or rd768 or rd1024)
  191. ; RAM disk DPB
  192. ;
  193. spt    equ    40
  194. bsh    equ    4
  195. blm    equ    15
  196. exm    equ     0
  197. dsm    equ    466    ;465 for 64K print buffer, 480 for 32K buffer
  198. drm    equ    255     ;drm equ 495 for 4K buffer
  199. al0    equ    0f0h
  200. al1    equ    0
  201. cks    equ    0
  202. offtrk    equ    0
  203.      endif
  204.  
  205.  
  206.  
  207. ; ADDITIONAL INFORMATION
  208. ; ======================
  209. ;
  210. ; In the Advent system image (.sys file) the system components
  211. ; appear at the following addresses (assuming 0100h at start of
  212. ; file):
  213. ; 
  214. ;     cold boot code    0900h
  215. ;     CCP or ZCPR    0B00h
  216. ;     BDOS or ZRDOS    1300h
  217. ;     BIOS        2100h
  218. ;     end of image    24FFh
  219. ; 
  220. ; This version of the BIOS does not support the Plu*Perfect
  221. ; datestamper.
  222. ;
  223. ; * END OF TBMSBIOS.HDR *
  224.