home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / beehive / utilitys / gpatch.arc / GPATCH.DOC < prev    next >
Text File  |  1990-07-21  |  4KB  |  114 lines
  1.  
  2.                     tm         tm
  3.     Running Microsoft GBASIC  on the Starcard        (K.C.M. Lau)
  4.     ------- --------- ------  -- --- --------        (April 1987)
  5.  
  6. This document describes how to get GBASIC.COM supplied with the Microsoft Z80
  7. Softcard (Apple) working on the PCPI Applicard Z80 Starcard. You will need the
  8. following files:
  9.  
  10. 1. FREEHGR.DVR    (and the associated .DOC file for instructions)
  11. 2. GPATCH.HEX
  12. 3. DDT.COM
  13. 4. GBASIC.COM    (BASIC-80 Rev 5.2, Apple CP/M Version. Created 30-Mar-82)
  14.  
  15. If you intend to use hi-res graphics you must format a blank disk and install
  16. FREEHGR.DVR on to it using INSTALL.COM supplied with the Starcard (See the
  17. Starcard Manual chapter 5 'Modifying Drivers with Your Starcard' for details).
  18. Note that FREEHGR.DVR must be installed as the second driver.
  19.     Copy files 2 - 4 on to the disk. Keep a backup of GBASIC.COM as the
  20. modified version will not run on the Softcard anymore. Do the following:
  21.  
  22.     A>DDT GBASIC.COM
  23.     DDT VERS 2.2
  24.     NEXT  PC
  25.     6500 0100
  26.     -IGPATCH.HEX
  27.     -R
  28.     NEXT  PC
  29.     6CB6 0000
  30.     -G0
  31.  
  32.     A>SAVE 108 GBASIC.COM
  33.  
  34. You now have a version of BASIC that runs on the Starcard. Whenever you intend
  35. to use hi-res graphics, make sure to boot from this disk. To run BASIC type:
  36.  
  37.     A>GBASIC
  38.  
  39. Differences
  40. -----------
  41. Here are the differences between the Starcard version and the original:
  42.  
  43. o HCOLORs greater then 7 are not implemented exactly (note: HCOLOR=13 does not
  44.   give a reverse color).
  45.  
  46. o The GR command does not restrict the text window to the bottom 4 lines only;
  47.   hence, be careful of scrolling.
  48.  
  49. o CALL% which should call a 6502 routine, is not implemented.
  50.  
  51. o The EDIT command has been extensively modified to provide a screen oriented
  52.   line editor which should be easier to use. The command keys are based on
  53.   Wordstar:
  54.  
  55.     printable character    insert character at cursor
  56.     ^P tab,^I,^J        insert control character at cursor
  57.     ^S, left arrow        move cursor left one character
  58.     ^D, right arrow        move cursor right one character
  59.     ^A            move cursor left one word
  60.     ^F, tab            move cursor right one word
  61.     ^R, ^B, up arrow    move cursor to beginning of line
  62.     ^C, ^N, down arrow    move cursor to end of line
  63.     del            delete character to left of cursor
  64.     ^G            delete character under cursor
  65.     ^T            delete word under and to right of cursor
  66.     ^Y            delete from cursor to end of line
  67.     ^Q            leave line unchanged and exit edit mode
  68.     ret            accept changes and exit edit mode. Trailing
  69.                 spaces are removed.
  70.  
  71. Notes
  72. -----
  73. o RAM locations 1000h - 3000h which was the hi-res screen memory on the
  74.   Softcard, is unavailable under the Starcard GBASIC as new code resides
  75.   there. Hence, software that tries to load a hi-res picture in to these
  76.   locations will damage BASIC.
  77.  
  78. o 6502 zero page locations that reside at F400h - F4FFh on the Softcard are
  79.   not found on the Starcard. Be careful of programs that poke these locations
  80.   as they will damage BIOS. Also there is no simple way of accessing 6502
  81.   locations and routines from the Starcard. One possible solution is to write
  82.   a Z80 routine that 'talks' to the 6502 via the common port.
  83.  
  84. o The modified edit command may prove to be too slow for external terminals
  85.   In that case you can revert to the original line editor by making the
  86.   following additional patches:
  87.  
  88.     -S62A6
  89.     62A6 xx 16
  90.     62A7 xx    00
  91.     62A8 xx    CD
  92.     62A9 xx .
  93.  
  94. o If inverse, normal, vtab, or home does not work, the screen codes may have
  95.   been changed (ie. by reconfiguring SFTVIDEO.DVR using CONFIGSV.COM). In this
  96.   case you will have to modify a table of screen codes located within
  97.   GBASIC.COM at 6485h - 64FFh (It has the same format as the software screen
  98.   function table found in the Apple CP/M BIOS). Here is the table:
  99.  
  100.     6485 20        Cursor address coordinate offset.
  101.              If hi bit is 0 transmit order is YX else XY.
  102.     6486 1B        Lead in character. For the following,
  103.             if hi bit is 0 no prefix else prefix with lead in:
  104.     6487 AA        Clear screen    
  105.     6488 D9        Clear to End of Page
  106.     6489 D4        Clear to End of Line
  107.     648A EB        Set Normal Text
  108.     648B EA        Set Inverse Text
  109.     648C 1E        Home Cursor
  110.     648D BD        Address Cursor
  111.     648E 0B        Move Cursor Up One Line
  112.     648F 0C        Non-destructively Move Cursor Forward
  113.  
  114.         Home Cursor