home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / bdos / nosltdos.lbr / USER20.DZC / USER20.DOC
Text File  |  1987-12-04  |  3KB  |  54 lines
  1.  
  2. USER20.DOC        R.Gaspari        12-04-87
  3.     
  4.     This is a replacement lower bios (USER.ASM) for Northstar Advantage.
  5. It embeds SMT no-slot clock call support along with pop-up clock display in
  6. the bios.  See NOSLT20.LBR for more info on SMT clock use for cpm.
  7.  
  8.     It replaces USER15 which handled function keys from inside bios.  
  9. Since the function key capability was removed, an alternative function key 
  10. handler is provided as YKEY.  This function key handler is not a general 
  11. purpose tool like either Qwikkey or Eric Gan's GKEY.  In fact, if either 
  12. of their source code was available I would never have bothered to write it.  
  13. YKEY is designed as an overlay to any specific program, thus loading with it 
  14. from the command line.  It requires use of DDT for the overlay and requires
  15. special tailoring for every application program for which it is to be overlaid.  
  16. Examples for its use are provided.  See YKEY for details.
  17.  
  18.     The TIME routine within USER20 is accessed via the reader (RDR:)
  19. jump at boot+15h.  This is not much of an imposition since both PUN:
  20. and RDR: were removed to make room in bios.   As mentioned in USER15, 
  21. I have never in 6 years used the RDR: or PUN: options built into the 
  22. cp/m system via the PIP and STAT commands.
  23.  
  24.     The POP-UP routine is accessed by a hot-key.  The released version
  25. is initialized for CMND-F1 and CMND-F2.  The function key CMND-F1 gives
  26. one single display of the clock.  CMND-F2 gives continuous display, which 
  27. is toggled on and off by successive CMND-F2.   The reason for the "one-shot" 
  28. display option is that an application program might have useful information 
  29. at the display location (upper right hand corner of the crt screen).  The 
  30. display is quick and short.  There's not much room in bios for exotic options, 
  31. and so the pop-up code was compressed as much as possible.
  32.  
  33.     For permanent installation into the bios, use SYSGEN and DDT.  
  34. For the Northstar Advantage floppy based system (& Northnet system) use 
  35. an offset of  3E00h.
  36.          a) SYSGEN   to get the image of the OS into RAM at location 1400h
  37.          b) DDT      (original DDT only) to load USER.HEX
  38.             -IUSER.HEX     place USER.HEX in the name buffer
  39.             -R3E00         read it in with an offset of 3E00
  40.             -^C            exit DDT
  41.          c) SYSGEN   to process the modified system image that
  42.                          was created above and store it onto disk.
  43.  
  44.     For temporary installation, it can be loaded into the bios at
  45. run time along with an application program.  I often use this approach
  46. in case the coldboot disk wasn't re-sysgened with the new USER20 overlay.
  47. Examples of this usage can be found in YK-EXAMP, examples for YKEY.
  48.  
  49.     Additional general information on patching the BIOS area of Northstar
  50. Advantage systems can be found in section 8.6 of the Northstar Graphics 
  51. CPM Preface.  Send bug reports or comments to R.Gaspari,  6656 W 87th Pl,
  52. Los Angeles 90045.
  53.  
  54.