home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / ENTERPRS / CPM / UTILS / A / BIOS-R62.LZH / BIOS-R6.DOC < prev    next >
Text File  |  2000-06-30  |  10KB  |  212 lines
  1.                              Commodore 128 CP/M 3.0
  2.                                  BIOS revision 6
  3.                                28 May 1987 version
  4.                            Modified 12 October 1992
  5.                          Second Release - 31 Jan 93 by
  6.                                 Randy Winchester
  7.  
  8.     LEGAL STUFF & DISCLAIMER:  I'm claiming no copyright on any of this 
  9.     material.  I didn't write most of it myself, these are just my 
  10.     modifications and implimentation.  Copyrights are held by Commodore.  The 
  11.     user of this code assumes all responsibility for all damages or losses, 
  12.     so don't do anything with this code that might cause damages or losses.
  13.  
  14.                            BIOS R6 - Release 2 Notes
  15.  
  16.     There were some problems with the first release of BIOS R6.  Somehow, an 
  17.     obsolete version of CXEQU.LIB crept into the LBR that was distributed.  
  18.     This caused some assembly errors, as some labels weren't defined.
  19.  
  20.     Another problem was the default drive search chain that I'd set up.  It 
  21.     works great for me, but then, I have an REU and a Quick Brown Box.  Other 
  22.     people had tried assembling the system without editing the drive search 
  23.     chain in CXIO.ASM.  I set it back to a more reasonable "A:,*" so it should 
  24.     work "straight out of the box."
  25.  
  26.     This was also a great opportunity to add some more comments to the source 
  27.     code where they were needed.  For anyone interested in customizing a CP/M 
  28.     system to better suit their needs, I suggest glancing at the ASM and LIB 
  29.     files - at least the first screen or two of the files that have been 
  30.     modified.  Most of the configuration options are commented fairly well, and 
  31.     it shouldn't take a lot of programming skill to change them.  If I ever get 
  32.     around to doing another release, I'll try to include all user configurable 
  33.     options in a CONFIG.LIB file.
  34.  
  35.     Oh.  One more thing.  I fixed the long standing BIOS bug that screws up the 
  36.     keyboard response after exiting a terminal program.  It took only two lines 
  37.     of code to fix it.  Take a look at the file CXIO.ASM for more details.
  38.  
  39.                                   Why BIOS R6?
  40.  
  41.     This update of the C128 CP/M BIOS includes full support for the 
  42.     "official" C128 CP/M 1581 disk format.  The included CXDISK.ASM file 
  43.     still includes all other changes as stated in this documentation.
  44.  
  45.     A bug fix was made to the RAMDISK label in the module CXRAMDSK.ASM.  The 
  46.     label was changed from 'ERTWINE  VON' to ' ERTWINE VON' to avoid 
  47.     potential incompatibility problems with some software.  See the section 
  48.     on CXRAMDSK.ASM in the following BIOS R5 documentation to see why it was 
  49.     changed in the first place.
  50.  
  51.                     ZPM3 and BIOS R6 - A Winning Combination
  52.  
  53.     One major reason you might want to spend the effort to generate a new 
  54.     BIOS is to include Simeon Cran's excellent ZPM3 BDOS segments.  This BDOS 
  55.     is coded in fast tight Z80 assembly and adds a boost in speed, bug fixes, 
  56.     and additional features.  It's not possible to add ZPM3 to a C128 
  57.     CPM+.SYS using the ZPM3 MAKEDOS utility.  Generating a new BIOS seems to 
  58.     be the only way on the 128.  The necessary ZPM3 files are included with 
  59.     this distribution.  If you've only used "stock" CP/M on a 128, you owe it 
  60.     to yourself to give ZPM3 and BIOS R6 a try.
  61.  
  62.                                   BIOS R5 Notes
  63.  
  64.     This version of a BIOS for the Commodore 128 is based on BIOSR4.ARK 
  65.     from James Waltrip IV.  Mr. Waltrip took care of many of the essentials 
  66.     a couple of years ago.  He slashed out a lot of unneeded code and added 
  67.     a great screen dump.  My revisions were to add back some of the things 
  68.     I've wanted or needed.
  69.  
  70.     I made modifications to the following:
  71.  
  72.          CXIO    .ASM            CXDISK  .ASM
  73.          CXKEY   .ASM            CXRAMDSK.ASM
  74.          CXPRINTE.ASM            CXEXT   .ASM
  75.  
  76.     All other files in this library are unmodified from the version in 
  77.     BIOSR4.ARK.
  78.  
  79.     Most of my additions are to support additional hardware.
  80.  
  81.     * Drive D: is available (it was taken out in BIOSR4).
  82.  
  83.     * A Drive E: has been added.  This isn't to be confused with the 
  84.     virtual disk drive in the official Commodore releases of CP/M.  The 
  85.     intended purpose of this drive E: is to make an entry in the drive 
  86.     table that can be used by QD.COM for an entry for the Quick Brown Box.  
  87.     The Quick Brown Box is a 64K battery backed-up RAM cartridge.  QD is a 
  88.     product of Herne Data Systems, Ltd.  QD installs a driver for the Quick 
  89.     Brown Box that allows it to be used as a RAM disk.  By entering the 
  90.     command: QD F/F, the Quick Brown Box is set up as Drive F:.  I keep my 
  91.     favorite utilities stored there so I can have them as soon as the 
  92.     system boots up.
  93.  
  94.     * Definitions have been added to the disk parameter table for two of my 
  95.     favorite disk formats, 'Maxi 71' and '1581 GP'.  Maxi 71 is from Miklos 
  96.     Garamszeghy's article in 'The Transactor' on adding support for more 
  97.     foreign disk formats.  Maxi 71 offers an incredible 398K.  Disks can be 
  98.     formatted using Garamszeghy's public domain FORMAT22 or his 
  99.     commercially available package, Jugg'ler.  The latest version of 
  100.     Jugg'ler supports over 130 CP/M disk formats.
  101.  
  102.     * 1581 GP is a 796K format for 3.5 inch disks.  Gene Pizzetta wrote 
  103.     FORMAT81 for adding 1581 disk support before the 1581 Commodore version 
  104.     was released.  He did a good job.  Not does his format hold more than 
  105.     Commodore's, it also seems faster than Commodore's format.  I haven't 
  106.     taken the time to verify this - just try it out and see what you think. 
  107.     Disks for 1581 GP can be formatted using Gene's public domain FORMAT81.
  108.  
  109.     * The default LST device is now an ASCII printer, device 4.  The 
  110.     secondary address has been changed to 5.  This allows for transparent 
  111.     mode with the Xetec SuperGraphix interface without added line feeds.  
  112.     If you need to use a Commodore printer, replace FAST8502.ASM with the 
  113.     version found in BIOS4MOD.LBR, and replace CXPRINTE.ASM with the 
  114.     original version found on the DRI Source Code/Utilities disks.
  115.  
  116.     Here's the nitty-gritty, file by file:
  117.  
  118. --------------------------------------------------------------------------
  119.                                  CXIO.ASM
  120. --------------------------------------------------------------------------
  121.  *ADDITIONS BY Randy Winchester, 5/6/89
  122.  
  123.  Default printer is device 4.
  124.  
  125.  Set up for non-flashing block cursor
  126.  
  127.  Search chain/temp drive:  M:,*,F: [TEMP=M:]
  128.  Drive F: is reserved for the Quick Brown Box battery powered RAM cartridge.
  129.  The QBB is initialized with QD.COM from Herne Data Systems, Ltd.
  130.  
  131.  No password protection for booting the system.
  132.  
  133.  Colors set in sign-on message.  Background=lt. gray, character=blue
  134.  
  135.  Default system baud rate set for 75 baud.  This speeds up normal operation
  136.  considerably.
  137.  
  138.  Printer names set to PRT-D4 and PRT-D5 (devices 4 and 5)
  139. --------------------------------------------------------------------------
  140.  
  141. --------------------------------------------------------------------------
  142.                                  CXKEY.ASM
  143. --------------------------------------------------------------------------
  144.  * ADDITIONS by Randy Winchester, 5/3/89
  145.  
  146.  Added drive D: to MFM unlock routine.
  147. --------------------------------------------------------------------------
  148.  
  149. --------------------------------------------------------------------------
  150.                                CXPRINTE.ASM
  151. --------------------------------------------------------------------------
  152.  Set the secondary address to 5 to work properly with the Xetec
  153.  SuperGraphix in transparent mode.  -RW, 5/6/89
  154. --------------------------------------------------------------------------
  155.  
  156. --------------------------------------------------------------------------
  157.                                CXRAMDSK.ASM
  158. --------------------------------------------------------------------------
  159.  CHANGES by Randy Winchester, 6 May 89
  160.  
  161.  RAM disk is now drive M: again.
  162.  
  163.  Disk Label for the RAM disk has been changed back to ERTWINE VON from
  164.    RAMDISK RAM.  Not only do I believe in honoring programmers rather
  165.    than hardware, there was no need to fuss with it in the first place.
  166.    No need to tempt fate.
  167. --------------------------------------------------------------------------
  168.  
  169. --------------------------------------------------------------------------
  170.                                  CXEXT.ASM
  171. --------------------------------------------------------------------------
  172.  CHANGES by Randy Winchester, 6 May 89
  173.  
  174.  Drive D: returned to active duty.
  175.  
  176.  RAM disk set back to drive M:
  177.  
  178.  Table entry made for Drive E:, used by Quick Brown Box.
  179. --------------------------------------------------------------------------
  180.  
  181.     Notes:
  182.  
  183.     I think the CXKYCODE.ASM file that is included with the ARKhive is 
  184.     lacking in many ways.  Rather than edit the file, there are easier ways 
  185.     to include key definitions in a CPM+.SYS file.  I highly recommend 
  186.     KEYFIG from the original Commodore system disk for defining the 
  187.     keyboard layout.  Once you have the keyboard configured the way you 
  188.     like it, you can use KEYFIG to save the layout in your new CPM+.SYS.  
  189.     Other tools that are helpful in this regard are the public domain 
  190.     SAVEKEY and LOADKEY by Gene Pizzetta.  These programs save or load 
  191.     keyboard definitions in files, and can be used to transfer custom key 
  192.     layouts from an old CPM+.SYS to a new CPM+.SYS.
  193.  
  194.     I'd love to add support for Commodore's "official" 1581 disk format.  
  195.     I've hacked most of it out of a copy of the 28 May 87 release, but I 
  196.     haven't been able to make it work.  If anyone can show me the code to 
  197.     support the 1581, or a Disk Parameter Table entry for Commodore's 
  198.     format, please pass it along.
  199.  
  200.     Please make sure to read all of the documentation in this archive.
  201.  
  202.     If you have hints, tips, bug reports, suggestions, I'd like to hear 
  203.     them.  Please write me.
  204.  
  205.                    Randy Winchester
  206.                    P.O. Box 1074
  207.                    Cambridge, MA  02142
  208.  
  209.                    or the BCS/CUG BBS, 617/729-7340
  210.                    or Internet:  randy@mit.edu
  211.  
  212.